Guide
OmnaDMX is an ESP32 DMX lighting controller. It drives addressable RGB and RGBW LED strips from DMX512, Art-Net, or sACN, and it can run its own pattern engine when there’s no console at all. You configure it from an on-device OLED, a browser app, or plain-language prompts.
Two boards run the same firmware. They have the same features, so the choice between them comes down to the install.
Boards & limits
Section titled “Boards & limits”| Sparkle Motion | ESP32-S3-ETH | |
|---|---|---|
| LED strip outputs | 3 | up to 8 |
| Network | WiFi only | wired Ethernet (preferred), WiFi fallback |
| Onboard mic | yes (sound-reactive) | no |
| USB file access | no | yes (storage mounts as a USB drive) |
| Best for | compact or sound-reactive installs | permanent installs, larger rigs, show networks |
The ceilings you design within apply to both boards:
| Limit | Value |
|---|---|
| Virtual elements | 8 |
| Slices per strip | 32 |
| Palette colours per pattern | 8 |
| Pixel universes (Art-Net / sACN, DMX Pixels) | 8 (Sparkle Motion), 38 (S3-ETH) |
| I2C sensors | 4, each up to 16 outputs |
| Routes / reactions per sensor | 8 / 8 |
How this guide is organized
Section titled “How this guide is organized”- Getting Started — wire power and LEDs, first boot, get on the network.
- Web Config App — the browser UI: elements and slices, operating modes, the pattern engine, sensors, AI patterns.
- DMX / Art-Net / sACN — wiring and configuring the protocol inputs and outputs.
The HTTP API has its own Reference.
Where to start
Section titled “Where to start”New device in hand: Power & LED wiring. Slotting it into an existing rig: the DMX / Art-Net / sACN track gets you there fastest.
Docs · 0.9.1-beta