mirror of
https://github.com/steffjenl/com-homey-unifiprotect.git
synced 2026-06-18 14:11:07 +00:00
Adds support for Ubiquiti UniFi Protect devices in Homey.
- JavaScript 92%
- HTML 7.2%
- CSS 0.6%
- Python 0.2%
|
|
||
|---|---|---|
| .github | ||
| .homeycompose | ||
| assets | ||
| drivers | ||
| library | ||
| locales | ||
| settings | ||
| specs | ||
| tools | ||
| widgets | ||
| wiki | ||
| .eslintignore | ||
| .eslintrc.json | ||
| .gitignore | ||
| .homeychangelog.json | ||
| .homeyplugins.json | ||
| AGENTS.md | ||
| api.js | ||
| app.js | ||
| app.json | ||
| CODE_OF_CONDUCT.md | ||
| CONTRIBUTING.md | ||
| env.json | ||
| LICENSE | ||
| package-lock.json | ||
| package.json | ||
| README.md | ||
| README.nl.txt | ||
| README.txt | ||
| tsconfig.json | ||
Ubiquiti UniFi Protect
Adds support for Ubiquiti UniFi Protect devices in Homey.
Supported devices
- UniFi® Protect (Network Video Recorder):
- UniFi® Cloud Key v2 Pro
- UniFi® Dream Machine Pro (UnifiOs)
- UniFi® Protect Network Video Recorder (UnifiOs)
- UniFi® Video Camera G3 series:
- UVC-G3
- UVC-G3-AF
- UVC-G3-DOME
- UVC-G3-FLEX
- UVC-G3-MICRO
- UVC-G3-PRO
- UniFi® Video Camera G4 series:
- UVC-G4-PRO
- UVC-G4-BULLET
- UniFi® Doorbell G4 series:
- UVC-G4-DOORBELL
- UVC-G4-DOORBELL-PRO
Getting started
- Create a local access user in the UniFi Protect web interface (used only for Homey.
- Install this UniFi Protect app on your Homey.
- Go to the UniFi Protect app's settings page.
- You will be prompted to enter the credentials of the UniFi Video user you created in step 2 and some network information.
- Start the 'add device wizard' in Homey, search for your UniFi Cloud Key and/or cameras and add them to your devices.
- If the user credentials changed in UniFi Protect, they can be updated on the UniFi Protect app's settings page.
Usage
- A flow can be triggered when motion detection on a camera starts or ends.
- A flow can be triggered when a snapshot is created on a camera. This card supplies the name of the camera that created the snapshot and the snapshot image itself.
- A flow action card can be used to create a snapshot, which is is saved to an Image tag.
- A flow action card is available to set a camera's recording mode, being one of 'Don't record', 'Always record' or 'Record only motion'.
How to create an local account?
- Login in your local UniFi web interface, and click on Admins & Users. Note: This must be done from your local device and not from unifi.ui.com or within the app.
- Click on the '+' icon to add a new user.
- Fill in the user details, and make sure to select 'Restrict to local access only' as the user type.
- Give the user Full Management rights and click on 'Add'.
Troubleshooting / FAQ
- Question: I am using not the latest firmware on the cloudkey and can't connect.
- A: Please upgrade your Cloudkey to 2.0.27 and Protect version 1.17.2
- Question: I get a lot of false motion alerts. Is there anything to do about that?
- A: Turn off 'Enable Auto Rotate' and rotate the camera manually.
- A: Remove the default motion zone and create a motion zone with only the zone what you want to detect motions.
- A: Set 'Minimum seconds of motion to trigger event' on 1 second or higher
- Do you have more tips? let me know!
- Question: I am using a UnifiOS device, I don't see any storage information.
- A: UnifiOS device does not release storage information through the API.
Feedback
If you find a bug or if you are missing a feature, please create an issue here. Thank you for using this app!