Installer des applis sur muOS : fichiers .muxapp et .muxzip avec Archive Manager

Les applis pour muOS se présentent sous la forme d’un seul fichier se terminant par .muxapp. Pas besoin de le décompresser ni de copier des dossiers : muOS intègre un installateur appelé Archive Manager qui s’en charge. Ce guide montre toute la procédure, ce qui se passe en coulisses, et les deux pièges les plus courants : les mises à jour qui réinitialisent vos réglages, et la désinstallation.

Testé sur : Anbernic RG40XXH · muOS 2601.0 Jacaranda. Les autres consoles sous muOS fonctionnent de la même façon.

Qu’est-ce qu’un fichier .muxapp

Un fichier .muxapp est une archive ZIP ordinaire avec une autre extension. Elle contient un dossier au nom de l’appli, par exemple :

WiFiTransfer.muxapp
└── WiFiTransfer/
    ├── mux_launch.sh    ← muOS lance l’appli avec ce fichier
    ├── config.ini
    └── …

L’installer, c’est décompresser ce dossier dans MUOS/application/ sur votre carte SD. Chaque appli de ce dossier apparaît dans le menu Applications.

Étape 1 : copier le fichier dans le dossier ARCHIVE

Archive Manager liste les fichiers du dossier ARCHIVE à la racine de la carte SD 1 (celle depuis laquelle muOS fonctionne). S’il n’existe pas, créez-le, en majuscules.

Il y a trois façons simples d’y déposer le fichier :

Lecteur de cartes : éteignez la console, insérez la carte SD 1 dans votre ordinateur et copiez le fichier .muxapp dans ARCHIVE. Éjectez proprement la carte avant de la retirer.
Par Wi-Fi avec Wi-Fi Transfer : ouvrez l’appli sur la console, ouvrez l’adresse affichée dans le navigateur de votre téléphone ou PC, puis, dans l’onglet Carte SD 1, touchez Ajouter des jeux et choisissez le .muxapp. Il va automatiquement dans ARCHIVE.
SFTP : muOS peut faire tourner un serveur SFTP : activez SFTP + Filebrowser dans Configuration → Connectivity → Web Services. N’importe quelle appli SFTP (FileZilla, Cyberduck, WinSCP) peut ensuite copier le fichier dans ARCHIVE sur la carte SD 1.

Gardez le nom du fichier tel quel : Archive Manager décide quoi faire d’après l’extension (.muxapp).

Étape 2 : l’installer avec Archive Manager

Sur la console, ouvrez Applications → Archive Manager.
Sélectionnez le fichier .muxapp et appuyez sur A.
muOS ferme ses menus et affiche un écran de texte pendant le travail : Inspecting Archive…, les fichiers extraits, Sync Filesystem et enfin All Done!
Quelques secondes plus tard, vous revenez dans Archive Manager. Le fichier est maintenant marqué INSTALLED.

Ouvrez Applications : la nouvelle appli est dans la liste. Certaines applis ont aussi besoin du Wi-Fi activé (Configuration → Connectivity → Wi-Fi Network) avant d’être lancées.

Le fichier .muxapp reste dans ARCHIVE après l’installation. Vous pouvez le garder comme sauvegarde ou le supprimer ; l’appli installée n’en a pas besoin.

Ce que fait vraiment Archive Manager

Avant d’extraire quoi que ce soit, Archive Manager vérifie l’archive et la refuse si un chemin à l’intérieur pointe hors de son dossier cible (un chemin absolu ou ..). Un paquet cassé ou malveillant ne peut donc pas écraser de cette façon les fichiers système de muOS.

Cette vérification porte sur l’emplacement des fichiers, pas sur ce que fait l’appli une fois lancée. Sur muOS, les applis s’exécutent avec un accès complet au système : n’installez donc des fichiers .muxapp que depuis des sources de confiance, comme le site du développeur ou sa page de versions sur GitHub.

Archive Manager ne sert pas qu’aux applis. Il choisit la méthode d’installation d’après l’extension du fichier :

