WLED matrix control

An ESP32 with WLED and an addressable LED matrix is the cheapest way to get a room-sized display that reacts to music, motion, or whatever else a laptop can throw at it. The XDA build that mirrored movements on a matrix hit the point: the microcontroller is easy. The controller software on the desktop is where hobby projects usually stall. The best apps for WLED matrix control on desktop turn that box of parts into a display that actually does something.

We tested seven controllers on a 16x16 WS2812B panel and a 300-LED strip driven by an ESP32-C3 running WLED 0.16. Two are audio-reactive engines, two are full pixel-mapping suites for holiday shows, one is the WLED web UI itself, and two are ambient-lighting bridges that treat the matrix as a light behind a monitor. All work over Wi-Fi against WLED without flashing custom firmware.

What to look for

A WLED controller earns a slot on your desk by handling the awkward parts:

Quick comparison

App Best for Platforms Free plan Starting price Rating
WLED Web UI Direct control from a browser Web Yes Free 4.9
LedFx Music-reactive live effects Windows, macOS, Linux Yes Free 4.7
xLights Sequenced holiday and event shows Windows, macOS, Linux Yes Free 4.7
Vixen Lights Timeline-driven light sequencing Windows Yes Free 4.4
WLED Sync Interface Node-based motion input to WLED Windows, macOS, Linux Yes Free 4.3
Prismatik Screen ambilight to WLED Windows, macOS, Linux Yes Free 4.2
Hyperion Full ambilight for HTPCs Linux, macOS, Windows Yes Free 4.6

1. WLED Web UI, best for direct control from a browser

The WLED Web UI is the built-in controller that ships with the firmware. Point a browser at the ESP32’s IP and every effect, palette, segment, and scheduled preset is one tap away. For a matrix, the 2D pixel-map editor in the recent WLED release finally makes serpentine wiring and non-square shapes fully first-class.

Where it falls short: effects are limited to the built-in library. It does not read the desktop audio at all, so anything music-reactive needs a companion app.

Pricing:

Platforms: Any browser.

Download: flash WLED with the official installer or GitHub releases

Bottom line: the first thing to bookmark. Use it for setup, palette work, and static effects; add a desktop tool only for what the web UI cannot do.

2. LedFx, best for music-reactive live effects

LedFx is the tool the WLED community actually reaches for when the point is music reactivity. It captures desktop audio (via WASAPI on Windows, PulseAudio on Linux, Blackhole or Loopback on macOS), analyzes it in real time, and pushes E1.31 frames to WLED at 60 fps. The 2026 release added a 2D effects engine that ships proper matrix visualizations (spectrograms, radial ripples) not just 1D-stretched-across-a-matrix.

Where it falls short: the Python packaging is fragile on Windows; the recommended path is the installer, not pip. Latency spikes when the CPU is under load.

Pricing:

Platforms: Windows, macOS, Linux.

Download: ledfx.app or GitHub source

Bottom line: install this first if music reactivity is why you built the matrix.

3. xLights, best for sequenced holiday and event shows

xLights is the industry-standard sequencer for holiday-light shows and it treats a WLED matrix as one device among many. Build a timeline against an MP3, drag effect blocks onto the timeline, target segments, and export to E1.31 for playback. WLED’s built-in xLights protocol handling is stable in the 2026 build.

Where it falls short: the interface is dense and the learning curve is real. Overkill if the matrix is just a wall-behind-the-desk piece.

Pricing:

Platforms: Windows, macOS, Linux.

Download: xlights.org

Bottom line: pick xLights when the matrix is one of several devices in a coordinated show.

4. Vixen Lights, best timeline sequencer for Windows

Vixen Lights is xLights’ longer-running sibling on Windows. Same timeline concept, more mature UI in some places, weaker in others. Its WLED integration is via E1.31 and its curve editor for effect intensity is the sharpest in this list.

Where it falls short: Windows only, and updates are slower than xLights’. Some effects need to be built from primitives rather than dragged in.

Pricing:

Platforms: Windows.

Download: vixenlights.com

Bottom line: the pick when Windows is the only desktop and xLights’ complexity feels off-putting.

5. WLED Sync Interface, best for motion input to WLED

WLED Sync Interface is the class of node-based tools that plug MediaPipe (or another motion-tracking model) into an E1.31 output. The XDA project used a similar pipeline: webcam feeds motion into a controller, controller pushes color-mapped frames to WLED. Several community-maintained forks exist; the most active one is on GitHub.

Where it falls short: motion tracking eats a full CPU core, and the frame rate through WLED caps around 30 fps for full-matrix updates. Setup is a one-evening project.

Pricing:

Platforms: Windows, macOS, Linux.

Download: WLED community projects

Bottom line: the pick when the matrix should react to you moving in front of the webcam.

6. Prismatik, best screen ambilight for WLED

Prismatik captures the screen edges and pushes matching colors to LEDs behind the monitor. Its WLED support went in around 2024 via the E1.31 output, and the 2026 fork updates it for Windows 11 capture APIs and Wayland on Linux.

Where it falls short: the fork ecosystem is messy. Pick the actively maintained one (search WLED forum threads for the current recommendation).

Pricing:

Platforms: Windows, macOS, Linux.

Download: Prismatik forks on GitHub

Bottom line: the pick when the matrix sits behind a monitor and should extend the screen colors.

7. Hyperion, best full ambilight for HTPCs

Hyperion.NG is the serious ambilight rig for home-theater PCs. It runs headless on a Linux box or Kodi HTPC, captures video (HDMI grabber or software), and outputs matching colors to a WLED matrix or strip behind the TV. Better than Prismatik at 4K, lower CPU cost, more configurable.

Where it falls short: setup requires editing JSON config or slogging through the web UI. Windows support exists but is second-class behind Linux.

Pricing:

Platforms: Linux (primary), macOS, Windows.

Download: hyperion-project.org or GitHub source

Bottom line: the pick when the matrix is the ambilight behind a home theater TV.

How to pick the right one

FAQ

What protocol should I use to talk to WLED?

E1.31 (sACN) for 100-500 LEDs, DDP for larger matrices where UDP overhead matters. WLED handles both; every desktop tool in this list supports at least one.

Do I need WLED’s music-reactive fork?

Not since WLED 0.15 shipped MoonModules integration in mainline. LedFx still gives more control and better beat detection than the on-device sound sensor, but the on-device path works for casual use.

How high a frame rate can WLED push?

About 40-60 fps for a 300-LED strip over Wi-Fi, roughly 30 fps for a 256-LED matrix. Ethernet-connected ESP32 boards do better.

Can I run LedFx and the WLED Web UI at the same time?

Yes, WLED accepts E1.31 input while the web UI is open, and the last frame received wins. Some effects will look glitchy if both are actively pushing frames.

What is the cheapest WLED matrix build?

An ESP32-C3 (under 5 USD), a 16x16 WS2812B panel (under 15 USD), and a 5 V 5 A power supply covers a small matrix for around 25 USD.

Does music reactivity need a physical audio loopback cable?

No. LedFx reads system audio directly on Windows and Linux. On macOS install Blackhole or Loopback as a virtual audio device.