Lighting

WLED

wled

Built inLocal pushPlatinum

WLED is a fast and feature-rich implementation of an ESP8266/ESP32 webserver to control NeoPixel LEDs (like WS2812B, WS2811, SK6812, and similar) and SPI based chipsets (like WS2801 and APA102).

Documentation Source code

In Apple Home through HomeKit Bridge

What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.

Entity	Shows up as	Note
`light`	Light
`switch`	Switch or outlet
`sensor`	Sensor (humidity, temperature)
`button`	Button (as a switch)
`select`	Mode picker (as switches)

2 reports below say how a device from this integration behaves in the Home app.

What people report

WLED works locally with push updates; RGB+CCT mixed strips can't be controlled independently, and some ESP32 devices with many segments reportedly hang. WLED lights show up in HomeKit Bridge.

Works8
Partly works2
Not working2

Device	In Home Assistant	In Apple Home	What they said	Source
BTF-Lighting LED strips with WLED and Gledopto	Works Local		Recommended combination; 2 users agree Saved copy BTF strips, WLED for software, and gledopto for controllers Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23.	Reddit comment · 2026-03
WLED controllers (ESP8266/ESP32, QuinLED) with BTF-Lighting strips	Works Local		Several users prefer WLED with BTF strips; best control and flexibility Saved copy I used to be all in on Hue but these days I just build my own. I buy decent strips from BTTF lighting and use a variety of WLED controllers such as standalone ESP8266 D1 Minis for simple projects or more expensive QuinLED controllers for bigger runs. I usually go for 5V RGBW strips unless I need them to be super bright. Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23.	Reddit comment · 2025-02
WLED LED controller	Works Local		3 users recommend WLED for addressable strips; one flash, controllable from HA Saved copy WLED. One flash and controlled from web phone and HA Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23.	Reddit comment · 2019-10
WLED LED strip controllers	Works Local		Recommended for long LED strip runs; Athom sells premade controllers Saved copy Wled, I personally would even think of using anything else. You can make your own controller or buy them pre made. The wled site has wiring diagrams for long runs. https://kno.wled.ge/ https://quinled.info/pre-assembled-boards/ Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23.	Reddit comment · 2026-10
WLED light	Works Local	Works in Home Added automatically in Home app; maintainer tested single and multiple	Maintainer could not reproduce missing light Saved copy Home Assistant release with the issue: 0.102.3 Operating environment (Hass.io/Docker/Windows/etc.): Hass.io Integration: WLED and HomeKit Description of problem: Hello. I have trouble adding WLED to HomeKit. All devices have been added automatically except for WLED. I tried to manually include_entity and exclude_entity but nothing helped. How can I add this light to HomeKit? Why didn't it automatically add like other devices? Excerpt saved from GitHub on 2026-10-23.	Issue #29637 · 2019-12
WLED light via HomeKit Bridge	Works Local	Works in Home Appears as a light in Home app	Added to HomeKit normally; closed as completed Saved copy Home Assistant release with the issue: 0.102.3 Operating environment (Hass.io/Docker/Windows/etc.): Hass.io Integration: WLED and HomeKit Description of problem: Hello. I have trouble adding WLED to HomeKit. All devices have been added automatically except for WLED. I tried to manually include_entity and exclude_entity but nothing helped. How can I add this light to HomeKit? Why didn't it automatically add like other devices? Excerpt saved from GitHub on 2026-10-23.	Issue #29637 · 2019-12
WLED on ESP32	Works Local		Easy to integrate into HA automations; 3 users recommend Saved copy Honestly what i am now switching to is WLED because first of all i am not limited by anything with it and it just really works. I have an ESP32 running WLED and as a test which has now migrated to fully in use i made something like hue ambilight but for my pc which is really neat and works a little too well. The absolute downside to this is some soldering might be required so be aware if you want fancy. WLED is wifi so if that is stable the light will be too. I think the specific strip i have is a ws2812b which is fully rgb and can control each led seperately too. White is unfortunately more … Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23.	Reddit comment · 2024-07
WLED RGBW strips	Works Local		White channel and color modes supported Saved copy Breaking Change: When using WLED with RGBW strips, setting the color in Home Assistant to white, will turn off the RGB LEDs of the strip and use the W channel only. ## Description: WLED supports RGBW strips, however, when selecting white in Home Assistant as the color, the RGB leds will still be turned on, since WLED expects an (R, G, B, W) value. I've discussed this with @aircookie (creator of WLED), and we think it is best to turn of the RGB channels off using (0,0,0) when white is selected in Home Assistant (255,255,255). This allows the user to have a pure white LED strip, while still … Excerpt saved from GitHub on 2026-10-23.	PR #30477 · 2020-01
WLED on ESP8266 (v0.14.1)	Partly works Local		ESP8266 on 0.14.1 unstable with HA websocket; downgrading to 0.14.0 restored stability Saved copy I think there are a couple of different things going on. First, ESP8266 and 0.14.1 don't play well together when connecting to Home Assistant; resource utilization just too high for the little 8266. I reverted all my 8266 WLED strips to 0.14.0 to restore stability. I'm uncertain about the described power issues, but the WLED version will certainly affect things. Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23.	Reddit comment · 2024-01
WLED RGB+CCT (RGBWW) strips	Partly works Local		Only one color model per segment; RGBWW PR closed unmerged Saved copy Proposed change WLED component update to fix rgbww lights, solve #162142 This lets users controls rgbww lights in multiple ways, as: * CCT lights * normal RGB lights * RGBWW lights (parsing RGBWW to RGB+CCT) Tested with a FW1906 addressable led strip With the following WLED se Excerpt saved from GitHub on 2026-10-23.	PR #164597 · 2026-03
QuinLED DigUno	Not working Local		Goes offline after some time until power cycled Saved copy i also have a similiar issue with a QuinLED DigUno (v15.0 b7 - I will update to the v15.0 today)... after some time it shows offline in HA and I can not reach the webinterface anymore. I have to unplug and plug it in again and then it is working fine again... EDIT: board is connected via ethernet Excerpt saved from GitHub on 2026-10-23.	Issue #127360 · 2024-10
WLED on ESP32 with four segments (QuinLED DigQuad)	Not working Local		Device becomes unresponsive over HTTP after about an hour Saved copy I have the same issue with my HA and WLED HA version: 2024.10.2 WLED version: 0.14.4 (flash via https://install.wled.me/) Hardware: HA on Proxmox, WLED on ESP32-WROOM-32 brought via Aliexpress After WLED integration, I lost connection with my WLED. Power unplugged and reconnected also doesn't work. It is back to normal after reflash (without HA integration). p.s. It has nothing to do with 'Disable WiFi sleep', I've uncheck it and still working well without integrated with HA update about testing 10/16/2024 My WLED device work perfectly without integrate with HA. I have also setup MQTT (addon … Excerpt saved from GitHub on 2026-10-23.	Issue #127360 · 2024-10

Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.

How it connects

Local push

Talks to the device on your network, and the device tells Home Assistant the moment something changes.

Found automatically over

Bonjour (zeroconf)

Details

Installs (analytics)	34,075 (4.81%)
Quality scale	Platinum
Added in	Home Assistant 0.102
Set up in the UI	Yes
Maintainers	@frenck, @mik-laj

Limitations from the docs

WLED exposes a single color model per segment in Home Assistant.
The integration relies on the WLED JSON API.
Real-time effects that depend on sound-reactive or 2D matrix features appear in the effect list, but may not behave correctly if the WLED instance was not compiled with those capabilities.
Custom segment names configured in WLED are not used by the integration. Segments are always named using their index (for example, "Segment 1", "Segment 2"), regardless of any names assigned in the WLED interface.
The integration does not support controlling WLED usermods, such as the AudioReactive usermod. Features like toggling the microphone on or off are not available.
There is no segment master control to apply changes (color, effect, brightness) to all segments in a single action. To control multiple segments at once, you can group them using a light group, though this sends separate requests per segment and may result in less smooth transitions compared to WLED's native …
Only the primary color of a segment can be set through the integration. The secondary and tertiary colors that many WLED effects use cannot be controlled directly from Home Assistant. The workaround is to configure those colors in the WLED app or web interface, save the configuration as a preset, and then activate …

In ReReHome

Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.

Bridges get their own settings page listing the accessories behind them.