# seedds/nxnative

> nxnative is a tool for playing Nintendo Switch and Switch 2 games that you own natively on Apple silicon Macs, iPhone and iPad. A build script packs your game files and your prod.keys into a Mac app or an unsigned IPA that you install yourself. The game's own code runs directly on the Apple chip, with Switch graphics rebuilt on Metal, and the project's primary language is Python with native code in C, C++, C# and Objective-C.

Source: https://github.com/seedds/nxnative
Indexed: commit 804809c on 2026-11-10 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: Library
- Language: Python
- Stars: 16,036 at index time
- License: MIT
- Code health: 6.3/10, Fair
- Last commit: 2026-11-10
- Contributors: 5

## Install

From the README: https://github.com/seedds/nxnative#install

Clone the nxnative repository.
    git clone https://github.com/seedds/nxnative.git

Move into the nxnative folder.
    cd nxnative

Install the tools needed for the build.
    brew install xcodegen zstd glslang

Build the IPA with your game folder and your prod.keys.
    python3 scripts/build_ipa_from_nsp.py ~/Games/MarioWonder -k ~/keys/prod.keys

## How it works

Input enters through scripts/build_ipa_from_nsp.py, which takes a folder of game files or a .nup file and produces an IPA or a Mac app in the game's folder. The dm/tools/nx_extract project is a C# tool with a LibHac dependency, and its Program.cs is an entry point of the repository. The dm/gfx/nvn directory runs the Nintendo Switch NVN graphics API on Metal, and guest NVN calls enter through its NVN entry file. The dm/host directory runs the game inside a host process on macOS and iOS, answering the game's operating system calls and passing controller, touch, sound and frame-rate data between the game and the platform, with dm/host/main.c as its entry point. The dm/games directory holds per-game profiles that set the port's options and fixes for each supported title.

- dm/gfx/tools/dmsh_xlate/Program.cs: entry point
- dm/host/main.c: entry point
- dm/ios/Sources/main.m: entry point
- dm/tools/nx_extract/Program.cs: entry point
- .github/ISSUE_TEMPLATE/bug_report.yml: central file
Modules: dm, scripts. 1,658 files, 308,177 lines, 36,574 symbols.

## Code health

- Score: 6.3/10 (Fair)
- Rank: #202 of 4,000+ indexed repos
- Hotspots: dm/gfx/nvn/nvn_mtl.m, dm/gfx/tools/dmsh_build.py, dm/gfx/nvn/hle_nvn.c, dm/gfx/tools/shader_split.py, dm/host/hle_codec_video.c
- Lowest file: dm/gfx/nvn/nvn_geometry.inc
- Dead code: 76 findings

## Maintenance

- Last commit 2026-11-10, 500 commits
- 5 contributors, bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/seedds/nxnative/security

## More

- Page: https://repowise.dev/repo/seedds/nxnative
- Ask this codebase: https://repowise.dev/repo/seedds/nxnative/chat
- Docs: https://repowise.dev/repo/seedds/nxnative/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/seedds/nxnative
