Installare muOS passo dopo passo: la guida completa

muOS, il cui nome ufficiale di progetto è MustardOS, è un firmware alternativo per console portatili sotto Linux. La versione corrente al momento della nostra ultima verifica è la 2606.0 «Andromeda», pubblicata a fine ottobre 2026. Copre diciotto macchine, principalmente di Anbernic e TrimUI. Se la tua console è presente, calcola circa trenta minuti, compreso il download, e l'operazione si limita a una scheda microSD. Altrimenti, nessuna manipolazione la farà funzionare: è meglio saperlo prima di acquistare una scheda. Questa guida segue la procedura pubblicata dal progetto e segnala i punti in cui ci si sbaglia più spesso.

A chi è rivolto muOS e su quali macchine

muOS è pensato per chi desidera un'interfaccia veloce, un menu chiaro e impostazioni accessibili senza tastiera né terminale. Non è un semplice strato estetico: si cambia sistema operativo.

La lista ufficiale della 2601.1 comprendeva undici modelli Anbernic (RG28XX H, RG34XX H, RG34XX SP, RG35XX 2024, RG35XX H, RG35XX PLUS, RG35XX PRO, RG35XX SP, RG40XX H, RG40XX V, RGCUBEXX) e due TrimUI (Brick e Smart Pro), ovvero la gamma Anbernic con chip Allwinner H700 e le due TrimUI con Allwinner A133 Plus. La 2606.0 aggiunge in particolare la TrimUI Brick Pro, l'Anbernic RG VITA Pro, la GKD Pixel 2 e la BatleXP G350: consulta la pagina Devices di muos.dev per la lista esatta.

Per le macchine assenti da questa lista, la nostra tabella di compatibilità firmware indica quale sistema alternativo corrisponde a quale console.

Cosa offre muOS rispetto al firmware originale

Sulle Anbernic H700, il firmware di fabbrica funziona, ma invecchia male: navigazione lenta, impostazioni sparse, aggiornamenti rari. muOS risponde su quattro punti.

• Una navigazione unificata. Il modulo Explore Content unisce tutti gli archivi montati in un'unica struttura, senza convenzioni di denominazione imposte.
• La scelta dell'emulatore per contenuto. Un gioco ostinato riceve un core diverso senza che il resto della cartella venga toccato.
• Impostazioni di sistema leggibili. Wi-Fi, lingua, sospensione, governor della frequenza, temi, backup dei dati, tutto è contenuto in un menu Configuration strutturato.
• La separazione dei dati. Il modulo Storage sposta salvataggi, copertine e impostazioni sulla seconda scheda.

In cambio, si perde il sistema pronto all'uso e bisogna rifare tutte le impostazioni. Soprattutto, muOS non aumenta le prestazioni: una RG35XX Pro sotto muOS rimane una macchina con Allwinner H700, con gli stessi limiti di emulazione. Per puntare a sistemi più pesanti, bisogna cambiare hardware.

L'hardware necessario

Serve una seconda scheda microSD, un lettore di schede e un software per scrivere immagini. Il progetto consiglia una scheda di qualità da 16 GB o più e cita Samsung e SanDisk. Su una console con due slot, l'immagine viene scritta sulla scheda dello slot 1.

La scheda è il primo componente a cedere su queste console: una scheda lenta o contraffatta provoca blocchi che vengono erroneamente attribuiti al firmware. I criteri sono dettagliati nel nostro articolo sulla scelta di una scheda microSD; quelle che spediamo vengono verificate con una scrittura-lettura completa prima della spedizione.

Installazione passo dopo passo

1. Identifica il tuo modello esatto. È il passaggio più importante e quello più trascurato. RG35XX H, RG35XX PLUS, RG35XX 2024 e RG35XX SP sono quattro macchine diverse, con quattro immagini diverse. Il nome completo è riportato sul retro della console.
2. Scarica l'immagine dal sito ufficiale. Su muos.dev, nella pagina Devices, prendi il file corrispondente alla tua macchina per la versione corrente. L'immagine è distribuita in .img.gz, tramite diversi host di file (Gofile, MEGA, Filen). Nessun link di forum né di canale video.
3. Verifica l'integrità del download. La pagina Devices di muos.dev mostra, per ogni macchina, l'immagine e la sua checksum. Calcola quella del tuo file (certutil -hashfile su Windows, shasum su macOS e Linux) e confronta: un download troncato produce una scheda che non si avvia.
4. Scrivi l'immagine sulla scheda. Il progetto consiglia Raspberry Pi Imager (versione 1.9.6), Alex's USB Image Tool, Rufus, Win32 Disk Imager o USBImager, ed esclude esplicitamente Balena Etcher a causa di ripetuti errori di scrittura. Questi strumenti prendono il .img.gz così com'è, senza decomprimere. Sotto Raspberry Pi Imager: scegli il dispositivo, poi «Use Custom OS», il file, il lettore di schede, ignora le opzioni di personalizzazione, conferma l'eliminazione e lascia che la scrittura e la verifica vadano a termine.
5. In riga di comando, la documentazione indica: gunzip -c < "image_name_here.img.gz" | sudo dd of=/dev/sdxyz bs=4M conv=fsync status=progress. Verifica tre volte il dispositivo di destinazione: un errore qui cancella un disco.
6. Primo avvio. Inserisci la scheda nel primo slot, accendi. Il sistema avvia alcuni menu di configurazione, poi termina da solo. La documentazione avverte: se il dispositivo sembra bloccato su «Factory Reset», lascialo per 5-10 minuti prima di premere reset. Spegnere troppo presto ti costringe a ricominciare.
7. Configurazione iniziale. Nel menu principale, esamina le impostazioni qui sotto prima di copiare anche solo un gioco.

La nostra guida generale all'installazione di un firmware personalizzato include muOS tra Knulli, ArkOS, ROCKNIX e Batocera.

Le impostazioni da fare subito

Lingua

Menu principale, poi Configuration, poi Language. Le traduzioni sono della community, mantenute tramite Weblate, e si aggiornano dalla console premendo X una volta connessi alla rete. Questa impostazione riguarda solo l'interfaccia, non i giochi.

Wi-Fi

Configuration, poi Connectivity, poi Wi-Fi Network. Premi X per avviare la scansione, oppure inserisci manualmente il nome della rete se è nascosta. Inserisci nome utente e password, lascia la modalità DHCP a meno di esigenze particolari, conferma Connect, poi premi Y per salvare il profilo: la console si riconnetterà da sola in seguito.

Pulsanti

Lo schema dei comandi si regola dalle opzioni di contenuto (Content Option, poi Control Scheme), gioco per gioco o cartella per cartella. È lì che si corregge una disposizione A/B invertita.

Sospensione e autonomia

Configuration, poi Power Settings: comportamento del pulsante di accensione (Sleep Function), intervallo di sospensione (Idle Input Sleep Timeout), intervallo di spegnimento dello schermo (Idle Input Display Timeout), disattivazione del suono associata, indicatore di batteria scarica e governor della frequenza. Regolare questi due intervalli è il gesto che cambia di più l'autonomia reale.

SD1 e SD2: cosa va dove

muOS distingue lo storage principale, montato su /mnt/mmc e chiamato SD1, e lo storage secondario, montato su /mnt/sdcard e chiamato SD2. SD1 contiene il sistema; SD2 è facoltativa, ed è lei che rende il firmware comodo.

In Configuration, poi Storage, sposti su SD2 salvataggi e save state, screenshot, catalogo di copertine, collezioni, cronologia, temi, file BIOS, profili Wi-Fi, applicazioni installate e tracciamento del tempo di gioco. L'interesse: il giorno in cui riflash SD1, i tuoi dati personali sopravvivono.

Dove mettere i tuoi giochi

I tuoi file di gioco vanno nella cartella di contenuto situata alla radice della scheda. La documentazione ufficiale la scrive a volte ROMS, a volte roms: riprendi l'ortografia della cartella già presente dopo il primo avvio piuttosto che crearne una seconda. La stessa cartella può esistere su SD2, muOS le fonde nell'interfaccia.

La struttura completa è trattata firmware per firmware nel nostro articolo sul trasferimento di giochi e la struttura dei firmware. muOS non impone una denominazione rigida: comodo, ma l'organizzazione resta a tuo carico.

Associare i core e mostrare le copertine

Quando un file non ha un'associazione, muOS chiede cosa usare all'avvio. Si regola in Content Option, poi Core: scegli il sistema, poi il core predefinito o un core alternativo, un altro emulatore compatibile scelto per le prestazioni o il rendering. Un downloader di core aggiunge i sistemi assenti.

Le copertine vivono in un catalogo ordinato su SD1, in MUOS/info/catalogue/, con una sottocartella per sistema contenente box, preview, splash e text. Il nome dell'immagine deve riprendere esattamente quello del file di gioco, esclusa l'estensione: per Chrono Trigger (USA).zip, l'immagine si chiama Chrono Trigger (USA).png. Il sistema cerca solo alla radice di queste cartelle, mai nelle sottocartelle. I pacchetti forniti in .muxcat passano per il gestore di archivi.

La trappola più frequente

È l'immagine di un modello vicino. I nomi si somigliano molto — RG35XX H, RG35XX PLUS, RG35XX PRO, RG35XX SP, RG35XX 2024 — e una console che si rifiuta di avviarsi o rimane su uno schermo nero dopo un flash ha quasi sempre ricevuto l'immagine del modello accanto. Stessa osservazione per TrimUI, dove la Brick porta il codice TUIBRICK e la Smart Pro il codice TUISPOON.

Annota il nome esatto della tua macchina prima di aprire la pagina di download e confronta carattere per carattere. Seconda trappola, più discreta: lo strumento di scrittura, molti flash «falliti senza motivo» provenienti da Etcher. Prima di concludere per un guasto, rifai la scrittura con un altro strumento della lista ufficiale.

Passare da una versione alla successiva

Il progetto è chiaro: per cambiare versione, consiglia di salvare i dati e scrivere un'immagine nuova. È il metodo più affidabile, ed è veloce se i tuoi dati sono già su SD2.

Un archivio di aggiornamento è esistito per alcuni passaggi: la 2601.1 ne proponeva uno, riservato a chi veniva dalla 2601.0 «Jacaranda». La 2606.0 «Andromeda», invece, è proposta solo come immagine completa. Questi archivi portano l'estensione .muxupd, si copiano in una cartella ARCHIVE alla radice della scheda (/mnt/mmc/ARCHIVE per SD1, /mnt/sdcard/ARCHIVE per SD2) e si installano da Applications, poi Archive Manager.

Un dettaglio proprio della 2606.0: i temi sono ora memorizzati in cartelle aperte e non più in archivi compressi, e i vecchi file .muxthm devono essere estratti manualmente. Prima di qualsiasi aggiornamento, pensa a Device Backup, in Configuration, che archivia selettivamente salvataggi, collezioni, temi, configurazioni RetroArch, BIOS e profili di rete. Dalla 2606.0, questi backup sono file .muxbak ordinati nella cartella ARCHIVE; la cartella BACKUP non è più utilizzata.

Tornare indietro

Tutta la procedura si svolge sulla scheda microSD. Spegni la console, rimuovi la scheda muOS, rimetti quella originale: ritrovi il firmware del produttore così com'è. È questo che rende la prova reversibile, e la ragione d'essere della regola d'oro.

La scheda muOS può essere formattata e riflashata con un altro firmware senza conseguenze per la macchina. Se sei ancora indeciso tra più macchine compatibili, la nostra selezione di console retro sotto Linux specifica per ogni modello lo stato alla consegna.