homebridge-unifi-ap-light

Control the light rings on your UniFi Access Point(s) with HomeKit!

Features

Multi-Site Support: Supports multiple UniFi sites (tenants) in a single Homebridge config.
Dynamic Discovery: Automatically discovers UniFi APs across one or more specified sites.
Real-time Updates: Changes made in HomeKit instantly reflect on your access points.
Advanced Filtering: Include or exclude specific APs by ID.
Compatiblity: Supports self-hosted and Ubiquiti-hosted (e.g. UDM) UniFi API structures.
Session Management: Robust handling of cookie- and token-based API authentication.

Search for homebridge-unifi-ap-light in the Homebridge UI, or run:

npm install -g homebridge-unifi-ap-light

Or, with Yarn:

yarn global add homebridge-unifi-ap-light

{
  "name": "UniFi AP Lights",
  "platform": "UnifiAPLight",
  "host": "<hostname>:<port>",
  "username": "<username>",
  "password": "<password>"
}

{
  "sites": ["Default", "mySite"]
}

You may specify site desc values (friendly names like "Default", "mySite") or internal names ("default", "p2yvd0iv").
The plugin automatically resolves the proper internal identifiers using the UniFi API.

{
  "includeIds": ["<device-id-1>", "<device-id-2>"],
  "excludeIds": ["<device-id-3>"]
}

includeIds: Only devices with these IDs will be shown in HomeKit.
excludeIds: Devices with these IDs will always be excluded, even if included elsewhere.

On startup, the plugin will list all detected sites:

[UniFi AP Lights] Available sites loaded: Default, default, mySite, p2yvd0iv

If a site is not recognized, you'll see:

Site "xyz" is not recognized by the controller (api.err.NoSiteContext).

This project is licensed under the MIT License — see the LICENSE file for details.