S2Arm README

项目的 README,来自 github.com/jhaizhou-ops/S2Arm。合并为一个 markdown 文件:README.md。

S2Arm
s2arm.com

[!NOTE] Good news: s2arm.com is now the official S2Arm website. S2Arm is free and open source and never accepts donations; get S2Arm only from s2arm.com or this GitHub repository.

Your own Switch games, running natively on iPhone, iPad and Mac. Game code is rewritten to native ARM64 and runs directly on the device's processor, with graphics going straight to Metal. Your whole library lives in one app, and a few clicks in the Mac or Windows launcher take a game from import to play.

Platforms: iPhone / iPad (iOS / iPadOS 18 and later) · Mac (Apple silicon, macOS 15 and later) · Build on Mac or Windows · Android / HarmonyOS coming soon · License: Apache-2.0 · Bring your own games

简体中文 · Download the launcher · All releases · Evidence

S2Arm launcher welcome page

A native port, not an emulator

The game's own ARM64 code is rewritten at build time and then runs directly on the processor in your iPhone, iPad or Mac. There is no CPU emulator in between. Graphics calls are translated straight to Metal, and system services come from a native host. That is where the speed, the low heat and the battery life come from. Evidence

One app, your whole library

Every game you import goes into the same S2Arm app; open it and pick what to play. The whole library takes a single App slot on your developer account, so adding a game never means installing another app or spending another signing slot. Evidence

Graphical launchers, next to zero setup

There is a graphical launcher for Mac and one for Windows. On first launch the welcome page boils everything down to three steps: get this computer ready, add your keys, add your games, with a single primary button at any moment. Everything else is either bundled or fetched in one click, and you never touch a command line.

After you click Build, every stage shows its progress, elapsed and remaining time, and disk use. Several games can queue up and build one after another. Evidence

One-click build Build progress

Build finished Game library

Let an AI drive

Both the Mac and Windows launchers expose a control interface, s2armctl. An AI assistant can import games, build, install, follow progress and read errors, and every step shows up in the launcher window. A companion self-check, self-fix and feedback toolkit lets the AI find a problem, apply the documented fix, and, when it cannot, package a diagnostic bundle for you to file. Watch an AI diagnose and fix a real problem end to end: Evidence

Have an AI do it for you

Send this to your AI assistant (it needs to be able to run commands on your computer):

Please read https://github.com/jhaizhou-ops/S2Arm/blob/main/launchers/macos/skill/s2arm-operator/SKILL.md and then help me install my Switch game on my iPhone.

It moves forward with a few commands, and you can watch every step in the launcher window:

/Applications/S2Arm.app/Contents/Resources/s2armctl start        # open and connect to the launcher
/Applications/S2Arm.app/Contents/Resources/s2armctl next         # what to do now, who does it, and why
/Applications/S2Arm.app/Contents/Resources/s2armctl diag export ~/Desktop/S2Arm-diagnostics.zip   # export a diagnostic bundle if it cannot fix a problem

Anything only you can do (system permission prompts, signing in with your Apple ID, tapping Trust on your phone), the AI stops and asks you to do. On Windows, use s2armctl.cmd in the launcher folder with the same commands. Windows builds iPhone / iPad packages only, so for problems inside a game export the diagnostic bundle on the phone: long-press the game screen with four fingers for 1.5 seconds and choose Export diagnostics.

Something wrong inside a game (graphics, frame rate, stutter, crashes)? Send your AI:

Please read https://github.com/jhaizhou-ops/S2Arm/blob/main/skills/player-game-triage/SKILL.md . My S2Arm game has this problem: . Check the settings first, then collect diagnostics; if you can change code, fix it at the root and open a PR, otherwise help me file an issue.

Tested at scale

211 games surveyed with a 95% first-try build success rate. 4,700+ test runs on real iOS devices and 1,000+ on macOS. Evidence

Fast, smooth, and easy on the battery

On a 16 GB MacBook Air (M3), from importing a game to a finished iPhone build, completely cold:

Game Game files Shaders Build time
A 23.5 GB action RPG 23.5 GB 1,222 6.4 min
A 12.0 GB life-sim game 12.0 GB 9,315 8.6 min
A 17.5 GB open-world game 17.5 GB 26,999 34 min

A Switch 2 game, measured on an iPhone 17 Pro Max: a full 60 fps while the phone is cool, 37–43 fps once sustained load has heated it up, at about 0.15 J per frame. Evidence

Platforms

Platform Support
iPhone / iPad iOS / iPadOS 18 and later; every game is chosen inside one app
Mac Apple silicon, macOS 15 and later; builds locally and plays games right on the Mac
Windows Graphical launcher that builds and installs games for iPhone / iPad
Android / HarmonyOS Coming soon

