Français
General
Scrape
Template
Gestion de Roms
Gamelist
- Sauvegarde du gamelist.xml
Outils
Divers
English
General
Scrape
Template
Roms management
Gamelist
- Saving the gamelist.xml
Tools
Miscellaneous
General
Scrape
Template
Gestion de Roms
Gamelist
Outils
Divers
General
Scrape
Template
Roms management
Gamelist
Tools
Miscellaneous
Please refer to the previous chapter which details all tabs of the ARRM configuration panel.
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 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.
—-
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)
By tapping on a letter on the Database (if sorted in alphabetical order), the index (highlight) will be positioned on the first found game name beginning with that letter.
Undock / Dock (button): allows you to detach the database from the main form and thus be able to move it and resize it.
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
Check the fields on which you want to perform a filter.
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<>'')
The fields available for the conditions are:
* nomjeu_rom * fichier_rom * description_rom * image_rom * rating_rom * annee_rom * developer_rom * publisher_rom * genre_rom * players_rom * cache_rom * favoris_rom * numauto_rom * boxart_rom * screenshot_rom * wheel_rom * video_rom * mix_rom * playcount_rom * lastplayed_rom * md5_rom * core_rom * emulator_rom * cartridge_rom * hash_rom * manual_rom * region_rom * thumbnail_rom * marquee_rom * genreid_rom * fanart_rom * map_rom * titleshot_rom * lang_rom * adult_rom * kid_rom * gameid_rom * arcadesystemname_rom * boxback_rom * gametime_rom * temporary_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
%%nomjeu_rom%% %%fichier_rom%% %%description_rom%% %%image_rom%% %%rating_rom%% %%annee_rom%% %%developer_rom%% %%publisher_rom%% %%genre_rom%% %%players_rom%% %%cache_rom%% %%favoris_rom%% %%boxart_rom%% %%playcount_rom%% %%lastplayed_rom%% %%region_rom%% %%genreid_rom%% %%lang_rom%% %%adult_rom%% %%kid_rom%% %%gameid_rom%% %%arcadesystemname_rom%% %%gametime_rom%% %%temporary_rom%%
fichier_rom like '%(USA)%' nomjeu_rom not like '%[%' and region_rom is not null 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<>'')
The fields available for the conditions are:
* nomjeu_rom * fichier_rom * description_rom * image_rom * rating_rom * annee_rom * developer_rom * publisher_rom * genre_rom * players_rom * cache_rom * favoris_rom * numauto_rom * boxart_rom * screenshot_rom * wheel_rom * video_rom * mix_rom * playcount_rom * lastplayed_rom * md5_rom * core_rom * emulator_rom * cartridge_rom * hash_rom * manual_rom * region_rom * thumbnail_rom * marquee_rom * genreid_rom * fanart_rom * map_rom * titleshot_rom * lang_rom * adult_rom * kid_rom * gameid_rom * arcadesystemname_rom * boxback_rom * gametime_rom * temporary_rom
Each condition/filter validated via the button is stored in the ' Query ' combobox and saved in the file located under %appdata%\Nexouille Soft\arrm\database\query_sql2.txt (you can edit it and add any conditions you want)
You will then be able to select an already archived condition/filter.
The filter is applied to the Database
EXAMPLES :
Apply a modification of the value of a field
In the example above, we apply the Query:
nomjeu_rom not like '%[%' and region_rom is not null
which means that we want to display only the games which do not contain '[' and whose region field is not empty.
In the next combobox we indicate the new value. It can also be a field name from the database, it must then be surrounded by double % exemple :
%%nomjeu_rom%% [%%region_rom%%]
Select the field on which you want to apply modifications, here it will be the field Game Title (nomjeu_rom)
Select (highlight) the games you want to apply the changes to, then click the button to apply the change.
This will change the DB Fields Game Title (nomjeu_rom) so that it becomes nomjeu_rom [region_rom]
On the game ' Ballbllazer ' whose field region_rom = 'us' this will give: Ballblazer [us]
EXAMPLES :
Apply a value replacement on a field
In the example above, we apply the Query (It is OPTIONAL ):
fichier_rom like '%(USA)%'
which means that we want to display only the games whose fichier_rom (file name) contains '(USA)'.
Select the field on which you want to apply modifications, here it will be the field Genre (genre_rom)
Select (highlight) the games you want to apply the changes to, then click the button to apply the change.
This will replace in the DB Fields Genre (genre_rom) the string 'Tir' by 'Shoot'
%%nomjeu_rom%%
Filter 'Arcade Clone' (button) : Allow you to find and filter Clones of Roms for Arcade systems. The line (Clone of: rom_name → rom_title) is added in the 'temporary_rom' field. The filter (temporary_rom like '*Clone Of:*') is added to the filters of the Query combobox.
' Highlight the Roms whose core … ' (Combobox): Select the desired Core (combobox), then click on the green checkmark to highlight the Roms whose selected core is the best. See tutorial : Find the best emulator / core for Arcade games
All the actions associated with the buttons in this menu apply to the selected Roms (highlighted) in the Database
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)
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 ...
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%\roaming\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.
The file 'scrape_log.txt' is positioned in the '%appdata%\Nexouille Soft\arrm\temp\logs_arrm' directory of the selected system.