Repository navigation
MUN OS 0.1.0-dev.5 — development image for QEMU
Pre-releaseMUN OS 0.1.0-dev.5 is a development preview for QEMU. It is not a supported
release, and there is no MUN hardware: what runs on a board runs on MUN
Dev, our development platform, from a profile you build yourself.
What is new
A new Home. The console's main screen is an orbit: the entry in focus
stands large at its centre (the card's object when a card is in), the
entries on the orbit's ring beside it (MUN Disk, Universe, Settings, Turn
off) and each entry's panel. MUN Disk is the name the console's medium is
taking, and Home's entry for the card in the slot; the format and the tools
still say Game Card.
Settings opens as an arc of its own. Left alone, a card's motion keeps moving, and so does Home's own background
on the GPU path; on the virtual console, drawn in software, Home's own
background stays still. After ten minutes the screen dims, and the first key
only wakes it.
Controllers. A controller drives the menus as the keyboard does: its
directional pad or left stick to move, its bottom button to accept and the
one to its right to go back (Nintendo's layout on Nintendo-style pads). One
pad has been tried, over Bluetooth on MUN Dev. Games still get the keyboard
and the pointer only, and the virtual console has not been given a
controller.
Sounds for what the console does: a game handed back, a card released,
a release refused, a controller coming or going, turning off (the console
goes down once its sound has played).
A start that shows MUN from the first moment. From the moment the
system can draw, the console shows its standby picture, the dark screen
with its light on, and the shell takes over from the same frame. The
start-up then begins with its sound, which the picture follows only while
the sound really plays: without a sound device, or with one that stalls or
plays at the wrong speed, the picture goes on by itself at its own pace.
MUN Shape's motion, an experimental draft. A package may now bring a
scene that moves behind the menus and answers them: planes at depths,
creatures following paths, particles and light, declared as data and played
by the console's own player; nothing on the card runs. Reef is its
example: a sea with schools of fish, a shark, crabs and kelp behind Home,
and a school that gathers when the focus is on Play. The studio that makes
Reef is in the repository.
- It is a draft: its names, defaults, limits and budgets may change in any
version, and a package says which revision of the draft it is written
for. - MUN Shape v1 is unchanged and stays the stable contract. A package with
motion keeps a v1 look, and earlier previews show that. - Reduce motion holds the scene still.
- MUN Shape motion.
A fourth Game Card in the download: MUN Collect dressed in Reef.
./mun play --card collect-reef shows the motion without the card tools.
The shell can draw through a GPU. In the virtual console it still draws
with the software renderer; where the system gives it a graphics API it
uses that, finds out by itself and says which in its journal.
MUN Dev's profile, in source. q6a-dev builds MUN OS for our
development board, a Radxa Dragon Q6A: 1080p at 60 Hz over HDMI through its
GPU, sound, Game Cards on microSD cards in its slot, a wired network and
SSH for whoever supports it. It is experimental, no image of it is
published (it installs the vendor's kernel and firmware, whose source this
release does not gather), and it is not the console, which is being
designed around a different board.
MUN Dev
says what has been checked there.
For contributors: image profiles with their own image format and pinned
packages; a card service that can take cards from a named reader; checks of
the start-up's clock and of the sound device's health that run on any
computer.
Fixed since v0.1.0-dev.4
Security. Two advisories are published with this release:
GHSA-c73f-9g2m-4phx
(converting a crafted card image could write files outside the card tool's
temporary directory) and GHSA-g577-jrf6-prpc (on
Windows, the virtual console's control channels accepted connections from
every local user).
A save that was confirmed and then could not be loaded. A save within
the documented 64 KiB made of many small values (measured: an array of
30,000 one-digit numbers) was answered "saved" but written larger than the
console reads back: at the next start the game got an incomplete save, and
each later save moved the previous one aside as
save.json.damaged-<time>. MUN Collect's own saves are far smaller. This
version writes saves compactly and reads such files again. In our
reproduction, save.json and each save.json.damaged-<time> held the whole
save that had been confirmed; a card that also lost data in another way
(pulled during a write, a failing medium) is not covered by this. To
recover, insert the card in this version and play; or, on a computer and
without changing the card, debugfs -R "dump /saves/<card.id>/save.json out.json" card.img, then check it with python3 -m json.tool out.json.
A card or a game could stop the console. These no longer do: a card
whose file system asks the kernel to stop on errors froze the console when
a damaged entry was read; very large compressed text in a MUN Shape PNG or
a cover made the interface restart; a game's save request, a save file or a
shape.json with text that cannot be encoded, or nested very deeply,
could restart the card service or the launcher (Play then said
"Unavailable"); after a launcher restart a game could not save for the rest
of its session; a game could write key events into an input device and
restart the console; files a game left in /dev/shm stayed until the
console restarted. With an earlier version, remove the card or restart the
console; a card marked as having errors is repaired or made again on a
computer (e2fsck). In our tests the saves already on those cards were
left as they were; that is what we observed, not a promise for every card.
Get it and play
git clone https://github.com/Play-MUN/mun-os.git && cd mun-os
./mun get https://github.com/Play-MUN/mun-os/releases/download/v0.1.0-dev.5/release.json
./mun play --card collect-reefThen getting started
(en español).
If you played an earlier preview, its console keeps that image: start this
one by name, in a console of its own, as
getting started, section 3
says. Your cards and their saves work in both; a card you already have is
never replaced.
Where it was checked
- On a Mac (Apple Silicon), headless, from this release's own files: the
console starts, plays MUN Collect, gives the card back and powers off; and
again with the card dressed in Reef, where the shell must say it plays
the motion. Its sound recorded whole: the start-up's, the menus' (move,
enter and back) and the shutdown's. - On the same Mac, in a window with keyboard and sound: an earlier
build of this preview, before the changes to the start: arrival of a
card, navigation, play and return, safe and abrupt removal, with the keys
sent by the laboratory's tool. Headless and without sound, with that same
build: dimming, Reduce motion and half an hour left running. Not
repeated on this release's build. - The Hosts workflow, on GitHub's virtual machines, with this
release's own files before it was published
(run):
macOS ARM64, Linux x86_64 and ARM64 (Ubuntu 24.04), Windows Server 2025
x86_64 and Windows 11 ARM64, headless. On each, the console starts,
plays MUN Collect, gives the card back and powers off, and again with
the card dressed in Reef, its motion drawn; on Windows also the control
channel's tests, three starts in a row, and another account refused
while the console's own user connects. - On MUN Dev (not this release's image: the profile, built from the
same source): a card's arrival, navigation, play and return with a save
written to the physical card, safe and abrupt removal, Reef left running for 33.6
minutes with nothing restarting (no frame times were recorded: it says
nothing about a frame rate), dimming and Reduce motion, with an earlier build
installed whole; the start (picture, sound from its first note) on three
kinds of power-on, with this source's shell and board files put over that
installation. The board image of this preview's last candidate (commit
4fcdda7: what changed after it is tests, the Hosts workflow and
documentation) installed whole, on 16 November 2026, and walked: start-up (picture and sound), Reef on Home, a card put in and
pulled while running, safe removal, playing MUN Collect and coming back,
a save written to the card, power-off from the menu.
Known limits
- MUN Shape's motion is a draft: a package written for it today may
need changes for a later version. - Controllers reach the menus, not games; the system has no pairing,
and none has been tried in the virtual console. - In the virtual console the scene behind the menus is drawn by the
software renderer: how smoothly it moves there says nothing about a
console. - MUN Dev is a development board with a microSD slot, not the console
or its reader; nothing measured there says how the console's board will
do. No image for it is published. On our board its wired network went
down several times while it ran (PCIe errors; back at the next start); the
cause remains undetermined, and the console itself went on. - No updates of cards or of the system.
- A sound device that stops answering can hold the
interface as it leaves (for a new resolution or a stop). Its wait is
bounded only while a sound is being written to the device; a device that
stops in another of its calls was reproduced with a stand-in for that call
and has not been seen on MUN Dev. - On Windows, the virtual console's tools need Windows 10 version 1803
or later: their control channels are now sockets in the user's own
folder, which no other account can reach. They address it by an ASCII
path: when the path ofLOCALAPPDATAis not plain ASCII (as under
C:\Users\Iván), by its short (8.3) name. A folder has one only if its
volume was creating short names when the folder was made (dir /xin its
parent folder shows it); without one, the tools refuse to start and say
so: setLOCALAPPDATAto a folder of yours whose path is ASCII. In the
Hosts workflow such a folder worked on Windows 11 ARM64, and was refused
on Windows Server 2025 x86_64, whose volume keeps no short names. - Several options say Not available yet: HDR, the refresh rate, the
sound output and format, setting the time, joining a
network and updates. - Images before v0.1.0-dev.3 do not show MUN Shape, and those before
this one play no motion: a card with a package plays there in MUN's look,
or in the package's v1 look.
Build 20261116T133852Z-fa5344bee486, commit
fa5344bee486615b9c0cf909446b796c7382a4e0; every file's digest is in
release.json, the sources' in their .sha256.
En español
MUN OS 0.1.0-dev.5 es una versión preliminar de desarrollo para QEMU. No es
una versión con soporte y no existe hardware de MUN: lo que funciona en una
placa funciona en MUN Dev, nuestra plataforma de desarrollo, con un perfil
que construyes tú.
Una pantalla principal nueva. Es una órbita: la entrada en foco está en
grande en su centro (el objeto de la tarjeta cuando hay una dentro), las
entradas en el anillo de la órbita a su lado (MUN Disk, Universo,
Configuración, Apagar) y el panel de cada entrada. MUN Disk es el nombre
que está tomando el soporte de la consola, y la entrada de la tarjeta que
hay en la ranura; el formato y las herramientas siguen diciendo Game Card. Configuración se abre como un arco propio. Si no se
toca, el movimiento de una tarjeta sigue, y también el fondo propio de Home
en el camino con GPU; en la consola virtual, dibujada por software, el fondo
propio de Home se queda quieto. A los diez minutos la pantalla se atenúa,
y la primera tecla solo la despierta.
Mandos. Un mando maneja los menús como el teclado: su cruceta o su
palanca izquierda para moverse, su botón inferior para aceptar y el de su
derecha para volver (la disposición de Nintendo en los mandos de ese
estilo). Se ha probado un mando, por Bluetooth en MUN Dev. Los juegos siguen
recibiendo solo el teclado y el puntero, y a la consola virtual no se le ha
dado ningún mando.
Sonidos para lo que hace la consola: un juego que devuelve la consola,
una tarjeta liberada, una liberación rechazada, un mando que llega o se va,
y apagar (la consola se apaga cuando su sonido ha terminado).
Un arranque que muestra MUN desde el primer momento. Desde que el
sistema puede dibujar, la consola muestra su imagen de espera, la pantalla
oscura con su luz encendida, y el shell continúa desde ese mismo fotograma.
Después empieza el arranque con su sonido, al que la imagen sigue solo
mientras el sonido suena de verdad: sin dispositivo de sonido, o con uno
que se atasca o suena a otra velocidad, la imagen sigue sola a su ritmo.
El movimiento de MUN Shape, un borrador experimental. Un paquete puede
traer ahora una escena que se mueve detrás de los menús y les responde:
planos a distintas profundidades, criaturas que siguen recorridos,
partículas y luz, declarados como datos y reproducidos por el reproductor
de la propia consola; nada de la tarjeta se ejecuta. Reef es su
ejemplo: un mar con bancos de peces, un tiburón, cangrejos y algas detrás
de la pantalla principal, y un banco que se reúne cuando el foco está en
Jugar. El estudio que hace Reef está en el repositorio.
- Es un borrador: sus nombres, valores, límites y presupuestos pueden
cambiar en cualquier versión, y un paquete dice para qué revisión del
borrador está escrito. - MUN Shape v1 no cambia y sigue siendo el contrato estable. Un paquete con
movimiento conserva un aspecto v1, que es lo que muestran las versiones
anteriores. - Reducir movimiento deja la escena quieta.
Una cuarta Game Card en la descarga: MUN Collect vestido con Reef.
./mun play --card collect-reef muestra el movimiento sin las herramientas
de tarjetas.
El shell puede dibujar con una GPU. En la consola virtual sigue
dibujando por software; donde el sistema le da una API gráfica, la usa, lo
averigua solo y lo dice en su registro.
El perfil de MUN Dev, en código fuente. q6a-dev construye MUN OS para
nuestra placa de desarrollo, una Radxa Dragon Q6A: 1080p a 60 Hz por HDMI
con su GPU, sonido, Game Cards en tarjetas microSD en su ranura, red por
cable y SSH para quien le dé soporte. Es experimental, no se publica
ninguna imagen suya (instala el kernel y el firmware del fabricante, cuyo
código fuente esta versión no reúne) y no es la consola, que se diseña
alrededor de otra placa.
MUN Dev
dice qué se ha comprobado allí.
Cómo obtenerla y jugar: las mismas órdenes de arriba y
primeros pasos.
Si jugaste una versión preliminar anterior, su consola conserva aquella
imagen: arranca esta por su nombre, en una consola propia, como dice
la sección 3.
Corregido desde v0.1.0-dev.4:
- Seguridad: con esta versión se publican dos avisos:
GHSA-c73f-9g2m-4phx
(convertir una imagen de tarjeta manipulada podía escribir archivos fuera
de la carpeta temporal de la herramienta) y
GHSA-g577-jrf6-prpc (en Windows, los canales de control de la
consola virtual aceptaban conexiones de cualquier usuario del ordenador). - Un guardado confirmado que después no se podía cargar: un guardado
dentro de los 64 KiB documentados y con muchos valores pequeños se
confirmaba, pero se escribía más grande de lo que la consola lee después;
en el siguiente arranque el juego recibía un guardado incompleto. Esta
versión guarda de forma compacta y vuelve a leer esos archivos. En nuestra
reproducción,save.jsony cadasave.json.damaged-<hora>contenían
entero el guardado confirmado; una tarjeta que además perdió datos por
otra causa no está cubierta por esto. Para recuperarlo, inserta la tarjeta
en esta versión y juega; o, en un ordenador y sin modificar la tarjeta,
debugfs -R "dump …"como dice la versión en inglés. - Una tarjeta o un juego podían detener la consola: congelarla con un
sistema de archivos dañado, reiniciar la interfaz con ciertas imágenes PNG,
dejar «Jugar» como no disponible, impedir guardar tras reiniciarse el
lanzador, reiniciar la consola desde un juego o dejar memoria ocupada. Con
una versión anterior, retira la tarjeta o reinicia la consola; una tarjeta
marcada con errores se repara en un ordenador cone2fsck. En nuestras
pruebas, los guardados que ya estaban en esas tarjetas quedaron como
estaban; es lo observado, no una garantía para cualquier tarjeta.
Dónde se ha comprobado:
- En un Mac con Apple Silicon, sin pantalla, con los archivos de esta
versión: la consola arranca, juega MUN Collect, devuelve la tarjeta y se
apaga; y otra vez con la tarjeta vestida con Reef, donde el shell tiene
que decir que reproduce el movimiento. Su sonido, grabado entero: el del
arranque, los de los menús (mover, entrar y volver) y el del apagado. - En el mismo Mac, en una ventana con teclado y sonido: una
construcción anterior de esta versión preliminar, de antes de los cambios
del arranque. - El flujo Hosts, en las máquinas virtuales de GitHub, con los
archivos de esta versión antes de publicarla
(ejecución):
macOS ARM64, Linux x86_64 y ARM64 (Ubuntu 24.04), Windows Server 2025
x86_64 y Windows 11 ARM64, sin pantalla. En cada uno la consola arranca,
juega MUN Collect, devuelve la tarjeta y se apaga, y otra vez con la
tarjeta vestida con Reef, con su movimiento; en Windows, además, las
pruebas del canal de control, tres arranques seguidos y otra cuenta
rechazada mientras el usuario de la consola se conecta. - En MUN Dev (no la imagen de esta versión: el perfil, construido del
mismo código): lo que detalla la página de MUN Dev.
Límites conocidos:
- El movimiento de MUN Shape es un borrador: un paquete escrito hoy
puede necesitar cambios en una versión posterior. - Los mandos llegan a los menús, no a los juegos; el sistema no
empareja mandos y en la consola virtual no se ha probado ninguno. - En la consola virtual la escena de detrás de los menús se dibuja por
software: lo fluida que vaya allí no dice nada de una consola. - MUN Dev es una placa de desarrollo con una ranura microSD, no la
consola ni su lector. No se publica ninguna imagen para ella. En nuestra
placa, su red por cable se cayó varias veces con la placa en marcha
(errores PCIe; vuelve en el siguiente arranque); la causa sigue sin
determinarse, y la consola siguió funcionando. - Sin actualizaciones de tarjetas ni del sistema.
- Un dispositivo de sonido que deja de responder puede
retener la interfaz al salir (para una resolución nueva o al parar). La
espera solo está acotada mientras se escribe un sonido en el dispositivo;
un dispositivo que se detiene en otra de sus llamadas se reprodujo con un
sustituto de esa llamada y no se ha visto en MUN Dev. - En Windows, las herramientas de la consola virtual necesitan Windows 10
versión 1803 o posterior: sus canales de control son ahora sockets en la
carpeta del propio usuario, a la que no llega ninguna otra cuenta. La
nombran con una ruta ASCII: si la ruta deLOCALAPPDATAno es ASCII (como
bajoC:\Users\Iván), con su nombre corto (8.3). Una carpeta solo lo tiene
si su volumen creaba nombres cortos cuando se hizo (dir /xen la carpeta
que la contiene lo muestra); sin él, las herramientas se niegan a arrancar
y lo dicen: ponLOCALAPPDATAen una carpeta tuya cuya ruta sea ASCII. En
el flujo Hosts, una carpeta así funcionó en Windows 11 ARM64 y se rechazó
en Windows Server 2025 x86_64, cuyo volumen no guarda nombres cortos. - Varias opciones dicen No disponible todavía.
En inglés quedan los contratos, los README de los componentes, los mensajes
y la ayuda de ./mun, y estas notas en su versión completa.