r/NativePortsOniOS • • 12d ago Bravo

Mario Kart World iOS Released

1.2k Upvotes

Everything is complete and released for public use.
Recorded in 18 Pro
- 60 stable with minor hitches
- no graphical glitches or missing textures
- uses below 4gigs of ram

My repo: https://github.com/cheemu21/plumber-racer-2

Built on the nxnative framework, running in LiveContainer. Rather than emulating the console, nxnative runs the game’s own code on the phone, handles its system calls directly, and translates its Switch 2 shaders and NVN2 graphics calls to Apple’s Metal. Bringing the game up required support for several features it depends on. These included task and mesh shaders running on Metal’s mesh pipelines, sparse textures for its very large terrain data, and the video decoding used by its cup movies. Rendering problems such as frozen movies, missing textures, and magenta surfaces were traced and resolved one at a time using diagnostic logs from the device.

Memory was the largest obstacle, since a race initially needed more than the 8 GB iOS allows the app. We solved this by moving the game’s memory into a file-backed mapping that sits outside the system’s limit, loading textures in a way that avoids locking large memory pools in place, and reducing the detail of large textures. Together, these changes brought usage down to about 3.9 GB and made it possible to play through a complete cup.

Performance work followed the same measurement-led approach, using device logs and profiling to identify where each frame’s time was going. This led to pipeline prebuilding to eliminate compile stutter, along with CPU, terrain, and memory improvements adapted from the kartnative.

The port also features a touch layout which was also used from my Mario Kart 8 Deluxe ios port. I just added new buttons for it.

Also the newly built system opens up the opportunity to port newer titles that requires immense amount of ram usage.


r/NativePortsOniOS • • 4d ago

I might never Emulate again!

Post image
1.1k Upvotes

Everything is Native now.

What games have you ported over?


r/NativePortsOniOS • • 9d ago

So far…

Post image
820 Upvotes

The black app is Plumber Racer

Borrowed my gfs MacBook to create these using NXApple AND Claude code
I watched this Tutorial on YouTube to learn how to do it

Half of these wouldn’t work without Claude code


r/NativePortsOniOS • • 10d ago

Zelda Ocarina of Time running on iPhone

812 Upvotes

Work in Progress although Mac counterpart is released.
Ran on 18 Pro
- Unstable fps but reaches above 40
- No graphical glitches
- Utilizes about 6-7 gigs of ram

https://github.com/cheemu21/kid-with-sword-remake


r/NativePortsOniOS • • 10d ago

Introducing PomiVigra (WIP). An app which will convert Switch games into native iOS apps using only your device. No more Mac or GitHub runners needed.

Post image
798 Upvotes

Im currently working on an app which will use NXnative as a backbone to compile Switch games into native iOS apps. Unlike other approaches this aims to handle 100% of the workflow on device (no Mac Silicone, XCode or GitHub runners needed). It’s still very much a work in progress but I hope to have a beta ready within the next few days. I’ll make an official announcement once it’s ready as I’ll be looking for beta testers. I only have an iPhone 14 and want to ensure it works on a variety of devices before an official release. Stay tuned.

Also if you are interested in being a beta tester leave a comment with your device specs and preferred sideloading method.

Cheers!


r/NativePortsOniOS • • 4d ago

This is like a dream comes true. Built with NX2Apple on Windows PC. Running with iPhone Duo.

Post image
603 Upvotes

Even with the portability of Switch, carrying it around requires a conscious decision of “I’m going to play Switch today” and gen 1 screen is really bad in today’s standard. With NX2Apple running on Windows, I started this project to turn my games into native iOS apps that can run on my iPhone Duo. I practically have my phone with me 99% of the time, so I can truly play at anytime anywhere I want.

Everything was built (except the first few games) using NX2Apple 1.3.0, games living on my NAS, Claude automating copying the game files to local, build using NX2Apple, put them back to NAS, and I manually install the IPAs using Live Container.

If I run into issues, I feed the logs back to Claude and it fixes NX2Apple to rebuild. Below are the results of all my builds so far.

Switch games on iPhone (NX2Apple) – build results

✅ Works out of the box (27)

  • 1-2-Switch

  • ARMS

  • Bluey The Videogame

  • Castlevania Advance Collection

  • Fire Emblem Warriors: Three Hopes

  • Hyrule Warriors: Age of Calamity

  • Just Dance 2022

  • Just Dance 2025

  • Kirby Star Allies

  • Mario Kart 8 Deluxe

  • Mario Strikers: Battle League

  • Mario vs. Donkey Kong

  • My Friend Peppa Pig

  • ONE PIECE PIRATE WARRIORS 4

  • Paper Mario: The Origami King

  • Paper Mario: The Thousand-Year Door

  • Pokémon Brilliant Diamond

  • Pokémon Shining Pearl

  • Samurai Warriors 5 Deluxe Edition (built, not yet played)

  • Super Mario 3D World + Bowser's Fury

  • Super Mario Party Jamboree

  • Super Mario RPG

  • Super Monkey Ball Banana Rumble

  • The Legend of Zelda: Echoes of Wisdom

  • The Legend of Zelda: Link's Awakening

  • The Legend of Zelda: Ocarina of Time

  • Trombone Champ

