Apps auf muOS installieren: .muxapp- und .muxzip-Dateien mit dem Archive Manager

Apps für muOS kommen als eine einzige Datei mit der Endung .muxapp. Du musst sie weder entpacken noch Ordner kopieren: muOS hat einen eingebauten Installer namens Archive Manager, der das für dich erledigt. Diese Anleitung zeigt den ganzen Ablauf, was im Hintergrund passiert, und die zwei Stolperfallen: Updates, die deine Einstellungen zurücksetzen, und das Deinstallieren.

Getestet auf: Anbernic RG40XXH · muOS 2601.0 Jacaranda. Andere muOS-Handhelds funktionieren genauso.

Was eine .muxapp-Datei ist

Eine .muxapp-Datei ist ein ganz normales ZIP-Archiv mit anderer Endung. Darin liegt ein Ordner mit dem Namen der App, zum Beispiel:

WiFiTransfer.muxapp
└── WiFiTransfer/
    ├── mux_launch.sh    ← damit startet muOS die App
    ├── config.ini
    └── …

Installieren heißt, diesen Ordner nach MUOS/application/ auf deiner SD-Karte zu entpacken. Jede App in diesem Ordner erscheint im Menü Applications.

Schritt 1: Die Datei in den Ordner ARCHIVE kopieren

Der Archive Manager listet die Dateien im Ordner ARCHIVE ganz oben auf SD-Karte 1 (der Karte, von der muOS läuft). Gibt es den Ordner nicht, leg ihn an, in Großbuchstaben.

Es gibt drei einfache Wege, die Datei dorthin zu bringen:

Kartenleser: Schalte den Handheld aus, steck SD-Karte 1 in deinen Computer und kopiere die .muxapp-Datei nach ARCHIVE. Wirf die Karte ordentlich aus, bevor du sie herausnimmst.
Per WLAN mit Wi-Fi Transfer: Öffne die App auf dem Handheld, öffne die angezeigte Adresse im Browser deines Handys oder PCs und tippe im Tab SD-Karte 1 auf Spiele hinzufügen und wähle die .muxapp. Sie landet automatisch in ARCHIVE.
SFTP: muOS kann einen SFTP-Server betreiben: Schalte SFTP + Filebrowser unter Configuration → Connectivity → Web Services ein. Dann kann jede SFTP-App (FileZilla, Cyberduck, WinSCP) die Datei nach ARCHIVE auf SD-Karte 1 kopieren.

Lass den Dateinamen, wie er ist: Der Archive Manager entscheidet anhand der Endung (.muxapp), was er tut.

Schritt 2: Mit dem Archive Manager installieren

Öffne auf dem Handheld Applications → Archive Manager.
Wähle die .muxapp-Datei und drück A.
muOS schließt seine Menüs und zeigt während der Arbeit einen Textbildschirm: Inspecting Archive…, die entpackten Dateien, Sync Filesystem und zum Schluss All Done!
Nach ein paar Sekunden bist du zurück im Archive Manager. Die Datei ist jetzt mit INSTALLED markiert.

Öffne Applications: Die neue App steht in der Liste. Manche Apps brauchen vor dem Start auch eingeschaltetes WLAN (Configuration → Connectivity → Wi-Fi Network).

Die .muxapp-Datei bleibt nach der Installation in ARCHIVE. Du kannst sie als Sicherung behalten oder löschen; die installierte App braucht sie nicht.

Was der Archive Manager wirklich macht

Bevor er etwas entpackt, prüft der Archive Manager das Archiv und lehnt es ab, wenn irgendein Pfad darin aus seinem Zielordner hinauszeigt (ein absoluter Pfad oder ..). So kann ein kaputtes oder bösartiges Paket auf diesem Weg keine Systemdateien von muOS überschreiben.

Diese Prüfung betrifft nur, wohin Dateien geschrieben werden, nicht, was die App nach dem Start tut. Apps laufen unter muOS mit vollem Zugriff auf das System, installiere .muxapp-Dateien also nur aus vertrauenswürdigen Quellen: von der Website des Entwicklers oder seiner Release-Seite auf GitHub.

