Skip to main content
Version: 4.3

Fresh install

Step 1: Preparing the SD card (only necessary first time)


The SD card included with the Miyoo Mini is known to be slow, and will likely ruin your experience and/or data. Stick to using SD cards from reputable brands (e.g. SanDisk or Samsung).

Format your SD card as FAT32 (not exFAT!)

If your SD card is larger than 32 GB, you need to use a third-party tool like Rufus:

  1. In Rufus, select the device that corresponds with the SD card you want to format
  2. Set Boot selection to Non bootable
  3. Partition scheme should already be set to MBR
  4. Set File system to Large FAT32
  5. Cluster size at 32 kilobytes should be fine (16 kilobytes might extend the life of your SD card)
  6. Click START to format the card, when it's done you can close the window
GUIFormat / fat32format

We do not recommend using GUIFormat / fat32format, since many users are reporting file system errors on cards above 128 GB

Step 2: Copy the installation files and boot up your device to begin the installation

  1. Right click the file and select Extract allExtract
  2. Select and copy the 7 folders to the root of your SD card
Installation files

The Onion installation files consists of the following folders:

.tmp_update/  # Might be hidden
  1. Insert the SD card into the Miyoo device, and turn it on to begin the installation.
  2. When the installation is done, you'll be prompted with the Quick Guide - a quick overview of Onion
  3. Then you'll presented with the Package Manager, choose the systems and apps you want enabled, then press START twice
  4. When the installation is done, press the A button and the device will turn off (MM) or reboot (MMP).

Step 3: Copy over your bios and rom files

  1. Copy your bios files to the BIOS folder (stock bios files are available at RetroArch/.retroarch/system on the stock SD card).
  2. Copy your roms into their respective subfolders in Roms (see the Emulators page for more information - here you'll find the Rom Folders table).
Part of the system

Despite its name, the .tmp_update folder must stay on your SD card.

  1. Insert your SD card, boot up your Mini and press SELECTRefresh all roms from the Games tab in the main menu to refresh roms (forcing a reindex of your games).