This is a simple game boy emulator written in C The goal of this project is to gain a better understanding of computer architecture, emulation, and systems programming.

I used many resources when building this emulator. Without these, I would've had to reverse engineer the game boy, which is not something I can easily do.

1. https://gbdev.io/pandocs/
2. https://www.pastraiser.com/cpu/gameboy/gameboy_opcodes.html
3. https://www.youtube.com/@lowleveldevel1712

To build on Linux, you will need a C/C++ toolchain along with SDL2 development libraries. Below are some commands to install the dependencies on most Linux distributions:

Arch Linux

sudo pacman -S git base-devel sdl2

Debian/Ubuntu/Linux Mint

sudo apt update
sudo apt install git build-essential libsdl2-dev

Fedora

sudo dnf groupinstall "Development Tools"
sudo dnf install git SDL2-devel

openSUSE

sudo zypper install -t pattern devel_basis
sudo zypper install git libSDL2-devel

Alpine

sudo apk add git build-base sdl2-dev

Void Linux

sudo xbps-install git base-devel SDL2-devel

To compile the emulator, run the following commands:

git clone https://github.com/briskycola/gbemu.git
cd gbemu/src
make -j$(nproc)