# Mario Kart 8 Deluxe — Mush8

Canonical: https://playable.wtf/games/mush8/

Project ID: project:mush8

Build C22’s native Mario Kart 8 Deluxe port for iPhone, iPad and Apple Silicon Mac.

## About this version

Mush8 brings Mario Kart 8 Deluxe to Apple devices with touch or controller input. C22’s project translates Switch system and graphics calls to Apple’s native APIs and documents LAN, nearby wireless and internet LAN-play modes. Build it from source with your own game dump; Nintendo’s online service is unavailable.

Source / build. Racing.

[Build instructions](https://github.com/c22dev/mush8)

## Kart racing with room for different skill levels

Mario Kart 8 Deluxe combines races through a varied set of courses with items that can change the contest between drivers. The original game offers 48 base courses and optional Smart Steering to help newer racers stay on track, while faster classes give experienced players a different challenge. Its Booster Course Pass is separate additional content.

That is the original game’s design and content structure. Mush8 brings its own platform, input and networking support, so Nintendo’s published console services should not be assumed to work through this project.

Sources: [Mario Kart 8 Deluxe · Nintendo game introduction](https://mariokart8.nintendo.com/)

## An Apple-platform source project

Mush8 runs locally built native applications on Apple Silicon Macs and supported iOS devices. It adapts the game’s system calls and graphics to the host rather than offering a browser launch. There is no prebuilt game download: setup uses your own base NSP, version 4.0.1 update and keys. Owned Booster Course Pass content and a firmware folder for fonts and Miis are optional.

On a Mac, the Prepare step extracts data and processes shaders before play. iOS can import data directly or use the app’s Files location. The initial preparation work is distinct from starting a race, and the resulting commercial game data remains local.

Sources: [Mush8 · build, controls and compatibility documentation](https://github.com/c22dev/mush8/blob/1b2e9b875f3beb94802624f055e7a041a473ee3c/README.md)

## Several ways to control a local race

The documentation lists keyboard controls on Mac and support for Joy-Con, Switch Pro, Xbox and DualSense controllers. iOS shows touch controls when no controller is connected, with optional gyro input disabled by default. A phone can also act as a controller for a Mac or iPad on the same Wi-Fi network without carrying game data itself.

Local network play supports joining with a Switch. Nearby Mush8 devices have a wireless mode, while internet sessions use a separate lan-play server. These routes are distinct from Nintendo’s official online service, which the project does not support.

Sources: [Mush8 · build, controls and compatibility documentation](https://github.com/c22dev/mush8/blob/1b2e9b875f3beb94802624f055e7a041a473ee3c/README.md)

## Build and memory requirements shape compatibility

The documented Mac build requires Apple Silicon, macOS 14 or newer and the specified Xcode toolchain. iOS requires version 26 or newer and at least 6 GB of memory, with 8 GB recommended. Signing and installation are part of the source-build process.

Free Apple ID or IPA installations have a documented memory limit that differs from extended-memory builds. Amiibo is unsupported, and the hidden five-to-eight-player split-screen options are Switch 2-only behavior rather than working Mush8 modes. Check these limits before treating the port as a complete replacement for a console setup.

Sources: [Mush8 · build, controls and compatibility documentation](https://github.com/c22dev/mush8/blob/1b2e9b875f3beb94802624f055e7a041a473ee3c/README.md)

## Do I need the original game files?

Your own Mario Kart 8 Deluxe base game (.nsp), update 4.0.1 (.nsp) and prod.keys. The Booster Course Pass (.nsp) and a Firmware folder for fonts and Miis are optional. Game data is not included.

Creator-reported: [Project guide](https://github.com/c22dev/mush8/blob/1b2e9b875f3beb94802624f055e7a041a473ee3c/README.md)

## How do I get started?

Build from source on an Apple Silicon Mac with Xcode 26 or later and Rust. The project has no published binary release. The iOS build also needs Rust 1.98.1, the aarch64-apple-ios target and xcodegen, plus Apple ID signing or AltStore/SideStore for your locally built IPA.

1. Prepare your own base-game NSP, update 4.0.1 NSP and prod.keys. Keep optional Booster Course Pass and firmware files with them.
2. Follow the repository’s build guide. Its build.sh helper prepares missing tools and asks for the Mac or iOS target; review its installation steps before running it.
3. On Mac, open the locally built Mush8 app, choose your game-files folder and select Prepare to extract the game and compile shaders.
4. For iPhone or iPad, build and sign/install the app through Xcode, or build an IPA for AltStore/SideStore. Import your files in the app or copy them into its Mush8 folder in Files.

Creator-reported: [Project guide](https://github.com/c22dev/mush8/blob/1b2e9b875f3beb94802624f055e7a041a473ee3c/README.md)

## Which devices and browsers work?

The project targets Apple Silicon Macs on macOS 14 or later, and iPhone/iPad on iOS/iPadOS 26 or later with at least 6 GB RAM (8 GB recommended by the creator). Building requires a Mac capable of running Xcode 26 or later. This is a native app, not a browser game.

Creator-reported: [Project guide](https://github.com/c22dev/mush8/blob/1b2e9b875f3beb94802624f055e7a041a473ee3c/README.md)

## What are the controls?

The creator documents Switch Pro, Joy-Con, DualSense and Xbox controllers. Mac also supports keyboard input; iPhone and iPad show touch controls when no controller is connected. Gyro steering is optional. An iPhone can act as a touch controller for a Mac or iPad on the same Wi-Fi without game files on the controller phone.

Creator-reported: [Project guide](https://github.com/c22dev/mush8/blob/1b2e9b875f3beb94802624f055e7a041a473ee3c/README.md)

## Can I play multiplayer?

The creator documents local controllers, LAN on the same network, internet play through lan-play.com servers, and nearby wireless Mush8 sessions. Switch players can join the documented LAN/server modes. Nintendo’s official online service is unavailable, and 5–8-player split screen is hidden.

Creator-reported: [Project guide](https://github.com/c22dev/mush8/blob/1b2e9b875f3beb94802624f055e7a041a473ee3c/README.md)

## What should I know before playing?

Free Apple ID signing and AltStore/SideStore builds use a smaller 5 GB memory layout because they lack the extended virtual addressing entitlement. Nintendo online play and amiibo are unavailable. The two WebM videos play as slideshows on iOS.

Creator-reported: [Project guide](https://github.com/c22dev/mush8/blob/1b2e9b875f3beb94802624f055e7a041a473ee3c/README.md)

## Documented support

- Mobile: Supported · Creator-reported
- Controller: Supported · Creator-reported
- Multiplayer: Supported · Creator-reported
- Local multiplayer: Supported · Creator-reported
- Online multiplayer: Limited · Creator-reported

## Credits and project

- Port author: [Constantin Clerc / C22](https://github.com/c22dev)
- [Original project](https://github.com/c22dev/mush8)
