Skip to main content
Version: 4.1

Scraping artwork for games

(Credit: f8less & Julian)

File Type and Placement:​

The image file format for scraped artwork is .PNG, with a max size of 250px (H) X 360px (W). The images need to be placed into the Roms/<gamesystem>/Imgs folder.

The Imgs folder name is case sensitive (must have a capital I). Examples would be like the following:
Roms/FC/Imgs
Roms/SFC/Imgs
Roms/GB/Imgs

Box Art/Screenshot Scraping Process:​

Software Install:​

Initial Setup:​

  • Select "Recalbox"
  • Tick "Include non-Recalbox rom folders"

    (Some systems aren't recognized because their folder-names are non-standard. To add those systems, press the + symbol on the bottom left, select the systems that are missing & hit "OK". Then, click the added systems in the bar on the left, and correct the system's folders via the "GAMES & FRONT END" tab -> "Games/Roms folder:" field -or- by clicking the folder-icon to the right of it. You can find a list of all Rom folder names here

Media Selection:​

Use a (Great!) Custom Image Template Designed for OnionOS:

Examples:
image image image

Live Example:
image

  • Download template from the Retro Game Handhelds Discord:
    SkraperMix-_Miyoo_Mini_Big_Zoom_by_AchillesPDX.zip - Template by: AchillesPDX
  • Extract the .ZIP file into the following Skraper folder: .\Skraper-#.#.#\Mixes\
  • Via the "ALL SYSTEMS"selection on the left, go to the "MEDIA" tab -> Clear the "Fetched Media List" of all but one image type by pressing the "minus" button.
  • Change the "Media type:" to: "USER PROVIDED MIX" and click on the file icon to the right
  • Select the extracted: Miyoo Mini Big Zoom.xml
  • Disable settings "Resize width to" , "Resize height to" , "Keep Image Ratio"

- OR -

Customize Image:

  • Via "ALL SYSTEMS" on the left, go to the "MEDIA" tab -> Enable & 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 "minus" button, so there's only one picture.

    You can change how the image mix looks with the two buttons under "Media type", I recommend changing "4 IMAGES MIX" to "Screenscraper's Recalbox Mix V2", but use whatever you prefer. If you choose a picture that's taller than it's wide, like the boxart, set "Resize height to" to 360 and disable "Keep Image Ratio"

Output Settings:​

  • Change "Output folder" to %ROMROOTFOLDER%\Imgs, with a capital I.
  • Under 'Gamelist Link' ensure that "Link from node '<thumbnail>'" is ticked as well as 'Optimize media storage' (these are important if you wish to use the generated gamelist.xml to create a miyoogamelist.xml for use in Onion (more info on this below on this page).
  • Now click the system you want to scrape for on the left side, or "all system", and press the play button in the bottom right corner.

This will automatically scrape images to the correct folders for Miyoo Mini.

YouTube Tutorials:​