This is a fix release with 23 fixes; details below.
What changed
- Games you've already exported get S-grade enhancements without rebuilding. A new "S-grade upgrade" entry at the top of the library on Mac and Windows sorts your games into: can be upgraded, no matching patches, opted out at export, and original program not found. For games on iPhone, plug in the phone and choose "Connect your iPhone, upgrade and install" — only the program is replaced, your games and saves stay; if you sign it yourself, choose "Export IPA for self-signing" instead. Games on Mac pick it up automatically the next time they start. Games with S-grade enhancements show a gold S in the top-left corner of their cover.
- New: S-grade enhancements (Beta). When exporting, S2Arm looks up community frame-rate, full-screen and graphics patches and cheats that match the game's program ID and version, and builds them in. The export page shows a gold "S-grade enhancements (Beta)" card with how many full-screen, frame-rate, graphics and cheat entries matched. Matched full-screen and frame-rate patches are on by default; cheats are built in but start off, so you turn on the ones you want in the game. Nothing to find or install yourself. Frame-rate patches and cheats need an exact version match; full-screen patches for another version are adapted to yours when possible.
- Frame-rate patches: games locked to 30 fps run at 60 when a patch exists; games with a 120 fps patch present at 120 Hz on Macs with a high-refresh display when you set "Frame rate level" to "120 fps" in launch settings; on iPhone in this release, turn off "Frame generation" in the in-game gear menu to reach 120 Hz. Both will happen automatically in the next release.
- Full-screen patches: the picture fills your screen at its own aspect ratio; when a game has patches for several aspect ratios, the one closest to your screen is picked automatically, without stretching.
- Cheats: toggle each one from the in-game quick menu and game settings on iPhone, or from the launch settings on Mac; active ones are marked "Applied".
- If a patch crashes the game, it turns itself off: the next launch turns off the patches and cheats that were on at the time and shows one notice saying which ones — no digging through settings. If the picture freezes while a frame-rate patch is on, that patch is turned off on the spot and you're told.
- Unified settings: frame-rate, full-screen and graphics patches and cheats now live in one "S-grade enhancements" group in settings, showing which patch is in charge.
- The Windows launcher has S-grade enhancements too: the gold card on the export page, "S-grade upgrade" and the gold S in the library, and viewing / importing cheats from each game's menu.
- Choose the game language yourself, per game: in launch settings on Mac, or under Settings → Language in the game on iPhone. Only languages the game supports are listed. By default it follows your device's system language; if the game doesn't support that language, the setting says which one the game will start in.
- The Windows game library can live on a NAS or network drive: mapped drives keep their drive letter, and \\\\server\\share paths work too. The environment check notes that a network drive will be slower.
- Redesigned controller panel on Mac: up to 8 players and 8 controllers at once, mixing Switch 2 controllers and Bluetooth controllers. Assign controllers to players; splitting or pairing happens automatically when the game asks for it, including first-generation Joy-Con. Each player's motion and rumble go to their own controller.
- What's new: the first time you open a new major version on Mac or Windows, a multi-page window walks you through S-grade enhancements; on iPhone, the first visit to the library shows a 3-page guide to where settings, cheats and problem reports are. Each shows only once.
- Redesigned in-game settings on iPhone: a single column with just Screen, Graphics, S-grade enhancements and Language. Things you adjust while playing — layout, rumble, saves, problem reports — are in the top-left gear menu.
- Frame generation on iPhone: games that run at 30 fps and have no frame-rate patch are shown at 60 fps by default, for smoother motion; the game's own pace is unchanged. Turn it off per game under "Frame generation" in the top-left gear menu. Games with a frame-rate patch use the patch instead.
- Fixed several problems that blocked play: black screens and wrong rendering (including a fully black screen when an .img comes without its shader library); graphics memory that kept growing during long sessions; audio dropping out after a stutter, and a frozen game blocking system audio; export failures (missing shader bytes failing the whole export, library paths containing square brackets, copying across disks after moving the library, and a tight space estimate stopping the export); games without a camera hanging at startup; a crash when exporting diagnostics on iPhone; and exports from an incomplete install now say to reinstall over it.
- Exporting S2Arm and installing games to iPhone: games you removed from the library are no longer included. If some games in the library use a different address space type and can't share one app, the export no longer fails outright — those games are left out this time and named; when installing to the phone hits this conflict, it names which games already on the phone are the conflict.
- Mac controllers: motion on some Switch-compatible Pro controllers no longer stays at zero after disconnecting and reconnecting (thanks @lirc572, PR #1092). Players not using a Switch 2 controller no longer see "controller connection lost" every time a game starts; it now appears once only when a Switch 2 Pro / Joy-Con 2 that was connected in this session disconnects (thanks @nevenhsu, PR #1127).
- S2Arm's own generic 60 fps is removed: games with a frame-rate patch use the patch. Newly exported games no longer use S2Arm's own generic full screen — games with a full-screen patch use it; games exported earlier keep their current behaviour for now.
- Graphics patches (higher resolution etc.) are only built into the Mac version, not the iPhone version: phones have less memory and higher resolution can get the game closed by the system. On Mac they are on by default.
- Mac launch settings now have "Audio latency": Standard, Low and Lowest (default Standard, same as before). For rhythm and fighting games, a lower setting makes sound come out sooner after a button press. Side effect: higher CPU use, which can cause crackling — switch back to Standard if you hear it. Applies the next time you start the game.
- Mac 0.3.5 to 0.3.9 can update to v0.4.0 in-app — no need to download the dmg (the in-app update that used to roll back is fixed in this version). On 0.3.4 or earlier, download the dmg from s2arm.com and install it over the old app.
- Faster shader translation (about 2.6 ms less per frame in the game we measured). Existing packages still play as before; to get the speed-up, re-package the game's resources with v0.4.0. (Speed-up thanks to @nevenhsu, PR #1081)
- A few games packaged with an older S2Arm version may freeze on the screen at a certain scene (stuck while preparing graphics effects). Updating the app alone won't fix a package that was already made — if this happens, please re-package the game with v0.4.0.
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