Table des matières

Cette page a été déplacée, le nouvel emplacement est interface-en_relooked.

Presentation of the ARRM software interface

We will detail here the 7 panels that make up the ARRM interface

Software configuration (1)

Please refer to the previous chapter which details all tabs of the ARRM configuration panel.

System selection (2)

It can be a network directory (if you are accessing your frontend by network):

or a local disk (if you access the memory card / disk of your frontend connected to your PC):

for ARRM to work with Retropie , the following paths must be respected on Retropie:
  • Roms must be in ~/RetroPie/roms/%system%/
  • The gamelist.xml must be in ~/RetroPie/roms/%system%/gamelist.xml

For Batocera, Recalbox and Retropie you can also specify another temporary directory that will receive the overlays generated, but in this case you will need to copy / paste this content on your Box.

Remember to click on the 'V' buttons to validate the directories. The icons open the directory in your file explorer.

When this option is checked, ARRM overwrites gamelist.xml with the contents of gamelist_ARRM.xml, then loads the system having thus recovered all available tags.
If you open a system with this option checked, remember to save your gamelist.xml again via the Create gamelist.xml button before changing systems or leaving ARRM otherwise you will end up with a gamelist.xml containing all available tags
You can also find gamelist backups in the %appdata%\Nexouille soft\arrm\temp\backup\%system% directory


The Database (list of Roms) (3)

This window that I call the Database contains the information that will be written in the gamelist.xml during its backup / creation. Some fields are editable, but it is better to go through the 'Information Rom' panel that applies input controls.

This database is filled when selecting a system. It will contain the info of the gamelist.xml (if it exists) and the files present in the current system directory (if they did not exist in the existing gamelist.xml)

It is possible to use keyboard shortcuts to navigate more efficiently in the database. These shortcuts are available since version 1914 Beta 6

You can find out about the available shortcuts by clicking on the link shortcuts

Keyboard shortcuts usable on the database.

First select a line by clicking on it, then…

Ctrl + PgUp: Go to the 1st cell of the first line
Ctrl + PgDn: Go to the 1st cell of the last line
Home : Go to the 1st cell of the first line
End: Go to the last cell of the last row
PgUp: Go to previous page
PgDn: Go to next page
Ctrl + → : Go to end of selected line
Ctrl + ← : Go to start of selected line
[A-Z][0-9] : Jumps to the line whose Game name begins with the key pressed
Shift + [A-Z][0-9]: select rows from current position to the row whose Game Name begins with the key pressed (Best with Database sorted by Game Name)
+ : Jump to the next Game Name different from the current one (best with Database sorted by Game Name)
Ctrl + : Switch to the next File Name different from the current one (best with Database sorted by File Name)

Undock / Dock (button): allows you to detach the database from the main form and thus be able to move it and resize it.


View video

Example with the detached database:

Select all (button): Selects all the elements of the database.
Select none (button): Deselects all the elements of the database.
No filter (button): Removes all filters applied to the database.

On this Database we will be able to apply




FILTERS


Check the fields on which you want to perform a filter.

use the scroll bar to access the other fields

Check WITHOUT or WITH if you want to filter the selected fields having ( WITH ) a media or not having one ( WITHOUT )

These filters can be combined with each other by applying the AND / OR operator which will apply to all the conditions checked. The OR operator and most often used. Example: 

boxart_rom<>'' and favoris_rom=true and rating_rom > 0.2
nomjeu_rom like '*zelda*' and map_rom is null
favoris_rom=true and (image_rom is null and manual_rom<>'')
len(description_rom) < 10
substring(nomjeu_rom,1,2) = '19'
The searched strings must be surrounded by single quote (') and not by double quotes (“) If a searched string contains a single quote ('), you must put two single quotes in the query

The fields available for the conditions are: 

adult_rom
annee_rom
arcadesystemname_rom
boxart_rom
boxback_rom
cache_rom
cartridge_rom
core_rom
description_rom
developer_rom
emulator_rom
fanart_rom
favoris_rom
fichier_rom
gameid_rom
gametime_rom
genre_rom
genreid_rom
hash_rom
image_rom
kid_rom
lang_rom
lastplayed_rom
manual_rom
map_rom
marquee_rom
md5_rom
mix_rom
nomjeu_rom
numauto_rom
playcount_rom
players_rom
publisher_rom
rating_rom
region_rom
screenshot_rom
temporary_rom
thumbnail_rom
titleshot_rom
video_rom
wheel_rom

Each condition validated via the Filter button is stored in the ' Query ' combobox and saved in the file located under %appdata%\Nexouille Soft\arrm\database\query_sql.txt (you can edit it and add the conditions you want) You will then be able to select a condition that is already archived.

You can read the condition that was executed by ARRM, in the statusbar

Remember to remove the filter by clicking on 'No filter' after use.


See also : How to filter ROMS according to their country contained in the file name


Please refer to the section : SEARCH




REPLACEMENTS


Please refer to the section : Replacements


ARCADE


Actions on selected Roms (4)

All the actions associated with the buttons in this menu apply to the selected Roms (highlighted) in the Database

This 'Video+Overlay' feature needs the media to be present in the database (boxart, cartridge, wheel, video) because it will recompose a mix (without screenshot) with the media already present, which it will overlay on the video by applying a template. It is therefore necessary that the '4 images' mode of ARRM has been activated. Warning: incompatible with the templates offering screenshots in perspective. We can define a directory dedicated to these videos. It is also possible to put them in the video tag. Specific compression settings for these video + overlays are available in the 'Tools' tab.


A 'template_association_video.txt' file is used to associate templates with systems when creating 'video+overlay'.
By default the new template 'mix_video1' is associated with all systems.
A 'template_association_video.NEXT_PIXEL' file is included containing the associations for the templates of the NEXT_PIXEL theme. Rename it to 'template_association_video.txt' if you want to use it.
A folder reserved for video templates has been created, it is located in the directory: '%appdata%\Nexouille soft\arrm\ressources\templates_video\'
You can retrieve the usual templates located in '%appdata%\Nexouille soft\arrm\ressources\templates\', copy them to this directory ( '%appdata%\Nexouille soft\arrm\ressources\templates_video\' ) and modify them to adapt them to your needs.
When using the 'Video+Overlay' button ARRM checks for the existence of the template_association_video.txt file and applies the video template associated with the current system (auto_template enabled). If the template_association_video.txt file does not exist, ARRM will apply the usual templates (template_association.txt)


* mamedb.org (button): Finds the info of the selected Roms (highlighted) on the site MameDb. This site only gives information relating to the games themselves. The information is rather succinct and it only returns a screenshot.

Example of the contents of the file ' systemes_screenscraper.txt ': 

megadrive|1
genesis|1
mastersystem|2
nes|3
family_computer|3
snes|4
sfc|4
cps1|6
cps2|7
...
gba|12
gamecube|13
gc|13
n64|14
...

'Choose Mix Model' screen

This screen allows you to choose the templates to use. Here you can configure three types of templates: Default (non auto template) , Default (auto template) , System (auto template)

On the left of the screen:

The Default (non auto template) panel indicates the default template that will be used for all scraped systems when the ' Auto template ' checkbox is not checked. To select it, you just have to choose a template from the list and check the button ' Define as default template ' located under the selected template.

On the right of the screen, in the section ' Auto Template Settings ':

The Default (auto template) panel indicates the default template that will be used for all scraped systems when the ' Auto template ' checkbox is checked. To select it, you just have to choose a template from the list and check the button ' Set as default template '.

The System (auto template) panel indicates the template that will be used for the selected system when the ' Auto template ' checkbox is checked. To select it, you just have to choose a template from the list and check the button ' Define as template for' system name ''.

These actions update the file %appdata%\Nexouille soft\arrm\database\template_association.txt

The button ' Edit XML file ' allows you to open the XML file of the selected template in your text file editor and modify it. See the section Create your own template for ARRM

The button ' See Directory ' opens the directory containing the .XML file and the associated image files.

The ' Exit ' button closes this screen and returns to the main screen.

Detail / Modification of a Rom (5)

Please read the section devoted to this subject : Editing game data

The Gamelist (6)

Remember to configure the gamelist options via the gamelist_options tab

You can choose which media TAGs you want to appear in Gamelist.xml. This is explained in Gamelist Tags settings

If you want to use the 'Recompose image' function, it is important to check the 'Use Gamelist_ARRM.xml' checkbox when you load a system in order to have all the media available.

The Status Log (7)

The file 'scrape_log.txt' is positioned in the %appdata%\Nexouille Soft\arrm\temp\ directory

Title screen

You can select the interface language by checking the appropriate flag