WLED is a fast and feature-rich implementation of an ESP8266/ESP32 webserver to control NeoPixel (WS2812B, WS2811, SK6812, APA102, and similar) LED’s.
While Home Assistant supports WLED 0.8.4 and higher, the use of WLED 0.10 and newer is recommended to get the optimal experience.
This integration can be configured using the integrations in the Home Assistant frontend.
Menu: Configuration -> Integrations.
In most cases, the WLED devices will be automatically discovered by Home Assistant. Those automatically discovered WLED devices are listed on the integrations page.
If for some reason (e.g., due to lack of mDNS support on your network), the WLED device isn’t discovered, it can be added manually.
Click on the
+ sign to add an integration and click on WLED.
After completing the configuration flow, the WLED
integration will be available.
This integration adds the WLED device as a light in Home Assistant. Home Assistant treats every segment of the LED strip as a separate light entity.
Only native supported features of a light in Home Assistant are supported (which includes effects).
WLED can split a single LED strip into multiple segments. These segments can be controlled separately in WLED and in Home Assistant as well. The fully-featured segment control has been introduced in WLED 0.10 but has been partly around via APIs since WLED 0.8.6.
If WLED has 1 segment defined (the default), that one segment controls the whole LED strip. Home Assistant creates a single light entity to control the strip.
If WLED has 2 or more segments, each segment gets its own light entity in Home Assistant. Additionally, a master light entity is created. This master entity controls the strip power and overall brightness applied to all segments.
This integration provides sensors for the following information from WLED:
- Estimated current (in mA).
- Uptime (disabled by default)
- Free memory (in bytes, disabled by default).
- Wi-Fi Signal Strength (in %, disabled by default).
- Wi-Fi Signal Strength (RSSI in dBm, disabled by default).
- Wi-Fi Channel (disabled by default).
- Wi-Fi BSSID (disabled by default).
The integration will create a number of switches:
- Sync Receive.
- Sync Send.
Currently, the WLED integration provides one service for controlling effect. More services for other WLED features are expected to be added in the future.
This service allows for controlling the WLED effect.
|Service Data Attribute||Required||Description|
||no||A WLED entity ID, or list entity IDs, to apply the effect to. Use
||no||Name or ID of the WLED light effect.|
||no||Intensity of the effect. Number between
||no||Name or ID of the WLED light palette.|
||no||Speed of the effect. Number between
||no||Reverse the effect. Either
A list of all available effects (and the behavior of the intensity for each effect) is documented in the WLED Wiki.