Best WLED controllers for Home Assistant holiday lights

Your holiday lights can do better than “on.” Give them a slow candy-cane chase, a warm glow for dinner or a burst of colour when someone rings the bell. Choose the GLEDOPTO GL-C-618WL if you want Ethernet and room for several strips; choose the compact GL-C-310WL for a Wi-Fi project. Add a matching 5 V pixel strip, save a preset and let Home Assistant handle the schedule.

Specifications come from the makers; setup follows WLED and Home Assistant documentation, with the power table calculated from stated planning inputs.

The parts list contains two alternative controllers, one strip and one supply. Buy one controller, not both. The starter project below uses a short indoor section cut from the reel; keep ordinary outdoor strings on the outdoor smart-plug route if all you want is scheduled on/off.

Pick the controller for your connection

Pick	Connection	Maker input voltage	Data outputs / wiring	Maker current limits	Choose it for
GLEDOPTO GL-C-618WL	Ethernet or Wi-Fi	5, 12 or 24 V DC	Four: IO16, IO12, IO4, IO2	10 A per channel; 15 A total	A wired connection and several pixel runs
GLEDOPTO GL-C-310WL	Wi-Fi	5–24 V DC	Start with the default GPIO16 output	6 A per channel; 10 A total	A compact first strip project

Those limits come from GLEDOPTO’s GL-C-618WL manual and GL-C-310WL manual. They describe the controller hardware; your supply, wiring and connectors set the usable load for the finished project.

Our Ethernet pick: GL-C-618WL. It gives you four separately wired data outputs, so you can grow from one strip to several. Ethernet is useful when a cable is already available at the installation point. It carries the network connection; the LED power still comes from the DC supply.

Our compact pick: GL-C-310WL. Choose it when Wi-Fi is the convenient connection and a small controller suits the job. Its manual identifies GPIO16 as the default output group, which makes a sensible starting point for the first strip. Both choices are ESP32-based, so you can keep the same WLED-to-HA workflow as the display grows.

Buy pixels, not an ordinary RGB strip

The matching strip here is the BTF-LIGHTING WS2812B5M30LW30: a white-PCB, 5 m reel with 150 pixels, or 30 pixels per metre, in the IP30 indoor version. WS2812B pixels accept individual colour instructions. An ordinary analogue RGB strip changes a whole connected section together and needs different control hardware.

BTF’s WS2812B product documentation specifies 5 V DC and cutting at each LED’s marked connection points. Start with a 2 m section, giving you 60 pixels to configure and a manageable piece to mount. Save the rest of the reel for the next project.

For that short build, the ALITOVE 5 V / 10 A enclosed adapter supplies a rated 50 W. Its maker specifications describe a centre-positive barrel connector compatible with 5.5 × 2.1 mm and 5.5 × 2.5 mm connections. Match the controller input and polarity, and include the DC wiring, connectors and fuse holder in your project supplies.

Use an enclosed PSU sized for the complete load, and fuse each positive power feed to suit its wiring and current.

This is an indoor starter build: the selected strip is IP30, and GLEDOPTO lists the compact controller as IP20. Put the pixels where you can enjoy them without turning the first project into an outdoor enclosure project.

ESP32, voltage and the data pin: the three useful labels

ESP32 is the pick for a new controller. WLED’s controller guide advises against ESP8266 for new installations. An existing working ESP8266 display can have another holiday season; when buying fresh hardware, choose the ESP32 options here.

The strip decides the voltage. A controller accepting several voltages doesn’t convert them for you. Feed this 5 V strip from the 5 V supply, even though the controller also accepts higher input voltages. That one label matters more than the number of effects on the box.

Data goes into DIN. With power disconnected, connect the strip’s positive and ground to the matching supply/output connections, share ground with the controller, and run the controller’s data output to the strip’s data input. Follow the direction arrows printed on the strip. Start with IO16/GPIO16 on these controllers, using the corresponding terminal in the model’s wiring diagram.

The GPIO number is a software setting as well as a terminal label. In Config → LED Preferences, match the LED type, count and output pin to the connected strip. A generic ESP32 tutorial that uses a different pin won’t configure this controller for you.

Size the starter section before you unroll everything

Use 60 mA per RGB pixel at full white as a conservative design allowance from Adafruit’s NeoPixel power guide. That is a sizing assumption for this table, not a measurement of the BTF strip. We also reserve 20% of the 50 W supply rating, leaving a 40 W planning budget for the LEDs, controller and other loads.