Der Archive Manager ist nicht nur für Apps da. Er wählt die Installationsart anhand der Dateiendung:

Endung	Was es ist	Wohin es kommt
`.muxapp`	Anwendung	`MUOS/application/`
`.muxthm`	Theme	`MUOS/theme/<Name>/`
`.muxalt`	Alternatives Aussehen für das aktuelle Theme	der Ordner des aktiven Themes
`.muxzip`	Inhaltspaket (zum Beispiel Spielstände, BIOS oder Sammlungen, je nach Inhalt)	die passenden muOS-Ordner
`.muxcat`	Katalogpaket (Cover und Beschreibungen)	`MUOS/package/catalogue/`
`.muxcfg`	RetroArch-Konfigurationspaket	`MUOS/package/config/`
`.muxupd`	muOS-Systemupdate	das System selbst

Eine App aktualisieren: vorher die Einstellungen sichern

Zum Aktualisieren kopierst du die neuere .muxapp nach ARCHIVE und installierst sie genauso. Der Archive Manager entpackt sie über den vorhandenen App-Ordner:

Dateien, die im neuen Paket sind, ersetzen die alten, auch die config.ini;
Dateien, die nicht im Paket sind, etwa die Ordner data/ oder logs/ der App, bleiben erhalten.

Alles, was du in der config.ini der App geändert hast, steht nach einem Update also wieder auf dem Standard. Kopiere vor dem Update die config.ini der App an einen sicheren Ort (oder notiere deine Einstellungen) und trag deine Änderungen danach wieder ein. Game Manager ist eine Ausnahme: Sein Paket enthält keine config.ini, deine Einstellungen samt itch.io-API-Schlüssel bleiben beim Update also erhalten. Deine Liste installierter Spiele liegt in data/ und übersteht das Update.

Hat die neue Datei denselben Namen wie die alte, lösch oder ersetze zuerst die alte in ARCHIVE, damit du sicher weißt, welche du installierst.

Eine App deinstallieren

muOS 2601 hat keine Deinstallieren-Schaltfläche für Apps. Um eine zu entfernen, lösch ihren Ordner:

SD-Karte 1 → MUOS/application/<AppName>

Das geht mit einem Kartenleser, per SFTP oder mit Wi-Fi Transfer. Geh danach zurück ins Hauptmenü und öffne Applications erneut; die App ist weg. Mit dem Ordner werden auch die eigenen Einstellungen und Daten der App gelöscht, kopiere also vorher, was du behalten willst.

Fehlerbehebung

Der Archive Manager meldet “No Archives Found”: Die Datei liegt nicht in ARCHIVE ganz oben auf SD-Karte 1, oder der Ordner heißt falsch. Er muss ARCHIVE heißen und darf nicht in ROMS oder MUOS liegen.
Die Datei steht in der Liste, aber die Installation scheitert mit “unsafe paths”: Das Paket ist falsch gebaut. Wende dich an den Entwickler der App; versuch nicht, es von Hand zu entpacken.
“Could not open archive… Corrupt?”: Der Download ist nicht fertig geworden oder die Kopie wurde abgebrochen. Lade die Datei neu herunter und vergleiche, wenn der Entwickler eine SHA-256-Prüfsumme angibt, diese (shasum -a 256 file.muxapp auf Mac oder Linux).
Die App ist installiert, erscheint aber nicht: Geh zurück ins Hauptmenü und öffne Applications erneut. Fehlt sie immer noch, prüfe, ob MUOS/application/<AppName>/mux_launch.sh existiert.
Die App startet und schließt sich sofort: Viele Apps schreiben ein Protokoll in ihren eigenen Ordner, meist logs/app.log. Schau hinein, und schalte das WLAN ein, wenn die App Internet braucht.

Zusammenfassung

Leg die .muxapp-Datei in ARCHIVE auf SD-Karte 1.
Applications → Archive Manager, Datei wählen, A drücken, auf All Done! warten.
Die App über Applications öffnen.
Vor einem Update die config.ini der App sichern. Zum Deinstallieren ihren Ordner in MUOS/application/ löschen.

Fragen? Schreib an feedback@pocketkode.com.

PocketKode steht in keiner Verbindung zu muOS oder Anbernic.