Skip to content
LNPANDYPublic

About

Play your own Switch games on iPhone/iPad — one-click macOS app, no terminal. | 把 Switch 游戏装进 iPhone:图形界面一键构建,不用命令行。Bring your own game.

Topics

Resources

Contributing

Stars

8.0k stars

Watchers

19 watching

Forks

Latest commit

 

History

2,288 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

NX2Apple, by nxnative

Your Switch games, running on your iPhone.

Not an emulator. No terminal. A macOS or Windows app does the whole build in a few clicks.

Stars Forks Issues License Games

中文 English Svenska Deutsch Français Italiano

NX2Apple — Switch games on iPhone and Mac

🆕 Latest highlights

  • Multi-engine workbench and Dark Glass UI: Switch in one click at the top of the Builds page or in Settings between nxnative, nxkit (Beta) (with Ed25519-verified self-updates and console overlay support via NXKIT_OVERLAY), and MacNativeGames (guarded for 5 maintained first-party Mac titles), all wrapped in the unified Dark Glass UI and redesigned two-column controller console mode.
  • Hot-loaded iOS game frameworks, .p12 on-device signing, and slim shared IPA: All your games share a compact shell app of a few tens of megabytes (DMMSLTR1 shader trailers move into external .img archives with foreground .nxpart auto-joining). Add or update games by hot-pushing or exporting DmGame.framework into Documents/Frameworks without reinstalling the shell IPA (sideload users can import a .p12 certificate in the iOS app for automatic on-device signing), in 10 UI languages.
  • Persistent build seeds and fast batch refresh: Builds made with 1.5 persist build-seeds, so most subsequent engine upgrades finish in minutes via batch refresh without keeping the original game package or _build folders, paired with per-game update version badges (such as 1.5) and three-way missing .img recovery. The Windows launcher (NX2Apple-windows-x64.zip) also adds a general multi-game BuildQueue, an emulated heap growing up to 2 GiB on demand, and in-app self-update (NX2Apple.exe).
  • Shortcuts with PiP guide, audio mixing, and controllers: iPhone and iPad add a built-in 6-step Add to Home Screen wizard with an optional Picture-in-Picture walkthrough card and controller-connect auto-launch, background audio mixing (DM_AUDIO_MIX), an interactive 16:9 cover cropper, a visual touch layout editor, split Bluetooth Joy-Con sideways mapping on Mac, and Steam Controller (2026) support.
  • 208 game profiles, including 19 Switch 2 games: Pick a Switch 2 game folder or .nup file in the Mac or Windows launcher with no prod.keys needed, backed by Nintendo eShop banner fallback across Mac, iOS, and Windows.

Every release is in the changelog.


What NX2Apple is

NX2Apple runs Nintendo Switch games on your Mac and iPhone from your own game dumps. It is not an emulator: the game's own code runs natively on Apple silicon, and Metal draws it. A Mac app, the launcher, does the build in a few clicks (unpack, rewrite, translate the shaders, pack) and then keeps your games in a library you start with Play, the way a Switch does.

The launcher: a library of built games, one build in progress

