PlaiiinLight for Homebridge

Control PlaiiinLight lamps from Apple Home: each lamp becomes a HomeKit lightbulb with power, color, and brightness — all over your local network (HTTP + mDNS, no cloud, no account). The lamps run the open-source PlaiiinLightOS firmware.

Requirements

• A lamp running PlaiiinLightOS, already onboarded to your Wi‑Fi (use the PlaiiinLight app to onboard it first).
• Homebridge ≥ 1.8, Node ≥ 18.

Installation

Search for plaiiinlight in the Homebridge UI (Plugins tab), or:

npm install -g homebridge-plaiiinlight

How lamps appear

• Unclaimed lamps (nobody has claimed them in a PlaiiinLight app) are discovered via mDNS and added automatically — no configuration needed. Disable with autoDiscoverAndAddUnclaimed: false.
• Claimed lamps need a share key. The owner creates one in any PlaiiinLight app: lamp → Share → create key (role "user" is enough). Add the lamp to the plugin config with that key.

Configuration

Via the Homebridge UI, or in config.json:

{
  "platform": "PlaiiinLight",
  "autoDiscoverAndAddUnclaimed": true,
  "pollInterval": 10,
  "lamps": [
    {
      "name": "plaiiinlight-tower",
      "displayName": "Living room lamp",
      "shareKey": "…paste the share key here…"
    }
  ]
}

• name is the lamp's mDNS node name (shown in the PlaiiinLight apps and in the Homebridge log when the lamp is discovered).
• host/port (optional): pin a lamp by IP if mDNS doesn't reach it (VLANs, some mesh setups). Everything else keeps working.

Behavior notes

• Color, brightness, and power from HomeKit never change the lamp's mode — a running JS effect keeps running (a color change updates the base color the effect can pick up). Switch modes from the PlaiiinLight apps or the lamp's web portal.
• Changes made in the PlaiiinLight apps show up in the Home app within the poll interval.
• If a lamp you auto-added gets claimed by someone, it disappears from HomeKit (ask the owner for a share key to bring it back).

Troubleshooting

• Lamp doesn't appear: check it's on the same network/VLAN as Homebridge and that mDNS traffic passes; otherwise configure it with host.
• "share key rejected" in the log: the key was revoked or the lamp was factory-reset and re-claimed — ask the owner for a new key.

License

Apache-2.0. The plugin talks to the lamp's open, documented HTTP API from the PlaiiinLightOS firmware.