Skip to content

oakMOSS v0.2.0-beta.1

Choose a tag to compare

@CatalyticArkun CatalyticArkun released this 19 Sep 05:50
· 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:

  1. 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.
  2. 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.
  3. The system card goes in the slot your stock system card came from, and the spruceOS card in the other slot.
  4. 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