Wled-midi — an open convention to drive WLED from any DAW / MIDI controller (MIT)

Hey all :waving_hand: — sharing something I built while using WLED as stage lighting.

wled-midi is a small, open convention that maps standard MIDI → WLED JSON state — drive WLED from a DAW or any MIDI controller, 100% local:

  • Notes → colour looks (black + 7 hues + white) & power
  • CC → brightness / hue / sat / CCT + effect fx/sx/ix + palette
  • Program Change → recall a preset · MIDI clock → on-the-beat

It runs in three modes over the same mapping: lamp (control surface — colours/FX/presets), strip (note → a LED position: play a strip like an instrument, or a piano-guide that lights the key to play, Synthesia-style), and mpe (expressive per-note play). Multi-instance matrix/canvas rigs are covered too, via a small router using WLED’s own realtime protocols.

None of this is invented in a vacuum — people here have already been building the pieces: theTiPE’s single-HTML strip keyboard, frankofino’s live-performance mode, faltim’s club-matrix rig, plus piano-guides and preset-steppers. I just tried to write down the shared mapping underneath those needs. So it’s less “here’s my thing” and more “here’s a common language for the things you’re already building.”

Spec-first — a written SPEC + a tiny reference resolver + a reference implementation + an Ableton clip pack. MIT, DAW-agnostic.

Repo: GitHub - openlamp/wled-midi: An open convention for controlling WLED lights over MIDI — notes->colours, CC->brightness/effects, PC->presets, MIDI clock/Ableton Link->on-the-beat. Spec only. · GitHub

Not affiliated with or endorsed by the WLED project — it just speaks to WLED over the public local API. Feedback and other implementations very welcome. :control_knobs::light_bulb: