Installare Onion OS su Miyoo Mini e Mini Plus: la guida passo-passo

Il è possibile uscire dalla scatola di un Miyoo Mini Plus con un firmware originale funzionante, ma che mostra presto i suoi limiti: poche impostazioni, nessuna funzione di ripresa del gioco propria e un'organizzazione della scheda di memoria fissa. Onion è la risposta della community a questa situazione. È un sistema completo che risiede sulla scheda microSD, con RetroArch aggiornato, una centinaia di core di emulazione e un gestore di pacchetti per installare solo ciò che serve. Una buona notizia per chi esita: Onion non modifica il firmware della console. Tutto si svolge sulla scheda. Ecco la procedura da seguire, le insidie reali e il modo per tornare indietro in trenta secondi.

Onion, cos'è davvero

La documentazione ufficiale è inequivocabile: « Onion doesn't modify the firmware of your Miyoo Mini so this is not a CFW ». Non è quindi un firmware personalizzato nel senso stretto. Il sistema originale rimane installato nella console; Onion occupa la scheda microSD e prende il controllo all'avvio. Reinstallare la scheda di fabbrica riporta quindi la console allo stato originale. È il sistema alternativo più comodo da provare sul mercato.

Conseguenza meno piacevole: Onion è un ecosistema strettamente dedicato a Miyoo. Il progetto è destinato al Miyoo Mini e al Miyoo Mini+, e a nessun altro dispositivo. Non ha senso provarlo su una RG35XX o su una TrimUI Brick. Per queste console, la nostra tabella di compatibilità firmware indica quale sistema corrisponde a quale console.

La versione del firmware si legge in Settings › Device Info › Version. È l'unico requisito da controllare prima di iniziare.

Cosa offre Onion e cosa no

I vantaggi più evidenti fin dalla prima ora:

• Il GameSwitcher: si riprende una partita da dove era stata lasciata, passando da un gioco all'altro come su un telefono.
• Un RetroArch recente, core ottimizzati, filtri e overlay, più alcuni emulatori autonomi (PCSX-ReARMed, ScummVM).
• Un gestore di pacchetti per scegliere i sistemi e le applicazioni da installare.
• Scorciatoie per i pulsanti: riavvolgimento, avanzamento rapido, screenshot, controllo del volume.
• I salvataggi centralizzati in un'unica cartella /Saves.
• Oltre sessanta porting preconfigurati, un lettore video, una modalità ospite.

Ora i limiti. L'interfaccia è in inglese e la documentazione ufficiale non offre una traduzione in francese del menu principale. Le funzioni di rete (aggiornamento wireless, copertine, gioco in rete, condivisione tramite Samba o FTP) sono riservate al Miyoo Mini Plus, l'unico modello dotato di Wi-Fi. E il chip rimane modesto: niente PlayStation 2 né GameCube. Si rimane su SNES e titoli precedenti, PlayStation 1 e Game Boy Advance, gestiti molto bene.

L'hardware da preparare

Un computer, un lettore di schede e, soprattutto, una seconda scheda microSD. Questo è il punto più importante di questo articolo.

Riguardo alla scheda fornita, la documentazione è diretta: « The SD card included with the Miyoo Mini is known to be slow, and will likely ruin your experience and/or data ». Un altro motivo per scegliere una scheda seria; la nostra guida alla scelta di una scheda microSD spiega cosa conta.

D'altra parte, dimentica il software per scrivere immagini. Onion non viene distribuito come immagine disco: è un archivio ZIP il cui contenuto va copiato su una scheda formattata. Basta uno strumento di formattazione. Su Windows, il progetto comunitario Onion Desktop Tools automatizza la formattazione FAT32, il download, l'installazione e il ripristino della scheda.

Installazione passo dopo passo

1. Identifica il modello e la versione del firmware: Mini o Mini Plus, quindi Settings › Device Info › Version.
2. Scarica dalla fonte ufficiale, la pagina delle versioni del repository GitHub OnionUI/Onion. Il file si trova in fondo alle note di rilascio, nella sezione Assets, sotto forma di Onion-v4.x.x.zip. Al momento in cui scriviamo, l'ultima versione stabile è la V4.3.1-1 del 24 giugno 2024, archivio Onion-v4.3.1-1.zip. Una pre-versione 4.4.0 è presente sulla stessa pagina: riservala a chi accetta di fare da cavia. Controlla la pagina prima di installare, potrebbe essere uscita una versione più recente.
3. Controlla ciò che hai scaricato. Siamo onesti: il progetto non pubblica una somma di controllo ufficiale, gli unici file allegati sono il ZIP e il codice sorgente. Non c'è quindi alcuna impronta di riferimento con cui confrontare. La tua protezione dipende dalla provenienza: scarica esclusivamente dal repository ufficiale, mai da un link su un forum.
4. Formatta la scheda in FAT32. Non in exFAT, non in NTFS. Il metodo dipende dalla capacità.

   Capacità	Metodo indicato dal progetto
   32 GB o meno	Lo strumento di formattazione integrato del tuo sistema operativo, impostato su FAT32.
   Più di 32 GB	Rufus, con Boot selection = Non bootable, Partition scheme = MBR, File system = Large FAT32, Cluster size = 32 kilobytes (o 16 kilobytes per preservare la scheda).

   La documentazione sconsiglia GUIFormat / fat32format, poiché sono stati segnalati errori di sistema di file oltre i 128 GB.
5. Copia le cartelle nella root della scheda. Estrai l'archivio e posiziona queste sette cartelle nella root: .tmp_update/, BIOS/, Media/, miyoo/, miyoo354/, RetroArch/, Themes/. Attenzione alla prima: il suo nome inizia con un punto, quindi è nascosta per impostazione predefinita su Windows e macOS. Attiva la visualizzazione degli elementi nascosti prima di copiare. E nonostante il nome, .tmp_update non è affatto temporaneo: deve rimanere sempre sulla scheda.
6. Primo avvio. Inserisci la scheda, accendi. Appare la guida rapida, quindi si apre il gestore di pacchetti: scegli i sistemi e le applicazioni da installare, conferma con due pressioni su START. Alla fine, A spegne la console su un Mini, la riavvia su un Mini Plus. Non interrompere l'alimentazione durante questa fase.
7. Copia i tuoi giochi, quindi aggiorna la lista. Dalla scheda Games, SELECT fa apparire Refresh all roms: conferma con A. Senza questo passaggio, una libreria appena copiata potrebbe rimanere invisibile.

Le impostazioni da effettuare subito dopo

Tutto si gestisce dall'applicazione Tweaks, la cassetta degli attrezzi di sistema di Onion.

Lingua

L'interfaccia di Onion è in inglese e lo rimarrà. RetroArch, invece, gestisce la propria lingua nel menu Settings, sezione User: poiché gestisce la maggior parte dell'emulazione, ottieni lì l'essenziale in francese. Vedi le nostre impostazioni essenziali di RetroArch.

Wi-Fi

Solo sul Mini Plus. Una volta configurata la rete, sblocchi l'aggiornamento tramite l'applicazione Onion OTA update, lo Scraper che scarica le copertine, la sincronizzazione dell'ora, il gioco in rete e la condivisione dei file. Su un Mini, tutto passa attraverso il lettore di schede.

Pulsanti e standby

L'applicazione Shortcuts mostra le combinazioni di pulsanti: riavvolgimento, avanzamento rapido, screenshot, controllo del volume. Bastano cinque minuti per scorrerle e l'uso quotidiano cambia. Se la console si blocca su uno schermo nero, la procedura ufficiale consiste nel tenere premuto POWER per più di dieci secondi, fino alla seconda vibrazione.

Dove mettere i tuoi giochi

Una cartella Roms nella root, un sottodirectory per sistema all'interno. Eventuali BIOS vanno nella cartella BIOS nella root, con nomi ed estensioni sensibili alle maiuscole. Le sottodirectory di organizzazione sono tollerate su un solo livello (ad esempio Roms/GB/Hacks) e non devono contenere apostrofi.

Non riepiloghiamo qui l'intera struttura delle cartelle: è trattata nel nostro articolo sul trasferimento dei giochi e la struttura delle cartelle secondo il firmware. Per le copertine, il modo più rapido sul Mini Plus rimane lo Scraper integrato: da una lista di giochi, Y apre il menu Game List Options, da cui avvii il recupero delle immagini.

La trappola numero uno

Sempre la stessa: i nomi delle cartelle dei sistemi sono sensibili alle maiuscole e differiscono da quelli della scheda Miyoo originale. La documentazione lo scrive chiaro e tondo: « Rom folder names are case sensitive and differ in Onion vs the stock Miyoo SD card ».

Lo scenario classico: ricopi la cartella dei giochi dalla vecchia scheda, avvii e metà dei sistemi risulta vuota. Niente è perduto, ma Onion non cerca sotto quei nomi. Confronta le tue cartelle con quelle create da Onion al primo avvio, rispetta le maiuscole alla lettera, quindi rilancia Refresh all roms.

Secondo incidente frequente, con la sua soluzione ufficiale: se la console rimane bloccata su uno schermo nero, collega la scheda al computer ed elimina il file cmd_to_run.sh in .tmp_update. Ciò disattiva la ripresa automatica dell'ultima partita, la causa più comune di questo blocco.

Aggiornamento

Sul Mini Plus connesso al Wi-Fi, l'applicazione Onion OTA update fa il lavoro da sola. Altrimenti, l'aggiornamento manuale segue la logica dell'installazione: estrai il nuovo archivio, ricopi le sette cartelle nella root, accetta la sovrascrittura. Il resto si avvia al successivo avvio.

Il progetto indica che salvataggi, ROM, BIOS e configurazioni sono conservati, con un avvertimento di buon senso: i salvataggi di stato non sopravvivono sempre a un cambio di versione del core. Quindi termina con un salvataggio interno al gioco e copia la cartella /Saves sul tuo computer prima dell'operazione. Due casi particolari: se vieni da una versione 3.9 o precedente, elimina .tmp_update prima di copiare; e se un'installazione va male, ricopia i file permettendoti di saltare BIOS, Icons e Themes, quindi riformatta come ultima risorsa, dopo aver messo Roms e Saves al sicuro.

Tornare indietro

È qui che Onion si dimostra più indulgente degli altri sistemi alternativi. Poiché non modifica il firmware, il ripristino non richiede alcuna operazione: spegni, reinserisci la scheda microSD di fabbrica, riaccendi. Il sistema Miyoo è esattamente nello stato in cui lo avevi lasciato. È per questo che la regola d'oro della seconda scheda non è negoziabile.

Se nonostante tutto hai sovrascritto la scheda originale, esiste una via d'uscita: Onion Desktop Tools sa eseguire il backup e il ripristino di una scheda completa, e Miyoo diffonde le immagini del suo sistema. È più lungo, da cui l'importanza della precauzione.

Per collocare Onion rispetto agli altri sistemi, la nostra guida sull'installazione di un firmware personalizzato (muOS, Knulli, ArkOS, ROCKNIX, Batocera) copre il resto delle console. E se cerchi la console su cui installare Onion, il nostro reparto console Miyoo presenta i modelli in stock, con il loro stato alla consegna su ogni scheda.