🔧 Built but with issues, fixed (4)

GameFix
Dr Kawashima's Brain TrainingCrash at launch
Fate/EXTELLA LINKBlack game screen
Persona 5 StrikersCrash after the logos (notification and play-statistics services)
Kirby and the Forgotten LandCoins, enemies and objects disappearing (shader output format)

🛠️ Build failed, fixed (4)

GameFix
Hello Kitty Island AdventureCode-rewrite failure (new jump-pattern recogniser)
Yoshi's Crafted WorldCompressed-asset handling in the Windows builder; 60 fps
Demon Slayer: The Hinokami ChroniclesiOS memory limit (smaller memory layout); steady 30 fps
MY HERO ONE'S JUSTICE 2Unreal pak format, code rewrite, iOS memory layout, memory setup for its older Nintendo SDK; solid 60 fps

⚠️ Built, known issues (4)

GameStatus
JUMP FORCEStartup crashes fixed (memory, memory manager, online setup); still static in the sound (fix being tested), black boxes around characters, characters too dark
Fate/EXTELLA: The Umbral StarBlack screen fixed (shader package format); some skill effects may be missing
Luigi's Mansion 3Tessellated surfaces not supported
Mario Tennis AcesRendering problems

🏗️ Building now (2)

  • Naruto x Boruto: Ultimate Ninja Storm Connections (with DLC)

  • Red Dead Redemption

❌ Can't build (9)

GameReason
Mario & Luigi: BrothershipOodle/LZ5-compressed Unreal paks, needs a Mac
Demon Slayer: Sweep the BoardUnreal paks need a Mac to read
FANTASY LIFE iOodle/LZ5-compressed Unreal paks, needs a Mac
ONE PIECE ODYSSEY Deluxe EditionOodle/LZ5-compressed Unreal paks, needs a Mac
DRAGON QUEST BUILDERS 2Builds its shaders while running; capturing them needs a Mac
Hyrule Warriors: Definitive EditionBuilds its shaders while running; needs a Mac
Super Mario 3D All-StarsBuilds its shaders while running; needs a Mac
Mario Golf: Super RushNeeds the game booted on a Mac during the build
Luigi's Mansion 2 HD32-bit game; the engine only runs 64-bit games

Totals: 39 built (35 working, 4 with known issues) · 2 building · 9 can't build

Fixes on top of NX2Apple 1.3.0

Converting game code at build time

#FixGames
1Three new recognisers for indirect jumps (br x18) in the code rewriter: jump_long_tail, tail_call_nop_thunk, jump_guarded_copyHello Kitty Island Adventure, MY HERO ONE'S JUSTICE 2
215-minute timeout on each Metal shader compile, killing the stuck compiler processAny game (Fire Emblem Warriors: Three Hopes hung on two shaders)

Reading game files at build time

#FixGames
3Reader for Marvelous archive.pk / .pkh shader archives (both index layouts, any filename case) and KPKy shader packages (v4 and v6)Fate/EXTELLA LINK (+520 shaders), Fate/EXTELLA: The Umbral Star (+1,555 shaders)
4Unreal pak versions 5–7 (UE 4.19–4.21), version 8 with four compression names (UE 4.22), version 9 with its frozen index (UE 4.25); Windows file-path bug when reading game dataMY HERO ONE'S JUSTICE 2, JUMP FORCE, Demon Slayer: The Hinokami Chronicles
5NS Port Builder (not NX2Apple itself): Windows driver copes with a missing profile_guess function (oodle_packs)Yoshi's Crafted World

Game memory

#FixGames
6Guessed Unreal profiles ask for a 64 GB memory block iOS can't provide; switched to a 5 GB layout (per-game profile edit)JUMP FORCE, MY HERO ONE'S JUSTICE 2, Demon Slayer: The Hinokami Chronicles
7Unreal's built-in memory manager also swapped out for older engine versions, which use a different internal layoutJUMP FORCE
8Memory-setup changes for an older Nintendo SDK build (6.4.0) the automatic matching didn't recogniseMY HERO ONE'S JUSTICE 2
9Older SDK 0.12 memory layout mapped onto the engine's own memory areas (crash creating thread stacks)Fate/EXTELLA: The Umbral Star
10Being tested: Unreal's memory blanked before the game gets it, a likely fix for the static in the soundJUMP FORCE

Nintendo system services the engine stands in for

#FixGames
11Touch-screen setup call (SetTouchScreenConfigurationForNx) answered and ignoredDr Kawashima's Brain Training
12Notification and alarm service (nn::notification)Dr Kawashima's Brain Training
13Play-statistics lookup (QueryApplicationPlayStatistics) answers "never played"Persona 5 Strikers
14Security-certificate loading succeeds (still offline), so the game's online manager gets createdJUMP FORCE

