Skip to content

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.

License

Notifications You must be signed in to change notification settings

MoonModules/MoonLight

ย 
ย 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŒ™ MoonLight

MoonLight Logo

The open-source lighting platform that scales from art installations to professional stages

Drive lots of DMX or LED lights with stunning effects running on ESP32 microcontrollers. For creators who demand professional results without enterprise costs.

GitHub Stars Discord License: GPL v3

๐Ÿš€ Get Started โ€ข ๐Ÿ’ซ Enjoy โ€ข ๐Ÿ› ๏ธ Contribute

Watch MoonLight Demo

โ–ถ๏ธ Watch the release 0.6.0 video


๐ŸŽฏ Why Choose MoonLight?

MoonLight bridges the gap between hobbyist lighting projects and professional lighting systems. Get enterprise-grade performance and flexibility without the enterprise price tag.

  • โšก High Performance - 12K LEDs at 100 FPS with FastLED + parallel drivers
  • ๐ŸŽจ 3D Effects Engine - Stunning visuals for 1D strips, 2D panels, 3D cubes, and custom layouts
  • ๐Ÿ—๏ธ Flexible Setups - From simple strips to complex installations and DMX fixtures
  • ๐ŸŒ Modern IoT - ESP32-powered with responsive Svelte 5 interface
  • ๐ŸŽญ Professional Integration - DMX/Art-Net support for stage lighting
  • ๐Ÿ’ Open Source - GPL v3 licensed, budget-friendly, community-driven
Watch MoonLight Demo

โ–ถ๏ธ Watch the introduction


๐Ÿš€ Quick Start

1๏ธโƒฃ Flash & Go

Use our web installer to flash MoonLight directly via a USB cable to your ESP32, connect LEDs to it and you are ready to go.

2๏ธโƒฃ Connect & Configure

Built-in access point makes WiFi setup effortless. Configure through the intuitive web interface.

3๏ธโƒฃ Create & Enjoy

Start creating stunning effects immediately on both mobile and desktop.

๐Ÿ“– Full Installation Guide

Watch MoonLight Demo

โ–ถ๏ธ Watch the install tutorial


๐Ÿ› ๏ธ Built With Modern Technologies

Firmware Interface
๐Ÿ”ง ESP-IDF 5 - Modern ESP32 framework โšก Svelte 5 - Lightning-fast reactive UI
๐Ÿ’ก FastLED 3.10 - Industry-standard LED library ๐ŸŽจ DaisyUI 5 - Modern component library
๐Ÿ“ก PsychicHTTP 1.21 - High-performance web server ๐ŸŽฏ Tailwind 4 - Utility-first CSS
๐Ÿ“Š ArduinoJson 7 - Advanced JSON processing ๐Ÿ“ฑ Mobile & Desktop responsive

๐ŸŽฏ Perfect For

  • ๐ŸŽจ Artists & Creators - Bring your vision to life without breaking the bank
  • ๐Ÿ›๏ธ Small Venues - Professional lighting for theaters, events, and installations
  • ๐Ÿ”ง Makers & Hobbyists - Advanced features with user-friendly interfaces
  • ๐Ÿ’ผ Professionals - Integrate into existing lighting systems with standard protocols
  • ๐Ÿซ Educational - Open source platform perfect for learning and teaching
Watch MoonLight Demo

โ–ถ๏ธ Watch the functional overview


๐Ÿ“Š Technical Specifications

LED Control

  • Performance: up to 12,288 LEDs @ 100 FPS
  • Outputs: Typical 1, 4, 16 or 48 parallel LED strips
  • Drivers: FastLED + Parallel drivers for high-speed parallel processing

Effects & Layouts

  • Dimensions: 1D strips, 2D panels, 3D cubes and custom layouts
  • Effects: Layered effects system with modifiers
  • Fixtures: DMX lights (PAR lights, Light Bars, Moving Heads)

Connectivity

  • Protocols: DMX, Art-Net, WiFi, Ethernet
  • Platform: ESP32 with modern web interface
  • Integration: Professional lighting system compatible

๐Ÿ“ˆ Release Roadmap

Version 0.6.0 - November 2025

The user-friendly baseline release

โœจ Coming Features:

  • Plug & Play Experience
  • Preset Controller for quick effect management
  • Enhanced Web Installer with one-click flashing
  • Large Display Drivers for massive installations
  • WLED Audio Sync for music synchronization
  • Refined Interface with polished UX

From 0.6.0 Forward: Community-driven development focused on ease of use, more effects, and expanded hardware support.


๐Ÿ—๏ธ Architecture & Flexibility

MoonLight is built on MoonBase and ESP32-Sveltekit, our complete IoT framework:

  • ๐ŸŽฎ For LED Enthusiasts - Complete lighting solution out of the box
  • ๐Ÿ”ง For Developers - Fork MoonLight and add Effects, Modifiers, Layouts or Drivers or use MoonBase to create custom IoT applications
  • ๐Ÿญ For Integrators - Embed into larger systems using standard protocols
  • ๐Ÿ”Œ Modular Design - Add features as needed using the Nodes and Modules system
  • ๐Ÿ”ฉ GPIO Access - Full ESP32 hardware interface

๐Ÿค Community & Support

Get Help & Share Your Creations

Contributing

We welcome contributions! Whether it's:

  • ๐Ÿ› Bug fixes and improvements
  • โœจ New effects, modifiers, layouts and drivers
  • ๐Ÿ“ Documentation updates
  • ๐ŸŽจ UI/UX enhancements
  • ๐Ÿ”ง Hardware support
Watch MoonLight Demo

โ–ถ๏ธ Watch the developer quickstart tutorial


โค๏ธ Support the Project

MoonLight is free and open source. Help us continue building amazing tools for the community!

๐ŸŒŸ Show Your Support

Star & Follow

๐Ÿ’ Buy Us a Beer

Help us enjoy a good beer, a tasty meal, or a fine club night while we code:

Every star, subscription, and contribution helps us dedicate more time to making MoonLight better. Thank you for being part of our community! ๐ŸŒ™โœจ๐Ÿ’ซ


๐Ÿ“„ License & Credits

License: GPL-v3 - Free for personal and commercial use

Built on Amazing Open Source Projects


๐ŸŒ™ About MoonModules

MoonLight is a MoonModules.org project - Created by the lighting enthusiasts behind WLED-MM.

Our Mission: Make professional-grade LED control accessible to everyone, from hobbyists to professionals.


โš ๏ธ Disclaimer

Using this software is at your own risk. While we strive for quality, this software is not bug-free. Contributors to this repository are not liable for any issues, including but not limited to spontaneous combustion of LED strips, hardware damage, or the inevitable heat death of the universe. ๐Ÿ”ฅ๐Ÿ•บ๐ŸŒŒ


Made with โค๏ธ by the MoonModules community

About

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.

Resources

License

Stars

Watchers

Forks

Sponsor this project

 

Packages

No packages published

Languages

  • C 64.3%
  • C++ 26.6%
  • Svelte 7.0%
  • TypeScript 1.3%
  • Python 0.6%
  • Scala 0.2%