WLED Roofline and Outdoor Lights: Planning, Power and Injection
Plan permanent roofline or outdoor lights on WLED: how many amps, what power supply, where to inject power and how thick the wire must be. With a small calculator.
Quick answer: multiply the number of LEDs by what one LED draws at full white (55 mA for typical 5 V strips, about 30 mA for 12 V pixels), add 20 % for the power supply, and feed power in at more than one point once the current goes past about 4 A. For a long roofline, 12 V or 24 V pixels save you a lot of copper. The calculator below does the arithmetic.
A roofline is where most WLED setups grow up. A strip behind the TV runs fine off a phone charger. Forty meters of pixels along the gutter needs a real power supply, thick wire and a plan for where the power goes in. Getting that right at the start is far easier than fixing orange, flickering lights on a ladder in December.
Plan the run first
Walk the roofline with a tape measure and write down three things:
- Total length, broken into sections: front, garage, porch, peaks.
- Pixel spacing of the product you’re looking at. Permanent track lights and bullet pixels usually come with one pixel every few inches; strips come in 30, 60 or more LEDs per meter. Length times density gives you the LED count.
- Where power is. An outlet in the garage or the attic decides where the controller and supply sit, and that decides how long your wires are.
Put the controller and power supply near the middle of the run if you can. Two outputs going left and right are shorter than one going all the way around, and shorter runs mean less voltage drop and a faster frame rate.
On the WLED side, keep each output under about 800 LEDs. WLED’s own LED settings page warns above that (“Use less than 800 LEDs per output for the best experience”), and there’s a reason: WS281x pixels take about 30 microseconds each to update, so 800 pixels already take 24 ms per frame, which is about 40 frames per second. An ESP32 has several outputs, so a 1,500 LED roofline is two or three outputs, not one long chain. ESP8266 boards handle small outdoor jobs, but for a whole house use an ESP32.
5 V, 12 V or 24 V
| 5 V | 12 V | 24 V | |
|---|---|---|---|
| Common parts | WS2812B strips, SK6812 RGBW | WS2811 bullet pixels and strips, WS2815 | WS2814 RGBW strips, some permanent light kits |
| Current for the same light | highest | about half of 5 V | about a quarter of 5 V |
| Voltage drop | shows up after a few meters | much less | least |
| Power injection | many points | a few | few |
The light output is similar; what changes is how many amps carry it. Watts are what the LEDs turn into light, and at 12 V the same watts need far fewer amps than at 5 V. Fewer amps means thinner wire and fewer injection points. That’s why most outdoor and permanent installs use 12 V or 24 V. QuinLED’s power injection guide works through the same 20 m strip at all three voltages: 5 V needs five feed points, 12 V three, 24 V two.
Two things to check when you pick parts. The color order differs: WS2812B strips are usually GRB, while many WS2811 bullet pixels are RGB. If red shows as green, change Color Order in WLED’s LED settings. And 12 V WS2811 pixels drive three LEDs from one chip, so WLED sees one “LED” per chip. Count chips, not LEDs, when you enter the LED count.
The calculator
Fill in what you know. The results update as you type. Nothing is sent anywhere.
How the numbers are worked out
Nothing in the calculator is magic. Here’s each line, so you can check it or do it by hand.
- Full white, full brightness = LEDs × mA per LED ÷ 1000, in amps. 600 pixels at 30 mA is 18 A. Watts are amps × volts, so 216 W at 12 V.
- At your limit = the same, times the brightness limit. Real effects almost never light every LED full white, but holiday white is exactly that, so plan for it unless the limiter caps you.
- Power supply adds about 1 mA per LED (pixels draw a little even when dark, and WLED’s own estimate subtracts the same), 0.12 A for an ESP32 board, then 20 % headroom. A supply run at its label rating all evening runs hot, and outdoor boxes get warm on their own.
- WLED Maximum PSU Current is what you type into WLED’s brightness limiter: the planned load without the headroom. WLED lowers brightness to stay under it.
- Feed points is a rule of thumb, not physics. QuinLED’s guide works with about 4 A into a strip from a feed at its end and about 8 A from a feed in the middle, where the current splits both ways. Fewer than that and the strip’s own thin copper becomes the problem.
- Feed wire drop is current × resistance × twice the length (out and back), using copper’s standard resistance per AWG size. QuinLED’s rule is no more than 10 % drop on an injection wire; 5 % or less looks better.
The 4 A, 8 A, 10 % and 20 % numbers are rules of thumb people use to get close. Strips differ in how much copper they have, and pixels differ in what they draw. Measure before you trust it: run full white and check the voltage at the far end with a multimeter.
Power injection, done safely
Injection means running extra power wires from the supply to points further along the lights. Only the plus and minus wires; the data line stays a single chain from the controller through every pixel.
- Every feed gets a fuse sized for the thinnest wire on that feed. WLED says the same in its own LED settings once you enter more than 7.2 A: “use thick cables, multiple power injection points and a fuse”.
- Grounds are shared. The controller, every supply and the lights need a common ground, or the data signal has nothing to refer to and you get random flicker.
- Two supplies, two sections. With more than one power supply, connect their minus wires together but never their plus wires. Cut the plus line between sections fed by different supplies.
- Don’t power lights from the board’s 5 V pin. WLED’s settings page warns to keep it under 1 A if you do. A roofline goes straight to the supply.
You’ll know injection is short when full white looks fine near the controller and turns yellow, then orange, further along. That’s voltage drop: blue and green need more voltage than red, so they fade first. Lowering Maximum PSU Current hides it by keeping brightness down, but the real fix is another feed point.
Outdoor specifics
- Put the controller and supply in a weatherproof box or inside the garage or attic, and bring only the light wires out.
- Leave a drip loop before every cable enters a box, so water runs off instead of following the wire in.
- Plug the supply into a GFCI-protected outlet. Outdoor outlets usually are, but check.
- Keep the data wire from the controller to the first pixel short. If it has to be long, a level shifter on the controller side (or a controller board that has one built in) keeps the signal clean.
- Give the controller a fixed address with a DHCP reservation in your router, so timers, Home Assistant and apps always find it.
Setting it up in WLED
Once it’s wired:
- In Config›LED & Hardware (LED Preferences on 0.14 and 0.15), set each output’s LED count, data GPIO, type and color order.
- Tick Enable automatic brightness limiter, set Maximum PSU Current from the calculator, and pick the current per LED that matches your pixels. With several outputs on one supply, Use per-output limiter and split the supply’s current between them.
- Make a segment per side of the house, so the garage can show something different from the front. WLED segments explained and splitting a strip into zones cover how.
- Turn the lights on at sunset with a timer, see sunrise and sunset schedules.
Then the fun part: Christmas patterns, Halloween effects, colors for every holiday, or the classic 2 red 1 white pattern for C9 style bulbs.
In WLED Max the limiter is under Device Settings›LED Preferences, section Power & Performance: Max Current (mA) and Per-LED Current (mA), on iOS and Android. WLED settings explained goes through the rest of that page.
Common problems
Dim even though the supply is big. Maximum PSU Current is still at the default 850 mA. Set it from the calculator.
The light reboots when everything goes white. The supply can’t keep up and the voltage sags under the controller. A bigger supply or a lower Maximum PSU Current fixes it. On ESP32 boards with WLED 16 you may see error 91 (brownout restart) afterwards, see WLED error codes.
Random flickering on part of the run. Usually ground or data, not power: a missing common ground, a long first data wire, or a bad connector. Check the connector right before the first flickering pixel.
The far end is orange at full white. Voltage drop. Add a feed there, or move to thicker feed wire.
FAQ
How much power do 300 WLED LEDs need? At 5 V and 55 mA each, up to 16.5 A at full white, so a supply of about 20 A. At 12 V with 30 mA pixels, 9 A and a supply of about 11 A.
How often should I inject power? As a rule of thumb, so that no feed at the end of a strip carries more than about 4 A and no feed in the middle more than about 8 A. At 5 V that’s often every few meters; at 12 V or 24 V far less often. Measure the far end at full white to be sure.
Is there a WLED power calculator? WLED’s own LED settings page has a simple one: under the LED count it shows the power supply a full white strip would need (“A power supply with total of … A is required” on 0.15 and 16). The calculator on this page adds the supply size, feed points and wire drop.
Should outdoor lights be 12 V or 24 V? For a long roofline, yes, if the pixels you want come in that voltage. The same light needs a half or a quarter of the current, which saves wire, injection points and trouble.