DMG-01 Game Boy Emulator



cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j
./build/gameboy <rom_path> [--loadSave] [--fastForward] [--trace]
| Argument |
Required |
Description |
<rom_path> |
Yes |
Path to the Game Boy ROM file |
--loadSave |
No |
Resume from the save state for this ROM |
--fastForward |
No |
Start with fast forward enabled |
--trace |
No |
Log a CPU instruction trace |
| 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 |
Tested against various DMG rom test suites
cmake -S . -B build-test -DBUILD_APP=OFF -DBUILD_TESTS=ON -DCMAKE_BUILD_TYPE=Release
cmake --build build-test -j
ctest --test-dir build-test -j8
ctest --test-dir build-test -L '^mooneye$' # test suite
ctest --test-dir build-test -L ppu # component
ctest --test-dir build-test -R mooneye.timer # by test name