GB Recompiled
A static recompiler for original Game Boy ROMs that translates SM83 assembly into portable C code for native execution.
0 projects
About GB Recompiled
GB Recompiled is a static recompiler designed to translate original Game Boy (SM83) assembly into portable C code, allowing classic games to run as native executables without a traditional emulator. This specific repository is a personal development fork by mstan, which integrates upstream work from arcanite24 and GB-Recomp, while adding custom features such as PPU fixes, a TCP debug server, launcher hooks, and game-specific modifications for titles like Pokemon Red/Blue and Megaman Xtreme 2. The tool performs static control flow analysis to identify reachable code, bank switches, and jump tables, generating C code that links against a runtime library (libgbrt) for memory-mapped I/O, audio, and hardware emulation. It supports cross-platform builds on macOS, Linux, and Windows using CMake and Ninja. While the recompiler is a static analysis tool, it includes runtime debugging capabilities, including trace logging, interpreter fallback logging, and a TCP debug server that can be accessed even during the pre-boot launcher phase. Note that this project is a development fork and may diverge from its upstreams at any time; users seeking stable releases are directed to the canonical arcanite24/gb-recompiled project. The tool's ability to handle complex ROMs is enhanced by TOML configuration files for manual entry point specification.
Summarised from the official page linked above.