Miyoo Mini Plus — Onion OS setup
Quick answer
Button combo
(SD: FAT32)(SD: FAT32)insert SDPOWERPackage Manager (START twiceA)
Steps
- 1Update the stock firmware first: the Mini Plus needs base firmware 202305052130 or later for current Onion OS.
- 2Format your microSD/TF card as FAT32 with an MBR partition (Windows >32GB: use Rufus → Large FAT32, 32KB cluster; macOS: Disk Utility → Erase → MS-DOS (FAT) → Master Boot Record).
- 3Download the latest Onion-v4.x.x.zip from the OnionUI GitHub releases page.
- 4Extract the zip and copy all 7 folders to the SD root: .tmp_update, BIOS, Media, miyoo, miyoo354, RetroArch, Themes.
- 5Insert the card, press POWER, and let the Package Manager run; pick systems, press START twice, then press A to finish and reboot.
Last verified: 2026-06-20Source: github.com
The Miyoo Mini Plus is the device Onion OS was built for, but you must be on base firmware 202305052130 (May 2023) or newer before installing. Format the microSD as FAT32 (MBR), unzip the Onion release onto the card root, and the device runs its installer on first boot. After the Package Manager finishes, add ROMs to the Roms subfolders and BIOS files to BIOS. On Windows, Onion Desktop Tools can format, download, and install Onion in one step.
FAQ
- Which firmware version does the Mini Plus need before Onion OS?
- Base (stock) firmware 202305052130 or later. The Mini Plus shipped on older firmware that the current Onion OS will not install on, so update the stock firmware first using Miyoo's official firmware package.
- Why must the card be FAT32 and not exFAT?
- The Onion installer and the Mini Plus boot loader read FAT32. Cards over 32GB cannot be set to FAT32 by Windows' built-in formatter — use Rufus (Large FAT32) or the SD Card Formatter / Onion Desktop Tools instead.
- Do I copy the folder or the files?
- Copy the contents of the unzipped Onion folder — the 7 folders (.tmp_update, BIOS, Media, miyoo, miyoo354, RetroArch, Themes) must sit at the root of the card, not inside a subfolder.