Miyoo Mini V4 — Onion OS setup
Quick answer
Button combo
(SD: FAT32)(SD: FAT32)insert SDPOWERPackage Manager (START twiceA)
Steps
- 1Update the stock firmware first: the V4 should be on base firmware 202310271401 or later so Onion can use the V4's 752x560 screen.
- 2Format your microSD/TF card as FAT32 with an MBR partition (Windows >32GB: Rufus → Large FAT32, MBR, 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 and extract it.
- 4Copy the contents (the folders .tmp_update, BIOS, Media, miyoo, miyoo354, RetroArch, Themes) to the SD root — not inside a subfolder.
- 5Insert the card and press POWER; the Quick Guide and Package Manager run, then pick systems, press START twice and A to finish (the Mini V4 powers off — turn it back on).
Last verified: 2026-06-20Source: onionui.github.io
The Miyoo Mini V4 is a SigmaStar device like the original Mini and Mini Plus, so Onion OS installs by copying files to a FAT32 microSD with no internal flashing. The V4 has a higher-resolution 752x560 screen, and base firmware 202310271401 with Onion 4.3 or later is needed to drive it at native resolution — update the stock firmware first if yours is older. Format the card FAT32 (MBR), unzip the Onion release to 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 does the Mini V4 need before Onion OS?
- Base firmware 202310271401 or later, which with Onion 4.3+ lets the V4 run at its native 752x560 resolution. Older firmware can leave the screen at the wrong resolution, so update the stock firmware from Miyoo first.
- Is the V4 setup different from the original Mini?
- The procedure is the same (FAT32 card, copy the 7 folders, first-boot installer). The main difference is the V4's 752x560 screen, which needs the newer base firmware and a current Onion release to display correctly.
- Why must the card be FAT32 and not exFAT?
- The Onion installer and the V4's boot loader read FAT32. Cards over 32GB cannot be set to FAT32 by Windows' built-in formatter — use Rufus (Large FAT32), the SD Card Formatter or Onion Desktop Tools instead.