Ultrahand Overlay ha ricevuto un aggiornamento significativo, portando la piattaforma a una versione ancora più potente e flessibile per la gestione di menu overlay su Nintendo Switch.

Basato su libultrahand, un fork esteso di libtesla, il sistema consente di interagire con la console tramite comandi in C/C++ eseguibili all’interno di un linguaggio interpretato proprietario simile a Shell o BASH, rendendo possibile automatizzare operazioni complesse in modo modulare e intuitivo tramite file di configurazione come config.ini.

1 di 8

La nuova release migliora profondamente la gestione delle notifiche, spostando tutte le opzioni nel Notifications Menu all’interno delle impostazioni di sistema, permettendo di visualizzare più notifiche contemporaneamente e introducendo un limite di slot gestito in base alla memoria disponibile per l’overlay.

Le notifiche ora supportano icone personalizzate in formato RGBA 50×50 e vengono salvate in file JSON dedicati, con possibilità di filtraggio tramite flag.

I comandi di notifica notify e notify-now sono stati potenziati, offrendo controllo completo su testo, dimensione dei caratteri, allineamento, tipo di suddivisione del testo, durata, titolo, visualizzazione dell’orario e icona dell’applicazione, mentre un nuovo effetto sonoro può essere abilitato tramite il file notification.wav.

Sono stati introdotti nuovi colori tematici per titoli, timestamp e elementi non focalizzati, così come una nuova funzione touch per creare file vuoti e toggle per nascondere completamente il Packages Menu.

Altri miglioramenti includono aggiornamenti automatici dei preview della RAM in base alla memoria dell’overlay, supporto a nuove frequenze per file wav, gestione dei feedback aptico e sonoro in thread separati per maggiore stabilità, ottimizzazioni del codice, correzioni di bug legati alle connessioni internet, alle liste e ai comandi di script overlay, oltre alla pulizia dei file JSON delle lingue rimuovendo variabili inutili.

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:

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

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

3. 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.
4. 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.
5. 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.
6. 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

1. Numerosi miglioramenti all’implementazione delle notifiche.
   • Le opzioni delle notifiche sono state spostate nel Notifications Menu (nelle impostazioni di sistema).
   • Ora è possibile mostrare più notifiche contemporaneamente (fino al valore di Max Slots).
     • Se si utilizza 4MB di memoria overlay, il numero massimo di slot è 4; altrimenti è 8 (valore predefinito 4).
   • API Notifications (formerly known as External Notifications) are formatted as follows:

     {
         "text": "This is an example notification.",
         "font_size": 24, #optional
         "split_type": "word" #optional, word by default
         "alignment": "left", #optional, center by default without a title
         "duration": 4000, #optional duration in ms
         "title": "Example App", #optional, allows show_time
         "show_time": "true", #optional, true by default
         "priority": 20, #optional (ideally not modified)
     }
     • Vengono salvate in /config/ultrahand/notifications/{APP_ID}-{UNIQUE_ID}.notify (JSON format)
     • Le notifiche delle API possono essere filtrate in base all’esistenza del file /config/ultrahand/flags/notifications/{APP_ID}.flag.
   • Le icone delle notifiche sono ora supportate e devono avere dimensioni 50×50 in formato RGBA, con {APP_ID} corrispondente a quello presente nel JSON della notifica.
     • /config/ultrahand/assets/notifications/{APP_ID}.rgba
   • Il comando del pacchetto notify / notification e notify-now / notification-now è stato ampliato.
     • notify <MESSAGE> [FONT_SIZE] [TEXT_ALIGNMENT] [SPLIT_TYPE] [DURATION_MS] [TITLE] [SHOW_TIME] [APP_NAME]
       • <MESSAGE>: Il testo principale della notifica. (possono essere visualizzate solo 4 righe)”.
       • [FONT_SIZE]: Un valore intero nell’intervallo da 8 a 48 (24 di default se c’è un titolo, 26 se non c’è titolo).
       • [TEXT_ALIGNMENT]: Può essere left, center o right.
         • Per impostazione predefinita, senza titolo è center e con il titolo è left.
       • [SPLIT_TYPE]: Può essere word o char.
       • [DURATION_MS]: La durata del prompt in millisecondi. (minimo 500, default 4000)
         • Un valore di durata pari a 0 mantiene il prompt visualizzato indefinitamente fino alla sua chiusura.
       • [TITLE]: Un titolo per la notifica.
       • [SHOW_TIME]: Un valore true/false per mostrare il timestamp insieme al titolo. (richiede un titolo)
       • [APP_NAME]: Permette al comando di notifica di usare un’icona (utilizzato se presente).
         • Per usare un nome app senza titolo, il titolo deve essere una stringa vuota ("").
     • notify-now segue lo stesso schema di notify, ma viene sempre mostrato nello slot 0 con priorità immediata.”
     • Nota: Tutti i parametri tra [] sono opzionali e vengono interpretati in base al loro valore e all’ordine in cui vengono forniti.
   • Aggiunto un nuovo effetto sonoro per le notifiche nel percorso: /config/ultrahand/sounds/notification.wav.
     • Gli utenti potrebbero dover riapplicare il tema predefinito affinché questo nuovo effetto sonoro venga caricato.
     • L’opzione “Silence Notifications” disabilita gli effetti sonori delle notifiche.
   • Le notifiche possono essere chiuse premendo KEY_MINUS, oppure tramite tocco diretto sullo schermo.
   • Aggiunta una scorciatoia per attivare/disattivare le notifiche API (tenere premuto KEY_MINUS per 4 secondi), che consente di disabilitarle rapidamente quando necessario.
     • Questa scorciatoia per l’API può essere abilitata o disabilitata dal menu Notifications.
