GB Recompiled

A static recompiler for original GameBoy ROMs that translates Z80 assembly directly into portable, modern C code. Run your favorite classic games without a traditional emulator—just compile and play.

Features

High Compatibility: Successfully recompiles 98.9% of the tested ROM library (1592/1609 ROMs) MOST OF THE GAMES ARE NOT FULLY PLAYABLE YET Native Performance: Generated C code compiles to native machine code Accurate Runtime: Cycle-accurate instruction emulation (including HALT bug) Precise OAM DMA and interrupt timing Accurate PPU (graphics) emulation with scanline rendering Audio subsystem (APU) with all 4 channels Memory Bank Controllers: Full support for MBC1 (including Mode 1), MBC2, MBC3 (with RTC), and MBC5 SDL2 Platform Layer: Ready-to-run with keyboard/controller input and window display Debugging Tools: Trace logging, instruction limits, and screenshot capture Cross-Platform: Works on macOS, Linux, and Windows (via CMake + Ninja)

Usage Basic Recompilation

./build/bin/gbrecomp <rom.gb> -o <output_dir>

The recompiler will:

Load and parse the ROM header Analyze control flow across all memory banks Decode instructions and track bank switches Generate C source files with the runtime library