MIXTAPE

A community port deck for OnionOS on the Miyoo Mini Plus. Browse the community-made apps and game ports for your handheld, then install, update and remove them over Wi-Fi without taking the SD card out.

🤖 Built by Claude. Mixtape was designed and written by Claude, Anthropic's AI model, at the request of @snyderman3000. He came up with the idea, chose the direction and tested it on real hardware. Claude wrote the code, the documentation and the artwork. Please report bugs through Issues.

Features

• The whole community catalog. Mixtape reads the live MiyooMini-Ports catalog maintained by Producdevity, so new ports appear without a Mixtape update. If you're offline it uses the last catalog it downloaded, or a copy built into the app. A few projects not in that catalog yet (such as Panel Attack) are listed from Mixtape's own catalog/extra.json. If a project is in both, it's shown once, using the community catalog's entry with any install hints from extra.json.
• One-button installs. It downloads each project's newest GitHub release, detects where the files belong (App/, Roms/PORTS, and so on) and installs them. Projects without releases are installed from their repository.
• What's new. When you open Mixtape and apps or ports have been added to the catalog since your last visit, a NEW ARRIVALS window lists them. Press A to open one, or B to close the window. They also stay in a NEW tab for 14 days, newest first. On the very first visit nothing is announced. Mixtape remembers what it has shown in data/seen.json.
• Updates. Press Y to check everything Mixtape installed. Updates keep settings files you've edited.
• Updates itself. Mixtape checks its own GitHub releases at startup and shows ▲ READY · SELECT in the header when there's a new version. Press SELECT to install it; your settings are kept and Mixtape restarts.
• Clean removal. Erase deletes only the files Mixtape recorded when installing, and refreshes the Ports list for you. If the app ships a cleanup script (see below), Erase runs it first.
• Safe by design. Nothing is written outside the SD card, and Onion's own system files are never replaced.
• Bring-your-own-files games are marked. Ports like Balatro, Fallout and Half-Life need your own legally purchased game data. Mixtape tags them BYO and shows where the files go. It never downloads commercial game data.
• Cassette-futurism UI. Amber phosphor, scanlines, spinning tape reels and an LED VU meter for downloads.

Install

1. Download Mixtape-vX.Y.Z-OnionOS.zip from Releases.
2. Extract it and copy the App folder to the root of your SD card, merging it with the App folder already there.
3. Open Apps → Mixtape. Wi-Fi must be on (Settings → Network).

Requires OnionOS 4.2 or newer. Wi-Fi features need a Miyoo Mini Plus or Mini Flip. On the original Mini, Mixtape shows the catalog but can't download anything.

Controls

Button	Action
D-pad ↑ ↓	Move · ← → page up/down
L1 / R1	Switch tab: All · Apps · Games · On card · New (while there are new arrivals)
A	Open / install / update
X	Erase (only things Mixtape installed)
Y	Check for updates (list) · re-check release (details)
SELECT	Update Mixtape itself
B	Back / exit · MENU exits anywhere

List markers: ● installed by Mixtape · ○ found on the card (installed by hand) · ▲UPD update available · NEW added to the catalog in the last 14 days · BYO bring your own game files · PC must be installed from a computer (for example, .7z releases).

Settings

App/Mixtape/data/config.json:

• github_token: optional GitHub personal access token (no scopes needed). Without one, GitHub allows 60 release lookups per hour per network.
• catalog_url: point Mixtape at a different ports.json.
• extra_url: point Mixtape at a different extra-ports list (default: this repo's catalog/extra.json).

App/Mixtape/data/recipes.json (optional) overrides the built-in install hints in assets/recipes.json.

Logs are written to App/Mixtape/data/mixtape.log.

How it works

File	Purpose
device.go	Framebuffer output (rotated 180° for the Mini's panel) and button input from /dev/input/event0
gfx.go	Software renderer: fonts, cassette, VU meter and CRT effects
ui.go	Screens and navigation
catalog.go	Loads the MiyooMini-Ports catalog and the extra ports in catalog/extra.json, with cache and built-in fallback
github.go	Release lookup and choosing the right download (prefers OnionOS builds)
install.go	Download, archive layout detection, safe extraction, install records, erase
assets/recipes.json	Per-project hints for the few projects that need them

For app and port authors: cleanup on Erase. If your package changes anything outside its own folder (a system library, a setting in OnionOS), include a script named mixtape-uninstall.sh anywhere in it. Before erasing, Mixtape runs it with sh from the script's own folder, with MIXTAPE_UNINSTALL=1 and SDCARD (the card root) set, and allows it 30 seconds. If it fails, Mixtape still erases the files and shows the script's last output. MiniAmp uses this to restore OnionOS's sound library.

It compiles to a single static ARMv7 binary written in Go, with no SDL or C toolchain involved.

Building

Requires Go 1.24 or newer.

./build.sh            # runs the tests, then builds dist/Mixtape-vX.Y.Z-OnionOS.zip
go run . -shot list   # renders a screen to shot.png on your PC (boot|list|apps|detail|busy|done|error|confirm|whatsnew|newtab)

Releasing

Bump version in main.go, add notes in docs/releases/vX.Y.Z.md, and push to main. GitHub Actions runs the tests, builds the zip, tags the version and publishes the release. Every push to main is also test-built by the CI workflow.

Credits

• Catalog: MiyooMini-Ports by Producdevity (MIT). Mixtape is only a front end for it. The ports belong to their authors.
• Reference: PocketFeeds by IC-0n417 showed how to drive the Mini's framebuffer from Go.
• Fonts: Share Tech Mono, VT323 and Orbitron (SIL Open Font License).
• CA certificates: Mozilla bundle via curl (MPL 2.0).
• OS: OnionOS.
• Code, docs and art: written by Claude (Anthropic).

License

MIT. See LICENSE. Bundled fonts and certificates keep their own licenses. See THIRD_PARTY_NOTICES.md.