Overview

Carousel is a Raspberry Pi Zero-powered LED matrix display framework designed to support custom applications and extensible functionality.

Key features

Apps

• Main screen / Clock
• Gif viewer
• Conways game of life
• Weather¹
• Notion todo lists²
• Pomodoro timer
• Spotify player³
• Stocks & crypto
• Youtube subscribers count
• ...

Functionalities

• Logging system
• One-file configuration
• Makefile
• Comprehensive documentation to add new apps
• Web interface to manage the apps
• CAD files for 3D printing
• ...

Documentation

Comprehensive guides to help you get started:

• Wiring Guide
• Installation Guide
• Configuration Guide
• rpi-rgb-led-matrix Library Documentation

Troubleshooting

If you encounter wiring-related issues, please consult the Wiring Guide or the official rpi-rgb-led-matrix wiring documentation.

For other technical issues or questions, please submit an issue on the repository.

Contributing

If you want to contribute to the project, you can follow the steps described in the CONTRIBUTING file and get in touch with us at this email: morgan@kodelab.fr.

Acknowledgments

We would like to express our gratitude to the following individuals for their contributions to the start of the project:

• Allen's lab: for the matrix-dashboard project, which is a great starting point for building a dashboard using the Matrix platform through his video.
• Ty Porter: for bringing public Allen's lab's project source code and making it available to the community.
• Henner Zeller: for the rpi-rgb-led-matrix library, which is the core of the communication between the Raspberry Pi and the led matrix.
• Milk And Espresso: for making some of the original background images.

Additionally, we would like to thank the following people for their contributions to the project:

• Dimitry Siebert: for bringing the project to life with his CAO expertise and PCB design skills.
• Yann M. Vidamment: for adapting Allen's lab project to our needs and vision regarding the software part of the project.

Finally, we would like to thank all the people who tried the project and gave us feedback to improve it.

License

This project is licensed by the original author under the GNU GPL v3, which allows you to use, modify, and distribute the software freely, as long as you provide the source code and do not add restrictions that limit others' rights under the same license. For full details, refer to the LICENSE file.

Footnotes

1. The weather app is compatible with the OpenWeatherMap API or AccuWeather API. You will need to create an account on their website to get an API key. Although AccuWeather won't require you to enter your credit card details. ↩

2. The Notion todo lists app is compatible with the Notion API. You will need to create an account on their website to get an API key. ↩

3. The Spotify player app is compatible with the Spotify API. You will need to create an account on their website to get an API key. ↩