gbemu is a Nintendo Gameboy emulator written in C++. It was written as an exercise (and for fun!) so its goals are exploration of modern C++ and clean code rather than total accuracy.
Building the emulator requires
cmake and SDL and has been tested on macOS and Debian. To compile the project, run:
This builds two versions of the emulator:
gbemu- the main emulator, using SDL for graphics and input
gbemu-test- a headless version of the emulator for debugging & running tests
usage: gbemu <rom_file> [--debug] [--trace] [--silent] [--exit-on-infinite-jr] [--print-serial-output] arguments: --debug Enable the debugger --exit-on-infinite-jr Stop emulation if an infinite JR loop is detected --print-serial-output Print data sent to the serial port --trace Enable trace logging --silent Disable logging
The key bindings are: ↑, ↓, ←, →, X, Z, Enter, Backspace.
The emulator is tested using Blargg's tests - these can be ran with
The test it fails is due to the lack of a timer implementation.
gbemu only supports Gameboy games. I'm working on Gameboy Color support off-and-on at the moment. There's also no audio support yet.