@oblongmedulla/homebridge-pawport 1.2.0 → 1.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/.gitignore~
ADDED
|
File without changes
|
package/README.md
CHANGED
|
@@ -1,120 +1,105 @@
|
|
|
1
|
-
# homebridge-pawport
|
|
2
|
-
|
|
3
|
-
[
|
|
115
|
-
|
|
116
|
-
---
|
|
117
|
-
|
|
118
|
-
## License
|
|
119
|
-
|
|
120
|
-
MIT © [oblongmedulla](https://github.com/oblongmedulla)
|
|
1
|
+
# homebridge-pawport
|
|
2
|
+
[](https://www.npmjs.com/package/@oblongmedulla/homebridge-pawport)
|
|
3
|
+
[](https://www.npmjs.com/package/@oblongmedulla/homebridge-pawport)
|
|
4
|
+
|
|
5
|
+
A Homebridge plugin that exposes your Pawport smart pet door as a **Lock** in Apple Home. Lock and unlock your pet door from the Home app, Siri, or automations.
|
|
6
|
+
|
|
7
|
+
Supports **multiple doors** on a single account.
|
|
8
|
+
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
## Installation
|
|
12
|
+
|
|
13
|
+
### Via Homebridge UI (Recommended)
|
|
14
|
+
|
|
15
|
+
Search for `homebridge-pawport` in the Homebridge plugin search and click **Install**.
|
|
16
|
+
|
|
17
|
+
### Manual Installation
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
npm install -g homebridge-pawport
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## Configuration
|
|
24
|
+
|
|
25
|
+
After installing, go to the **Plugins** tab in Homebridge UI, find **homebridge-pawport**, and click **Settings**.
|
|
26
|
+
|
|
27
|
+
Add one entry per door with:
|
|
28
|
+
|
|
29
|
+
| Field | Description |
|
|
30
|
+
| ---------- | ------------------------------------------------------------ |
|
|
31
|
+
| Door Name | Whatever you want to call it in Apple Home (e.g. "Dog Door") |
|
|
32
|
+
| Auth Token | Your `x-auth-token` from the Pawport app (see below) |
|
|
33
|
+
| Door ID | The UUID of your door (see below) |
|
|
34
|
+
|
|
35
|
+
### Manual `config.json` Example
|
|
36
|
+
|
|
37
|
+
```json
|
|
38
|
+
{
|
|
39
|
+
"platforms": [
|
|
40
|
+
{
|
|
41
|
+
"platform": "PawportPlatform",
|
|
42
|
+
"name": "Pawport",
|
|
43
|
+
"doors": [
|
|
44
|
+
{
|
|
45
|
+
"name": "Dog Door",
|
|
46
|
+
"authToken": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
|
|
47
|
+
"doorID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
|
|
48
|
+
},
|
|
49
|
+
{
|
|
50
|
+
"name": "Cat Flap",
|
|
51
|
+
"authToken": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
|
|
52
|
+
"doorID": "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"
|
|
53
|
+
}
|
|
54
|
+
]
|
|
55
|
+
}
|
|
56
|
+
]
|
|
57
|
+
}
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
## Finding Your Credentials (Easy Mode)
|
|
61
|
+
|
|
62
|
+
You no longer need to proxy network traffic or capture SSL certificates to get your credentials.
|
|
63
|
+
|
|
64
|
+
You can use the built-in login tool right inside the settings layout:
|
|
65
|
+
|
|
66
|
+
1. Open the plugin **Settings** modal in the Homebridge UI.
|
|
67
|
+
2. Click the **Login to Pawport** helper button at the top of the interface.
|
|
68
|
+
3. Enter your registered Pawport account email and password.
|
|
69
|
+
4. The plugin will securely reach out to the API and automatically fill in your Auth Token and Door ID values directly into the configuration form.
|
|
70
|
+
|
|
71
|
+
## How It Works
|
|
72
|
+
|
|
73
|
+
This plugin communicates with the Pawport cloud API using the same GraphQL endpoint as the official iOS app.
|
|
74
|
+
|
|
75
|
+
The door appears as a **Lock Mechanism** in HomeKit, which means you can:
|
|
76
|
+
|
|
77
|
+
* Lock and unlock from the Home app
|
|
78
|
+
* Use Siri ("Hey Siri, lock the dog door")
|
|
79
|
+
* Create automations (e.g. lock at sunset, unlock at 7am)
|
|
80
|
+
* Include it in Home scenes
|
|
81
|
+
|
|
82
|
+
> Note: This plugin is not affiliated with or endorsed by Pawport. Use at your own risk.
|
|
83
|
+
|
|
84
|
+
## Troubleshooting
|
|
85
|
+
|
|
86
|
+
### Door Shows as "No Response"
|
|
87
|
+
|
|
88
|
+
* Check that your `authToken` is correct and hasn't expired.
|
|
89
|
+
* Re-run the login helper button to refresh credentials.
|
|
90
|
+
* Make sure your Homebridge server has internet access.
|
|
91
|
+
|
|
92
|
+
### Commands Fail Silently
|
|
93
|
+
|
|
94
|
+
* Check the Homebridge logs for error details.
|
|
95
|
+
* Try locking/unlocking from the Pawport app to confirm the door is online.
|
|
96
|
+
|
|
97
|
+
## Contributing
|
|
98
|
+
|
|
99
|
+
Pull requests are welcome.
|
|
100
|
+
|
|
101
|
+
Please open an issue first to discuss what you'd like to change.
|
|
102
|
+
|
|
103
|
+
## License
|
|
104
|
+
|
|
105
|
+
MIT © oblongmedulla
|
package/package.json
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"name":"@oblongmedulla/homebridge-pawport","version":"1.2.
|
|
1
|
+
{"name":"@oblongmedulla/homebridge-pawport","version":"1.2.1","description":"Homebridge plugin for the Pawport smart pet door","license":"MIT","main":"index.js","keywords":["homebridge-plugin","pawport","pet door","smart lock","homebridge"],"engines":{"node":">=18.0.0","homebridge":">=1.3.0"},"author":"oblongmedulla","repository":{"type":"git","url":"git+https://github.com/oblongmedulla/homebridge-pawport.git"},"bugs":{"url":"https://github.com/oblongmedulla/homebridge-pawport/issues"},"homepage":"https://github.com/oblongmedulla/homebridge-pawport#readme","dependencies":{"@homebridge/plugin-ui-utils":"^2.2.4"},"devDependencies":{"homebridge":"^1.8.0"}}
|
|
File without changes
|
|
File without changes
|