Il developer ppkantorski ha rilasciato la nuova versione 2.5.2 di Ultrahand Overlay, un aggiornamento che continua a perfezionare uno degli strumenti più completi per la gestione degli overlay su Nintendo Switch.

Basato su libultrahand, evoluzione della nota libreria libtesla, il progetto introduce numerose novità che migliorano la personalizzazione dell’interfaccia, la gestione dei comandi e la stabilità generale, rendendo l’esperienza ancora più fluida sia per gli utenti che per gli sviluppatori di pacchetti.

1 di 9

La principale novità riguarda l’espansione delle opzioni di personalizzazione grafica. Da questa versione è infatti possibile assegnare colori personalizzati ai singoli elementi delle liste tramite i nuovi parametri ;text_color= e ;footer_color=, che consentono di definire il colore del titolo e del valore associato utilizzando codici RGB.

Queste impostazioni hanno la priorità rispetto ai colori del tema scelto dall’utente, pur continuando a rispettare gli indicatori temporanei di stato, come spinner, conferme o messaggi di errore.

Anche le tabelle diventano più flessibili grazie ai nuovi parametri ;bg_color= e ;border=, che permettono rispettivamente di modificare il colore di sfondo e di attivare o disattivare il bordo indipendentemente dalle Dynamic Tables.

1 di 7

Si tratta di un’aggiunta che offre agli sviluppatori un controllo molto più preciso sull’aspetto degli overlay.

Sul fronte delle automazioni arriva invece il nuovo comando condizionale matching_hex_val_custom, accompagnato dalla relativa versione inversa.

Questa funzione consente di verificare il valore esadecimale presente in un file partendo da un pattern ASCII e da un offset relativo, sfruttando lo stesso sistema di scansione già utilizzato dalle operazioni di scrittura.

Il comando può essere utilizzato sia autonomamente sia insieme alle condizioni di visibilità o di stato dei toggle, ampliando ulteriormente le possibilità offerte dai pacchetti più avanzati.

L’aggiornamento introduce inoltre una nuova opzione denominata In-Package Titles all’interno delle impostazioni del widget.

Attiva per impostazione predefinita, questa funzione permette di decidere se mantenere i colori personalizzati dei titoli presenti nei sottomenu oppure forzarli automaticamente ai colori definiti dal tema in uso, garantendo una maggiore uniformità dell’interfaccia.

1 di 6

Particolare attenzione è stata dedicata anche all’esperienza d’uso durante l’esecuzione dei comandi.

Per evitare chiusure accidentali dell’overlay, il comportamento dei pulsanti è stato rivisto: durante un’operazione in corso il tasto sostituisce  per nascondere l’overlay, mentre quest’ultimo viene semplicemente ignorato, evitando così di interrompere involontariamente il menu.

Anche il D-Pad e il pulsante  ricevono un comportamento più coerente, mostrando solamente l’animazione di selezione senza attivare erroneamente nuovi comandi.

Sono stati risolti diversi problemi relativi alla navigazione nel menu delle impostazioni e corretti alcuni difetti grafici che impedivano ai titoli e alle versioni degli overlay di utilizzare correttamente i colori di evidenziazione previsti dal tema quando venivano selezionati.

L’intero sistema di gestione dei colori è stato rivisto per supportare le nuove personalizzazioni mantenendo al tempo stesso il corretto comportamento dell’interfaccia.

Anche il tema predefinito riceve alcune modifiche. Il Dynamic Logo viene ora disattivato di default, mentre sono stati aggiornati diversi colori dell’interfaccia, compresi quelli del logo principale, dell’effetto di selezione e dello sfondo delle tabelle.

Per chi preferisce l’aspetto delle versioni precedenti è stato aggiunto anche il nuovo tema classic.ini, che ripristina fedelmente la palette utilizzata prima della versione 2.5.2.

Per applicare correttamente le nuove modifiche grafiche è necessario reinstallare il tema predefinito oppure effettuare una nuova installazione di Ultrahand Overlay.

