github gminustwo/msr2ds v1.1.0-pre
msr2ds 1.1; flicker removed, android & mac versions added, randomizer + more

latest releases: v2.2.0, v2.1.0, v2.0.9...
20 days ago

Metroid: Samus Returns as a single-screen PC game, built on the Azahar 3DS emulator. This is msr2ds 1.1, with the new features below.

You need your own decrypted dump of Metroid: Samus Returns (USA, .3ds or .cci). Nothing from the game is included, and no texture pack.

Downloads

  • Windows (x64): msr2ds-1.1.0-pre-windows-x64.zip. Unzip it anywhere and run SamusReturns.exe.
  • Linux (x86_64): msr2ds-1.1.0-pre-x86_64.AppImage. Make it executable (chmod +x) and run it. It needs glibc 2.38 or newer (Ubuntu 24.04, Fedora 39, current SteamOS, Arch) and runs on X11 or XWayland.
  • Linux (ARM64): msr2ds-1.1.0-pre-aarch64.AppImage. The same for 64-bit ARM Linux, with the same requirements and a Vulkan driver.
  • macOS (Apple Silicon): msr2ds-1.1.0-pre-macos-arm64.zip. Unzip it and open SamusReturns.app (macOS 13.4 or newer). The app isn't notarized, so the first time macOS won't open it: choose Open Anyway in System Settings → Privacy & Security.
  • Android (arm64): msr2ds-1.1.0-pre-android-arm64.apk. Android 10 or newer with Vulkan. In the app's setup, choose a user folder and a games folder that holds your dump (in a folder of its own: Android doesn't let apps use Download itself).

Settings and saves from 1.0 carry over. On Windows they are in the user folder beside SamusReturns.exe: unzip the new version over the old one, or move user into the new folder. The AppImage keeps them in ~/.local/share/samus-returns-recomp (or a user folder beside it) as before. The macOS app keeps them in ~/Library/Application Support/samus-returns-recomp, or in a user folder beside the app if you make one.

New since 1.0

  • Texture flickering fixed (#3). Fog, dust and enemies no longer drop out for single frames while a new shader is being prepared, and far fewer shaders need preparing in play. The ones your game has used before are built when it starts.
  • Mac, Android, ARM Linux support added (#4)(#5).
  • Randomizer. A new Randomizer tab in the launcher sets up Randovania for you (about 200 MB, downloaded from its GitHub releases), then makes a seed from its Starter Preset, from presets you made in Randovania, or from a permalink someone shared. The seed becomes a game mod and is turned on; start a new file to play it. Open the seed in Randovania shows its spoiler log and the tracker. Seeds exported from Randovania itself (for Azahar, or to a folder) load too, and Randovania's game connection works on 127.0.0.1.
  • Game mods. Mods made for Citra or Azahar (romfs, romfs_ext, exefs, code.ips, exheader.bin) go in user/mods/game/, one folder each, and are turned on, off and ordered in the new Mods tab (launcher and in-game menu).
  • Language. (#6) The launcher's Game tab picks the game's language: English, Français, Español, Deutsch, Italiano or Nederlands.
  • Camera zoom in the Display tab, from 0.70 (see more of the level) to 1.50, with the HUD kept at its size.
  • Xbox button icons. With an Xbox-style pad, the game's on-screen button prompts show the Xbox letters (the buttons themselves stay where they were), texture packs included.
  • Launcher with a gamepad: options can be chosen with A or B, and every row can be reached, the language included.
  • Update check. When the launcher opens it looks for a newer msr2ds release on GitHub and, if there is one, shows it at the top with a button to its download page. Nothing is downloaded by itself. The Game tab's Updates row turns the check off or runs it now.

Notes

  • macOS, ARM64 Linux and Android were added to this release later, built from 12218aeba; the macOS zip was rebuilt from 84d91ea50 with the Background shaders option and a fix for gamepad navigation in the launcher. The Windows and x86_64 Linux downloads are unchanged.

Important

macOS has jitter. Macs have no native Vulkan, so Azahar's Vulkan renderer runs through MoltenVK, a translation layer to Apple's Metal. MoltenVK turns each shader into Metal source code, and Metal compiles it from scratch. Graphics drivers on Windows and Linux compile the same shaders in a few milliseconds, so there you don't notice.

It pauses the first time each new visual effect appears, while the Mac compiles a shader for it. Once an effect has been seen, it plays smoothly from then on, even after restarting.

Why the game waits: this port tells Azahar to finish each shader before drawing with it. Drawing without it was the "texture flicker" bug fixed in 1.1: fog, dust or enemies disappeared for a frame. So instead of a missing effect, you get a short pause.

Why it goes away: macOS keeps the compiled results for the app, in its cache for io.github.gminustwo.msr2ds. So the pauses only happen the first time each effect appears on a given Mac, and get rarer as you play. A macOS update can clear that cache, bringing the first-time pauses back once.

TL;DR: the Mac version has jitter. The Background shaders option, in the launcher's Display tab, removes it, but effects may flicker instead. That's the tradeoff.

  • Android is Azahar's Android app with this port's single 16:9 screen, 60 FPS and the galleries and Fusion Mode open. The launcher, the settings overlay, mods and the randomizer are PC-only for now. Menus show the bottom screen as a panel you can touch, and the on-screen buttons can be moved in the in-game menu.

  • On a Mac, the Randomizer tab's download fetches Randovania for Windows or Linux only: use Locate with your own Randovania.

  • Tested with the USA release (title 00040000001BB200).

  • This release runs the game on Azahar's JIT.

  • The Fusion suit option stays off while a randomizer is on: the randomizer has its own.

  • Not affiliated with Nintendo. Licensed GPLv2 or later, as Azahar is.

Don't miss a new msr2ds release

NewReleases is sending notifications on new releases.