Run your own supported Nintendo Switch games natively on Mac, iPhone and iPad — with Metal graphics, physical controllers and editable touch controls.

Start here

First: install full Xcode from the Mac App Store and open it once. Xcode compiles the games too, so a prebuilt launcher cannot remove this requirement.

Then: paste this single command into Terminal:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/nalancer08/nxnative-easy/main/install.sh)"

It downloads nxnative Easy, installs Homebrew and the missing build tools, compiles your own Mac interface and opens it. Follow any password or confirmation prompts in Terminal. No Apple developer account is used.

Already downloaded this repository? Double-click START-HERE.command in its top-level folder. It performs the same setup; you do not need to find a script under scripts/. If macOS blocks that file, use the Terminal command above.

When the app opens:

Choose iPhone / iPad or Mac.
Choose your own game folder and keys folder.
Click Prepare game.

After setup: open nxnative Easy.app in your home Applications folder. The setup keeps its source checkout separately, so you can delete the downloaded ZIP and folder.

Mac: creates one complete game .app, with its game data included inside; click Open game. No separate RomFS folder to copy. No Sideloadly or iPhone needed. Saves stay in ~/Library/Application Support/nxnative/<title ID>/.

iPhone / iPad: creates an unsigned lightweight IPA; install it with Sideloadly, then copy the game data as shown in the app. See the iPhone/iPad preparation screen.

Required: an Apple silicon Mac (M1 or newer), macOS 26+ and Xcode 26+. The command installs the other tools. You must provide your own games and keys. Compilation can take time, especially for the first game.

What this version adds

Built on seedds/nxnative. The original project provides the engine, game profiles and compatibility work. nxnative Easy adds:

Native Mac app: game-folder selection, progress, cancellation, and buttons for the IPA, RomFS data and Sideloadly.
Editable iPhone touch controls: position, size and opacity, saved per game and 2D/3D layout.
Lightweight IPA export for iPhone/iPad only: RomFS data live separately; existing outputs and valid caches are preserved.
Your own keys: explicitly select the external folder containing your prod.keys. No games or keys are included, downloaded or distributed.
Local preparation: no Apple account or company certificate is used to build the desktop app.

We provide source code, a preparation interface and build tools. The output is a local Mac game app, or an unsigned iPhone/iPad IPA that you sign and install yourself with Sideloadly. Games, console keys, Apple signing and universal game compatibility are not provided.

Language

The app starts in English. Choose Español using the selector at the top; your selection is remembered on this Mac. This changes the interface language, not the game's language. Build diagnostics keep their original language.

Updating the app

From version 1.4, the app checks for new releases at launch and every six hours while open. When one is available, click Update now. It downloads the new source and game profiles, builds and verifies the new Mac interface, then restarts it. Progress stays in the window. You can also use nxnative Easy → Check for updates….

The update uses a separate source folder and keeps the previous app as a backup. It does not reset your checkout or modify your game files, keys or saves. Updates are disabled while preparing a game. To apply new engine or profile changes to a previously prepared game, prepare that game again.

Your friend's older app has no updater yet: run the setup command above once, or double-click START-HERE.command, to get this version. Future updates then appear inside the app.

What happens after Prepare game?

The app prepares the tools and builds for your chosen device. Mac produces a game app with Open game and Show app buttons. iPhone / iPad produces a lightweight IPA and shows the Sideloadly and Finder steps when ready. Your own files and previous outputs stay in the game folder.

Setup keeps a separate source checkout and preserves local edits. Developers can still use scripts/Abrir-interfaz.command.

How the Mac app is built

The launcher uses Xcode's Swift compiler. The desktop app is explicitly ad-hoc signed, locally, with no Apple account, certificate or team (TeamIdentifier is unset). No company account is used. You enter your personal Apple account separately in Sideloadly when signing the iPhone IPA.

The app has an original phone-and-controller icon. Game cards use the existing upstream screenshots in this repository as a support reference; they do not provide or download games.

Install with Sideloadly and Finder

When the IPA is ready, connect your iPhone and click Send to Sideloadly. The app opens the prepared IPA there.
In Sideloadly, click Start using your personal Apple account. If needed, use Show IPA to find the file manually.
On the first installation, click Show game data and copy the complete romfs folder using Finder → iPhone → Files → your game.

For updates, keep the same Apple account and effective bundle ID used in Sideloadly. Install over the existing app; do not uninstall it, to retain its saves. Reuse the existing romfs only when the game data have not changed. The app installs missing build dependencies after Xcode and Homebrew are available, but does not sign or install the iPhone game. Those steps happen in Sideloadly. The app explains them only when the IPA is ready. See the official Sideloadly FAQ.

Included game profiles

The home carousel shows the game profiles in your checkout; it does not provide or download games. You must add your own game files. Click View all at the top right to browse the complete support list. Search by name, version or Title ID; each result links to its game notes. The catalog reads the local profiles each time you open it. The carousel rotates automatically and pauses while you hover over it.

Our own checks cover macOS compilation and packaging, not automatic iPhone gameplay verification. Profiles and gameplay reports come from upstream and may concern Mac or iPhone; read your game's notes. A profile does not guarantee that every game version works on every device.

This base requires iOS/iPadOS 26 or later, an iPhone with A17 Pro or later, or an iPad with M1 or later. Supply your own game files and keys.

Mario Kart 8 Deluxe _{~11.9 GB · no Mii heads}	Mario vs. Donkey Kong _{~1.6 GB}	Paper Mario: The Thousand-Year Door _{~5 GB · 60 fps with 1.0.1}
Super Mario 3D World + Bowser's Fury _{~3 GB}	Super Mario Bros. Wonder _{~4 GB}	Super Mario Galaxy _{~3 GB}
Super Mario Galaxy 2 _{~3 GB}	Super Mario Odyssey _{~6 GB}	The Legend of Zelda: Breath of the Wild _{~16 GB · 60 fps with 1.9.0}
The Legend of Zelda: Link's Awakening _{~6 GB}	The Legend of Zelda: Tears of the Kingdom _{~17 GB · 60 fps with 1.4.3}	13 Sentinels: Aegis Rim _{~5 GB}
Absolum _{~2 GB}	Ace Attorney Investigations Collection _{~7 GB}	Advance Wars 1+2: Re-Boot Camp _{~7.1 GB}
AI: THE SOMNIUM FILES _{~8.3 GB}	AI: THE SOMNIUM FILES - nirvanA Initiative _{~11.6 GB}	Animal Crossing: New Horizons _{~10.5 GB}
ANIMAL WELL _{~54 MB}	ASTRAL CHAIN _{~9.7 GB · 60 fps target with 1.0.1}	Balatro _{~82 MB · played by touch}
BALL x PIT _{~1.1 GB}	Bayonetta _{~8.8 GB}	Bayonetta 2 _{~12.5 GB}
Bayonetta 3 _{~14.2 GB}	Big Brain Academy: Brain vs. Brain _{~0.8 GB}	Brain Memory Training Academy _{~0.1 GB}
Captain Toad: Treasure Tracker _{~2 GB}	Catherine: Full Body _{~14 GB}	Celeste _{~0.9 GB}
Cuphead _{~5 GB}	DARK SOULS: REMASTERED _{~4 GB · 60 fps with 1.0.3}	Digimon Story Cyber Sleuth: Complete Edition _{~5 GB}
DRAGON QUEST VII Reimagined _{~5.9 GB}	DRAGON QUEST XI S: Echoes of an Elusive Age – Definitive Edition _{~15 GB · 60 fps with 1.0.4}	FINAL FANTASY RESONANCE _{~10 GB · 60 fps with 1.0.1}
FINAL FANTASY TACTICS - The Ivalice Chronicles _{~11 GB}	Fire Emblem Engage _{~15 GB · 60 fps with 2.0.0}	Fire Emblem: Three Houses _{~13 GB · 60 fps with 1.2.0}
Ghost Trick: Phantom Detective _{~3 GB}	The Great Ace Attorney Chronicles _{~4 GB}	Hades _{~4 GB}
Hades II _{~4 GB}	Hollow Knight: Silksong _{~6.4 GB}	Hyrule Warriors: Age of Calamity _{~15 GB · 60 fps with 1.3.0}
Luigi's Mansion 3 _{~7.5 GB · 60 fps with 1.4.0}	Metroid Dread _{~5 GB}	Monster Hunter Rise _{~22 GB · 60 fps with 16.0.2}
Monster Train 2 _{~1.6 GB · 60 fps with 1.1.1}	Octopath Traveler 0 _{~4 GB · 60 fps with 1.0.5}	Octopath Traveler II _{~5.9 GB · 60 fps with 1.1.1}
Patrick's Parabox _{~0.2 GB}	Persona 5 Royal _{~14.9 GB}	Pikmin 4 _{~10.8 GB}
Pokémon Brilliant Diamond _{~4.6 GB · 60 fps with 1.3.0}	Pokémon Legends: Z-A _{~6 GB}	Pokémon Sword _{~12.4 GB}
Pokémon Shield _{~12.4 GB}	Portal _{~2.6 GB}	Raging Loop _{~0.9 GB}
Rhythm Heaven Groove _{~3 GB}	ROMANCE OF THE THREE KINGDOMS 8 REMAKE _{~16.8 GB · controller only}	Stardew Valley _{~0.6 GB}
STEINS;GATE RE:BOOT _{~6 GB}	Super Smash Bros. Ultimate _{~17.5 GB · offline}	Taiko Risshiden V DX _{~3.3 GB · Japanese · played by touch}
Unicorn Overlord _{~4 GB}	NieR:Automata The End of YoRHa Edition _{~10.9 GB · 60 fps with 1.0.3}	The Legend of Zelda: Echoes of Wisdom _{~7.8 GB}

