NX Library

Utility 0.1.4.2

Bibliothèque et lanceur de jeux macOS qui prépare les dumps Switch avec NXnative et lance les applications obtenues.

NX Library est une application macOS en SwiftUI qui sert de bibliothèque et de lanceur : on y range ses jeux, on prépare ses propres dumps Switch avec NXnative, puis on lance les applications Mac obtenues depuis un seul endroit.

Elle propose un assistant de configuration, une aide à la compilation locale, la sauvegarde et la restauration des sauvegardes de jeu, et une navigation à la manette. Elle demande macOS 13 ou plus récent sur Mac Apple Silicon.

Le projet est encore en alpha. Il ne fournit ni jeu ni clé : il faut posséder ses propres fichiers.

Last updated:

Architecture

Mac OS X - macOS Mac OS X - macOS Apple Silicon Apple Silicon

Download and links

Version history

0.1.4.3
  • Ajout de six langues pour l’interface (Anglais, Italien, Français, Allemand, Espagnol, Portugais brésilien) avec sélection automatique ou manuelle dans les paramètres.
  • Affichage des formats régionaux (dates, nombres, tailles) avec prévisualisation, indépendamment de la langue choisie pour chaque jeu.
  • Meilleure cohérence des détails des jeux : genres connus traduits localement et descriptions adaptées à la langue de l’application.
  • Visualisation et gestion par jeu des dossiers app, cache et logs, triés par taille, avec suppression ciblée du cache sans toucher aux données principales.
  • Intégration de la dernière version de l’nxnative engine (8a5c5e7e) supprimant la dépendance à .NET et améliorant le rendu et les shaders pour plusieurs titres.
  • Correction de la prise en charge des fichiers NSP/XCI avec le nouveau moteur, ainsi que du nettoyage des outils en cas d’annulation de build.

A library that speaks your language, with a clearer view of your game storage.

  • Six interface languages: English, Italiano, Français, Deutsch, Español and Português (Brasil). Follow your Mac automatically or choose directly in Settings → Start-up → Language & region.
  • Formats that feel familiar: choose regional dates, numbers and sizes independently, with a preview. The language inside each game stays separate.
  • More consistent game details: known genres are translated locally and available descriptions follow your app language, including lookups for Switch 2 titles. Language changes keep the current page visible and reuse cached information; fallback text identifies its actual language.
  • Storage by game: see each game's app, cache and logs, with the largest caches first. Delete a selected build cache after confirmation while keeping the app, original game files, saves and logs.
  • Latest nxnative engine (8a5c5e7e): building no longer needs .NET. Upstream reports rendering and shader fixes across many games and newly playable titles such as Red Dead Redemption, TUNIC, Metroid Prime 4: Beyond and PRAGMATA. Rebuild a game to get them; its shaders are translated again once.
  • Fixes: adding NSP/XCI files with the newest engine works again; cancelling or quitting during a build no longer leaves the engine's tools running; saves are not replaced while a cloud download is unfinished.

Existing libraries, personal metadata, artwork and game-language settings are preserved. The interface changes need no rebuild; installed games keep their engine until you rebuild them. Available description translations depend on the catalog.

0.1.4.2
  • Amélioration des performances : mise à jour de l’engine avec une réduction des blocages au démarrage et du premier affichage, une baisse de la consommation mémoire et des corrections pour l’éclairage, la brume et les éléments végétaux.
  • Prise en charge des contrôleurs Switch 2 : activation via les options de jeu pour certains titres (jusqu’à 120 FPS), avec des profils dépendants des builds et de la performance du Mac.
  • Affichage des progrès de build : temps écoulé affiché en temps réel, pourcentages et estimation des étapes compilées, sans compter les fichiers cache obsolètes.
  • Gestion des icônes : choix entre conserver les icônes uniquement dans la bibliothèque ou les afficher aussi dans le Finder et le Dock, avec sauvegarde de ce paramètre.
  • Automatisation des icônes : utilisation systématique de l’icône originale ou des données Title DB, suppression des anciennes images personnalisées en cas d’absence de remplacement.

NX Library 0.1.4.2 improves build progress, game icons and the nxnative engine.

Updated engine

Pinned nxnative to 79741184. Upstream reports fewer Ocarina of Time startup and first-draw stalls, lower memory use, fixes for lighting/fog/foliage and improved frame pacing. Other fixes cover visibility queries, controller rumble, H.264 movies, bracketed folder names and multi-program DLC. Cloud sync avoids overwriting a remote save changed after launch.

Rebuilt games can offer Switch 2 controllers over Bluetooth under Game options → More settings → Controls. Supported profiles offer 120 fps through Frame rate: Pikmin 4, DRAGON BALL: Sparking! ZERO, Mario & Luigi: Brothership, The Rogue Prince of Persia, Minecraft Dungeons II and Fire Emblem Fortune's Weave. Available modes depend on the game's build and sustained performance depends on the Mac.

Metal stays 32023.922 with Xcode 27.2 minimum. The next rebuild regenerates the required shader data; keep the existing build cache. Installed game apps retain their engine until rebuilt. See the engine review for per-game results and validation limits. Adoption of this exact commit was requested by the maintainer; a new local game build/visible launch on it is not claimed.

Fixes and improvements

  • Build stages show live elapsed time, readable hour-long durations and percentages. Pipeline archive progress counts confirmed completed/reused batches and estimates remaining pipeline compilation when enough work has completed; it does not count old cache files or unfinished compiler output.
  • Icon location lets every game's artwork stay inside NX Library (Only here) or also appear in Finder and the Dock (Use on the Mac), including NUPs/dumps without an original icon. The choice survives restarts and rebuilds.
  • Automatic preserves that location choice, uses the original game icon then available Title DB artwork, and removes the previous personal app image when no replacement exists. Missing artwork is explained in the picker and build log; the game remains playable. Cached images work offline. Switch Icon Showdown is not an operational automatic source in this release.
  • Play waits safely while an app icon is prepared. Cancel stops the pending launch while allowing the icon update to finish safely.
  • A full disk offers Open Storage instead of incorrectly blaming keys. NUPs and extracted folders no longer receive the missing-keys fallback.
  • The update dialog recognizes an already-current Xcode instead of requesting the same version again.
  • The session recap fits after short play sessions and shows **
0.1.4.1
  • Amélioration majeure de l'expérience utilisateur : affichage d’une carte de session en haut à droite indiquant le temps de jeu actuel et cumulé, visible uniquement après la fermeture d’un jeu et pendant 8 secondes.
  • Retour automatique à NX Library : fermeture d’un jeu ramène l’application en premier plan dans son propre Space (macOS) ou conserve sa position si d’autres applications sont ouvertes.
  • Correction de la gestion des sessions : conservation des 200 dernières sessions, avec comptabilisation définitive du temps total et de la dernière date de jeu pour les sessions antérieures.
  • Prise en charge de la version 2 d’Ocarina of Time : suppression des artefacts visuels (lignes pointillées, trous, taches blanches) et optimisation de la mémoire et du temps de préparation.
  • Support du 60 fps pour Pikmin 4 (jusqu’à 120 fps en option via Game options → Frame rate), avec prise en charge de Dragon Ball Sparking! ZERO et d’autres jeux listés.
  • Mise à jour de l’engin en place : possibilité de basculer entre versions testée et main via Settings → Engine, avec indication du nombre de commits écarts.
  • Lecture des métadonnées des jeux : extraction automatique du titre et de la version depuis les fichiers, indépendamment de leur nom, évitant les erreurs liées aux tags [v…] incorrects.
  • Correction spécifique macOS : génération du DMG avec diskutil image pour une compatibilité avec macOS 14 (Sonoma).

A hotfix with a newer engine: Ocarina of Time loses its last visual glitches, Pikmin 4 runs at 60 fps, and a game you close now brings you back to NX Library with a recap of the time you played.

After you play

  • Session card. When you close a game, a card in the top right says how long you played this time and in total, over the game's faint art with its logo. It waits until NX Library is in front, stays 8 seconds and takes no input; sessions under 10 seconds show none. Turn it off in Settings → Games → Session card.
  • Back to NX Library when a game closes. Quitting a game you were playing brings NX Library back to the front, in its own Space, instead of leaving you on the desktop. If you had moved to another app while the game ran, or another game is still open, NX Library stays where it is.
  • Play time no longer shrinks. NX Library keeps the latest 200 sessions; older ones now count toward each game's total and last played date instead of disappearing from it. Time already lost before this fix can't be recovered.

