CyberFoil, il noto strumento open source sviluppato da luketanti e considerato da molti nella community come l’evoluzione moderna dei più completi installer apparsi su Nintendo Switch, ha ricevuto un aggiornamento significativo con la versione 1.4.2.

Nato come fork di Awoo Installer, CyberFoil si è progressivamente distaccato dal progetto originale, offrendo ora una gestione più completa e raffinata dell’esperienza utente sulle console con custom firmware come Atmosphere, avviate tramite Hekate.

L’app non si limita alla semplice installazione di pacchetti, ma funge da vero centro di controllo per sistemi modificati, con strumenti avanzati per shop, download, gestione offline e aggiornamenti.

La versione 1.4.2 migliora in particolare la reattività dello shop, velocizzando l’avvio soprattutto su console con molti titoli installati e introducendo il lazy loading nella sezione Installed per ridurre i tempi iniziali.

Il caricamento delle icone è stato ottimizzato: vengono preferite le icone offline e, in caso di assenza, si ricorre automaticamente all’URL dello shop, garantendo una navigazione fluida anche durante il caricamento delle immagini.

Per quanto riguarda le funzioni di rete e download, il supporto ai link JBOD è stato migliorato con parsing più accurato e gestione segmentata, mentre le connessioni HTTP beneficiano di retry e resume affidabili, con supporto per autenticazione di base e user-agent unificato.

L’aggiornamento offline del database è ora più veloce grazie a buffering ottimizzato e download paralleli, con fallback automatico a stream singolo quando necessario e miglioramenti nella visualizzazione del progresso di download, verifica e installazione.

L’esperienza di aggiornamento dell’app è stata resa più trasparente: un visualizzatore di changelog integrato consente agli utenti di leggere le note di rilascio prima di aggiornare, con supporto a release note lunghe organizzate in pagine per una leggibilità ottimale.

Infine, sono stati introdotti miglioramenti di qualità della vita, come lo schermo che si oscura automaticamente durante installazioni prolungate e si ripristina al tocco, rendendo l’uso quotidiano più comodo e intuitivo.

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

Questo aggiornamento si concentra sulla reattività dello shop, aggiornamenti più rapidi del database offline, installazioni di rete più affidabili e una migliore esperienza di aggiornamento.

Shop

• Velocità di avvio dello shop migliorata, soprattutto su console con molti titoli installati.
• Introduzione del lazy loading nella sezione “Installati” per ridurre i tempi di caricamento iniziali.
• Caricamento delle icone dello shop migliorato.
• Le icone offline vengono privilegiate; se mancanti, si utilizza l’URL dell’icona dello shop.
• Il caricamento delle icone dello shop è non-bloccante, permettendo una navigazione fluida durante il caricamento delle immagini.

Rete e Download

• Supporto ai link JBOD migliorato.
• Parsing più accurato degli URL JBOD e gestione dei download segmentati.
• Affidabilità dei download HTTP migliorata con retry e resume automatici.
• Supporto per autenticazione di base nei download di rete.
• Gestione unificata dell’user-agent HTTP in uscita per tutta l’app.
• L’user-agent predefinito rimane “cyberfoil”.

Database Offline

• Velocità di download del database offline migliorata grazie a buffering ottimizzato e download paralleli.
• Fallback a download a flusso singolo quando i download segmentati non sono adatti.
• Miglioramento della visualizzazione del progresso durante download, verifica e installazione del database offline.

Esperienza di Aggiornamento

• Aggiunto un visualizzatore di changelog nella notifica di aggiornamento dell’app.
• Gli utenti possono ora visualizzare le note di rilascio prima di decidere se aggiornare.
• Le note di rilascio lunghe vengono visualizzate in un visualizzatore a pagine per una migliore leggibilità.

Miglioramenti di Qualità della Vita

• Oscuramento dello schermo durante installazioni prolungate per inattività.
• Toccando lo schermo, la luminosità normale viene ripristinata.

Versione

• Aggiornato dalla versione 1.4.1 alla 1.4.2.

Download: CyberFoil v1.4.2

Download: Source code CyberFoil v1.4.2

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