WLED on ESP8266 — Full Setup Guide for LED Strips

What WLED is (and when to use it).

WLED is a free, open-source firmware for ESP8266 and ESP32 that turns addressable LED strips (WS2812B, WS2811, SK6812, APA102, and others) into a controllable lighting system you can drive from a phone, browser, Home Assistant, or DMX console. It ships with hundreds of effects — rainbow, fire, palette cycles, audio reactive — plus a clean web UI for saving and recalling presets.

It's not the right tool for everything. If you're switching four 12V uplighters on and off for a wedding, WLED is overkill — a $1 relay module and a small sketch is more predictable and easier to debug. If you're running 2 m of WS2812B along a backdrop and want phone-controlled rainbow, WLED is exactly what you want.

The ESP8266 port of WLED is mature and works well up to a few hundred LEDs. ESP32 is the better pick for very large installs, high LED counts, or any audio-reactive effect you want to run smoothly — its extra RAM and dual cores handle the audio FFT without dropping frames.

Parts for any WLED-on-ESP8266 build.

Most of these are reusable across projects. The only thing you'll change per build is the strip type and the power supply.

Flash WLED in under 10 minutes.

You don't need the Arduino IDE, no toolchain, no driver hunting. WLED has a browser-based installer that does everything from a Chrome tab.

Flashing with the web installer

1. Open wled-install.github.io in Chrome (or Edge). Chrome's WebSerial support is what makes this work — Firefox won't.
2. Click Install WLED. The page will download the latest WLED_0.x.x_ESP8266.bin build.
3. Plug your ESP8266 into a USB port on the computer.
4. Click Connect, pick your board's serial port (usually USB Serial or CH340), and click Install.
5. Wait ~30 seconds. The installer will say "Done" and reboot the ESP8266.

That's it — no manual driver install, no compile step, no esptool.py command line. If the serial port doesn't show up, swap USB cables (charge-only cables are the #1 cause of "nothing happens"); otherwise install the CH340 driver.

First boot and connecting to WiFi

After the reboot, the ESP8266 broadcasts its own WiFi network. On your phone or laptop, look for:

• SSID: WLED-AP
• Password: wled1234

Connect to that network, then open 4.3.2.1 in a browser. You'll land on the WLED UI. From there, go to Config → WiFi and join your normal home/venue network. The ESP8266 will reboot and come back on your network — at which point you can disconnect from WLED-AP and use it like any other device on WiFi.

For events where there's no router at all (common in tents and outdoor venues), just stay on WLED-AP. It works standalone — phone controls the strip directly through the ESP8266, no internet needed.

Wire it for event lighting.

WLED shines on addressable strips, but you can mix in 12V relay control too — same firmware, different wiring. Here's how I typically wire both.

   ESP8266 (Wemos D1 mini)              5V power supply
   ┌──────────────┐                     ┌──────────────┐
   │              │                     │              │
   │ 5V/VIN ──────┼─────┐            ┌──┤ 5V +     +5V ├──► strip 5V
   │              │     │            │  │              │
   │ D2/GPIO4 ────┼─────┼──► strip DIN  │              │
   │              │     │            │  │              │
   │ GND ─────────┼─────┴────────────┴──┤ GND     GND ├──► strip GND
   └──────────────┘                     └──────────────┘

   Add a 470Ω resistor in series with the data line,
   and a level shifter (74HCT245) past ~2m of strip.

             ┌──────────────┐
   12V + ───┤  LED fixture  │
             │   (12V DC)   │
   12V − ───┤              │
             └──┬───────────┘
                │
         ┌──────┴──────┐
         │   Relay     │   ← switch side
         │   COM ──────┼──── 12V +
         │   NO  ──────┼──── to fixture +
         │   NC         │   (leave NC unconnected)
         └──┬───────────┘
            │
            GND ←───────────── supply GND ─── ESP8266 GND
                ┌──────────────┐
   ESP  5V ─────┤  Relay coil  │
                │   VCC        │
   GPIO D1 ─────┤   IN         │   ← active-low on most modules
                │   GND ───────┼─── ESP8266 GND
                └──────────────┘

Save the looks before the event.

The whole point of using WLED for events is that you don't fiddle with the UI on the day — you build and save presets during prep, then recall them with one tap when the band kicks in.

Build three to four presets per event. For a wedding, my typical set is:

• Ceremony — single warm-white colour, brightness ~30%, no animations. Quiet look.
• Dinner — soft amber or cool white, brightness ~40%. Conversational vibe.
• Dance floor — full rainbow or palette cycle at brightness ~80%. Energy for the music.
• Exit / send-off — slow colour chase or fade-to-warm. Clean ending.

To save a preset: set the colours/effect/brightness in the WLED UI, then go to the Presets tab and click Save current state as preset #N. Recall them with one tap, with the API, with a physical button, or with Home Assistant.

For events that need to be bulletproof, set up a fallback to AP mode: if the venue WiFi drops, WLED will fall back to broadcasting its own network so the show keeps running from any phone that's still connected.

Where WLED on ESP8266 stops being the right tool.

WLED on ESP8266 is great — but it's not magic. Here are the limits you'll hit, in the order you'll hit them.

If WLED feels like overkill for what you need.

Who wrote this guide.