Outils pour utilisateurs

Outils du site

Panneau latéral




Recover already scraped images to create your gamelist.xml

You have recovered a pack of roms, in which there are the roms and a subdirectory containing the images (downloaded_images for example), but there is no gamelist.xml

With the button 'Recompose Image' (voir 'Recompose image'), ARRM can recover the already scraped images that are present in the image folder ('downloaded_image' in general). is named differently, rename it with the name of the directory you have initialized in the application settings (see 'Image directory name' in the settings tab 'General Options'

Here is how your directory containing the roms and the one containing your images can look like

Rom file:

Pictures subfolder:

You will notice in this case that the images have the same name as the Roms (only the extension differs)

Before continuing the example, we will specify how ARRM works:

Reminder about the local image search process

In its local image search process, ARRM looks for the following image formats:

Several formats are possible depending on the checkbox “image as rom” in ''Scrap options':

<rom_file> can be equal to:

  • <name of_rom_file>
  • <game_title>

For information:

The button recompose image tries to reconstitute an image from the url of the image tags (screenshot, boxart, wheel, cartridge) present in the database. If a tag is missing, the local image search process is executed.

When the scrape or the 'recompose image' can not find an image for the corresponding type (screenshot, boxart, wheel, cartridge), ARRM searches in the order indicated below the following images (the last found will be the one used) .

Search Order Screenshots

<rom_file> .png / .jpg
or <rom_file> -image.png / .jpg
or <rom_file> .png / .jpg
or <rom_file> _screenshot.png / .jpg

For the 3 types of images above, ARRM checks if “Regarded as mix” is checked, otherwise ARRM asks, via a popup, to the user to indicate if it is a Mix (no template will be applied) or if it's a screenshot (the template will apply). In the case of choice of Mix, the Mix file resulting from these images will have the suffix “_customnomix_screenshot_arrm”

or <rom_file> _screenscraper_screenshot_arrm.png / .jpg
or <rom_file> _screenscraper_screenshot_arrm_JAP.png / .jpg
or <rom_file> _thegamesdb_screenshot_arrm.png / .jpg
or <rom_file> _custom_screenshot_arrm.png / .jpg

if MIX is chosen <rom_file> _customnomix_screenshot_arrm.png / .jpg
if MIX is chosen <rom_file> _customnomix_mix_arrm.png / .jpg

If '4 images' mode is enabled, ARRM will also look for the following images:

Boxarts search order

<rom_file> _boxart.png / jpg
or <rom_file> _screenscraper_boxart_arrm.png / .jpg
or <rom_file> _screenscraper_boxart_arrm_JAP.png / .jpg
or <rom_file> _thegamesdb_boxart_arrm.png / .jpg
or <rom_file> _custom_boxart_arrm.png / .jpg

Search order of Wheels / Marquees / Titles

<rom_file> _marquee.png / .jpg
or <rom_file> _wheel.png / .jpg
or <rom_file> _screenscraper_wheel_arrm.png / .jpg
or <rom_file> _screenscraper_wheel_arrm_JAP.png / .jpg
or <rom_file> _thegamesdb_wheel_arrm.png / .jpg
or <rom_file> _custom_wheel_arrm.png / .jpg

Cartridge Search Order

<chr_file> _cartridge.png / .jpg
or <rom_file> _screenscraper_cartridge_arrm.png / .jpg
or <rom_file> _screenscraper_cartridge_arrm_JAP.png / .jpg
or <rom_file> _custom_cartridge_arrm.png / .jpg

For information:

You can manually add your image files in the format below (prefer the format with suffix

  • _screenscraper_screenshot_arrm
  • _screenscraper_boxart_arrm
  • _screenscraper_wheel_arrm
  • _screenscraper_cartridge_arrm

Let's go back to our Example

Launch of ARRM

Choose in the Systems panel the Roms directory of your Recalbox / Batocera (usually \recalbox\share\roms)

Configuring ARRM Options via Tabs (General Options / Scrap Options / Images Options / Gamelist Options / Recalbox / Screenscraper)

In this case, in the General options tab of ARRM, do not activate the 4 images (via the button Extra Tag + Default image)

In the 'Scrap options' tab check the desired options (in this case I check: Image as rom (allows to have image file names as the rom file name)

In tab 'Scrap options' you tick in the part 'local images considered as' Mix (if the already recovered images are Mix, or screenshot if they are only screenshots)

In the 'Images Options' tab, choose the type of image (Screenshot or Mix). If 'Mix' is chosen, consider choosing a template (button chosen Mix model). In this case the image will be mixed in the template (Do only if the original image is a screenshot). If you want to keep the image as the original one, take 'Screenshots'.


If you have chosen in 'Images Options' format 'Mix' and if in 'Scrap options' you do not choose 'Mix' or 'Screenshot', for each image found, a Popup (see picture below) below) will ask you to indicate if the image found is already a mix or a screenshot.

In the Gamelist tab the options are normally near ticked (saves old gamelist etc …). I invite you nevertheless to click on the button 'Backup Gamelists' which makes it possible to save in a directory backup of each system the gamelist.xml of each system.

In the tab 'Recalbox / Batocera / screenscraper', enter your account 'Login screenscraper' if you have one (it is not necessary to have one to scraper, but if you have one you will be prioritized by the server) and the login and password of the recalbox / Batocera

Before handling, remember to click on 'Stop EmulationStation', if you work directly on a Recalbox / Batocera 'on'

After filling in the directory of Roms ( 1 ), the list of systems present must be displayed.

Tick ​​the desired system ( 2 ), in our case: 'amstradcpc' and click on 'DISPLAY' ( 3 ).

Be careful not to choose several systems because in this case it will launch a scrapbook on Screenscraper for all selected systems

ARRM will display in the window the list of found Roms, and all related info. ( 1 )
In this example, you will find your Rom without any additional information.

Select all the Roms by clicking on the 'Select All' button ( 2 ) and Click on the 'Redo Image' button ( 3 ) located in the panel 'Possible actions on selected Roms'.

The search will launch on the highlighted Roms and will attempt to recover the previous images.

Once the scrap is done, just click on the 'SELECT ALL' button in the 'FILTERS' panel and then click on the button 'Create Gamelist.xml for the selected Roms'

Once the 'recompose image' is finished, you have your images in the database but not the text information. So we will retrieve this text information on the scrap servers (this operation is much faster than a full scrap). You have to tick in the tab 'images options': 'No picture, only texts', then re-select all the Roms, and start a scrapbook on Screenscraper by clicking on the button Screenscraper.

Once the scrap is done, just click on the 'SELECT ALL' button in the 'FILTERS' panel and then click on the button 'Create Gamelist.xml for the selected Roms' in order to save the contents of the Database in the gamelist ( link to images / text info etc …)

Then think about doing a 'reboot of the recalbox' via the 'Recalbox / screenscraper' tab to restart Emulationstation

Back to Various cases (practical cases)

retrieve_images_en.txt · Dernière modification: 2019/12/14 20:38 par nexusone13