It is a community fork of nxnative, which does the actual work (the code rewriter, the Horizon host, NVN on Metal and every game's profile). This fork adds the launcher and a short list of patches, and follows nxnative every day.

Requirements

  • An Apple silicon Mac. The launcher opens on macOS 13 or later. Building needs Xcode with the iOS SDK, and NVN games need Xcode 27.2 (macOS 26.6 or later) unless built with --allow-other-metal. Take 27.2 from Apple's download page, not the App Store's newer Xcode. With both installed, give 27.2 a distinct name such as Xcode-27.2.app. In Settings → Tools → Choose Xcode…, select the copy to use with NX2Apple, including one on an external drive. During first-run setup, click Set up later to reach Settings, then Run setup again after choosing Xcode. Use system Xcode follows the Mac's command-line selection (for example, sudo xcode-select -s /Applications/Xcode-27.2.app).
  • Your own game dumps (NSP or XCI) and your own prod.keys from your own console. Nothing is bundled, downloaded or looked up for you. The same prod.keys opens every one of your Switch games. A current dump covers all retail titles. Switch 2 games (a game folder or .nup file) do not need prod.keys.
  • For an iPhone or iPad: iOS or iPadOS 26 or later and a recent device. Older devices are untested.

The app carries its own build tools and Python, so no Homebrew and no Python install are needed. The default nxnative engine still lets the app install the .NET SDK 10 for you in one click, while the native nxkit engine needs neither Python nor .NET. The launcher's dependency page checks each requirement and installs what it can with one click.

Install

  1. Download the app: NX2Apple-macOS-arm64.zip from the latest release. Unzip it.
  2. Open it once with right-click, then Open. The app is not signed with a paid Apple developer certificate, so macOS asks before the first start. After that it opens normally.
  3. Follow the setup. The launcher fetches the project it builds with (a Download repository button on the setup page, a shallow clone into ~/NX2Apple. If GitHub is slow, the page shows the manual ZIP route), checks the tools above and updates itself later. You never need git.
  4. Build a game. Pick the game's folder (or its base game, update, DLC and prod.keys one by one), choose This Mac or iPhone / iPad, and press build. The page shows the real stages and the time left, and a stopped build continues where it left off. The iPhone / iPad target is one app on the device for all your games. The launcher signs it with Xcode, installs it and copies the game in. It needs a device paired with the Mac.

Building by hand from a terminal is in BUILDING.md.

Updating a game you already built. Games built with 1.5 persist local build seeds, so when syncing engine improvements you can use Refresh or Batch refresh to update in minutes without keeping the original NSP/XCI or _build folders. When installing a newer update NSP for the game itself, select the game in the library and choose Rebuild, keeping the base game selected and picking the new NSP in Updates & add-on content in the same output folder. The update can change both game code and data, so the launcher builds the new version and reuses cached work where it can. Your saves stay in their existing folder outside the .app, keyed by the game's title ID. Rebuilding or refreshing in the same library keeps that progress.

The iPhone and iPad app

The iPhone / iPad target builds one shell app that holds all your games, the way the Mac launcher does. Its library shows each game with its key art. In portrait it is one column with the chosen game at the top. On its side it is a Cover Flow. An iPad shows a grid.

The iPhone app in portrait: the library with a hero and two game covers, one game's settings, and a game that needs its game data

The iPhone app on its side: Cover Flow with the covers of Breath of the Wild, Hades and Tears of the Kingdom

  • Add games from the Mac. Build a game with the iPhone / iPad target and the launcher copies it into the app. You can also export a standalone DmGame.framework and place it in Files > On My iPhone > NX2Apple > Frameworks without reinstalling the shared shell app (sideload users can import their .p12 certificate in the iOS app's Settings so unsigned frameworks are signed automatically on device). Re-signing and reinstalling the app keeps your game data and saves.
  • Play. Pick a game and tap Play. A game that is missing its data, or needs a newer app, says so on its card and offers the fix.
  • Settings for each game. The settings button (or X on a controller) opens that game's launch options. Reset puts every choice back to its default.
  • Home Screen shortcuts. Use the built-in 6-step Add to Home Screen wizard (with an optional Picture-in-Picture walkthrough card) to create nx2apple://launch home screen icons or launch automatically when a controller connects.
  • Play with other audio. Enable Play with other audio (DM_AUDIO_MIX) so music or podcasts keep playing smoothly alongside your games.
  • Change Cover. Use Change Cover… to pick custom artwork and adjust it with the interactive 16:9 pinch-and-pan cropper.
  • Controller or keyboard. The whole app works from a controller: the D-pad and stick move, A picks, B goes back, X opens the settings and Y lists the controllers. A hardware keyboard works the same way.
  • Game data folder. Each game can read its data from a folder you pick in the Files app, for example on an external drive, or from the app's own folder.
  • Cloud saves. Pick an iCloud Drive folder for a game's saves to keep them in step with the Mac.
  • Language. The app follows the system language across all 10 languages (English, Simplified Chinese, Swedish, German, French, Italian, Spanish, Japanese, Korean, and Brazilian Portuguese).

The app needs iOS or iPadOS 26 or later. The covers are the eShop banners the Mac launcher caches for your own games.

How to play

On the Mac, a finished game appears in the library with its key art. Play starts it. Launch options (per game, kept across rebuilds) set the frame rate, console mode (docked or handheld), render scale and upscaling, game language, controls and more. What each does is in docs/settings.md. A controller drives the launcher as well as the games.

On the iPhone, the app shows the same settings before the game starts, tap Play. Touch controls come in a 2D and a 3D layout (tap the button at the top centre), and a connected controller (Xbox, PlayStation, Switch Pro, MFi) replaces them. docs/playing.md covers touch, rumble and motion. Short stutters the first time a scene appears are normal: the app compiles graphics for it once and remembers them. The game's data (romfs.img) can live on an external drive that the Files app picks.

Game language. On the Mac, a game that has your Mac's language starts in it: the Game language row of Launch options preselects it until you pick another (1.5 also adds Polish and Thai options), and Reset to tested defaults goes back to it. A game without your Mac's language, a game built in another language (LANGUAGE), and every iPhone build start in the build's language, English by default. For anything the sheet lacks, write an env.txt of KEY=VALUE lines (for example DM_LANG=zh-Hans) in one of two places: ~/Library/Application Support/nxnative/<title ID>/env.txt wins and survives rebuilds, while <App>.app/Contents/Resources/dm/env.txt is the app's own. A Mac app built before the language row existed needs one rebuild to get it. On the iPhone, the same lines go in Documents/env.txt (DM_FPS_TARGET=30 caps the frame rate to save battery, DM_OPMODE=0 picks handheld mode). That file applies to every game in the shared app. For a line that belongs to one game (a mod's DM_ROMFS_OVERLAY, for example), write it in Documents/games/<title ID>/env.txt. Where both files set a key, the game's file wins. A mod is easier: put its folder in Documents/games/<title ID>/mods/<mod name>/ (the RomFS files in a romfs/ folder inside it, or in the folder itself). The shell then sets DM_ROMFS_OVERLAY for that game only. If there are several mods, the one first by name wins where they replace the same file. Where the same key is set twice, the order is: the shell's own settings, the game's env.txt, the game's mods/ folder, the shared Documents/env.txt.

Saves and logs. A Mac game in a library folder keeps its saves and its log beside the app (log/<title ID>.log). Otherwise they are in ~/Library/Application Support/nxnative/<title ID>/ and ~/Library/Logs/nxnative/<title ID>.log. On the iPhone they are in the Files app under the app's name: save/ and log.txt (the previous run is log.prev.txt).

Reporting a bug. A launcher or build problem goes to the issue forms (build problem, launcher problem). Each asks for your versions and computer, Settings > Copy diagnostics and, for a build, the Build log. CONTRIBUTING.md says why. A game that crashes, freezes, runs slowly or looks wrong goes to seedds/nxnative. Never attach keys, game files or anything extracted from a game.

Games

208 games have a profile. Many are reported playable on an iPhone upstream, and most have a profile that has not been tried on a phone yet. A few of them:

Game Where it runs Status
The Legend of Zelda: Tears of the Kingdom Mac and iPhone Verified here: 304,243 files, byte-checked, ~17 GB
Hades II Mac and iPhone Verified here
Animal Crossing: New Horizons iPhone Verified here: runs smoothly
Super Mario Odyssey iPhone Reported playable upstream
The Legend of Zelda: Breath of the Wild iPhone Reported playable upstream, 60 fps with 1.9.0
Mario Kart 8 Deluxe iPhone Reported playable upstream

GAMES.md has the screenshot gallery with each game's install size, and the full table with the update version each game needs: the update NSP's display version must match the profile's, or the build says so.

Switch 2 games are supported in the engine. 19 have a profile: Donkey Kong Bananza, Splatoon Raiders, Fire Emblem Fortune's Weave, Pokémon Pokopia, Hyrule Warriors: Age of Imprisonment, Mario Kart World, Mario Tennis Fever, Star Fox, Yoshi and the Mysterious Book, The Legend of Zelda: Ocarina of Time, Kirby Air Riders, Super Mario Bros. Wonder – Nintendo Switch 2 Edition + Meetup in Bellabel Park, Orbitals, Fast Fusion, Resident Evil 4, Nintendo Switch 2 Welcome Tour, Nintendo Switch Sports Resort, Sonic Frontiers Definitive Edition, and PRAGMATA. Choose the game's folder of files (base/, updates/, dlc/) or its .nup file on the Builds page. No prod.keys are needed for them. The library marks them Switch 2. In addition to Donkey Kong Bananza running on Mac, iPhone, and iPad, The Legend of Zelda: Ocarina of Time (Switch 2 edition) has been played through the ending credits on Mac, and Fire Emblem Fortune's Weave has been verified at 60 fps on iPhone. GAMES.md has the details.

Limitations

  • Only the games with a profile. A title outside the list needs bring-up work of its own. The place to start is docs/agents, upstream's guide for another Switch title.
  • Big games on an iPhone hit a memory limit. Without the Increased Memory Limit entitlement iOS gives the app about 3.4 GB, which is not enough for Tears of the Kingdom. The app requests it, and AltStore Classic 2.2+, Impactor and Xcode with a Personal Team keep it. SideStore with a free Apple ID needs a one-time App ID fix, and Sideloadly drops it (the steps). The full measurements are in GAMES.md.
  • Unsigned launcher. The launcher is not signed for you, so you sideload it. The iPhone app is signed by Xcode with your own team when the launcher installs it.
  • Your own files. No game data, firmware or keys are included or downloaded.
  • Older shard archives are not read any more. The first iPhone builds packed Tears of the Kingdom into a RomFS shard archive (romfs.idx), whereas builds now write a single romfs.img. An iPhone that still holds an old archive needs the game data sent again once, as a romfs.img through the launcher.

For developers

  • Build from source: BUILDING.md. Report or fix something: CONTRIBUTING.md.
  • Where help is wanted: the milestones are the plan, and CONTRIBUTING.md says how to take an issue from one.
  • We are looking for one or two more developers. There is a lot to do. If you want to join us, take an open issue from a milestone and send a well made pull request. People who deliver good work, again and again, are asked to help with reviews and triage.
  • What this fork changes in upstream: the engine (dm/, scripts/, docs/, ref/) is not committed here. It is nxnative at a pinned commit (.upstream-ref) plus a queue of patches, each saying why the fork carries it, and python3 tools/engine.py sync builds it into engine/. patches/README.md explains it, and python3 tools/engine.py status lists what is carried. A daily job moves the pin and opens a pull request, or an issue naming the patch that no longer fits. The links to the engine's documents in this README point at nxnative at the pinned commit.
  • Another Switch game: docs/agents (extraction, binary survey, bring-up).
  • Release history: CHANGELOG.md.

Credits

Community contributors — this project's code is not one maintainer's output:

  • v0lumehi — the Mac front end's launcher (PR #27, 40 files): a game library with key art, per-game launch options, a real progress stream, and a Stop that ends the whole build's process group. The Mac app went from "a build form" to the first version of a launcher that opens like a Switch.
  • m1guelpf (Miguel Piedrafita) — two HLE fixes (PRs #24 and #26): the missing EnableAlbumImageTakenNotification and CreateWithAdjustableSystemClock entries plus their snapshot type byte — each would have read a null in games that call them, and each came with a test.

Want on this list? Contributing says how to start — reports with a full log and fixes with a test move fastest.

Community projects — maintained by their authors, outside this repository:

  • widmonstertony/nxnative (ios16-pokemon-za-port branch) — iOS/iPadOS 16.1–17 and tvOS compatibility, with a legacy Metal renderer path, tested on an A10X iPad and an M2 iPad. For devices this fork's releases do not support.

All of the engine work is other people's. This repository adds the launcher and the patch queue on top:

  • nxnative (MIT) — the native-execution toolchain this repository is built from: the NSO rewriter, the Horizon host layer, NVN-on-Metal, the per-game profiles and the iOS shell.
  • d2r-mobile (MIT) — the original native-execution approach that nxnative grew out of.
  • Ryujinx (MIT) — the shader translator that turns Maxwell shaders into SPIR-V.
  • Atmosphère — the reference for Horizon's synchronization semantics.
  • LibHac — reads NSPs and layers updates in nx_extract.
  • SPIRV-Cross — SPIR-V to Metal Shading Language.
  • yuzu, deko3d, libvpx, stb_vorbis, libdeflate — see upstream's acknowledgement list for what each contributes.

dm/third_party ships other projects with their licenses (list).

Legal

What this project is. A build tool for games you already own. It reads dumps you made of your own cartridges and purchases, on your own machine, and produces a package for your own device. Nothing in this repository, in the app, or in any release contains or distributes Nintendo's code, art, text, data, shaders, firmware, keys or any other copyrighted material.

What it cannot do. The pipeline has no source of games or keys: it requires the user's own prod.keys and their own NSP/XCI dumps, and it talks to no server. It does not bypass, strip or redistribute any protection — LibHac opens the user's own dumps with the user's own keys, the same operation a console performs on a cartridge.

Trademarks. Not affiliated with, sponsored by or endorsed by Nintendo. "Nintendo Switch" and game titles are trademarks of Nintendo Co., Ltd., and all other trademarks belong to their respective owners.

Your responsibility. Laws on making a personal backup copy differ by country, and some places do not allow it at all. You are responsible for knowing and following the law where you live, and for never distributing game files, keys or the packages built from them — the project's outputs are for personal use on your own hardware only. If you enjoy a game, buy it.

Takedowns. If you believe anything in this repository infringes your rights, open an issue or contact the maintainer directly. Valid claims will be actioned promptly, up to removing content or the repository.

No warranty. The software is provided "as is" under the licenses in LICENSE (this fork adds to upstream's, see the credits) — without warranty of any kind, express or implied. Use it at your own risk.

About

Play your own Switch games on iPhone/iPad — one-click macOS app, no terminal. | 把 Switch 游戏装进 iPhone:图形界面一键构建,不用命令行。Bring your own game.

Topics

Resources

Contributing

Stars

8.0k stars

Watchers

19 watching

Forks

Releases

Packages

Contributors

Languages