A home for your games on Mac.
Browse and launch games from one Mac library, with controller navigation,
game artwork and activity. Bring together installed Steam games for Mac and games you’ve ported.
Download · Get started · User guide · Troubleshooting · Changelog · Development
Your library, together.
Games, artwork and activity in Spotlight.
- One library for your Mac games. Add installed Steam games for Mac alongside games ported with nxnative. Browse in Spotlight or Collection and launch from either view.
- Steam achievements. See playtime, achievement rarity and crystal tiers when available. Complete every achievement in a game to reveal the animated Arcane.
- An interface built for browsing. Navigate with a controller, keyboard or mouse, and personalise your library with artwork, themes and live backgrounds.
- NX Library is now Arcane. Your library, preferences and save backups carry over. Settings are grouped into General, Library, Porting and System.
Every release is in the changelog.
Arcane is an independent game library and launcher for Apple silicon Macs. It brings installed Steam games for Mac and games ported with nxnative into the same interface, inspired by Selene. The integrated porting workflow uses nxnative to build compatible Mac apps from your own Switch game files.
| Area | What you can do |
|---|---|
| Library | Browse Spotlight and Collection, search, favourite, hide and reorder games. |
| Steam | Launch installed games for Mac and browse playtime, achievements and related games. |
| Game options | Keep each title's launch settings, artwork and metadata together. |
| Personalisation | Choose palettes, wallpapers, live backgrounds, interface sounds and controller prompts. |
| Porting | Build compatible Switch titles with nxnative, review updates and DLC, and follow build progress. |
| Ported games | Manage compatible mods and cheats, back up local saves and preview save imports. |
Game files, keys and firmware are not provided. See Legal and third-party notices.
Arcane is in alpha. Get the latest published build from Releases, or build this version from source.
Automated checks cover the application code, publication inputs, compilation and development-app packaging. They do not certify game compatibility. Changes are recorded in the changelog, and the current checks are available under Actions.
Porting uses nxnative commit 461a5f9f with Xcode 27.2 and Metal 32023.922. Porting Setup retrieves that commit. Installed game apps use the engine they were built with. See the engine upgrade notes.
| Requirement | Details |
|---|---|
| Arcane library | Apple silicon, macOS 13 or later. Steam and each game can require a newer macOS version. |
| Porting and nxnative game apps | macOS 26.6 or later for the Mac hosts built by the pinned engine. This is separate from Arcane's own minimum. |
| Xcode for porting | 27.2 or later, with the Metal compiler certified for the pinned engine. Browsing the library and using Steam do not require Xcode. |
| Porting engine | nxnative at the pinned commit. Setup can prepare the checkout. To select an existing folder, use Settings → Porting → Setup and engine. |
| Porting inputs | Your own supported game sources and keys, with the rights and permissions needed to use them. |
A packaged app includes Python and its required packages, zstd and glslangValidator. Homebrew is used to prepare that runtime during development; it is not needed to use a packaged copy. A source build without the bundled runtime uses the engine's virtual environment and tools on PATH.
With the development prerequisites installed:
git clone https://github.com/Bium23/NxLibrary.git
cd NxLibrary
bash scripts/bundle_runtime.sh
bash scripts/build_app.sh
open "$HOME/Applications/Arcane Dev.app"Run bundle_runtime.sh once, and again when runtime.lock changes. build_app.sh prepares, signs and verifies the app before installing it atomically in ~/Applications.
Build options, runtime dependencies, debug builds and release packaging are documented in the development guide.
- Download the DMG from Releases.
- Open it and drag Arcane to Applications.
- Open Arcane, choose which detected sources to use, and select Open library.
The current alpha is ad-hoc signed and not notarised. If macOS blocks first opening, use System Settings → Privacy & Security → Open Anyway only for a copy you built or obtained from a source you trust.
Packaged releases check this repository for app updates; no GitHub account is needed. Choose Update to download, verify, install and reopen Arcane while keeping your library and preferences. Automatic checks run at most once every 24 hours; Arcane → Check for Updates… in the macOS menu bar and Settings → About → Check now check immediately. Both open the same app-style dialog, with scrollable release notes and a visible result even when no update is available. Updates wait while a build, a running game or a save operation requires the app. Development builds can check public releases manually but never replace themselves.
On first launch, Arcane looks for installed Steam games for Mac and previously ported apps. Choose whether to include Steam and select Open library. Use Settings → Library → Sources to change your Steam source or refresh it later. Choose Porting on the first screen to set up local game builds with nxnative.
Get ready shows the engine, build tools and keys. Install all prepares the engine checkout and certified Metal compiler. Install Xcode from the App Store and follow its licence and system prompts. Choose Continue to proceed. Build requirements can be completed later, and existing game apps remain playable.
Your games shows Game apps: where to keep existing nxnative games (.app) and install new builds. It checks the selected folder before reporting an empty library. Use Change to choose another folder, Choose game file for NSP, XCI, NSZ or XCZ, or Choose a folder instead for a source folder, including supported extracted inputs. A single detected title opens the existing build review; multiple titles require a choice. Selecting sources never starts a build by itself. Cancelling the picker stays on this page.
If games are found, Open library takes you to them. Skip for now enters the launcher without adding a game and is remembered: the welcome flow does not return automatically just because the library is empty. Add games later from Spotlight's Add Game card or Collection. An interrupted first setup resumes on its current step.
The default Game apps folder is ~/Applications; first use can prepare this default without an extra picker. Remembered or custom unavailable folders are never recreated automatically. Changing folders does not move installed apps, and a rebuild updates an existing app in its current location. A read-only folder still allows discovery and Play; installing new builds needs write access.
Discovery includes subfolders of Game apps, skips app contents and limits the search depth. Settings → Porting → Library → Scan game apps reports search limits and unreadable folders. If several builds of a title are found, Arcane keeps the registered app while it exists. For a newly discovered title, it uses the most recently modified build.
Game files is a separate optional folder preference in Settings → Porting → Library. Selecting individual files leaves that preference in place. Both folder choices can be changed later.
Import your prod.keys when prompted. Arcane keeps a private copy with mode 0600 and leaves the original file unchanged. Key values are not displayed or logged.
Reopen both setup steps from Settings → Porting → Setup and engine → Open Setup whenever needed; this keeps your library and completion state. Arcane never runs sudo, accepts the Xcode licence for you or changes xcode-select.
To discover existing nxnative game apps, choose Settings → Porting → Library → Scan game apps → Scan. Play works with the installed app. To rebuild it, attach the original sources.
If an installed app is moved or removed, its library entry stays with a blurred, locked tile and App not found. Restore it to its folder or change Game apps, then refresh the library. Arcane does not search elsewhere for it. Missing build inputs show Game files not found when there is no app to play. An existing app still plays when its source files are missing; only rebuilding is unavailable. To reconnect a game's moved inputs, use Game Options → Edit details → Attach sources….
Spotlight places your games in a row of square tiles, with Play, Options and Favourite beside the selected title. Collection offers a cover-based view. Both use the same library and support a controller, keyboard or mouse.
A closer look at each game.
Artwork, details and play history in one place.
Scroll down for screenshots, the game description and More like this when matching titles are in your library. Steam games can show playtime and an Achievements card with rarity, unlocked items and crystal tiers. The animated Arcane appears when every achievement is unlocked.
Use Find a game for search, Game Options for title-specific actions, and the menu for themes, Settings and running-game controls. Hidden games can be restored under Settings → Library → Games → Hidden games.
When you quit a game, Arcane comes back to the front, unless you had moved to another app or another game is still open. A session card in the top right shows how long you played this time and in total; sessions under 10 seconds show none. Turn it off in Settings → Library → Games → Session card.
Quick access.
Open the menu without leaving your library.
Arcane is available in English, Italiano, Français, Deutsch, Español and Português (Brasil). Settings → Start-up → Language & region follows the Mac automatically or lets you choose the app language and region separately. Changes apply immediately and are remembered. Regional formats controls dates, numbers and sizes. Game options → Language controls each supported game's language.
Choose a language directly from its list. Known catalog genres are translated locally, without changing the saved metadata. Descriptions from Nlib are requested in the app language when supported, with cached descriptions shared between regions using the same language. Switching language reuses available artwork and credits; when those are fresh, only the localized description is requested. English remains available when a translated description cannot be found; descriptions, mod text and release notes from external sources are not automatically translated. Personal names, metadata choices, artwork and game settings are preserved.
The last row in Details shows five stars, the original score out of 100 and its source. Public ratings via Wikidata work without a key; games without a verified match or usable score show Rating unavailable. Critic scores take priority. When neither IGDB nor Wikidata supplies one, a configured IGDB connection can show its community average, clearly labelled User score · Users · IGDB. Community and critic scores are never mixed.
Optional Settings → Online services → IGDB accepts your own Twitch application's Client ID and Client Secret. The dialog includes five short setup steps and a direct link to register an application. Check and save verifies access before keeping the credentials in a private file on this Mac. The secret is hidden, and credentials are separate from ordinary settings and the Dev-profile import. Remove returns to the keyless source. With IGDB configured, its critic average takes priority, followed by public critic scores via Wikidata and finally the explicitly labelled IGDB user average. Cached scores remain available offline. The same general settings page contains the SteamGridDB key for game artwork; API connections are optional.
The same optional connection adds IGDB proposals to Game options → Edit details → Change metadata for Switch, Switch 2 and Steam games. Preview descriptions, genres, developers, publishers and platform-specific release dates, then choose each field individually. Automatic and manual choices remain available. Saved proposals work offline, and IGDB descriptions keep their original language.
LaunchBox and TheGamesDB also provide optional proposals without an API key, based on the game's title and platform. The picker explains missing or ambiguous data and allows a retry. Native Mac entries take priority, and PC alternatives are labelled.
Use the dialog's Developer portal and Setup guide links to create your credentials.
Use this workflow for games you want to port with nxnative. Arcane discovers installed Steam games through Settings → Library → Sources.
- Open Add game and choose or drop a supported file or folder.
- Review the detected base game, update and DLC. Arcane accepts NSP, XCI, NSZ, XCZ and Switch 2 NUP packages, plus supported source folders.
- Check the destination, disk estimate and game options.
- Choose Add and port to build, or Add to library only to keep the entry for later.
For a title already in the library, Review opens with that game's saved options and offers Rebuild or Save changes.
Sources stay in place; staged workspaces use symbolic links. New game apps install in the chosen Game apps folder. Builds run on the drive the app goes to: with the folder on an external APFS or Mac OS Extended drive, the extracted game, shader cache and new app stay on that drive in a hidden .nxlibrary-build folder, so the Mac's disk needs no space for the build and the app is moved into place, not copied. On an exFAT drive or a network share builds keep using the Mac's disk: exFAT keeps Mac file attributes in separate ._ files, which break a built app's signature. Review shows the actual destination, including any filename needed to avoid an unrelated app. Build stages, progress, estimated time and a live log remain available while the operation runs. The first build of a game after an engine update can first move its shader cache into the engine's new format: that shows Updating shader cache instead of an ETA and takes longer on a large cache or an external drive. Closing the porting screen leaves the operation running; cancellation is a separate action.
A rebuild of a running game waits to replace its app until it closes. If compilation finishes but installation fails, Retry installs the preserved result without compiling again. If the destination folder disconnects, reconnect it before retrying: the ready build keeps its original destination. A library refresh preserves pending installations and failure information.
Follow the build.
Keep track of porting progress from Spotlight.
| Where | Scope | When it applies |
|---|---|---|
| Settings → Porting → New games | Starting values for titles added later. | When a new title is added. Existing titles keep their choices. |
| Game Options → Next launch | The selected game. | Its next launch. |
| Game Options → Use new game defaults | Copies the current defaults into that game once. | Its next launch. |
| Add game → Review | The title being added or rebuilt. | That operation, including its saved language. |
| Settings → Porting → Cloud saves | Library-wide preference, subject to advanced game configuration overrides. | Reapplied before each launch, including when Off. |
| Settings → Look | The library's presentation. | The app interface; game artwork and launch-screen style have their own controls. |
For games built with nxnative, options can include fullscreen, FPS target, docked mode, language, rumble, render scale, MetalFX upscaling and Metal HUD. MetalFX upscaling enlarges the finished picture, including the HUD, to your window or screen. Game's upscaler is offered for games that upscale inside the frame, such as Donkey Kong Bananza. Available options depend on the installed build and game.
Arcane groups Settings into General, Library, Porting and System. Use Search to find a setting and Changed to review values you’ve adjusted. Group resets retain the cloud-sync choice and selected sources folder.
For a ported game, open Game Options → Saves. Keep the game closed during backup, import or restore.
| Button | What it does |
|---|---|
| Open folder | Opens the current local save in Finder. |
| Back up now | Creates a dated, verified copy of all local users, their registry and the device save. |
| Save type | Selects the import destination. User save is the usual choice; Device save is for a separate device save. |
| Import save… | Previews an exported save folder or a dated Arcane backup before replacing anything. |
| Refresh | Reads save and backup information again. If recovery is needed, offers Retry recovery. |
| Backup folder | Opens this game's backups in Finder. The row shows the latest backup's date and time. |
To import: choose the folder, review the centred From → To preview, then confirm. Arcane backs up existing progress first and verifies the result. A successful import shows Imported successfully, which disappears after three seconds.
For Ryujinx, choose the numbered game folder under bis/user/save/. A folder selected inside that tree is recognised too; Arcane checks its title metadata and imports the complete committed save, including all slots. For other exports, choose the folder containing the complete save.
To restore: choose a dated backup folder through Import save…. A current backup restores the complete local user group, including missing destinations. Older backups restore only the primary user and device save, preserving additional users. An ordinary folder import replaces only the selected primary-user or device destination.
Cloud sync and backups have different purposes. Cloud sync can replace local files, so import and restore require it to be off in the effective configuration. Cloud sync covers only the primary user and device save; additional local users are protected by local backups, not by cloud sync. A backup is a dated copy you manage in Finder. Save compatibility still depends on the game, platform and version; recognising the folder does not guarantee compatibility.
Interrupted replacements must recover before Play. The Saves panel reports what is blocking an operation and keeps the backup folder accessible.
For a ported game, open Game Options → Cheats, then choose or drop a matching cheat file. Arcane checks the title and build information. Newly imported cheats start off. Enable the master switch and the individual cheats you want, then launch the game.
Changes apply at the next Play and are written only while the game is closed. An older or unrecognised engine build may require Rebuild. The engine's in-game panel, ⌘⇧C, reads the same files.
Cheats change values while you play, for one game version only. New items, looks or gameplay are mods.
Arcane manages file mods for games ported with nxnative.
- Mod store. The Mods card in Spotlight opens a store of the GameBanana mods that work with your games: a featured banner, the most popular, a row per category and a row per game, sorted by Popular, Most liked, Newest or Recently updated. Hide the card in Settings → Spotlight.
- A game's Mods band. Each game page lists its GameBanana mods and the ones you installed. Open a mod for its images, author, version and requirements, then press Install; Update appears when the author replaces the file. If the game's GameBanana page is uncertain, the band asks once, and Wrong game? picks another.
- Your own mods. File mods (a folder with
romfsinside) go into the game's mods folder. Turn them on in the band or in Game Options → Mods; the order decides which mod wins when two change the same file. Remove moves a mod to the Trash.
Mods apply at the next launch, without a rebuild. The engine reads file mods only: mods that patch code (exefs, such as 60 fps patches) or need a loader or PC tool (exlaunch, Skyline, ARCropolis, mod managers) don't work, and the store leaves them out.
Mods for your games.
Browse what works with the engine and install it in one step.
- Game Options → Edit details changes one game's artwork or metadata. Manual artwork choices take priority over automatic images. After choosing an Icon in Change artwork, choose Only here to keep it inside Arcane or Use on the Mac to show it in Finder and the Dock too. This choice is available for every game, including apps with no original icon, and survives restarts and rebuilds. Only here restores the original app icon (or its absence) if a custom one was already applied. Automatic removes the personal image and uses the game's own icon, then available online artwork, while keeping your location choice. On the Icon tab, Icon location changes Only here / Use on the Mac at any time, including with Automatic selected. If no image is found, the app keeps the standard macOS icon and remains playable; Change artwork explains that no icon is available. The finished build log records the separate icon result.
- Menu → Theme opens colors first, then backgrounds. Arcane keeps the original blue moonlight as the default. Optional Arcane Crystal and Arcane Flow offer fine moving light threads, with barely visible ambient light. Background choices include local images, muted looping videos and optional online sources; source credits appear in the picker.
- Settings → Look controls wallpaper placement, sizing, brightness, game backgrounds, Reduce Motion and the Color/Monochrome app icon.
- Settings → Sound & music controls interface cues and volume. Four interface sounds are bundled; additional sounds and wallpapers can be imported from a Selene theme folder you own.
Online artwork and wallpapers require their providers to be available. Their content and service terms remain those of the respective owners.
Choose your colours.
Preview each palette before applying it.
Find a wallpaper.
Browse backgrounds and preview them in your library.
Add a little motion.
Choose a live background or bring your own video.
Settings → Start-up → Start in fullscreen chooses the launcher window mode at the next opening. It is separate from each game’s Fullscreen option.
The macOS Game menu follows the current selection. Game Details opens the existing game page in Spotlight or the selected cover’s details in Collection; Game Options… opens the same options as the in-app button. Unavailable commands are disabled.
In fullscreen, the pointer hides after three seconds without movement. Moving the mouse reveals it; keyboard/controller navigation, clicks and scrolling do not. Leaving fullscreen, switching apps or opening a native system panel restores it.
| Action | Keyboard | Controller |
|---|---|---|
| Navigate | Arrow keys | D-pad / left stick |
| Select | Return / Space | Confirm button |
| Back | Escape | Back button |
| Menu | ⌘K |
Menu / Start |
| Settings | ⌘, |
Hold Menu |
| Find a game | ⌘F |
Hold View |
| Switch library view | Tab | View |
| Switch tabs / filters | Q / E where shown | LB / RB |
Prompts follow the connected controller and supported system remapping. Settings → Controllers → Button layout separates Library navigation from In game defaults. Game inputs are handled by the engine and can differ in older builds.
| What you see | What to do |
|---|---|
| A Steam game is missing | Open Settings → Library → Sources, verify the Steam folder, then choose Refresh Steam. Arcane lists supported titles installed as Mac apps. |
| Play works, Rebuild is blocked | Open Settings → Porting → Setup and engine and check Compatibility. Existing apps and new builds have separate requirements. |
| Sources detached / missing | Use Attach Sources… or locate the original files. The installed app remains usable. |
| Ready build waiting to install | Close the running game or finish the save operation, then retry the installation if prompted. |
| Import is unavailable | Close the game, finish any active operation and follow the cloud-sync or recovery action shown in Saves. |
| Import fails | Read the error message, check that the folder contains a complete save and inspect the preview before retrying. |
| A setting cannot be saved | Use the dialog's Retry. Unreadable preferences are preserved before defaults are written. |
| Porting fails | Use the explained failure and its suggested action. Console contains the build log and Copy diagnostics. |
Before reporting a problem, review copied diagnostics and remove anything personal. Include your app/macOS versions, the operation and steps to reproduce. Read SECURITY.md before sharing a suspected vulnerability.
- Arcane uses a manually pinned engine and checks its commit, working tree, CLI contract and Metal compiler before new builds. It does not follow upstream
mainautomatically. Settings → Setup and engine → Newest engine lets you choosemainyourself before Arcane has tested it: an orange dot marks it, builds are recorded as untested, Update moves to a newermainwhen there is one, Back to tested returns to the pinned engine, and it is not offered whenmainneeds a different Metal compiler. - The current engine is
461a5f9fand certifies Metal32023.922. Build anyway with an untested toolchain requires explicit confirmation and marks the resulting build as untested. A successful launch does not turn it into a certified combination. - Game compatibility depends on nxnative, the game version and the toolchain.
- Output follows the window/display; native 1440p/4K internal rendering is not supported. Render scale is 50–100% where the build supports it. MetalFX is spatial upscaling.
- Builds run one at a time. iOS/IPA output, automatic engine updates and notarisation are not currently provided.
The upgrade notes record each engine review and its toolchain requirements.
App data lives in ~/Library/Application Support/NXLibrary/. Local game data uses ~/Library/Application Support/nxnative/<title ID>/, with mods in its mods folder. Backups are stored under NXLibrary/SaveBackups/<title ID>/.
Settings → Porting → Storage shows app, build cache and log sizes for every library entry, including hidden games, with the largest caches first. Delete cache permanently removes only the chosen game's build cache after confirmation. Its app, original game files, saves and logs stay in place. The next rebuild may take longer. Shared cache confirmations list the other affected entries. Connect unavailable drives or check folder access, then choose Recalculate.
Storage can also clear all build caches or logs and open the shared backups folder. Cleanup runs without blocking navigation and is unavailable during a build or app update. Remove Sources & Build Cache deletes the selected original source files, while retaining the installed app and saves. Read that confirmation carefully; it differs from clearing a cache.
| Document | Contents |
|---|---|
| Changelog | User-visible changes and release history. |
| Development guide | Runtime preparation, debug builds, tests, packaging and releases. |
| Screenshots and demo | Media inventory and display guidance. |
| Contributing | Change and verification guidelines. |
| Security | Private vulnerability reporting and handling sensitive files. |
| Technical guide | How each area works today, in Italian. |
| How to build | Where new code goes and the recipes to follow, in Italian. |
| Flows | End-to-end flows with diagrams, in Italian. |
| File catalog | Responsibility of every project file, in Italian. |
| Steam | Steam integration: files read, game states, launch, playtime, achievements, limits; in Italian. |
| Engine upgrade notes | Pin changes and their evidence. |
If you’d like to support Arcane’s development and maintenance, you can buy me a coffee.
Arcane is MIT licensed. It uses upstream nxnative. It began from the MIT nxnative_Launcher codebase, which has been rewritten since; that repository is no longer available and its notice stays in NOTICE. Adaptations from NX2Apple cover key checks, failure explanations, diagnostics and updates.
The interface draws from the MIT Selene theme. Bundled fonts, sounds, palettes and runtime components retain their own licences; see NOTICE, media notices and palette notices.
The app icon uses original artwork. The master and generation notes are included.
Project scope. Arcane is an independent macOS game library and launcher. It supports installed Steam games for Mac and provides guided setup and local game builds through nxnative.
Games and keys. The project does not provide games, firmware, cryptographic keys or downloadable game packages. Users must supply their own game files and keys and have the rights and permissions required to use them. Do not submit these files through issues, pull requests or support requests.
Local processing and external services. Game preparation uses locally supplied files and keys. Arcane checks encrypted game headers using the supplied keys and invokes nxnative to perform the build. Setup, updates and optional artwork features may contact third-party services.
Permitted use. Owning a game or console does not necessarily authorise every form of copying, decryption or conversion. Applicable rules vary by jurisdiction. This project does not grant permission to circumvent technological protections or infringe third-party rights. Do not use it to distribute game files, keys or generated packages without the necessary authorisation.
Third-party software and content. Arcane does not distribute proprietary Nintendo game code, game assets, firmware or cryptographic keys. Open-source dependencies and bundled resources remain subject to their respective licences and notices. Artwork retrieved from external services remains subject to its owners’ rights and the applicable service terms.
Trademarks. Arcane is not affiliated with, sponsored by or endorsed by Nintendo or any other game publisher or platform provider. Product names, game titles and trademarks belong to their respective owners.
Rights concerns. If you believe material distributed by this project infringes your rights, contact the maintainer with the relevant material, your rights claim and sufficient information to assess it. Substantiated concerns will be reviewed promptly and addressed as appropriate.
No warranty. Arcane is provided “as is”, without warranty, as described in LICENSE. Third-party components are governed by their own licences. See NOTICE for acknowledgements.







