Most holiday light kits come with an app, a cloud account and a remote, and plenty of them reach Home Assistant only through the vendor’s cloud, if at all. A WLED controller talks to it directly. It is a small ESP32 board running open firmware that Home Assistant finds on your network by itself, and from then on every segment, preset and effect is an entity you can put in an automation. The best WLED controller for Home Assistant is the one that also survives a winter outside, which comes down to fusing, level shifting and how much current it can pass.
We picked four Amazon-sold WLED controllers, two outdoor-rated 12V light types and the power supply that feeds them, and wired the picks into one roofline plan with real current numbers. Nothing here was installed on our house, so every spec comes from the makers’ pages and datasheets, the WLED and Home Assistant docs, and live Amazon US listings. We confirmed all of it against WLED 16.0.1 and the current Home Assistant WLED integration, and we rechecked every listing and price band in mid-November 2026, ahead of Black Friday.
Match each part to its job
A WLED light show has three parts that you buy separately: the controller that runs the firmware, the addressable lights, and a power supply sized for the lights rather than for the controller. The table lists our pick for each job with the spec that decides it. Prices are Amazon bands from our mid-November check, and holiday pricing moves daily, so check the live price before you order. We recheck prices on buyer guides and deal refreshes before Black Friday and through December, and this page gets another pass if a pick sells out.
| Job | Pick | Deciding spec | Price band |
|---|---|---|---|
| Whole roofline, best overall | GLEDOPTO GL-C-618WL | 4 outputs, Ethernet, level shifter, fuse | about $36 |
| One or two runs over Ethernet | GLEDOPTO GL-C-616WL | 2 outputs, Ethernet, 10A per output | about $28 |
| Cheapest start, indoors | GLEDOPTO GL-C-015WL-D | 2 outputs, Wi-Fi only, 800 pixels | about $25 |
| Pixels plus plain strips | BTF-LIGHTING SP805E | 2 pixel outputs, 5 PWM channels, ETL listed | about $24 |
| Roofline strip | BTF-LIGHTING WS2815 IP68 | 12V, backup data line, 300 LEDs per 5 m | about $50 |
| Indoor 5V strip | BTF-LIGHTING WS2812B ECO IP30 | 5V, 300 LEDs per 5 m, indoor only | about $14 |
| Indoor RGBW strip | BTF-LIGHTING SK6812 RGB+Natural White | 5V, RGBW, 300 LEDs per 16.4 ft, indoor only | about $45 |
| Windows, trees, fascia | ALITOVE WS2811 12V pixels | 50 IP68 bullets, xConnect plugs | about $31 |
| Power for all of it | Mean Well LRS-350-12 | 12V, 29A, 348W | about $31 |
All four controllers in the table run WLED on an ESP32: GLEDOPTO names WLED on each board’s page, and BTF sells the SP805E as a WLED-ESP32 controller. That matters more than it looks. The WLED project says ESP8266 support is coming to an end and points new builds at the ESP32, so we skipped every ESP8266 board, however cheap. The outdoor lights are 12V for the same reason a roofline needs them; the 5V strips below are for indoor runs close to the supply: at the same wattage, 12V carries well under half the current that 5V does, and current is what drops voltage along a long run.
Wire power and data before you shop
Power and data reach the lights by different paths, and that split decides which controller you need. The controller sends data down each output and passes some current with it, but the supply feeds the far end of every long run directly through its own fuse, so most of the current never touches the controller. Home Assistant only ever talks to the controller, over your LAN.

