ly05010419 /MacNativeGames
Play your own Tears of the Kingdom and Breath of the Wild natively on Apple silicon Mac, iPhone and iPad. Not an emulator: the game's ARM64 code runs directly, NVN rebuilt on Metal. Bring your own game.
★ 7,906⑂ 1,174👁 30⑃ 555● 1,648▤ 2
+69
日增长
+556
周增长
7,906
stars
1,174
forks
30
watchers
555
prs
1,648
issues
2
releases
README
MacNativeGames A technical exploration: can a Nintendo Switch game's NVN graphics be ported to Metal? Tested with your own copies of Tears of the Kingdom and Breath of the Wild on Mac, iPhone and iPad, and of Ocarina of Time (Switch 2) on the Mac. Not an emulator: the game's own ARM64 code runs directly on Apple chips. English | 中文 English Legal You must own the game. Use this project only with games that you bought, and with keys and system files dumped from your own Nintendo Switch. This is an independent, non-commercial project. It is not affiliated with, endorsed by, or sponsored by Nintendo. The Legend of Zelda and Nintendo Switch are trademarks of Nintendo. The repository contains no game content and distributes none: no game program, art, text, audio, shaders or keys. Everything the game needs is made on your own computer from your own files when you build the app. The app you build contains the game, so it is for your own use only; do not share it. What the repository does hold is the information needed to make the port work: the patch code, the addresses and hashes used to check your files, and the shared shader list, which names shaders and bind states but contains no shader code. Apple, Mac, iPhone, iPad, Apple Vision Pro and Metal are trademarks of Apple Inc.; this project is not affiliated with Apple. Other game titles and trademarks named here belong to their respective owners. Whether dumping games, keys and system files is legal depends on where you live; check and follow your local laws. Issues and pull requests that contain or ask for game files, keys or firmware will be deleted. About This project is a technical exploration, mainly feasibility experiments and analysis. The Nintendo Switch is an ARM system (an ARM64 CPU in NVIDIA's Tegra X1), and Apple chips are ARM64 as well, so we want to test whether its games can, technically, be ported to Apple chips. It started from one question: can the NVN graphics a Switch game was written for be rebuilt faithfully on Apple's Metal, and can the game's own ARM64 code run directly on Apple chips without an emulator? Tears of the Kingdom and Breath of the Wild are the test cases, because they push the graphics API hard. The repository records the experiments, measurements and findings along the way; it is a study of the technique, not a game distribution. It does not encourage piracy: use only your own game data, dumped from a game you bought and from your own Switch, never game files, keys or firmware downloaded from the internet or obtained from anyone else. How it works: bring your game file (XCI or NSP) and your prod.keys; one script builds a Mac app or an unsigned iPhone/iPad IPA. The game's own ARM64 code runs directly on Apple chips (rewritten where the operating system requires it), the Switch system services are answered by a small host, and the game's NVN graphics are rebuilt on Metal. The iOS build requires iOS/iPadOS 26 and iPhone 14 or newer; Tears of the Kingdo
Top issues
#2107Ocarina of Time (Mac): two mesh pipelines crash the Metal compiler service (XPC_ERROR_CONNECTION_INTERRUPTED), so update_runtime can never rebuild the pipeline archive on M1 Max9 comments · 2026-11-11#132Gamepad 8BitDo 2C Bluetooth patch -- now it works8 comments · 2026-10-21#2103Ocarina of Time (Mac): the picture turns white during an NPC dialog while audio keeps playing; the picture never returns (M1 Max)6 comments · 2026-11-11#1231TOTK 1.4.3 on macOS 27.2: key 5 (MetalFX Temporal anti-aliasing) does not anti-alias. The jitter is never applied, and even with it MetalFX V4 passes a 1:1 frame through.6 comments · 2026-10-28#2113OoT: host memory grows unbounded during long play (~3 GB/h); watchdog self-exit at the 24 GB cap5 comments · 2026-11-11#2011OOT build fails with "unsupported RomFS image" after pulling latest main5 comments · 2026-11-10#739卓拉领地前瞭望台闪退5 comments · 2026-10-25#2112时之笛更新 131072 在 M1 Max 上反复闪退(pool_inputs_wait abort、gpu_hang_guard)4 comments · 2026-11-11
Discussions
#2006MacNative Mods 0.2.5 beta — a standalone mod manager for MacNativeGames0 comments · 2026-11-10#1948Withdrawn0 comments · 2026-11-08#1790TOTK 1.4.3 on M4 iPad Pro and M4 Pro MacBook Pro0 comments · 2026-11-05#1333A mod manager for MacNativeGames ports1 comments · 2026-10-30#1147UI0 comments · 2026-10-28#917Ability to lock into 60FPS0 comments · 2026-10-26
Latest release
MacNativeGames 2026-10-25 v2026.10.25 2026-10-25First tagged snapshot of MacNativeGames. There is no app to download: this release is the source. Build the app on your own Mac from your own game files as the README explains. The repository contains no game content, keys or shaders. Supported - Tears of the Kingdom 1.0.0, 1.2.1, 1.4.3: Mac, iPhone and iPad - Breath of the Wild 1.6.0 and 1.9.0: Mac; 1.6.0 also on iPhone - Requires an Apple silicon Mac with macOS 26; iPhone / iPad builds need iOS / iPadOS 26 and iPhone 14 or newer Highlights (October 17 – 25) - Breath of the Wild 1.6.0 on the iPhone: full screen, add-on content, saves co
相关报道 (6)
blog.csdnMacNativeGames 公共着色器清单指南:26,832 个变体如何由玩家众筹消灭卡顿,你的游戏也能做贡献2026-10-20blog.csdnMacNativeGames 版本选择终极指南:一个 --update 合并更新,1.0.0 到 1.4.3 存档安全迁移全解2026-10-19新浪财经苹果Mac也能玩《塞尔达传说:王国之泪》!M4 MacBook Air跑出90帧2026-10-19凤凰网科技开源项目让《塞尔达传说:王国之泪》原生运行于Apple Silicon,苹果M4 MacBook Air稳定90帧2026-10-21新浪网【《王国之泪》已可在苹果M系列芯片原生运行】开源项目MacNativeGames 近期实现了让《塞尔达传说:王国之泪》直接运行在Apple Silicon 上。它利用两端同属ARM64 架构的特性绕开传统CPU 模拟,并将图形指令转译至Metal 4。在 M4 芯片设备实测中,着色器预处理2026-10-20Notebookcheck CN《塞尔达传说:王国之泪》Mac 移植版运行帧率达 90 fps,超越 Switch 2 和 PC 竞品2026-10-19
News & coverage (7)
XDA Developers on MSNNintendo Switch games can now run on Mac thanks to a Wine-like tool, and 85 titles are already compatible2026-10-27TweakTownZelda: Tears of the Kingdom native port hits Apple Silicon MacBooks, runs at 90 FPS on an M4 Air2026-10-20NotebookcheckZelda Tears of the Kingdom für Mac bietet 90 FPS und übertrifft Switch 2 und PC-Version2026-10-18TweakTownNintendo Switch games can now run natively on macOS, no emulator required2026-10-25NotebookcheckZelda: Tears of the Kingdom Mac port runs at 90 fps, topping Switch 2 and PC rival2026-10-19XDAFor once, Mac gets a game first as Zelda: Tears of the Kingdom now runs natively on Apple's M4 chip2026-10-18TechPowerUpPS4 Exclusive Driveclub Now Runs Natively on PC Through New Recomp2026-10-18