WLED WS
homebridge-wled-ws · v0.0.26
Adds WLED LED strips to HomeKit as lights using WLED websockets.
What it says it supports
Brands
- WLED
Devices it names
- WLED LED strips
Shows up in Apple Home as from its README
What people report
Controls WLED controllers over websocket; color temperature on CCT lights is not working reliably due to WLED-side limits.
- Requested1
| Device | Status | What they said | Source |
|---|---|---|---|
| WLED CCT tunable-white light | Requested | CCT control in WLED proved unreliable; work paused pending WLED changesSaved copyI've been working on this, but actually controlling CCT in wled is really hit-or-miss. There must be some magic sequence of adjust color then CCT to get it to actually work. So here's a quick update: 1. `wled-client` properly detects that a light supports CCT 2. The color temperature is generally returned as an unsigned tinyint (0-255). Documentation states that you can send a Kelvin value, but from my experience this does nothing. 3. Homebridge supports color temperature from 500 to 140 in Mired, which is $\frac{1,000,000}{T_k}$. This is 2000 - ~7145 kelvin, which would leave a direct … Excerpt saved from GitHub on 2026-10-22. | Issue #211 · 2025-02 |
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
WLED JSON API over WebSocket on the LAN
You’ll need
- WLED firmware 0.13 to 0.16
Compatibility
| Verified by Homebridge | Yes |
|---|---|
| Homebridge versions | ^1.8.0|| ^2.0.0-beta.0 |
| Homebridge 2.0 | Yes |
| Node.js | ^20.19.0 || ^22.14.0 || ^24.0.0 |
| Settings in Homebridge UI | Yes |
| Matter | No |
| Platform name | wled-ws |
| License | Apache-2.0 |
Community signals
| Downloads a week | 47 |
|---|---|
| Downloads a month | 296 |
| GitHub stars | 23 |
| Open issues | 3 |
| Closed issues | 19 |
| Last code push | 2026-10-19 |
| Latest version | 0.0.26 (2026-10-15) |
| First published | 2024-01-13 |
| Releases | 17 |
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
- Only first segment controlled
- Firmware 0.14.2 websocket broken
HomeKit services in its code
Found by scanning the published npm package. A plugin can register a service only for some devices.
- Lightbulb
- Switch
Sources
- npm: https://www.npmjs.com/package/homebridge-wled-ws
- Source code: https://github.com/smhex/homebridge-wled-ws
- Issues: https://github.com/smhex/homebridge-wled-ws/issues
- Verified plugins list: https://github.com/homebridge/verified