Pubblicato un nuovo aggiornamento per Goldleaf, il noto strumento multiuso per console Nintendo Switch sviluppato dal developer XorTroll, spesso paragonato a FBI su Nintendo 3DS per la sua completezza e per il ruolo centrale che ricopre nella scena homebrew.

Nel tempo Goldleaf si è affermato come una delle applicazioni più versatili per la gestione avanzata del sistema, offrendo un’interfaccia chiara e una vasta gamma di funzioni pensate sia per utenti esperti sia per chi muove i primi passi nel modding della console.

Sorry for taking too long, but it's finally time to drop new releases of emuiibo, uLaunch and Goldleaf!

All of them fix any compatibility issues due to recent firmware updates, are compiled with the latest libraries, and also introduce a few new features! Go check them out!

— XorTroll (@XorTroll) December 22, 2025

Goldleaf consente di navigare nei file system della NAND e della scheda SD, installare file NSP relativi a giochi, aggiornamenti e contenuti aggiuntivi, gestire i ticket con possibilità di esportazione e svolgere numerose altre operazioni di manutenzione e organizzazione del sistema.

Questo lo rende uno strumento essenziale per chi utilizza Atmosphère e desidera avere un controllo completo sui contenuti installati e sulle risorse della console.

La nuova versione si concentra su un mix equilibrato di compatibilità, stabilità e miglioramenti dell’esperienza utente. L’applicazione è stata aggiornata alle più recenti versioni di libnx, garantendo il supporto almeno fino al firmware 21.1.0.

Corretti inoltre diversi problemi critici che potevano causare crash, come quelli legati alla selezione di alcune lingue di sistema, tra cui russo e taiwanese, o alla presenza di partizioni SAFE non montabili, che ora non vengono più caricate all’avvio.

Un cambiamento importante riguarda la procedura di installazione dei contenuti, che è stata riprogettata internamente per scrivere prima i dati e modificare solo successivamente i record di sistema.

In questo modo, in caso di errore, è sufficiente rimuovere i contenuti già scritti senza rischiare inconsistenze nei record, migliorando notevolmente l’affidabilità delle installazioni.

Sono state inoltre corrette imprecisioni nel codice di rilevamento delle chiavi, vecchi bug legati ai dump e problemi nell’accesso ai percorsi del PC.

L’aggiornamento introduce anche diverse migliorie orientate alla comodità d’uso. Il menu di selezione della lingua personalizzata ora mostra i nomi reali delle lingue invece dei semplici codici, è possibile regolare la velocità di navigazione dei menu tramite joystick e viene offerta l’opzione di saltare automaticamente gli NSP già installati durante le installazioni multiple.

Tra le novità più interessanti c’è anche la possibilità di dumpare Amiibo non ancora inizializzati, semplicemente fornendo un nome e un Mii, ampliando le funzionalità legate alla gestione dei contenuti NFC.

Sul fronte della localizzazione, Goldleaf aggiunge il supporto allo spagnolo latinoamericano e aggiorna le traduzioni coreane e spagnole.

Caratteristiche principali

Esploratore dei contenuti: Un browser del filesystem facile da usare ma completo.

Posizioni/dispositivi supportati

• Scheda SD.
• Memoria della console (partizioni SAVE, SYSTEM, USER e PRODINFOF).
• Sistemi remoti (tramite strumenti remoti come Quark).
• Unità USB (grazie a libusbhsfs).
• Dati salvati dei giochi (sola lettura, consulta di seguito come montarli).
• NRO homebrew RomFs (sola lettura).

Nota: Tutto verrà automaticamente smontato quando Goldleaf verrà chiuso.

Funzionalità

• Operazioni di base sui file: Creazione, eliminazione, copia, rinomina, visualizzazione come esadecimale/testo, dimensioni, ecc..
• Operazioni di base sulle cartelle: Creazione, eliminazione, copia, rinomina, impostazione/cancellazione bit archivio, dimensioni complete, ecc..
• Installa pacchetti NSP di applicazioni/giochi, aggiornamenti, contenuti aggiuntivi/DLC, ecc.. (Nota: Utilizzare con cautela e assicurarsi di sapere cosa si stia facendo).
• Avvia altri homebrew NRO e monta le loro RomFs (opzione menzionata sopra).
• Esegui file .bin come payload RCM (riavvia con essi).
• Imposta file JPG/JPEG come icone utente (Nota: Utilizzare con cautela e assicurarsi di sapere cosa si stia facendo).