L’aggiornamento migliora inoltre l’affidabilità dei download, aumentando la compatibilità con un numero maggiore di domini web, e introduce numerose correzioni interne all’infrastruttura di libultrahand, comprese alcune ottimizzazioni legate alla gestione del foreground e alla dichiarazione delle combinazioni di tasti predefinite.

A poche ore dalla pubblicazione della versione 2.5.2 è arrivato anche un Quick Update che rifinisce ulteriormente il software.

Tra le novità spiccano nuove correzioni per la gestione del foreground, ulteriori ritocchi al tema predefinito e l’introduzione della modalità auto per il wrapping delle tabelle, che utilizza automaticamente l’andata a capo per caratteri nelle lingue asiatiche e quella per parole nelle lingue occidentali.

Aggiunto inoltre il parametro swipe_offset nel file config.ini, utile per calibrare con maggiore precisione il punto di partenza del gesto di apertura tramite swipe.

Completano l’aggiornamento diverse correzioni dedicate alla gestione delle interruzioni di riga nelle tabelle, ai sistemi di traduzione e ai divisori delle sezioni, oltre all’introduzione del nuovo placeholder {ovl_language}, che permette di richiamare direttamente la lingua attualmente utilizzata dall’overlay durante la visualizzazione dei contenuti.

Funzionalità

Per gli utenti

• Accessibile istantaneamente da qualsiasi gioco tramite una combinazione di tasti o un gesto di scorrimento (swipe), senza necessità di sospendere il gioco.
• Avvio e gestione di overlay e pacchetti con combinazioni di tasti personalizzabili per ogni singolo elemento.
• Installazione ed esecuzione di pacchetti della community tramite Ultrahand Packages.
• Controllo del volume (fino al 150% tramite la patch audio inclusa), della retroilluminazione e delle impostazioni di sistema in tempo reale.
• Feedback del progresso in tempo reale per download, copie e installazioni.
• Supporto completo al touchscreen: scorrimento, tocchi, pressione prolungata e gesti swipe funzionano in tutta l’interfaccia.
• Temi, sfondi, pacchetti audio e layout dell’interfaccia completamente personalizzabili.
  • Wallpaper Designer basato su browser: consente di ritagliare, modificare ed esportare sfondi .rgba pronti all’uso (448×720).
• Sistema di notifiche toast: pacchetti, sysmodule e applicazioni esterne possono inviare notifiche all’overlay tramite file JSON .notify.

Un ecosistema in continua crescita di overlay basati su libultrahand è disponibile, tutti avviabili e gestibili direttamente da Ultrahand.

Per un elenco più completo, consultare Ultrahand Overlays.

Per gli sviluppatori di pacchetti

Un ricco ambiente di scripting GUI basato su file INI con:

• Integrazione dell’avvio — combinazioni di tasti assegnabili per ogni pacchetto, stato nascosto/preferito (hide/star) e hook di avvio/uscita del pacchetto (boot_package.ini / exit_package.ini).
• Controllo degli overlay — avvio di overlay, esecuzione di sezioni del pacchetto, navigazione indietro e uscita al menu.
• Interfaccia dinamica — toggle, slider, menu a tendina, tabelle (disegnate direttamente o caricate da un file di testo), notifiche toast avanzate (titolo, durata, allineamento, icona), impostazione del piè di pagina e aggiornamento di pagina/tema/sfondo.
• Widget della barra di stato — widget overlay opzionale con orologio, temperatura e batteria.
• Traduzioni linguistiche — le stringhe dell’interfaccia dei pacchetti vengono tradotte automaticamente al momento del rendering in base alla lingua di sistema attiva.
• Notifiche — i comandi notify / notify-now inviano messaggi toast direttamente dagli script; inserendo un file JSON .notify nella cartella /config/ultrahand/notifications/ viene messa in coda una notifica API persistente che rimane visibile fino alla chiusura manuale.
• Segnaposto — supporto a sorgenti INI, JSON, hex, liste, file e timestamp; informazioni hardware ({ams_version}, {hos_version}, {title_id}, {build_id}, {ram_vendor}, {local_ip}, {volume}, {backlight}, dati fuse e altro ancora); trasformazioni matematiche e di stringhe.
• Logica condizionale — blocchi try:, controlli path_exists, protezioni hardware erista:/mariko:, confronti tra versioni.
• Operazioni sui file — copia, spostamento, eliminazione, rinomina, creazione cartelle, modifica timestamp, sincronizzazione, confronto, flag e pulizia dei punti.
• Download ed estrazione — download con tentativi multipli e supporto ZIP; esegue una sincronizzazione NTP una tantum con pool.ntp.org al primo download per evitare errori di handshake SSL.
• Modifica di file INI — lettura/modifica di valori e chiavi, aggiunta/rinomina/rimozione di sezioni e chiavi, modifiche di massa tramite corrispondenza di pattern.
• Modifica JSON — lettura e modifica di valori e chiavi.
• Modifica HEX — modifica tramite offset, scambio (swap), stringhe, decimali, decimali invertiti, offset con pattern personalizzati e sostituzione di pattern hex.
• Conversione mod — conversione da .pchtxt a formato .ips o cheat Atmosphère.
• Controllo del sistema — riavvio (target di boot Hekate tramite boot/ini/UMS/payload), spegnimento, volume, retroilluminazione e regione.

Consultare la Wiki per la documentazione completa.

Per gli sviluppatori di overlay

Gli overlay basati su libultrahand ottengono accesso all’intera suite di utilità libultra oltre a un’integrazione completa con Ultrahand:

• Compatibilità Tesla — sostituzione completa (drop-in) di libtesla; gli overlay esistenti funzionano senza modifiche.
• Rendering migliorato — prestazioni di rendering superiori e primitive grafiche ampliate rispetto a libtesla.
• Correzioni di bug — risolti rispetto a libtesla originale il bug del cambio del Title ID in foreground, il bug di underscan e il problema della trasparenza negli screenshot.
• Supporto completo al touchscreen — gestione completa dell’input touch con scorrimento corretto, tocchi, pressione prolungata e gesti swipe (un miglioramento significativo rispetto al supporto touch limitato di libtesla).
• Integrazione dell’avvio — combinazioni di tasti assegnabili, stato nascosto/preferito e hook di avvio/uscita dei pacchetti.
• Temi per singolo overlay — sovrascritture indipendenti del tema specifiche per ogni overlay.
• Sfondi per singolo overlay — supporto a sfondi personalizzati con fallback automatico basato sulla memoria heap disponibile.
• Widget della barra di stato — widget overlay opzionale con orologio, temperatura e batteria.
• Traduzioni linguistiche — traduzione automatica delle stringhe durante il rendering in base alla lingua attiva.
• Notifiche — possibilità di chiamare tsl::notification->show() o tsl::notification->showNow() per inviare messaggi toast dal codice dell’overlay, con testo, dimensione del carattere, priorità, durata, allineamento e icona configurabili.
• Utilità per file e percorsi — copia, spostamento, eliminazione, creazione cartelle, ricerca tramite wildcard e attraversamento delle directory.
• Download ed estrazione — download di file tramite curl ed estrazione ZIP; esegue una sincronizzazione NTP una tantum con pool.ntp.org al primo download per evitare errori di handshake SSL.
• Utilità INI, JSON e HEX — accesso completo in lettura/scrittura a file INI, file JSON e dati binari HEX.
• Conversione mod — conversione da .pchtxt a formato .ips o cheat Atmosphère.
• Utilità per stringhe — rimozione spazi (trim), divisione (split), formattazione, analisi delle versioni e risoluzione dei segnaposto.
• Audio e feedback aptico — riproduzione audio WAV con controllo del volume e feedback tramite vibrazione.

Consultare libultrahand per la documentazione completa.

Installazione

Installazione rapida (consigliata)