2. Nuovi colori del tema: notification_title_color, notification_time_color e unfocused_color.
   • notification_title_color è il colore usato per i titoli delle notifiche.
   • notification_time_color è il colore usato per il timestamp delle notifiche.
   • unfocused_color è il colore con cui viene mostrata la scritta KEY_A + “OK” nella parte inferiore dell’overlay quando nessun elemento è selezionato.
3. Nuovo comando di pacchetto touch, utilizzabile come touch <PATH_TO_FILE>.
   • Il comando crea un file di testo vuoto nel percorso indicato se il file non esiste.
4. Nuova opzione nel menu Packages (in Miscellaneous) per nascondere completamente il menu dei pacchetti.
5. Il placeholder per il timestamp {timestamp()} (senza parametro di formattazione) ora può essere utilizzato anche come {timestamp}.
6. Le anteprime della RAM di sistema ora cambiano automaticamente quando si modificano le impostazioni di Overlay Memory nel menu System Settings.
7. Gli effetti sonori ora possono utilizzare file WAV PCM a 16 bit con frequenze di campionamento di 8000 Hz, 11025 Hz, 16000 Hz, 22050 Hz, 32000 Hz e 44100 Hz, oltre ai 48000 Hz.
8. Il sistema di feedback (vibrazione + suono) ora viene elaborato in un thread in background dedicato, migliorando prestazioni e affidabilità.
9. Miglioramenti alla vibrazione (haptics) in modalità portatile.
10. Pulizia dei file JSON delle lingue (rimozione di variabili inutilizzate o non necessarie).
11. Correzione di un bug nei controlli della connessione internet durante le chiamate di download.
12. Varie correzioni e miglioramenti alle classi delle liste.
13. Varie ottimizzazioni del codice, correzioni di bug e miglioramenti generali.

Full Changelog: f580fd9...v2.3.0

Aggiornamento rapido:

• Correzione di un bug nel parsing dei placeholder JSON (per consentire la conversione di valori numerici / booleani in stringhe). – 12/03/2026 23:26 PST
• Lo Script Overlay non rimuove più i tag dai comandi ListItem (correzione di bug). – 12/03/2026 23:26 PST
• Correzione di un bug nel posizionamento del timestamp delle notifiche (per le notifiche senza icone). – 12/03/2026 23:42 PST
• Colorazione del simbolo separatore nel testo delle notifiche. – 13/03/2026 00:01 PST
• Correzione di un bug nella chiusura delle notifiche tramite tocco in modalità lato destro. – 13/03/2026 01:12 PST

Full Changelog: v2.3.0...7df15c9

Download: Ultrahand Overlay v2.3.0

Download: lang.zip

Download: sdout.zip

Download: Source code Ultrahand Overlay v2.3.0

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

Ultimo aggiornamento 2026-06-16 / Link di affiliazione / Immagini da Amazon Product Advertising API