ben-tilley@pc-razer2:~$ cat /vault/projects/prj-pixel-wizard.md 44 nodes · 47 assets

Pixel Wizard — Theatrical sACN & OSC Pixel Mapping Engine [prj-pixel-wizard]

Year: 2026 Domain: software shipped Stack: TypeScript · Electron · React · Zustand · Konva · sACN (e131) · OSC (UDP) · ONNX Runtime Shows: The Seagull

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.

4 sections · node [prj-pixel-wizard]
§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:

  1. flicker_strike — Fluorescent/filament ignition warmup settling to steady 100% state.
  2. wipe — Directional and symmetrical reveal/grow (up, down, left, right, center_out, edges_in).
  3. fizzle — Stochastic pixel decay envelope with independent pixel death timestamps and colour shift.
  4. shimmer — High-frequency stochastic flutter modulated over spatial gradients.
  5. burst — Instantaneous filament overload spike prior to Blackout.
§4Production Deployment
  • The Seagull (Oxford Playhouse, MT26): Mapped 4× 1.25m × 2.50m Perspex/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
Embed: Seagull_Set_LX_Diag.png (631.4 KB) Open raw image ↗