Arduino Simple LED Matrix Library

By Jamal Bouajjaj


The purpose of this software is to generate an column-addressed array based off a visual representation of the matrix. This array then can be copied unto an Arduino example (current tested only on my library) in order to display the create image.


GitHub Repository:

Click in the icon below to direct you to the Github repository, where you can download the library from:

GitHub Repository Link

Software Description:

Note: Python3 and the Python libraries Tkinter and pyperclip are required in order for the software to run.

Current there are 2 python software published with this library which can be found in the GitHub repository(Python software is under each folder):

Here are a screenshot of both software:

Single Matrix Screenshot 4 Matrix Screenshot

Screenshot of 'Simple'

Screenshot of '' with example PNG bitmap imported with "Import Picture" button

In order to 'draw' a matrix, click on a 'pixel' to toggle it on or off (red is off, blue is on). The entry on top of the software will determine the name of the array that will be copied.
In order to copy the generated array, click on the "Copy Array" button. The array then can be pasted unto the corresponding Arduino example to test your design.
The "Fill Display" and "Clear Display" are used to completely turn on or off all 'pixels' in the array.
In the software, there is a button named "Import Picture". This is to import a 32x8 image that will be then intepreted and used to determine which pixel is on or off. An example image has been provided in the same folder as the software, titled "4-Matrix Test Image.png".
If you want to import your own image, make sure it's 32x8, or else the software will reject it. For best outcome, make sure the 'pixels' to be turned on are black and the 'pixels' to be turned off are white in whichever image edition software you are using. Also, for best outcome, make sure you create the bitmap as a PNG, so that there is no loss/misintepretation of data through JPEG's compression.

Arduino Software:

Altough the software can be used with any library that can take a column-addressed array. With that said, this software has been currently only tested with my own software

My LED Matrix library's documentation page can be found HERE. The section "Python Matrix Generators" on that page describes which example to use for whichever software you used.