Elgato Key Light
homebridge-keylights · v1.3.3
Adds Elgato Key Light, Key Light Air and Ring Light to HomeKit.
What it says it supports
Brands
- Elgato
Devices it names
- Key Light
- Key Light Air
- Ring Light
Shows up in Apple Home as from its README
What people report
Controls Elgato Key Lights with adaptive lighting and Homebridge 2.0 support (v1.3.0); Light Strip is not supported.
- Works2
- Requested1
| Device | Status | What they said | Source |
|---|---|---|---|
| Elgato Key Light | Works | On/brightness/temperature work; adaptive lighting added, Homebridge v2 supported in v1.3.0Saved copyAny update on status of when compatibility of Key Lights plugin with v2 of HomeBridge will happen. After HomeBridge updated to v2 the Key Lights plugin fails to function with the following error message: This plugin threw an error from the characteristic 'On': Unhandled error thrown inside read handler for characteristic: Cannot read properties of undefined (reading 'LEAVE_PACKAGE_AT_DOOR.LEAVE PACKAGE AT DOOR'). See https://homebridge.io/w/JtMGR for more info. Excerpt saved from GitHub on 2026-10-22. | Issue #530 · 2025-01 |
| Elgato Key Light | Works | Working amazingly on macOS; one user could not get it working on 2021 MBPSaved copy… related; the misses anyway. I installed myQ for my garage door opener. This has been amazing. Never fails and is just so great working in my Home app. Elgato Key Lights. These are working amazingly, too. Ring. Ohhh Ring, how I despise thee... I have the alarm system, 2 flood light cams, and the doorbell cam. The doorbell doesn’t show up on my Apple TV. The cameras are hit or miss as to whether I can view them. https://i.imgur.com/pw02i28.jpg is the common thing I see. It’s incredibly aggravating and I want to fix it this upcoming week when I setup the new Pi. Update: I'm getting this error … Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit thread · 2021-01 |
| Elgato Light Strip | Requested | Added as a Key Light so color control is lostSaved copyThat would be nice to have for support for the light strip. When we add one with this plug-in, the light strip "transforms" into a key light and we loose the ability to control colour. Excerpt saved from GitHub on 2026-10-22. | Issue #380 · 2022-11 |
Gathered from the plugin’s GitHub issues, pull requests, discussions, wiki and docs, and from r/homebridge. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local
LAN polling by IP/mDNS
Compatibility
| Verified by Homebridge | Yes |
|---|---|
| Homebridge versions | ^1.8.0 || ^2.0.0-beta.0 |
| Homebridge 2.0 | Yes |
| Node.js | ^20.0.0 || ^22.0.0 || ^24.0.0 |
| Settings in Homebridge UI | Yes |
| Matter | No |
| Platform name | ElgatoKeyLights |
| License | MIT |
Community signals
| Downloads a week | 21 |
|---|---|
| Downloads a month | 121 |
| GitHub stars | 59 |
| Open issues | 14 |
| Closed issues | 11 |
| Last code push | 2026-09-03 |
| Latest version | 1.3.3 (2025-12-14) |
| First published | 2020-08-15 |
| Releases | 16 |
In ReReHome
Whatever this plugin publishes reaches Apple Home as a normal HomeKit accessory behind your Homebridge bridge, so ReReHome shows and controls it like any other.
Bridges get their own settings page listing the accessories behind them.
Caveats from the README
- Lights can go unresponsive; power cycle fix
HomeKit services in its code
Found by scanning the published npm package. A plugin can register a service only for some devices.
- Lightbulb
Sources
- npm: https://www.npmjs.com/package/homebridge-keylights
- Source code: https://github.com/jnmau/homebridge-keylights
- Issues: https://github.com/jnmau/homebridge-keylights/issues
- Homepage: https://github.com/derjayjay/homebridge-keylights#readme
- Verified plugins list: https://github.com/homebridge/verified
