# ly05010419/macnativegames

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/ly05010419-macnativegames).**

_How this analysis was created: the description and tags below were written by an AI model that read this project's README and public documentation pages; stars, license and language come straight from the GitHub API. The model does not read the source code._

7,262 stars · 1,071 forks · C · MIT

## Links

- GitHub: https://github.com/ly05010419/MacNativeGames
- awesome-repositories: https://awesome-repositories.com/repository/ly05010419-macnativegames.md

## Topics

`apple-silicon` `arm64` `breath-of-the-wild` `game-port` `ios` `ipados` `macos` `metal` `native-port` `tears-of-the-kingdom` `ultrawide` `zelda`

## Description

MacNativeGames is a toolchain and runtime for running console and PC games natively on Apple silicon Macs, iPhones and iPads. It takes a game dump and console keys that you supply and, through a single build script, produces a Mac app or an unsigned iPhone and iPad package. Switch titles run by executing the game's own ARM64 code directly rather than through an emulator, with only the instructions the operating system requires being rewritten. A small built-in host answers the game's system calls, so original console firmware is not needed.

Graphics are handled by a layer that reimplements the Switch NVN interface on Apple's Metal API and translates the game's compiled shaders to Metal ahead of time, aiming to reproduce the original rendering faithfully. The project also includes a static recompiler that converts Windows PC games ahead of time to arm64, drawing with Metal so they run on the same Apple devices. Early support for Switch 2 titles is included through the same runtime.

Around that core are tools for reducing shader stutter: shader states seen during play can be recorded, submitted through GitHub using only identifiers, and merged into a shared list that later builds precompile. Players can choose between SMAA and FXAA and set each one's quality separately. A VR mode renders the game on a Mac for each head pose and streams it over USB-C to a Quest 3 headset with six-degrees-of-freedom tracking.

Supported targets are Apple silicon Macs, with output up to native 4K, and newer iPhones and iPads running iOS 26 or later. A step-by-step install guide is written so an AI coding assistant can place files, run each build stage and fix common errors.

## Tags

### Game Development

- [Native Game Ports](https://awesome-repositories.com/f/game-development/native-game-ports.md) — Runs Switch games' own ARM64 code directly on Apple silicon without an emulator, rewriting only operating-system-dependent instructions. ([source](https://github.com/ly05010419/macnativegames#readme))
- [Native Recompilations](https://awesome-repositories.com/f/game-development/retro-game-emulation/native-recompilations.md) — Ships a static recompiler that converts Windows PC games ahead of time to arm64, rendering with Metal on Apple devices.

### Operating Systems & Systems Programming

- [Native Console Game Runtimes](https://awesome-repositories.com/f/operating-systems-systems-programming/native-console-game-runtimes.md) — Executes console game code directly on Apple silicon without emulation, rewriting only the instructions the operating system requires.
- [Graphics API Translation Layers](https://awesome-repositories.com/f/operating-systems-systems-programming/graphics-api-translation-layers.md) — Reimplements the Switch NVN graphics interface on Metal and translates compiled shaders ahead of time to reproduce original rendering.
- [Console System Call Hosts](https://awesome-repositories.com/f/operating-systems-systems-programming/console-system-call-hosts.md) — Answers a Switch game's system calls with a small built-in host, removing the need for original console firmware.
- [Firmware System Call Translation](https://awesome-repositories.com/f/operating-systems-systems-programming/system-call-interception/firmware-system-call-translation.md) — Answers the game's operating system calls with a small built-in host, removing the need for original console firmware. ([source](https://github.com/ly05010419/macnativegames#readme))

### DevOps & Infrastructure

- [Direct Guest Code Execution](https://awesome-repositories.com/f/devops-infrastructure/deployment-management-strategies/execution-platforms-and-targets/hardware-profile-deployments/arm64-deployment-profiles/native-arm64-builds/direct-guest-code-execution.md) — Executes the game's own ARM64 code directly on Apple silicon, rewriting only the operating-system-dependent instructions instead of emulating.
- [Game Build Packaging](https://awesome-repositories.com/f/devops-infrastructure/distribution-packaging/game-build-packaging.md) — Turns a user-supplied game dump and console keys into a Mac app or unsigned iPhone and iPad package with one build script. ([source](https://github.com/ly05010419/macnativegames#readme))

### Graphics & Multimedia

- [Graphics API Translation](https://awesome-repositories.com/f/graphics-multimedia/graphics-api-translation.md) — Reimplements the Switch NVN graphics interface on Apple's Metal API and translates shaders to reproduce original rendering faithfully. ([source](https://github.com/ly05010419/macnativegames#readme))
- [Metal Graphics Backends](https://awesome-repositories.com/f/graphics-multimedia/metal-graphics-backends.md) — Reimplements the console graphics interface on Apple's Metal API so games draw faithfully and quickly on Mac, iPhone and iPad.
- [Shader Caching](https://awesome-repositories.com/f/graphics-multimedia/graphics-engines-rendering/shaders/cross-platform-shader-compilers/shader-caching.md) — Records shader states seen during play, merges them into a shared list and precompiles them in later builds to avoid stutter. ([source](https://github.com/ly05010419/macnativegames#readme))
- [Tethered Headset Game Streaming](https://awesome-repositories.com/f/graphics-multimedia/streaming-distribution/streaming-broadcasting/media-streaming/tethered-headset-game-streaming.md) — Renders the game on a Mac for each head pose and streams it over USB-C to a Quest 3 with six-degrees-of-freedom tracking.

### Programming Languages & Runtimes

- [Ahead-Of-Time Compilers](https://awesome-repositories.com/f/programming-languages-runtimes/compiler-interpreter-internals/compiler-toolchains/execution-mode-engines/ahead-of-time-kernel-compilation/ahead-of-time-compilers.md) — Recompiles Windows game binaries to arm64 ahead of time instead of translating at runtime, so they run at native speed on Apple chips.
- [Shader Translation](https://awesome-repositories.com/f/programming-languages-runtimes/intermediate-representation-translation/shader-translation.md) — Translates the console's compiled shaders into Metal shader code ahead of time while preserving the original visual output.
