NX Library
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.
Dernière mise à jour :
Architecture
Mac OS X - macOS
Apple Silicon
Téléchargement et liens
- Télécharger NX Library
- Code source 187 étoiles sur GitHub
- Licence : MIT
Historique des versions
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(fromb2d46b86, through7fe9fc4dande5f03403, 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.keysis 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) andDM_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.
0.1.4
- Système de mods intégré : activation de mods personnalisés (dossiers romfs) ou téléchargement depuis GameBanana via une interface dédiée, avec gestion des conflits et suppression sans perte.
- Stockage des builds sur périphérique externe : extraction et construction des jeux sur un disque APFS ou Mac OS Extended externe, libérant l’espace interne et évitant les copies lourdes (~35 Go).
- Amélioration des upscalers : clarification des deux méthodes (MetalFX pour l’image finale et upscaler natif du jeu) avec optimisation GPU (1 ms vs 3,5–5 ms sur M1).
- Détection des fichiers corrompus : vérification des fichiers NUP/dump avant lancement, avec option de lancer malgré tout si des fichiers sont endommagés.
- Mise à jour de l’engine nxnative : passage à la version b2d46b86, ajout de profils pour Kirby Air Riders, Ocarina of Time (Switch 2), ŌKAMI HD, Minecraft Dungeons II et Sonic Superstars.
- Réduction de l’impact CPU : passage à ~0% CPU en veille grâce à l’utilisation exclusive de Core Animation pour les animations.
- Suppression de Game Mode macOS : désactivation automatique pour éviter la baisse de priorité des builds en arrière-plan.
Mods arrive in NX Library: turn on your own, or find and install the ones that work from GameBanana, in a game's page or in a new mod store. Games now build on the drive they are installed to, and the engine moves to a newer, tested version.
Mods
- Your own mods, no rebuild. Put a file mod (a folder with
romfsinside) into a game's mods folder, then turn it on in the game's new Mods band or in Game options → Mods, and play. The engine reads mods at launch, so nothing is rebuilt. When two mods change the same file, the order you set decides which one wins. Remove moves a mod to the Trash, so nothing is lost by mistake. - Mods from GameBanana in a game's page. The Mods band also lists the GameBanana mods that work with the engine. Open one to see its images, author, version and files, then press Install: it downloads into the game's mods folder and is on at the next launch. Update appears when the author replaces the file.
- Why only some mods: NX Library checks every file of a mod before showing it and keeps only file mods (
romfs). Mods that patch the game's code (exefs, such as most 60 fps patches) don't work with the engine, so they are left out instead of failing after the download. - Finding the right game: when the game's GameBanana page isn't certain, the band asks once and remembers your choice; Wrong game? picks another.
- Every mod links to its page on GameBanana, so its authors keep the credit.
- Why only some mods: NX Library checks every file of a mod before showing it and keeps only file mods (
- Mod store. A new Mods card in Spotlight's row. Go down from it into a store of the mods that work with your games: a large Featured banner, the most popular mods for your games, a row per category (characters, worlds, graphics, music, interface, gameplay) and a row for each of your games, last played first. Sort by Popular, Most liked, Newest or Recently updated.
- It opens at once from what it found last time and checks GameBanana again in the background, so you never wait on a blank page.
- A small arrow at a row's right end shows when more mods are hidden past the edge.
- The card shows the art of the best mods, and the background glides to gold while it is selected. Don't want it? Hide it in Settings → Spotlight or from its Y menu.
- Installing one file installs only that file. In a mod with several files, only the one you chose shows its progress; the others wait until it ends.
- A mod's panel reads well with long text. Read more sits right under the description and opens all of it; the files follow under their own Files title. The panel scrolls with the wheel, the trackpad or Up and Down, which read the text before moving to the next row.
Building on an external drive (#4, #6)
- Games build on the drive their app goes to. With the Game apps folder on an external APFS or Mac OS Extended drive, the extracted game, the shader cache and the new app stay on that drive, in a hidden
.nxlibrary-buildfolder.- Why: before, every build happened on the Mac's own disk and the finished app was then copied across. A Switch 2 game needed tens of GB free on a small internal SSD (#4), and the final copy wrote ~35 GB again (#6). Now the Mac's disk needs no free space for the build, and the finished app is moved into place, which is instant.
- A game whose build files were on the Mac's disk moves them at its next rebuild and frees that space.
- exFAT drives still build on the Mac's disk: exFAT stores extended attributes in
._files, which break a Mac app's signature. The space warning says so. Installing to exFAT works as before.
Game options
- The two upscalers, explained. They are two different steps of the same frame, and both can be on:
- MetalFX upscaling enlarges the finished picture, menus and HUD included, to your window or screen with Apple's MetalFX instead of smooth scaling: sharper, for a little more GPU time.
- Game's upscaler appears only in games that enlarge their 3D picture inside the frame with an upscaler of their own (such as Donkey Kong Bananza). Game's own keeps it; MetalFX does the same step with Apple's scaler in a fraction of the GPU time (about 1 ms instead of 3.5–5 ms on an M1), with Apple's look instead of the game's.
- Info beside a row. Rows with an explanation show an info button: click it, or press Y on the focused row.
Cheats
- Cheats or mods? A line under the Cheats panel's title tells them apart: cheats change values while you play, for one game version only; new items, looks or gameplay are mods.
- Cheats on imported games. A game added from an app built elsewhere no longer asks for a rebuild when its engine already supports cheats: NX Library reads the engine version the app carries.
Game app icons
- A game whose app has no icon (Switch 2 games and dumps) now shows the Icon you choose in Change artwork, in Finder and the Dock. For a game with its own icon, a question lets you use yours on the Mac too. The icon survives a rebuild, and Automatic brings back the game's own. Updating a large game's app takes about a minute.
Engine
- Updated nxnative to
b2d46b86(from4a0551e4, through04df08d4, which was tested with an Ocarina of Time build). The Metal compiler is the same, so no new setup is needed.- New game profiles: Kirby Air Riders and Ocarina of Time (Switch 2, from a NUP), ŌKAMI HD, Minecraft Dungeons II, and Sonic Superstars (provisional).
- Ocarina of Time no longer crashes at the first note of the ocarina and runs lighter in the village.
- Upstream also reports fixes for Trails in the Sky 1st Chapter and Just Dance (a crash at launch), Super Mario Galaxy 2 (cutscene picture shape), Super Smash Bros. Ultimate 13.0.5, Rhythm Heaven Groove and Fire Emblem: Three Houses.
- A game's shader cache and shader libraries are now one file each, so a build writes far fewer files. The first build of each game after updating converts its cache and shows Updating shader cache meanwhile; every game translates its shaders again once.
- Damaged game files are caught. A NUP or a dump has no checksums, so a damaged file used to make a game that reloads an asset for ever. The engine now checks the files once (about 16 s for Ocarina of Time) and stops with Some game files are damaged, with Port anyway if you want to try.
- Installed games keep their engine until you rebuild them.
Smoother and lighter
- Cards no longer wobble in a quick run of presses. Every card grows, shrinks and slides on one shared glide, so the gaps between cards hold; cards coming in at the edge no longer drift into line, and the lock, build progress and Add Game icon move with their card. In Spotlight and Collection.
- NX Library rests at about 0% CPU when idle, instead of a quarter of a core: the selected card's ring and shine now run in Core Animation, just as smooth.
- macOS Game Mode stays off for NX Library. It is a launcher, not a game, and Game Mode lowers the priority of background work such as builds. Games keep Game Mode off as the engine sets it, because it holds the GPU at its lowest clock after a few minutes. If macOS already remembers NX Library as a game, turn it off once in full screen: Command-Esc, Game Overlay, Game Mode.
- The background art no longer jumps or flashes when you move between games, and Spotlight's genres now leave and return with the game's buttons.
- The Mods card keeps its art when selected; new art crossfades in whole.
- The intro shows only the moving background, without the app icon.
Considered and not adopted
These were looked at in this release and left out on purpose:
- Downloading cheats from switch-cheats-db. It was built and then removed. A cheat works only on the exact game version it was written for, and the public collections (switch-cheats-db, MyNXCheats, Breeze's archive, the GBAtemp mirror) have nothing for the latest versions of most games, which are the ones people port. A panel that goes online on every open and almost never finds anything isn't worth it. You can still add cheat files yourself in the Cheats panel.
- Loading a cheat from another game version. The engine could load it, but its memory addresses would be wrong: crashes or damaged saves. Not offered.
- Code mods (
exefs, e.g. 60 fps patches). The engine doesn't apply them, so NX Library doesn't list or install them. - New engine switches without a player use:
DM_PROBE_EVERY(a diagnostic counter),DM_NVN_CUT_BUSY(diagnostic) andDM_GUEST_FILE_DIR(iOS only) stay out of the app. - Building on exFAT drives, for the signature reason above.
- A grid view for Collection (#3) is planned for a later release, to be done with proper focus, art and controller navigation rather than a quick port.
Known issue
- A game drawn upside down (#5). NX Library doesn't draw the game: the picture comes from the nxnative engine, and no NX Library option flips it. The engine already fixes this symptom game by game; 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.
0.1.3.3
- Reconnaissance étendue des jeux extraits : acceptation de plusieurs structures de dossiers pour les dumps (exefs/romfs directement, ou dans un sous-dossier base).
- Gestion des mises à jour/DLC : intégration automatique des contenus dans un dossier base contenant des fichiers mis à jour.
- Affichage d'erreur plus précis : message explicite pour les dossiers vides ou mal structurés, incluant les extraits de jeux.
- Compatibilité avec les mises à jour seules : prise en charge des dumps contenant uniquement un dossier updates// comme jeu complet.
Fixed
- Extracted games (dumps) are recognised in every layout the engine accepts. Before, only a folder holding
base/exefsandbase/romfsworked; choosing thebasefolder itself said "No NSP, XCI, NSZ, XCZ or NUP files were found in this folder". Now these work too:- a folder with
exefsandromfsdirectly in it (abasefolder, or whatnup extractwrites). Abasefolder inside a dump with updates or DLC brings them along; - a dump with only an update (
updates//), played as the whole game; - a
basewith only its code, when an update has the RomFS.
- a folder with
- A folder with no game now says what NX Library looks for, extracted folders included.
0.1.3.2
- Ajout du support natif du décompresseur ZBIC (variante de zstd de Nintendo) pour les jeux et mises à jour du système 22.0.0+, intégré via zbic 1.0.1.post1 dans le Python embarqué.
- Intégration du décompresseur NSZ/XCZ (nsz 5.0.0) dans le Python embarqué, évitant la dépendance à une installation externe.
- Vérification systématique des dépendances (ZBIC, NSZ, make) lors de l’installation et de la construction, supprimant l’affichage trompeur « All set » en cas de manque.
- Message d’erreur amélioré pour les jeux nécessitant une langue non supportée, redirigeant vers les options de configuration.
- Détection des packages corrompus (troncature ou échec de vérification de hash) avec une suggestion de téléchargement/réparation, sans proposer le portage.
Fixed
- Games and updates for system 22.0.0 and later, whose code Nintendo compresses with ZBIC (its own zstd variant), now build. Before, the porting stopped with "The engine needs the zbic package to read this game's code", even after
pip install zbic: NX Library uses only its built-in Python, which lacked the package. The built-in Python now includes zbic 1.0.1.post1 (GPLv2; its source ships inRuntime/sources/), and Setup checks it with the other modules. - NSZ and XCZ files build without a separate nsz install. The engine converts them with the nsz tool, which the built-in Python lacked, so they worked only where nsz happened to be installed. The built-in Python now includes nsz 5.0.0 and its dependencies.
- Setup and the build check test every package and tool the engine needs (zbic, nsz and
maketoo), so All set no longer appears when one is missing. - A game built with a Language it does not have explains it and points to Game options (Game Default or one of the game's languages), instead of "The porting stopped".
- A package too damaged for Port anyway (cut off, or its own tables fail their hash check) asks for a new dump or download and no longer offers Port anyway.
0.1.3.1
- Ajout du support des fichiers NUP Nintendo Switch 2 sans jeu de base, si l’update contient l’intégralité du jeu.
- Correction de l’erreur bloquante lors de l’acceptation de NUP incomplets pour les mises à jour purement correctives.
- Intégration native des jeux Switch 2 avec affichage automatique de descriptions, genres, couvertures et captures d’écran.
- Plateforme systématiquement identifiée comme Nintendo Switch 2.
- Options de jeu personnalisées par titre, synchronisées entre l’interface et le jeu (ex. : FPS, upscale).
- Paramètres spécifiques à un jeu n’apparaissent que s’ils sont supportés par celui-ci.
- Ajout d’un navigateur en ligne (LaunchBox/SteamGridDB) pour télécharger des artworks en taille native après sélection.
- Mise à jour de nxnative avec corrections et profils pour Super Mario Odyssey, Tears of the Kingdom et Donkey Kong Bananza.
A quick fix on top of 0.1.3. If you already have 0.1.3, this update adds only the fix below; everything else is the same.
Fix in 0.1.3.1
- Add Game accepts Switch 2 NUP files without a base game, when their update holds the complete game, as the engine does. Before, such a file stopped with "The NUP file could not be read: AttributeError: 'NoneType' object has no attribute 'meta'". If the update is only a patch, the build now says a NUP with the base game is needed.
What's new in 0.1.3
Switch 2 support, game options that follow each game, more artwork sources and a verified engine upgrade.
Switch 2
- Add Game accepts Switch 2 NUP files: Review lists the base game, updates and DLC.
- Switch 2 games get their description, genres, cover, background and screenshots automatically, and show Nintendo Switch 2 as their platform.
Game options
- Options follow each game's own settings: a change made in the game's settings window shows in NX Library, and the other way round. Rebuild a game to use this.
- Frame rate (with 120 fps where a game supports it), the game's upscaler and the other settings a game offers appear only when the game has them.
Artwork
- Browse online in Change artwork opens LaunchBox and SteamGridDB (with your free API key). Images are downloaded at full size only when you choose them.
Engine
- Updated nxnative to
4a0551e4, with fixes and updated profiles for games such as Super Mario Odyssey, Tears of the Kingdom and Donkey Kong Bananza. Rebuild a game to use it; its shaders are prepared again. - After a game is rebuilt and played with this engine, an older build of that game may not read some of its saves.
- Games the engine has no profile for are accepted with a provisional one, marked Not tested with this engine yet.
- Newest engine in Settings → Engine lets you try nxnative's latest version before NX Library has tested it. Back to tested returns to the tested engine at any time.
- Hold Home for 2 seconds, then A, to quit a game with the controller.
Fixes
- Refreshing the library no longer takes minutes for large games on an external drive.
- The Cheats switch no longer shows an error for a game without a cheat file.
Updating keeps your library and preferences. Existing game apps remain playable and are not rebuilt automatically. 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.
0.1.3
- Ajout du support officiel pour les jeux Nintendo Switch 2 (fichiers NUP, descriptions automatiques, couvertures et captures d’écran).
- Options de jeu dynamiques : paramètres (FPS, upscaler) liés aux capacités du jeu, synchronisation bidirectionnelle avec les réglages locaux.
- Intégration de sources d’artwork externes (LaunchBox, SteamGridDB) avec téléchargement sur sélection manuelle.
- Mise à jour de l’engine nxnative (4a0551e4) avec correctifs pour des jeux comme Super Mario Odyssey et Tears of the Kingdom.
- Option pour tester l’engine nxnative en version non validée depuis les paramètres.
Switch 2 support, game options that follow each game, more artwork sources and a verified engine upgrade.
Switch 2
- Add Game accepts Switch 2 NUP files: Review lists the base game, updates and DLC.
- Switch 2 games get their description, genres, cover, background and screenshots automatically, and show Nintendo Switch 2 as their platform.
Game options
- Options follow each game's own settings: a change made in the game's settings window shows in NX Library, and the other way round. Rebuild a game to use this.
- Frame rate (with 120 fps where a game supports it), the game's upscaler and the other settings a game offers appear only when the game has them.
Artwork
- Browse online in Change artwork opens LaunchBox and SteamGridDB (with your free API key). Images are downloaded at full size only when you choose them.
Engine
- Updated nxnative to
4a0551e4, with fixes and updated profiles for games such as Super Mario Odyssey, Tears of the Kingdom and Donkey Kong Bananza. Rebuild a game to use it; its shaders are prepared again. - After a game is rebuilt and played with this engine, an older build of that game may not read some of its saves.
- Games the engine has no profile for are accepted with a provisional one, marked Not tested with this engine yet.
- Newest engine in Settings → Engine lets you try nxnative's latest version before NX Library has tested it. Back to tested returns to the tested engine at any time.
- Hold Home for 2 seconds, then A, to quit a game with the controller.
Fixes
- Refreshing the library no longer takes minutes for large games on an external drive.
- The Cheats switch no longer shows an error for a game without a cheat file.
Updating keeps your library and preferences. Existing game apps remain playable and are not rebuilt automatically. 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.
0.1.2
- Ajout de la détection automatique des applications nxnative dans les sous-dossiers du répertoire Game apps, avec une action unique Scan game apps et des explications en paramètres.
- Masquage automatique du curseur en plein écran après trois secondes d’absence de mouvement, réapparition à tout déplacement.
- Intégration des menus natifs pour conserver la sélection de jeu et accéder aux onglets Details et Options via la navigation standard.
- Option Start in fullscreen ajoutée dans Settings → Start-up pour lancer automatiquement en plein écran.
- Mise à jour de l’interface de vérification des mises à jour avec des notes de version scrollables et une gestion des erreurs réessayables.
- Mise à jour de nxnative incluant des corrections audio, d’alignement mémoire, de rendu/shaders et des profils mis à jour.
A small usability update, with a verified upstream engine upgrade.
Library and controls
- Discover existing nxnative apps inside subfolders of Game apps. One Scan game apps action handles discovery and refresh; skipped folders are explained in Settings without repeated launch popups.
- In fullscreen, the pointer hides after three seconds without movement and returns when you move the mouse. Keyboard and controller navigation keep it hidden.
- Native menus preserve the selected game and open Details and Options through the normal navigation flow.
- Choose Start in fullscreen in Settings → Start-up for the next app launch.
Updates
- NX Library → Check for Updates… opens the same dialog as Settings → About, with scrollable release notes, a clear up-to-date result and retryable errors.
Engine
- Updated nxnative to
b64a5ff0, including audio-start and memory-alignment fixes, renderer/shader corrections, updated profiles and shader-build improvements. - Cache cleanup now shows its activity without an unreliable ETA. New key diagnostics distinguish outdated keys from a missing package ticket.
- Xcode 27.2 and certified Metal
32023.922remain the build requirements.
Updating the launcher keeps your library and preferences. Existing game apps remain playable and are not rebuilt automatically; rebuild a game to apply the new engine to it. Setup can prepare the newly required engine checkout.
Use the DMG for a first installation. Installed release copies can update from Settings → About → Check now; automatic checks run at most once every 24 hours.
0.1.1
- Ajout du décodage automatique des vidéos AV1 avec dav1d en cas d’absence de décodage matériel.
- Corrections des shaders et du rendu, incluant la gestion du temps de vie des pools de textures et des pipelines primitive-ID.
- Renforcement de la réécriture des tables de saut et de l’arrêt des travailleurs.
- Prise en charge des compute-shaders dans Unity 2020.3 et mise à jour des profils de jeux.
- Fichier DMG fourni pour une nouvelle installation (signature alpha, non notarisée).
nxnative engine update
NX Library 0.1.1 updates its pinned nxnative engine to 65501fbb.
- Automatic AV1 movie decoding with dav1d when hardware decoding is unavailable.
- Shader and rendering fixes, including texture-pool lifetime handling, geometry batching and primitive-ID pipelines.
- More robust jump-table rewriting and worker shutdown.
- Updated game profiles and Unity 2020.3 compute-shader support.
The build requirements remain Xcode 27.2 and certified Metal 32023.922. After updating NX Library, use Setup to prepare the required engine when prompted. Existing game apps remain playable; rebuilding applies the new engine to a game.
Download the DMG for a new installation. Installed release copies can update from Settings → About; the ZIP is used by the in-app updater. This alpha is ad-hoc signed and not notarised.
See the changelog for details. Games, firmware and keys are not included.
0.1.0
- Interface utilisateur complète avec vues Spotlight et Collection, recherche, favoris, affichage des artworks et historique des sessions de jeu.
- Système de configuration en deux étapes incluant un jeu d’exemple par défaut et un dossier partagé pour les applications et builds existants.
- Intégration de builds locaux avec vérification des sources, suivi du progrès, annulation et réessais d’installation.
- Options de lancement personnalisées par jeu (cheats, sauvegardes locales, prévisualisation des imports de sauvegardes).
- Système de thèmes, fonds d’écran statiques/dynamiques, sons d’interface et prompts de contrôleur.
- Canal de mises à jour d’application public sans nécessiter de compte GitHub.
First public alpha
NX Library is a macOS frontend for organising your game apps, preparing your own supported game files with nxnative and launching them from one library.
Downloads
- NXLibrary-0.1.0.dmg — first installation. Open the image and drag NX Library to Applications.
- NXLibrary-0.1.0.zip — the verified app archive used by the in-app updater.
Included
- Spotlight and Collection views, search, favourites, artwork and play activity.
- Two-step setup, with an optional first game and a shared folder for existing game apps and new builds.
- Local builds with source review, progress, cancellation and installation retries.
- Per-game launch options, cheats, local save backups and save-import previews.
- Themes, static and live backgrounds, interface sounds and controller prompts.
- A public app-update channel that needs no GitHub account.
Requirements and installation
Apple silicon and macOS 13 or later. Building games also requires Xcode 27.2, the certified Metal compiler, .NET 10 and the pinned nxnative engine; Setup guides you through the supported steps. Existing game apps can be played without the build tools or original sources.
This alpha is ad-hoc signed and not notarised. If macOS blocks first opening, use System Settings → Privacy & Security → Open Anyway only after confirming that you obtained this copy from this repository. Games, keys and firmware are not included.
See the README for the illustrated guide and changelog for the full list of changes. Please report reproducible problems through the repository's issue template; do not attach games, keys or private files.
Réagir sur le forum
Une question, un retour d’expérience ? Ouvrez la discussion sur le forum.