rcarraretto / docker-gb-dev

docker-based full toolkit for developing gameboy games

This is a docker-based full toolkit for developing gameboy games.

All you need is docker, and it should run on any OS:

mkdir work
docker run --name='gb' --rm -it -p 8080:8080 -v "${PWD}/work:/home/gbdev" gb

Then open http://localhost:8080

A bunch of tools are installed, with an X-windows server, that runs VNC. It's got fluxbox and some windows tools setup with wine.

/home/gbdev is meant to be your working directory, as you are logged in as gbdev. This helps with permissions on mac/linux, as it makes it all run as user-1. In the above docker run example, I am volume-mounting it to a dir work/, so I can compile stuff in that dir. You can mount it however you like, though.

Some useful things to do:

# run text-mode bash inside container
docker exec -it gb bash

## inside container

# run BGB Gameboy Emulator
wine /opt/bgb/bgb.exe

There is also GBDK/RGBDS installed in /opt, so you can use those in your makefiles. I also added some of these tools to the fluxbox menu (right-click on desktop.)

If you want to try it out, put the example/ dir in your work folder, and run this:

docker run --name='gb' -d --rm -p 8080:8080 -v "${PWD}/work:/home/gbdev" gb
docker exec -it gb bash
cd example
make
wine /opt/bgb/bgb.exe demo.gb
docker kill gb

more info

Here are the tools installed in your environment:

• gbdk-2020
• rgbds
• bgb gameboy emulator (via wine)