A gif viewer that selects a random gif to play from a folder of gifs, renders it to an rgbmatrix display, and continues selecting random gifs until all are played, then starts all over again. Designed to run without a network connection.
Built for Anime Central 2026.
Note
This setup can be used for other kinds of gif collections. This just happens to be Umamusume themed.
Important
Most of this code was rushed, but works (it's still in the v.0 stage).
Expect more refinements/cleanups at some point (if I ever get around to it).
(Note: No LLMs were involved in this project.)
This project assumes you're familiar with rgbmatrix displays and have a Raspberry Pi on hand.
These scripts are not designed for any other setups (Arduino, ESP32, RP2040, etc.)
- Clone this repo:
git clone --depth=1 https://github.com/WeegeeNumbuh1/MamboMonitor
- Add URLs to
links.txt. - Run the install script
install.shto install the required python packages and install the service. - Run
main_downloader.pyintoolsto download Umamusume gifs from Tenor if you don't have any already. - Edit
config.yamlto match your existing rgbmatrix setup.- The defaults are based on my personal config (2x 64x32 displays in V-Mapper:Z orientation)
- Run the main script,
MatikanetannhauserMain.py:
python MatikanetannhauserMain.py img_src
# or, provide a path to your desired gif collection
# e.g. python MatikanetannhauserMain.py /username/memesIf you wish to uninstall, use the uninstall.sh script (coming soon™).
to-do
Most of the code was adapted from my other project, FlightGazer.
Questions? Contact me or file an issue with this repo.
(clicking the above gif will link to the video)
(to be decided)