This is a fix release with 58 fixes; details below.
What changed
- iPhone: S2Arm installed through LiveContainer can now start games. When S2Arm runs inside LiveContainer, it re-signs the game's program with the certificate imported into LiveContainer. It used to stop with "program library signature not accepted on this device". If LiveContainer has no certificate yet, the message now tells you to import one in LiveContainer's settings instead of telling you to switch to S2Arm on the computer.
- Mac: new With Switch option in Multiplayer mode (community contribution, #1741). Pick With Switch to play over the local network with a Switch running ldn_mitm. Automatic stays the default; while With Switch is selected, the usual multiplayer with an iPhone or another Mac does not work. Quit the game completely and reopen it for the change to apply.
- Mac: split and rejoin first-generation Joy-Con during a game (#918). In a game, press SL + SR to split a pair into two sideways controllers for two players, and press L / R on each to join them back into one pair for one player; the game follows. These gestures used to work only while the Assign players panel was open, so you could not switch back once in a game.
- Mac: controller player lights, Joy-Con colors and button layout (community contribution, #1759). Player lights on the controller now follow P1–P8; first-generation Joy-Con show their own colors; first-generation Joy-Con and Joy-Con 2 reconnect more reliably after splitting or joining; the face-button layout can be set per controller and takes effect in the launcher right away.
- Mac: the game's cover in the Dock and Cmd+Tab (community contribution, #1779, #994). Once a game starts, the Dock and Cmd+Tab show its cover instead of the system's blank icon.
- Mac / Windows: the free-signing expiry reminder can be dismissed. The reminder in the Library now only follows the copy of S2Arm on the phone that the launcher signed with a free Apple ID; after you install it with another tool or another signing method, it no longer stays up. It has an × to dismiss it, and a Free signing expiry reminder switch in Settings turns it back on.
- Standalone app: one app per game. When packing you can choose Standalone app: the game installs as its own app with its name and icon and opens straight into the game. The universal shell still works. Two cards side by side show both options, mark the one recommended for your signing method and explain why; picking the other shows an orange line saying what will happen, without blocking. Distribution certificates default to Standalone app, everything else to the universal shell, and your choice per game wins. The success page shows the phone, the name on the phone and the expiry date; an exported standalone app goes into the game's folder with a read-me in your language. The phone console lists standalone apps with their remaining signing days.
- iPhone: long-press a game and choose Export this game… (#1793). The iPhone creates the .s2arm and .img files for that game and hands them to the Files app, to share or keep as a backup. Games installed by pushing from the computer can be exported too.
- iPhone / Mac: a notice when the device's address space is too small for a game. If S2Arm detects at launch that a game will not fit the device's address space (it may run very slowly or stop at the start), the iPhone shows a page explaining this and Start anyway launches the game as usual; on the Mac a notice appears above the game window without blocking the game.
- Faster packing. The late stages of building the shader library now compile similar shaders together (one large game used to spend several minutes compiling them one by one), and add more parallel work whenever memory frees up instead of fixing it at the start of packing. When packing a game again, the base pipeline step checks the cache first (it used to take over four minutes for one large game even then). (#1723, #1770)
- Mac / Windows: the packing page shows whether it is really stuck. Every late step of building the shader library now has a counter, so it no longer sits at 100% with no sign of progress, and the current step shows "last moved N seconds ago". It is only really stuck if the counter stays put while that number keeps growing. (#1723, #1770, #1773)
- Mac / Windows: no more half a minute without progress before extraction. Before the extract step starts, packing checks the game's files; with a cold cache this showed no progress for 24–35 seconds, and it now counts file by file. Because this step now records its work differently, each game re-runs extraction once the first time you pack it after updating; after that it behaves as before.
- Mac / Windows: a game is no longer pushed to the iPhone twice. While a game is being pushed or waiting in the queue, its Push to iPhone button says Pushing… / Queued and is greyed out, so an extra tap no longer queues a second push.
- Fewer hitches entering new scenes. Every pipeline that can be prebuilt during packing is now included, no longer capped at 10% of the original game's size (in one game only 44 of the 181 pipelines used in the prologue used to be included). The cost is a larger package and a longer step: that game's bundled data went from 464 MB to 1,422 MB.
- Pipelines from the community and public lists work again, and scenes you played on iPhone get prebuilt. Since 0.6.0, shader pipelines collected by the community and from public project lists never matched at packing time and were all dropped; they are now converted first (one game went from 0 to nearly 2,000). When you pack a game again, pipelines the game actually used on your iPhone are prebuilt first.
- Packing failures now show the reason. Many failed packs used to say only "packing did not finish", with the reason buried in the log; the original message from the failing step now goes into the red line and the error summary. (#1725, #1730, #1744)
- iPhone: Automatic orientation follows the system. With orientation set to Automatic, the game lays out in whatever direction the system turns to, split screen included; where the system does not offer upside-down portrait, S2Arm turns the whole screen itself, touch and settings sheets included. On foldable dual-screen iPhones, opening and closing repeatedly no longer shifts the picture a bit more each time. Landscape and Portrait still lock the orientation.
- iPhone: far less writing to storage. Some games kept writing to the iPhone's storage on models with less memory (one Switch 1 game wrote 2–3.5 GB every 10 seconds on an 8 GB model). Memory is now used first, and only what exceeds this phone's headroom goes to a file.
- Mac / Windows: the certificate check lists each missing entitlement (#1760). When you import a developer certificate, the three entitlements S2Arm needs are checked one by one, and each missing one is listed with what it breaks. Distribution, Ad Hoc and enterprise certificates lack the debugging entitlement, so S2Arm signed with them cannot open any game; such imports are now refused, your existing certificate is kept, and you get text to copy to whoever issued the certificate, or a one-click switch to Apple ID sign-in. If S2Arm signed this way is refused when starting a game on iPhone, the message also names the missing debugging entitlement.
- Renewal instructions point to the right place. When a free Apple ID's 7 days run out, or the Increased Memory Limit entitlement is lost, the instructions now point to Renew S2Arm in the S2Arm tile at the start of the Library instead of telling you to push the game again.
- Mac: Settings and packing page design (community contribution, #1537). The Settings window is centred and split into four tabs; the packing and job pages use a blurred poster of the current game as background; the favourite button is now coral; button hover effects are softer.
- Fixed some games freezing about 80 seconds in while offline (#1823). Without a network connection, some games keep submitting a network request and wait for its result; S2Arm answered differently from a real console, the game thread spun there and the picture froze after about 80 seconds (reported with Hades). The offline answers now follow the real console's order.
- Windows: writing the game image no longer fails because another program holds the file. If antivirus or indexing software had game.img open while packing, writing it used to stop midway with "Permission denied"; it now finishes the write and only saves a little less temporary space, and a real failure names the step in the log. Failures caused by a full disk are now reported as out of space.
- A more accurate message when the graphics API cannot be determined. It no longer says this is "common with homebrew or ported programs", and the log now includes the readings used to diagnose it, which helps bug reports.
- Fixed some Apple IDs failing to sign in with the correct password (#1794). For some accounts Apple asks for a different password check that the bundled signing tool did not support, so sign-in failed with -22406 even with the right password and the app could not be installed. The signing tool bundled on Mac and Windows now supports it.
- Mac: no more prompt to access an external drive at launch. With an external drive connected, S2Arm asked to access files on a removable volume as soon as it opened, because it searched external drives for Xcode every time. It now looks for Xcode only when actually needed and no longer searches external drives on its own; if Xcode is on an external drive, choose it in Settings.
- Mac / Windows: new versions show up even when the website lags behind. If the website's update information is still on an older version, the update check also reads the same signed manifest from the GitHub release and uses the newer one.
- Several quick-save crashes. The save thread did not release its resources on exit, so long sessions could use up a memory region and end the game; on some devices, when the address window could not fit the standard layout, the snapshot area crowded the game. Both are fixed; if it truly cannot fit, snapshots are turned off for that session and the game runs as usual.
- Double-speed picture after dropping to the 30 fps tier (#1766). When the frame rate ladder steps back to 30 fps, output is now capped at 30 fps instead of running at double speed.
- S-grade batch upgrade progress went backwards. It now only moves forward.
- Windows: Details on the install card closed by itself. Progress updates no longer collapse it.
- Mac: third-party Pro controllers that report a Joy-Con product ID were misidentified. They are now treated as Pro controllers.
- Distribution certificates imported earlier were not recognized. They are now checked against the stored provisioning profile, so older imports are recognized.
- The game quit when audio output could not start or dropped out. It now continues without sound.
- Windows: Update selected now explains games that did not make it and retries only those (as promised in the 0.6.1 notes). When some games in Update selected in the phone console fail to push, the console now says how many did not make it, listing each game with its reason; Retry pushes only those games again, not the ones that already succeeded. If the reason is that the phone has more than one S2Arm installed, it lists them right there; pick one and it is remembered and the push runs again.
- Windows: packing failing right at the start on some PCs (#1762). The extract and shader library steps no longer go through the bundled Git Bash, so packing works on PCs where Git Bash cannot start child processes. If another step fails because Mandatory ASLR is turned on in Windows, the launcher now names that cause and where to turn it off.
- Windows: packing failing with "access denied" (WinError 5) because a directory link could not be created. Packing and moving the library no longer need directory links, so packing works on drives that do not allow them.
- Windows: packing failing with error 1005 for games on some mounted drives (community contribution, #1789). Fixed.
- Windows: S-grade optimization failing when the system encoding is not UTF-8 (community contribution, #1764). On Chinese Windows, for example, S-grade optimization failed at the rewrite step and the patches were not applied. Fixed.
- Windows: Update selected in the phone console showing "5307 / 5367 games". The count now goes by games instead of counting files inside each push.
- With the library on another drive, Update no longer writes temporary files to the system drive. Temporary files from rebuilding the shader library now stay on the game's own drive.
- An extra "path is not inside a managed folder" error when the library is reached through a link or lives on another drive. This false error no longer shows in the error summary, so it does not mislead troubleshooting. (#1725, #1730, #1744)
- Mac: packing failing to build the game program when S2Arm's folders have spaces in their path (community contribution, #1742). Fixed.
- Packing multi-program collections stopping at "write single IMG" (#1782). Every multi-program collection used to fail with "programs/1/romfs.img in the resource pack list is missing"; they now pack.
- Packing stopping at the rewrite step when a patch contains invisible characters (#1775). Invisible characters carried in when copying a cheat or patch from a web page no longer fail the whole pack; an entry that still cannot be read is skipped on its own and the rest are kept.
- Update this game not clearing the Update suggested hint (#1756). If the game had to translate shaders on the phone that were missing from a package built by an older version, Update this game now rebuilds the shader library and the hint goes away.
- Mac / Windows: pushing getting stuck when one iPhone has more than one S2Arm. When a push asks which S2Arm to use, the failure page now lists the choices right there and pushes again automatically once you pick one.
- Mac / Windows: an endless loop asking for the Apple ID verification code. After the code is accepted it no longer keeps asking; if it still asks a second time, it stops and explains why.
- Mac / Windows: a raw English error when the Apple ID password is wrong. You now get a proper explanation and what to do.
- The phone console showing a 7-day expiry for apps signed with a paid Apple ID (#1772). The expiry now comes from the real date in the signed package, which also decides whether it counts as free or paid.
- Installing to Apple TV failing every time (#1758). Installing has failed with an error since 0.6.0; fixed.
- The phone console saying a game needs the original files even though its resource pack is there (community contribution, #1765). Resource packs stored as a folder on the phone are now recognised.
- Mac: a failure badge in the top bar after cancelling Export self-signed package (community contribution, #1537). Cancelling it yourself no longer counts as a failure.
- Mac: a wired Xbox controller stopping responding mid-game (community contribution, #1746). It now recovers on its own when it stalls.
- Little Nightmares II crashing repeatedly (#1678). Fixed.
- 《白日梦的构想图》 crashing or showing a black screen after opening (#1440). None of the game's textures used to upload; they now do. Fixed.
- Lit surfaces turning solid black or flickering in some games (community contribution, #1119). Where a game binds a flat texture in a slot that expects a 3D texture, it used to read all zeros; it now reads that texture itself.
- Same as 0.6.1: Mac with Apple silicon on macOS 15 or later; 64-bit Windows 10 or 11; iPhone / iPad on iOS / iPadOS 18 or later.
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