Evidence

Downstream deep ports

Some games have a deep port made specially by the community. S2Arm recognizes these games: on export it shows a page explaining the option, and you can switch to the downstream project's route (importing, packing and installing are still buttons in S2Arm, with the downstream project's implementation underneath) or keep the standard route. The registry is pack/downstream/schemes.json; the contract between the two is the downstream project's document.

Route Project Devices Contract
D2R-Mobile jhaizhou-ops/d2r-mobile iPhone / iPad (iOS 26 and later; Android and HarmonyOS in progress) docs/S2ARM.md

Getting started

  1. Download the Mac or Windows launcher from the download page and open it. Building for iPhone on a Mac needs the free Xcode from the App Store, signed in with your Apple ID; the launcher walks you through it.
  2. Import your own keys and games. Put the base game, updates and DLC in one folder and import them together.
  3. Choose iPhone / iPad or this Mac, then click Build.
  4. Follow the launcher to sign and install with your own Apple ID (the Windows launcher ships with the Impactor signing tool), open S2Arm, and pick a game from the library.

Back up your saves before updating the app. The release uses the new app identifier io.s2arm.*, which the system treats as a new app: saves from the beta builds do not carry over automatically.

Honest boundaries

S2Arm runs 64-bit (AArch64) games. Apple silicon cannot execute 32-bit ARM code, so 32-bit games are outside what S2Arm supports, as are games that need a 36-bit address space.

Development

Contributing · AI collaboration policy · Diagnosis and root-fix skills for AI · Report a problem · Third-party licenses

Thanks

S2Arm stands on the shoulders of its community.

Versions, full license texts and what each component does are in NOTICE and the third-party license list.

Star History

Star History

S2Arm is open source under the Apache License 2.0. The project ships no games and no keys; obtain your own game files legally. S2Arm is not affiliated with or endorsed by Nintendo, and game titles and trademarks belong to their respective owners.

S2Arm (jhaizhou-ops/S2Arm)

正在搜索数据库…

3.5K ·GitHub
这是什么?S2Arm 让你可以在 iPhone、iPad 和 Mac 上原生运行自己的 Switch 游戏。游戏代码在构建时被转换为 ARM64,图形直接交给 Metal 处理,中间没有 CPU 模拟器。
它是模拟器吗?不是。README 说明这是原生移植,而不是模拟器:游戏的 ARM64 代码直接在设备处理器上运行,系统服务由原生宿主程序提供。
我该怎么让它运行起来?下载 Mac 或 Windows 启动器,导入你自己的密钥和游戏(本体、更新和 DLC 放在同一个文件夹中),选择 iPhone/iPad 或当前这台 Mac,然后点击 Build,并按照启动器的提示,使用你自己的 Apple ID 进行签名和安装。
开始之前我需要准备什么?在 Mac 上为 iPhone 构建需要从 App Store 下载免费的 Xcode,并登录你的 Apple ID。需要 iOS 或 iPadOS 18 及以上,或 macOS 15 及以上(Apple 芯片)。游戏和密钥需要你自己准备。
所有 Switch 游戏都能运行吗?不能。仅支持 64 位(AArch64)游戏;32 位游戏以及需要 36 位地址空间的游戏不在 S2Arm 的支持范围内。
支持哪些设备和系统?iPhone 和 iPad 需要 iOS/iPadOS 18 或更高版本,搭载 Apple 芯片的 Mac 需要 macOS 15 或更高版本。Windows 仅可作为启动器使用,用于为 iPhone/iPad 构建和安装。Android 和 HarmonyOS 即将支持。
它会附带游戏或密钥吗?不会。项目不附带任何游戏和密钥,因此你必须通过合法途径获取自己的游戏文件。
我需要懂命令行吗?不需要。启动器都是图形界面,README 说明你完全不需要接触命令行。AI 助手也可以通过 s2armctl 控制接口来完成整个流程。
构建需要多长时间?README 给出了在 16 GB 内存的 MacBook Air(M3)上冷启动的示例:23.5 GB 的动作角色扮演游戏需要 6.4 分钟,12.0 GB 的生活模拟游戏需要 8.6 分钟,17.5 GB 的开放世界游戏需要 34 分钟。
我的整个游戏库怎么管理?所有游戏都放进同一个 S2Arm App 中,因此整个游戏库只占用开发者账户中的一个 App 名额,你可以在 App 内选择要玩的游戏。
运行 Switch 2 游戏够快吗?README 显示,在 iPhone 17 Pro Max 温度正常时可以达到稳定的 60 fps;手机发热后,在持续负载下为 37–43 fps。
大小
95.8 MB
星标
3.5K
时长
10天
提交 · 90 天