Driving addressable LEDs with WLED, Art-Net and audio
Learning objectives
- learner can choose and configure a DMX-over-Ethernet transport (Art-Net, sACN/E1.31, DDP) within universe capacity and framerate limits
- learner can configure WLED DMX modes, pixel grouping and ledmap remapping for real and non-rectangular layouts
- learner can drive addressable strips audio-reactively with LedFx virtuals over the network
Capstone — one whole task that evidences the objectives
Build an audio-reactive LED installation: pick a transport (Art-Net or sACN) sized to universe/framerate limits, configure a WLED controller's DMX mode, pixel grouping and a ledmap (with -1 gaps) for a non-rectangular strip layout, then have LedFx auto-discover the device and drive a spanned virtual effect from live audio.
Prerequisite modules
This module takes you from software lighting cues to physical light: an ESP32 running WLED, a few metres of addressable strip bent into a non-rectangular shape (an infinity sign, a logo, a stage-edge outline), and a laptop analysing live audio. In club and installation practice this is the cheapest route to hardware visuals that pulse with the music — no media server, no projector, just Wi-Fi and pixels — and every design decision is a budget decision: channels per universe, universes per frame, milliseconds per frame.
The arc starts supported. First exercise: one straight strip, one universe, LedFx auto-discovery doing the work — lean on the plug-and-play discovery workflow (“LedFx auto-discovers WLED devices on the local network”) and the channel-mode table (“WLED offers multiple DMX channel modes”) to get any light reacting to sound. From there the constraints tighten: you size the rig using the 170-pixels-per-universe rule and the 3-universe/40fps ceiling, choose Art-Net versus sACN deliberately (knowing DDP’s forced Multi-RGB behaviour), stretch scarce channels with pixel grouping, and describe your physical shape with a ledmap, marking absent positions with -1. The capstone removes the scaffolding: you plan, wire, map and drive the whole installation yourself, spanning one virtual effect across the layout.
Required atoms are exactly the ones the capstone cannot survive without — transport choice, capacity and framerate budgeting, DMX-mode and grouping configuration, ledmap authoring, and the LedFx virtual pipeline. Supporting atoms widen the frame: Effect DMX mode and per-preset ledmaps for bandwidth-light or multi-song rigs, QLC+‘s Art-Net offset quirk for hybrid desks, and media facades plus the synthesis-versus-clips distinction for where this craft scales.
Atoms in this module
Required — these gate the capstone
Supporting — enrichment, not gating
Part of curricula
- VJ — visual performance with projection, light & video — Map, light & wire the room required
Unlocks — modules that require this one