We sized the picks against one plan: 20 m of roofline in four 5 m reels of WS2815, plus two strings of ALITOVE bullets around a window and a tree. BTF recommends a 12V 5A supply per 5 m reel of its IP68 WS2815, and ALITOVE rates its bullets at 0.5W each, so the numbers come out like this:
| Run | Pixels | Maker’s supply rating at 12V | Share of a 29A supply |
|---|---|---|---|
| 4 reels of WS2815 (20 m) | 1,200 | 20A, 240W | 69% |
| 2 ALITOVE strings | 100 | about 4.2A, 50W | 14% |
| Total | 1,300 | about 24.2A, 290W | 83% |
Full white is the worst case, and a holiday show rarely runs every pixel at full white, but the supply and the fuses must still survive it. The WS2815 figure is BTF’s supply recommendation rather than a measured draw, so meter one reel at full white before you trust it. We’d stop at this load on one LRS-350-12 and add a second supply for anything bigger. The table also shows why the controller choice matters: the GLEDOPTO boards pass 15A in total to their outputs, so 20A of roofline can’t all flow through them. Feed each reel from the supply at its far end, and fuse each feed.
WLED’s own wiring guide sets the rest of the rules, and they apply to every pick below:
- Fuse the positive lead close to the supply, rated just above the run’s expected draw.
- Once the supply is over 100W, give every injection line its own fuse as well.
- Inject power when a run passes about 150 LEDs or its far end looks dim or off-colour, with 22AWG wire or thicker.
- Join every ground: supply, controller and each light run.
- Level-shift the 3.3V data from the ESP32. The WLED docs call the shifter mandatory, especially on 12V and 24V lights.
Then set WLED’s brightness limiter to the current your supply can really deliver, so a stray full-white preset can’t overload it. Change the mA per LED too, because the default assumes 5V pixels. WLED has a built-in 12mA (WS2815) option, but we’d set a custom 17 mA, which matches BTF’s 5A per 300 LEDs and leaves the limiter on the cautious side. The full rules, with photos, are in the WLED wiring guide. Missing grounds and unshifted data cause most of the flicker people blame on bad strips.
Run a roofline from the GL-C-618WL
The GL-C-618WL (GLEDOPTO calls it the Elite 4D-EXMU) is the controller we’d mount in the weatherproof box for a full roofline. It has four data outputs, so our plan puts two 5 m reels on each of two pins (600 pixels each, inside the 800 per pin that the WLED multi-strip docs call very good) and leaves the other two pins for the bullet strings.
Protection is what earns it the top spot. It carries a TI level shifter, a pluggable 20A fuse with a spare 5A in the box, reverse polarity protection and a relay that cuts power to the lights when WLED turns them off. The relay means the lights are not left powered all night while the show is off. There’s one catch: power you inject from the supply at the far end of a reel bypasses the relay. Switch those feeds too, or accept the idle draw.
On the network side, the board has an Ethernet port as well as Wi-Fi, and it adds a PDM microphone for sound effects and Wago lever terminals for the wiring.
Watch two numbers on the label. It takes 5, 12 or 24V in, but the output limits are 10A per channel and 15A in total, so the 20A fuse protects the board, not your load budget. Two reels at full white reach the channel limit on their own, which is why the far-end injection matters. Keep the current that passes through the controller under 15A and inject the rest from the supply. It is also rated IP20, so it belongs in a sealed box under the eaves, never loose on the gutter.
Buy it if you light a whole house from one box, or plan to run xLights shows over Ethernet later. Skip it if you have one run, where the GL-C-616WL below does the same job for less. It sells for about $36 from GLEDOPTO’s own Amazon store, where it had 129 ratings averaging 4.3 in our October check, so check the GL-C-618WL’s live price.
Use the GL-C-616WL for one or two runs over Ethernet
GLEDOPTO’s GL-C-616WL is the same Elite family with two outputs instead of four. You get the same Ethernet port, level shifter, relay and 20A pluggable fuse, the same 15A total, and up to 10A on either output.
Two outputs cover more houses than you’d think: one for the front roofline and one for the bullets around the door is a common first season. Ethernet is the reason we’d pick it over a cheaper Wi-Fi board. A controller in a metal box on an outside wall often sits at the edge of the house Wi-Fi, and the WLED FAQ recommends wired Ethernet for large realtime shows anyway. Home Assistant does not care which link the controller uses, as long as it is on the same network.
According to the Amazon listing, the board ships with GLEDOPTO’s pre-configured custom firmware, which is WLED set up for its pins. Stock WLED has a Gledopto Ethernet profile in its settings, so you can flash the official ESP32_Ethernet build later if you prefer, since the plain ESP32 build has no Ethernet support. It is about $28, but it had only 49 ratings at 4.0 in our October check, fewer than the four-output board, so see the GL-C-616WL’s current price and reviews before you order. A house that will need a third run from the same box is better served by the GL-C-618WL.
Start cheap with the GL-C-015WL-D indoors
For learning WLED, the GL-C-015WL-D is the board we’d start with: an ESP32 with two outputs, a microphone, a UART port for flashing and a MOSFET relay. It takes 5 to 24V in, its label allows 10A per channel and 15A in total, and it is rated for 800 pixels.
What it leaves out is the reason it is not our roofline pick. Neither GLEDOPTO’s page nor the Amazon listing claims a fuse or a level shifter, and it has no Ethernet. On a short indoor run beside the controller that’s fine: a mantel garland, a stair rail or a tree a metre from the outlet. On a 12V roofline with a long data lead, you’d be adding the fuse and fighting the flicker yourself, so if it does go outside, fit the shifter and inline fuse described after the SP805E section.
GLEDOPTO’s budget board is the most-reviewed one in this guide, with 168 ratings at 4.4 in our October check, sold by GLEDOPTO’s store under the Sogledwow brand name. At about $25 it is a cheap way to see whether you like WLED in Home Assistant before you wire the house, so look up the GL-C-015WL-D’s price. Skip it for anything mounted outside.
Mix pixels and plain strips on the SP805E
The SP805E is the pick when the holiday setup includes ordinary single-colour or white strips as well as pixels. Next to its two pixel outputs, which the Amazon listing rates at up to 2,048 pixels each, it has five PWM channels at 6A each for plain RGB, RGBW or tunable-white strips, so the warm-white under-cabinet strip and the chasing pixels share one controller and one Home Assistant device.
It’s the only controller here with an ETL safety listing. The limits are low for an outdoor build, though. The total is 12A, the DC barrel jack is labelled 4A, BTF rates it for indoor use from -10 to 40ยฐC, it is Wi-Fi only, and neither BTF nor the listing claims a level shifter or a fuse. Feed it through the screw terminals rather than the jack once a strip draws more than 4A, and give it the shifter and fuse in the next section before it drives anything longer than a shelf.
We’d use it indoors: a window display, a lit shelf, the tree. It had 36 ratings at 4.8 in our October check and had dropped to about $24 on Amazon by mid-November, so confirm the SP805E’s price before you order. Skip it if every light you own is a pixel strip, since you’d be paying for PWM channels you never use.
Add a level shifter and fuse to a bare board
The GL-C-015WL-D and the SP805E send data at the ESP32’s 3.3V, and neither maker claims a level shifter or a fuse. WS2812B and WS2811 chips expect a 5V data signal, according to the WLED FAQ, so a bare 3.3V line often works on the bench and then flickers once the first pixel sits a few metres away in the cold. You don’t need a different controller to fix it. Two small parts and a fuse holder in the same box do the job:
- Put an SN74AHCT125 between the ESP32 data pin and the strip, powered from 5V. It’s the level shifter WLED’s other hardware page lists as Aircoookie’s recommendation, and the WLED FAQ notes it’s the chip on the QuinLED Dig-Uno.
- Skip TXS0102 and TXS0108 boards for outdoor runs. The same WLED page says those bidirectional shifters only work on data lines shorter than 50 cm.
- Add a 300 to 500 ohm resistor in series on the data line, fitted at the strip end of the wire, as Adafruit’s NeoPixel best practices advise.
- Fuse the positive lead to each output with an inline blade fuse sized as in the wiring section above, close to the supply.
For the shifter, Adafruit sells the 74AHCT125 as a single quad level-shifter chip (3V to 5V, 4.5 to 5.5V supply per its product page), and it’s about $11 as of mid-November, so check the Adafruit 74AHCT125’s price. It’s a bare DIP chip, so you’ll solder it to a small board. For fuses, Amazon’s inline holders are generic automotive parts from brands without a spec page we could check, so this guide links none: pick an ATC/ATO blade holder rated for the wire gauge you run. If soldering a shifter isn’t how you want to spend December, that’s the honest case for the GL-C-618WL or GL-C-616WL, which ship with both parts on the board.
Line the roof with WS2815 IP68 strip
For a continuous roofline we’d hang BTF’s IP68 WS2815: 12V, 300 individually addressable LEDs per 5 m reel, sealed in silicone. The WS2815 carries a backup data line, so one dead LED does not black out everything after it, which on a roofline is the difference between a ladder trip in December and a ladder trip in January.

