Il developer ppkantorski ha pubblicato la versione 2.5.3 di Ultrahand Overlay, un aggiornamento che continua ad affinare uno degli strumenti più completi per la gestione degli overlay su Nintendo Switch.

Basato su libultrahand, evoluzione della celebre libreria libtesla, il progetto introduce una serie di miglioramenti mirati a rendere l’interfaccia più intuitiva, ottimizzare la gestione dei pacchetti e offrire un’esperienza ancora più stabile sia agli utenti finali che agli sviluppatori.

1 di 9

La novità principale riguarda la gestione del contesto durante l’apertura degli overlay. Da questa versione, quando un overlay viene avviato tramite il comando open, il sistema mantiene correttamente il punto in cui ci si trovava all’interno del pacchetto.

Tornando indietro dall’overlay, l’utente viene quindi riportato esattamente alla schermata precedente, una soluzione che permette agli sviluppatori di realizzare overlay sempre più integrati, trasformandoli in vere e proprie estensioni o plugin dei pacchetti stessi.

1 di 7

L’aggiornamento introduce inoltre un nuovo sistema di ricerca per gli array JSON, che consente di individuare gli elementi utilizzando la sintassi campo=valore anziché affidarsi esclusivamente agli indici numerici.

Questa modifica semplifica la gestione dei dati e rende più flessibile lo sviluppo dei pacchetti che sfruttano file JSON complessi.

1 di 6

Tra le altre novità troviamo un miglioramento della gestione dei controlli touch, ereditato dalle ultime versioni di libultrahand, insieme a numerose ottimizzazioni del codice e delle librerie interne che contribuiscono a incrementare prestazioni e reattività dell’applicazione.

Uno degli aspetti più interessanti di questa release è la significativa riduzione delle dimensioni del programma. Ultrahand Overlay 2.5.3 occupa infatti oltre 160 KB in meno rispetto alla precedente versione 2.5.2, diventando la release più leggera distribuita dal progetto dai tempi della versione 1.1.6.

L’aggiornamento porta anche al rinnovo dell’ambiente di sviluppo, con libnx e le altre librerie aggiornate alle versioni più recenti. In particolare, Ultrahand utilizza ora libnx 4.12.0-1 ed è distribuito insieme a nx-ovlloader 2.0.3.

Gli sviluppatori, tuttavia, hanno precisato che, nonostante i test effettuati e i numerosi riscontri positivi ricevuti dalla community, è stata segnalata un’anomalia da parte di un utente.

Per questo motivo, in attesa di completare le verifiche, consigliano temporaneamente di continuare a utilizzare nx-ovlloader 2.0.2.

La versione 2.5.3 si completa infine con numerose correzioni di bug e ulteriori rifiniture che migliorano l’affidabilità generale del progetto, confermando l’impegno del suo sviluppatore nel rendere Ultrahand Overlay uno degli strumenti di riferimento per la gestione degli overlay su Nintendo Switch.

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. Implementato il corretto ritorno al contesto originale per i comandi open nei pacchetti.
   • Tornando indietro da un overlay aperto tramite il comando open, ora si viene riportati esattamente al punto in cui ci si trovava all’interno del pacchetto.
   • Con questa modifica, gli overlay possono ora essere realizzati come vere e proprie estensioni o plugin dei pacchetti stessi, che possono sfruttarli direttamente.
2. Aggiunta la ricerca negli array JSON tramite il formato field=value. (by @Niklas080208 in #326).
   • Al posto degli indici degli array nelle voci dei dati JSON, gli utenti possono ora specificare una corrispondenza tramite field=value contenuta nell’array corrispondente.
3. Migliorata la gestione dei controlli touch (grazie agli aggiornamenti della più recente versione di libultrahand).
4. Varie ottimizzazioni al codice e alle librerie.
   • Oltre 160 KB più leggera rispetto alla versione 2.5.2 (ora è la versione più compatta dal rilascio della v1.1.6).
5. Aggiornate libnx e altre librerie di sviluppo.
   • Ora utilizza libnx 4.12.0-1.
6. Ora incluso con nx-ovlloader v2.0.3.
   • Importante: nx-ovlloader v2.0.3 è risultato pienamente funzionante dai test effettuati e dai numerosi riscontri ricevuti dagli utenti, ma una sola segnalazione ha evidenziato un problema che richiederà ulteriori verifiche. Per il momento continueremo quindi a utilizzare nx-ovlloader v2.0.2. — 18/07/2026 02:54 PST
7. Varie correzioni e risoluzioni di bug.

Download: Ultrahand Overlay v2.5.3

Download: lang.zip

Download: sdout.zip

Download: Source code Ultrahand Overlay v2.5.3

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

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