Fetching contributors…
Cannot retrieve contributors at this time
33 lines (27 sloc) 1.35 KB


Python library interfacing LED matrix displays with the MAX7219 driver (using SPI) and WS2812 & APA102 NeoPixels on the Raspberry Pi and other linux-based single board computers - it provides a Pillow-compatible drawing canvas, and other functionality to support:

  • multiple cascaded devices
  • LED matrix, seven-segment and NeoPixel variants
  • scrolling/panning capability,
  • terminal-style printing,
  • state management,
  • dithering to monochrome,
  • Python 2.7 and 3.4+ are both supported

max7219 matrix

A LED matrix can be acquired for a few pounds from outlets like Banggood. Likewise 7-segment displays are available from Ali-Express or Ebay.

.. seealso::
   Further technical information for the specific devices can be found in the
   datasheets below:

   - :download:`MAX7219 <tech-spec/MAX7219.pdf>`
   - :download:`WS2812 <tech-spec/WS2812.pdf>`
   - :download:`WS2812B <tech-spec/WS2812B.pdf>`
   - :download:`APA102 <tech-spec/APA102.pdf>`