Skip to content

How to Install Onion OS on the Miyoo Mini Plus

Handheld Spot Staff

The Miyoo Mini Plus gets the hardware right: a 3.5-inch 640×480 screen, a proper D-pad, Wi-Fi, and a shell that disappears into a pocket. The software it ships with does not. The stock SD card is unreliable, the bundled ROMs are a mess, and the stock OS leaves most of the hardware unused.

Onion OS is the fix. It is a free, open-source operating system that adds a faster menu, 100+ emulators, save states, rewind, cover art, and per-system controls. This guide takes you from a blank card to a working library, including the two game sets most people want: Tiny Best Set: GO! and Done Set 3.

Last verified: October 2026, against Onion 4.3.1-1 and Done Set 3.

Buy the right model. The new Miyoo Mini Plus V2 uses a Rockchip RK3562 and has no Onion OS build as of October 2026. This guide is for the original Mini Plus with the SigmaStar SSD202D. Check the current listing (affiliate link) and confirm it is the original model, not the V2.

Some links on this page are affiliate links. If you buy through them, we may earn a commission at no extra cost to you. See our affiliate disclosure.

The short version: Format a good microSD card as FAT32 → update the firmware if it is older than 20230505 → extract Onion to the card root → boot and pick your cores → copy Tiny Best Set or Done Set 3 → press SELECT and refresh. Budget 30–45 minutes, plus download time.

Contents

What you need

You needWhat to get
Miyoo Mini PlusThe original model with the SigmaStar SSD202D — not the V2. See the note above.
microSD card32GB minimum. A 128GB card covers almost everyone. SanDisk or Samsung, bought from a reputable seller.
Card readerA decent USB card reader. The bundled one is not worth the risk.
ComputerWindows, macOS, or Linux.
7-ZipWindows only. macOS can use the built-in Archive Utility.
qBittorrentOptional, but strongly recommended for Tiny Best Set and Done Set 3.
USB-C data cableOnly if your firmware needs updating. A charge-only cable will not work.

Card size, in plain terms:

CardWhat it holds
32GBOnion + Tiny Best Set base (about 6GB) + saves.
64GBOnion + TBS base + the 64GB expansion.
128GBFull Tiny Best Set (about 94GB) or Done Set 3 base.
256GBDone Set 3 plus the PS1 add-on.

If you are buying a card for this project, buy 128GB. It is the size that keeps your options open without paying for space you will never fill. Go to 256GB only if you are set on Done Set 3’s PS1 add-on.

Before you start

  • Do not use the card that came in the box. It is the most common failure point on the Mini Plus. Keep it as a stock fallback if you like, but do not put your library on it.
  • Optional: if the stock card still works, copy RetroArch/.retroarch/system from it to your computer. That is the stock BIOS folder. TBS and Done Set 3 include their own BIOS files, so this is a nice-to-have, not a requirement.
  • If you already have saves or ROMs on a card, copy Roms and Saves to your computer before you format anything.
  • Keep the stock card untouched. A clean stock card is your fastest way back if you ever want to undo the install.

Step 1: Format the SD card

Onion cannot read exFAT. The card must be FAT32. This is the single most common reason an install fails.

Windows

  1. Download Rufus.
  2. Insert the card and select it under Device.
  3. Set Boot selection to Non bootable, Partition scheme to MBR, File system to Large FAT32, and Cluster size to 32 kilobytes.
  4. Click Start and confirm.

Rufus handles cards larger than 32GB, which Windows’ built-in formatter cannot format as FAT32.

macOS

  1. Open Disk Utility.
  2. Select the card itself — the device, not the volume underneath it.
  3. Click Erase.
  4. Choose Format: MS-DOS (FAT) and Scheme: Master Boot Record.
  5. Click Erase.

Linux and Chrome OS

On Linux, use gparted (or mkfs.vfat -F 32) to create a single FAT32 partition with an MBR partition table. Double-check the device name before you format. On Chrome OS, right-click the card in Files, choose Format Device, select FAT32, and confirm.

Windows says the card is in use? Close File Explorer. Open Task Manager, find Windows Explorer, right-click it, and choose End Task. Then go to File > Run new task, type explorer.exe, and press Enter. Try the format again.

Step 2: Check and update the firmware

This step is for the Miyoo Mini Plus only. The original Mini and the Flip use different firmware — do not copy these files onto them.

Turn the device on and open Settings > Device Info (some firmware versions call it About Device) > Version. You need a version starting with 20230505 or newer.

  • Already on 20230505 or newer? Skip to Step 3.
  • Older? Update before installing Onion.
  1. Open the Onion installation page and download the recommended Miyoo Mini Plus firmware. Unzip it.
  2. Copy the .img file inside to the root of the SD card. It should be the only file on the card.
  3. Power the device off, insert the card, and connect the device to your computer with a USB-C data cable. The update starts on its own; you will see a progress screen, often a rocket.
  4. When it finishes, power the device off, put the card back in the computer, and delete the .img. Continue to Step 3.

