Repository navigation
Installation muOS Andromeda
The current packaging target is MustardOS (muOS) 2606.0 Andromeda on compatible H700 handhelds. Hardware-specific behaviour still needs testing on each model. Do not assume older muOS releases or other distributions are compatible.
- Download the .muxapp asset from the relevant GitHub Release. Do not install the source-code ZIP.
- Copy the .muxapp file to the ARCHIVE/ folder on SD1.
- On the handheld, open Applications → Archive Manager.
- Select the QWASAR Desk package and install it.
- Launch QWASAR Desk from the Applications menu.
The .muxapp archive has one top-level application directory: Void-Desk/. It contains the launcher and app files. There must not be an extra application/ directory nested inside the package.
- Keep the device connected to reliable Wi-Fi during optional desktop-image setup.
- Back up important saves and configuration before installing test builds or changing firmware.
- Keep the device powered while the desktop image or packages are being installed.
- Check that sufficient free storage is available before starting optional XFCE setup.
Use the Pygame frontend. The LÖVE frontend is an experimental prototype and is not yet a complete alternative.
The product identity is now QWASAR Desk, formerly Void Desk. The current installable package still uses the legacy Void-Desk/ root and existing launcher/configuration paths. Do not rename or move these paths manually; a future migration will be handled by a versioned installer.
QWASAR continues to launch through the official muOS application runner. Keep the native muOS frontend and recovery path available.