Engine

  • Updated nxnative to bd979ced (from b2d46b86, through 7fe9fc4d and e5f03403, both tested with an Ocarina of Time rebuild). The Metal compiler is the same, so no new setup is needed.
    • Ocarina of Time (Switch 2): no more dotted rows across fog and light, holes in the ground, white blotches in Kokiri Forest or white flashes in the foliage, and the Poe Sisters' and Phantom Ganon's paintings have their colours. Its first start prepares its pipelines before the first frame, and it uses less memory.
    • Pikmin 4 runs at 60 fps, up to 120 on the Mac (Game options → Frame rate, after a rebuild). DRAGON BALL: Sparking! ZERO now plays.
    • Upstream also reports fixes for The Great Ace Attorney Chronicles, Monster Jam Steel Titans 2, Little Nightmares II, Ori and the Will of the Wisps, Mario Kart World, Mario Kart 8 Deluxe's shader build time, Donkey Kong Bananza's ambient occlusion, Super Smash Bros. Ultimate's first start, Hyrule Warriors: Age of Calamity's cutscenes, Tetris 99, Pokémon Friends, Splatoon Raiders and Cuphead 1.3.7.
    • Controllers: two identical controllers over USB are two players. Rebuilt games get Press a button to join in Game options → Controls: a controller becomes a player at its first button press.
    • 30 fps in full screen is steadier, and a NUP is no longer unpacked again when it hasn't changed.
    • Every game translates its shaders again at its next build, so that first rebuild takes longer.
  • Game files are read by what they contain. The engine now takes each game file's title and version from inside the file, not from its name, and NX Library does the same when you add games. A file named with the wrong [v…] tag is no longer a problem, and a base game that is already version 1.1.0 builds as such. Games added before this version rebuild without being added again.
  • The newest engine can be updated in place. While you use Newest engine (Settings → Engine) and nxnative main moves on, Check offers Update beside Back to tested and says how many commits newer main is. With the keyboard or a controller, Left and Right move between the two buttons and Return or A presses the one in focus. In the upstream list, the commit you are on is tagged In use in green and newer ones New in orange.
  • Installed games keep their engine until you rebuild them.

Mods

  • Mods that need a loader are left out. Some GameBanana file mods need a loader or a PC tool (exlaunch, Skyline, ARCropolis, TKMM, a mod manager, TotK Recomp, ReShade). The engine runs none of them, so such a mod would install and then not work, or break the game. NX Library now reads a mod's requirements and doesn't list those. A tool the author only recommends doesn't hide a mod.
  • A mod's panel shows its requirements, such as the game version it was made for or another mod it needs, under its version line, so a mismatch shows before the download.
  • A mod you installed from GameBanana always shows in the game's Mods band, with Update when its author replaced the file. Before, it could vanish while GameBanana left it out of the game's list, or when it was past the band's first twelve mods.

Fixes

  • .NET in your home folder is found. Setup and builds also look for .NET in ~/.dotnet, where Microsoft's install script puts it.
  • A library file that can no longer be read is kept beside it as library.json.damaged-… instead of being written over by the next save.
  • When NX Library cannot save the library (a full disk, for example), it says so instead of losing recent changes at the next start in silence.
  • The private copy of prod.keys is readable only by you from its first byte, not made private just after it is written.
  • The DMG is made with diskutil image, as macOS 26 asks.

Considered and not adopted

  • Translated texts for the "more players wanted" prompt (DM_CTRL_PROMPT_TEXT): NX Library is in English for now, the prompt's own language. It will come with the languages work.
  • Diagnostic engine switches (DM_NVN_END_ALIAS, DM_NVN_ALLOCPROF=2) and DM_PAD_IDENTICAL, which only turns the identical-pads fix off, stay out of the app.

Known issue

  • A game drawn upside down (#5). The picture comes from the nxnative engine, and no NX Library option flips it. Please report affected games, with title ID and version, at nxnative's issues.

Updating

Updating keeps your library, mods and preferences. Existing game apps remain playable and are not rebuilt automatically; rebuild a game to use the new engine. Setup prepares the new engine in one step after the restart.

Use the DMG for a first installation. Installed release copies can update from Settings → About → Check now.

Reply on the forum

A question or a hands-on report? Open the discussion on the forum.

Reply on the forum