Extension	Contenu	Destination
`.muxapp`	Application	`MUOS/application/`
`.muxthm`	Thème	`MUOS/theme/<nom>/`
`.muxalt`	Variante d’apparence du thème actuel	le dossier du thème actif
`.muxzip`	Paquet de contenu (par exemple sauvegardes, BIOS ou collections, selon ce qu’il contient)	les dossiers muOS correspondants
`.muxcat`	Paquet de catalogue (jaquettes et descriptions)	`MUOS/package/catalogue/`
`.muxcfg`	Paquet de configuration RetroArch	`MUOS/package/config/`
`.muxupd`	Mise à jour du système muOS	le système lui-même

Mettre à jour une appli : sauvegardez d’abord vos réglages

Pour mettre à jour, copiez le .muxapp plus récent dans ARCHIVE et installez-le de la même façon. Archive Manager le décompresse par-dessus le dossier de l’appli existante :

les fichiers présents dans le nouveau paquet remplacent les anciens, y compris config.ini ;
les fichiers absents du paquet, comme les dossiers data/ ou logs/ de l’appli, sont conservés.

Tout ce que vous avez modifié dans le config.ini de l’appli revient donc aux valeurs par défaut après une mise à jour. Avant de mettre à jour, copiez le config.ini de l’appli en lieu sûr (ou notez vos réglages), puis remettez vos modifications ensuite. Game Manager fait exception : son paquet ne contient pas de config.ini, donc vos réglages, y compris votre clé API itch.io, sont conservés lors d’une mise à jour. Votre liste de jeux installés est dans data/ et survit à la mise à jour.

Si le nouveau fichier porte le même nom que l’ancien, supprimez ou remplacez d’abord l’ancien dans ARCHIVE, pour être sûr de celui que vous installez.

Désinstaller une appli

muOS 2601 n’a pas de bouton pour désinstaller une appli. Pour en retirer une, supprimez son dossier :

Carte SD 1 → MUOS/application/<NomAppli>

Faites-le avec un lecteur de cartes, par SFTP ou avec Wi-Fi Transfer. Revenez ensuite au menu principal et rouvrez Applications : l’appli a disparu. Supprimer le dossier supprime aussi les réglages et données propres à l’appli : copiez d’abord ce que vous voulez garder.

Dépannage

Archive Manager affiche “No Archives Found” : le fichier n’est pas dans ARCHIVE à la racine de la carte SD 1, ou le dossier est mal nommé. Il doit s’appeler ARCHIVE, pas se trouver dans ROMS ni dans MUOS.
Le fichier est listé mais l’installation échoue avec “unsafe paths” : le paquet est mal construit. Contactez le développeur de l’appli ; n’essayez pas de le décompresser à la main.
“Could not open archive… Corrupt?” : le téléchargement n’est pas allé au bout ou la copie a été interrompue. Téléchargez-le à nouveau et, si le développeur fournit une somme SHA-256, comparez-la (shasum -a 256 file.muxapp sur Mac ou Linux).
L’appli est installée mais n’apparaît pas : revenez au menu principal et rouvrez Applications. Si elle manque toujours, vérifiez que MUOS/application/<NomAppli>/mux_launch.sh existe.
L’appli s’ouvre et se ferme aussitôt : beaucoup d’applis écrivent un journal dans leur propre dossier, généralement logs/app.log. Consultez-le, et activez le Wi-Fi si l’appli a besoin d’Internet.

En résumé

Placez le fichier .muxapp dans ARCHIVE sur la carte SD 1.
Applications → Archive Manager, sélectionnez-le, appuyez sur A, attendez All Done!
Ouvrez l’appli depuis Applications.
Avant une mise à jour, sauvegardez le config.ini de l’appli. Pour désinstaller, supprimez son dossier dans MUOS/application/.

Des questions ? Écrivez à feedback@pocketkode.com.

PocketKode n’est affilié ni à muOS ni à Anbernic.