Warning: Firmware flashing can brick the device if it is interrupted. Start with a charged battery, use a known-good cable, and do not unplug until it finishes. If your firmware is already 20230505 or newer, do not update just because a newer file exists.

If the update never starts, check three things: the .img is in the card root, the device is off before you connect the USB cable, and the cable carries data. Try another cable and another USB port.

Step 3: Copy Onion OS to the card

Download the latest stable Onion release from the Onion GitHub releases page. As of October 2026, that is v4.3.1-1. Download the .zip asset, not a pre-release or snapshot.

Extract the ZIP directly to the card root. Do not create a folder for it. When you are done, the root should contain these seven folders:

.tmp_update/
BIOS/
Media/
miyoo/
miyoo354/
RetroArch/
Themes/

You may also see a Roms folder if the card has been used before. That is fine. If the root contains a single Onion-v4.3.1-1 folder instead, you extracted one level too high — move the seven folders up.

On macOS and Chrome OS, .tmp_update is hidden by default. On macOS press Command+Shift+.; on Chrome OS open the three-dot menu and enable Show Hidden Files. If .tmp_update is missing, the installer will not run.

Delete the downloaded ZIP afterward. It does not need to stay on the card.

Windows shortcut: Onion Desktop Tools can format the card, download Onion, and copy the files for you. It is a good option if you would rather not do Steps 1–3 by hand. The manual route is just as reliable.

Step 4: Install Onion OS on the device

  1. Eject the card safely, put it in the Mini Plus, and power on.
  2. The installer runs automatically. Follow the on-screen Quick Guide, then the Package Manager.
  3. Select the systems and cores you want. If you are using Tiny Best Set or Done Set 3, use the lists below. Press START twice to begin.
  4. Wait while Onion installs. The Mini Plus reboots when it is done. If it powers off instead, turn it back on.

Do not remove the card while Onion is installing. You can add or remove cores later in the Package Manager, so you do not have to get the list perfect on the first try.

Cores for Tiny Best Set

If you plan to use Tiny Best Set, check these in the Package Manager:

  • Arcade
  • Atari - 2600
  • NEC - TurboGrafx CD (64GB and 128GB expansions only)
  • NEC - TurboGrafx-16
  • Nintendo - Game Boy
  • Nintendo - Game Boy Advance
  • Nintendo - Game Boy Color
  • Nintendo - NES
  • Nintendo - SNES
  • SNK - Neo Geo
  • Sega - CD (64GB and 128GB expansions only)
  • Sega - Game Gear
  • Sega - Genesis
  • Sega - Master System
  • Sony - PlayStation (64GB and 128GB expansions only)

Cores for Done Set 3

Done Set 3 covers more systems. Check these:

  • Arcade
  • Atari - 2600
  • Atari - 5200
  • Atari - 7800
  • Atari Lynx
  • Bandai - WonderSwanColor
  • Capcom - CPS3
  • Coleco - ColecoVision
  • Commodore - C64
  • GCE - Vectrex
  • Microsoft - DOS
  • NEC - TurboGrafx-16
  • NEC - TurboGrafx CD
  • Nintendo - Famicom Disk System
  • Nintendo - GBA
  • Nintendo - Game & Watch
  • Nintendo - Game Boy
  • Nintendo - Game Boy Color
  • Nintendo - NES
  • Nintendo - SNES
  • Nintendo - Satellaview
  • Nintendo - Super Game Boy
  • Nintendo - DS (if your Onion build lists it)
  • PICO-8
  • Ports Collection
  • SCUMM
  • SNK - Neo Geo Pocket Color
  • Sega - CD
  • Sega - Game Gear
  • Sega - Genesis
  • Sega - Master System
  • Sinclair - ZX Spectrum
  • SNK - Neo Geo
  • Sony - PlayStation

Package names shift slightly between Onion versions. If a name is not an exact match, pick the closest one. If you are using your own ROMs, select only the systems you actually have; you can add the rest later.

Step 5: Add games

Pick one path: Tiny Best Set: GO!, Done Set 3, or your own ROMs. TBS and Done Set 3 share a lot of games, so installing both gives you duplicate entries and a messier menu.

A note on the sets: TBS and Done Set 3 are community-curated collections of copyrighted game files. This guide does not link to or host them.

Tiny Best Set: GO!Done Set 3
Best forFirst-timers who want a curated library.Tinkerers who want the widest library.
Size6GB base; 94GB full.93GB base; 119GB with extras.
Card32GB base; 128GB full.128GB base; 256GB with PS1.
SetupDrag and drop.Auto Setup.bat or manual extract.
ExtrasBox art, BIOS, arcade names.Manuals, cheats, configs, PS1 add-on.

