Home Homebrew Rilasciato Ultrahand Overlay v2.0.0

[Scena Switch] Rilasciato Ultrahand Overlay v2.0.0

7 Agosto 2025 Data modificata: 7 Agosto 2025

Pubblicato un rapido aggiornamento per Ultrahand Overlay, lo strumento ci permette di gestire in modo efficiente file e directory sulla scheda SD della console Nintendo Switch.

Ispirandosi a una nuova funzionalità di Zelda, questa utility offre funzionalità avanzate per creare e condividere pacchetti, consentendo agli utenti di personalizzare il proprio sistema di gestione dei file secondo le proprie esigenze.

Con Ultrahand, è possibile creare nuove directory, unire file e personalizzare le configurazioni utilizzando file di configurazione semplici come il file config.ini.

Questa nuova versione introduce un lanciatore combinato, simile a quello dei normali overlay, con cui è possibile assegnare qualsiasi pacchetto a combinazioni di tasti.

Aggiunta inoltre l’opzione di avvio rapido che disattiva temporaneamente i comandi di boot durante questi lanci combinati. Nuove combinazioni di tasti ampliano ulteriormente le possibilità di controllo.

Introdotto anche il comando open, che permette l’apertura diretta degli overlay (con o senza argomenti) dal menu pacchetti, mentre gli overlay ora possono essere compilati per svolgere compiti specifici legati ai pacchetti Ultrahand.

Navigare nei menu ora è molto più rapido: i tasti e consentono di saltare intere pagine, anche in successione, agevolando lo scorrimento delle tabelle.

Una delle novità più importanti riguarda invece la funzione di aggiornamento dell’Atmosphere: spostando o copiando i file necessari (come stratosphere e package3) nella cartella /atmosphere/, questi verranno rinominati con estensione .ultra, evitando sovrascritture.

Al riavvio del sistema tramite Ultrahand, partirà automaticamente un payload aggiornato, che verrà scaricato una sola volta e attivato anche durante gli aggiornamenti software.

Inoltre ora c’è anche il supporto per la libreria libultrahand, con rilevamento automatico degli overlay compatibili e colori evidenziati per distinguerli visivamente.

Sarà però necessaria la ricompilazione degli overlay con una nuova firma presente nel Makefile. Aggiunto inoltre il comando dot-clear, utilissimo per eliminare automaticamente i file metadata .DS_Store e simili creati da macOS, che possono causare problemi durante il caricamento delle mod.

Ampio spazio è stato dedicato alla personalizzazione visiva: ora è possibile modificare i colori del tema, inclusi i testi delle versioni, dei pacchetti e degli overlay.

Alcuni utenti potrebbero dover riapplicare il tema predefinito per vedere correttamente i nuovi colori. Migliorata inoltre l’isolazione degli input, per evitare conflitti tra i tasti di navigazione e quelli delle combo, mentre operazioni come lettura/scrittura file, scambio di pagine e parsing dei file .ini ora sono thread-safe.

Il menu delle impostazioni è stato riorganizzato e include una sezione dedicata al tema. I menu a tendina possono ora visualizzare widget specifici o modificare il simbolo di selezione.

Durante un ritorno da un menu di pacchetto o da un forwarder, la pagina si aggiorna automaticamente, e le intestazioni dei pacchetti possono ora mostrare widget tramite opzioni dedicate.

L’aggiornamento installa anche nx-ovlloader/nx-ovlloader+ v1.1.1, migliorando la gestione della memoria e ottimizzando la velocità dei caricamenti. Il disegno dei menu è stato velocizzato e la memoria utilizzata è stata ridotta in molte sezioni del codice.

Corretto un bug che faceva scomparire i valori di scorrimento su alcune barre, assieme a numerose altre ottimizzazioni per il tocco prolungato, il caricamento di file .json, la generazione delle liste di file e la gestione dei mod tramite il tool Mod Alchemist.

Infine, in un successivo aggiornamento, è stata corretta una piccola anomalia grafica riguardante la trasparenza del cursore negli screenshot.

Caratteristiche

Ultrahand Overlay è un overlay Tesla che fornisce potenti funzionalità per la gestione di file e directory su di una scheda SD. Offre le seguenti caratteristiche:

Crea directory:
- Crea facilmente directory sulla tua scheda SD specificando il percorso della directory. Ultrahand gestirà il processo di creazione per te.
Copia file o directory:
- Copia facilmente file o directory da una posizione all’altra sulla tua scheda SD. Basta fornire i percorsi di origine e destinazione e Ultrahand gestirà senza problemi il processo di copia.
Elimina file o directory:
- Semplifica l’eliminazione di file e directory sulla scheda SD. Specificando il percorso del file o della directory che desideri eliminare, Ultrahand lo rimuove prontamente, rendendo il processo di eliminazione senza problemi.
Sposta file o directory:
- Sposta facilmente file o directory tra le posizioni sulla scheda SD. Fornisci il percorso di origine e il percorso della directory di destinazione e Ultrahand si prenderà cura del processo di spostamento, garantendo un trasferimento senza intoppi.
Scarica file:
- Scarica file sulla tua scheda SD con facilità. Recupera in modo efficiente file da repository o URL nella posizione desiderata. Che tu debba scaricare/aggiornare homebrew o trasferire file tra posizioni, questa funzione semplifica il processo, rendendo la gestione delle repository un gioco da ragazzi.
Estrai file ZIP:
- Estrai file compressi zip sulla scheda SD decomprimendo gli archivi, preservando la loro struttura originale. Che tu abbia scaricato archivi zip o ricevuto file compressi, questo comando semplifica il processo di estrazione, rendendo facile l’accesso ai contenuti.
Modifica file INI:
- Modifica facilmente i file INI sulla scheda SD. Assumi il pieno controllo delle tue configurazioni aggiornando le coppie chiave-valore esistenti, aggiungendo nuove voci o creando nuove sezioni all’interno del file INI utilizzando Ultrahand. Personalizza e personalizza i tuoi file INI senza sforzo attraverso la sua interfaccia intuitiva.
Modifica file esadecimale:
- Modifica esadecimale dei file sulla scheda SD. Modifica direttamente i dati binari, consentendo un controllo preciso sui dati. La funzione Hex Edit Files di Ultrahand consente di analizzare, modificare e personalizzare i file nella loro forma grezza.

Ultrahand fornisce una comoda interfaccia a riga di comando per eseguire queste operazioni, consentendoti di gestire in modo efficiente file, directory e file INI su una scheda SD.

Utilizzo

Per utilizzare Ultrahand, seguire questi passaggi:

Scaricare e installare l’ultima versione di nxovloader.
Scaricare l’ultima versione di Ultrahand ovlmenu.ovl e posizionarla nella cartella /switch/.overlays/.

ATTENZIONE: Questo sovrascriverà Tesla Menu se già installato.

Dopo aver installato Ultrahand Overlay, verrà creata una nuova cartella chiamata ultrahand nella cartella di configurazione principale sulla scheda SD (/config/ultrahand/), insieme a un file config.ini contenente varie impostazioni di Ultrahand.
Avviare Ultrahand (simile a Tesla Menu) con le combinazioni di tasti predefinite di Tesla o di Ultrahand ( + + ). Verrà creata una nuova cartella (/switch/.packages/) con un file package.ini preimpostato per i comandi del menu base.
Posizionare il file package.ini personalizzato nella directory dei pacchetti di Ultrahand (/switch/.packages/<NOME_PACCHETTO>/). Questo file conterrà i comandi per il pacchetto personalizzato di Ultrahand.
I comandi ora appariranno nel menu pacchetti all’interno di Ultrahand.

Funzionalità Aggiuntive

Premere per eseguire qualsiasi comando, così come premere per visualizzare/eseguire le singole linee di comando scritte nel file ini per l’esecuzione.
Premere nel menu principale per entrare nel menu delle impostazioni.
Premere sopra un overlay/pacchetto per aggiungerli ai preferiti.
Premere sopra un overlay/pacchetto per configurare impostazioni aggiuntive.
Per ulteriore assistenza con i pacchetti personalizzati, consultare la Wiki di Ultrahand Overlay.

Opzioni di configurazione

Il file config.ini contiene diverse sezioni che definiscono insiemi di comandi eseguibili. Ogni sezione è racchiusa tra parentesi quadre [ ] e i comandi sono elencati sotto ciascuna sezione.

