Skip to content
Control WS2812B RGB LEDs with an ESP8266 over WiFi!
Branch: master
Clone or download

WLED logo

Welcome to my project WLED!

A fast and feature-rich implementation of an ESP8266/ESP32 webserver to control NeoPixel (WS2812B, WS2811, SK6812, APA102) LEDs!


  • WS2812FX library integrated for 80 special effects
  • FastLED noise effects and palettes
  • Customizable Mobile and desktop UI with color and effect controls
  • Settings page - configuration over network
  • Access Point and station mode - automatic failsafe AP
  • Support for RGBW strips
  • 25 user presets to save and load colors/effects easily, supports cycling through them.
  • Macro functions to automatically execute API calls
  • Nightlight function (gradually dims down)
  • Full OTA software updatability (HTTP + ArduinoOTA), password protectable
  • Configurable analog clock + support for the Cronixie kit by Diamex
  • Configurable Auto Brightness limit for safer operation

Supported light control interfaces:

  • WLED app for Android and iOS
  • JSON and HTTP request APIs
  • MQTT
  • Blynk IoT
  • E1.31
  • Hyperion
  • UDP realtime
  • Alexa voice control (including dimming and color)
  • Sync to Philips hue lights
  • Adalight (PC ambilight via serial)
  • Sync color of multiple WLED devices (UDP notifier)
  • Infrared remotes (24-key RGB, receiver required)
  • Simple timers/schedules (time from NTP, timezones/DST supported)

Quick start guide and documentation:

See the wiki!

DrZzs has made some excellent video guides:
Introduction, hardware and installation
Settings, tips and tricks

If you'd rather read, here is a very detailed step-by-step beginner tutorial by tynick!


Licensed under the MIT license
Credits here!

Uses Linearicons by Perxis!

Join the Discord server to discuss everything about WLED!
You can also send me mails to
If WLED really brightens up your every day, you can

You can’t perform that action at this time.