Graphics

#FixGames
15Depth and stencil textures never given a linear layout, which Metal doesn't allowFate/EXTELLA LINK, Fate/EXTELLA: The Umbral Star
16Hand-written shader settings marking the G-buffer output as an integer format, for all 5,800 affected pixel shadersKirby and the Forgotten Land

Fixes 1, 3, 4, 7 and 8 apply to any game with the same engine version or file format; the rest are tied to specific games or SDK builds.


r/NativePortsOniOS • • 10d ago

Zelda ooT on iPhone Duo 🤭

Post image
575 Upvotes

r/NativePortsOniOS • • 7d ago

NXNative + Claude code

533 Upvotes

The link to the actual tutorial I learned from is in the comments
It’s really easy
But you do need a Mac. I’m using my gfs
Can’t stand Macs btw, this has been torture

17 pro max, 16 Plus and IPad M4 is what I use to play these


r/NativePortsOniOS • • 8d ago

ZELDA OOTR iOS Port Released

426 Upvotes

Ran on iPhone 18 Pro
- Very stable 60 fps as long as the phone doesn't overheat
- Below 5 gigs of ram usage, might go up depending on the scenario
- ran on 720p 60

CURRENT FEATURES
- Latest build (V17) is targeting a steady 30 FPS. Still being tested.
- Touch controls with a Zelda-style layout.
- Render scale slider ranging from 0.25x to 1.0x.
- Source code only. No game files or IPAs are distributed. You'll need your own game dump.

HOW IT WORKS

- No CPU emulation: The game's ARM64 code is rewritten ahead of time and runs directly on the iPhone's CPU. System calls are handled by a host layer that acts as a substitute for the Switch OS.

- Graphics: The game's NVN graphics calls are translated to Metal 4. All 42,854 shaders are converted to Metal ahead of time, with 42,853 successfully compiling.

- Memory: The game expects a 9 GB memory pool, while iOS limits an individual app to approximately 8 GB. Guest memory is stored in sparse files instead of entirely occupying RAM, keeping the app's footprint around 4–4.5 GB during gameplay.

- Render scale: Small patches to the game's code allow the host to directly control the final 3D rendering resolution, going below the game's original minimum.

- Frame pacing: The host controls frame duration in whole vsync intervals, keeping game time synchronized with real time at both 30 and 60 FPS.

- Thread scheduling: Game thread priorities are mapped to iOS thread classes, keeping loading and streaming threads away from the performance cores needed for rendering.

- Shader fix: Added a barrier before shared-memory reads in translated shaders, fixing white flashes and screen corruption in the game's upscaler.

PERFORMANCE TUNING

- At 60 FPS, CPU power consumption reaches approximately 3.5 W.
- After around 60 seconds, iOS reduces the CPU clock from 4.2 GHz to approximately 1.7 GHz due to thermal throttling.
- GPU frame time increases from around 13 ms to 16–21 ms.
- Lowering the render resolution barely improves GPU performance. GPU time remains almost identical at 0.25x and 0.6x.
- The next step is identifying fixed GPU costs through per-pass GPU timestamp profiling.
- At 30 FPS, iOS lowers GPU frequency until GPU work fills the available frame time, resulting in frames missing their deadlines by a few milliseconds.

V17 IMPROVEMENTS TARGETING 30 FPS

- Frame buffering to allow CPU and GPU workloads to overlap.
- A two-frame (66 ms) GPU completion window.
- Removed catch-up jumps after late frames to improve frame pacing.

CREDITS

- nxnative by seedds and its contributors.
- The iOS Porting Central Community

LINKS

Releases and source code:
https://github.com/cheemu21/kid-with-sword-remake/releases

V17 improvements PR on nxnative:
https://github.com/seedds/nxnative/pull/1852

This project would not have been possible without the work of the nxnative developers and contributors.


r/NativePortsOniOS • • 5d ago

I made Cartouche, a free and open-source app that turns your iPhone into a console for your nxnative games

Thumbnail
gallery
346 Upvotes

Salut à tous,

nxnative permet de jouer à vos jeux Switch nativement sur iPhone, mais au quotidien, cela implique de jongler avec les fichiers IPA, le sideloading et une signature qui expire chaque semaine.

J'ai donc créé Cartouche, une application qui offre les mêmes sensations qu'une console :

Vos jeux réunis sur une seule étagère, avec leurs jaquettes officielles, jouables à la manette ou via l'écran tactile.

Installez et jouez depuis votre propre espace de stockage : votre Mac, un NAS, un serveur SFTP, un bucket S3 ou l'application Fichiers.

Un bouton Home en pleine partie : retour à la console, le jeu étant mis en pause. Vos sauvegardes sont synchronisées avec votre stockage et vous suivent donc sur un autre iPhone.

L'application se signe, se renouvelle et se met à jour automatiquement, et alloue à vos jeux l'espace mémoire nécessaire, le tout avec un compte Apple gratuit.

