Home Homebrew Rilasciato uLaunch v1.2.1

[Scena Switch] Rilasciato uLaunch v1.2.1

9 Giugno 2025 Data modificata: 9 Giugno 2025

Pubblicato un nuovo aggiornamento per uLaunch, la reimplementazione personalizzata e open-source di qlaunch (il menu HOME della console Switch) sviluppato del developer XorTroll.

uLaunch è un progetto che mira a sostituire il menu HOME della console Switch con uno personalizzato e orientato verso gli homebrew.

I've just released uLaunch v1.2.1! This version is mostly a support update fixing (hopefully most) slowdowns the previous release had, and working with latest Atmosphère (and fw 20.1.0). Go check it out! https://t.co/aISSZ0ktB6

— XorTroll (@XorTroll) June 9, 2025

In questa versione, uLaunch è stato ricompilato per garantire la piena compatibilità con la versione 1.9.1 di Atmosphère e il firmware 20.1.0, mentre una delle novità più importanti riguarda l’introduzione di un nuovo sistema di caching per le icone dei giochi e i dati NACP (titolo, autore, descrizione ecc..).

Questo sistema mira ad aggirare i rallentamenti introdotti dalle modifiche apportate nel firmware 20.x, che rendevano lento il caricamento delle icone.

Ora i dati vengono memorizzati in uSystem, aumentando l’uso di memoria da 12MB a circa 40MB, ma permettendo così di gestire in modo fluido fino a circa 200 giochi installati.

Chi possiede un numero superiore di titoli può comunque aprire una segnalazione per richiedere un’ulteriore estensione del limite di cache, visto che in teoria è possibile spingersi fino a 50MB.

Nonostante l’aumento del consumo di memoria, non ci sono impatti negativi: uLaunch continua a utilizzare meno risorse del menu HOME originale, e in molti casi offre prestazioni più fluide.

Sono stati corretti anche diversi bug, tra cui uno che causava rallentamenti notevoli con molte applicazioni installate (anche con solo una decina), dovuti a un comando richiamato ad ogni frame per ogni gioco visibile nel menu.

Ora il valore viene letto una sola volta durante il caricamento iniziale delle app, migliorando sensibilmente le prestazioni.

Inoltre, è stato risolto un errore per cui il tema attivo veniva memorizzato nella cache solo se non lo era già, mentre in realtà uSystem cancellava tutta la cache a ogni riavvio: ciò comportava il caricamento ripetuto del tema a ogni avvio della console.

Infine, è stato corretto un comportamento anomalo per cui il tema predefinito, in alcune circostanze, veniva erroneamente considerato obsoleto.

Caratteristiche

Funzionalità personalizzate

Sistema di login utente (accedi una volta, usa quell’utente per tutto).
Menu principale a griglia, ispirato profondamente al menu 3DS (e parzialmente ai menu DSi/Wii), più facile che mai da navigare e personalizzare.
- La griglia può essere ridimensionata come nei menu 3DS.
- Le voci possono essere spostate a piacere.
Cartelle, sottocartelle…
Homebrew lanciabile direttamente dal menu principale come applet o applicazione (utilizzando applicazioni come donatori).
Supporto estensivo per la personalizzazione dei temi.
- Sfondi, icone, ecc..
- BGM e molti effetti sonori.
Browser web facilmente accessibile direttamente dal menu principale.
Editor Mii facilmente accessibile direttamente dal menu principale.
Supporto per la cattura dello schermo su PC tramite USB.
Visualizzazione della versione di sistema + versione di Atmosphère + presenza di EmuMMC in modo indipendente e più chiaro.
Migliore visualizzazione quando la scheda di gioco non riesce a montarsi.
Risoluzione a 1080p.

Caratteristiche di base implementate

Elenco delle funzioni del menu HOME ufficiale implementate:

