Version: 4.3

Scraping artwork for games

^{Credit: f8less & Julian}

note

Onion now includes an internal scraper (Scraper). However for big games collections it will be probably faster to make it from a PC so this guide will help you to configure your scraping.

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

Install

Download & Extract Skraper from: https://www.skraper.net/
Log in to Skraper

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:

Live Example:

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.

Scraping artwork for games

File type and placement