RetroRecomp

https://github.com/user-attachments/assets/818d3278-d698-491e-a58b-e11edc602923

https://github.com/user-attachments/assets/ac2dff32-b23c-44a4-ab81-ef962833251d

RetroRecomp brings several recompilers together in one application. It turns your own game dumps into standalone Windows or Linux executables, with as much native code as possible: no emulator to configure, no dedicated FPGA hardware.

Install in 3 steps

1. Download. Open the latest release and take the file for your computer: Retro-Recomp-<version>-windows-x64-setup.exe on Windows, retro-recomp_<version>_amd64.deb on Debian or Ubuntu (double-click it), or Retro-Recomp-<version>-linux-x86_64-install.run on another 64-bit Linux. Windows may say unknown publisher because the installer is not signed with a paid certificate: choose More info → Run anyway (it is not a virus alert, see Windows security warnings).
2. Add your ROMs. Start Retro-Recomp, drop your own ROM files, ZIPs, arcade romsets, disk images or whole folders on the window, and leave the console on Automatic. ROMs and box art are never included.
3. Convert and play. Press Convert. The first time, Retro-Recomp offers to install the build tools it needs; accept. Your games appear in one folder per console under Games, beside the application, and in the Compiled Games window.

The full guide, with portable downloads, updates and uninstalling, is docs/INSTALLING.md; the keys of every game are in docs/CONTROLS.md.

Console support

Machine	Status	What is converted
Master System	Supported	Two players, PAL/NTSC, quick states and Light Phaser
Game Gear	Supported	Native handheld display and colors
Game Boy	Supported	Original Game Boy, quick states, grayscale or classic green
NES	Supported	Validated cartridge layouts, PAL/NTSC, quick states and Zapper
Mega Drive	Supported	Standard cartridges, PAL/NTSC, SRAM and EEPROM saves, quick states and Menacer
Super Nintendo	Supported	Standard cartridges, LoROM/HiROM, PAL/NTSC, quick states, battery saves and Super Scope
Neo Geo	Supported	Cartridge games: arcade MVS, optional console AES, two players, scores, memory card and quick states; needs your BIOS ZIP in Options → Neo Geo
Capcom CPS-1	Experimental	MAME/FBNeo ZIP romsets of the standard boards (no QSound), up to four players and six buttons, DIP switches, vertical games rotated, quick states; no BIOS, and a split clone needs its parent ZIP beside it
Sharp X68000

Compatibility depends on the game and the revision; there is no fixed game list. See the compatibility guide. Interpreter fallback is always reported: native code, CPU fidelity, hardware fidelity, gameplay validation and physical latency are separate measures, and native execution alone guarantees neither complete compatibility nor zero latency.

Learn more

How it works, what each machine does and how the project is run: start from the documentation index. The windows of the converter are in the screenshots, each release's changes in the release notes, and the machines planned next in the roadmap.

For developers

• docs/BUILDING.md: build and run from source, and the dependencies.
• CONTRIBUTING.md: how to propose a change.
• docs/AGENTS_GUIDE.md: the repository map, the checks that need no ROM and the pitfalls, for coding agents and people alike.
• docs/STANDARDS.md: the rules every change follows.

Credits and licence

Created and integrated by Arthur Reboul Salze. The app's Credits page links the independent projects behind each console.

Original RetroRecomp contributions use the MIT license. Imported components retain their own terms, including noncommercial restrictions; MIT does not override them. See third-party notices. Notices are embedded in the converter; the matching UPX source archive is available in this repository.