Never heard of WLED before? This guide explains everything in plain English — what it is, what you need, how to set it up, and how to get the most out of it.
WLED is free, open-source software (called firmware) that you install on a tiny $3-10 Wi-Fi microcontroller chip. Once installed, that chip plugs into your LED strips and lets you control them wirelessly — no subscriptions, no cloud, no hub required.
Think of it like this: your LED strip is the screen, the microcontroller is the graphics card, and WLED is the software. WLED gives you 180+ built-in lighting effects, a full colour picker, music reactivity, and smart home integration.
It was created in 2018 by Christian Schwinne (Aircoookie) and is now used by hundreds of thousands of people worldwide.
A basic WLED setup needs four things:
A WLED controller
The Athom WLED Controller or a QuinLED board are ideal — they come pre-flashed with WLED.
Browse hardware ->A power supply
You need a dedicated 5V or 12V DC power supply — not a phone charger.
Calculate your PSU ->Wire, connectors, and a fuse
You need appropriately gauged wire and a fuse in the positive line for safety.
Each LED contains a tiny IC that receives colour instructions over a single data wire. The controller sends colour data for every LED, 30-60 times per second.
WLED runs a web server on the microcontroller. When you connect from your phone, you're accessing a tiny website hosted on that chip.
The microcontroller and LED strip run off DC power — no dangerous mains voltage in the LED wiring itself.
Plan your build
Decide where your LEDs will go and what voltage to use. Use the power calculator to work out PSU size and fuse rating.
Buy your components
Get a WLED-compatible controller, the correct LED strip, a suitably rated power supply, wire, fuse holder, and connectors.
Flash WLED (if needed)
Visit install.wled.me in Chrome, connect the board via USB, and click Install.
Wire up your system
Connect PSU to controller and strip, with fuse in the positive line and a 300-470 ohm resistor on the data line.
Double-check polarity
Verify + and - are connected correctly. Reversing polarity destroys the LED strip.
Power on and connect
Connect to WLED-AP hotspot (password: wled1234), then open 4.3.2.1 in your browser.
Configure WLED
In Config > LED Preferences, set LED type, data pin, LED count, and maximum current.
Connect to your Wi-Fi
In Config > Wi-Fi, enter your home network credentials.
Once your LEDs are lit up, explore these features first:
Effects
Browse 180+ effects — each has Speed and Intensity sliders.
Palettes
Try Party, Ocean, Lava, or Forest to completely change an effect's look.
Presets
Save your favourite effect + palette combinations for instant recall.
Segments
Divide your strip into sections with different effects on each.
Schedules
Create schedules to automatically turn effects on/off at specific times.
Sync
Enable UDP sync to make multiple WLED devices mirror the same effect simultaneously.
Using a USB phone charger as the power supply
Fix: USB chargers cannot supply enough current for more than ~30 LEDs. Always use a dedicated 5V or 12V PSU.
Skipping the fuse
Fix: A fuse in the positive wire is cheap insurance against wire fires.
Wrong LED type in WLED settings
Fix: If colours look wrong, check Config > LED Preferences and try different colour orders (GRB, RGB, BGR).
Connecting power to one end only on long strips
Fix: For strips over 3m at 5V, inject power from both ends and at intermediate points.
Not setting a maximum current in WLED
Fix: Set the mA limit in Config > LED Preferences to protect your PSU.
Using thin wire for high current runs
Fix: Undersized wire gets hot and can cause fires. Use the wire gauge calculator.