This project add some nodes to node-red, to interact with unifi from ubiquiti .
This project, is mainly a proof of concept of the library unifi-client, and so mainly reuse tested functions .
You can read nodes documentation here .
- Installed UniFi-Controller version v6 or newer
- An unifi user, without 2FA*
*: 2FA is supported, but not adapted to automated usage .
The recommended way to install this module is from the Node-RED GUI itself. Menu/manage palette/Install/search for unifi and then click install.
Allow you to do all the request you want to unifi . The node will do the connection and other for you, and then return directly the result of the request in msg.payload
Check for events on Unifi access Doors, and send a message per event .
Can be used to trigger a workflow depending on who open the door .
Ask to unlock a relais (doors for example)
Adding nodes to this library is pretty easy .
First of all, be sure to have a ready node-red environnement (follow install tutorial), then clone the repos and install it in node-red config directory with a local module npm i /home/thib3113/repo/ .
Then, you can create a new node, you can check the example of DoorEvents :
- create a ts file in src/nodes
- create a classe extending Node
- export a function that will call the function "registerNode"
- create an html file with the same name as the ts file (without the extension)
- configure the package.json node-red part to add your node
To do request to Unifi, feel free to read the documentation of unifi-client .
When you are ready, open a PR
Thank you