Option A: Tiny Best Set: GO!

TBS is the easiest on-ramp. It is a hand-curated set with box art, BIOS files, and arcade names already organized for Onion. Search the web for Tiny Best Set: GO! and open its current release page. The download may ask you to log in; that is normal. Grab the torrent and open it in qBittorrent — it is much faster than pulling the ZIPs one at a time.

The set is split into incremental packs:

FileWhat it adds
tiny-best-set-go-games.zipBase games and BIOS.
tiny-best-set-go-imgs-onion.zipBox art for the base set.
tiny-best-set-go-arcade-names-onion.zipProper arcade game names.
tiny-best-set-go-expansion-64-games.zip64GB expansion games.
tiny-best-set-go-expansion-64-imgs-onion.zipBox art for the 64GB expansion.
tiny-best-set-go-expansion-128-games.zip128GB expansion games.
tiny-best-set-go-expansion-128-imgs-onion.zipBox art for the 128GB expansion.

Download all seven if you have the card space and bandwidth. For the base set, the first three are enough. For a 64GB card, add the two 64GB files. The packs build on each other — the 128GB pack is incomplete without the base and 64GB packs.

  1. Open one ZIP. Inside you will see a Roms folder, a BIOS folder, or both.
  2. Drag those folders to the root of the SD card. When Windows or macOS asks, merge with the existing folders and skip duplicates.
  3. Repeat for each ZIP you downloaded.
  4. Eject safely, put the card in the Mini Plus, power on, and press SELECT on the main menu. Choose Refresh all roms.

The base pack does not include PS1, Sega CD, or PC Engine CD games. Those start in the 64GB expansion.

Option B: Done Set 3

Done Set 3 is the current Done Set release (January 2025). It is bigger and broader than TBS: more consoles, more ports, manuals, cheats, and per-model configs. It also takes longer to set up and needs a bigger card. If you just want to play, TBS is the easier choice. If you want the fullest library, use Done Set 3.

Search the web for Done Set 3 (the January 2025 release) and download the torrent. The set’s release notes include a setup guide with the full details; the steps below are the short version.

Before you start: Done Set 3 is a fresh-install set. Do not unpack it over TBS, Done Set 1, or Done Set 2 — the region suffixes were removed, and mixing sets creates duplicate entries. You need a 128GB card minimum; the PS1 add-on is for 256GB cards.

  1. Install Onion first (Steps 1–4) and select the Done Set 3 cores above.
  2. Windows: put the card back in the PC and ignore the “filesystem error” prompt. Open the downloaded done-set-three_202501 folder and run Auto Setup.bat. Choose the SD card root and the modules you want. It downloads and extracts the latest installer. Manual alternative: open Done Set 3.zip with 7-Zip, extract it to the card root, and choose merge/overwrite. Repeat for each optional ZIP. Do not copy the ZIPs themselves.
  3. macOS: unzip Done Set 3.zip, drag the contents to the card root, and choose Merge. Repeat for optional ZIPs.
  4. Add the extras you want:
    • One art pack: Imgs (2D Box).zip, Imgs (2D Box and Screenshot).zip, or Imgs (Miyoo Mix).zip (the default Miyoo look).
    • Configs for Plus Model.zip for the Mini Plus. Use Configs for V4 Model.zip only on a Mini v4.
    • Manuals.zip if you want PDF manuals. It is large.
    • Cheats.zip last, if you want cheats enabled.
    • PS1 Addon for 256gb SD Cards.zip only if you have a 256GB card.
  5. Eject safely, boot the device, press SELECT, and choose Refresh all roms.

Done Set 3 notes: The set contains mature and unlicensed games, and its author asks that it not be sold. If you are migrating saves from an older set, rename each save to match the new region-free game filename, and do not let an old config folder overwrite Done Set 3’s.

Option C: Your own ROMs

If you already have a collection, skip both sets. Copy each game into the right folder under Roms — for example, Roms/GBA for Game Boy Advance — and put BIOS files in BIOS. Then press SELECT > Refresh all roms. The Onion emulator list has the full folder reference.

Use only ROMs you own. This guide does not host or link to game files.

Step 6: Five settings worth changing

