What is WLED and what can it be used for?

Updated

WLED is an open-source firmware for ESP32 and ESP8266 boards that turns them into network-connected LED controllers. You flash it onto a supported microcontroller, wire up an LED strip or panel, and then control it from a web browser over Wi-Fi. It fits anyone who wants addressable LED lighting they can drive from a phone, browser, or home automation system without writing firmware from scratch.

What WLED actually is

WLED is a fast, feature-rich implementation of an ESP32 webserver built to control addressable LEDs. According to the project's own documentation, it drives:

  • NeoPixel chipsets such as WS2812B, WS2811, and SK6812
  • SPI-based chipsets such as WS2801 and APA102
  • HUB75 video wall panels

The firmware runs on the ESP board itself. The ESP creates its own Wi-Fi access point on first boot (an automatic failsafe AP), and you configure it from there. Once connected to your network, everything is managed through a browser-based interface.

What you can do with it

Lighting effects and control

WLED integrates the WS2812FX library, giving you over 100 special effects, plus FastLED noise effects and 50 palettes. You get a modern UI with color, effect, and segment controls.

Segments are one of the more useful features: they let you assign different effects and colors to different parts of the same LED strip. A single strip can run a rainbow chase on one section and a solid warm white on another.

Presets and automation

You can save and load up to 250 user presets for colors and effects, and cycle through them. Presets can also trigger automatic API calls, which is how most people wire WLED into scheduled or event-driven routines.

Interfaces and integrations

The documentation lists a wide range of control interfaces, including:

Interface What it's for
JSON API / HTTP Request API Direct control from scripts and apps
MQTT Home automation messaging
E1.31 (DMX) / Art-Net DMX lighting setups
DMX input and output Wired lighting consoles
Philips Hue Integration with an existing Hue setup
UDP Sync / UDP Realtime / tpm2.net Synchronizing multiple controllers
WebSocket / DDP Realtime Low-latency streaming control
ESPNow Remotes Wireless remote control
Serial Direct wired control

There is also a dedicated Home Automation section and Remote Access / IFTTT support in the advanced documentation.

Hardware capacity

  • Up to 3 LED outputs per ESP8266 instance
  • Up to 10 LED outputs per ESP32 instance
  • Support for RGBW strips
  • Relay control and multi-strip support

Other built-in functions

  • Nightlight — gradually dims the lights down
  • Full OTA software updates over HTTP, with optional password protection
  • Configurable analog clock, plus support for the Cronixie kit
  • Audio reactive effects (covered in the advanced section)
  • Ethernet (LAN) compatibility
  • Pixel art tools — a Pixel Art Converter, PixelForge for images and GIFs, and custom fonts

Who it's for

WLED suits you if you want:

  • Smart LED strips — desk, shelf, or room accent lighting controlled from a browser or phone
  • Ambient and decorative lighting — effects, palettes, and segments for scenes
  • DIY lighting projects — matrix panels, HUB75 video walls, or multi-strip builds
  • Home automation integration — MQTT, JSON API, and IFTTT hooks into a larger smart home
  • Synchronized multi-controller setups — UDP sync and realtime protocols across several boards

It is less suited to someone who wants a plug-and-play consumer product with no wiring or flashing. WLED requires a compatible ESP board, a supported LED strip or panel, and a power supply sized for your LEDs.

Getting started

The documentation's quick start path is:

  1. Check compatibility — confirm your LED strip and controller board are supported (see the Compatibility section for LED strips, controllers, and other hardware).
  2. Install the firmware — options include installing the WLED binary, using the ESP GUI, or the WLED ESP Flasher.
  3. Wire it up — follow the Wiring Guides.
  4. Configure over the network — connect to the WLED access point, then set up station mode so it joins your Wi-Fi.
  5. Control it — use the Web UI for colors, effects, segments, and presets.

The project also maintains a Top 5 mistakes page and a FAQ, both worth reading before your first build — the wiring and power pitfalls are the ones that most commonly trip up new users.

Where to look next

The documentation is organized into Basics, Compatibility, Software Installation, Features, Interfaces, Advanced, Wiring, Compiling, Community Usermods, and About sections. If you are deciding whether WLED fits your project, the Features and Compatible Hardware pages answer most of it. If you have already decided, start with Getting Started and the Wiring Guides.