Strip length at 30 pixels/m	Pixels	LED current allowance	LED power at 5 V	Budget left from 40 W
1 m	30	1.8 A	9 W	31 W
2 m starter section	60	3.6 A	18 W	22 W
Full 5 m reel	150	9 A	45 W	Exceeds budget by 5 W

The calculation is pixels × 0.06 A, then current × 5 V. Build the 2 m section first. The whole reel exceeds this planning budget before adding the controller, so don’t treat the 50 W adapter as a full-reel expansion plan. Include controller consumption and every added branch when sizing the next supply and its distribution.

WLED’s brightness/current limit is useful for keeping a display within its configured operating budget. Set it for the actual installation; physical wiring and fuses still do their own job. For a wall-side measurement of the finished display, the plug-in power-meter guide explains the separate tool to use.

Get the pixels working in WLED

Follow WLED’s quick start and the controller manual:

1. Complete the low-voltage connections with the supply unplugged, then power up the controller.
2. For the GL-C-618WL, connect Ethernet to your network. Its manual says Ethernet is configured by default. For Wi-Fi, join the controller’s setup network and use WiFi Settings to connect it to your network.
3. Open its WLED interface. Under Config → LED Preferences, select the WS2812B-compatible LED type, 60 LEDs for the starter section and GPIO16 for the chosen data output, then save.
4. Start dim. Try red, green and blue individually, then a simple effect. If colours are swapped, adjust the colour order to match the strip. If only part lights, revisit the configured count and data connection.
5. Make a slow red-and-green effect you enjoy. Save it under Presets as Holiday Glow, including the brightness and segment settings you want recalled.

WLED’s preset documentation is the useful next stop. Make a second preset called Warm Evening for calmer lighting; now your display has a party outfit and a dinner outfit.

Use the maker’s model-specific firmware route when updating a ready-made controller, particularly the Ethernet model. Save the WLED configuration and presets first so you keep the pin mapping and the scenes you just built.

Make it a holiday scene in Home Assistant

The official Home Assistant WLED integration uses local communication and requires WLED 0.14.0 or newer. Check the version in WLED, then open Settings → Devices & services → Add integration → WLED in HA, or select the discovered device.

Find the light entity and its Preset select entity. The names below are placeholders: replace them with your own entities and keep the preset name exactly as saved in WLED.

Sunset: bring on Holiday Glow

Create an automation with the Sunset trigger from the Sun integration. Turn on the WLED light, then use Select: Select option to choose Holiday Glow on its preset entity. HA documents this action order; changing the light afterwards can clear the selected preset.

alias: Holiday pixels at sunset
triggers:
  - trigger: sun.sunset
actions:
  - action: light.turn_on
    target:
      entity_id: light.holiday_pixels
  - action: select.select_option
    target:
      entity_id: select.holiday_pixels_preset
    data:
      option: Holiday Glow
mode: single

Bedtime: let the pixels sleep

Make a second automation with a Time trigger. This example uses 23:00; choose the time you want.

alias: Holiday pixels off at bedtime
triggers:
  - trigger: time
    at: "23:00:00"
actions:
  - action: light.turn_off
    target:
      entity_id: light.holiday_pixels
mode: single

The Sunset trigger guide and Time trigger guide cover both schedules. Test each automation with Run actions, then temporarily set the Time trigger a few minutes ahead, Save and watch it run. Restore your chosen time and Save again. The sunset automation gets its real trigger test at the next sunset; inspect its trace after it runs.

For a physical “festive / calm” button, the Zigbee scene-remote guide supplies the button workflow. Have one press select Holiday Glow and another select Warm Evening. You keep the same saved presets instead of rebuilding effects in every automation.

Grow with power injection, not a brighter problem

If the far end gets dim or colours drift as brightness rises, investigate voltage drop along the power path. WLED’s wiring guide describes power injection: running additional power and ground connections from the supply to other points on the strip. The data still follows the strip’s direction.

Use branches from the same supply for a continuous run. Don’t join the positive outputs of separate supplies; a larger multi-supply display needs separately powered sections. Keep the common ground/data arrangement in the wiring plan and size each branch before extending it.

The GL-C-618WL’s extra outputs are handy when several separate strips make a tidier display than one long chain. Start each output with the correct GPIO and pixel count, then create segments and presets around the display you actually built. More outputs give you layout choices; they don’t increase the rating of the power supply.

The controller we’d choose

GL-C-618WL for Ethernet and multiple runs; GL-C-310WL for a compact Wi-Fi build. Add the 5 V WS2812B strip and size the supply around the section you’re building now. Get one preset working, let sunset start the show and give bedtime its own off switch.

For lamps and ordinary room lighting, use the local smart-lighting guide. For the next local-control project, head to the Home Assistant hub.