Scaricare l’ultima versione di sdout.zip ed estrarla nella root della scheda SD. Include tutto il necessario: nx-ovlloader, ovlmenu.ovl, i file delle lingue, i temi, i pacchetti audio e la struttura delle cartelle richiesta.

Avviare o riavviare la console e aprire Ultrahand utilizzando la combinazione di tasti predefinita ( + + ) oppure qualsiasi combinazione compatibile con Tesla.

Installazione manuale

1. Scaricare e installare l’ultima versione di nx-ovlloader.
2. Posizionare il file ovlmenu.ovl nel percorso /switch/.overlays/ovlmenu.ovl (Attenzione: questa operazione sostituirà Tesla Menu se installato).
3. Avviare o riavviare la console e aprire Ultrahand utilizzando la combinazione di tasti predefinita ( + + ) oppure qualsiasi combinazione compatibile con Tesla.
4. Al primo avvio, Ultrahand creerà la cartella /config/ultrahand/ e andrà a generare un file iniziale package.ini nella directory /switch/.packages/.

Se un pacchetto non compare nel menu, provare ad eseguire Fix Bit Archive tramite Hekate.

Per i pacchetti della community disponibili, consultare Ultrahand Packages.

Navigazione

Input	Azione
	Esegue il comando selezionato.
	Visualizza ed esegue singole righe di comando (Script Overlay); tocca per chiudere la notifica in primo piano.
(premuto per circa 4 secondi)	Attiva/disattiva le notifiche API (quando l’opzione API Toggle Hotkey è abilitata nelle impostazioni delle notifiche).
Pressione prolungata (touch)	Apre la visualizzazione della riga di comando oppure le impostazioni dell’overlay/pacchetto.
	Aggiunge ai preferiti/contrassegna un overlay o un pacchetto.
	Apre le impostazioni dell’overlay/pacchetto.
	Apre le impostazioni di Ultrahand dal menu principale.
/	Salta all’inizio/fondo dell’elenco corrente.
/	Scorre pagina su/giù (tenere premuto per uno scorrimento rapido).
durante un comando	Interrompe l’operazione in esecuzione.
durante un comando	Chiude l’overlay senza annullare l’operazione.
Scorrimento verso l’interno dal bordo dello schermo	Apre Ultrahand (alternativa alla combinazione di tasti).
Tocco sulla notifica (touch)	Chiude direttamente quella notifica.

Panoramica delle impostazioni

Accedere al menu Impostazioni premendo  dalla schermata principale.

• Key Combo — Configura la combinazione di tasti utilizzata per aprire Ultrahand.
• Language — Seleziona la lingua dell’interfaccia utente (caricata da /config/ultrahand/lang/).
• Notifications — Impostazioni per il comportamento delle notifiche toast e delle notifiche API.
  • Disattiva le notifiche, imposta il numero massimo di slot e abilita/disabilita la notifica all’avvio.
  • Sysmodule e applicazioni esterne possono inviare notifiche tramite file JSON .notify nella cartella /config/ultrahand/notifications/; sono supportati filtri per applicazione e icone RGBA da 50×50 pixel.
  • API Toggle Hotkey — Tieni premuto MINUS per circa 4 secondi per attivare/disattivare le notifiche API al volo.
• System — Visualizza le informazioni del dispositivo e regola la dimensione dell’heap di memoria dell’overlay (4 / 6 / 8 MB).
• Software Update — Controlla e installa gli aggiornamenti direttamente dall’overlay.
• Theme — Seleziona un tema dalla cartella /config/ultrahand/themes/.
• Sounds — Seleziona un pacchetto di effetti sonori dalla cartella /config/ultrahand/.sounds/.
• Wallpaper — Imposta uno sfondo personalizzato (richiede un heap di almeno 6 MB; formato .rgba, 448×720 pixel).
• Widget — Attiva o disattiva singoli elementi della barra di stato:
  • Orologio, Temperatura SOC, Temperatura PCB, Batteria.
  • Sfondo, Sfondo esteso, Bordo.
