jabolol / gameboy

An accurate GameBoy emulator written in C from scratch

gameboy

An accurate gameboy emulator written in C from scratch.

development

In order to run the emulator, you need to have SDL2 installed on your machine, as well as build-essential.

1. Clone the repository

git clone [email protected]:Jabolol/gameboy.git .

2. Compile the project

make

3. Run the emulator

./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.