What is WLED? A Complete Beginner's Guide (2026)
Share
What is WLED in One Sentence?
WLED is free, open-source software for ESP32 and ESP8266-based microcontrollers that turns a simple circuit board into a powerful smart LED controller for DIY lighting setups. Install it once, connect your LED strip, and control 16 million colours from your phone — no subscriptions, no cloud accounts, no expensive hubs.
Think of it like this: if your LED strip is a speaker, WLED is the amplifier. The strip can't do much on its own — it needs a controller running WLED to tell it what colours to show, when to turn on, and how to react to music. That's what WLED does.
⚡ Quick Start (3 steps)
- Buy a pre-flashed ESP32 WLED controller
- Connect a WS2812B addressable LED strip
- Open the WLED app — your lights appear automatically
What Makes WLED Different from Normal LED Strips?
Most standard LED strips sold in hardware stores are "dumb" strips — the entire strand can only be one colour at a time. If you want blue, the whole thing turns blue.
WLED controls addressable LEDs, where every single bulb can be a different colour and brightness at the exact same time. This is what creates those fluid rainbow waves, chasing holiday lights, and music-synced effects you've probably seen online.
What Can WLED Do?
Once WLED is running on a controller, here's what you get:
Control from your phone Open the WLED app or web page. Tap to turn lights on or off, pick colours, adjust brightness. No account creation, no app store registration.
100+ lighting effects Rainbow waves, fire, twinkle, colour swirl, pulse, chase lights, and dozens more. Some are subtle (warm candle flicker), some are dramatic (full party mode).
Music reactivity With a controller that has a built-in microphone, your lights dance to whatever music is playing. Bass triggers one colour, treble triggers another. Some sound-reactive setups include spectrum analysis features.
Schedules and automation Set lights to turn on at sunset, dim at midnight, and flash when your doorbell rings. WLED integrates with Home Assistant automatically. It can be integrated with Alexa and Google Home using Home Assistant or compatible smart home bridges.
You own everything There's no subscription or cloud dependency — you control how it runs. WLED is open source, which means it does not require a paid plan or server connection to function.
Why Choose WLED Over Store-Bought Brands?
| Feature | WLED | Philips Hue / Govee / Nanoleaf |
|---|---|---|
| Custom effects | 100+, community-built | 10–20 presets, locked |
| Music reactivity | Sound-reactive, spectrum analysis | Basic pulse mode |
| Smart home | Auto-discovers in Home Assistant | Rarely compatible |
| Ownership | Local control, offline | Often cloud-dependent |
| Cost | Lower upfront cost | Higher upfront cost |
What Do You Need to Use WLED?
Three things:
1. A WLED-Compatible Controller
This is the brain — a small circuit board based on an ESP32 microcontroller (or the older ESP8266) with built-in Wi-Fi, about the size of a credit card, that runs the WLED software. For beginners, buy a pre-flashed controller so the software is already installed. Plug it in and go.
Browse our range of pre-flashed WLED controllers on Zelco — all come with WLED pre-installed, ready out of the box.
Not sure which one to pick? See our guide: Find Your Perfect WLED Controller.
2. An Addressable LED Strip
You cannot use a standard LED strip. Look for "addressable" or "digital" strips. Common types:
| Model | Voltage | Best for | Key Feature |
|---|---|---|---|
| WS2812B | 5V | Indoor desks, TV backlighting, small projects | Most common, highly affordable |
| SK6812 | 5V | Kitchen under-cabinets, accent lighting | Dedicated white chip for true, clean white light |
| WS2811 | 12V | Longer runs like rooflines and outdoor holidays | LEDs are controlled in groups of 3 |
| WS2815 | 12V | Outdoor, long distances, backup data lines | Every pixel is individual; if one dies, the rest stay lit |
3. A Power Supply
The power supply takes electricity from your wall and converts it to the voltage your lights need.
The most important rule in WLED: match your voltage. If you buy 5V lights, you must use a 5V power supply. If you buy 12V lights, use a 12V supply.
A small desk setup needs a phone charger. A full room needs something bigger.
What Can You Build with WLED?
| Project | What it looks like | Controller you'd need |
|---|---|---|
| TV backlight | WLED TV backlight setup — colourful glow behind your TV, reacts to music | MIC sound-reactive controller |
| Under-cabinet kitchen lighting | Warm white light for food prep, colour for parties | 5V mini or 12–24V mini controller |
| Permanent outdoor roofline | WLED roofline lights — colour or warm white along your house year-round | Outdoor-rated or multi-output controller |
| Gaming desk setup | WLED gaming desk RGB — strip behind your monitor | 5V mini controller |
| Whole-home sync | Every room playing the same effect in perfect timing | Multiple controllers with UDP sync |
Already know your project? Read our DIY Permanent Outdoor Lighting Guide or our Sound-Reactive TV Backlight Guide.
How to Set It Up
The process takes less than ten minutes once you have the parts:
1. Connect the strip Connect your LED strip to the controller. Most beginner-friendly controllers use plug-in screw terminals — no soldering required.
2. Power on Plug your power supply into the wall and connect it to the controller.
3. Wi-Fi setup On your phone, look for a new Wi-Fi network named "WLED-AP". Connect to it. A setup page will open automatically — enter your home Wi-Fi details so the controller joins your network.
4. Use the app Download the WLED app from the App Store or Google Play. It will automatically find your lights, and you can start choosing colours, effects, and patterns immediately.
A Real UK Example
In a typical UK semi-detached home, a WLED setup often starts small. A popular first project is a 2-metre WS2812B strip behind a living room TV, powered by a compact 5V controller tucked behind the TV stand. While a standard UK USB power adapter can run a short strip like this, the clever trick is using WLED’s built-in automatic brightness limiter in the software settings. This keeps the power draw perfectly safe for a standard household plug, costing a fraction of a commercial kit and taking under half an hour from unboxing to your first custom light show.
From there, many people expand — adding under-cabinet strips in the kitchen, outdoor pixels along the roofline, or syncing multiple rooms together. The same WLED software and app manage it all, so you're never starting from scratch.
Is WLED Difficult to Set Up?
Not at all — with a pre-flashed controller, the basic setup is genuinely plug-and-play. Most people go from unboxing to lights on in under 10 minutes.
Where it gets more complex is large projects — long strip runs need power injection, outdoor installations need weatherproofing, and multi-room sync needs a bit of network setup. But a basic single-strip setup is simple.
Safety Tips for Beginners
Mind the heat: LED strips can get warm. For permanent installations, use an aluminium channel to dissipate heat and protect the strip.
Don't overload: If you plan on running more than 5 metres of lights, you may need a larger power supply. Always check the amperage rating.
Use the software brightness limiter: If powering your controller via a standard USB port or phone charger, remember to configure WLED's built-in brightness limiter (e.g., set to 850mA - 2000mA depending on your adapter) to prevent brownouts or overheating.
Watch for voltage drop: On long runs, the end of your strip may look dimmer than the start. This is normal — you fix it by "injecting" power at the midpoint or end of the strip.
Start simple: Begin with a small project, like a 2-metre strip behind a desk or under a cabinet, before attempting a whole-house installation.
Why WLED Is So Popular
WLED has become the go-to platform for DIY smart lighting because it combines:
- Open-source flexibility — no vendor lock-in, no forced updates
- Active development — WLED is maintained by an open-source community and regularly updated with new features and bug fixes
- Strong community — active forums, Discord servers, and user-contributed effects
- Wide hardware compatibility — works with dozens of strip types and ESP32-based controllers
- Local control — everything runs on your network, no cloud dependency
- Low cost — a full setup costs a fraction of commercial smart lighting ecosystems
It's widely used by hobbyists and professional installers alike.
Frequently Asked Questions
Is WLED free?
Yes, WLED is completely free and open-source. There are no paid tiers, subscriptions, or premium features locked behind a paywall.
Does WLED need the internet?
No. WLED works entirely on your local Wi-Fi network. Once set up, it continues functioning even if your internet connection drops.
Can WLED control any LED strip?
No. WLED only works with addressable (digital) LED strips such as WS2812B, SK6812, WS2811, and WS2815. Standard "dumb" LED strips are not compatible.
Does WLED work with Alexa or Google Home?
Yes. WLED integrates with Home Assistant automatically. Alexa and Google Home support is available through Home Assistant or compatible smart home bridges.
Is WLED good for beginners?
Yes. With a pre-flashed controller, the basic setup is plug-and-play. No coding, no soldering, no technical background required.
What's the difference between 5V and 12V LED strips?
5V strips (like WS2812B) are ideal for short runs and indoor projects. 12V strips (like WS2811) handle longer distances better and suffer less from voltage drop, making them the preferred choice for outdoor roofline installations.
Is WLED safe to use permanently?
Yes, when installed correctly. Use a properly rated power supply, ensure good ventilation around the controller and strip, and use aluminium channels for heat dissipation on permanent indoor installations. For outdoor installations, use weatherproof (IP65 or IP67) components and protect all connections from moisture. WLED itself runs on low-voltage DC — the same safety category as phone chargers and USB devices.
Where Do I Start?
- Pick a project — TV backlight, kitchen, outdoor, desk, whatever excites you
- Choose a controller — Browse our range of pre-flashed WLED controllers, all pre-installed with WLED
- Buy a compatible LED strip — 5V or 12V addressable RGB or RGBW strip
- Follow the setup guide above — connect, power, open the app
Still unsure? Drop us a message — we'll point you to the right product for your project.
Was this helpful? Save it for later or share it with someone who keeps asking "what's WLED?"
New to WLED? Check out our other beginner-friendly guides: