Since version 1.8.1.6.

Video Tutorial

Watch video

This form is accessible via the Media assignment 'Screenscraper' + Media order button in the General options tab

This form presents the different graphic elements that can be retrieved via the Screenscraper API. You can choose which graphic element will feed this or that TAG of the gamelist. It also makes it possible to force the recovery of media images and texts in the order of the countries indicated.

ARRM adds proprietary Tags that cannot be used in themes but are used for various ARRM internal processing. These Tags are:

• screenshot
• boxart
• cartridge
• wheel
• mix

In 4-image mode they are written in the gamelist.xml because they allow you to recompose MIX images without having to re-scrape on Screenscraper, (for example to use another template)

The possible choices are therefore:

• BOXART
• CARTRIDGE
• SCREENSHOT
• WHEEL
• MIX
• FANART
• MAP
• TITLESHOT
• IMAGE
• NONE (default)
• –ERASE–

If you choose the CARTRIDGE media for thumbnail, the thumbnail tag will be written in the gamelist.xml with the value corresponding to the media of the CARTRIDGE tag. This media will therefore be recovered on the disk. Ditto for marquee and image.
If you choose NONE, the thumbnail tag will keep the value of the thumbnail tag loaded with the gamelist.xml.
If you choose –ERASE–, the contents of the 'marquee' tag will be erased from the database and not written to gamelist.xml.

For the marquee Tag, you must indicate which Tag it will use the media from. By default it will be NONE.

The possible choices are therefore:

• BOXART
• CARTRIDGE
• SCREENSHOT
• WHEEL
• MIX
• FANART
• MAP
• TITLESHOT
• IMAGE
• NONE (default)
• –ERASE–

If you choose the BOXART media for marquee, the marquee tag will be written in the gamelist.xml with the media value corresponding to the media of the BOXART tag. This media will therefore be recovered on the disk.
If you choose NONE, the marquee tag will keep the value of the marquee tag loaded with the gamelist.xml.
If you choose –ERASE–, the contents of the 'marquee' tag will be erased from the database and not written to gamelist.xml.

The image Tag will contain the media selected in the 'Images options' tab, and which can therefore be:

• Boxart
• Screenshot
• Marquee
• Mix
• Cartridge

You can tell ARRM in which order of priority you want to retrieve image and text media depending on the country.

Do you want, for example, to recover Japanese media, while keeping the texts (description, genre, etc.) in French?

It's entirely possible. You can choose in which language ARRM will retrieve the media and texts.

Edit presets

It is also possible to select a preset (via the combobox Media Order) These presets can be edited by clicking on the icon. You can thus create your own presets. When you modify the presets file, remember to click on the arrows icon to update the combobox.

The preset file looks like this:

# FRENCH
# country code: ame,asi,au,bg,br,ca,cn,cus,cz,de,dk,en,es,eu,fi,fr,gr,hu,il,it,jp,kr,kw, mor,nl,no,nz,oce,pl,pt,ru,se,sk,tr,tw,uk,us,ss,wor
# you can add your own label, but keep the same structure
# you can edit this file: modify or add country codes
# Wen default is selected, the country codes will be those of the language of the interface (same as custom line)
# never delete default entry
#
default#screenshot=default|boxart=default|cartridge=default|wheel=default|text=default
custom#screenshot=fr,ca,eu,wor,us,en,uk,ss,cus|boxart=fr,ca,eu,wor,us,en,uk,ss,cus|cartridge=fr,ca,eu, wor,us,en,uk,ss,cus|wheel=fr,ca,eu,wor,us,en,uk,ss,cus|text=fr,ca,eu,wor,us,en,uk,ss, cus
japan#screenshot=jp,wor|boxart=jp|cartridge=jp|wheel=jp|text=fr,ca,eu,wor,us,en,uk,ss,cus
brazil#screenshot=br,wor|boxart=br|cartridge=br|wheel=br|text=fr,ca,eu,wor,us,en,uk,ss,cus
china#screenshot=cn,wor|boxart=cn|cartridge=cn|wheel=cn|text=fr,ca,eu,wor,us,en,uk,ss,cus
england#screenshot=uk,en,wor|boxart=uk,en|cartridge=uk,en|wheel=uk,en|text=fr,ca,eu,wor,us,en,uk,ss,cus
europe#screenshot=eu,wor|boxart=eu|cartridge=eu|wheel=eu|text=fr,ca,eu,wor,us,en,uk,ss,cus
france#screenshot=fr,eu,wor|boxart=fr,eu|cartridge=fr,eu|wheel=fr,eu|text=fr,ca,eu,wor,us,en,uk,ss,cus
...

In our example, we want to retrieve the Japanese media (jp) with the texts in French. We can go through the japan preset by selecting it in the combobox, which offers this configuration:

japan#screenshot=jp,wor|boxart=jp|cartridge=jp|wheel=jp|text=fr,ca,eu,wor,us,en,uk,ss,cus

This may be enough, but if we are demanding, and only want Japanese media images and nothing else with only French texts, nothing prevents us from creating our own preset by adding a line, and indicating:

japan_perso#screenshot=jp|boxart=jp|cartridge=jp|wheel=jp|text=en

It is strongly advised to put in screenshot the country world (wor) because very often it is the only country to offer screenshots. By omitting it you risk recovering no screenshots or very few.

Operating principle When a list of countries is given, ARRM searches in sequence for the existence of a media (image or text) for the given country on screenscraper. If the search is successful, the search stops, otherwise the search continues with the next country.

Noticed By limiting the number of countries, you also limit the chance of finding media, but you can thus make more precise rom sets.

Since version 1.9.1.2 Beta 16, the ROM country priority checkbox allows priority to be given to the media of the country indicated in parentheses in the name of the file
Examples:

 Actraiser (Japan).zip,
 Legend of Zelda, The (Europe) (Rev A).zip,
 Batman Forever (F) [!].zip

The recognized countries are:

AUSTRALIA,A,AU,AUS
BRAZIL,B,BR
CHINA,C,CN,ZH
ENGLAND,EN,UK,GBR
EUROPE,E,EU,EUR
FINLAND,FI,FN
FRANCE,F,FC,FR,FRA
GERMANY,G,DE
GREECE,GR
ITALY,I,IT,ITA
JAPAN,1,J,JP
KOREA,SOUTH KOREA,K,KR
NETHERLANDS,HOLLAND,H,NL
SPAIN,S,ES,ESP
SWEDEN,SW,SWE
USA,4,U,US
WORLD,WOR