Start here if you’ve never used WLED before — this explains the basics in plain language before you touch any hardware.
The guide is organised into sections — What Is WLED, What You Need, How It Works, and Common Mistakes. Use the jump links near the top to skip straight to whichever section answers your question.
This section explains, without jargon, what WLED firmware actually does and why people use it instead of commercial smart lighting like Govee or Hue.
This section lists the four essential components for any WLED build (controller, power supply, LED strip, wiring) so you know exactly what to shop for before opening the Hardware Database or Buying Guide.
This covers the small errors that cause the majority of first-build problems — reversed polarity, undersized power supplies, and skipped fuses.
The Beginner's Guide is the right starting point if you have never worked with WLED, ESP32 controllers, or addressable LED strips before. It explains the core concepts and vocabulary you need to understand the rest of the site, and covers the four essential hardware components with purchasing guidance.
Read the Beginner's Guide from start to finish before moving to any other page. It establishes the foundation — what WLED is, what each hardware component does, how they connect — that the more detailed guides and calculators assume you know. It takes about 10 minutes to read.
Once you have read the Beginner's Guide: use the Power Calculator to spec your power supply and fuse, check the Hardware Database to choose a controller, optionally check the LED Strip Comparison to confirm your strip choice, then follow the Build Guide for the physical installation and firmware setup.
The Glossary covers every technical term used across the site. If you encounter a word in the Beginner's Guide that is not explained, look it up in the Glossary. If you have a specific question not covered, the WLED Discord (linked in the footer) has an active help channel with community members available around the clock.
No. WLED's web interface, effects, and presets are fully usable with no coding at all. Basic scripting knowledge only helps if you want custom integrations (like Home Assistant automations), which are optional.
A single ESP32 dev board, a short WS2812B strip, and a matched 5V power supply is the cheapest realistic entry point. Use the Power Calculator with your intended strip length before buying, so you don't undersize the supply and have to buy a second one.
Yes, provided you follow basic electrical safety: correctly size your power supply and fuse using the calculators here, don't exceed a strip's rated maximum run length without power injection, and check for warm connectors after the first hour of use. See our Disclaimer for the full safety context.
Usually, as long as they're one of the common addressable chipsets (WS2812B, WS2811, SK6812, APA102, WS2815) and you have a compatible ESP32/ESP8266 controller. Check the LED Strip Comparison page to confirm your strip's chipset is supported before flashing.