How j8-diablo/ddmx works
DDMX is a Flask-based web controller for DMX/ArtNet lighting rigs. Operators configure fixtures and devices, edit or select JSON cues, then trigger playback or live effects; the backend renders channel values and sends ArtNet output. The UI also exposes identify, timeline/sequence, and video-sync capabilities. The README documents the API and workflow, while excerpts show engine rendering and ArtNet emission; some internal routing and optional integrations are not shown, so those connections are omitted or marked unverified.
Main entry points: app.py Flask API · dmx_engine.py Render Engine · ui.js Web UI · fixture_runtime.py Fixture Parser
Components 19
Operator Interface
- Web UI
static/ui.js - Rig Editor
static/rig.js - Cue Editor
static/cues.js - Effects UI
static/effects.js - Timeline
static/timeline.js - Video Sync
static/sync_video.js - Desktop Shell
gui.py
Control and Show Data
- Flask API
app.py - Fixture Parser
fixture_runtime.py - Fixture Definitions
fixtures - Cue Files
cue - Effect Catalog
effects_definitions.json
Rendering
- Render Engine
dmx_engine.py - Simple Engine
dmx_engine_simple.py - LFO Effects
Effect.py - Intelligent Effects
intelligent_fx.py
DMX Transport
- ArtNet Sender
DMXE.py - ArtNet Network
Other components
- Lighting Operator
Connections 18
- Lighting Operator → Web UI: operates
README.md - Web UI → Flask API: calls API
README.md - Rig Editor → Flask API: manages rig
README.md - Cue Editor → Flask API: manages cues
README.md - Effects UI → Flask API: starts effects
README.md - Timeline → Flask API: controls playback
README.md - Video Sync → Flask API: sync settings
- Flask API → Fixture Parser: parses fixtures
app.py - Fixture Parser → Fixture Definitions: loads definitions
README.md - Flask API → Cue Files: reads and writes
README.md - Flask API → Effect Catalog: lists effects
README.md - Flask API → Render Engine: controls rendering
README.md - Render Engine → ArtNet Sender: sends universes
dmx_engine.py - ArtNet Sender → ArtNet Network: emits packets
DMXE.py - Render Engine → LFO Effects: uses LFOs
dmx_engine.py - Render Engine → Intelligent Effects: evaluates effects
dmx_engine.py - Flask API → Simple Engine: selects engine
app.py - Desktop Shell → Flask API: hosts server
gui.py