A Python-based tool for designing and generating custom LED displays from a single image file. The goal of this project is to make it easier for electronics hobbyists and makers to create their own custom LED displays without having to manually design the mechanical, graphical, and electronic parts separately. You define your display and select the required MCU and LED-driving configuration, and the tool generates the files needed to build it.
You may find detailed usage instructions in the video: https://youtu.be/lEBiFov_C0w
Steps
- Install Python 3.12
Download from:
Python 3.12 Downloads
https://www.python.org/downloads/release/python-3120/
During install:
check "Add Python to PATH"
Check the active python version
python -V
Setup and Run 2. Create a virtual environment
Create a virtual environment named .venv:
python -m venv .venv
- Activate the virtual environment
PowerShell
.\.venv\Scripts\Activate
Command Prompt (cmd)
.\.venv\Scripts\activate.bat
-
Confirm Python and pip point to the virtual environment
python -Vpython -m pip --version -
Upgrade pip
Upgrade pip, setuptools, and wheel inside the virtual environment:
python -m pip install --upgrade pip setuptools wheel
- Install dependencies
Install the required Python packages:
python -m pip install -r requirements.txt
- Start the app
python main.py