Gestore dei contenuti: Un gestore dei contenuti facile da usare ma completo:

• Operazioni di base sui contenuti (programma, aggiornamento, DLC, ecc..):
  • Visualizza le informazioni sul contenuto (ID, dimensioni, versione, statistiche di gioco…).
  • Disinstalla/rimuovi completamente il contenuto (non rimuove i dati salvati).
  • Esporta i contenuti esistenti in un pacchetto NSP.
  • Monta i dati salvati per navigarvi (consulta l’Esploratore dei contenuti sopra).
  • Rimuovi il ticket se presente (Nota: Utilizzare con cautela e assicurarsi di sapere cosa si stia facendo).
  • Reimposta la versione di avvio (utile per poter giocare a un gioco di base dopo che un aggiornamento è stato rimosso).
  • Nota: Alcune di queste operazioni non sono disponibili con i contenuti del sistema o della scheda di gioco.
  • Controlla i ticket inutilizzati e rimuovili (Nota: Utilizzare con cautela e assicurarsi di sapere cosa si stia facendo).

Browser web: Usa l’applet web della console:

• Sfoglia URL inviati dagli utenti.
• Crea e salva segnalibri.

Nota: Il browser web è garantito solo per funzionare correttamente quando viene avviato come applicazione.

Gestore account: Seleziona un utente (o utilizza quello preselezionato se presente) e gestiscilo:

• Cambia il nickname.
• Visualizza la sua icona.
• Elimina l’utente (ovviamente solo se ce ne sono più di uno nel sistema!) Nota: Per cambiare l’icona dell’utente, consultare l’Esploratore dei contenuti sopra.

Dump di Amiibo: Crea un Amiibo virtuale (per emuiibo) da una vera statuetta Amiibo.

Impostazioni: Controlla le impostazioni del sistema e di Goldleaf:

• Firmware e aggiornamenti:
  • Controlla le informazioni sul firmware attuale (versione, hash, generazione chiave).
  • Controlla gli aggiornamenti in sospeso e (se desiderato) rimuovili se presenti.
  • Esporta i dati del firmware attuale o dell’aggiornamento in sospeso.
  • Memoria: Controlla lo spazio libero e totale in diverse posizioni.
  • Impostazioni di Goldleaf: Controlla le impostazioni presenti in settings.json.
  • Aggiornamenti: Controlla gli ultimi aggiornamenti di Goldleaf e (se desiderato) aggiorna a una nuova versione se esiste.
  • Informazioni: Controlla la versione di Goldleaf e come è stato avviato (come applet o applicazione).

Goldleaf è stato tradotto in 11 lingue diverse finora: inglese, spagnolo, tedesco, francese, italiano, olandese, giapponese, portoghese, coreano, cinese tradizionale e cinese semplificato.

Controlli

Comuni

• // – Sposta nel menu corrente.
• / – Mostra un dialogo per spegnere o riavviare la console.
• – Mostra un dialogo con queste informazioni di controllo.
• – Esci dall’applicazione per tornare in hbmenu.

Esploratore dei contenuti

• – Smonta la posizione selezionata (solo quando è selezionata una posizione montata manualmente).
•  – Seleziona la cartella (potrebbe richiedere un po’ di tempo con cartelle con molti sotto-elementi).

Domande frequenti

Assicurati di controllare queste domande prima di segnalare un problema!

Installazioni NSP

Domanda: Continuo a ricevere errori ‘NCA non valido’/’sigpatches mancanti’ o errori strani di FS/ETicket…

Risposta: Controlla quanto segue:

• Il file NSP è stato convertito da XCI (utilizzando strumenti come 4NXCI)? Allora hai bisogno di patch extra.
• Hai tutte le patch richieste?
• Se hai appena aggiornato a una nuova versione della console e si verifica questo errore, provare a scaricarle nuovamente.

Domanda: Goldleaf si blocca e Quark non risponde/si lamenta quando lo avvio…

Risposta: Hai impostato correttamente il dispositivo USB? Controlla come farlo qui.

