DMG-01 Game Boy Emulator
This application emulates the orginal Game Boy hardware allowing users to play Game Boy games. It has been tested with a few games such as, Pokemon Red, Tetris and Zelda's Awakening.
mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make./gameboy ${PATH_TO_ROM} [--trace] [--loadSave] [--fastForward]| Argument | Required | Description |
|---|---|---|
<rom_path> |
Yes | Path to the GameBoy ROM file |
--trace |
No | Enables debug trace mode |
--loadSave |
No | Loads saved game data if available |
--fastForward |
No | Speeds up the game when enabled |
| Keyboard Key | GameBoy Button | Function |
|---|---|---|
| Z | B | B button |
| X | A | A button |
| Enter/Return | Start | Start button |
| Tab | Select | Select button |
| ↑ (Up) | D-pad Up | Move up |
| ↓ (Down) | D-pad Down | Move down |
| ← (Left) | D-pad Left | Move left |
| → (Right) | D-pad Right | Move right |
| S | N/A | Save state |
| F | N/A | Toggle fast forward |
Core components are documented under docs.


