Guide: Running Switch games natively on Mac with nxnative
AppleGamingWiki · Source en anglais
Ouvrir la ressource →Apple Silicon Mac · iPhone · iPad
Vos jeux Switch, en natif sur Apple
Créez des apps pour Mac avec puce Apple, iPhone et iPad à partir de vos jeux et clés. Le code du jeu s’exécute sur la puce Apple et les graphismes utilisent Metal.
128jeux jouables
25passés à 60 ips
MITCode source sur GitHub
Choisissez où jouer
Les deux options se compilent sur Mac : ouvrez l’app Mac ou installez l’IPA non signé sur iPhone ou iPad par sideloading.
Apple Silicon Mac
Compilez avec --platform mac-app, puis ouvrez l’app créée depuis le Finder.
iPhone & iPad
Créez un IPA sur Mac, puis installez-le par sideloading. La version amont exige iOS / iPadOS 26+ et A17 Pro / M1 ou plus récent.
Vos jeux et vos clés
Préparez le jeu de base, les mises à jour et DLC facultatifs, ainsi que prod.keys. Aucun jeu ni aucune clé n’est fourni.
Vérifiez d’abord votre jeu
Le catalogue recense des tests de jeu sur Mac ou iPhone. Chaque fiche précise la version testée, les notes et les limites connues.
Construit sur d2r-mobile, le traducteur de shaders de Ryujinx, Atmosphère, yuzu, LibHac, SPIRV-Cross et d'autres. Voir les remerciements.
Trouvez votre jeu
Ces jeux ont été testés sur Mac ou iPhone, mais pas nécessairement sur tous les appareils. Consultez chaque fiche pour les détails.
Donkey Kong Bananza
Splatoon Raiders
Fire Emblem Fortune's Weave60 fps
Pokémon Pokopia
Mario Kart 8 Deluxe
Mario vs. Donkey Kong
Paper Mario: The Thousand-Year Door60 fps
Super Mario 3D World + Bowser's Fury3D disposition
Super Mario Bros. Wonder2D disposition
Super Mario Galaxy3D disposition
Super Mario Galaxy 23D disposition
Super Mario Odyssey3D disposition
Afficher tout le catalogue (128)
The Legend of Zelda: Breath of the Wild3D disposition60 fps
The Legend of Zelda: Link's Awakening2D disposition
The Legend of Zelda: Tears of the Kingdom3D disposition60 fps
13 Sentinels: Aegis Rim2D disposition
Absolum2D disposition
Ace Attorney Investigations Collection2D disposition
Advance Wars 1+2: Re-Boot Camp
AI: THE SOMNIUM FILES
AI: THE SOMNIUM FILES - nirvanA Initiative
Animal Crossing: New Horizons
ANIMAL WELL
ASTRAL CHAIN60 fps
Balatro
BALL x PIT
Bayonetta
Bayonetta 2
Bayonetta 3
Big Brain Academy: Brain vs. Brain2D disposition
Brain Memory Training Academy2D disposition
Captain Toad: Treasure Tracker3D disposition
Catherine: Full Body
Celeste2D disposition
Cuphead2D disposition
DARK SOULS: REMASTERED60 fps
Digimon Story Cyber Sleuth: Complete Edition
Donkey Kong Country: Tropical Freeze
DRAGON QUEST VII Reimagined60 fps
DRAGON QUEST XI S: Echoes of an Elusive Age – Definitive Edition3D disposition60 fps
FINAL FANTASY RESONANCE60 fps
FINAL FANTASY TACTICS - The Ivalice Chronicles3D disposition
Fire Emblem Engage2D disposition60 fps
Fire Emblem: Three Houses3D disposition60 fps
Ghost Trick: Phantom Detective
The Great Ace Attorney Chronicles2D disposition
Hades3D disposition
Hades II3D disposition
Hollow Knight: Silksong
Hyrule Warriors: Age of Calamity3D disposition60 fps
Kirby and the Forgotten Land
Luigi's Mansion 360 fps
Metroid Dread2D disposition
Monster Hunter Rise3D disposition60 fps
Monster Train 22D disposition60 fps
OCTOPATH TRAVELER
Octopath Traveler 02D disposition60 fps
Octopath Traveler II60 fps
Patrick's Parabox2D disposition
Persona 5 Royal
Pikmin 4
Pokémon Brilliant Diamond60 fps
Pokémon Legends: Z-A2D disposition
Pokémon Scarlet
Pokémon Violet
Pokémon Sword
Pokémon Shield
Portal
Raging Loop
Rhythm Heaven Groove2D disposition
ROMANCE OF THE THREE KINGDOMS 8 REMAKE
Sea of Stars
SHIN MEGAMI TENSEI V: Vengeance60 fps
Stardew Valley
STEINS;GATE RE:BOOT2D disposition
Super Smash Bros. Ultimate
Taiko Risshiden V DX
Unicorn Overlord2D disposition
Yoshi's Crafted World
NieR:Automata The End of YoRHa Edition60 fps
The Legend of Zelda: Echoes of Wisdom
Donkey Kong Country Returns HD
Mario + Rabbids Sparks of Hope
Xenoblade Chronicles 2
Xenoblade Chronicles 3
FINAL FANTASY CRYSTAL CHRONICLES Remastered Edition
Return of the Obra Dinn
Blasphemous 2
Silver Pines
Blasphemous
FINAL FANTASY X/X-2 HD Remaster
Mario + Rabbids Kingdom Battle
Persona 4 Golden
Xenoblade Chronicles: Definitive Edition
Pokémon Legends: Arceus
Super Mario Party Jamboree
Cult of the Lamb
Paper Mario: The Origami King
Batman: Arkham Knight
Bastion
Baba Is You
SteamWorld Heist II
SteamWorld Heist: Ultimate Edition
Subnautica: Below Zero
SteamWorld Dig 2
Streets of Rage 4
Mario Party Superstars
Subnautica
SteamWorld Dig
Team Sonic Racing
Well Dweller
Need for Speed: Hot Pursuit Remastered60 fps
EA SPORTS FC 2760 fps
Portal 2
Super Monkey Ball Banana Rumble
Atelier Ryza: Ever Darkness & the Secret Hideout DX
DRAGON QUEST III HD-2D Remake60 fps
Hyrule Warriors: Definitive Edition
Metroid Prime Remastered
DRAGON QUEST I & II HD-2D Remake
Dead Cells
Hollow Knight
TRIANGLE STRATEGY60 fps
Castlevania: Belmont's Curse
SUPER ROBOT WARS Y
Super Mario RPG
The Legend of Zelda: Skyward Sword HD
Princess Peach: Showtime!60 fps
Des fichiers à une app jouable
La première compilation prend environ 30–60 minutes ; les suivantes réutilisent le travail effectué. Vous obtenez une app Mac ou un IPA non signé.
Compilation : macOS 26.6+, Xcode 27.1, Homebrew et Python ARM64 3.12+. Pour iPhone, installez aussi la plateforme iOS de Xcode. Prévoyez deux fois la taille du jeu plus 10 Go d’espace libre.
Vous préférez une fenêtre à un terminal ? NX2Apple, un projet de la communauté, regroupe ces étapes dans une app macOS.
Récupérer nxnative et ses outils
Une seule fois, sur le Mac.
xcodebuild -downloadComponent MetalToolchain
git clone https://github.com/seedds/nxnative.git && cd nxnative
brew install xcodegen zstd glslang
brew install --cask dotnet-sdk
python3 -m pip install lz4 "capstone>=5,<6" fonttools nsz zbic "backports.zstd; python_version < '3.14'"Mettre les NSP d'un jeu dans un dossier
Placez le jeu de base, les mises à jour et DLC dans un dossier. Formats pris en charge : NSP, XCI, NSZ et XCZ.
~/Games/MarioWonder/
Super Mario Bros. Wonder [010015100B514000][v0].nsp
Super Mario Bros. Wonder [010015100B514800][v327680].nspLancer le script
Le résultat se trouve dans le dossier du jeu. Pour Mac, ajoutez --platform mac-app.
python3 scripts/build_ipa_from_nsp.py ~/Games/MarioWonder -k ~/keys/prod.keys
# Mac app instead of an iPhone IPA:
python3 scripts/build_ipa_from_nsp.py ~/Games/MarioWonder -k ~/keys/prod.keys --platform mac-appOuvrir ou installer
Sur Mac, ouvrez l’app depuis le Finder. Sur iPhone / iPad, installez l’IPA avec AltStore, Sideloadly ou LiveContainer. Pour les gros jeux, activez Increased Memory Limit si l’outil le propose.
Jouer
Touchez 2D / 3D en haut pour changer la disposition tactile. Une manette connectée masque les commandes tactiles. En 3D, glissez sur le tiers droit de l'écran pour la caméra. Secouez le téléphone pour secouer la manette.
Si l’IPA est trop gros, recompilez avec --romfs separate et exécutez la commande de copie indiquée. La compatibilité avec les anciens iOS relève d’une branche communautaire. Jouer.
Tutoriels et vidéos
Sélection issue de Google le 30 octobre 2026. Le classement varie. Privilégiez la documentation actuelle ; les titres des vidéos ne garantissent pas la prise en charge de tous les jeux.
nxnative — Development guide
seedds / nxnative · Source en anglais
Ouvrir la ressource →How to Build Any Switch Game As Native Mac App (nxnative)
Andrew Tsai’s Tips · 11:59 · Source en anglais
Ouvrir la ressource →NXnative - Native Switch Games on iPhone 17 Pro Max
blackheart909 · 8:41 · Source en anglais
Ouvrir la ressource →FAQ et astuces
Langue
Anglais par défaut. Choisissez-en une autre à l'empaquetage avec -l (par exemple -l ja), ou ajoutez DM_LANG=zh-Hans à Documents/env.txt.
Sauvegardes et journaux
Dans l'app Fichiers, sous le nom de l'app : save/ et log.txt. Envoyez log.txt en cas de problème.
Saccades
De courtes saccades à la première apparition d'une scène sont normales : les graphismes sont compilés une fois puis mémorisés.
Réinstallation
Certains outils de sideload donnent un nouveau dossier de données. Copiez save/ et pso_user.tsv depuis l'ancien.
Réglages
Lignes dans Documents/env.txt : DM_OPMODE=0 pour le mode portable, DM_FPS_TARGET=30 pour économiser la batterie, DM_SHOW_FPS=1 pour afficher les ips.
Non pris en charge
Pas d'amiibo ni de fonctions en ligne. Les autres jeux reçoivent un rapport d'analyse et un IPA « au mieux » qui peut ne pas démarrer.
Outils et compatibilité communautaires
Découvrez des interfaces graphiques, des bibliothèques de jeux et la prise en charge d’anciens iOS. Ces projets sont indépendants ; leurs fiches renvoient aux prérequis et au code source.
NX2Apple Tiers
Un lanceur et une bibliothèque macOS pour compiler et gérer les jeux Mac, iPhone et iPad. Depuis la v1.0, iPhone et iPad partagent une coque avec bibliothèque, Cover Flow, navigation à la manette ou au clavier et réglages par jeu ; le moteur est livré avec les versions et suit le dépôt amont chaque jour.
Voir le projet →NX Play Tiers
Une bibliothèque pour extraire, jouer, empaqueter et gérer les jeux, désormais avec NX Play sur iPhone et iPad. Le lanceur mobile liste les jeux du Mac, demande une installation par réseau local, lance les jeux installés avec manette et rappelle le renouvellement des signatures.
Voir le projet →LumaNX Tiers
LumaNX, anciennement LumaDock, réunit nxnative, une bibliothèque graphique, une file de builds et des conversions. La version 0.3.0 ajoute sur Mac l’import expérimental de dossiers Switch 2 déchiffrés et réutilise les étapes de préparation inchangées.
Voir le projet →iOS 16.1/17 compatibility fork Tiers
Branche expérimentale de compatibilité pour anciens iOS avec Metal classique, contraintes de shaders par appareil et adaptateurs par build. La branche maintenue s’appelle désormais ios16-ios17-compat.
Voir le projet →nx2android Tiers
nx2android transpose à Android l’exécution directe de nxnative. Le code ARM64 du jeu s’exécute sur l’appareil et les appels NVN passent par Vulkan ; le constructeur produit un APK et les données du jeu.
Voir le projet →MacNativeGames Tiers
MacNativeGames est un projet natif indépendant centré sur Breath of the Wild et Tears of the Kingdom. Il fonctionne sur Mac, iPhone, iPad et propose un support initial de Vision Pro.
Voir le projet →xbunax nxnative Tiers
xbunax/nxnative est un fork doté d’un studio WebUI local. Il ajoute l’import et les tâches dans le navigateur, la conversion XCI et documente les routes IPA sous Windows et macOS.
Voir le projet →CA-NINAPPLE Tiers
CA-NINAPPLE est un fork Windows dérivé de NXNativeWindows. Son interface et son flux PowerShell produisent un IPA à partir du jeu et des clés sans Mac.
Voir le projet →NX OS Tiers
NX OS est un lanceur macOS façon console construit sur nxnative. Il découvre les jeux compilés, les lance en plein écran, suit le temps de jeu et peut créer de nouveaux builds Mac ou iPhone.
Voir le projet →nxnative-gui Tiers
nxnative-gui est un frontend macOS léger, pas un autre moteur. Il clone ou met à jour nxnative, vérifie les outils et rassemble dans un formulaire les choix habituellement saisis dans le terminal.
Voir le projet →ns2ios-shell Tiers
ns2ios-shell sépare un shell iOS réutilisable du conditionnement local par jeu. La CI construit le shell et l’outil assemble jeu et shell sous Windows, Linux ou macOS sans Xcode.
Voir le projet →