Aucun jeu inclus ni lien de téléchargement : vous devez fournir les vôtres, extraits de votre console et compilés avec nxnative.

Captures d'écran, fonctionnalités et instructions d'installation disponibles sur le site web : cartouche-app.github.io/Cartouche

Logiciel libre et open source (AGPL-3.0), basé sur LiveContainer et SideStore, avec Claude Code. Le projet est encore en développement, vos retours sont donc les bienvenus !


r/NativePortsOniOS • • 2d ago

Cyberpunk 2077 on iphone 18PM

303 Upvotes

I got my own Steam Mac copy of Cyberpunk 2077 (2.5 + Phantom Liberty) running natively on my iPhone 18 Pro Max using CyPort by Thijs2004. It's an open-source project that runs the Apple Silicon Mac version of the game directly on iOS, with no emulation and no streaming.

CyPort contains no game files, so you build the app on your Mac from a copy you own, then copy the ~80 GB of game data onto the phone.

Out of the box it booted, but on this phone it had some problems, so I spent a session fixing them:

Controller sticks did nothing. Buttons and the D-pad worked, but stick movement was being silently dropped before it reached the game. That was a small bug in how CyPort batched stick input, and it affected the on-screen sticks too. Fixed.

Crashing seconds after loading into the city. iOS caps a single app at 8 GB even on a 12 GB phone. The game was asking Metal how much GPU memory it could use, getting "8 GB", and reserving almost all of it up front, so iOS killed it as soon as the city streamed in.