Ecco un esempio del formato del file config.ini:

Gli utenti hanno la possibilità di personalizzare le azioni eseguite da Ultrahand aggiungendo le proprie sezioni e comandi nel file config.ini.

È importante notare che i percorsi specificati nei comandi devono essere relativi alla directory principale della scheda SD e devono terminare con /.

Riferimento ai comandi

Ultrahand supporta i seguenti comandi:

make o mkdir: Crea una nuova directory.
- Utilizzo: make <percorso_directory>
copy o cp: Copia un file o una directory.
- Utilizzo: copy <source_file_path> <destination_file_path>
delete o del: Elimina un file o una directory.
- Utilizzo: delete <percorso_file>
move o mv: Sposta o rinomina un file o una directory in una nuova posizione o con una nuova etichetta.
- Utilizzo: move <file_path> <destination_directory_path>
set-ini-val o set-ini-value: Modifica un file INI aggiornando o aggiungendo una sezione con la coppia chiave-valore desiderata.
- Utilizzo: set-ini-val <file_to_edit> <sezione_desiderata> <chiave_desiderata> <valore_desiderato>
set-ini-key: Modifica un file INI aggiornando una sezione con una nuova chiave.
- Utilizzo: set-ini-key <file_to_edit> <sezione_desiderata> <chiave_desiderata> <chiave_nuova_desiderata>
reboot: Riavvia il sistema.
- Utilizzo: reboot
shutdown: Spegne il sistema.
- Utilizzo: shutdown

Assicurarsi di seguire la sintassi corretta e fornire gli argomenti richiesti per ciascun comando, questo è fondamentale per un utilizzo corretto di Ultrahand.

È possibile configurare questi comandi nel file config.ini inserendoli nelle sezioni corrispondenti e fornendo gli argomenti necessari come descritto per ciascun comando.

Changelog

Nuovo launcher di pacchetti combinati (simile al launcher overlay).
- Gli utenti possono impostare qualsiasi pacchetto su combinazioni di tasti.
- Nuova impostazione del pacchetto Quick Launch (per disattivare i comandi di avvio del pacchetto durante i lanci tramite combinazioni di tasti).
- Sono state aggiunte all’elenco anche altre combinazioni di pulsanti.
Nuovo comando open per aprire gli overlay (con o senza argomenti di avvio) dal menu dei pacchetti.
- Si utilizza nel formato: open /percorso/dell/overlay.ovl {ARGOMENTO_DI_AVVIO_1} {ARGOMENTO_DI_AVVIO_2} {...}.
- Ora è possibile compilare le sovrapposizioni per gestire attività specifiche per i pacchetti Ultrahand.
I pulsanti e ora salteranno il menu esattamente di una distanza pari alla finestra di visualizzazione verso l’alto o verso il basso.
- Facendo clic più volte e tenendo premuto il pulsante del mouse, le pagine verranno saltate rapidamente.
- Ciò dovrebbe consentire una navigazione più rapida e semplice nei menu e lo scorrimento delle tabelle.
Nuova funzionalità di aggiornamento di Atmosphère.
- Per utilizzarli, copia/sposta/decomprimi i file nella posizione desiderata (sovrascrivendo stratosphere e package3 in /atmosphere/).
  - Invece di essere sovrascritti, ai file verrà assegnata un’estensione .ultra.
- Dopo che i file sono stati spostati nella posizione corretta, qualsiasi comando reboot attiverà automaticamente il payload di aggiornamento di Ultrahand.
  - Questo payload viene scaricato una sola volta, al primo reboot dopo l’installazione di Atmosphere e anche durante gli aggiornamenti software.
  - Per rendere effettive le modifiche, gli utenti devono riavviare Ultrahand Overlay.
Rilevamento di libultrahand per gli overlay compilati con libultrahand.
- Colori evidenziati per gli overlay con funzionalità di libultrahand.
- Necessaria la ricompilazione di tutti gli overlay libultrahand con la nuova firma di Ultrahand aggiunta (vedere Makefile).
Nuovo comando dot-clear, chiamato dot-clear <PERCORSO_DA_PULIRE>.
- Questo comando rimuoverà tutti i file di metadati che iniziano con ._ da qualsiasi directory specificata (nonché da tutte le sottodirectory).
- Questa funzionalità è utile per gli utenti che trasferiscono file e mod da macOS alla propria scheda SD.
  - Nota a margine: Questi file di metadati possono causare problemi con le mod, quindi cancellarli può essere molto utile.
