Speel je Switch-games native op iPhone en iPad

Geen emulator. De eigen code van de game draait direct op de Apple-chip, met Switch-graphics opnieuw opgebouwd op Metal. Neem je eigen NSP-bestanden en prod.keys mee; één script maakt er een IPA van die je sideload.

Aan de slag Bekijk 89 games GitHub

89speelbare games

18opgewaardeerd naar 60 fps

0gamebestanden in de repository

iOS 26+A17 Pro / M1 of nieuwer

Achtergrond

Een native port in plaats van emulatie: de code van de game wordt alleen herschreven waar de kernel van Apple dat vereist.

Native uitvoering

De NSO-modules van elke game worden herschreven en draaien direct op de CPU. Een hostlaag vervangt Horizon, het besturingssysteem van de Switch: threads, geheugen, bestandssysteem, audio en services.

Graphics op Metal

NVN- en Vulkan-aanroepen zijn op Metal geïmplementeerd. Maxwell-shaders worden tijdens de build vertaald naar SPIR-V en daarna naar Metal Shading Language.

Neem je eigen game mee

Hier wordt niets van een game meegeleverd. Het packscript leest je NSP's met je sleutels op je Mac en schrijft een niet-ondertekende IPA om te sideloaden.

Profiel per game

Elke game heeft in dm/games/<title id> een klein profiel met constanten en shadertabellen. De code leest het profiel en bevat nooit een vastgezette game.

Gebouwd op d2r-mobile, de shadervertaler van Ryujinx, Atmosphère, yuzu, LibHac, SPIRV-Cross en meer. Zie de dankwoorden.

Snelle handleiding

Pak een IPA op een Mac, sideload hem en speel. De eerste build duurt 30–60 minuten, latere ongeveer 10.

Vereisten. Een Mac met Xcode en Homebrew; vrije schijfruimte van ongeveer twee keer de grootte van de NSP's plus 10 GB; een iPhone 15 Pro of nieuwer (A17 Pro+) of een iPad met M1 of later, met iOS / iPadOS 26+ (de BC-gecomprimeerde textures van de games hebben dat nodig).

Liever een venster dan een terminal? NX2Apple, een communityproject, verpakt deze stappen in een macOS-app.

Haal nxnative en de tools op

Eenmalig, op de Mac.

git clone https://github.com/seedds/nxnative.git && cd nxnative
brew install xcodegen zstd spirv-cross
brew install --cask dotnet-sdk
python3 -m pip install lz4 capstone fonttools "backports.zstd; python_version < '3.14'"

Zet de NSP's van één game in een map

De basisgame (een NSP of een XCI-dump), de update en eventuele DLC.

~/Games/MarioWonder/
  Super Mario Bros. Wonder [010015100B514000][v0].nsp
  Super Mario Bros. Wonder [010015100B514800][v327680].nsp

Voer het script uit

De IPA verschijnt in dezelfde map.

python3 scripts/build_ipa_from_nsp.py ~/Games/MarioWonder -k ~/keys/prod.keys

Sideload

Installeer de IPA met AltStore, Sideloadly, LiveContainer of iets vergelijkbaars. De app krijgt de naam, het icoon en de versie van de game.

Spelen

Tik bovenaan op 2D / 3D om de aanraakindeling te wisselen. Een aangesloten controller verbergt de aanraakbediening. In 3D veeg je over het rechtergedeelte (een derde) van het scherm voor de camera. Schud de telefoon om de controller te schudden.

FAQ en tips

Taal

Standaard Engels. Kies bij het packen een andere met -l (bijvoorbeeld -l ja), of voeg DM_LANG=zh-Hans toe aan Documents/env.txt.

Saves en logs

In de Bestanden-app onder de naam van de app: save/ en log.txt. Stuur log.txt mee als er iets misgaat.

Haperingen

Korte haperingen de eerste keer dat een scène verschijnt zijn normaal: graphics worden één keer gecompileerd en onthouden.

Opnieuw installeren

Sommige sideload-tools geven een nieuwe gegevensmap. Kopieer save/ en pso_user.tsv uit de oude.

Instellingen

Regels in Documents/env.txt: DM_OPMODE=0 voor handheld, DM_FPS_TARGET=30 om batterij te besparen, DM_SHOW_FPS=1 voor een fps-teller.

Niet ondersteund

Geen amiibo, geen onlinefuncties. Andere games krijgen een analyserapport en een IPA op basis van beste inspanning die mogelijk niet start.

Communityprojecten

Projecten die anderen op nxnative bouwen. Ze worden niet door nxnative onderhouden; raadpleeg de README en issues van elk project.

NX2AppleVan derden

A fork of nxnative that follows upstream daily and adds NS Port Builder, a macOS app that runs the whole pipeline from a window.

A GUI for every step: pick the game, update, DLC and prod.keys, install missing tools with one click, follow the build's stages
A RomFS archive of about 100 shards, so very large games such as Tears of the Kingdom install as a slim IPA plus one folder of files
Interrupted builds resume where they stopped; a prebuilt macOS (Apple silicon) app on its releases page

GitHub Releases

LumaDock · 璃游Van derden

A native launcher for Apple Silicon Macs (macOS 26+, SwiftUI) that you point at your own nxnative checkout, games and keys.

A game library: add NSP / XCI / NSZ / XCZ files or scan a folder, then import, decompress and prepare them automatically
Automated builds with measured progress, cancellation and retry, shader warnings and repair suggestions
Launch a game on the Mac or export an unsigned iPhone / iPad IPA from the game's details; English and Simplified Chinese interface

GitHub Releases

NX PlayVan derden

A Mac app (and the nxplay script behind it) that builds, plays, installs and manages your Switch games through nxnative, on the Mac and on iPhone / iPad.

A library of your games with their icons: extract, play on the Mac and rebuild from one window; Console Mode runs full screen with a game controller
Install on an iPhone or iPad through Xcode or build an IPA to sideload; copy saves between the Mac and a device and back them up to your own private Git repository
Pulls nxnative's latest fixes before each run and rebuilds when they change something, or keeps a build that works as it is; needs Apple silicon and macOS 15+

GitHub Releases

NxNative LauncherVan derden

A native macOS interface (Apple silicon, macOS 13+) that turns nxnative's command-line pipeline into a console-style game library and a guided porting wizard.

A cover-art game library you can drive with a game controller (Nintendo, Xbox, PlayStation, 8BitDo and generic gamepads), with per-game settings such as 60 FPS, docked / handheld, MetalFX and the Metal HUD
A three-step wizard: drop a folder of NSP / NSZ / XCI files, choose a Mac app or an iOS IPA, and follow the build stages live
Shows installed DLC and the save folder for each game, and sends a notification when a build finishes or fails

GitHub