g-gisbert / TinyBoy

TinyBoy is a simple GameBoy emulator written in C++.

TinyBoy - GameBoy Emulator

This project is yet another GameBoy emulator written in C++. The window, graphics and input were handled using SFML. The code was only tested on Windows, but should work on other platforms.

Build & Run Instructions

You can build the project as follows:

git clone https://github.com/g-gisbert/TinyBoy.git
cd TinyBoy
mkdir build
cd build
cmake ..
make -j8

The ROM files are easily found online. To run the emulator, you just need to type :

./emulator [path/to/rom]

The buttons are mapped to A, B, enter (start) and delete (select).

Features

Available:

• All 256 CPU instructions (+256 extended instructions)
• Successfully pass all Blargg's GameBoy CPU tests
• Handle no MBC, MBC1 and MBC3 cartridges

TODO:

• Audio
• GameBoy Color

References

• General GameBoy information (must read)
• GameBoy Opcodes
• GameBoy Opcode Summary
• Game Boy: Complete Technical Reference
• The Cycle-Accurate Game Boy Docs
• GameBoy Doctor (amazing tool for CPU debugging)