Il developer sthetix ha rilasciato un nuovo aggiornamento per HATSKit Pro, il software per PC Windows pensato per semplificare la creazione, la personalizzazione e la gestione dei pack Atmosphere ed Hekate destinati alle console Nintendo Switch modificate.

Il programma continua a rappresentare uno strumento centrale per chi utilizza il custom firmware in modo regolare, riducendo sensibilmente le operazioni manuali necessarie per mantenere aggiornati componenti come Atmosphere, Hekate, SigPatches e vari homebrew.

HATSKitPro Version 2.0.1 is out!

• Added `Edit Target Path` in the Component Extras window.
• Improved component extras retargeting for files under `assets/component_extras/<component_id>/`.
• Changed `Scan F…

Download: https://t.co/lZn0wXw49u

— sthetix (@sthetixofficial) June 14, 2026

Con la versione 2.1 arrivano diversi miglioramenti che riguardano soprattutto la gestione dei componenti e l’esperienza d’uso generale.

Una delle novità più rilevanti è l’introduzione della possibilità di modificare il percorso di destinazione direttamente nella finestra Component Extras, rendendo più flessibile e immediata la gestione dei file associati ai singoli elementi del pack.

Migliorata inoltre la logica di retargeting dei componenti, con una gestione più precisa dei file contenuti in assets/component_extras/<component_id>/, così da garantire una struttura più coerente e ordinata.

Anche l’interfaccia grafica ha ricevuto un importante aggiornamento. Il pulsante Scan Folder è stato reso più evidente e non appare più disabilitato nel tema scuro, migliorando la chiarezza e la percezione delle azioni disponibili.

Nel Pack Builder è stata introdotta una codifica visiva più intuitiva: i componenti appena aggiunti vengono evidenziati in arancione, mentre i nuovi elementi sono contrassegnati con il simbolo “+” e quelli modificati con “*”, facilitando il confronto tra le diverse versioni del pack.

Sul fronte delle integrazioni, il supporto a GitHub è stato potenziato con una migliore normalizzazione degli URL e una scansione più accurata dei metadati dei repository.

Aggiunta inoltre la possibilità di effettuare richieste API autenticate tramite GitHub Personal Access Token, migliorando l’affidabilità del controllo delle versioni e delle release disponibili.

Parallelamente, è stato aggiornato il database interno dei componenti, includendo versioni più recenti e l’entry aggiornata del componente ProdinForge.

Infine, viene specificato che assets/skeleton.zip rimane una soluzione legacy opzionale, mentre i componenti con risorse integrate restano la fonte preferenziale per configurazioni e contenuti specifici.

Funzionalità

Pack Builder

• Seleziona da una libreria di componenti disponibili.
• Cerca e filtra i componenti per categoria.
• Anteprima dei componenti selezionati prima della build.
• Recupera le ultime informazioni di versione da GitHub.
• Crea pack HATS personalizzati con i componenti scelti.
• Rilevamento automatico della versione e download.
• Applica gli extra dei componenti solo quando il componente è selezionato.
• Continua la build senza assets/skeleton.zip quando gli extra forniscono i file migrati.

Component Editor

• Visualizza e modifica le definizioni dei componenti.
• Aggiungi nuovi componenti alla libreria.
• Configura le sorgenti di download (GitHub releases o URL diretti).
• Definisci i passaggi di elaborazione per ogni componente.
• Gestisci i metadati dei componenti (nome, categoria, descrizione).
• Supporto per più tipi di sorgenti e pattern di asset.
• Gestisci gli extra dei componenti come config, risorse payload, file BMP, .bin e .dat.
• Modifica direttamente nell’app file testuali (.ini, .txt, .config, .cfg, .json e simili).
• Scansiona assets/component_extras/<component_id>/ per registrare automaticamente file aggiunti manualmente.
• Modifica assets/skeleton.zip quando il contenuto di fallback legacy deve ancora essere aggiornato.

Pack Manager

• Scarica pack HATS ufficiali direttamente da GitHub.
• Scarica firmware pack ufficiali direttamente da GitHub.
• Installa i pack sulla scheda SD con un clic.
• Visualizza i componenti installati con informazioni dettagliate.
• Sposta i componenti nel cestino per una rimozione sicura.
• Ripristina i componenti dal cestino.
• Rilevamento automatico del percorso della scheda SD.

Extra Config

• Gestisci la connettività di rete Nintendo sysMMC dalla configurazione su SD.
• Blocca la connettività sysMMC Nintendo usando la configurazione sicura predefinita.
• Consenti la connettività sysMMC Nintendo quando necessario.
• Aggiorna gli stessi file core usati dal controllo rete sysMMC in stile NetMan.
• Si concentra solo sulla connettività sysMMC; le modalità online/offline emuMMC non sono gestite qui.

Funzionalità aggiuntive

• Integrazione API GitHub integrata con supporto PAT.
• Dimensione chunk download configurabile per prestazioni ottimali.
• Interfaccia dark theme basata su ttkbootstrap.
• Gestione avanzata degli errori e feedback utente.
• Archiviazione persistente della configurazione.
• Fallback skeleton opzionale per layout legacy dei pack.

Installazione

Usando il launcher Python (consigliato)

• Scaricare l’ultima release.
• Estrarre l’archivio nella cartella desiderata.
• Fare doppio click su HATSKitPro.exe per avviare l’app.

Fatto! Il launcher farà automaticamente:

• Verifica se .NET è installato sul sistema.
• Installa .NET se assente.
• Verifica se Python è installato.
• Installa Python se assente.
• Installa tutte le dipendenze richieste (ttkbootstrap, requests, py7zr).
  • py7zr viene usato per estrarre archivi .7z durante la build dei pack.
• Avvia HATSKit Pro.

Nessuna configurazione manuale o operazione da terminale richiesta!

Installazione manuale (utenti avanzati)

Se si preferisce eseguire dal sorgente:

• Clonare la repository:

git clone https://github.com/sthetix/HATSKitPro.git
cd HATSKit-Pro

• Installare Python 3.8 o superiore (se non già presente).
• Installare le dipendenze: pip install ttkbootstrap requests py7zr
  • py7zr è necessario per estrarre archivi .7z durante la build dei pack.
• Avviare l’app: python hatskitpro.py

Utilizzo

Prima configurazione

1. Configurare GitHub Personal Access Token (opzionale ma consigliato).
   • Andare su Settings > GitHub PAT.
   • Inserire il token.
   • Questo aumenta i limiti API e velocizza i controlli versione.
   • Il token viene salvato in modo sicuro in config.json.
2. Impostare il percorso della SD.
   • Andare nel tab Manager.
   • Cliccare Browse... per selezionare la SD card.
   • Oppure inserire manualmente il percorso (es. E:\ o F:).

Creazione di un pack personalizzato

• Andare al tab Pack Builder.
• Cercare o esplorare i componenti.
• Utilizzare il filtro categoria.
• Selezionare i componenti (Ctrl o Shift per multi-selezione).
• Anteprima nella colonna destra.
• Cliccare su Fetch Versions (opzionale).
• Cliccare su Build Pack.

Il pack verrà salvato come: HATS-[data]-[hash].zip

Installazione di un pack

1. Andare sul tab Manager.
2. Opzione A – Pack ufficiale
3. Cliccare Refresh.
4. Cliccare Download Latest.
5. Attendere il download.
6. Cliccare Install to SD Card.
7. Opzione B – Pack personalizzato
   • Cliccare Select Pack (.zip)...
   • Oppure viene selezionato automaticamente dopo la build.
8. Assicurarsi che il percorso SD sia impostato.
9. Cliccare Install.

Gestione componenti

• Andare su Manager.
• Visualizzare componenti installati.
• Selezionare quelli da rimuovere.
• Cliccare su Move to Trash.
• Utilizzare il cestino per ripristinare se necessario.

Configurazione rete sysMMC

La scheda Extra Config segue lo stesso ambito semplificato del payload NetMan: gestisce esclusivamente la connettività di rete sysMMC Nintendo.

Modalità disponibili:

• Blocca connettività Nintendo (default sicuro).
• Consenti connettività Nintendo.

Quando blocca sysMMC:

• HATSKit Pro applica impostazioni equivalenti alla modalità sysMMC protetta di NetMan.
• Abilita blank_prodinfo_sysmmc.
• Mantiene blank_prodinfo_emummc disabilitato.
• Scrive regole in atmosphere/hosts/sysmmc.txt.
• Mantiene DNS MITM attivo.
• Abilita sys-patch e blocco update firmware.

Quando consente sysMMC:

• Disabilita blank_prodinfo_sysmmc.
• Mantiene blank_prodinfo_emummc disabilitato.
• Rimuove il blocco degli host Nintendo su sysMMC.
• Mantiene attivo DNS MITM con host predefiniti disabilitati.
• Mantiene attive le patch di rete sys-patch.
• Consente gli aggiornamenti del firmware.

La scheda Configurazione aggiuntiva non gestisce più separatamente le modalità online/offline o entrambe online di emuMMC.

Editing componenti

1. Andare nella scheda Component Editor.
2. Selezionare un componente dalla lista.
3. Modificare i dettagli del componente:
   • Informazioni di base (nome, categoria, descrizione).
   • Tipo di sorgente (release GitHub o URL diretto).
   • Informazioni della repository e pattern degli asset.
   • Passaggi di elaborazione per estrazione e posizionamento.
4. Cliccare su Save Changes per aggiornare la definizione del componente.
5. Utilizzare Add New per creare nuove voci di componenti.

Gestione Component Extras

I component extras sono file che appartengono a un componente specifico e vengono inclusi nel pack finale solo quando quel componente viene selezionato.

Esempi:

• Hekate: bootloader/hekate_ipl.ini, bootloader/res/*.bmp
• Ultrahand: config/ultrahand/config.ini
• DBI: switch/DBI/dbi.config
• Modchip payload helpers: boot.dat, bootloader/payloads/*.bin

Per aggiungere gli extras tramite interfaccia (UI):

• Andare nella scheda Component Editor.
• Selezionare un componente.
• Cliccare su Edit Extras.
• Cliccare su Add File.
• Scegliere il file da includere.
• Inserire la cartella di destinazione all’interno del pack.
• Per file nella root come boot.dat, lasciare la cartella vuota o usare /.
• Per risorse Hekate, usare bootloader/res/.
• Per configurazioni Ultrahand, utilizzare config/ultrahand/.
• I file di testo possono essere selezionati e modificati con Edit.
• I file binari o risorse possono essere sostituiti con Edit.

Per registrare i file copiati manualmente:

• Copiare i file in assets/component_extras/<component_id>/
• Mantenere sotto quella cartella la struttura del percorso finale prevista nel pack.
• Cliccare su Edit Extras.
• Cliccare su Scan Folder.

Esempio:

assets/component_extras/hekate/bootloader/hekate_ipl.ini
assets/component_extras/hekate/bootloader/res/ofw.bmp
assets/component_extras/hekate/bootloader/res/sysnand.bmp

Dopo la scansione, i file vengono registrati come:

bootloader/hekate_ipl.ini
bootloader/res/ofw.bmp
bootloader/res/sysnand.bmp

Durante la fase di build, i component extras sovrascrivono per impostazione predefinita i file già esistenti nello stesso percorso di destinazione. Questo rende possibile migrare gradualmente i file fuori da skeleton.zip in modo sicuro.

Skeleton fallback

Il file assets/skeleton.zip ora è opzionale. Può ancora essere utilizzato come archivio base legacy, ma gli component extras rappresentano la soluzione preferita per ospitare configurazioni e file di risorse appartenenti ai singoli componenti.

Ordine di costruzione:

optional skeleton.zip
+ selected component downloads
+ selected component extras
+ generated manifest and metadata
= final HATS pack

Se il file assets/skeleton.zip non è presente, il programma di compilazione registra un messaggio che indica che sta continuando senza di esso. Questo comportamento è previsto per le configurazioni migrate da HATSKit Pro 2.0.

Processing steps (riferimento)

Le fasi di elaborazione definiscono come le risorse scaricate vengono estratte e inserite nel pacchetto HATS. Azioni disponibili:

Esempio: Organizzazione di applicazioni homebrew:

{
  "pattern": "*.nro",
  "processing_steps": [
    {
      "action": "copy_file_to_auto_folder",
      "target_path": "switch/"
    }
  ]
}

Esempio – Patch del tema:

{
  "pattern": "theme-patches-*.zip",
  "processing_steps": [
    {
      "action": "unzip_subfolder_to_path",
      "subfolder_name": "theme-patches-master/systemPatches",
      "target_path": "themes/"
    }
  ]
}

Configurazione

config.json

Contiene le impostazioni dell’applicazione:

• github_pat: Il GitHub Personal Access Token (opzionale)
• download_chunk_size: Dimensione dei chunk di download in byte (predefinito: 2 MB)

components.json

Contiene tutte le definizioni dei componenti, inclusi:

• Metadati dei componenti.
• Sorgenti di download.
• Informazioni sulle versioni.
• Istruzioni di elaborazione (processing).
• Metadati degli extra dei componenti.

Esempio di componenti aggiuntivi:

{
  "component_extras": [
    {
      "type": "text",
      "target": "bootloader/hekate_ipl.ini",
      "source": "assets/component_extras/hekate/bootloader/hekate_ipl.ini",
      "enabled": true,
      "overwrite": true
    },
    {
      "type": "file",
      "target": "bootloader/res/ofw.bmp",
      "source": "assets/component_extras/hekate/bootloader/res/ofw.bmp",
      "enabled": true,
      "overwrite": true
    }
  ]
}

manifest.json

• Tiene traccia delle informazioni relative all’ultimo pacchetto compilato, a scopo di riferimento.

Requisiti di sistema

• Sistema operativo: Windows 7/8/10/11 (64 bit)
• Python: versione 3.8 o superiore (installato automaticamente dal launcher)
• Memoria RAM: minimo 2 GB
• Spazio su disco: almeno 100 MB liberi (più spazio aggiuntivo per i pack)
• Connessione Internet: necessaria per scaricare componenti e pack ufficiali

Limiti API di GitHub

Senza autenticazione, le API di GitHub sono limitate a 60 richieste all’ora. Utilizzando un Personal Access Token (PAT):

• Il limite aumenta fino a 5.000 richieste all’ora.
• Consente un controllo più rapido delle versioni dei componenti.
• Questo è consigliato (e spesso necessario) per un utilizzo intensivo del sistema.

Creazione di un GitHub PAT

• Andare su GitHub Settings > Developer settings > Personal access tokens
• Cliccare su “Generate new token (classic)”.
• Assegnare un nome descrittivo al token (es. “HATSKit Pro”).
• Per repository pubblici non sono necessari permessi o scope speciali.
• Cliccare su “Generate token”.
• Copiare il token e incollarlo nelle impostazioni di HATSKit Pro.

Risoluzione problemi

L’app non si avvia

• Assicurarsi di eseguire il launcher HATSKitPro.exe, non lo script Python direttamente.
• Verificare che l’antivirus non stia bloccando l’applicazione.
• Provare ad avviarla come amministratore.

I componenti non vengono scaricati

• Controllare la connessione a Internet.
• Verificare che GitHub PAT sia valido (se utilizzato).
• Potreste aver raggiunto il limite di richieste dell’API GitHub.
• Riprovare più tardi oppure configurare un PAT.

Installazione non riuscita

• Controllare che il percorso della scheda SD sia corretto.
• Verificare che la SD non sia in sola lettura.
• Assicurarsi di avere spazio sufficiente sulla scheda.
• La SD deve essere formattata in FAT32 o exFAT.

Scheda SD non trovata

• Verificare che la scheda SD sia inserita correttamente.
• Controllare in Esplora File la lettera dell’unità assegnata.
• Provare un’altra porta USB o un lettore di schede diverso.

Changelog

Modifiche

• Aggiunto Edit Target Path nella finestra Component Extras.
• Migliorato il retargeting dei componenti extra per i file presenti in assets/component_extras/<component_id>/.
• Il pulsante Scan Folder è stato reso un pulsante primario pieno, così da non sembrare più disabilitato nel tema scuro.
• I componenti appena aggiunti vengono ora evidenziati in arancione nella preview del Pack Builder.
• Aggiunto il marcatore + per i nuovi componenti, mantenendo il marcatore * per le versioni modificate.
• Migliorata la gestione delle entry dei repository GitHub con normalizzazione degli URL e scansione dei metadati del repo.
• Aggiunto il supporto a richieste API GitHub autenticate per i controlli di release/versione quando è configurato un GitHub PAT.
• Aggiornati i metadati dei componenti inclusi nel pacchetto, comprese le versioni aggiornate e la voce del componente ProdinForge.

Note

• assets/skeleton.zip rimane un fallback legacy opzionale.
• I componenti con extras integrati restano la fonte preferita per configurazioni e risorse specifiche dei pack.

Download: HATSKit Pro v2.0.1

Download: Source code HATSKit Pro v2.0.1

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

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