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.

• 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.
• 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.
• 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.
• 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.

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.

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

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.

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

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)

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.

• 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).

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