This is a fix release with 55 fixes; details below.

What changed

  • Redesigned Mac launcher: the home page is split into All games / Ready / Recently played / Favorites, search works by name, pinyin or title ID, and the whole launcher can be used with a controller, even a single Joy-Con. (Thanks @realskyrin, PR #1106 and #1284; @nevenhsu, PR #1159)
  • Mod import: Mac, Windows and iPhone can import asset-replacement mods and turn each one on or off, and the export page on your computer also takes mods with code patches (pchtxt / IPS) and builds them into the game.
  • Play time: the Mac and iPhone libraries show how long you've played each game and when you last played it, recorded only on your device and never uploaded (not on Windows in this release).
  • No more .NET: the Mac version works right after installing, the Windows version no longer bundles the .NET runtime, and both downloads are smaller.
  • Updates happen when you choose: the launcher only tells you when a new version is available and downloads and restarts when you click; it also only tells you when S2Arm on your iPhone has a new version, and updates it when you connect the phone and click.
  • iPhone home-screen widget (4×2): your last game on the left and your three most-played on the right; tap a cover to start, or turn it off in the launcher settings on your computer.
  • "After building" on the export page: with iPhone checked, choose "Install on iPhone" or "Export a self-sign IPA" (no phone needed), and a failed install can switch to exporting in one click. (#502)
  • You can install another game on your iPhone while a build is running; only tasks that really conflict wait for each other.
  • If the "Increased Memory Limit" permission is missing, S2Arm on your iPhone tells you at the top as soon as it opens, and "Learn more" shows how to keep it with each self-signing method.
  • iPhone: choose the interface language in the library settings and the game language in each game's settings (only the languages that game supports).
  • Rumble uses the left and right motors separately (Xbox, DualSense and others); on Mac, Xbox-style controllers such as 8BitDo or GameSir also provide motion in Switch mode.
  • iPhone: if a game uses motion and there's no motion source, you're told once; a motion-capable controller is preferred, and the phone's gyroscope fills in only when the controller can't.
  • Mac: controllers that GameController doesn't recognize (such as the Google Stadia controller) now work, with buttons mapped by position and adjustable in the button settings.
  • Switch 2 Pro Controller (iPhone / iPad): if it won't connect, hold SYNC on top for a second or two and it connects.
  • iPhone Duo inner screen and iPad: the picture follows the device orientation, including upside down.
  • The Mac export page shows which port a game uses and lets you change back with "Change" after picking a third-party port; the D2R-Mobile port for Diablo II is updated to v2.3.3 and can be built on Windows too.
  • iPhone "Auto" frame rate now goes up to 60 FPS; 120 FPS must be chosen by hand, and the settings page explains that a device that can't keep up will make the game run slower.
  • Mac home: the main button has an icon and a label, the other actions share one style, and cards show how many days the iPhone signature has left or that it has expired.
  • Faster builds for small games: about twice as fast on Windows and about a quarter faster on Mac.
  • Downloads are about a third smaller: about 128 MB on Mac (189 MB in 0.4.5) and about 119 MB for the Windows installer (178 MB in 0.4.5).
  • The program part of each game is now stored compressed: newly built games are stored this way right away, and games built with 0.4.x switch after their first "Update iPhone".
  • Game data is compressed before it's pushed to the iPhone, unless that saves less than 15%.
  • The computer side no longer sets its own permissions on its data folders and uses the system defaults, which also fixes "Access denied" on Windows when adding games and similar actions.
  • Recovering supplement files from the phone: the Mac launcher still recovers the program modules a game fills in on its first run on the phone; the Windows launcher can't recover them in this release, so for such games you'll need to prepare the game once with the Mac launcher.
  • If a game was deleted on this computer but is still on the phone, the install tells you which one.
  • Exporting a self-sign package only writes the data of the game you clicked, and the result card names any other games that weren't written.
  • iPhone can now use "lighter load" graphics patches (quality-raising ones stay Mac-only); they're off by default and can be turned on in the S-grade page.
  • iPhone: files locked by the system are no longer moved automatically; you're told about it with three steps to free space.
  • When a stuck game is stopped safely, the Mac launcher and the iPhone now say "The game got stuck and was stopped safely" and tell you how to keep playing and how to send us diagnostics with "Report a Problem", instead of showing "Done". (#1257, #1378)
  • Windows: when Impactor sign-in fails, you're told whether you're not signed in, the session expired, or Apple's servers can't be reached, with what to do for each.
  • Windows: when installed on a drive other than the system drive (such as D:), the new version now opens by itself after an update.
  • Windows: long tasks no longer fail midway with "Access denied". (Thanks @wwmogu, PR #1277)
  • Windows: when antivirus or indexing software has a file open, moving folders waits and retries instead of failing the whole task.
  • When the game's folder on the phone can't be written, the install now tells you to export your saves, delete and reinstall, then import them back, instead of asking you to continue again and again.
  • Some games still drew at about 30 FPS with 60 FPS on. (Thanks @albionlee, PR #1255)
  • Frame-rate patches understand one more FPSLocker format and some wrongly built constants are fixed; if a patch can't be applied, the settings page says why.
  • Mac (M1 / M2): some Switch 2 games could hang the GPU when lowering their resolution; we fixed what player diagnostics pointed to, but we have no M1 / M2 Mac to confirm it, so please upload diagnostics if it still happens.
  • Mac: some games crashed while swapping frames.
  • Some Switch 2 games on Mac grew to about 39 GB of memory and were stopped; they now use about 15.5 GB, and a GPU page fault on systems before macOS 26 is fixed too.
  • Much lower graphics memory use in large Switch 2 games (one racing game on Mac dropped from about 16 GB to about 10.7 GB).
  • A Switch 2 racing game crashed at launch when it set an automatic target frame rate.
  • Mac / iPad: sessions were aborted when a large memory pool couldn't be created.
  • iPhone: running out of memory while playing Switch 2 games.
  • iPhone: crash when starting a game with a controller connected.
  • iPhone: occasional in-game crashes on some devices.
  • iPhone (iOS 18.0–18.3): a possible crash when building graphics pipelines for the first time, and the pipeline cache not being saved so every launch recompiled.
  • Some games recompiled graphics pipelines on every launch and stuttered at the start.
  • Occasional missing textures or graphics glitches after returning from the background.
  • A flashing white haze over 3D scenes in some games when the render scale isn't 1x.
  • iPad: motion aiming moved diagonally when turning left and right (since 0.4.2). (#1360)
  • Some OpenGL games crashed at start.
  • iPhone: if a game file put into "Import Here" is damaged, you're asked to delete the game and put it in again.
  • With a French, Japanese, Spanish or Traditional Chinese interface, the self-sign export folder was named in Chinese; it now uses English unless the interface is Chinese. (#502)
  • "._" files created by macOS on exFAT / FAT drives were treated as mods and pushed again on every install. (Thanks @wwmogu, PR #1278)
  • Controllers changed a lot in this release (navigation in the new interface, separate left/right rumble, motion on third-party controllers); if something doesn't work, please open an issue or upload diagnostics.

Before updating

Back up saves and review migration notes for your installed version. Release notes describe upstream changes, not independent compatibility testing by this site.

Read the full upstream release