CyberFoil continua la sua evoluzione con la versione 1.4.3, confermandosi come uno degli strumenti più completi e moderni per la gestione dei sistemi modificati su Nintendo Switch.

Nato inizialmente come fork di Awoo Installer, il progetto sviluppato da luketanti ha progressivamente acquisito una propria identità, trasformandosi da semplice installer a vero e proprio hub di gestione per console con custom firmware come Atmosphere avviato tramite Hekate.

Nel tempo CyberFoil si è distinto per la sua capacità di andare oltre la semplice installazione di pacchetti, offrendo una piattaforma completa che integra gestione degli shop, download dei contenuti, modalità offline e strumenti per il controllo e l’aggiornamento del sistema.

Questa visione più ampia lo rende particolarmente apprezzato dalla community, soprattutto da chi utilizza frequentemente ambienti homebrew e necessita di un’interfaccia affidabile e ben organizzata.

L’aggiornamento alla versione 1.4.3 introduce una serie di miglioramenti che incidono sia sulle prestazioni che sull’esperienza utente.

Uno degli elementi più rilevanti è l’introduzione del supporto ai blocchi NCZ durante l’installazione, una novità tecnica che amplia la compatibilità con determinati formati e migliora la gestione dei contenuti compressi.

Parallelamente, è stato svolto un lavoro significativo sull’interfaccia degli shop, con tempi di caricamento ridotti anche in presenza di liste molto estese e una maggiore reattività durante la navigazione tra visualizzazioni a elenco e griglia.

Sono stati risolti diversi piccoli problemi che influenzavano la fluidità dell’interfaccia, come il ritardo nel passaggio tra le modalità di visualizzazione e la gestione dello stato degli elementi selezionati.

Anche il comportamento dopo l’installazione è stato migliorato, rendendo più immediato l’aggiornamento delle liste. A questo si aggiungono nuove opzioni per ordinare i contenuti e una separazione più chiara tra ricerca e filtri, elementi che contribuiscono a rendere la navigazione più intuitiva.

Dal punto di vista della compatibilità e della rete, CyberFoil si aggiorna per adattarsi alle più recenti specifiche di autenticazione, introducendo un sistema aggiornato per la generazione di UAUTH.

Migliorato inoltre il supporto ai percorsi degli shop, con una gestione più intelligente delle configurazioni legacy, mentre viene mantenuta la compatibilità con porte personalizzate durante la modifica delle impostazioni. Allo stesso tempo, è stato rimosso il vecchio sistema di cache degli shop, ormai superato.

Un altro aspetto fondamentale di questa versione riguarda diagnostica e affidabilità. Sono stati introdotti strumenti avanzati di logging, con la possibilità di salvare file di debug dettagliati direttamente dal menu delle opzioni.

Questo consente di analizzare in modo più preciso eventuali problemi durante l’installazione, grazie anche a un sistema di classificazione degli errori più chiaro.

Inoltre, la gestione interna dei processi di scrittura e salvataggio dei dati è stata migliorata, con l’introduzione di buffer che aumentano stabilità e prestazioni durante le operazioni più delicate.

Infine, anche il lato sviluppo riceve un piccolo aggiornamento con l’introduzione di metadati legati al versionamento Git, utili per tracciare meglio le build in fase di sviluppo. Si tratta di un dettaglio tecnico, ma importante per mantenere ordine e trasparenza nel ciclo di aggiornamento del progetto.

Funzionalità

