Home Homebrew Rilasciato uLaunch v1.1.0

[Scena Switch] Rilasciato uLaunch v1.1.0

17 Marzo 2025 Data modificata: 17 Marzo 2025

123

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.

It took a while but I've finally dropped uLaunch v1.1.0, supporting latest Atmosphére/FW and with some new features, go check it out! https://t.co/NAMu2lVjmB

— XorTroll (@XorTroll) March 16, 2025

Questa nuova versione, oltre ad introdurre il supporto per Atmosphère v1.8.0 (fino al firmware 19.0.1), aggiunge anche una funzione più accurata di rilevamento dei giochi, che ora gestisce meglio i giochi corrotti e i titoli sulle schede di gioco, visualizzandoli correttamente.

Tuttavia, è presente un problema minore: alcuni giochi vengono erroneamente contrassegnati come “bisogno di aggiornamento” con un’icona sbagliata, ma ciò non ne impedisce il lancio.

Inoltre, è stato aggiunto il supporto per la lockscreen, che può essere abilitata o disabilitata all’interno delle impostazioni.

Tra le altre migliorie, i nomi delle cartelle che ora vengono visualizzati sopra le icone delle cartelle, proprio come nelle versioni precedenti di uLaunch.

Sono stati introdotti anche nuovi controlli per i giochi che non possono essere avviati, riconoscendo e mostrando correttamente tali titoli, e migliorando il processo di rilevamento dei giochi corrotti. Inoltre, è stato ridotto il tempo di ritardo dopo l’aggiunta di un homebrew o dopo un crash.

Anche le impostazioni sono state riorganizzate e ora comprendono nuove opzioni, tra cui la lingua della console, la regione del sistema, lo stato degli aggiornamenti, il tempo di sospensione della console e altre opzioni relative alla gestione dell’energia e al blocco schermo specifico di uLaunch.

Le opzioni di personalizzazione del tema sono state ampliate, con l’introduzione di nuovi icon set per le varie condizioni dei giochi, come corrotto, scheda di gioco, aggiornamento necessario, e non avviabile.

Infine, la documentazione e lo strumento uDesigner verranno aggiornati per supportare questi cambiamenti nei temi, garantendo una personalizzazione più completa dell’interfaccia.

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

Prima di tutto, è supportato Atmosphère v1.8.0 (fino al firmware 19.0.1).

Disclaimer: problema noto

Questa versione include un problema noto (minore): il rilevamento dei giochi recentemente introdotto (scheda di gioco, corrotti e altro) classifica erroneamente alcuni giochi come “necessitanti di un aggiornamento”.

Sebbene ciò non impedisca di avviarli, l’icona corrispondente viene visualizzata in modo errato. Il developer deve ancora scoprire come il menu HOME regolare rileva i titoli aggiornati.

Traduzioni in italiano, francese e tedesco
Supporto per lockscreen! Può essere abilitato/disabilitato nelle impostazioni
Aggiunta una nuova voce speciale per le impostazioni amiibo
I nomi delle cartelle ora vengono visualizzati sopra le icone delle cartelle (come nelle versioni precedenti di uLaunch)
I giochi ora vengono rilevati in modo molto migliore:
- I giochi corrotti vengono rilevati come nel menu HOME regolare, consentendo lo stesso processo di controllo dei dati, ma in background, mentre il menu HOME regolare lo forzava a essere attivo
- I titoli sulla scheda di gioco vengono riconosciuti e visualizzati correttamente
- I giochi che non possono essere avviati (per la maggior parte) vengono riconosciuti e mostrati correttamente (vedi il problema noto sopra)
Aggiunti controlli speciali per assicurarsi che tutte le voci speciali (pagina utente, opzioni del controller, ecc.) siano presenti nel menu
Ridotto il tempo di ritardo dopo l’aggiunta di un homebrew o dopo un crash
Risolti bug minori nell’aggiunta di una nuova voce homebrew nel menu
Risolti alcuni problemi con le voci di menu personalizzate, dove alcuni campi JSON non funzionavano se altri campi non erano stati impostati.

Impostazioni

Le impostazioni sono state riorganizzate e ampliate con alcune opzioni precedentemente non implementate (e ce ne saranno altre in futuro). Ecco le voci modificate/aggiunte:

Lingua della console (riorganizzata in modo più ordinato).
Stato dell’aggiornamento del sistema.
Regione della console.
Memoria primaria per gli album.
Lockscreen abilitato (specifico per uLaunch).
Tempo di sospensione della console/handheld.
Sospensione durante la riproduzione dei media.
Risveglio al cambio di stato di alimentazione.
Numero di serie/batch della batteria.

Tutte queste voci sono state organizzate in vari menu (uLaunch, sistema, schermo, ecc..), non sono state aggiunte molte nuove voci, ma le impostazioni supportate continuano ad essere estese progressivamente.

Temi

Introdotta una nuova voce speciale per le opzioni amiibo, con una nuova icona in ui/Main/EntryIcon/Amiibo, ui/Main/QuickIcon/Amiibo e un effetto sonoro dedicato in sound/Main/OpenAmiibo.wav.

Le impostazioni sono state riorganizzate, ora con i campi menu_text e submenu_text (il campo info_text non viene più utilizzato) e la propria input_bar, con uno sfondo in ui/Settings/InputBarBackground.

Grazie a un miglior rilevamento dei giochi, in questa versione sono state introdotte le seguenti icone sovrapposte: