PrimeRecomp v0.0.2 (early beta)

PrimeRecomp runs Metroid Prime Remastered (Nintendo Switch) natively on Windows and Linux, including the Steam Deck. The game's code is statically recompiled for your PC and the Switch's system services and graphics are reimplemented on the PC, with Vulkan for the graphics. No emulator runs.

PrimeRecomp is built on LAS Recomp by Peiikai and the LAS Recomp contributors. Nearly everything that makes it possible is their work. Full credits are in the README.

Note

No game files are included. You need your own copy of Metroid Prime Remastered v1.0.0 (no updates), dumped from your own console and extracted: a folder that holds exefs and romfs.

What's new in v0.0.2

• Linux and the Steam Deck (experimental): PrimeRecomp-v0.0.2-linux-x86_64.AppImage. So far it has only been tested on a software renderer (the start screen, the setup, the title screen and a loaded save), not yet on a real Linux GPU or a Steam Deck. Reports, good or bad, are very welcome.
• Vulkan fixes for drivers other than NVIDIA's: the stencil state is always set, and the game memory the GPU reads directly stays within the driver's allocation limit.

Getting started

Windows

1. Download PrimeRecomp-v0.0.2-windows.zip below. Extract it to a folder you can write to, such as Documents or a games folder (not Program Files).
2. Run primerecomp.exe. Choose your game folder (the one with exefs and romfs), then click Set up. Setup runs once: it copies the game files and recompiles the game on your PC, which takes a few minutes.
3. Press Play.

Linux

1. Download PrimeRecomp-v0.0.2-linux-x86_64.AppImage below and make it executable (chmod +x, or Properties -> Permissions in your file manager).
2. Run it, choose your game folder, Set up, then Play. Everything it writes goes to ~/.local/share/primerecomp.

Steam Deck

1. In Desktop Mode, put the AppImage in your home folder, right-click it -> Properties -> Permissions -> "Is executable", and copy your game files onto the Deck or its SD card.
2. Run the AppImage, choose the game folder and Set up (once, in Desktop Mode: the folder picker is a desktop file dialog).
3. Add it to Steam: Games -> Add a Non-Steam Game to My Library -> Browse (file type "All Files") -> the AppImage. It then starts from Game Mode.
4. In the game, press both sticks in to open PrimeRecomp's menu and set Controls -> Face buttons to Xbox, so the Deck's A button is A.

More in docs/linux.md, including how to keep the game files on the SD card.

Requirements: Windows 10 or 11 (64-bit), or a 64-bit x86 Linux with glibc 2.35 or newer (SteamOS included); a CPU with AVX2 (Intel Haswell / AMD Zen or newer); a GPU with a Vulkan 1.3 driver; and about 15 GB of free disk space.

What's in this build

• Boot, menus, the Frigate Orpheon, and Tallon IV. The Landing Site, Chozo Ruins and Magmoor Caverns have been played so far. Saving and loading work.
• Mouse aim that turns and aims directly, like a PC shooter. Full keyboard, mouse and controller rebinding.
• Controllers work out of the box (Xbox, PlayStation, Switch Pro, Steam Controller, Steam Deck and others), with gyro aiming and rumble.
• Resolutions up to 8K, AMD FSR 1, SMAA and anisotropic filtering.
• Ultrawide support (the HUD stays in the middle 16:9 area) and adjustable field of view.
• 60 or 120 fps. Every cutscene can be skipped.

To open PrimeRecomp's own menu, press F1, or press both sticks in on a controller. Press F11 or Alt+Enter for fullscreen. The README lists all keyboard controls.

Known issues

This is an early beta.

• Some lighting glitches. Visor effects such as rain drops sometimes don't appear.
• Nobody has played past Magmoor Caverns yet, so later areas may crash or freeze.
• The Linux version hasn't run on real Linux hardware or a Steam Deck yet (see above).

Reporting bugs

Please open an issue and attach primerecomp.log (Windows: in the PrimeRecomp folder; Linux and Steam Deck: in ~/.local/share/primerecomp). For a graphics problem, press F9 at the spot to save a capture to build/f9_<frame>/ in that folder (zip it up), and press F8 to note your position in positions.txt.

Support

If you enjoy PrimeRecomp, you can buy me a coffee.

---

SHA-256:

• PrimeRecomp-v0.0.2-windows.zip: 68225bf562c53315252813b2130a0e6455fe67072012d5fe9d27606895a95c1a
• PrimeRecomp-v0.0.2-linux-x86_64.AppImage: bcf460e72942158d5345a7809a2cc57a619c4f383ce9cff25b6c8edbb9896d43

PrimeRecomp v0.0.1 (early beta)

PrimeRecomp runs Metroid Prime Remastered (Nintendo Switch) natively on Windows. The game's code is statically recompiled for your PC and the Switch's system services and graphics are reimplemented on Windows and Vulkan. No emulator runs.

PrimeRecomp is built on LAS Recomp by Peiikai and the LAS Recomp contributors. Nearly everything that makes it possible is their work. Full credits are in the README.

Note

No game files are included. You need your own copy of Metroid Prime Remastered v1.0.0 (no updates), dumped from your own console and extracted: a folder that holds exefs and romfs.

Getting started

1. Download PrimeRecomp-v0.0.1-windows.zip below. Extract it to a folder you can write to, such as Documents or a games folder (not Program Files).
2. Run primerecomp.exe. Choose your game folder (the one with exefs and romfs), then click Set up. Setup runs once: it copies the game files and recompiles the game on your PC, which takes a few minutes.
3. Press Play.

Requirements: Windows 10 or 11 (64-bit), a CPU with AVX2 (Intel Haswell / AMD Zen or newer), a GPU with a Vulkan 1.3 driver, and about 15 GB of free disk space.

What's in this build

• Boot, menus, the Frigate Orpheon, and Tallon IV. The Landing Site, Chozo Ruins and Magmoor Caverns have been played so far. Saving and loading work.
• Mouse aim that turns and aims directly, like a PC shooter. Full keyboard, mouse and controller rebinding.
• Controllers work out of the box (Xbox, PlayStation, Switch Pro, Steam Controller and others), with gyro aiming and rumble.
• Resolutions up to 8K, AMD FSR 1, SMAA and anisotropic filtering.
• Ultrawide support (the HUD stays in the middle 16:9 area) and adjustable field of view.
• 60 or 120 fps. Every cutscene can be skipped.

To open PrimeRecomp's own menu, press F1, or press both sticks in on a controller. Press F11 or Alt+Enter for fullscreen. The README lists all keyboard controls.

Known issues

This is an early beta.

• Some lighting glitches. Visor effects such as rain drops sometimes don't appear.
• Nobody has played past Magmoor Caverns yet, so later areas may crash or freeze.
• Windows only for now.

Reporting bugs

Please open an issue and attach primerecomp.log from the PrimeRecomp folder. For a graphics problem, press F9 at the spot to save a capture to build\f9_<frame>\ (zip it up), and press F8 to note your position in positions.txt.

---

SHA-256 of PrimeRecomp-v0.0.1-windows.zip: d470ad62c4b8c8b6f3eccd6cb4e617b24eca97aab8b327237e218e5b8ebd2d4c