• L’applicazione consente l’installazione di file NSP/NSZ/XCI/XCZ e di file NSP/XCI suddivisi direttamente dalla scheda SD.
• Supporta l’installazione di file NSP/NSZ/XCI/XCZ via LAN o USB tramite strumenti come NS-USBloader.
• Permette l’installazione di file NSP/NSZ/XCI/XCZ da internet tramite URL o Google Drive.
• Permette l’installazione di file NSP/NSZ/XCI/XCZ tramite MTP (trasferimento file USB).
• Verifica le NCA tramite firma dell’header prima dell’installazione.
• Consente di installare e gestire rapidamente le patch di firma più recenti.
• Integra un eShop con sezioni, ricerca e anteprime delle copertine.
• Gestore backup dei dati di salvataggio: permette di sfogliare i salvataggi presenti sulla console o sul server, caricare backup con note, scaricare versioni specifiche dei propri salvataggi ed eliminare file di salvataggio dal server.
• Include una modalità OLED con sfondi nero puro.
• Fork di Awoo Installer (Huntereb Awoo Installer).
• Basato su Adubbz Tinfoil.
• Utilizza Plutonium di XorTroll per un’interfaccia grafica curata.

Motivazioni

Il progetto nasce come alternativa a Tinfoil, che non è più supportato né aggiornato per le nuove versioni del firmware. Per funzionalità avanzate come la gestione dei ticket installati, dei titoli e degli account utente, viene consigliato l’utilizzo di Goldleaf.

eShop

CyberFoil supporta un eShop con sezioni, ricerca e anteprime delle copertine.

Configurazione