Avvio, sospensione e chiusura delle applicazioni.
Avvio e chiusura degli applet.
Pagina utente.
Supporto per i controller.
Impostazioni (finora ne sono state implementate solo alcune):
- Versione della console.
- Versione di Atmosphère.
- Presenza di EmuMMC.
- Soprannome della console.
- Fuso orario della console.
- Nome della connessione WiFi/Impostazioni WiFi.
- Lingua della console.
- Upload delle informazioni della console (abilita/disabilita).
- Bluetooth (abilita/disabilita).
- NFC (abilita/disabilita).
- Download automatico delle applicazioni (abilita/disabilita).
- Aggiornamento automatico della console (abilita/disabilita).
- LAN wireless (abilita/disabilita).
- Numero di serie della console.
- Mostra indirizzo IP/MAC della console.
Messaggi generali per i canali/gli applet (alcuni non sono ancora implementati):
- Rilevamento del pulsante HOME.
- Spegnimento, sospensione, riavvio.
- Rimozione della scheda SD.
- Fallimento nel montare la scheda di gioco.

Funzionalità di base non implementate

Elenco delle funzionalità non implementate del menu HOME ufficiale:

Pianificate per essere implementate

Sospensione automatica dopo un certo periodo di tempo.
Diverse impostazioni non implementate.
Diversi messaggi generali per i canali/gli applet non implementati.
Aggiornamento della console.

Non pianificate per essere implementate (almeno per ora)

Funzionalità eShop.
Controllo genitori.
Aggiornamenti delle applicazioni (giochi).

Installazione

Installazione di uLaunch

Scaricare l’archivio .zip.
- Nota: Questo progetto è rilasciato e destinato all’uso con Atmosphère, quindi usalo con CFW diversi a tuo rischio.
Copiare tutto ciò che è all’interno dell’archivio .zip all’interno della scheda SD.
- Se non hai mai usato uLaunch o nessun tipo di sostituto del menu HOME (NXThemes non contano), non dovrai sovrascrivere nessun file.
- Non è necessario rimuovere i tuoi temi normali del menu HOME (NXThemes) per installare uLaunch. Questi temi sono in una directory romfs all’interno di contents/0100000000001000, mentre l’unico file di uLaunch in quella cartella è contents/0100000000001000/exefs.nsp.
Avviare il CFW (utilizzando emuMMC o sysMMC non dovrebbe fare differenza) e goditi il tuo nuovo menu HOME!

Rimozione di uLaunch

Importante: Assicurarsi di non rimuovere altro se non ciò che è menzionato qui, per evitare potenziali problemi!
- Se si desidera mantenere i propri temi personalizzati, le voci del menu, la configurazione, ecc.., utilizzare semplicemente lo strumento uManager per disabilitare uLaunch. Questo non rimuove alcun dato, permettendoti di riattivarlo in qualsiasi momento.
- Se desideri rimuovere tutto permanentemente, allora dovrai rimuovere le cartelle atmosphere/contents/0100000000001000 e ulaunch sulla scheda SD. Se si desidera rimuovere anche uManager, allora rimuovere anche switch/uManager.nro.
- Nota: Se si usa qualsiasi modifica del menu HOME – come NXThemes – assicurarsi di non eliminare l’intera cartella 0100000000001000, solo il file exefs.nsp!

FAQ

uLaunch mi dà uno schermo nero. Come posso risolverlo?

Innanzitutto, assicurarsi di utilizzare l’ultima versione rilasciata di uLaunch.
Se sono stati rilasciati nuovi aggiornamenti del firmware o nuove versioni di Atmosphère, potrebbe essere necessario attendere una nuova versione, e nel frattempo potreste essere in grado di utilizzare build di sviluppo/test dal nostro server Discord.
I file di log generati dai componenti di uLaunch all’interno della cartella ulaunch possono essere molto utili quando condividi il tuo problema su Discord o GitHub. Assicurati di non riavviare di nuovo in uLaunch, poiché i file di log verranno sovrascritti! Altrimenti, replica il bug e condividi/copia i file di log prima di ricaricare qualsiasi cosa.
In casi più estremi, gli schermi neri di uLaunch potrebbero essere causati da una gestione errata dei file JSON di tema/voce non validi. I file JSON potrebbero essere stati corrotti (a causa di ExFAT, altri homebrew…) quindi provare ad eliminarli.