Telling the game a smaller GPU budget brought GPU memory from ~6.8 GB down to ~2.5 GB, and it now plays with over 2 GB to spare. I also merged a community fix for some memory leaks (PR #16 on the repo).

Rumble for controllers without motors. Clip-on pads like the OhSnap M-Con have no rumble, so I added an option for the phone's own haptics to stand in (testing now)


r/NativePortsOniOS • • 12d ago

Dragon Ball Fighterz Native

Post image
268 Upvotes

Finally got my all time favorite game running natively!
Working on sparking zero, haven’t seen anyone attempt it yet


r/NativePortsOniOS • • 3d ago

I (effort split: me 1% Claude 99%) built an iOS eShop (aka iShop) to access my NX2Apple built games with ease

256 Upvotes

Continuation from my last post, I built an automation that uses NX2Apple to turn Switch ROMs stored in my NAS into native IPAs. The IPAs are then moved to my iPhone manually, installed via Live Container, and created as Profiles which show as Apps on my Home Screen (here’s the answer to some of you who asked how I side loaded so many apps).

Moving IPAs and installing them take a lot of manual time, so an idea struck me today. Claude helped me turn it into iShop. It’s a simple web hosted on my NAS that allows search, install, download IPA (for troubleshooting purposes). I downloaded a small app for demonstration purposes, but all games are working as shown.


r/NativePortsOniOS • • 12d ago

Mario Kart World iOS

212 Upvotes

Recorded on 18 Pro
- semi stable 60 fps no graphical glitches or missing textures
- runs at about 4GB RAM
I've reached the final stages of development just a little bit more things to do


r/NativePortsOniOS • • 9d ago

Update to: Zelda OOTR iPhone Port

207 Upvotes

Recorded on iPhone 18 Pro
- It runs at a stable 60 fps now with rebuilt fps engine to set custom fps locks without breaking in game physics
- runs at 720p handheld
- game goes bonkers when temperature status reaches serious or above 50 degrees celsius
- will be releasing later or tommorow


r/NativePortsOniOS • • 20d ago Heartwarming

How to compile Switch games into native iOS apps without a Mac.

193 Upvotes

This beginner-friendly guide explains how to use GitHub Actions to build an iOS IPA with nxnative without needing a Mac. You will use Google Drive to host your game files and GitHub to run the build on a cloud macOS machine.
You do not need to know how to code, and you do not need to fork either nxnative source repository. You will create your own GitHub repository containing the build workflow.

1. Games reported to work with nxnative
The following combined list comes from the game lists in the two nxnative repositories. Compatibility varies by iPhone model, game version, and build configuration.
13 Sentinels: Aegis Rim
Absolum
Ace Attorney Investigations Collection
Advance Wars 1+2: Re-Boot Camp
AI: The Somnium Files
AI: The Somnium Files – nirvanA Initiative
Animal Crossing: New Horizons
Animal Well
Astral Chain
Balatro
BALL x PIT
Bayonetta
Bayonetta 2
Bayonetta 3
Big Brain Academy: Brain vs. Brain
Blasphemous
Blasphemous 2
Brain Memory Training Academy
Captain Toad: Treasure Tracker
Catherine: Full Body
Celeste
Cuphead
DARK SOULS: REMASTERED
Digimon Story Cyber Sleuth: Complete Edition
Donkey Kong Country Returns HD
Donkey Kong Country: Tropical Freeze
DRAGON QUEST VII Reimagined
DRAGON QUEST XI S: Echoes of an Elusive Age – Definitive Edition
FINAL FANTASY CRYSTAL CHRONICLES Remastered Edition
FINAL FANTASY RESONANCE
FINAL FANTASY TACTICS: The Ivalice Chronicles
Fire Emblem Engage
Fire Emblem: Three Houses
Ghost Trick: Phantom Detective
The Great Ace Attorney Chronicles
Hades
Hades II
Hollow Knight: Silksong
Hyrule Warriors: Age of Calamity
Kirby and the Forgotten Land
Luigi's Mansion 3
Mario + Rabbids Sparks of Hope
Mario Kart 8 Deluxe
Mario vs. Donkey Kong
Metroid Dread
Monster Hunter Rise
Monster Train 2
NieR:Automata The End of YoRHa Edition
OCTOPATH TRAVELER
Octopath Traveler 0
Octopath Traveler II
Paper Mario: The Thousand-Year Door
Patrick's Parabox
Persona 5 Royal
Pikmin 4
Pokémon Brilliant Diamond
Pokémon Legends: Z-A
Pokémon Scarlet
Pokémon Shield
Pokémon Sword
Portal
Raging Loop
Return of the Obra Dinn
Rhythm Heaven Groove
ROMANCE OF THE THREE KINGDOMS 8 REMAKE
Sea of Stars
SHIN MEGAMI TENSEI V: Vengeance
Silver Pines
Stardew Valley
STEINS;GATE RE:BOOT
Super Mario 3D World + Bowser's Fury
Super Mario Bros. Wonder
Super Mario Galaxy
Super Mario Galaxy 2
Super Mario Odyssey
Super Smash Bros. Ultimate
Taiko Risshiden V DX
The Legend of Zelda: Breath of the Wild
The Legend of Zelda: Echoes of Wisdom
The Legend of Zelda: Link's Awakening
The Legend of Zelda: Tears of the Kingdom
Unicorn Overlord
Xenoblade Chronicles 2
Xenoblade Chronicles 3
Yoshi's Crafted World
WARNING: Any game not on this list is not guaranteed to work. Even games on the list may fail to build or run correctly on your particular device. This is a list of reported titles, not a guarantee that every game is compatible.
Use game dumps and keys you are legally entitled to use.

2. What you need
Before starting, gather these items:
A GitHub account: https://github.com/
A Google account with Google Drive: https://drive.google.com/
A legally obtained Nintendo Switch game dump, normally an .nsp or .xci file, or an archive containing one.
The matching prod.keys file.
The matching game update, if applicable.
The matching DLC files, if applicable.
The universal nxnative workflow YAML: https://pastebin.com/XbJt5p3c
You do not need a Mac. GitHub Actions provides the cloud build machine.
Keep your keys private. Do not post them publicly or share them with other people. Anyone with access to your keys may be able to access protected game content.

3. Upload your files to Google Drive
Google Drive will host the files so the GitHub workflow can download them during the build.
Step 1: Upload the files
Open https://drive.google.com/ and sign in.
Click New.
Choose File upload.
Select your base game file and wait for it to finish uploading.
Repeat for your prod.keys file.
Upload the game update and DLC files if you have them and intend to use them.
Keep each file separate so you can identify which link belongs to which file.
Step 2: Set sharing permissions
Repeat these steps for each file you want the workflow to download:
Find the file in Google Drive.
Right-click it, or tap its three-dot menu.
Select Share or Manage access.
Under General access, change Restricted to Anyone with the link.
Leave the permission set to Viewer.
Click Copy link.
Click Done.
Repeat for the base game, keys, update, and DLC files as applicable.
Google’s sharing instructions: https://support.google.com/drive/answer/2494822
Privacy warning: Anyone with these links may be able to access the files. Do not post the links publicly. After the build, consider changing the files back to Restricted.

4. Create a GitHub account
If you already have a GitHub account, skip to Section 5.
Open https://github.com/.
Click Sign up.
Enter your email address and create a password.
Complete the verification steps.
Verify your email if requested.
Sign in to GitHub.
You do not need a paid plan just to try this workflow, although usage limits and runner availability can vary.

5. Create a blank GitHub repository
A repository is where you will store the workflow file and its private settings.
While signed in, open https://github.com/new.
Enter a repository name, such as nxnative-ipa-builder.
Choose Private or Public. Private is a sensible default for a personal build project.
You can leave the description blank.
Do not upload game files or keys to the repository.
Click Create repository.
That’s it. You do not need to fork either nxnative source repository. The workflow checks out the selected source repository automatically when it runs.

6. Add your Google Drive links as GitHub secrets
GitHub secrets store the links privately so you don’t have to write them directly into the workflow.
Open your new repository.
Click Settings.
In the sidebar, find Secrets and variables.
Click Actions.
Under Repository secrets, click New repository secret.
Enter the secret name exactly as shown below.
Paste the matching Google Drive sharing link into the Secret field.
Click Add secret.
Required secrets
Secret name
What to put in it
Game_URL
Google Drive sharing link for the base game
Keys_URL
Google Drive sharing link for your prod.keys file
Optional secrets
Secret name
What to put in it
Update_URL
Google Drive sharing link for the game update
DLC_URL
Google Drive sharing link for the DLC
Only add the update and DLC secrets if you have the corresponding files and want to use them.
Important: The names must match exactly, including capitalization and underscores. Game_URL is not the same as game_url.
Do not paste the contents of your keys file into a secret. The workflow expects a link from which it can download the file.
GitHub’s instructions for repository secrets: https://docs.github.com/en/actions/how-tos/write-workflows/choose-what-workflows-do/use-secrets

7. Download the universal workflow YAML
The YAML file contains the instructions that tell GitHub how to build the IPA.
Open this link: https://pastebin.com/XbJt5p3c
Find the full YAML text.
Copy the entire file, from the first line to the last line.
Keep it ready to paste into GitHub.
Do not paste the YAML into Google Drive, the repository’s README, or a terminal. It must be saved as a GitHub Actions workflow.

8. Add the workflow to your repository
Return to your GitHub repository’s main page.
Click Add file.
Select Create new file.
In the filename field, enter this exact path:
.github/workflows/build.yml
GitHub will create the required folders automatically.

Click inside the large editor area.
Paste the entire YAML you copied from Pastebin.
Check that you included the beginning and end of the file.
Click Commit changes.
If prompted, confirm the commit to your default branch, normally main.
You should now have a workflow file at .github/workflows/build.yml.
GitHub requires workflow files to be inside .github/workflows/. A manually triggered workflow must be available on the default branch to be run from the Actions interface.

9. Put the Google Drive links into the correct secrets
Now connect the files you uploaded to the workflow.
For example:
Game_URL gets the sharing link for your base game file.
Keys_URL gets the sharing link for your prod.keys file.
Update_URL gets the update file’s sharing link, if applicable.
DLC_URL gets the DLC file’s sharing link, if applicable.
To create or change a secret:
Open Settings → Secrets and variables → Actions.
Select the secret you need to create or update.
Paste the appropriate Google Drive link.
Save it.
GitHub won’t show you the full value of an existing secret after saving it, so double-check the link before you click Add secret.
What if the Google Drive link doesn’t work?
The workflow needs to download the actual file, not a page that asks you to sign in. Make sure:
The sharing permission is set to Anyone with the link — Viewer.
You copied the link for the correct file.
The file is fully uploaded.
Google Drive isn’t blocking the download or requiring an extra confirmation.

10. Run the build
Open your repository.
Click the Actions tab.
Select the workflow from the left sidebar.
Click Run workflow.
Select the branch containing your workflow, usually main.
Choose the device option.
The workflow provides these intended build paths:
iPhone 15 or older (BC fallback): selects the pinned BC-texture fallback build.
iPhone 15 Pro/Pro Max or newer (standard): selects the standard upstream build.
These are build-path choices, not guarantees that every game will work on every device. If you aren’t sure which option to choose, consult the compatibility information for your device and build.
If the workflow asks for a profile ID override, leave it blank or at its default unless you know you need to override automatic detection.
Click Run workflow to start the build.
GitHub will allocate a runner and execute the workflow. The build can take some time while dependencies are installed, files are downloaded, and the game is compiled.

11. Monitor progress and troubleshoot errors
After starting the workflow:
Stay on the Actions tab.
Click the new workflow run.
Click the job to open its detailed log.
Watch each step as it runs.
A green check mark means the workflow completed successfully. A red X means something failed.
Common problems
A. Google Drive download fails
Possible causes:
The file is still Restricted.
The URL was copied incorrectly.
Google Drive requires a confirmation that the workflow cannot handle.
The file is too large or Google Drive has temporarily limited downloads.
Check the sharing settings and confirm that the secret points to the correct file.
B. The keys file is missing or invalid
Check that Keys_URL points to the actual keys file and that the file is valid and compatible with your game dump.
C. The game file cannot be detected
Check that the game dump downloaded completely and is in a supported format. If the workflow cannot identify the title ID, the log may contain a detection error.
D. The build fails while installing dependencies or compiling
Read the first meaningful error in the log. Later errors may simply be consequences of the first failure. The standard upstream source and pinned fallback source may also change or behave differently.
E. The build succeeds, but the game doesn’t run properly
A successful build does not guarantee compatibility. Check whether the game appears in the reported game list, whether you chose the intended device option, and whether the game dump, update, DLC, and keys match.
Use an AI assistant to diagnose errors
If you’re stuck, copy the relevant error message and surrounding log lines into an AI assistant.
You can use this prompt:
I’m trying to build an iOS IPA using nxnative and a GitHub Actions workflow. The build failed at the following step. Please identify the first actual error, explain what caused it, and give me step-by-step instructions to fix it. Don’t assume the build succeeded if the logs say otherwise.

[Paste the relevant log lines here.]
Include the failed step’s name and the device option you selected.
Remove sensitive information before sharing logs. Check for Google Drive URLs, tokens, private repository information, and other credentials. Never upload your keys file or game dump to an AI assistant just to diagnose an error. Usually, the error message and nearby log lines are enough.

12. Download the finished IPA
Once the workflow completes successfully:
Open the completed run under the Actions tab.
Scroll down to the Artifacts section on the run summary page.
Find the IPA artifact. Its name may identify the build type, such as BC-Fallback or Standard.
Click the artifact name to download it.
GitHub will normally download the artifact as a ZIP file.
Open the ZIP and extract the .ipa file.
You now have the IPA produced by the workflow. You can proceed with your usual iOS sideloading method.
If there is no IPA artifact, check the workflow log for the first failed step. A build that fails before the upload step will not produce the expected artifact.

Final checklist
☐ Game dump and matching keys prepared.
☐ Update and DLC prepared, if applicable.
☐ Files uploaded to Google Drive.
☐ Required files shared with the appropriate link access.
☐ GitHub account and repository created.
☐ Required secrets added with exact names.
☐ Universal YAML saved as .github/workflows/build.yml.
☐ Workflow committed to the default branch.
☐ Correct device option selected.
☐ Build completed successfully.
☐ IPA artifact downloaded and extracted.
That’s it! Create your repository once, add your own secrets, and use the workflow whenever you want to build another compatible game.
Remember that this is a community workflow, not a guarantee that every game will build or run correctly on every device. If a build fails, save the relevant log lines and troubleshoot the first error before trying again.


r/NativePortsOniOS • • 6d ago

Zelda OOTR iOS Port Update:

158 Upvotes

Ocarina of Time — X9 Version (Previously V26)

New: Frame Generation

- Set Frame Rate to 30 FPS, then enable Frame Generation in the launcher's Game section.
- The game runs at 30 FPS while the display shows 60 FPS. MetalFX generates an intermediate frame between every two actual frames, giving you a smoother 60 FPS experience with roughly the workload and heat of 30 FPS.
- There is a slight increase in input latency compared to native 60 FPS, but it's still more responsive than standard 30 FPS. The display updates every ~17 ms instead of ~33 ms.

Fixes Since X6 (First Frame Generation Build)

- Reduced GPU workload: Intermediate frames are now generated from the displayed image (2352×1080) instead of the game's full-resolution 3136×1440 texture. This reduces the frame generation workload by approximately 44%, addressing the GPU overhead that previously caused frame drops.
- No more flickering during frame drops: Frame generation temporarily pauses when the game drops frames, displaying actual frames instead before automatically resuming.
- More consistent 60 FPS output: X8 paused frame generation unnecessarily on approximately 37% of frames. X9 now only pauses when actual frame drops occur.

Recommended Settings

- Enable Real-Time Presenting and Deadline Boost to help keep the game running on the performance cores, especially as the phone heats up.
- For additional performance headroom in demanding areas, disable Wide View or lower the Render Scale.
- Keep at least 15 GB of free storage on your device.

Known Issues

- Camera jitter when using frame generation. This may be addressed in X10.

Notes:
- All commits are pushed to fork: https://github.com/cheemu21/kid-with-sword-remake
- New commits will also be pushed to the nxnative pull requests on X10: https://github.com/seedds/nxnative

Acknowledgements:
This fork's Ocarina of Time builds also carry work by these people (what each made):
seedds (nxnative itself);
ChiefSZ13 (the game's profile and bring-up);
Pedro Nascimento (lunks), Xipzer, nanotchec, Adrian Smith, Romen Adama Caetano Ramírez, Travis (travislikestocode);
vladbondarenko97, uncraftablexd, mmkzer0, Nimesh Ambepitiya, MetaIX, TheGoldfish11, Oliver Ames, David Padron-Harris, zatteogit, tut;
the author of the oot2 branch.


r/NativePortsOniOS • • 16h ago

NussaNX Port Switch Game on Directly on Iphone/Ipad

150 Upvotes

NusaNx — On-Device Switch to Native iOS & Apple Metal Showcase

Watch *Celeste* running at a **stable 60 FPS** on iPad — built completely on-device with Apple Metal Showcase

Watch *CeNusaNx — On-Devic- Decrypts yourice Swit/usaNx — using your ownvice Switch t& statically rewrites ARM64 code
- Compiles Switch NVN / GL shaders to*Celeste* running at a **stright inside the app
- Auto-extracts cover art & embeds iOS Home Screen icons (`com.nusanx.<Game>`)
- Multi-Style Studio UI (*Switch Neon*, *Cyber OLED*, *Midnight Pro*, *Solar Forge*) + built-in SHA-256 IPA check
ur `.nsp` / `.xci`Preparing first public releases!ive iOS & App

https://github.com/optimalabsistem/NusaNX Apple Metal Showcase

https://discord.gg/ebmF82guu


r/NativePortsOniOS • • 7d ago

iPhone 18 Pro Max running OOTR using HookLink at 60~fps

149 Upvotes

r/NativePortsOniOS • • 1d ago

HookLink X1 is Out!!

124 Upvotes

HookLink X1
HookLink X1 is a new engine and a redesigned launcher. The engine is the latest nxnative with HookLink's own fixes and the best of cheemu21's kid-with-sword-remake on top, and every setting both projects offer is in the launcher.
Before you update
The engine compiles the game's shaders differently again, so the first build after updating compiles every shader (about 30 minutes on an M-series Mac), and the first start on the phone prepares the game's pipelines behind the progress screen for a while. Leave the phone plugged in; later starts take seconds.
A new launcher
Play shows the game, Play and a Resolution dial in the middle of the left side: Coolest, Cool, Balanced, Sharp and Sharpest. With Dynamic resolution on it reads Auto; moving it fixes a size.
Quick settings on the right, each with a line on what it does: Frame rate, Frame generation, Cool mode, Potato mode, Wide view and the Ocarina mic.
Frame generation and the frame rate mode are one choice: turning frame generation off moves 60 + frame generation to 60 fps, and on again moves back.
Settings has Game, Controls and Performance as tabs, with real switches and sliders. Extras is a set of cards that say what each does.
The title bar says HookLink X1, and nothing sits under the Dynamic Island on either side.
New settings
Render scale, 25 % to 100 % (it never worked for Ocarina before: the game's render-scale hook was missing).
Cool mode: half the 3D resolution and smaller in-between frames, for less heat and longer battery. It starts on for iPhones with less than 10 GB of memory.
Potato mode: the lightest the game can run, at 25 % resolution with memory savers, for older iPhones. The settings it sets are locked while it is on.
Light movies: the title and opening movies skip a sharpening step that kept the title screen under 60 fps. A slightly softer movie; turn it off for the movies as made.
Microphone: play the ocarina by humming or whistling.
Faster and steadier
About 11 % less CPU work per object drawn, and far fewer hitches after loading an area (texture tables reused instead of made 16 times a frame; from kid-with-sword-remake).
Less GPU memory at scene changes: the old scene's textures are no longer made again (about 2.5 GB at the house-to-forest change). This is aimed at the crashes when loading a save on iPhones with less memory.
Frame generation pauses in the pause menu, where it could hang the GPU, and is switched off on iPhones whose GPU can't make in-between frames.
nxnative's newest work, including a faster start (the pipeline archive opens 3 to 6 times faster) and steadier frame pacing.
Known issues
Hyrule Field can still drop under 60 fps when the GPU falls behind or the phone is warm. 30 fps + frame generation, Cool mode or a lower Resolution help there.

https://github.com/dsi-hub/HookLink/releases/tag/v2.0


r/NativePortsOniOS • • 8d ago

gta v native port on iPhone 11 Pro max very stable

120 Upvotes

iPhone 11 Pro Max

4gb ram

A13 Bionic Chip

iOS 27.0.1


r/NativePortsOniOS • • 1d ago

I made a native iOS port of Black Ops 2

112 Upvotes

I ported Black Ops 2 to iOS. It runs natively on the phone. This video is a real online match on an iPhone 17 Pro Max.

Source and build guide: https://github.com/Alextechgamer/bo2-ios

No IPA, you build it yourself with a Mac and your own Steam copy.

EDIT https://github.com/Alextechgamer/bo2-ios/blob/main/docs/INSTALL.md#without-a-mac Here's how to make the ipa without a Mac


r/NativePortsOniOS • • 2d ago

Ocarina of Time Remake running on 4th gen Apple TV (2GB RAM Limit)

110 Upvotes

Took a little bit of effort customizing nxnative work for Mac / iPhone, but it is possible to get Ocarina of Time remake working on the new Apple TV (A19 processor with 8GB of RAM and 128GB storage, but tvOS apps are limited to only 2GB). Commented in r/decomps about the changes codex made here: https://www.reddit.com/r/decomps/s/Xb23Jvm4dX & will look to get them as PRs for nxnative in the next few days.


r/NativePortsOniOS • • 11d ago

Fallout New Vegas Ported to iOS

110 Upvotes

Fallout: New Vegas ported to iOS with optimized mobile friendly touch controls and gyro! This is running on an iPhone 16 Pro Max. 
Performance is generally decent with some slowdowns in settlement areas.

EDIT: forgot the GitHub link. You can sideload the ipa and bring your own data files. https://github.com/arjunyerevan95-dot/FNV-iOS-Shim

UPDATE: adding in support for other builds of the game today - build 23 will take care of this for compatibility


r/NativePortsOniOS • • 4d ago

Cyberpunk 2077 running locally on my iPhone 17 Pro Max

106 Upvotes

Swift runtime + setup: https://github.com/eugenebokhan/cyberpunk-ios

Needs a Mac, a paid developer team and your own Mac App Store copy. Clip from an earlier Backbone build; touch controls are now included.