gameboy

An accurate gameboy emulator written in C from scratch.

development

In order to run the emulator, you need to have cmake, a build system like ninja and a C compiler. SDL2 is included as a submodule and will be compiled along with the project.

1. Clone the repository

git clone --recurse-submodules git@github.com:Jabolol/gameboy.git .

2. Compile the project

cmake -B build -G Ninja && cmake --build build

3. Run the emulator

./build/gameboy /path/to/rom.gb

features

• Bus (Memory Management)
• CPU
• PPU (Graphics)
• Input (Joypad)
• Timer
• Interrupts (V-Blank, LCD, Timer, Serial, Joypad)
• MBC1 (Memory Bank Controller 1)
• Save States (.sav files)

controls

• Arrow Keys - D-Pad
• A - A
• B - B
• Enter - Start

screenshots

Legend of Zelda, The - Link's Awakening

Dr. Mario

Mega Man - Dr. Wily's Revenge

Contra - The Alien Wars

Kirby - Dream Land

Tetris

Super Mario Land 2 - 6 Golden Coins

resources

• Gameboy CPU Manual: A comprehensive guide to the Gameboy CPU.
• Gameboy Opcodes: List of all opcodes for the Gameboy CPU.
• Gameboy Pan Docs: A detailed guide to the Gameboy hardware.

license

This project is licensed under the MIT License - see the LICENSE file for details.