How to add box art in Miyoo Mini?

While adding box arts in Miyoo Mini is easy to do, creating them need a intermediate guide. This guide is inspired when I answered how to add box art in RG35XX, so expect similarities. Box art, again, is a thumbnail image representing your games. Many people need box arts to tell which game it is, and considering that the older we are, the worse our eyes can be. That’s why I think it’s a bliss to include box arts into our retro handheld device.

Make sure you read my Miyoo Mini Onion guide.

What you need

  • The latest version of Skraper
  • The latest version of ImageMagick
  • List of box arts for retro games (adding manually)

How to add box art in Miyoo Mini?

Adding box art automatically
  • Insert your SD card into a computer
  • Extract and run Skraper installation file.
  • Select Recalbox. Press “Next”. Select your Roms in SD card as the rom path
  • Tick Include non-Recalbox rom folders then press “Next”, then press “Finish”
  • Press the ‘+’ button at the bottom left below systems and highlight all the missing systems you would like to scrape for (can select multiple at once). You can also use the ‘-‘ button to remove emulators you don’t want to scrape for
  • Add folder for each of the missing systems you just added. Learn how to rename folders in this article
  • Select Media, set “Resize width to” to 250, and enable “Keep image ratio”
  • Select the image type you don’t want in the “Fetched Media List” and press the ‘-‘ button, so there’s only one picture.
  • Select “All systems” on the left side, select the Game List tab, and change the name of “Game list full path” from %ROMROOTFOLDER%\gamelist.xml to %ROMROOTFOLDER%\miyoogamelist.xml
  • Change output folder from %ROMROOTFOLDER%\media\images to %ROMROOTFOLDER%\Imgs and select “Cleanup output folder before generating new medias” checkbox
  • Under “Gamelist Link” ensure that “Link from node ‘<thumbnail>'” is ticked as well as “Optimize media storage”
  • Scrape all systems, or whatever system you want to scrape for
  • Delete any gamelist.xml files after
  • Continue to bulk resize all images
Adding box art manually

If you don’t like to download anything, you would like to add box art manually. If you use Onion with your Miyoo Mini or Miyoo Mini Plus, it is very easy to add box arts manually. Here is the step-by-step guide:

  • Download box arts manually, either from Archive or libretro
  • Insert your SD card, navigate to %ROMROOTFOLDER%\Imgs. If there is no folder with that name, create one
  • Depending on where you download box arts from, you must resize to match the Miyoo Mini’s resolution. Continue to bulk resize all images

Bulk resize box arts for Miyoo Mini

For Windows users
  • Navigate to Roms folder, press and hold SHIFT + right click. Select “Open PowerShell window here”
  • Use this command line
Get-ChildItem -recurse | where {$_.name -eq "Imgs"} | foreach {cd -LiteralPath $_.FullName; magick mogrify -monitor -resize 340x480 -extent 640x480 -gravity West -background none *;}

If you want to edit individual Imgs folder, for example whenever you add new system to your Miyoo Mini, just navigate to this specific folder (for example, /Roms/Arcade/), press and hold SHIFT + right click. Select “Open PowerShell window here”. Then use this command line:

magick mogrify -monitor -resize 340x480 -extent 640x480 -gravity West -background none *
For macOS users
  • Open Finder, navigate to Roms folder and select all the images inside that you want to resize. Right click, select “Open with” and click on “Preview (default)”
  • In “Preview”, select all the images you’d like to batch resize from the left side thumbnail drawer. Click on “Edit,” and then “Select All”
  • Click on “Tools” and then click on “Adjust Size…”
  • Set “Height” to 640 and “Width” to 480. Click OK
  • Click on “File,” and then “Save”

That’s it, if you have any other questions, please find it in my Miyoo Tutorial.