• Miscellaneous — Impostazioni aggiuntive con controlli dettagliati, tra cui:
  • Apertura tramite scorrimento (Swipe-to-open), Feedback aptico, Sincronizzazione NTP automatica.
  • Ripristino pagina (Page recall), Ripristino avvio (Launch recall).
  • Menu pacchetti, Guida utente, Visualizzazione/nascondimento dell’eliminazione, Visualizzazione/nascondimento degli overlay non supportati.
  • Visualizzazione della versione di overlay e pacchetti.

Le combinazioni di tasti per l’avvio di singoli overlay e pacchetti possono essere assegnate in modo indipendente tramite il menu delle impostazioni dell’overlay/pacchetto .

Scrivere pacchetti

I pacchetti si trovano nella cartella /switch/.packages/<NOME_DEL_TUO_PACCHETTO>/ e vengono configurati tramite un file package.ini. Esempio minimale:

;title='My Package'
;version=1.0.0
;creator=YourName

[Copy Config]
copy /switch/.packages/package.ini /config/mypackage/

[Reboot to Hekate]
;hold=true
reboot hekate

Per la documentazione completa sul formato dei pacchetti, tutti i comandi disponibili, le variabili segnaposto e le modalità dei comandi, consultare la Wiki:

• Package Reference — Struttura dei pacchetti, intestazioni, pagine, hook di avvio/uscita e configurazione.
• Command Reference — Tutti i comandi, le modalità, le funzioni sorgente e le variabili segnaposto.

Per esempi reali di pacchetti, consultare la directory: examples/

Changelog

