Bridge between GameBoy emulator and Matrix, written in Python.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Bram van den Heuvel cb71b02957 Add Dockerfile 2 weeks ago
config Move to config folder 2 weeks ago
.gitignore Ignore screenshot 2 weeks ago
Dockerfile Add Dockerfile 2 weeks ago
LICENSE Initial commit 3 weeks ago Move to config folder 2 weeks ago Move to config folder 2 weeks ago
requirements.txt Add first design 2 weeks ago


Matrix-gameboy is a GameBoy emulator that connects to a Matrix room and allows users to control the game from within the room.

This repository supports the following:

  • Emulate GameBoy games
  • Send control commands to the emulator
  • Get a screenshot posted in the room
  • Emulate GameBoy Advance (GBA) games

How to run

You can run

pip install -r requirements.txt && python

or using Docker, you can either build the repository yourself or run

docker run --rm --name "Matrix_Plays_GameBoy" \
           -v $(pwd)/config:/usr/src/app/config \

Why it was made

It was inspired by matrix-plays-pokemon, which is a JavaScript implementation that supports both GB and GBA using mGBA.

Upon debugging, there were several problems that couldn't be solved, so I decided to write up an equally short program doing the same thing, but in Python.

In short, this implementation is a wrapper of the PyBoy and matrix-nio libraries.