Download · Get started · Road to 1.0 · FAQ · Issues · Changelog
Metroid Dread Recomp is a static recompilation of Metroid Dread (Nintendo Switch, version 2.1.0) into a native application for Windows and Linux, built on your PC from your own copy of the game. No emulator: the game code is translated from ARM64 to C once, compiled by a bundled compiler, and runs directly on your CPU.
Taken in Metroid Dread Recomp at 2.25x resolution with TAA and ambient occlusion. The game is © Nintendo; you need your own copy to run it.
Important
No game files are included. You need your own copy of Metroid Dread, updated to version 2.1.0 and dumped from your own Nintendo Switch. This project provides no game files, keys, firmware, dumping or decryption tools, and no instructions for obtaining them. The game code is recompiled locally, on your machine, from your files.
Note
Made with AI. Most of the runtime fixes, performance work, launcher, setup and tooling were written by Claude (Anthropic, through Claude Code), directed, tested and reviewed by a human. Every change is built and measured on real hardware before release. The full source is here to read and build.
Warning
Pre-1.0. The whole game can be played from start to end, but expect rough edges on hardware that hasn't been tested yet. On AMD graphics cards, use Native Vulkan (the default there): AMD's OpenGL driver can crash. Read the FAQ before opening an issue.
- The whole game, from your own 2.1.0 copy, on Windows and Linux (Steam Deck included)
- Frame rates of 60, 90, 120, 144, 240 or unlimited, with cutscenes and loading screens at your frame rate
- Resolution scaling, 16:10, 21:9 and 32:9 (experimental) with a wider view instead of a stretched one
- Two renderers: OpenGL and Native Vulkan
- TAA, FXAA, NVIDIA DLAA (RTX, downloaded from NVIDIA when you ask for it), sharpening, anisotropic filtering up to 16x, XeGTAO ambient occlusion, higher shadow resolution, HDR (experimental)
- Any controller through SDL2, keyboard remapping, mouse aim, rumble and HD rumble (Switch Pro / Joy-Con, DualSense)
- Xbox / PlayStation button prompts (community packs, fetched on request)
- Skip any cutscene, built-in cheats and Atmosphere cheat files, virtual amiibo
- Mods and texture packs (LayeredFS layout), 5.1 audio, Brazilian Portuguese fan translation
- AUTO-SET picks settings for your PC; one-click updates with undo; Add to Steam
- One button to make a bug report with your logs and system info
You need: your own Metroid Dread 2.1.0 dump (ExeFS and RomFS), Windows 10 or later or Linux on x86-64 (glibc 2.38+), a GPU with OpenGL 4.3 or Vulkan, and 8 GB of RAM.
- Download the latest build from Releases:
- Windows: the
.zip. Extract it to a folder you can write to (not Program Files). - Linux and Steam Deck:
Metroid_Dread-x86_64.AppImage. Make it executable and run it (Linux and Steam Deck).
- Windows: the
- Start it and choose the folder with your dump (ExeFS:
main,main.npdm, ...; RomFS:system,packs, ...). If the 2.1.0 update is a separate dump, choose it as the update folder. Every file is checked against the 2.1.0 file list, then the game code is compiled once (a few minutes). Your own files aren't changed. - Press AUTO-SET if you're not sure about settings, then PLAY. F1 or the Home / Guide button opens the in-game menu.
Updating: the Play screen offers UPDATE when a new release is out. Only changed files are downloaded and checked before anything is replaced; UNDO goes back. Saves, settings and mods are never touched.
- Windows:
Metroid Dread_data\savenext toMetroid Dread.exe - Linux / Steam Deck:
~/.local/share/MetroidDreadRecomp/Metroid Dread_data/save
Close the game and copy the whole folder to back it up.
Any controller SDL2 knows works. Keyboard defaults (Switch button → key):
| Button | Key | Button | Key |
|---|---|---|---|
| Left stick | W A S D | Right stick | I J K L |
| A | X or Space | B | Z |
| X | C | Y | V |
| L / R | Q / E | ZL / ZR | 1 / 3 |
| L3 / R3 | Left Shift / F | + / − | Enter / Backspace |
| D-pad | Arrow keys | Menu | F1 or Esc |
Every key can be rebound on the Play screen (Controls > Keyboard).
0.x builds are previews. Windows and Linux get finished first; 0.9 brings Android and macOS; 1.0 is the first release meant to be solid everywhere: no known crash, locked frame rates, every scripted moment right above 60 FPS, and the experimental options finished. Left to do, by area:
| Area | Left for 1.0 |
|---|---|
| Performance | locked 120 in the heaviest effect scenes, shorter hitches on video starts and first room entries |
| Stability | AMD OpenGL driver crash, a few crashes in specific places |
| High frame rates | slow-motion sequences, cutscene audio sync, quick-time events |
| Graphics | Intel / Mesa glitches, ultrawide and HDR out of experimental |
| Controls | Switch 2 Pro Controller on Linux |
| Steam Deck | Game Mode fully checked, TAA / AO cost |
| 0.9 | Android and macOS ports |
Every item, with its issue: Road to 1.0.
Use the latest release, check the FAQ and the existing issues, then press REPORT on the Play screen: it zips your logs, settings and system info and opens a prefilled issue. Attach that zip.
See Building on Windows and Building on Linux. Pull requests are welcome: CONTRIBUTING.md.
- Metroid Dread is © Nintendo. This is a fan project, not affiliated with, endorsed or sponsored by Nintendo.
- This repository contains no game files, no game code (also not the C the recompiler generates from it), no assets
and no keys, and release builds don't either.
dread/dread_v210_patches.jsonholds only this project's own edits;dread/romfs_v210.manifestholds file names, sizes and hashes used to check your dump. - The code you generate and the build made from it contain Nintendo's code: for your own use only. Don't share or upload them.
- Issues or pull requests with game files, keys, generated code or links to pirated copies are removed.
Built on SwitchRecomp by MZ Labs (Apache-2.0) with the ScarletNX Vulkan renderer (GPL-3.0), Dear ImGui (MIT), Intel XeGTAO (MIT), a Ryujinx reverb port (MIT), libvpx and OpenH264 (BSD), SDL2 and zlib. Brazilian Portuguese translation by JumpmanClub Brasil; button-icon packs by Krydar, Nova77 and xSeRosiSx. Full list: Credits.
The released program is under GPL-3.0 because it contains ScarletNX; each source file keeps its own license. NVIDIA's DLSS file is never in this repository or the release. See DLSS.md.