Se hai impostato correttamente il dispositivo USB, Quark non dovrebbe lamentarsi. Se lo fa, provare a eseguire nuovamente l’impostazione per assicurarsi che sia fatta correttamente.

Inoltre, assicurati di avviare Quark dopo aver avviato Goldleaf. Goldleaf deve essere aperto prima. Stai usando l’ultima versione sia di Goldleaf che di Quark? Verifica nuovamente, poiché questo è un errore molto comune.

Domanda: Non riesco a avviare Quark/Quark mi sta dando errori su Linux…

Risposta: Quark è un po’ problematico su Linux. Assicurati di controllare l’impostazione per ulteriori informazioni sulla questione.

Avvertenza

Installazione di file NSP

Ricordarsi sempre che installare pacchetti NSP può essere un modo molto facile per essere bannato. Se utilizzi la modalità aereo e DNS speciali come 90DNS, ci sarà una probabilità minore di essere bannato.

Non installare mai NSP non affidabili. Goldleaf non effettuerà alcuna verifica speciale, fare molta attenzione nell’installazione di pacchetti non affidabili.

Ticket

I ticket rappresentano un acquisto di un gioco, tecnicamente parlando, non puoi avviare un titolo se il ticket non è presente e il titolo lo richiede (i titoli ufficiali li richiedono). I pacchetti NSP che non hanno o hanno bisogno di un ticket sono crittografati in modo standard.

Goldleaf mostrerà se un ticket è presente o meno e, in caso affermativo, la sua chiave del titolo. Le chiavi del titolo sono necessarie per decrittare e accedere al contenuto di un titolo. Altrimenti, non sono decifrabili e quindi non possono essere avviati dal sistema.

Quark e navigazione remota

Quark è lo strumento Java desktop di Goldleaf, che funge da client desktop per l’opzione PC remoto. Supporta Windows, Linux e Mac.

Il programma ha bisogno di Java 9 o superiore per funzionare. Vedere di seguito l’installazione consigliata per ogni sistema supportato. Bisogna andare ad installare anche i driver libusbK per far funzionare bene la connessione USB.

Windows

Il modo migliore per installare Java 9 in Windows (o uno molto semplice) è installare AdoptOpenJDK 11 o superiore.

Nota: Assicurarsi che la versione di JDK/JRE che viene scelta contenga JavaFX, è possibile sempre installarlo manualmente in caso contrario.

Dopo l’installazione, fare doppio clic sul file JAR dovrebbe essere sufficiente per avviarlo. In caso contrario, eseguire java -jar Quark.jar nel prompt dei comandi.

Perché l’USB venga riconosciuta, seguire i seguenti passaggi:

• Scarica Zadig.
• Avviare la console con Custom Firmware e collegarla al PC tramite USB.
• Eseguire Goldleaf.
• Con Zadig, selezionare il dispositivo chiamato “Goldleaf” (se non appare, assicurarsi che Goldleaf abbia un’icona USB in alto sullo schermo e selezionare “Mostra tutti i dispositivi” in “Opzioni” in Zadig).
• Installare libusbK su quel dispositivo (nessun altro driver funzionerà bene).

Linux

Installare OpenJDK 11 (o superiore) dal terminale:

• Digitare sudo add-apt-repository ppa:openjdk-r/ppa
• Digitare sudo apt-get update
• Infine, digitare sudo apt-get install openjdk-11-jdk (se si desidera solo JRE, installare invece openjdk-11-jre).
• Creare il file /etc/udev/rules.d/99-switch.rules con il seguente contenuto: SUBSYSTEM=="usb", ATTRS{idVendor}=="057e", ATTRS{idProduct}=="3000", GROUP="plugdev"
• Ricaricare le regole di udev con: sudo udevadm control --reload-rules && sudo udevadm trigger

Ora è possibile eseguire Quark utilizzando il comando java -jar Quark.jar.

Mac

Installare OpenJDK 11 (o superiore) nel terminale:

• Installare brew /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
• Eseguire brew tap AdoptOpenJDK/openjdk
• Eseguire brew install adoptopenjdk11 --cask
• Infine, eseguire java -version per verificare la versione di JDK.

Ora è possibile eseguire Quark utilizzando il comando java -jar Quark.jar.

