WLED guides

Step-by-step help for WLED lights, with the exact settings we tested.

Results appear as you type. Use the up and down arrow keys to pick one and Enter to open it.

Popular searches

New to WLED? Start here

  1. Set up a new light on Wi-FiJoin WLED-AP, open 4.3.2.1, add your network.
  2. App can't find your lightsThe usual Wi-Fi and phone settings to check.
  3. Effects list with previewsEvery effect with a preview and what the sliders do.

Browse by topic

Get started

6 guides

New board, the app and your first settings.

Show 3 moreShow fewer

Colors and effects

5 guides

Get the look you want, from warm white to music.

Show 2 moreShow fewer

Segments, presets and playlists

5 guides

Split a strip, save looks, run several lights.

Show 2 moreShow fewer

Schedules and automation

8 guides

Timers on the light, Siri, Tasker and widgets.

Show 5 moreShow fewer

Fix a problem

6 guides

Lights offline, errors, updates that fail.

Show 3 moreShow fewer

Smart home and big displays

3 guides

Apple Home, Home Assistant, rooflines and shows.

Diwali and Christmas

Holiday patterns with exact settings

Red and green, candy cane, C9 style bulbs with dark gaps and diya patterns, plus a presets file and power numbers for long rooflines.

Open the patterns guide All holiday lights
  1. Set up a new light on Wi-Fi
  2. Effects list with previews
  3. Repeating patterns like 2 red 1 white
  4. Segments explained
  5. On at sunset, off at bedtime

Newest guides

  1. Home Assistant problems and fixes
  2. WLED in Apple Home
  3. Roofline lights and power
  4. Holiday colors with hex codes
  5. Move to a new phone
Using WLED Max?

WLED Max tutorials

The main features of the app for iOS and Android, each linked to the step-by-step part of a guide.

Background reading

Article The Story of WLED: Ten Years From One Commit to a Community How WLED began in 2016 as one developer's ESP8266 side project and grew into a community firmware for addressable LEDs. Every date and number sourced.

Other guides: remote access

Not about WLED. Reach any device on your home network from anywhere.

WLED is an open source project (kno.wled.ge). We write these guides and make the WLED Max app; we are not part of the WLED project.