What Are the Key Features of WLED?

Updated

WLED is a fast, feature-rich firmware implementation of an ESP32 (and ESP8266) webserver for controlling addressable LEDs. It supports NeoPixel chipsets like WS2812B, WS2811, and SK6812, SPI-based chipsets like WS2801 and APA102, and HUB75 video wall panels. If you want a single firmware that handles effects, color control, network integrations, and over-the-air updates without writing your own code, WLED covers that scope.

Effects and color control

  • WS2812FX library integration — provides over 100 special effects out of the box.
  • FastLED noise effects — adds organic, noise-driven animations on top of the standard effect set.
  • 50 palettes — predefined color gradients you can apply across effects.
  • Modern UI — color, effect, and segment controls are exposed through a web interface rather than requiring code changes.
  • RGBW strip support — works with four-channel strips, not just RGB.

Segments, presets, and macros

  • Segments let you assign different effects and colors to different parts of a single LED strip, so one physical strip can behave like multiple independent zones.
  • Up to 250 user presets save and load colors and effects easily, and you can cycle through them.
  • Presets can trigger API calls automatically, which turns them into lightweight macros for automation.
  • Macros are a documented feature area for chaining actions.

Hardware and output capacity

Platform Max LED outputs per instance
ESP8266 Up to 3
ESP32 Up to 10

This matters if you're planning a multi-strip build: an ESP32 gives you substantially more independent output channels than an ESP8266.

Network, control interfaces, and integrations

WLED exposes a broad set of control paths, which is often the deciding factor for whether it fits a project:

  • Web UI — the primary interface for configuration and control.
  • JSON API, HTTP Request API, and WebSocket — for programmatic control.
  • MQTT — for home automation message buses.
  • E1.31 (sACN) / Art-Net and DMX input/output — for lighting-industry protocols.
  • UDP sync, UDP Realtime / tpm2.net, DDP Realtime, ESPNow — for multi-device synchronization and real-time streaming.
  • Philips Hue — integration with an existing Hue setup.
  • Home Automation and Remote Access / IFTTT — documented integration paths.
  • Audio Reactive — effects that respond to sound.

Setup, updates, and reliability features

  • Access Point and station mode with automatic failsafe AP — if the device can't join your network, it falls back to its own access point so you can still reach it.
  • Settings page — full configuration over the network, no reflashing needed.
  • Full OTA software updatability over HTTP, which can be password protected.
  • Nightlight function — gradually dims the LEDs down instead of cutting them off abruptly.
  • Configurable analog clock, plus support for the Cronixie kit by Dia.

Other capabilities worth knowing

The documentation also covers multi-strip support, relay control, Ethernet (LAN) compatibility, white handling (relevant for RGBW), a Pixel Art Converter and PixelForge image/GIF tool, custom fonts, a particle system, and HUB75 mapping including mixed 2D and 1D bus configurations.

How to decide if WLED fits your project

  • Choose WLED if you want addressable LED control with a ready-made web UI, a large built-in effect library, and one of the widest protocol/integration sets available in this space — especially if you need MQTT, E1.31/Art-Net, or multi-device sync.
  • Pay attention to output count if you're driving many independent strips: ESP8266 caps at 3 outputs, ESP32 at 10.
  • Check the compatibility pages for your specific LED strip and controller before buying, since supported chipsets are listed explicitly (NeoPixel WS2812B/WS2811/SK6812, SPI WS2801/APA102, and HUB75 panels).

For installation paths, the documentation lists installing the WLED binary, using ESP GUI, or using WLED ESP Flasher, alongside a Quick Start guide and a "Top 5 mistakes" page that's worth reading before your first flash.