Perché non posso accedere alle solite impostazioni di sistema, mentre posso accedere ad altri menu di sistema normali come l’album, l’editor Mii, la pagina utente, ecc..?

Questo è uno sfortunato problema tecnico. Mentre il browser web, la pagina utente, l’album… sono applet separati (programmi separati, indipendenti dal menu HOME stesso) le impostazioni di sistema fanno effettivamente parte del menu HOME stesso. Pertanto, dobbiamo implementare manualmente tutte loro… il che richiede sforzo, quindi solo alcune delle impostazioni disponibili (più qualche extra) sono attualmente disponibili qui, mentre le restanti impostazioni sono in fase di reverse engineering e implementazione.

L’utilizzo di uLaunch mi farà bannare online?

Ci sono stati alcuni casi in cui l’utilizzo di uLaunch potrebbe aver causato ban. Tieni presente che sostituire la funzionalità del menu HOME ufficiale non è mai un’idea completamente sicura, quindi usalo sempre a tuo rischio. Poiché uLaunch non esegue alcuna telemetria o comunicazione con i server Nintendo, potrebbero essere in grado di notare che stai utilizzando qualcosa di diverso dal menu HOME originale.

Perché uLaunch (a volte) sembra più lento del menu HOME ufficiale?

Ci sono diverse possibili ragioni:
- uLaunch carica più contenuti rispetto al menu HOME ufficiale durante il caricamento. La maggior parte dell’interfaccia utente del menu HOME ufficiale sono colori solidi, mentre uLaunch carica diverse immagini, ecc.. essere personalizzabile comporta piccoli inconvenienti, come questo.
- Le icone vengono caricate lentamente, quindi per i menu con molte voci (essenzialmente per le persone che hanno un sacco di giochi) navigare attraverso il menu sarà leggermente laggoso fino a quando tutto non sarà caricato, il che richiederà solo pochi secondi. Il menu 3DS ha momenti laggosi simili.
- Oltre alle due scuse sopra, c’è sempre spazio per ulteriori ottimizzazioni nel codice di uLaunch. Sentiti libero di segnalare qualsiasi problema di lag eccessivo/rallentamenti.

Componenti

uSystem

uSystem è il processo di sostituzione dell’applet di sistema – la sostituzione reale e letterale del menu HOME – e funge da backend per il menu effettivo con cui l’utente interagirà (uMenu).
uSystem gestisce la funzionalità essenziale del menu HOME, come la sospensione/chiusura dei titoli, la chiusura degli applet, il rilevamento dei pulsanti di alimentazione o del pulsante HOME… è molto leggero poiché deve essere sempre in esecuzione in background.
Comunica anche con uMenu per tutto ciò che è necessario tramite il loro sistema di comunicazione smi.

uMenu

uMenu è un’applicazione libreria (che funziona temporaneamente sull’applet eShop quando viene avviata) che rappresenta il menu HOME che l’utente vedrà e con cui interagirà.
uMenu viene avviato e terminato da uSystem quando necessario. Per gestire la funzionalità speciale del menu HOME (chiudere titoli, avviarli…) comunica con uSystem tramite il loro sistema di comunicazione smi.

uLoader

uLoader è un’implementazione personalizzata di nx-hbloader, che consente di avviare facilmente homebrew come applet o applicazioni o persino di scegliere homebrew come una sorta di dialogo di file.

uManager

uManager è un homebrew NRO utilizzato per controllare gli aspetti chiave di uLaunch.
Solo i compiti che non possono essere eseguiti al di fuori di uLaunch sono controllati (come abilitare o disabilitare uLaunch stesso, motivo per cui questo è un NRO separato e non parte di uMenu/ecc), mentre tutto il resto è controllato e gestito su uLaunch stesso.

uScreen

uScreen è uno strumento per PC che comunica tramite USB con uSystem per catturare lo schermo. Richiede Java 8 o superiore, ma sono raccomandate versioni superiori.
Nota che la cattura dello schermo USB è disabilitata per impostazione predefinita e deve essere abilitata nelle impostazioni.
Devi anche installare i driver libusbK affinché USB funzioni correttamente:

Windows

Il modo migliore per installare Java 9 su Windows (o uno molto semplice) è installare AdoptOpenJDK 11 o superiore.
- Nota: Assicurarsi che il JDK/JRE scelto contenga JavaFX! è possibile installarlo manualmente altrimenti.
- Dopo averlo installato, fare doppio clic sul JAR dovrebbe essere sufficiente per avviarlo.
- Altrimenti, eseguire java -jar uScreen.jar nel prompt dei comandi.
- Per far riconoscere l’USB, seguire i seguenti passaggi:
  - Scaricare Zadig.
  - Avvia la console con uLaunch (prima assicurati che la cattura dello schermo USB sia abilitata nelle impostazioni), collegarla al PC tramite USB.
  - Con Zadig, selezionare il dispositivo denominato “Nintendo Switch”.
  - Installare libusbK su quel dispositivo (qualsiasi altro driver non funzionerà correttamente).

Linux

Installare OpenJDK 11 (o superiore) nel terminale:
- Eseguire il comando sudo add-apt-repository ppa:openjdk-r/ppa
- Eseguire il comando sudo apt-get update
- Infine, eseguire il comando sudo apt-get install openjdk-11-jdk (se desideri solo il JRE, installare openjdk-11-jre invece).
- Creare il file /etc/udev/rules.d/99-switch.rules con i seguenti contenuti: SUBSYSTEM=="usb", ATTRS{idVendor}=="057e", ATTRS{idProduct}=="3000", GROUP="plugdev"
- Ricaricare le regole udev con: sudo udevadm control --reload-rules && sudo udevadm trigger
- Ora è possibile eseguire uScreen utilizzando java -jar uScreen.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 del JDK.
- Ora è possibile eseguire uScreen utilizzando java -jar uScreen.jar.
Dopo aver fatto tutto ciò, la connessione USB dovrebbe funzionare correttamente.

uDesigner

uDesigner è un editor di temi web (sperimentale) per rendere la creazione dei temi più semplice.

Changelog

Alcune delle modifiche e correzioni elencate qui sotto sono ancora sperimentali (in particolare per gli utenti con molti giochi installati), quindi vi invitiamo a segnalare eventuali problemi strani o nuovi che doveste riscontrare!

Ricompilato con il supporto ad Atmosphère v1.9.1 (firmware 20.1.0).
Introdotto un nuovo sistema di cache per le icone dei giochi e i file NACP per aggirare i rallentamenti nel caricamento riscontrati con il firmware 20.x:
- I dati delle icone e dei NACP ora vengono memorizzati direttamente in RAM tramite uSystem, motivo per cui l’utilizzo di memoria di uSystem passa da circa 12MB a 40MB. In teoria, questo consente di memorizzare in cache fino a 200 giochi installati. Chi avesse un numero maggiore (per quanto improbabile) può aprire una segnalazione per richiedere più memoria dedicata alla cache. In teoria si potrebbe arrivare fino a circa 50MB.
- Nessuna preoccupazione riguardo all’impatto sulla memoria, poiché anche con questo aumento uLaunch utilizza meno memoria del menu HOME originale (che usa circa 50MB), mantenendo un’esperienza equivalente o anche più fluida.
Risolto un bug che causava gravi rallentamenti con molti giochi installati (anche solo 10 bastavano a rendere il problema percepibile), dovuto a un comando che veniva eseguito ogni fotogramma per ogni applicazione. Ora il valore viene letto una sola volta al caricamento delle app.
Corretto un bug banale in cui uMenu tentava di salvare in cache il tema attivo solo se non era già presente, ignorando il fatto che uSystem svuotava completamente la cache a ogni riavvio: il risultato era che il tema veniva salvato in cache inutilmente a ogni avvio.
Corretto un comportamento anomalo in cui, in certe situazioni, il tema predefinito veniva erroneamente considerato obsoleto.