Xc1Ym / LumaDock

LumaDock · 璃游 
 Let your games continue on Mac. 
 English · 简体中文 
 Apple Silicon · macOS 26+ · Native Liquid Glass interface 
 Download for Mac · Build status 
LumaDock is a game launcher exclusively for Apple Silicon Macs, built on **nxnative**. Bring your authorized NSP game files and `prod.keys`, then import, prepare, and launch from a graphical interface.
Through nxnative's code rewriting and runtime, the game's code executes natively on Apple Silicon, with graphics rendered through Metal. LumaDock organizes your library and runs the preparation steps, producing runtime files directly for macOS.
**No games, updates, DLC, firmware, keys, game artwork, or player-generated shader caches are included. This project is not affiliated with Nintendo or any game publisher.** The app and README support **English and Simplified Chinese**. The interface follows your macOS language by default; choose System default, English, or 简体中文 in **Settings → Language** or the setup assistant. Changes apply immediately. Built-in system dialog controls and raw compiler logs retain their system/tool language.
Choose **System default, Light, or Dark** in **Settings → Language & appearance** to change LumaDock’s appearance independently of macOS. The choice takes effect immediately and is saved.
## Features
- **One game library.** Import NSPs or scan a folder. Identify base games, updates, and DLC from their content metadata. Drag and drop, multiple selection, Unicode paths, and duplicate checks are supported.
- **Automated preparation.** Extract, merge updates, process DLC, rewrite code, translate and compile shaders, then build the Mac host. Track stages, cancel tasks, validate caches, and retry.
- **A native Mac interface.** SwiftUI / AppKit, Liquid Glass, light and dark appearance, and an opaque fallback for Reduce Transparency.
- **Separate player data.** Original files, managed copies, runtime files, caches, and saves are kept separate. A failed preparation preserves the last successful runtime version.
## Screenshots
All screenshots use Light appearance and an empty library. They contain no game footage, covers, keys, or player data.
**Game library** — An empty library before importing player content.
**Setup assistant** — Environment checks come before importing keys and games.
**Settings** — Switch languages and appearance, and manage the local environment.
## Tested games on Mac
**This README lists only games actually tested on Mac.** Tests were recorded on October 20, 2026, using an Apple M5 Pro, macOS 27.0.1, and Xcode 27.1.
| Game | Tested version | Result and scope |
| --- | --- | --- |
| The Legend of Zelda: Breath of the Wild | 1.9.0 | **Build and startup passed:** full preparation with two DLCs and a brief native run; gameplay across the full game has not been verified |
| Super Mario Odyssey | 1.4.1 | **Gameplay test passed:** full preparation and GUI launch passed; the player confirmed normal play during a roughly 23-minute run, and save files were wr