CyberFoil continua a crescere e a consolidarsi come uno degli strumenti più avanzati e completi per la gestione delle console Nintendo Switch modificate.

Nato come semplice fork di Awoo Installer, il progetto sviluppato da luketanti ha progressivamente ampliato il proprio raggio d’azione, trasformandosi in una piattaforma articolata capace di gestire non solo l’installazione dei contenuti, ma anche l’intero ecosistema legato ai custom firmware.

In particolare, l’integrazione con ambienti come Atmosphere ed Hekate lo rende uno strumento centrale per chi utilizza abitualmente soluzioni homebrew.

Con il tempo, CyberFoil ha smesso di essere un semplice installer per diventare un vero hub multifunzione, capace di unire gestione degli shop, download dei contenuti, supporto offline e strumenti di controllo del sistema in un’unica interfaccia coerente.

Questa evoluzione ha contribuito a renderlo particolarmente apprezzato dalla community, soprattutto per la sua capacità di semplificare operazioni che altrimenti richiederebbero l’uso di più applicazioni separate.

L’aggiornamento più recente prosegue su questa linea, concentrandosi soprattutto sul miglioramento dell’esperienza utente e sull’ottimizzazione delle prestazioni.

L’interfaccia degli shop è stata resa più chiara e reattiva, grazie a un sistema di caricamento progressivo che fornisce feedback visivi più comprensibili, accompagnati da animazioni che rendono l’attesa meno statica. Anche il processo di connessione agli shop è stato affinato, risultando più fluido e affidabile.

Uno degli interventi più rilevanti riguarda invece la gestione del catalogo degli shop, che ora viene memorizzato in memoria.

Questo significa che, riaprendo uno shop già visitato, non sarà più necessario scaricare nuovamente l’intero catalogo, a meno di un aggiornamento forzato o di modifiche alla configurazione. Si tratta di un miglioramento concreto che riduce i tempi di attesa e rende l’utilizzo quotidiano molto più immediato.

Non manca un’attenzione particolare alla compatibilità, con il supporto ai cosiddetti “legacy shop” tramite modalità Tinfoil e l’introduzione del supporto per shop criptati.

Questi cambiamenti ampliano le possibilità d’uso e rendono CyberFoil più flessibile in contesti diversi, adattandosi meglio alle varie configurazioni utilizzate dagli utenti.

Sul fronte delle correzioni, l’aggiornamento risolve diversi problemi che potevano compromettere la stabilità o l’usabilità.

Tra questi spiccano la gestione degli handle IPC durante l’installazione di file XCI, che in alcuni casi causava errori, e vari bug legati all’interfaccia, come pulsanti non responsivi o comportamenti incoerenti dopo alcune operazioni.

Anche la gestione dei dispositivi di input è stata migliorata, garantendo una risposta più precisa dopo l’utilizzo della tastiera virtuale.

Infine, sono stati apportati aggiornamenti a livello strutturale e di sviluppo, con l’aggiornamento di componenti interni, workflow di integrazione continua e manutenzioni generali del repository.

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

• Migliorata l’esperienza di caricamento degli shop:
• Aggiunto un caricamento progressivo a fasi con aggiornamenti di stato più chiari.
• Introdotto un feedback visivo animato durante il caricamento.
• Migliorato il flusso di connessione agli shop.
• Aggiunto caching del catalogo shop in memoria:
  • Riaprendo uno shop non è più necessario riscaricare l’intero catalogo (salvo aggiornamento forzato o modifiche alla configurazione).
• Aggiunta la compatibilità con shop legacy (modalità Tinfoil).
• Aggiunto il supporto per shop criptati.

Correzioni

• Risolto un problema di esaurimento degli handle IPC durante l’installazione di file XCI dallo Shop (@davidpfarrell).
• Corretti casi in cui i pulsanti diventavano non responsivi.
• Sistemato il comportamento del tasto “indietro” al termine di un’installazione tramite MTP.
• Corretto il comportamento dell’icona di selezione nella modalità lista dello Shop.
• Aggiornato lo stato dei dispositivi di input dopo la chiusura della tastiera software.

Piattaforma / Build / Infrastruttura

• Aggiornato il submodule Plutonium.
• Aggiornati i workflow CI (dev/master/release con aggiunte e modifiche).
• Eseguite varie correzioni e manutenzioni minori del repository e del sistema di build.

Download: CyberFoil v1.4.4

Download: Source code CyberFoil v1.4.4

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

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