https://github.com/lupin3000/rgb-matrix-led
Simple games for RGB Matrix LED (from Adafruit)
https://github.com/lupin3000/rgb-matrix-led
adafruit gpio matrix-panel python raspberry-pi rgb-matrix-bonnet rgb-matrix-led
Last synced: about 2 months ago
JSON representation
Simple games for RGB Matrix LED (from Adafruit)
- Host: GitHub
- URL: https://github.com/lupin3000/rgb-matrix-led
- Owner: Lupin3000
- Created: 2024-01-04T10:22:55.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2024-01-27T18:20:43.000Z (over 2 years ago)
- Last Synced: 2025-03-21T18:52:05.010Z (over 1 year ago)
- Topics: adafruit, gpio, matrix-panel, python, raspberry-pi, rgb-matrix-bonnet, rgb-matrix-led
- Language: Python
- Homepage: https://softwaretester.info
- Size: 31.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# RGB Matrix LED - Games
## Requirements
- Adafruit RGB Matrix LED (_min. 1x 64x32_)
- Adafruit RGB Matrix Bonnet for Raspberry Pi
- Raspberry Pi (_min. Zero WH_)
- USB adapter (_USB to Micro USB_)
## Installation
In case your RGB Matrix LED installation is already done, you only need to ensure `Python evdev` and `git` is installed.
```shell
# change to home directory (optional)
$ cd ~
# update packages (optional)
$ sudo apt update && sudo apt upgrade -y
# get rgb matrix installation script
$ curl https://raw.githubusercontent.com/adafruit/Raspberry-Pi-Installer-Scripts/main/rgb-matrix.sh >rgb-matrix.sh
# run installation
$ sudo bash rgb-matrix.sh
```
> Please be patient with your installation! This task can take some time. Also verify that installation was successful before you continue.
```shell
# install needed python packages and git
$ sudo apt install -y git python3-evdev
```
Done ... now clone the repository and enjoy the games.
```shell
# clone repository
$ git clone https://github.com/Lupin3000/RGB-Matrix-LED.git
# change into repository directory
$ cd RGB-Matrix-LED/
```
## Controller
To ensure your controller is connected and can be used, verify the input devices.
> In case the input will not be discovered, please check your USB cable and USB port on Raspberry Pi!
```shell
# verify current input devices (optional)
$ ls -la /dev/input/
```
Because you should run the Python scripts with `sudo` permission, it's good to add the root user into `input` group. Otherwise, it will show error messages.
```shell
# add root to input group
$ sudo usermod -a -G input root
```
> Inside directory `usb` are some files to help with your controller. In case you don't have same you can use these scripts, to configure any other brand. But also adaptations inside `lib/stadia_controller` will be needed!
```shell
# list all devices (optional)
$ sudo python -B usb/show_all_devices.py
# show all events
$ sudo python -B usb/show_device_events.py
```
## Execute games
All games are started very in same way:
```shell
# run Pong
$ sudo python -B Pong.py
# run Snake
$ sudo python -B Snake.py
# run Starfighter
$ sudo python -B Starfighter.py
```
> You can stop these games also with `CTRL` + `c` or just wait to lose.
## Participate the project
You are very welcome to take part in this project! No matter whether you want to develop new games or expand / optimize existing games. There are very few rules:
- Games must be developed in MicroPython
- No insults are allowed
- The code should be at least somewhat documented (e.g. DocStrings)
- Anyone who destroys something has to fix it again