Homebridge UniFi Occupancy Sensor

This Homebridge plugin will provide an occupancy sensor accessory to HomeKit based on the devices connected to WiFi access points managed by a UniFi Controller.

The plugin connects to the UniFi Controller event web socket to get instant notifications of connecting devices - which can then be used to trigger HomeKit actions like turning on the lights.

Requirements

• Node.js v4 or later
• UniFi Controller v5

Homebridge Config

"accessories": [
  {
    "accessory": "UniFi Occupancy Sensor",
    "name": "Occupancy Sensor",
    "unifi": {
      "controller": "https://demo.ubnt.com:8443",  // Required. The url of the UniFi Controller.
      "username": "superadmin",                    // Required. A read-only user is fine.
      "password": "password",                      // Required.
      "site": "default",                           // Optional. The UniFi site to connect to.
      "secure": false                              // Optional. Set true to validate the SSL certificate.
    },
    "watch": [
      "44:00:10:f0:3e:66", 
      { "device": "44:00:10:f0:3e:67", "ap": "44:00:10:f0:3e:44" }
    ],                                             // Required. An array of device MAC addresses to watch for or objects with device MAC / AP MAC
    "watchGuests": true,                           // Optional. Set false to not monitor guest networks.
    "interval": 1800,                              // Optional. Polling interval used to query Unifi in seconds 
    "mode": "any"                                  // Optional. Set to "any", "all" or "none".
  }
]

Site Name

If you're using a non-default site you will need to specify the name of the site in the plugin config. The internal site name might not match the name you have allocated to the site exactly, you can get the required site name by navigating to the site in the unifi controller then looking at the url bar:

https://unifi.com:8443/manage/site/mofkpypu/dashboard

In this case the site name is mofkpypu and this is the value that should be entered in your Homebridge config.