Impostazioni

Goldleaf supporta la personalizzazione di colori, risorse e altre opzioni tramite un file JSON situato nella cartella di Goldleaf: sd:/switch/Goldleaf/settings.json.

Esempio

Questo è un esempio di JSON per le impostazioni di Goldleaf:

{
    "general": {
        "customLanguage": "es",
        "externalRomFs": "/switch/Goldleaf/theme/rom",
        "use12hTime": true
    },
    "ui": {
        "background": "#aabbccdd",
        "base": "#aabbccdd",
        "baseFocus": "#aabbccdd",
        "text": "#aabbccdd",
        "menuItemSize": 80
    },
    "installs": {
        "ignoreRequiredFwVersion": false,
        "copyBufferMaxSize": 10485760
    },
    "export": {
        "decryptBufferMaxSize": 10485760
    },
    "web": {
        "bookmarks": [
            {
                "name": "Google",
                "url": "https://www.google.com"
            },
            {
                "name": "GitHub",
                "url": "https://www.github.com"
            }
        ]
    }
}

Se un certo attributo non è presente, Goldleaf utilizzerà i valori predefiniti. Per i colori, Goldleaf caricherà inizialmente temi predefiniti chiari/oscuri in base al colore del tema della console e successivamente utilizzerà i colori presenti nel JSON anziché quelli predefiniti.

Note

Attraverso la sostituzione di RomFs, quando Goldleaf cerca di individuare, ad esempio, romfs:/FileSystem/FileDataFont.ttf, se romfsReplace è true e romfsReplacePath è, ad esempio, /switch/Goldleaf/testromfs, Goldleaf verificherà se esiste sd:/switch/Goldleaf/testromfs/FileSystem/FileDataFont.ttf e lo utilizzerà in caso contrario userà quello di RomFs.

Quindi, tramite queste configurazioni, possono essere utilizzate immagini dell’interfaccia utente, risorse, dimensioni degli elementi e persino traduzioni (utilizzando traduzioni JSON personalizzate) personalizzate, oltre ad alcuni altri asset che potrebbero essere aggiunti in future aggiornamenti.

Bug noti

L’uscita da Goldleaf tramite il menu HOME (come NRO) sembra bloccare il sistema su firmware 7.x a causa di un errore USB strano presente su quelle versioni specifiche. Nessun firmware non 7.x sembra avere questo problema.

Changelog

• Aggiornato con l’ultima versione di libnx, con supporto (almeno) fino al firmware 21.1.0.
• Risolto un problema che causava il crash di Goldleaf dopo la selezione (o l’utilizzo del sistema) delle lingue russa e taiwanese.
• Risolto un problema per cui Goldleaf andava in crash immediatamente se la partizione SAFE dell’utente non era montabile; ora tali partizioni non vengono montate all’avvio.
• La procedura di installazione è stata modificata internamente: i contenuti vengono scritti prima di qualsiasi modifica ai record, così in caso di problemi è necessario rimuovere solo i contenuti già scritti senza alterare i record.
• Corretto un errore minore nel codice di rilevamento della generazione delle chiavi.
• La finestra di dialogo “lingua personalizzata” ora mostra i nomi reali delle lingue, invece dei soli codici, rendendo la selezione più leggibile.
• Risolto un problema per cui Goldleaf accedeva in modo errato ai percorsi del PC, utilizzando quello elencato sotto anziché quello effettivamente selezionato.
• Aggiunta un’opzione di configurazione per modificare la velocità di navigazione dei menu tramite joystick.
• Corretto un vecchio bug nei dump con sostituzione totale, in cui le stringhe coreane mostravano “g_Clipboard” invece di “clipboard”.
• Aggiunta un’opzione per saltare automaticamente gli NSP già installati durante le installazioni multiple di NSP.
• Aggiunta la possibilità di dumpare gli Amiibo anche se non sono ancora stati inizializzati, permettendo all’utente di fornire manualmente il nome dell’Amiibo e il Mii.
• Aggiunto il supporto alla lingua spagnola latinoamericana.
• Aggiornate le traduzioni coreane e spagnole.

Download: Goldleaf v1.2.0

Download: Quark v1.2.0

Download: Source code Goldleaf v1.2.0