Nuove configurazioni dei colori del tema e aggiornamenti al tema predefinito, così come ai file ultra.ini e ultra-blue.ini.
- banner_version_text_color: Colore predefinito dell’etichetta della versione sotto il titolo Ultrahand.
- overlay_text_color: Colore predefinito per i titoli sovrapposti.
- overlay_version_text_color: Colore predefinito per le versioni sovrapposte.
- ult_overlay_text_color: Colore predefinito per i titoli sovrapposti compilati da libultrahand.
- ult_overlay_version_text_color: Colore predefinito per le versioni di overlay compilate da libultrahand
- package_text_color: Colore predefinito per i titoli dei pacchetti.
- package_version_text_color: Colore predefinito per le versioni del pacchetto.
- ult_package_text_color: Colore secondario per i titoli dei pacchetti.
- ult_package_version_text_color: Colore secondario per le versioni del pacchetto.
- text_separator_color: Colore predefinito per i simboli di separazione del testo.
- selection_value_text_color: Colore predefinito per il valore di selezione.
  - Nota a margine: Gli utenti potrebbero voler riapplicare il tema predefinito una volta affinché alcune delle modifiche vengano applicate.
Corretto l’isolamento degli input in modo che i pulsanti di navigazione del menu non interferiscano con le combinazioni e viceversa.
Operazioni su file ini, manipolazione esadecimale, gestione dei file e cambio pagina sicure per l’esecuzione concorrente (thread-safe).
- Nuovo comando libultrahand swapTo per gestire in modo sicuro lo scambio tra pagine (goBack/pop + changeTo).
Il menu delle Impostazioni Varie è stato riorganizzato e ora include Theme Settings.
- Le impostazioni del tema includono opzioni che consentono di attivare e disattivare varie configurazioni del tema.
Al ritorno dai menu a discesa/inoltri dei pacchetti, la pagina ora viene aggiornata automaticamente.
- Tutti i piè di pagina e le tabelle dei comandi verranno ridisegnati automaticamente.
Gli header dei pacchetti ora possono utilizzare ;show_widget=true per il rendering del widget.
I comandi del menu a tendina ora possono utilizzare ;mode=slot per cambiare il simbolo del menu a tendina in un simbolo di opzione.
L’aggiornamento software ora installa nx-ovlloader / nx-ovlloader+ v1.1.1 (ultima versione).
- Correzioni di bug per lo scambio rapido di overlay, chiamate di I/O ridotte, migliore mappatura della memoria e lievi ottimizzazioni.
Le modifiche alla lingua ora vengono applicate immediatamente al menu direttamente dalla selezione della lingua.
Creazione più rapida del menu.
Le dimensioni dei buffer per nx-ovlloader+ (espansione memoria) ora vengono caricate immediatamente durante il lancio dell’overlay.
- Lievi modifiche alle dimensioni del buffer per il caricatore di base.
Lievi miglioramenti a Swipe To Open.
Lievi modifiche a vari componenti di testo all’interno della sovrapposizione.
Correzioni e miglioramenti relativi al rendering.
Correzioni alla generazione dell’elenco dei file da copia e spostamento per includere le sottodirectory.
- Questa funzionalità permette a Mod Alchemist di gestire correttamente la rimozione di cartelle quando necessario per attivare o disattivare mod di contenuti.
Numerose correzioni di bug, ottimizzazioni della memoria, correzioni di navigazione e correzioni di allineamento.
- Riduzione significativa della pressione della memoria in numerosi metodi.
- Innumerevoli ottimizzazioni del codice e migliore gestione della memoria.
- Correzione del bug relativo alla scomparsa dei valori della barra di tracciamento dei passi.
- Correzioni relative al tocco (tocco prolungato e rilascio).
- Correzioni di bug relativi a pattern pericolosi.
- Correzioni di bug per json_file / json_file_source.
- Molte altre correzioni non menzionate.