Onion works fine out of the box, but these five changes make it much nicer. All are optional.

  1. Turn on rewind. In a game, press SELECT + MENU, open Rewind, enable Rewind Support, and set Rewind Frames to about 20. Back out to the main menu, open Overrides > Save Core Overrides. Hold MENU + L to rewind.
  2. Stop games from auto-resuming. Press SELECT + MENU, open Saving, and turn off Load State Automatically. Save a core override so it sticks.
  3. Stop save slots from auto-incrementing. Open Apps > RetroArch > Saving and turn off Increment Save State Index Automatically. Back out, open Configuration File > Save Current Configuration. MENU + Left/Right switches slots manually.
  4. Set vibration. Open Apps > RetroArch > Settings > Input > Haptic Feedback and adjust Vibration Strength. Save the configuration when you are done.
  5. Add a theme. Download a theme from the Onion theme repository, extract it into Themes on the card, then open Apps > Theme Switcher. Browse themes.

One more useful trick: Onion can copy files over Wi-Fi. Turn on the Samba server in Onion and connect to the device’s IP from your computer. The Onion wiki has the credentials and setup steps.

Troubleshooting

ProblemFix
Black screen or boot loop after copying OnionThe folders are nested one level too deep. The card root must contain .tmp_update, BIOS, Media, miyoo, miyoo354, RetroArch, and Themes. Re-extract and move them up.
Installer never starts.tmp_update is missing or hidden. Re-extract the ZIP with hidden files shown. Confirm the card is FAT32, not exFAT.
Games do not show upPress SELECT > Refresh all roms. Check the files are in the right Roms/<system> folder and use a supported extension. If the folder has an old miyoogamelist.xml, rename or remove it and refresh again.
Duplicate gamesYou installed TBS and Done Set 3 together, or copied an old set over a new one. Use one set on a fresh card.
“Filesystem error” on Windows after installing OnionClick ignore or continue. This is expected; Windows does not understand Onion’s partition layout.
Card is not recognized by the PCTry another card reader, USB port, or cable. If the card is a no-name brand, replace it.
Firmware update never startsMake sure the .img is in the card root, the device is off before you connect USB, and the cable supports data. Try another cable and port.
PS1, Sega CD, or PC Engine CD games will not launchA BIOS file is missing or in the wrong place. Use the BIOS from TBS or Done Set 3, or add your own to BIOS.
Saves disappeared after changing setsThe ROM filename changed. Rename the save or state file to match the new ROM name.
Wrong aspect ratio in a gamePress START + MENU to cycle the available aspect ratios.

FAQ

Do I really need a new SD card?

Yes. The included card is the most common failure point on the Mini Plus. A 32GB SanDisk or Samsung card costs little and saves you from losing saves. If you already have a good card, use it.

Which card size should I buy?

128GB for most people. It covers the full Tiny Best Set or the Done Set 3 base. Buy 256GB only if you want Done Set 3’s PS1 add-on; buy 32GB or 64GB only if you are sure you want the TBS base or base + 64 expansion.

Tiny Best Set or Done Set 3?

TBS for most people. It is smaller, simpler, and still covers NES through PS1. Done Set 3 if you want the widest library, more consoles, ports, and manuals, and you do not mind a longer setup and a bigger card.

Can I install both?

No. They share games, and you will get duplicate entries. Pick one.

Do I need BIOS files?

TBS and Done Set 3 include the BIOS files they need. If you are using your own ROMs, put the required BIOS files in BIOS. PS1 and Sega CD games need them.

Do I need to update the firmware?

Only if your Mini Plus is older than 20230505. If it is on 20230505 or newer, skip Step 2. Do not flash firmware you do not need.

Does this work on the Miyoo Mini or Miyoo Mini Flip?

No. This guide is for the Miyoo Mini Plus. The original Mini uses different firmware, and the Flip uses a separate Onion build. Check the Onion installation docs for the current supported-device list.

Does this work on the Miyoo Mini Plus V2?

No. The V2 uses a Rockchip RK3562 and has no Onion build as of October 2026. Buy the original SSD202D model if Onion is the plan.

Can I undo it?

Yes. Keep the stock card untouched. To go back, power off, swap in the stock card, and boot. If you reused the stock card, you would need to restore it from a backup.

How long does it take?

About 30–45 minutes for the setup, plus download time. TBS installs faster than Done Set 3. A slow card or a large torrent can add an hour.

Where do I get games?

Use ROMs you own, or one of the two sets above. This guide does not host or link to game files.

Is Onion free?

Yes. Onion is free and open source. If you like it, consider supporting the developers through the project page.

You’re done

You should now have Onion booting, a library with cover art, working save states, and rewind. Put the stock card somewhere safe and go play.

More handheld guides: all guides, the Miyoo platform page, Miyoo Mini Plus vs Anbernic RG35XX SP, and the best retro handhelds for emulation.

Still need the hardware? Miyoo Mini Plus on AliExpress (affiliate link).

Sources and further reading

This guide was written from the official Onion documentation, the Tiny Best Set release notes, and the Done Set 3 setup guide. It does not host or link to game files.

Related