Pixel Wizard — Theatrical sACN & OSC Pixel Mapping Engine [prj-pixel-wizard]
Electron/TypeScript/React sACN (E1.31) LED pixel-mapping and animation server with ETC Eos OSC cue triggering and deterministic theatrical effect algorithms.
Open, generalized LED pixel-mapping and animation desktop engine designed for live theatrical show control over arbitrary 2D fixture geometries.
§1Problem & Motivation
Standard architectural pixel controllers lack deterministic theatrical fade curves, native Warm White (w) diode isolation on RGBW fixtures, and direct cue-synchronization from theatrical lighting consoles. Pixel Wizard bridges ETC Eos console cue lists and on-stage sACN (E1.31) LED controllers.
§2Architecture & Implementation
- Runtime & UI: Built with Electron, React, TypeScript, Zustand state management, and Konva / react-konva canvas layout tools for spatial fixture mapping.
- Network Output: Multicast sACN (
e131) output driving multi-universe RGBW strips through Ethernet ESP32 controllers (Athom WLED ESP32). - Console Integration: Listens for ETC Eos UDP OSC cue-fire events on port
8000(/eos/out/event/cue/.../fire) for deterministic cue execution without timing drift. - Dedicated Warm White Channel: Addresses the 4th hardware diode directly (
{ r: 0, g: 0, b: 0, w: 255 }) rather than simulating tungsten with RGB mixing.
§3Theatrical Effect Algorithms
Extended the core animation engine (solid, chase, pulse, gradient, perlin_noise, strobe, sweep) with five custom theatrical algorithms built for The Seagull:
flicker_strike— Fluorescent/filament ignition warmup settling to steady 100% state.wipe— Directional and symmetrical reveal/grow (up,down,left,right,center_out,edges_in).fizzle— Stochastic pixel decay envelope with independent pixel death timestamps and colour shift.shimmer— High-frequency stochastic flutter modulated over spatial gradients.burst— Instantaneous filament overload spike prior to Blackout.
§4Production Deployment
- The Seagull (Oxford Playhouse, MT26): Mapped 4×
1.25m × 2.50mPerspex/aluminium LED scenic frames totalling 360 RGBW pixels (1,440 sACN DMX channels) synchronized live to the ETC Eos cue stack.
Seagull_Set_LX_Diag.png (631.4 KB)
Open raw image ↗
Backlinks / Referenced By [4]
- [shw-seagull] The Seagull show (2026) — Referenced in notes
- [cv-profile] CV, Bio & Production Credits cv — Referenced in notes
- [sys-etc-eos] ETC Eos Family gear — Referenced in notes
- [sys-sacn-wled] sACN (E1.31) & Athom WLED ESP32 gear — Referenced in notes