• Avviare il backend del proprio shop e annotare l’host e la porta (esempio: http://192.168.1.2:8465).
• Nelle impostazioni di CyberFoil, impostare l’URL dello Shop, l’username e la password (opzionale).
• Se lo shop è privato, assicurarsi che le credenziali siano corrette.

Navigazione

• e cambiano sezione (New, Recommended, Updates, DLC, All, Installed).
• avvia la ricerca nella sezione All.
• Il pannello a destra mostra la copertina dell’elemento selezionato.
• La sezione Installed utilizza una visualizzazione a griglia con navigazione tramite . Premere per vedere i dettagli.
• In modalità griglia, i titoli selezionati mostrano un’evidenziazione verde e un overlay di selezione.

Aggiornamenti e DLC

• Gli aggiornamenti e i DLC vengono mostrati solo se il titolo base è installato.
• L’elenco degli aggiornamenti mostra solo quelli più recenti rispetto alla versione installata.

Procedura di installazione

• Seleziona uno o più titoli base e premere per installare.
• CyberFoil può chiedere se includere eventuali aggiornamenti disponibili per i titoli selezionati.

Note

• Le risposte cifrate dello shop non sono supportate.
• La sezione Installed elenca i contenuti già presenti sulla console e non consente l’installazione da lì.
• L’elenco dello shop viene memorizzato in cache per un avvio più rapido (TTL di 5 minuti). Premere per aggiornare.

Save Sync

• Disponibile quando l’account dispone dell’accesso al backup.
• Mostra i salvataggi locali della console e i backup remoti presenti sul server in una sezione dedicata “Saves”.
• L’upload supporta l’aggiunta di note di versione.
• Download ed eliminazione dei backup remoti consentono la selezione per singola versione tramite layout con selettore integrato nella pagina.

Metadati/Icone offline (senza controlli online):

• CyberFoil può utilizzare metadati locali dei titoli e icone locali da sdmc:/switch/CyberFoil/offline_db/.
• Genera la cartella dai file artefatto di CyberFoil-DB con: python tools/export_offline_db.py --source-dir <path-to-CyberFoil-DB-artefacts> --output-dir <folder>/offline_db
• Oppure specifica i file manualmente: python tools/export_offline_db.py --icon-db <path>/icon.db --titles-json <path>/titles.US.en.json --output-dir <folder>/offline_db
• Per generare un manifest di aggiornamento per GitHub Releases, includi: --manifest-base-url https://github.com/<owner>/<repo>/releases/latest/download
• L’exporter crea offline_db_manifest.json con versione, dimensione e sha256 per titles.pack e icons.pack.
• Copia la cartella offline_db generata in sdmc:/switch/CyberFoil/offline_db/.
• File runtime utilizzati da CyberFoil: titles.pack, icons.pack e manifest.json locale (opzionale).
• icons.pack viene caricato direttamente in memoria a runtime (non servono file icona estratti in cache).
• In Impostazioni → Shop, utilizzare Offline DB update (…) per verificare/scaricare versioni più recenti dei pack dall’URL del manifest.
• In Impostazioni → Shop, Offline DB auto-check on startup controllare se CyberFoil verifica il manifest all’avvio dell’app.
• Durante il download dell’Offline DB, la schermata di installazione ora mostra progresso e velocità di trasferimento in tempo reale (MB/s) per evitare che sembri bloccata su file di grandi dimensioni.
• Il log di debug dell’aggiornamento Offline DB viene scritto in: sdmc:/switch/CyberFoil/offline_db_update.log.

Note sulle impostazioni

• La modalità OLED utilizza sfondi nero puro per l’interfaccia. Può essere attivata o disattivata all’interno delle impostazioni.
• L’opzione “Remove anime” consente di nascondere la mascotte grafica.
• I suoni possono essere disattivati all’interno delle impostazioni; è possibile personalizzarli inserendo success.wav e bark.wav in sdmc:/switch/CyberFoil/.
• Impostazione MTP: è possibile abilitare/disabilitare l’esposizione dell’unità Album mentre è in esecuzione la modalità di installazione MTP.
• La cache delle icone dello shop è salvata nel percorso sdmc:/switch/CyberFoil/shop_icons/.
• Input touch: Tocca gli elementi nel menu principale e nelle impostazioni per selezionarli.

Obiettivi futuri

• Migliorare ricerca e navigazione per librerie di grandi dimensioni (Pianificato).
• Migliorare la robustezza MTP e la compatibilità con diversi host.
• Aggiungere il supporto per il passaggio tra più shop.
• Precaricare immagini e banner nella cache per un’interfaccia più veloce.
• Realizzare un video tutorial dedicato ai principianti per la configurazione completa (CyberFoil e backend dello shop).

Changelog

Novità principali

• Aggiunto supporto ai blocchi NCZ per le installazioni. (Grazie a @davidpfarrell)
• Migliorate prestazioni e UX dello shop:
• Caricamento più veloce per liste shop di grandi dimensioni. (Grazie a @D35P4C1T0)
• Migliore reattività nella navigazione tra lista e griglia.
• Corretto il ritardo nel cambio lista/griglia e lo stato di visibilità.
• Migliorato il comportamento di aggiornamento dopo l’installazione.
• Aggiunte opzioni di ordinamento nella navigazione.
• Separati i controlli di ricerca e ordinamento.
• Corretto il comportamento della navigazione tenuta premuta e relativo feedback.
• Corretti gli aggiornamenti dello stato delle checkbox nello shop.
• Migliorata la visibilità dello stato di caricamento delle immagini.

Compatibilità e Rete

• Aggiornata la generazione UAUTH per allinearsi alle ultime specifiche di autenticazione.
• Aggiunto supporto ai percorsi degli shop con migrazione delle configurazioni legacy.
• Mantenute le porte personalizzate degli shop durante la modifica.
• Rimosso il supporto alla cache legacy degli shop.

Diagnostica e Affidabilità

• Aggiunto logging di debug su file. (Log di installazione dettagliati nelle Opzioni)
• Aggiunte diagnostiche di installazione, logging dettagliato e classificazione degli errori.
• Migliorata la gestione del ciclo writer/flush nella pipeline di installazione.
• Scrittura dei contenuti su storage bufferizzata per maggiore stabilità e prestazioni.

Build e Sviluppo

• Aggiunti metadati versione dev consapevoli di Git.

Download: CyberFoil v1.4.3

Download: Source code CyberFoil v1.4.3

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

Ultimo aggiornamento 2026-04-12 / Link di affiliazione / Immagini da Amazon Product Advertising API