Repository navigation
oakMOSS v0.2.0-beta.1
·
34 commits
to main
since this release
oakMOSS v0.2.0-beta.1
System card (SD1) images for three MagicX handhelds. This beta adds the XU20 V32 and touch on the XU20 and Zero 40.
Downloads
| Device | Image |
|---|---|
| MagicX Mini Zero 28 | oakmoss-zero28-v0.2.0-beta.1-sd1.img.xz |
| MagicX Zero 40 | oakmoss-zero40-v0.2.0-beta.1-sd1.img.xz |
| XU RETRO / MagicX XU20 V32 | oakmoss-xu20-v0.2.0-beta.1-sd1.img.xz |
Before you start
- Back up your stock system card. A full image of it is the only way back to stock.
- You need a spruceOS nightly from after 2026-09-19 (newer than
v4.4.2-20260919) on a second card, formatted FAT32 (exFAT won't mount). Older spruceOS builds boot, but touch, sleep and brightness won't work right.
Install
The spruce installer has beta support for oakMOSS.
To install manually:
- Write the image to the system card with Raspberry Pi Imager or a similar tool (in Imager: "Use custom", then pick the
.img.xz). Leave verification on. - Once the card is ejected, put it straight into the device. On Windows, don't plug it back into the PC first: Windows can rewrite the card's partition table so it no longer boots. If that happens, write it again.
- The system card goes in the slot your stock system card came from, and the spruceOS card in the other slot.
- Power on.
What's new
- XU20 V32 support.
- Touch on the XU20 and Zero 40.
- Fixed: the XU20 and Zero 40 sometimes stuck at the boot logo.
- Fixed: rebooting from spruce powered the device off.
- The Zero 40 keeps the same WiFi address, and so the same IP, across reboots.
- New oakMOSS boot logo. On the XU20 and Zero 40, bootloader warnings and the low-battery screen now show instead of looking like a freeze.
Known limitations
- Sleep turns the screen off and pauses the game. Full suspend isn't supported on these devices.
- Beta: tested on one unit of each device.
Checksums
sha256sum -c SHA256SUMS checks the downloads. Each *-BUILD-INFO.txt lists exactly what went into its image.
SHA-256 of the decompressed images
50dd611b796c35fcf64e6943c7c0143ad302869f546d5792214a7883090cbfed oakmoss-zero28-v0.2.0-beta.1-sd1.img
2c8de76a6c05e171844959152738cf3a0ff70c1f1ff481217251e6770db7b299 oakmoss-zero40-v0.2.0-beta.1-sd1.img
59534cabe61a0f12e4984a5fb94d067a954639f6d4d9b33baff5d9917291ee4b oakmoss-xu20-v0.2.0-beta.1-sd1.img