Xbox, PS5 and PS4 controllers

The game apps use Apple's GameController framework on Mac, iPhone and iPad:

Xbox: Bluetooth-capable Xbox Wireless Controller (model 1708), Series X/S and Elite Series 2.
PS5: DualSense and DualSense Edge.
PS4: DualShock 4.

The preparation app automatically shows connected controller names and Ready on this Mac when Apple exposes a compatible gamepad profile. It updates when you connect or disconnect a controller. The Mac controller panel is hidden when you choose iPhone/iPad. Pair a controller directly with the device where you will play.

In Mac mode, click Test controller to see live input: buttons and D-pad light up, both sticks move, and trigger bars show pressure. Input received! appears only after input is detected. If several controllers are connected, choose which one to test. The tester reads input only while its window is visible and does not take input handlers away from games.

Pair your controller in the device's Bluetooth settings, then open the prepared game. No extra driver or launcher setting is needed. Sticks, D-pad, face buttons, shoulders, triggers, stick clicks and menu buttons are mapped automatically. On iPhone/iPad, touch controls hide while a physical controller is connected.

Face buttons follow Nintendo positions, rather than the letters printed on an Xbox controller: Switch A = Xbox B / PlayStation Circle; Switch B = Xbox A / Cross; Switch X = Xbox Y / Triangle; Switch Y = Xbox X / Square.

Standard gamepad input is supported; DualSense adaptive triggers, controller motion and touchpad gestures are not mapped. Rumble depends on the features exposed by the controller and OS. Mac supports separate local players when the game allows it; iPhone/iPad merge controllers into player 1.

See Apple's Xbox pairing guide and PlayStation pairing guide. This support was checked in the input code and automated tests; these specific physical models have not been tested in this checkout.

Make the controls your own

Inside the game, tap Edit controls. Move buttons, adjust their size and opacity, then tap Save. Cancel discards edits; Reset control / Reset all restores defaults. Each game keeps separate 2D and 3D layouts. The game continues running while you edit. The desktop language selector does not translate this in-game editor.

Guides, commands and technical details

Based on seedds/nxnative, with our touch editor and preparation workflow. The MIT license, original acknowledgements and third-party licenses are retained. Personal additions are authored by nalancer08; upstream commits retain their original authors.

README.md Unescape Escape

nxnative Easy