JazzLights is LED software focused on syncing patterns between devices. It's designed to work in the absence of network infrastructure, such as in the Black Rock Desert. Devices can use Wi-Fi and Bluetooth Low Energy to communicate over an unconnected mesh network that automatically elects and follows a leader. Devices will stay in sync over time as long as a packet gets through once in a while to avoid clock skew.
JazzLights was the basis for large art cars and dozens of individual vests and other accessories. It's worked well out in the desert for several years. Instructions for building your own vest are here. JazzLights is also integrated with Home Assistant.
As such, JazzLights is not designed as a general-purpose LED library suitable for all projects. Adding new patterns or device layouts requires modifying the C++ code. For cases where syncing is not required or the networking conditions are less challenging, WLED might be a better alternative.
JazzLights supports various models and variants of ESP32 and focuses on boards made by M5Stack, in particular the ATOM Matrix and ATOM S3. JazzLights is developed in C++ and built using PlatformIO. It leverages FastLED and can work with any LEDs supported by FastLED.
The most common build targets can be installed directly from your Web browser to an ESP32 using Jazzlight's Web Installer. Otherwise, all other targets can be installed using PlatformIO.
First install PlatformIO for your favorite editor
here. If you're not sure which editor
to pick, we recommend VSCode (Visual Studio Code). That'll also install the
pio command-line tool. If you've installed PlatformIO more than a few weeks
ago, make sure to update your tools by running: pio pkg update.
To install JazzLights for a furry vest on an M5Stack ATOM Matrix, you can run:
pio run -e vest -t upload.
See DEBUGGING.md.
See CONTRIBUTING.md.
This project initially started off as a fork of unisparks by Dmitry Azovtsev and Igor Chernyshev.