Skip to content
VGioMPublic

About

Interface graphique (Mac) pour nxnative : jeux Switch en apps Mac/iPhone, sans NX2Apple

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

35 Commits

Folders and files

Repository files navigation

Atelier NX

Interface graphique simple pour nxnative (le projet d'origine) : on choisit un jeu Switch, la langue, la mise à jour et les DLC, et on clique sur Construire.

Atelier NX

  • Liste les jeux Switch de tout le dossier, sous-dossiers compris, avec leurs mises à jour et DLC où qu'ils soient rangés. L'identifiant est lu dans le fichier (ticket du NSP, en-têtes NCA d'un XCI ou d'un NSP sans ticket, déchiffrés avec prod.keys), sinon dans le nom ([title ID]). Jeux groupés « avec profil » / « sans profil », archives .zip décompressables.
  • Jaquettes lues dans le jeu lui-même, sans site tiers : l'icône du NCA Control du fichier de base (NSP ou XCI, déchiffré avec prod.keys), dans la langue des Réglages (sinon en anglais), extraite en arrière-plan pour chaque jeu qui n'a pas encore d'icône. Après un build Mac, l'icône de l'app la remplace. Rien pour les NSZ/XCZ et les NUP.
  • Construit une app Mac ou une IPA avec scripts/build_ipa_from_nsp.py, en choisissant la langue, la mise à jour et les DLC, avec la progression en direct (--progress json).
  • File de construction : « Construire » ajoute le jeu à la file avec ses options (langue, mise à jour, DLC, options avancées) ; les builds s'enchaînent, un échec n'arrête pas la file. Ordre modifiable, pause, historique. La file est gardée sur disque (queue.json) : quitter pendant un build le remet en tête, file en pause.
  • « Construire plusieurs jeux » : une ligne par jeu (Mac, iPhone ou les deux, mise à jour, DLC), filtres (avec profil, jamais construits, à reconstruire) et recherche ; un clic ajoute tout à la file.
  • Options avancées : build Mac rapide (seulement les shaders vus pendant les tests de nxnative, --seen-shaders), shaders en fichiers séparés pour AltServer (--shader-files), sans détection de mouvement, fichiers du jeu à part sur iPhone, compteur d'images coupé au démarrage sur iPhone (--no-show-fps), fichiers endommagés acceptés.
  • Place disque des builds : sur la fiche d'un jeu, la taille de ses fichiers de build et de ce que nxnative n'utilise plus (dossier obsolete), avec « Supprimer les fichiers inutilisés » ou « Tout supprimer » (le prochain build réextrait le jeu ; l'app et la sauvegarde ne sont pas touchées). Dans Réglages : le total par jeu, le dossier obsolete vidé automatiquement après chaque build réussi (désactivable), un bouton pour supprimer les fichiers de build de tous les jeux, et une case pour supprimer ceux d'un jeu dès son build réussi (sauf iPhone avec fichiers du jeu à part, dont l'image RomFS est copiée sur le téléphone depuis le dossier de build).
  • Conteneurs .nup (jeu, mises à jour et DLC en un seul fichier) : lus avec scripts/pack_nup.py de nxnative, construits sans prod.keys.
  • Builds en priorité basse (nice -n 10, réglable) : ils prennent le processeur libre sans faire ramer les autres apps.
  • Bouton « Jouer », journal du jeu, dossier de sauvegarde du jeu (pour en faire une copie).
  • « Réglages du jeu » : les réglages de la fenêtre de lancement nxnative (liste lue dans launcher.json), pré-remplis via les choix enregistrés de l'app (launcher.<VAR>), sans les bloquer. Réglages par défaut appliqués automatiquement à chaque nouveau build Mac. env.txt reste accessible pour forcer un réglage.
  • Modules Python de nxnative installés tout seuls : la liste est lue dans le script de nxnative (ses vérifications et sa ligne pip install), donc un module ajouté par une future version (comme zbic) est pris en compte sans mise à jour d'Atelier NX. Vérifiée au lancement, après chaque mise à jour de nxnative et avant chaque build (rien n'est relancé tant que ni le Python ni nxnative ne changent) ; ce qui manque est installé dans le Python des Réglages avec uv pip (sinon pip, installé au besoin par ensurepip). Si un build échoue quand même sur un module manquant, il est installé et le jeu relancé une fois. Si l'installation échoue, la file se met en pause avec un seul message et un bouton « Réessayer », au lieu de faire échouer tous les jeux un par un.
  • Vérifie et installe les mises à jour de nxnative (git pull), et signale les jeux construits avec une ancienne version : nombre de changements depuis le build, et ceux qui citent le jeu (son profil, son nom ou son identifiant dans le message), avec un lien vers chacun sur GitHub. Une app déplacée est retrouvée dans le dossier des apps des Réglages.
  • « Compatibles que tu n'as pas » : les jeux qui ont un profil nxnative et ne sont pas dans le dossier (branche distante lue par git fetch toutes les 6 h, variantes régionales fusionnées, « nouveau » pour les profils arrivés depuis la dernière mise à jour du clone), triés de A à Z ou par date d'arrivée du profil. Un clic ouvre le profil sur GitHub.

Fonctionnement

  • server.py : serveur local (127.0.0.1, jeton par session) qui lance nxnative ; bibliothèque standard Python, plus pycryptodome (déjà requis par nxnative) pour lire les en-têtes NCA.
  • index.html : la page.
  • App/main.swift : la fenêtre Mac (WKWebView, interface sombre) qui démarre le serveur et le coupe en quittant ; réutilise un serveur déjà lancé (server.json).
  • App/icon/make_icon.swift : dessine l'icône (App/AppIcon.icns).

Le script de nxnative attend un dossier par jeu : Atelier NX crée nxnative-build.noindex/<title ID>/ (« .noindex » : Spotlight ignore ses milliers de fichiers) avec des liens symboliques vers les fichiers choisis. Le dossier <title ID>_build que nxnative y crée garde l'extraction pour les builds suivants. Les apps vont dans Apps/.

Réglages et état : ~/Library/Application Support/AtelierNX/ (config.json, state.json, queue.json, catalog.json, icônes). La variable ATELIERNX_SUPPORT permet d'utiliser un autre dossier (tests).

Installation

  1. Prérequis de nxnative : Mac Apple Silicon, Xcode 27.1 et sa chaîne Metal, Homebrew, et votre propre prod.keys (extrait de votre console).
    brew install xcodegen zstd glslang dotnet-sdk python@3.13
    
  2. Cloner nxnative et lui créer un environnement Python (3.12 ou plus) :
    git clone https://github.com/seedds/nxnative ~/nxnative
    cd ~/nxnative
    /opt/homebrew/bin/python3.13 -m venv .venv
    .venv/bin/pip install lz4 capstone fonttools nsz pycryptodome
    
  3. Télécharger Atelier NX dans les releases (ou le compiler, voir plus bas) et le mettre dans Applications. Au premier lancement, autorisez-la dans Réglages Système → Confidentialité et sécurité → « Ouvrir quand même » (l'app n'est pas notarisée par Apple). Ensuite, l'app vérifie elle-même au lancement s'il existe une nouvelle version et propose de l'installer (menu de l'app → « Rechercher les mises à jour… »).
  4. Dans Réglages, choisir le dossier des jeux Switch (NSP/XCI, sous-dossiers compris) et prod.keys.

Valeurs par défaut : nxnative dans ~/nxnative, Python = ~/nxnative/.venv/bin/python (sinon le premier python3.12+ de Homebrew), clés dans ~/.switch/prod.keys. Les apps construites vont dans <dossier des jeux>/Apps, les fichiers de build dans <dossier des jeux>/nxnative-build.noindex (prévoir environ 2 × la taille du jeu + 10 Go) ; les deux se changent dans Réglages.

Compiler

./build.sh            # dist/Atelier NX.app
./build.sh install    # et copie dans /Applications

Sans l'app : python3 server.py --open ouvre la page dans le navigateur.

Publier une version

./signing-cert.sh        # une seule fois par Mac : crée le certificat local
./release.sh 1.4.0       # build, tests, commit « Version 1.4.0 », tag, release GitHub
./release.sh 1.4.0 notes.md   # avec des notes écrites à la main

La release contient AtelierNX-<version>-macOS-arm64.zip (nxnative ne fonctionne que sur Mac Apple Silicon, il n'y a pas d'autre plateforme). Les apps déjà installées la trouvent via l'API GitHub et proposent de l'installer (SelfUpdate.swift, le même fichier dans Biblifilm, Biblijeu, Atelier NX et Recomps). Elles n'acceptent qu'une version signée avec le même certificat que la leur : il faut donc garder ce certificat (« VGioM Local Signing », dans le trousseau de session ; à exporter avec sa clé privée en lieu sûr). Une release signée avec un autre certificat devrait être réinstallée à la main par chacun.

About

Interface graphique (Mac) pour nxnative : jeux Switch en apps Mac/iPhone, sans NX2Apple

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages