Python RGB Matrix games and animations https://www.xythobuz.de/ledmatrix_v2.html

Thomas Buck c70d975e83 slight tweak to gamepad input code		7ヶ月前
fonts	more fonts. more instructions. added images and colors from cccamp23 style guide. text rendering now possible with colors. custom font spacing. images automatically scaled and cropped. fixed qr text and colors. allow exiting test gui with q or esc. better target check.	10ヶ月前
hardware	various adjustments	9ヶ月前
images	add NASA astronomy picture of the day loader. and some more pics.	7ヶ月前
tools	systemd unit	8ヶ月前
.gitignore	add NASA astronomy picture of the day loader. and some more pics.	7ヶ月前
README.md	systemd unit	8ヶ月前
apod.py	add NASA astronomy picture of the day loader. and some more pics.	7ヶ月前
bdf.py	split text drawing interface into multiple methods.	9ヶ月前
breakout.py	slight tweak to gamepad input code	7ヶ月前
camp_pico.py	various adjustments	9ヶ月前
camp_small.py	rename images	8ヶ月前
config.py	initial weather page and other small stuff	8ヶ月前
copy.sh	various on-camp adjustments	8ヶ月前
gamepad.py	slight tweak to gamepad input code	7ヶ月前
games.py	various on-camp adjustments	8ヶ月前
image.py	image test runner shows both bilinear and nearest neighbour. add aphex twin logo.	8ヶ月前
img_tmp.py	pre-created images with less whitespace	9ヶ月前
life.py	change brightness with controller. tweak tetris.	10ヶ月前
livingroom.py	add NASA astronomy picture of the day loader. and some more pics.	7ヶ月前
manager.py	randomized manager should not show same screen twice	8ヶ月前
mapper.py	slight tweak to gamepad input code	7ヶ月前
net.py	various on-camp adjustments	8ヶ月前
pi.py	various adjustments	9ヶ月前
pi.sh	convenience pi update script	8ヶ月前
pico.py	slight tweak to gamepad input code	7ヶ月前
pico_ota.py	various on-camp adjustments	8ヶ月前
qr.py	initial weather page and other small stuff	8ヶ月前
qr_tmp.py	pre-created images with less whitespace	9ヶ月前
runner.py	slight tweak to gamepad input code	7ヶ月前
scroll.py	kind of fix manager	9ヶ月前
snake.py	slight tweak to gamepad input code	7ヶ月前
solid.py	change brightness with controller. tweak tetris.	10ヶ月前
splash.py	change brightness with controller. tweak tetris.	10ヶ月前
telegram.py	initial weather page and other small stuff	8ヶ月前
test.py	initial weather page and other small stuff	8ヶ月前
tetris.py	slight tweak to gamepad input code	7ヶ月前
util.py	randomized manager should not show same screen twice	8ヶ月前
weather.py	slight tweak to gamepad input code	7ヶ月前

RGB Matrix Visualizer

Render various content to various output devices.

Quick Start

Just run:

./manager.py

and go from there.

Dependencies

You always need:

pip install Pillow bdfparser "qrcode[pil]" evdev wetterdienst

For evdev to find all devices you may need to add your user to the input group or run the scripts as root.

The rest depends on the output device chosen. For debugging on your host PC you can use the TestGUI interface with pygame:

pip install pygame

Setup

The other currently supported option is using a Raspberry Pi with the Adafruit RGB Matrix Bonnet and a matching LED Matrix. The tutorial suggests using the Adafruit Raspberry Pi Installer Script for the RGB matrix. This will give you the hzeller/rpi-rgb-led-matrix project which includes the Python bindings used in this project.

Use the included systemd unit to auto-start the script on Raspberry Pi:

sudo cp tools/led.service /etc/systemd/system/led.service
sudo systemctl daemon-reload
sudo systemctl enable --now led.service

Adding your own visualizations

Take a look how others are implemented. You can chain the different screens together using Manager and also check for conditions, as seen in CheckHTTP. This should enable you to quickly create something usable.

One goal is to run this project on public events. If this is the case, and you want your own message to appear, simply open up a PR or send an email with a patch. Because of different versions between host PCs and the Raspbian OS, things may look slightly different, especially regarding stuff like animated GIF viewing.

Licensing

This project is licensed as beer-ware:

----------------------------------------------------------------------------
"THE BEER-WARE LICENSE" (Revision 42):
<xythobuz@xythobuz.de> wrote this file.  As long as you retain this notice
you can do whatever you want with this stuff. If we meet some day, and you
think this stuff is worth it, you can buy me a beer in return.   Thomas Buck
----------------------------------------------------------------------------

The included fonts from farsil/ibmfonts are licensed as CC-BY-SA-4.0.

The fonts from cmvnd/fonts are licensed as GPLv3.

The tiny font is from robey and licensed as CC0.

The included GIFs are from GifCities.

The included DWD weather API documentation is from their website.

README.md