MoonLight is open-source software that lets you control a wide range of DMX and LED lights using ESP32 microcontrollers, for home, for artists, and for stages.
Release highlights: Live Scripts, Ethernet, DMX in/out, Multiple Layers, and SuperSync device control
MoonLight 1.0 is a milestone release. Since v0.9.0, MoonLight gained Live Scripts for code-driven effects without a firmware rebuild, full Ethernet and DMX in/out support, multiple independent virtual layers, Arti-FX effects ported from WLED-MM, and a completely reworked device SuperSync with robust group-based control and WLED coexistence.
Use MoonLight Installer to install.
If you like MoonLight, give it a ⭐️, fork it or open an issue or pull request. It helps the project grow, improve and get noticed.
⚠️ v1.0.0 is the final MoonLight release
As of May 2026, active development is moving to ProjectMM. MoonLight v1.0.0 remains fully usable — see MoonLight v1.0.0 and Beyond for the full story.
What's Changed
MoonBase
-
Live Scripts — write and run effect scripts directly from the browser without rebuilding firmware. See Live Scripts
-
Ethernet — multiple ethernet types (LAN8720, W5500, PoE). See IO Module
-
WiFi improvements — reconnection guard prevents duplicate connection attempts; hostname drives mDNS, AP name, and device name from a single setting. See WiFi Station
-
Searchable drop-downs — type to filter effects, layouts, and drivers in long lists
-
SuperSync group control — devices grouped by hostname prefix synchronise light state automatically. Control broadcasts go on MoonLight-private port 65507; discovery stays on the WLED-compatible port 65506, so MoonLight and WLED coexist without interfering. See Devices
MoonLight
-
Multiple virtual layers — run independent effects on overlapping LED ranges and composite them. See Layouts
-
DMX in/out — receive and send DMX512 over RS-485. See Drivers module
-
Network in/out — Art-Net and sACN input and output. See Drivers module
-
Arti-FX effects — effects ported from WLED-MM's Arti-FX scripting engine. See Effects Module
-
REST API — control brightness, palette, and preset from external systems
-
FastLED Audio improvements — DominantFreqHz and magnitude channels exposed to effects. See Drivers module
Pull Requests
- Searchable drop-downs by @ewowi in #142
- Live Scripts re-animation by @ewowi in #144
- bug fix: use board preset to know how to display voltage and current by @limpkin in #145
- Ethernet supporting ethernet types by @ewowi in #151
- Ethernet WiFi and host-name by @ewowi in #152
- Live scripts by @ewowi in #153
- Arti-FX effects by @ewowi in #155
- DMX in/out, Ethernet, Livescripts by @ewowi in #158
- Multiple Layers by @ewowi in #159
- network in/out by @ewowi in #160
- Livescripts tutorial, WiFi handling, Network in/out, rest API by @ewowi in #161
- Update installer.md by @Flavourdynamics in #162
- Device sync and FastLED audio by @ewowi in #165
- UDP port segregation by @ewowi in #172
New Contributors
- @limpkin made their first contribution in #145
- @Flavourdynamics made their first contribution in #162
Full Changelog: v0.9.0...v1.0.0
