Instalar apps en muOS: archivos .muxapp y .muxzip con Archive Manager

Las apps para muOS vienen en un solo archivo terminado en .muxapp. No hay que descomprimirlo ni copiar carpetas: muOS trae un instalador llamado Archive Manager que lo hace por ti. Esta guía muestra todo el proceso, qué ocurre por dentro y las dos cosas que más confunden: las actualizaciones que reinician tus ajustes y cómo desinstalar.

Probado en: Anbernic RG40XXH · muOS 2601.0 Jacaranda. Otras consolas con muOS funcionan igual.

Qué es un archivo .muxapp

Un archivo .muxapp es un ZIP normal con otra terminación. Dentro hay una carpeta con el nombre de la app, por ejemplo:

WiFiTransfer.muxapp
└── WiFiTransfer/
    ├── mux_launch.sh    ← muOS inicia la app con esto
    ├── config.ini
    └── …

Instalarlo significa descomprimir esa carpeta en MUOS/application/ de tu tarjeta SD. Todas las apps de esa carpeta aparecen en el menú Applications.

Paso 1: copia el archivo en la carpeta ARCHIVE

Archive Manager muestra los archivos de la carpeta ARCHIVE en la raíz de la tarjeta SD 1 (la tarjeta desde la que funciona muOS). Si la carpeta no existe, créala en mayúsculas.

Hay tres formas fáciles de llevar el archivo allí:

Lector de tarjetas: apaga la consola, pon la tarjeta SD 1 en tu ordenador y copia el archivo .muxapp en ARCHIVE. Expúlsala correctamente antes de sacarla.
Por Wi-Fi con Wi-Fi Transfer: abre la app en la consola, abre la dirección que muestra en el navegador del móvil o del PC y en la pestaña Tarjeta SD 1 toca Añadir juegos y elige el .muxapp. Va a ARCHIVE automáticamente.
SFTP: muOS puede ejecutar un servidor SFTP: activa SFTP + Filebrowser en Configuration → Connectivity → Web Services. Luego cualquier app SFTP (FileZilla, Cyberduck, WinSCP) puede copiar el archivo en ARCHIVE de la tarjeta SD 1.

No cambies el nombre del archivo: Archive Manager decide qué hacer según la terminación (.muxapp).

Paso 2: instálalo con Archive Manager

En la consola, abre Applications → Archive Manager.
Selecciona el archivo .muxapp y pulsa A.
muOS cierra sus menús y muestra una pantalla de texto mientras trabaja: Inspecting Archive…, los archivos que se extraen, Sync Filesystem y por último All Done!
Unos segundos después vuelves a Archive Manager. El archivo aparece marcado como INSTALLED.

Abre Applications: la nueva app está en la lista. Algunas apps también necesitan el Wi-Fi activado (Configuration → Connectivity → Wi-Fi Network) antes de abrirlas.

El archivo .muxapp se queda en ARCHIVE tras la instalación. Puedes guardarlo como copia o borrarlo; la app instalada no lo necesita.

Qué hace realmente Archive Manager

Antes de extraer nada, Archive Manager revisa el archivo y lo rechaza si alguna ruta de dentro apunta fuera de su carpeta de destino (una ruta absoluta o ..). Así, un paquete roto o malicioso no puede sobrescribir por esa vía los archivos del sistema de muOS.

Esa comprobación trata de dónde van los archivos, no de lo que hace la app cuando se ejecuta. En muOS las apps tienen acceso completo al sistema, así que instala solo archivos .muxapp de fuentes de confianza: la web del propio desarrollador o su página de versiones en GitHub.

Archive Manager no es solo para apps. Elige el método de instalación según la terminación del archivo:

Terminación	Qué es	Adónde va
`.muxapp`	Aplicación	`MUOS/application/`
`.muxthm`	Tema	`MUOS/theme/<nombre>/`
`.muxalt`	Aspecto alternativo del tema actual	la carpeta del tema activo
`.muxzip`	Paquete de contenido (por ejemplo partidas, BIOS o colecciones, según lo que contenga)	las carpetas de muOS correspondientes
`.muxcat`	Paquete de catálogo (carátulas y descripciones)	`MUOS/package/catalogue/`
`.muxcfg`	Paquete de configuración de RetroArch	`MUOS/package/config/`
`.muxupd`	Actualización del sistema muOS	el propio sistema

Actualizar una app: guarda antes tus ajustes

Para actualizar, copia el .muxapp más nuevo en ARCHIVE e instálalo igual. Archive Manager lo descomprime encima de la carpeta de la app que ya existe:

los archivos que vienen en el paquete nuevo reemplazan a los antiguos, incluido config.ini;
los archivos que no están en el paquete, como las carpetas data/ o logs/ de la app, se conservan.

Así que todo lo que cambiaste en el config.ini de la app vuelve a los valores por defecto tras actualizar. Antes de actualizar, copia el config.ini de la app a un lugar seguro (o apunta tus ajustes) y vuelve a ponerlos después. Game Manager es una excepción: su paquete no trae config.ini, así que tus ajustes, incluida tu clave API de itch.io, se conservan al actualizar. Tu lista de juegos instalados está en data/ y sobrevive a la actualización.

Si el archivo nuevo se llama igual que el antiguo, borra o reemplaza primero el antiguo en ARCHIVE, para saber seguro cuál estás instalando.

Desinstalar una app

muOS 2601 no tiene botón para desinstalar apps. Para quitar una, borra su carpeta:

Tarjeta SD 1 → MUOS/application/<NombreApp>

Hazlo con un lector de tarjetas, por SFTP o con Wi-Fi Transfer. Después vuelve al menú principal y abre otra vez Applications; la app ya no está. Borrar la carpeta también borra los ajustes y datos propios de la app, así que copia antes lo que quieras conservar.

Solución de problemas

Archive Manager dice “No Archives Found”: el archivo no está en ARCHIVE en la raíz de la tarjeta SD 1, o la carpeta tiene otro nombre. Tiene que ser ARCHIVE, no dentro de ROMS ni de MUOS.
El archivo aparece pero la instalación falla con “unsafe paths”: el paquete está mal hecho. Contacta con el desarrollador de la app; no intentes descomprimirlo a mano.
“Could not open archive… Corrupt?”: la descarga no terminó o la copia se cortó. Descárgalo otra vez y, si el desarrollador da una suma SHA-256, compárala (shasum -a 256 file.muxapp en Mac o Linux).
La app se instaló pero no aparece: vuelve al menú principal y abre otra vez Applications. Si sigue sin estar, comprueba que existe MUOS/application/<NombreApp>/mux_launch.sh.
La app se abre y se cierra enseguida: muchas apps escriben un registro en su propia carpeta, normalmente logs/app.log. Revísalo, y activa el Wi-Fi si la app necesita internet.

Resumen

Pon el archivo .muxapp en ARCHIVE de la tarjeta SD 1.
Applications → Archive Manager, selecciónalo, pulsa A y espera a All Done!
Abre la app desde Applications.
Antes de actualizar, guarda el config.ini de la app. Para desinstalar, borra su carpeta en MUOS/application/.

¿Preguntas? Escribe a feedback@pocketkode.com.

PocketKode no está afiliado a muOS ni a Anbernic.