Skip to content

About

Static recompilation of your own retro game dumps into standalone Windows and Linux executables, as native as possible, with a counted interpreter fallback.

Topics

Resources

Contributing

Stars

21 stars

Watchers

0 watching

Forks

Repository files navigation

RetroRecomp: the RR cartridge
RetroRecomp

Retro consoles and classic computers. One growing project.

Atari ST · Capcom CPS-1 · Capcom CPS-2 · Commodore Amiga · Commodore Amiga 1200 · Game Boy · Game Boy Advance · Game Gear · Master System · Mega Drive · MSX · MSX2 · MSX2+ · Neo Geo · NES · Nintendo 64 · PC Engine / TurboGrafx-16 · Sharp X68000 · Sony PlayStation · Super Nintendo · and Adventure (ScummVM)

Less emulation. No FPGA. As native as possible.

Release version 1.8.0 Nineteen machine profiles, and Adventure (ScummVM) as a category of its own Windows x64 and Linux x86-64 Original contributions: MIT

Download · Build from source · Compatibility · What's new · Credits and licensing · Website

Powered by mstan & RetroPortingToolKit

RetroRecomp-explainer.mp4

RetroRecomp in under two minutes: how your own game dumps become native Windows and Linux programs.

retrorecomp-architecture_LD.mp4

Under the hood, in under three minutes: how RetroRecomp is built and how it works.

Compiled Games collection in French, with scan-level stars, box art and a game summary, demo collection

Compiled Games, in French: favorites, scan-level stars, covers, summaries and New paths.

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

Console Status Qualification progress
Atari ST* supported █████████░ 91 %
Capcom CPS-1 supported █████████░ 90 %
Capcom CPS-2 supported █████████░ 94 %
Commodore Amiga* supported █████████░ 91 %
Commodore Amiga 1200* supported ████████░░ 84 %
Game Boy supported ██████████ 97 %
Game Boy Advance supported █████████░ 91 %
Game Gear supported █████████░ 93 %
Master System supported ██████████ 97 %
Mega Drive supported ██████████ 97 %
MSX supported █████████░ 93 %
MSX2 supported █████████░ 90 %
MSX2+ supported █████████░ 91 %
Neo Geo supported █████████░ 94 %
Nintendo 64* supported █████████░ 90 %
Nintendo NES supported █████████░ 91 %
PC Engine / TurboGrafx-16 supported █████████░ 94 %
Sharp X68000 supported █████████░ 91 %
Sony PlayStation* supported ████████░░ 81 %
Super Nintendo supported █████████░ 94 %
Adventure (ScummVM) supported outside this list: emulated, 0 % native code

* The PlayStation, the Nintendo 64, the Atari ST and the two Amigas are not fully recompiled systems: each game runs on a complete emulator core inside its executable, with native code for the main CPU only, so their native share is not comparable with the other machines' (how to read it; detail on each machine's page).

Qualification progress, approximate: the share of the gates that apply to a machine that are met (half a point for a partial one), drawn from the matrix of QUALIFICATION.md. It is not a quality score, it mixes none of the five measures, and it never decides a status: leaving the experimental status is the owner's own decision.

Adventure (ScummVM) is a category of its own, supported since 1.7.1: point-and-click adventure games run in ScummVM, emulated (0 % native code, by design), each packed with its own files into one executable with its saves in datas/ (how it works and what supported means here). It is not part of the qualification matrix of the recompiled consoles.

The Capcom CPS-1 line includes its 18 QSound boards (CPS-1.5). Some machines need files you supply yourself: the Neo Geo and the Game Boy Advance (their BIOS), the Sharp X68000 (its IPL and font ROM), and the QSound boards and the Capcom CPS-2 (their DSP ROM, and for the CPS-2 the key file of the romset). The Atari ST (a TOS), the PlayStation (a BIOS) and the MSX, MSX2 and MSX2+ cartridges (an MSX, MSX2 or MSX2+ BIOS) take your own as an option and have a free fallback; MSX2+ disks need your own MSX2+ BIOS and disk ROM. The Commodore Amiga takes your own Kickstart image, needed only by the installs that ask for one. What each machine converts, its options and its limits are on its page.

In development

No other machine is available yet. Each new one starts as an experimental profile; no date is promised.

Per-machine plans are in the roadmap.

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.

New in 1.8.0. The Front-end: your compiled games as a wall of box art, one console at a time, played from the sofa with a gamepad (favourites, title search with an on-screen keyboard, covers per row on L2 / R2, full screen or window), and an option to start Retro-Recomp straight in it. A conversion left half built no longer blocks the next one, and the converter no longer closes silently during a batch. No game is converted again: exports of 1.7.9 are only rebuilt. Details in the release notes and Compiled games.

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

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.

About

Static recompilation of your own retro game dumps into standalone Windows and Linux executables, as native as possible, with a counted interpreter fallback.

Topics

Resources

Contributing

Stars

21 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages