Skip to content
Library for creating and rendering 2D animations and patterns.
C++ Python Other
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs Merge branch 'master' of Jul 26, 2019
docsrc Docs - Finalize Sphinx migration. Jul 26, 2019
src MandelbrotAnimation - Minor optimization. Jul 26, 2019
tests Version 2.0.2 Jul 10, 2019
.gitignore Docs - Finalize Sphinx migration. Jul 26, 2019
.gitmodules Make PixelMaestro compatible with the Arduino IDE May 28, 2018 Docs - Finalize Sphinx migration. Jul 26, 2019
LICENSE Add license. Apr 8, 2017 Docs - Migrated documentation to Sphinx. Jul 26, 2019
library.json PlatformIO - Added library.json and updated Nov 23, 2018 Version 2.0.2 Jul 10, 2019


latest tag license

PixelMaestro is a graphics library for LED displays. It lets you create dynamic, colorful 2D animations and patterns on any size display. Originally designed for Arduinos, PixelMaestro can be used to drive any kind of LED on any device.


  • True (24-bit) color depth
  • Support for up to 256 independent, layered drawing surfaces
  • Over 10 unique, customizable animations with support for different orientations, speeds, and color schemes
  • Powerful raster graphics editing tools with support for still or animated images
  • Intuitive scheduling system for creating time-based animations and transitions
  • Lightweight communications protocol for controlling devices over USB, Bluetooth, or other serial channel
  • Microcontroller friendly: Use with Arduino, Raspberry Pi, ESP32, and other devices

Getting Started

Click here for a tutorial on using PixelMaestro, or read the documentation.

If you want to run PixelMaestro on an Arduino, you can do so via the Arduino IDE or PlatformIO. For detailed instructions, see the examples folder.

Companion App

PixelMaestro has a companion desktop application called PixelMaestro Studio. PixelMaestro Studio lets you build custom animations, save and share configurations, control devices over USB, and more. Click here to learn more about PixelMaestro Studio.

Running Tests

PixelMaestro uses the Catch framework to run tests. Compiling the test suite requires CMake 3.6.2 or higher.

  1. Navigate to the tests folder.
  2. Run cmake .
  3. Navigate to the bin folder and run PixelMaestro_Test.
You can’t perform that action at this time.