Three details from BTF’s page change how you install it. The IP68 version has no adhesive tape, so it mounts with the screws and clips in the bag, which suits gutters and fascia board better than tape in the cold anyway. The colour order is GRB rather than RGB, so set it in WLED’s LED preferences or red and green swap. And BTF rates it from -20 to 40ยฐC, which covers most winters but not the coldest ones.
A waterproof strip still needs waterproof joints. The Amazon listing says the connection points must be protected from direct water exposure, so seal every cut end and keep the 4-pin connectors out of standing water.
BTF’s page recommends a 12V 5A supply per reel while the listing says 3A, and we used the page’s figure for sizing. It is about $50 a reel as of mid-November, and it had 514 ratings averaging 4.7 in our October check, shared across its variants, so check the IP68 WS2815’s price. For visible points of light rather than a smooth line, pick the bullets below instead.
Choose the strip chip before the controller
Search Amazon for addressable LED strips and most listings you’ll meet are WS2812B, SK6812 or WS2815. WLED drives all three from the same one-wire data output, but they differ in voltage, colour channels and what happens when a single LED dies. The rows below come from the WLED FAQ, with the current figure from Adafruit:
| Chip | Supply | Colours | What to set or know |
|---|---|---|---|
| WS2812B | 5V | RGB, GRB order | Set GRB in WLED; Adafruit puts each pixel at up to 60 mA at full white |
| SK6812 | Varies, check the listing | RGBW, commonly GRBW | Tick “LEDs are 4-channel type (RGBW)” or the colours run in a red, green, blue pattern |
| WS2815 | 12V | GRB on the BTF pick, per its page | Backup data line (BI), so one dead LED doesn’t kill the rest |
| WS2811 | 12V power, 5V signal | RGB in most cases | Used in bullet pixel strings like the ALITOVE pick below |
For a roofline we’d stay on 12V, which is why both outdoor picks here are WS2815 and WS2811. A 5V WS2812B strip needs more than twice the current for the same wattage, so it drops voltage faster and needs power injected more often along a long run. WS2812B is still a fine choice for a TV backlight, a shelf or a tree within a couple of metres of the supply, and SK6812 earns its extra white channel indoors, where you want plain white light as often as colour. For those indoor jobs, the two strips below are the ones we’d order. Whatever you buy, check the chip, voltage and IP rating on the listing against the table first.
Light a shelf or tree with 5V WS2812B or SK6812
For indoor runs within a couple of metres of the supply, BTF’s WS2812B ECO strip is the cheap way in: 5V, 60 LEDs per metre, 300 LEDs on a 5 m reel, IP30 and so not waterproof. BTF’s listing recommends a 5V 10A supply for the full 5 m and says not to connect it to 12V or 24V. It pairs with the GL-C-015WL-D or the SP805E on a shelf or tree, and it’s about $14 as of mid-November, so check the WS2812B ECO strip’s live price. Skip it for anything outside, because IP30 offers no protection from water.
If you want true white as well as colour, BTF’s SK6812 strip in RGB plus natural white is the RGBW version of the same idea: 5V, 300 LEDs over 16.4 ft, IP30, per its Amazon listing. Set the output type in WLED’s LED preferences to the SK6812 RGBW entry (older builds call it “LEDs are 4-channel type (RGBW)”), or the strip shows single red, green and blue pixels in a row. It’s about $45 as of mid-November, so check the SK6812 RGBW strip’s price. BTF’s own SK6812 product page wasn’t reachable when we checked, so that listing is the source for those specs. Skip it if you only need colour, because the WS2812B costs about a third as much.
Outline windows with ALITOVE bullet pixels
Bullet pixels are the classic holiday look: separate points of light spaced along a cable, each with its own WS2811 chip and sized to fit a 12 mm hole. The ALITOVE string has 50 IP68 pixels at 8 in (20 cm) spacing over 10 m, which wraps a tree trunk or traces a window frame with gaps you can see from the street.
The xConnect plugs are why we chose this string. They’re the 3-pin waterproof connector most holiday-pixel gear uses, the string ships with a female pigtail to wire into the controller, and strings plug end to end without soldering. ALITOVE rates each pixel at 0.5W, which works out to 25W a string, although the same page also says 50W a string. Our power table uses 25W a string. At the page’s 50W figure, two strings would add about 8.3A and push one LRS-350-12 near its limit, so meter a string before you add a second batch.
Review history is the honest catch with this pick. On Amazon this exact listing had only 10 ratings averaging 2.9 in our October check, against 28 at 4.8 on ALITOVE’s own store, so treat it as the least proven pick in this guide and test each string on the bench before it goes up the ladder. It costs about $31, and stock was running low on the listing in mid-November, so order strings early if you want them up before December and check the ALITOVE string’s current price. Skip bullets for a roofline, where 50 points over 10 m reads as sparse next to a strip.
Power it from a Mean Well LRS-350-12
Cheap kits usually fail at the power supply first, and the Mean Well LRS-350-12 is the one we’d trust with a whole roofline. Mean Well’s datasheet rates it at 12V and 29A for 348W, with output adjustable from 10.2 to 13.8V, and protection against short circuits, overload, over voltage and over temperature.
Two things on the datasheet catch first-time buyers. The AC input range is set by a switch, 90 to 132V or 180 to 264V, so check it matches your mains before you plug it in. And it is an enclosed, fan-cooled unit with screw terminals and no IP rating, so outside it lives in a ventilated weatherproof box with the controller, never on the ground or in the rain.
Our 20 m roofline plan puts it at about 83% of its rating at full white, which is as far as we’d push one unit. For more lights, add a second supply rather than a bigger one, so each feeds its own runs and fuses. It is about $31 as of mid-November, and it had 252 ratings averaging 4.7 in our October check, so see the LRS-350-12’s live price. It’s the wrong unit for 5V lights, and a 5V roofline is the wrong plan anyway. Whichever seller fills the order, check the serial number on Mean Well’s S/N lookup when it arrives.
Connect WLED to Home Assistant
The WLED integration is built into Home Assistant, uses local push, and finds controllers on its own through zeroconf. It needs WLED 0.14.0 or newer, and it gets state changes over a WebSocket, falling back to polling every 10 seconds on firmware that has no WebSocket. If you haven’t installed Home Assistant yet, our guides cover Home Assistant on Ubuntu 26.04 and Home Assistant in Docker.
Order matters here, because Home Assistant creates its entities from whatever the controller has when you add it:
- Join the controller to your network, over Wi-Fi or by plugging in Ethernet.
- Set the LED count, colour order (GRB for the BTF strip) and power limit in WLED’s LED preferences.
- Create the segments you want as separate lights, such as one per side of the roof.
- Accept the discovered WLED device in Home Assistant, or add it by IP.
Once the controller is added, each segment becomes a light entity, with a master light added when there are two or more. Presets, playlists and palettes become select entities, speed and intensity become numbers, and an update entity can install new stable WLED releases from Home Assistant. On a GLEDOPTO board, back up the WLED configuration first, because the update can swap the vendor’s pre-configured build for a different one. With the brightness limiter configured, you also get estimated current and max current sensors, and estimated current is the one we’d chart on a dashboard during the first cold night to check the supply’s headroom.
A few limits shape your automations. It sets only the primary colour, so two-colour and three-colour looks belong in WLED presets that Home Assistant calls by name. It ignores custom segment names and can’t control usermods such as the audio-reactive microphone.
In practice, you build the looks in WLED and use Home Assistant to choose which preset runs and when: on at sunset, a playlist on weekends, off at midnight. A small mini PC running Home Assistant handles that schedule easily, since the controller does all the pixel work.
Check these specs on any WLED controller
Amazon lists dozens of boards with WLED in the title, and the listings rarely say what’s missing. These are the checks we ran on every candidate, in the order that ruled most of them out:
- ESP32, not ESP8266, since WLED is winding down ESP8266 support.
- A level shifter on the data outputs, named on the maker’s page.
- A fuse on board, or room in your box for an inline one.
- A total output current above the share of your lights it will carry.
- Ethernet if the box sits at the edge of your Wi-Fi.
One more check is the official list. GLEDOPTO is not on WLED’s compatible controllers page, which names QuinLED, Athom and a handful of others. Those two brands pass the ESP32, level shifter and fuse checks, but you buy them direct rather than on Amazon, as the next section shows.
Order QuinLED or Athom direct for built-in protection
QuinLED and Athom build the level shifter and fuse onto the board, which is exactly what the two budget Amazon picks leave out. Neither had an Amazon listing we could verify against the maker, so they carry no affiliate link and aren’t numbered picks. Here’s how the three boards worth ordering direct compare, from the makers’ own pages:
| Board | Outputs | Input and current | Protection | Network | Where to buy |
|---|---|---|---|---|---|
| QuinLED Dig-Uno v4 | 2 data + relay trigger | 5-24V, 10A max | 10A fuse, reverse polarity, ESD-protected level-shifted outputs | Wi-Fi, Ethernet option | Resellers, about $39 at DrZzs in the US |
| QuinLED Dig-Quad v4 | 4 data + relay trigger | 5-24V, 30A continuous, 50A peak | 5 SMD fuses (2 x 10A, 3 x 5A), level shifter | Wi-Fi, Ethernet option | Resellers, about $47 at DrZzs in the US |
| Athom Ethernet WLED ESP32 | 2 addressable + 5 PWM | 5-24V | Built-in level shifter, replaceable fuse | Wi-Fi and Ethernet | athom.tech, about $24 on sale ($34 regular) |
QuinLED released the reworked v4r1 revision of both Dig boards on 31 October 2026, with a new power stage that fixes a part the previous revision could lose at 24V, and both ship with WLED installed. The Dig-Uno is the closest match to the GL-C-616WL, while the Dig-Quad covers a whole house from one box like the GL-C-618WL, with more total current than either GLEDOPTO board. QuinLED’s shop says its reseller prices were indexed in mid-2026, so check the reseller before you count on a figure. Athom’s board is the cheapest way to get Ethernet, a shifter and a fuse together, and it matches the SP805E’s mix of pixel and PWM outputs. The catch with all three is shipping time, so order before December if you want the lights up this season. Our QuinLED vs Gledopto vs Athom comparison puts them next to the GLEDOPTO boards one spec at a time.
For the lights, the IP rating tells you where they can go. IP65 survives jets of water, IP67 survives brief immersion to 1 m, and IP68 survives longer immersion on terms the maker sets. A roofline needs IP65 at minimum, and IP67 or better wherever snowmelt pools. If your ESP32 projects go beyond lights, our ESP32 boards for ESPHome guide covers the sensor side of the same chip.
Connect WLED to more than Home Assistant
Home Assistant is the scheduler, but WLED speaks other protocols too, and a holiday show usually ends up using one of them. The controller does not care how many sources talk to it, though only one can drive the pixels at a time:
| Talks to | Protocol | Use it for | Watch out for |
|---|---|---|---|
| Home Assistant | WLED JSON API and WebSocket | Schedules, presets, dashboards | Primary colour only |
| xLights | DDP on UDP 4048 | Music-synced sequences | Ethernet for large shows |
| Other show software | E1.31 or Art-Net | Show software without DDP | 170 pixels per universe |
| Any MQTT broker | MQTT on 1883 | Node-RED and other tools | Unencrypted |
The E1.31 row is where people get stuck. Our 1,200-pixel roofline needs 1,200 รท 170 = 7.06, so eight universes, which fits under WLED’s limit of nine universes (1,530 pixels), but WLED recommends three or fewer for a smooth frame rate. That’s why the WLED FAQ recommends DDP with xLights. Finally, WLED has no HTTPS and no login, so keep every controller on your LAN and reach it from outside through a VPN to your Home Assistant, never through a port forward.





