home/ modules/ driving-addressable-leds-with-wled-and-artnet

Driving addressable LEDs with WLED, Art-Net and audio

  • 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

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.

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

Art-Net transports DMX512 and RDM lighting data over an Ethernet network
Concept L1 Foundations I
Art-Net and sACN are the two competing Ethernet-based DMX transport protocols
Concept L2 First instrument I
E1.31 (sACN) sends DMX over multicast UDP, with universe numbers matching QLC+ numbers directly
Fact L2 First instrument IJ
One E1.31 universe carries 512 DMX channels, controlling up to 170 RGB LEDs at 3 channels each
Fact L1 Foundations IJ
Using more than 3 E1.31 universes in WLED degrades frame rate below 40fps
Principle L2 First instrument IJ
WLED offers multiple DMX channel modes ranging from single-color control to per-pixel RGB addressing
Concept L2 First instrument IJ
WLED supports Art-Net and DDP as E1.31 alternatives, but DDP always uses Multi RGB regardless of DMX mode
Fact L2 First instrument IJ
WLED Pixel Grouping treats N consecutive physical pixels as one DMX channel to stretch limited universes
Concept L2 First instrument IJ
WLED's ledmap.json remaps physical LED order to any logical layout
Procedure L2 First instrument I
Use -1 in a WLED ledmap to mark absent pixels in non-rectangular shapes
Fact L2 First instrument I
LedFx processes audio input in real time and pushes light effects to networked LED devices over Wi-Fi
Concept L2 First instrument IJ
A LedFx virtual is a device-independent effect surface that can be spanned or copied across multiple physical LED strips
Concept L3 Craft I
LedFx auto-discovers WLED devices on the local network, enabling plug-and-play LED strip control without manual configuration
Procedure L2 First instrument I

Supporting — enrichment, not gating

WLED Effect DMX mode allows remote control of built-in effects via 15 DMX channels without per-pixel data
Concept L2 First instrument IJ
WLED supports multiple named ledmaps selectable per preset
Fact L3 Craft I
Audio-reactive synthesis generates visuals from sound data rather than triggering pre-recorded clips
Concept L1 Foundations IJ
QLC+ transmits DMX over Ethernet using Art-Net UDP with universe-numbering offset by 1
Fact L2 First instrument IJ
Media facades use building-scale LED or light matrices, not projectors, as a reactive audiovisual output surface
Concept L2 First instrument I