1. Nuovi intestazioni di comando ;text_color= e ;footer_color= per gli elementi dell’elenco dei comandi.
   • ;text_color=<HEX> e ;footer_color=<HEX> (RGB888, ad esempio #RRGGBB oppure RRGGBB) impostano un colore personalizzato per il titolo/valore di quello specifico elemento.
   • Si applica agli elementi standard dell’elenco, ai toggle e agli elementi con selezione a tendina; ha la priorità rispetto ai colori predefiniti del tema, ma non sovrascrive mai i colori temporanei dello stato di esecuzione (rotellina di caricamento, segno di spunta, crocetta o stato di avanzamento).
2. Nuove intestazioni di comando per le tabelle ;bg_color= e ;border=.
   • ;bg_color=<HEX> imposta un colore di sfondo personalizzato per la tabella. Vengono utilizzati solo i canali RGB (il valore alpha viene comunque preso dal tema).
   • ;border=true / ;border=false attiva o disattiva il bordo della tabella indipendentemente dalle Tabelle Dinamiche (Dynamic Tables).
3. Nuovo comando condizionale matching_hex_val_custom <PERCORSO_FILE> <PATTERN_ASCII> <OFFSET> <VALORE_HEX> (e il comando inverso !matching_hex_val_custom).
   • Corretto <OFFSET> in relazione all’offset nel file di <PATTERN_ASCII> (ad esempio "CUST"), utilizzando lo stesso sistema di scansione magic + cache degli offset usato dalle scritture hex-by-custom-offset.
   • Utilizzabile autonomamente oppure con ;visibility_condition= / ;toggle_state_condition=, come gli altri controlli matching_*.
4. Nuovo toggle Titoli inclusi nel pacchetto (In-Package Titles) nelle impostazioni del widget (in_package_titles, attivato di predefinito).
   • Separato dal toggle esistente Titoli del pacchetto (Package Titles). Quando è disattivato, ogni titolo incluso nel pacchetto (sottomenu) viene forzato al colore predefinito dei titoli dei pacchetti del tema, ignorando qualsiasi colore richiesto dal pacchetto tramite la propria intestazione (ad esempio ;color=).
5. Modifiche alla gestione degli input per impedire la chiusura accidentale mentre è in esecuzione un comando.
   • Ora nasconde l’overlay mentre è in esecuzione un comando (spostato da ), quindi premere istintivamente  per “tornare indietro” non nasconde più l’overlay durante l’esecuzione di un comando.
   • viene ignorato durante l’esecuzione di un comando, invece di nascondere l’overlay o chiudere/aprire il menu.
   • Il D-pad e il tasto  ora fanno rimbalzare visibilmente l’elemento evidenziato mentre è in esecuzione un comando, invece di attivare erroneamente un’animazione di clic.
6. Correzioni ai bug di navigazione del menu delle impostazioni.
7. Risolto il problema per cui i titoli e le versioni dell’elenco overlay/pacchetti non passavano al colore del testo/valore della selezione del tema quando venivano evidenziati.
   • Ora questi elementi utilizzano internamente il nuovo percorso del colore di base, quindi l’evidenziazione si comporta nuovamente in modo corretto, mantenendo comunque il supporto alle nuove sovrascritture personalizzate per singolo elemento ;text_color= / ;footer_color=.
8. Lievi modifiche ai colori e alle impostazioni del tema predefinito.
   • Il Logo dinamico (Dynamic Logo) ora è disattivato per impostazione predefinita invece che attivato.
   • Nota a margine: Per applicare le modifiche ai colori, gli utenti devono riapplicare il tema predefinito oppure installare Ultrahand da zero.
9. Aggiornati i colori del tema predefinito (clic, logo dinamico, logo principale e sfondo della tabella) e aggiunto un nuovo tema incluso chiamato classic.ini.
   • classic.ini mantiene la stessa identica tavolozza di colori predefinita delle versioni precedenti alla 2.5.2, per chi preferisce l’aspetto precedente.
10. Migliorata l’affidabilità dei download per garantire una maggiore compatibilità con una gamma più ampia di domini URL.
11. Correzioni di bug relative alla gestione del primo piano (foreground) in libultrahand.
12. Risolata una dimensione dichiarata non corrispondente nell’array predefinito delle combinazioni di tasti.

Changelog completo: v2.5.1...v2.5.2

Aggiornamento rapido

• Correzioni di bug relative alle richieste di primo piano (Foreground). – 07/10/2026 02:54 AM PST
• Piccoli aggiustamenti al tema predefinito. – 07/10/2026 4:20 AM PST
• Aggiunta una nuova modalità automatica per il ritorno a capo delle tabelle (table wrapping mode auto) e correzioni ai bug relativi alle traduzioni e agli allineamenti delle notifiche. – 07/10/2026 7:35 AM PST
  • La modalità auto utilizza il ritorno a capo per caratteri nelle lingue asiatiche e il ritorno a capo per parole nelle lingue non asiatiche.
• Aggiunta una nuova chiave swipe_offset al file di configurazione config.ini di Ultrahand (valore intero; opzionale) per calibrare il punto di inizio sull’asse X del comportamento di apertura tramite scorrimento (swipe). – 07/10/2026 7:35 AM PST
• Correzione della gestione delle interruzioni di riga forzate nella funzione wrapText delle tabelle (ora le nuove righe vengono gestite correttamente). – 07/10/2026 08:04 AM PST
• Aggiunta la gestione delle traduzioni nei costruttori di CategoryHeader. -07/10/2026 8:33 AM PST
• Le traduzioni ora vengono applicate anche alle sezioni nelle stringhe divise dai separatori; aggiunto il nuovo segnaposto {ovl_language} per la lingua dell’overlay; corretti i problemi relativi alle modifiche delle interruzioni di riga forzate. – 07/10/2026 10:01 AM PST

Changelog completo: v2.5.2...d706cd8

Download: Ultrahand Overlay v2.5.2

Download: lang.zip

Download: sdout.zip

Download: Source code Ultrahand Overlay v2.5.2

Alcune parti di questo articolo sono state generate con l’aiuto dell’intelligenza artificiale.

Ultimo aggiornamento 2026-08-15 / Link di affiliazione / Immagini da Amazon Product Advertising API