Repository navigation
Native Linux build of Metroid Prime 4: Beyond as a single AppImage, and now a Windows build too. Bring your own copy: no Nintendo files are included; the first-run setup verifies your dumped ExeFS + RomFS and compiles the game on your machine.
chmod +x Metroid_Prime_4_Recomp-x86_64.AppImage
./Metroid_Prime_4_Recomp-x86_64.AppImageWindows: download MetroidPrime4Recomp-PC-v2026.11.22.1042.zip, extract it anywhere with about 30 GB free, and run Metroid Prime 4 Beyond.exe in the Metroid Prime 4 Beyond folder. Setup and the compiler are included. The Windows work comes from a contributor (pull request #13), who played it on Windows; the build itself is made by GitHub Actions from this repository. It has not been tested on Windows by this repository's maintainer, so please report problems under Issues with Metroid Prime 4 Beyond.log from the game folder.
Linux: the game is installed in ~/.local/share/MetroidPrime4Recomp (set MP4_RECOMP_HOME to use another folder). If you ran an earlier build, its ~/.local/share/MetroidBeyondRecomp folder is moved there on the first start, with your saves, compiled game and shader cache.
New in the 2026-11-08 update
- Fixed: the Ice Belt lake's fog was far too thick and hid the enemies (compressed 3D textures were only partly decoded). The first start after updating asks for a REBUILD of the game code, which takes a few minutes.
- Built-in cheats on the Gameplay page and the in-game Cheats page, off by default: no ammo use, infinite health, infinite jumps, any elemental shot, one-hit kills and more. Based on the GBAtemp cheat research by Gamerjin, Luffysan and ZiT866. Some are still being tested, and Walk through walls can get you stuck, so keep a save.
- Green Energy 10x option, after the mod by melos444.
- AUTO-SET now picks a Low, Medium, High or Ultra profile from your graphics card, video memory, CPU and RAM. If an install is opened on different hardware, the Play screen offers to fit the settings to that PC.
- Fixed: the Control Beam was invisible. Its glowing shots, spiraling ribbons and impact burst now draw.
- Fixed: setup stopping with "the keys file has no titlekek_11" (or another titlekek / key_area_key). Setup now works these out from the master keys in your prod.keys. If your keys file really is too old, it now tells you which firmware the keys must come from. With several prod.keys on the PC (for example an old ~/.switch copy and a newer Ryujinx one), setup uses the newest.
- Workaround for a shader link crash on Mesa 26.2.6.
- The AppImage now runs on older distributions too: it needs glibc 2.35 or newer (Ubuntu 22.04, Debian 12, Fedora 36 and later) instead of 2.38.
- Less stutter when changing areas on AMD graphics under Linux, Steam Deck included. The driver was compiling a new version of some vertex shaders (instanced scenery) while the game waited, 25-40 ms each, on every launch. Those shaders now compile in the background and stay in the driver's cache: in an Ice Belt area-load test, 16 slow frames became 2 and the area-load frame went from 208 ms to 115 ms. On the first start after updating, some objects may appear a moment late while these shaders compile once. A check at startup verifies the new path against the driver and turns it off if they differ (
SWR_INSTANCE_FETCH=0turns it off by hand). - Empty fog volumes are cleared instead of uploaded, which shortens area loads.
- Keyboard and mouse, PrimeHack-style (Linux and Windows, from pull request #13 by Zorkats): WASD moves, the mouse aims, left click fires, right click or Shift locks on, middle click or F fires missiles, Space jumps, Ctrl morphs, E or Alt for visors, 1-4 for the D-pad. In first person the mouse turns the camera by a fixed angle per movement, like a PC shooter. Every button can be rebound in the F1 menu > Controls. Esc opens the game's own menu (map, inventory, Settings), like the − button; quit by closing the window or with QUIT GAME in the F1 menu. The first start after updating asks for a REBUILD of the game code.
- Fixed: the F1 menu closing again right after it opened, once it had been closed with Esc (Linux and Windows).
- RecompLauncher support (Linux and Windows): the launcher asks for your game file, the update and your
prod.keys, builds the game with no window, shows the main settings on the game's page and starts the game directly. Every release now carriesrecomplauncher.json. Without the launcher nothing changes. - Game speed above 60 FPS (#13): the game's logic now follows the frame time, so a 120, 144 or 240 FPS limit no longer makes it run fast, and frame drops no longer slow it down. AUTO-SET may now pick a higher frame limit on a high-refresh screen.
- Hard difficulty unlocked from the start (pull request #14 by Zorkats). Normally it opens only after finishing the game.
- Portuguese (Brazil) can be picked as the game's language (pull request #16 by patrickksmdev); European Portuguese is offered too but untested.
- Fixed (#13): music came out of the right speaker only.
- Native Vulkan renderer (
renderer=vulkan_native, experimental) updated, with fixes for an upside-down picture, a black world after the intro and a white screen (#13). - Windows only (#13): NVIDIA DLSS and AMD FSR 3.1 frame generation, each downloaded from NVIDIA's or AMD's own GitHub by a button on the Graphics page, and launcher themes.
- New Extract shaders button (Advanced > Shaders, Linux): reads your own game files and translates every shader in them ahead of time, with a progress dialog. About 2 minutes and 131 MB on a fast PC (it reads all 27 GB of the game's files once, so expect several minutes on a Steam Deck). Optional: the game reads the result as it needs it, but the effect on stutter is small, since the graphics driver still compiles each shader when an area loads it. Needs the
zstdpackage. - New
--install DIRoption to install the game somewhere else, such as a Steam Deck's SD card:./Metroid_Prime_4_Recomp-x86_64.AppImage --install /run/media/deck/YOUR-SD-CARD, or put--install /run/media/deck/YOUR-SD-CARDin the game's Launch Options in Steam. The choice is remembered. See "Installing somewhere else" in the README.
Highlights of this build
- Steady 60 fps in play on an RX 9070 XT (Mesa 26.2): 59.9 fps average, 2 frames over 100 ms in a 5.6-minute session, both right after loading.
- Fixed: black arm cannon and enemies after cutscenes (lighting updates were never picked up), the magenta flash at every spawn and likely the rainbow screen (unloaded mip levels were sampled), speckled textures, the sun shining through walls, black rocks and sky, the morph-ball box, the scan visor.
- Shader stutter: shaders are built before they're drawn, with the right variant predicted; indirect-branch shaders no longer freeze the game in new areas.
- Audio: splitters, cutscene voices (5.1 downmix), sound at real speed.
- No more slow frame every 5 seconds: the background shader scan rereads only what changed (about 70 MB instead of 300 MB) and runs at low priority on Linux.
- Sol Valley: the ground is there, without holes, lit and without black tiles while turning (five shader translation fixes: 2D-array texel fetches, mip-level queries, NaN to integer, unwritten vertex outputs).
- Updates from the launcher: the Play screen checks this page when it opens and offers newer builds (the new AppImage replaces this one after a checksum check; the previous one is kept for Undo). This build is the first with it: earlier downloads need this one fetched by hand once. Needs the system's libcurl (the
curlpackage). - Setup takes your game's
.xci/.nspand the update's.nspdirectly: they're decrypted with your own Switch'sprod.keys(in~/.switchor where Ryujinx / yuzu keep it) and the update is applied, no emulator needed to extract them. Extracted folders still work. - Setup with an eShop
.nspas the game: it now checks that the game's RomFS decrypts before writing anything and picks the game's exact program, instead of ending with "444 RomFS files are not the RS15 versions". If it still stops, the message names the cause (for example a keys file whose titlekek doesn't match its master key: dump the keys again). - Runs on any x86-64 CPU, Steam Deck included (the first upload needed AVX-512 and glibc 2.43: "CPU ISA level is lower than required"). Needs glibc 2.35 or newer.
- Renamed to Metroid Prime 4 Recomp; settings left over from the project it was forked from (cutscene skip, fast loading, aspect patches, 60 FPS cutscenes) are removed.
See the README for requirements, setup, the full list of fixes and known issues.
Built from commit 755c33a. Linux AppImage version 2026.11.21.1144, SHA-256: b99e2fafcf59252790c86451a6bf39e4d4e45fd152e9cb80d4a38881067500c8. Windows zip version 2026.11.22.1042, SHA-256: 2a1ca69bd13ef1aa5a1ceada98b66c4cefbaecd481b3e79e31110d37ccc442db