Expose a switch to HomeKit. If the switch is enabled through HomeKit, every time someone rings and Nello doesn't open the door automatically, this plugin will open it for you. (Can be used for HomeKit automations.)
The URL and SHA256 HMAC key is regenerated periodically, but this is not immune to replay attacks (within the locationUpdateInterval) since Nello does not include a timestamp in their digest. Use at your own risk!
Context: https://github.com/lukasroegner/homebridge-nello/issues/43
Do not actually open the door, only log. Useful for testing.
WARNING: This also allows unauthenticated webhooks for testing.
This is not a problen since this also disables door-opening, but please be aware.
Expose the lock state as "unknown" when nello.io API is unreachable.
Unfortunately, this also triggers a fake "unlocked" notification, so turn this off if you do not want that.
It's recommended to create another account in the nello app for this plugin. In order to prevent duplicated notification you should enter the user name of this HomeKit account. Default value is undefined.
Frequency to update locations from Nello (when devices are added or removed) also dictates how often the reachability is updated (when the Nello API is down)
Use 0 to disable continuous updates (will only update at startup).
(milliseconds)
for how long should the lock be displayed as unlocked after you unlock the door
(milliseconds)
Expose a motion sensor to HomeKit and trigger it every time someone rings. (Can be used for HomeKit automations and notifications.)
for how long should the motion sensor be triggered after someone rings
(milliseconds)
Specify this if you would not like to use the Webhook Relay service and instead setup port forwarding and Dynamic DNS to make a local Express server publicly accessible. Must be configured to the full URL (e.g. http://example.com:3000/ or https://example.com/) to register with Nello.io.
Use a video configuration adjusted for the camera module.
If this value is set to true, a camera can be added to HomeKit (as extra accessory) and when someone rings at your door you will get a push notification with unlock button (The lock and the camera must be in the same room to see the unlock button)
Port to run the Express Webhook server on. Only relevant if you setup the publicWebhookUrl above.
how often to regenerate webhook URLs and set a new signing key
this partially protects against replay attacks if an attacker gets access to a webhook payload (see docs for dangerouslyEnableAlwaysOpenSwitch)
quicker is better, however, updates that are too frequent can cause errors on the Nello API
(milliseconds)
(Pi Only) Rotate the video stream (in degrees)
Custom path to ffmpeg binary
(Pi Only) Flip the stream horitzontally
Maximum frame per seconds of the stream
Maximum height of the stream
Maximum width of the stream
(Pi Only) If set to true you will see all messages from ffmpeg
Set to either a URL or '-i
The path MUST start with / and not ~ or be any other relative path
If you use an https:// address, make sure that ffmpeg is compiled with openssl
Enter a stream url of e.g. your RaspberryPi camera or leave it blank if you don't have one
Set a video codec for ffmpeg
(Pi Only) Flip the stream vertically
If you have a doorbell with srtp support, or a Raspberry Pi camera module, you can use this configuration.
You need to install ffmpeg if you want to see a picture in the Home app. Just take a look at last paragraph of the Installation part