# Mush8 brings Mario Kart 8 Deluxe to Apple devices: what setup involves

Canonical: https://playable.wtf/guides/mush8-mario-kart-8-deluxe-apple/

Written: 2026-10-17

Mush8 is C22’s native Apple project for Mario Kart 8 Deluxe. It requires building with your own game dump and keys; it is not a browser game or a Mario Party port.

## What the project changes

[Mush8](https://playable.wtf/games/mush8/) adapts Mario Kart 8 Deluxe for Apple hardware. Its approach patches the game’s ARM64 code and supplies replacements for Switch system services, with graphics translated to Metal. On iOS, the game code becomes part of the app during the build.

That makes preparation central to the experience: a project repository is the starting point, not an instantly playable web page. [Super Mario Bros. Wonder Recomp](https://playable.wtf/games/super-mario-wonder-recomp/) is a separate project for a different game, with its own platform work and requirements.

## Prepare the matching data

The README asks for your own `prod.keys`, base-game `.nsp` and the **4.0.1 update**  `.nsp`. Booster Course Pass data and firmware are optional additions. Use only files you are authorized to obtain and use.

Keep the base game and update together as a matched set. An archive from Mario Party, the original Wii U Mario Kart 8 or another title cannot substitute for Mario Kart 8 Deluxe. Renaming an archive does not change its contents.

## Choose Mac or iOS before building

The creator documents an Apple Silicon Mac, macOS 14 or later and Xcode 26 or later for preparation. The iOS route adds signing or IPA installation and device-memory requirements; check the current README before committing to a build.

The project’s `build.sh` asks which platform to prepare and can install missing development tools. Read its steps before running it. This is a local software build, not a normal browser launch.

Its diagnostics distinguish missing keys or the wrong update from Xcode signing errors, a locked device and insufficient disk space. Follow the message for the failing step. Repeating game extraction will not fix a signing identity problem, and changing a signing setting will not supply missing game data.

## Controls and multiplayer boundaries

Mush8 documents controllers and iOS touch input. Multiplayer choices include local LAN, nearby wireless play and internet LAN-play servers. Nintendo’s online service is unavailable; the launcher’s Online choice refers to LAN-play.

Agree on the intended mode before inviting friends. Someone expecting Nintendo matchmaking is expecting a different service. Check the current project limitations before planning a group session, especially when mixing devices or installation methods.

For broader context, the [project-label guide](https://playable.wtf/guides/ports-decompilations-emulators-explained/) explains why native execution, system-service replacement and game-data requirements can coexist.

## Project reading

- [C22 · Mush8 requirements and features](https://github.com/c22dev/mush8#readme)
- [Mush8 · build assistant and diagnostics](https://github.com/c22dev/mush8/blob/HEAD/build.sh)