Différences

Ci-dessous, les différences entre deux révisions de la page.

--- settings-en [2020/06/26 17:21] – [Images Options] nexusone13
+++ settings-en [2023/06/03 17:38] (Version actuelle) – modification externe 127.0.0.1
@@ Ligne 1: / Ligne 1: @@
+#REDIRECT arrm_relooked_en:settings-en_relooked
 ~~NOCACHE~~
 ====== ARRM software setting ======
+__**Video Tutorial**__
+{{ youtube>DcewFsD2-Wo?medium }}
+\\
+[[https://youtu.be/DcewFsD2-Wo|View video]]
 When you run ARRM, you get this main screen (interface)
@@ Ligne 6: / Ligne 16: @@
 {{ARRM:Interface:interface_detail_settings_en.png?direct}}
-Before embarking on the manipulation of gamelists, roms and other scraps, it is necessary to configure the application so that it can meet your configuration and your needs.
+Before embarking on the manipulation of gamelists, roms and other scrapes, it is necessary to configure the application so that it can meet your configuration and your needs.
 In the screenshot above, the setup part is surrounded by red to highlight it for this wiki. We will dwell on the 6 tabs that make up the setup part.
 ----
+===== Systems and overlays folders =====
+{{arrm:interface:tab_systemes_en.png?direct}}
+  * **Roms Folder** : Enter here the path to the ROM directories (network or local).
+It can be a network directory (if you are accessing your frontend by network):
+     * For Batocera: \\batocera\share\roms
+     * For Recalbox: \\recalbox\share\roms
+     * For Retropie: \\retropie\roms
+or a local disk (if you access the memory card / disk of your frontend connected to your PC):
+     * E:\recalbox\share\roms (if you access the memory card / disk of your recalbox connected to your PC
+<note warning>
+ 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 **
+</note>
+  * ** Directory of overlays ** (textbox): Specify here the path to the root directory that will contain the overlays. :
+    * For Batocera: \\batocera\share
+    * For Recalbox: \\recalbox\share
+    * For Retropie: \\retropie  (or \\retropie\configs if access to \\retropie is denied)
+<note important> If you choose \\retropie\configs, it will be necessary to modify the ** overlays_path.txt ** file. See [[bezels_en|How to retrieve overlays of systems and games]] for more details </note>
+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.
+    * With Recalbox the generated directories will be '** overlays **' and '** system **' to be copied in '**\\recalbox\share **'
+    * With Batocera the generated directory will be '** decorations **' to copy in '** \\batocera\share **'
+    * With Retropie the generated directory will be '** configs **' to copy in '**/opt/retropie **' on your Retropie
+     Remember to click on the '<color #22b14c>**V**</color>' buttons to validate the directories. The {{:arrm:eye-icon-1481.png?direct}} icons open the directory in your file explorer.
+  * **Extensions** : displays the list of extensions recognized for this system. Only the files containing these extensions will be displayed in the database. This list is powered by the file //**% appdata%\Nexouille soft\arrm\database\systems_extensions.txt **// which contains the extensions recognized by Recalbox, Batocera AND Retrope. If you want to remove/add extensions, please refer to the files '_lisezmoi.txt/_readme.txt' for Recalbox and '_infos.txt' for Batocera present in each system directory that contains the list of recognized extensions. You can edit this file via the configuration panel, 'General Options' tab, 'Edit Extensions' button. You have to restart ARRM to take effect. For more information :** [[add_extensions_en|ARRM does not display all my games. How to add an extension?]]**
+  * **Click to edit** (label): allows to indicate the systems which must be treated in **Folder Mode**  or in **Standard Mode** (file mode). See [[file_or_folder_mode-en|Manage certain systems as a folder or file]]
+----
@@ Ligne 20: / Ligne 81: @@
   * ** Disable music ** (checkbox): removes intro and outro music from the application
-  * ** End scrap alert ** (checkbox): allows to play a sound at the end of scrap
+  * ** End scrape alert ** (checkbox): allows to play a sound at the end of scrape
-  * ** Image directory name ** (textbox): name of the directory containing the images retrieved by the scraper.
+  * ** Preview Medias ** (checkbox): (<color #ed1c24> since version 1.9.0.1 Beta 3 </color>) When checked, allows you to automatically preview existing media (locally) for the ROM selected. You can move this preview window. Its location is saved when it is closed. Here is the window that appears when you select a ROM and this option is checked:
-      * For Recalbox & Batocera: downloaded_images
+{{:arrm:functionality:media_preview_en.png?direct|}}
-      * For Retropie: images or media
+<note> If you experience slowdowns, please uncheck this **Media Preview** option and click the ** Media ** button in the ** ROM Info ** panel to bring up the **Media Preview form** on each ROM. </note>
-      * You can set as directory name a path like this : 'media/images'
+  * ** Check if the media exists ** (checkbox): When loading the gamelist, checks if the referenced media exist locally, otherwise the media reference is deleted from the database <color #ed1c24>(from the version 1882 beta 12) </color>
+  <note>
+If your gamelist is already finalized, you can disable this option to speed up the loading of the gamelist in ARRM
+</note>
+  * ** Find missing images** (checkbox): When a gamelist.xml is loaded, if Media Tags are empty, ARRM tries to find the missing media locally. If the loaded system does not have a gamelist.xml, you must save the empty gamelist.xml, then re-open it so that ARRM tries to find the missing media locally.
+<note important>Warning: this greatly slows down the loading of the gamelist.xml</note>
+<note>
+If your gamelist is already finalized, you can disable this option to speed up the loading of the gamelist in ARRM
+</note>
+  * ** 4 images mode activation** (checkbox): By checking this box you get the 4 images (screenshot, box, cartridge and wheel). During a scrape these 4 images are recovered separately, you can use the button 'recompose image' to recreate, at leisure, your mix or other formats without having to re-scrape. The image retained in the gamelist.xml will be the one chosen in 'image Options' configuration tab. The counterpart being the place a little more important occupied by the images and a longer duration of scrape.
+<note>
+To benefit from all the features of ARRM, it is advisable to activate 4 images mode.
+</note>
-  * ** Videos Directory name ** (textbox): name of the directory containing the videos retrieved by the scraper.
+  * **Activate Cache** (checkbox) : makes it possible to keep in a cache the textual information recovered during a Scrape. Can be used for example following a crash during a scrape or a missing gamelist.
-    * You can put the same directory as the images folder
-    * You can also put as directory name a path such as 'media/videos'
   * ** Edit No MD5 ** (button): open the file **//%appdata%\Nexouille soft\arrm\database\crc_no_calcul.txt//** containing the list of file extensions on which MD5 should not be calculated
@@ Ligne 45: / Ligne 120: @@
   * **Assignment of media Screenscraper + Media order** (button) (from 1.8.1.6): Goes to the page that allows you to assign the Screenscraper media to the different ARRM TAGs and to affect the order in which the media images and texts must be recovered in priority on Screenscraper. [[media-assignation-en|see the dedicated section]].
-  * ** Extra Tag + Default Image ** (button): Accesses the configuration menu for recovery of boxart, screenshot, wheel, video, cartridge, mix and setting custom tag setup. By activating the recovery of the boxart, screenshot, wheel and cartridge, you can use the button 'recompose image' to recreate your mix or other formats without having to re-scrape on the Internet. You can also choose default images that will take place when no image has been found. See below the configuration screen that appears when you click on this button:
+  * **Assignment of media Launchbox** (button) (from 1.9.0.2 Beta 11): Goes to the page that allows you to assign the Launchbox media to the different ARRM TAGs. [[media-assignation-launchbox-en|see the dedicated section]].
+  * **Profile (Save/Load) ** (button) <color #ed1c24>(since 1.9.2.8 Beta 2)</color>: Allows you to create and restore profiles that contain ARRM settings. See: [[profile-scrape-en|Manage scrape profiles]]
-{{ARRM:functionality:arrm_tag_default_en.png?direct}}
+----
+===== Folders =====
-  * ** Activation of recovery of 4 images + TAG Custom ** (checkbox): By checking this box you get the 4 images (screenshot, box, cartridge and wheel). During a scrap these 4 images are recovered separately, you can use the button 'recompose image' to recreate, at leisure, your mix or other formats without having to re-scrape. The image retained in the gamelist.xml will be the one chosen in 'image Options' configuration tab. The counterpart being the place a little more important occupied by the images and a longer duration of scrap.
+{{arrm:options:options_folders_options_en.png?direct}}
+ in which you can configure the paths for each of the media (image, screenshot, boxart, wheel, cartridge, titleshot, map, fanart, manual, video)
-  * ** Download video (video TAG) ** (checkbox): By checking this box you download the video of the ROM in the image directory. This video will appear in the gamelist.xml with the tag <video>. Attention only currently Retropie and Batocera (since 5.22 version) know how to manage this tag (Recalbox does not manage it for the moment)
+It could be like this :
-  * **Section Tags Custom **  : The default tags used in ARRM (boxart, screenshot, wheel, mix, cartridge, video); The officially recognized tags in emulationstation are image, marquee, thumbnail and video. <color #ed1c24>It is strongly advised not to change the names of the tags in this page.</color>
+  * downloaded_images
+  * media/images
+  * media/screenshot
+  * media/cartridge
+  * manuals
+  * media/manual
+  * media/videos
+  * etc...
-  * ** Default Image Section **: Choose a default image that will take place if no image is found. Its use is reserved for very particular cases. In common usage it is best not to put a default image.
+Since version **<color #ed1c24>1923 Beta 5</color>** it is possible to configure the **suffixes** that you want to put at the end of recovered media files.
+Example :
+   *007-GoldenEye**-boxart**.png
+   * Looney Tunes - Duck Dodgers (E) [!]**-image**.png
+By default the suffixes are:
+   *-image
+   *-screenshot
+   *-boxart
+   *-wheel
+   *-cartridge
+   *-titleshot
+   *-map
+   *-fanart
+   *-manual
+   *-video
+   *-mixvideo
+   *-music
+   *-boxback
+   *-extra1
+It is possible not to add a suffix by leaving the textbox empty.
+<note warning>If you use a single folder for all your media, specify different suffixes so as not to overwrite your images.</note>
+When scraping media, these suffixes will be applied to the recovered media.
+<note important>Use the scroll bar to access the rest of the media / suffix directories</note>
 ----
-===== Scrap Options =====
+===== Scrape Options =====
 {{ARRM:Options:options_scrap_options_en.png?direct}}
-  * ** Clean rom ** (checkbox): Cleans the name of the game during a scrap, a search by MD5 or when adding the disk number. ARRM removes the characters between () and [] and moves the article (the, a, an, this... and those of the other languages Spa/Por/Ger/Fre) to the end of the name of the game. Examples:
+  * ** Clean up rom ** (checkbox): Clean up the name when a game is saved (following a scrape or manual saving). <color #ed1c24>Please note</color> that the ** Game name ** checkbox must be checked in the ** Information Rom ** panel for this modification to be taken into account. ARRM removes the characters between () and [] and moves the articles (the, the, and those of other languages ES / POR / GER / FR) at the end of the name of the set. Examples:
     * The Legend of Zelda: Ocarina of Time Legend of Zelda, The: Ocarina of Time
     * The Bard's Tale -> Bard's Tale, The
   * ** Add disk ** (checkbox): When scrape or check of the name with MD5, ARRM adds the diskette number, Side number, and AGA/CD32 (for Amiga) at the end of the name (if this information is present in the file name). The elements sought by ARRM in the filename are: disc/disk/tape/side/part
+\\
+<note>
+The **add disk** checkbox now relies on the** multi_part_add_disk.txt** file to find and retrieve multi-disk information in the names of files \\ \\
+This file is located in \\ \\
+**%appdata%\Nexouille Soft\arrm\database\multi_part_add_disk.txt** \\
+\\
+Content of file looks like this : \\ \\
+<code>
+disc|disk|file|part|side|tape
+</code>
+\\
+</note>
   * Examples:
@@ Ligne 79: / Ligne 208: @@
   * ** Keep rom name ** (checkbox): When scrape or adding the disk number uses the name of the Rom file as the name of the game. This disables the 'Add disk' option because the Disk/K7/Side is already included in the rom file name
-  * ** Auto search TGDB ** (checkbox): Automatically searches on the exact name of the game without asking any questions on TheGamesDB.net. Be careful, with the new API the automatic search is no longer as accurate. It is best not to activate it.
+  * ** Add language ** (checkbox): Allows to Find languages in the file name when loading the gamelist and assigns it to the **Language** field if it is empty. Also works with the **Check Roms** button.  Example : Daffy Duck in Hollywood (Europe) (**En,Fr,De,Es,It**).zip
   * ** Add Country ** (checkbox): Add at the end of the name of the game the country if it is present in the file, or retrieved on Screenscraper if the MD5 of the game was filled.
@@ Ligne 95: / Ligne 224: @@
   * ** No text ** (checkbox): During a scrape, does not take into account the textual information from the scraper. Useful if you have modified this information and do not want to be overwritten.
-  * **Force MD5 before scraping** (checkbox) : allows to calculate the MD5 (if not already present), before the scrap. The research of information will be done in priority via the MD5 of the Rom.
+  * **Force MD5 before scraping** (checkbox) : allows to calculate the MD5 (if not already present), before the scrape. The research of information will be done in priority via the MD5 of the Rom.
-  * ** Pad to Keyboard cfg ** (checkbox): When scraping, if this option is activated, ARRM retrie  ves the configuration file .p2k.cfg from the current Rom. The file is stored in the directory where the rom is located and is called '** rom_filename.extension.p2k.cfg **'. This file is used to assign keyboard keys to the joypad. Useful for computer emulators that sometimes use keyboard keys in games. See explanations: https://recalbox.gitbook.io/documentation/v/francais/user-avance/configurations/pad-to-keyboard
+  * ** Pad to Keyboard cfg ** (checkbox): When scraping, if this option is activated, ARRM retrieves the configuration file .p2k.cfg (or .keys for Batocera) from the current Rom. The file is stored in the directory where the rom is located and is called '** rom_filename.extension.p2k.cfg **'. This file is used to assign keyboard keys to the joypad. Useful for computer emulators that sometimes use keyboard keys in games. See explanations: https://wiki.recalbox.com/en/advanced-usage/pad-to-keyboard
-  * ** Ignore Local Search ** (checkbox): When performing a scrape, if this option is enabled, ARRM ignores the search for a missing image locally in the scraped system images directory. This option is activated automatically when using 'Mix'Me'. If you scrap a system for the first time check this option to speed up the process.
+<note>
+If you want to convert Recalbox .p2k files into Batocera compatible .keys files I invite you to use the [[https://github.com/soaresden/RecopierBox/|RecopierBox]] utility from Soaresden, which also offers other utilities for Recalbox / Batocera
+</note>
+  * ** World Flag ** (checkbox): Forces the addition of the World flag when no region is found.
+  * **Compress video** (checkbox) : If checked, compresse video with handbrake. Compressing the videos also makes them compatible with the OMX player on Retropie. See : [[compress_video_en|Compress videos to save storage space]]
+  * ** Video+Overlay -> Video TAG** (checkbox): When using the 'Video+Overlay' button, assign the created 'video+ overlay' video to the VIDEO TAG in the database.
+  * ** PC / DOS: files mode  **: The systems to be managed as directories (PC, DOS, Windows, PS3...) are indicated in the file **systemes_as_folder.txt** located in **%appdata%\Nexouille Soft\Arrm\database\**. This checkbox allows you to override and force file mode on these systems.
+  * ** GamesDB Music **: Finds music on the GamesDatabase site, stores it in the   directory defined in Folders, and adds a <music> tag in the gamelist. Usable for example with my game JVB_QUIZZ.
+  * ** SpeedUp ** (checkbox): Accelerates image processing by removing the validity check from the recovered image file (file in the correct png format etc). When loading the 'gamelist.xml', do not check if the images referenced in the 'gamelist.xml' file exist locally.
+  * ** Topstaff -> Favorites **: Put in favorite the games selected by the Screenscraper team
+  * ** Use GameID **: Uses in priority the GameID (if present in the database) to find the games in Screenscraper.
+  * ** ONLY use ARRM detection of 'viewport' for 'Bezels' **: If checked, ARRM tries to automatically detect the coordinates of the 'viewport' of the downloaded 'Bezel' in order to create the overlay configuration files, otherwise it will use the coordinates provided by the ScreenScraper API.
+  * ** Auto Hide cue / gdi / m3u ** (checkbox) :  <color #ed1c24>** from version 1.8.9.2 beta 3 ** </color>: allows, when loading a system, to hide files referenced in .cue / .gdi / .m3u files
+  * **Without Artwork only**  (checkbox) Since version 1.9.0.3 beta 11 you can only scrape the missing media (artworks) by checking **Without Artwork only** in the ** Scrape Options ** tab. Only the missing media (artworks), checked in the ** Images options ** tab will be recovered. In the scrape engines, only these missing media (artworks) will be presented and selectable. See : [[scrape_missing_artwork_only_en|Only scrape missing Artworks]]
+  * **Ignore existing MD5** (checkbox): When scraping on Screenscraper, ignores the MD5 that already exists in the gamelist / gamecard.
+  * **ROM country priority** (checkbox): <color #ed1c24>Since 1.9.1.2 Beta 16</color> Allows priority to be given to the media of the country indicated in parentheses in the file name \\
+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 \\
+  * **Translate description** (checkbox): **<color #ed1c24>Available since version 1.9.1.3 Beta 11</color>**, allows you to translate, in bulk or during a scrape, game descriptions into the language of your choice. See wiki: [[translate_description_en|Translate descriptions]]
+  * ** Ignore Local Search ** (checkbox): When performing a scrape, if this option is enabled, ARRM ignores the search for a missing image locally in the scraped system images directory. This option is activated automatically when using 'Mix'Me'. If you scrape a system for the first time check this option to speed up the process.
@@ Ligne 113: / Ligne 299: @@
  {{ARRM:functionality:arm_mixorscreen_en.png?direct}}
+  * **Media order (combobox)** : allows you to select the country preset, which contains the order of the countries in which the media (images and texts) must be searched. See the dedicated section. Click on the button (with the arrows) to update the combobox (if the presets have been modified / added)
 ----
@@ Ligne 121: / Ligne 310: @@
 {{ARRM:Options:options_images_options_en.png?direct}}
-You can select here the type of image that will be used in your frontend (Recalbox, Batocera, Retropie etc.) to represent the game. 5 choices are possible:
+<note important> Use the scroll bar to access the rest of the media directories </note>
-  * Screenshot
-  * Boxart
+  * **Without Artwork only**  (checkbox) Since version 1.9.0.3 beta 11 you can only scrape the missing media (artworks) by checking **Without Artwork only**in the ** Scrape Options ** tab. Only the missing media (artworks), checked in the ** Images options ** tab will be recovered. In the scrape engines, only these missing media (artworks) will be presented and selectable. See : [[scrape_missing_artwork_only_en|Only scrape missing Artworks]]
-  * Marquee
-  * Mix
+  * ** 4 images mode activation** (checkbox): By checking this box you get the 4 images (screenshot, box, cartridge and wheel). During a scrape these 4 images are recovered separately, you can use the button 'recompose image' to recreate, at leisure, your mix or other formats without having to re-scrape. The image retained in the gamelist.xml will be the one chosen in 'image Options' configuration tab. The counterpart being the place a little more important occupied by the images and a longer duration of scrape.
-  * Video
+<note>
+To benefit from all the features of ARRM, it is advisable to activate 4 image mode.
+</note>
+  * **No image, only texts** (checkbox): If checked, the '**NONE**' choice will be applied to the **TAG** image choice combobox. ARRM only retrieves textual information from the scraping site as well as the media checked in '**Force Media Download**'
+You can select in the **combobox (Choose the image TAG you want)** the image that will be assigned to the **image TAG** and which will be the one used in your frontend (Recalbox, Batocera, Retropie etc) to represent the game:
+The combobox allows you to choose between these different media:
+  * NONE (if you don't want to assign or modify the image TAG)
+  * BOXART
+  * BOXBACK
+  * CARTRIDGE
+  * EXTRA1
+  * FANART
+  * MAP
+  * MIX (choice MIX allows to apply a MIX template)
+  * MIXRBV1 (corresponds to an already made MIX proposed by Screenscraper)
+  * MIXRBV2 (corresponds to the second MIX already made proposed by Screenscraper)
+  * ROUND WHEEL
+  * SCREENSHOT
+  * TITLESHOT
+  * WHEELS
+<note>
+Be careful when you select one of the elements (except MIX, MIXRBV1, MIXRBV2), the media in question will be checked automatically in the **Force Media Download** section</note>
+<note>By selecting **NONE** as **image TAG**, no image will be assigned to the **TAG Image**. The '**No image, only texts'** will be checked,  the '**Enable 4-picture mode**' mode will also be disabled. However, you can force the recovery of certain images by clicking on the images you want in the '**Force Media Download**' section.</note>
+For **Screenscraper** and **Launchbox**, you can associate these Media with those used on Screenscraper and Launchbox. See [[media-assignation-en|Screenscraper media assigment with ARRM]] and [[media-assignation-launchbox-en|Launchbox assigment with ARRM]]
-If the option '4 images' is activated, the 4 images will be recovered (Screenshot, Boxart, Marquee, Cartridge) but only the one corresponding to the option checked (among Screenshot, Boxart, Marquee, Mix) will be the default image of the game in the frontend (tag : image).
+<note warning>
+If the option '4 images' is activated, the 4 images will be recovered (Screenshot, Boxart, Marquee, Cartridge) but only the one corresponding to the combobox (**Choose the image TAG you want**) will be the default image of the game in the frontend (tag : image).</note>
 By default ARRM retrieves the images of the games in the versions corresponding to the selected language on the interface (except the Russian which is not present on Screenscraper). It is however possible to change the search order via the form 'Assignment of Media 'Screenscraper' + Media order'. See this chapter: [[media-assignation-en#order_of_priority_of_the_media_according_to_the_country|Screenscraper media assigment with ARRM]]
-  * ** Box ** (checkbox): If checked, ARRM tries to recover on the selected scrape site the 2D Boxart of the game. If you want the 3D Boxart, please checked also the Box 3D checkbox.
-  * ** Box 3D ** (checkbox): If this option is checked, ARRM retrieves the 3D box of the game (only on Screenscraper) if not then 2D
+  * **BOX 3D**: allows you to recover the Boxart in 3D when scraping on **HFS-DB** / **GameTDB**
-  * ** Screenshot ** (checkbox): If checked, ARRM attempts to retrieve the game's Screenshot from the selected scrape site
+  * **Custom Marquee**: allows you to create a mini marquee with integrated wheel/logo based on the marque_fanart (marquee) template. You must have the Fanarts and Wheel/Logo of the games to process and do a '**Recompose Image**'. See: [[custom_marquee_en|Generate Custom Marquees]]
-    * **Mix RB V1** (checkbox) : Allows to recover as screenshot the Mix V1 proposed by Screenscraper. Available only if V2 API is enabled. \\ {{arrm:mixrbv1.png?direct}}
-    * **Mix RB V2** (checkbox) : Allows to recover as screenshot the Mix V2 proposed by Screenscraper. Available only if V2 API is enabled. \\ {{arrm:mixrbv2.png?direct}}
-    * ** Screen Title ** (checkbox): Allows to recover as screenshot the Screen Title proposed by Screenscraper. You can check 'Screen Title' and select Mix (the screenshot will be that of the Screentitle). \\ {{arrm:sstitle.png?direct}}
-  * ** Marquee ** (checkbox): If checked, ARRM attempts to retrieve the Marquee / Game Title from the selected scrape site
-  * ** Mix ** (checkbox): If checked, ARRM creates a Mix with the images recovered on the scrape site by applying one of the templates proposed by ARRM.
+__ ** Force Media Download ** __
-  * ** Video ** (checkbox): If checked, ARRM retrieves only the video of the game (only on Screenscraper) that it places in the videos directory of the scraped system. If you wish to download the video as well as the other scrap informations, check the '**video**' checkbox via the '**Extra Tag + Default image + Video**' menu or check the  ** Download video (video TAG) ** checkbox in this tab. This option does not require the activation of the '4 images' mode
-  * ** Download video (video TAG) ** (checkbox): If checked, during the scrap, ARRM also download the video of the game (only on Screencraper) that it places in the videos directory of the scraped system. Same as checkbox '** video **' of the menu '** Extra Tag + Default image + Video **'
+If you want to force the recovery of other media/tags during the scrape, you must force their recovery by checking the desired media below. (They will also be written in the gamelist)
-  * ** No image, only texts ** (checkbox): If checked, ARRM only retrieves the text information on the scrape site.
+{{ARRM:Options:force_media_download_en.png?direct}}
-  * ** Media order ** (combobox): allows you to select the country preset, which contains the order of the countries in which the media must be searched (images and texts). [[media-assignation-en#order_of_priority_of_the_media_according_to_the_country|See the dedicated section]]. Click on the button (with the arrows) to update the combobox (in case presets have been modified / added)
-  * ** Overlays ** (checkbox): If checked, ARRM retrieves the overlays of the games (only on Screenscraper). Overlays are stored in the overlays directory you specified. If you only want to recover overlays, check 'Overlays' and 'No image' and start the scrap.) ARRM creates the configuration files automatically by detecting the areas of the viewport For much more detail see the dedicated chapter : [[http://www.jujuvincebros.fr/wiki/arrm/doku.php?id=bezels_fr|How to recover overlays of systems and games]]
+  * ** Get the video (video TAG) ** (checkbox): If checked, during the scrape, ARRM also download the video of the game (only on Screencraper) that it places in the videos directory of the scraped system.
+  * ** Get the Manual ** (checkbox): If checked, when scraping, ARRM also retrieves the game manual (the priority of languages and those of textual media) (only on Screencraper) which it places in the directory of scraped system manuals. This feeds the 'MANUAL' Tag in the gamelist.xml
+  * ** Get the Map ** (checkbox): If checked, when scraping, ARRM also retrieves the game's Map (if existing) (only on Screencraper) which it places in the Maps directory of the scraped system. This feeds the 'MAP' Tag in the gamelist.xml
+  * ** Get the Fanart ** (checkbox): If checked, when scraping, ARRM also retrieves the game's Fanart (if existing)  which it places in the Fanart directory of the scraped system. This feeds the 'FANART' Tag in the gamelist.xml
+  * ** Get the Titleshot ** (checkbox): If checked, when scraping, ARRM also retrieves the Titleshot of the game (if existing) which it places in the Titleshot directory of the scraped system. This feeds the 'TITLESHOT' Tag in the gamelist.xml
+  * ** Get the Boxback ** (checkbox): If checked, when scraping, ARRM also retrieves the Boxback (2D back side of the boxart) of the game (if existing)  which it places in the Boxback directory of the scraped system. This feeds the 'BOXBACK' Tag in the gamelist.xml
+  * ** Get the Extra1 ** (checkbox): If checked, when scraping, ARRM also retrieves the media corresponding to the Extra1 tag defined in '** Media assignment' Screenscraper '+ Media order **', that ' it places in the directory of Extra1 of the scraped system. This allows the use of the Extra1 media in the ARRM templates. Possible use: media 'marquee' (screenscraper) associated with Extra1 allows you to display the marquee arcade in templates with arcade cabinets. Extra1 will not appear in the gamelist, because ARRM is responsible for checking if it is present in the directory dedicated to Extra1
+  * **Round Wheel (HFSDB / Screenscraper)** (checkbox): <color #ed1c24>available since 1913 Beta 4</color>. If checked, retrieves **Round Wheels** from HFSDB and Screenscraper in the **wheels** directory with the suffix **-wheelround**. For Screenscraper the type (carbon or steel) can be selected in the **Assignment media Screenscraper** module. This media is not saved in the gamelist. ARRM finds the media if it is present in its dedicated directory
+  * ** Hyperspin Theme ** (checkbox): If checked, when scraping, ARRM also retrieves the Hyperspin Theme as a .zip file (only on Screencraper) which it places in the theme directory of the scraped system. There is no tag in the gamelist for the hyperspin 'theme
+  * ** Get the Screenshot ** (checkbox): If checked, when scraping, ARRM also retrieves the Screenshot of the game (if existing) (only on Screencraper) which it places in the Screenshot directory of the scraped system. This feeds the 'SCREENSHOT' Tag in the gamelist.xml
+  * ** Get the Boxart ** (checkbox): If checked, when scraping, ARRM also retrieves the Boxart of the game (if existing) (only on Screencraper) which it places in the Boxart directory of the scraped system. This feeds the 'BOXART' Tag in the gamelist.xml
+  * ** Get the Wheel ** (checkbox): If checked, when scraping, ARRM also retrieves the game's Wheel (if existing) (only on Screencraper) which it places in the Wheel directory of the scraped system. This feeds the 'WHEEL' Tag in the gamelist.xml
+  * ** Get the Cartridge ** (checkbox): If checked, during the scrape, ARRM also recovers the Game Cartridge (if existing) (only on Screencraper) which it places in the Cartridge directory of the scraped system. This feeds the 'CARTRIDGE' Tag in the gamelist.xml
+<note important> If you want to retrieve one or more of these items from the '** Force Media Download **' section, you just need to check one or more of these items and check the '** No image , only texts ** '. During the scrape, only the textual information as well as the checked media will be recovered. </note>
+  * ** Overlays ** (checkbox): If checked, ARRM retrieves the overlays of the games (only on Screenscraper). Overlays are stored in the overlays directory you specified. If you only want to recover overlays, check 'Overlays' and 'No image' and start the scrape.) ARRM creates the configuration files automatically by detecting the areas of the viewport For much more detail see the dedicated chapter : [[http://www.jujuvincebros.fr/wiki/arrm/doku.php?id=bezels_fr|How to recover overlays of systems and games]]
     * ** {{:arrm:eye-icon-1481.png?direct}} ** (bouton) : Opens the directory containing the overlays models
   * ** Dev ** (checkbox): Allows you to recover an overlay image with the viewport area detected by Arrm surrounded by yellow. This will detect and correct overlay errors.
@@ Ligne 165: / Ligne 411: @@
-  * ** Manual ** (checkbox): If checked, ARRM retrieves the game manual (only on Screenscraper) and saves it in a subfolder named 'manuals'
+  * ** Delete unused images files ** (button): Erase all images from the current system folder not associated with a Rom file in the gamelist.xml. If several systems are selected, the deletion will be done on the media folders of each system.
-  * ** Cartridge ** (checkbox): If checked, ARRM attempts to retrieve the cartridge of the game.
-  * ** Delete unused images files ** (button): Erases all images in the current system folder that are not associated with a Rom file in the gamelist.xml
-  * ** Show Mix model ** (button): Displays the template selection menu used with the 'Mix' option
+  * ** Default Image + Video ** (button): (<color #ed1c24>Since 1.9.0.2 Beta 15</color>) When a scrape finds a ROM but the Boxart, Screenshot, Cartridge, Wheel and Video media are missing, it is possible to display a substitute image / video. To do this, you must check the ** Activation of default images ** checkbox.
+{{ARRM:functionality:arrm_tag_default_en.png? Direct}}
+<note> If all of these four media (Boxart, Screenshot, Cartridge, Wheel) are empty following a scrape, the replacement images will not be used </note>
 ----
@@ Ligne 195: / Ligne 438: @@
   * ** Remove sortname tag** (checkbox): doesn't write the sortname tag in the gamelist.xml
-**<color #ed1c24>__Note__</color>** : ARRM uses this tag, adding an index before the name in the <sortname>, in order to be able to sort the database according to certain criteria. The counterpart is that, in your Frontend, this cancels the possibility of making a 'jump to a given letter'. If you wish to continue to make jumps to a given letter in your frontend, you must check this checkbox ** No sortname tag ** and save your gamelist.xml for consideration.
+<note>ARRM uses this tag, adding an index before the name in the <sortname>, in order to be able to sort the database according to certain criteria. The counterpart is that, in your Frontend, this cancels the possibility of making a 'jump to a given letter'. If you wish to continue to make jumps to a given letter in your frontend, you must check this checkbox ** No sortname tag ** and save your gamelist.xml for consideration.</note>
-  * ** Backup old gamelist ** (checkbox): Make a backup of your old gamelist.xml in the backup folder of the selected system before saving the new one.
+  * ** XML in uppercase ** (checkbox): When saving the gamelist.xml the fields ** Game name **, ** Description **, ** Developer **, ** Publisher **, ** Genre ** are capitalized.
+<note warning>
+To go back to lower case you will have to re-scrape the textual information.
+</note>
+  * ** Add the 'temporary' tag ** (checkbox): Allows saving in the gamelist the <temporary> tag used by ARRM to store certain information used in ARRM processing (roms clones etc ...)
+  * ** Core / Emulator per game ** (checkbox): On Batocera, allows saving the core / emulator per game in a text file located in  **%appdata%\Nexouille soft\arrm\temp\batocera.conf\batocera.conf.%system%.txt**.
+It will suffice to copy the lines of this file into your batocera.conf file.
+Click on the {{:arrm:eye-icon-1481.png?Direct}} icon to access the directory containing this file generated by ARRM. See [[emulator_core_en|Change emulator and core by game]]
+  * ** Retroarch Surcharge ** (checkbox): On Recalbox, the forcing of Emulators / Cores can be done via a Retroarch overload. See [[emulator_core_en#recalbox_specificity|Change emulator and core by game]]
+  * ** Backup old gamelist ** (checkbox): Make a backup of your old gamelist.xml in the backup folder (%appdata%\Nexouille soft\arrm\temp\backup\%systeme%) before saving the new one.
   * ** Auto Save Gamelist ** (checkbox): Automatically backs up the entire current gamelist.xml file during a system change, when you exit the application or when you click 'Create gamelist.xml'
@@ Ligne 206: / Ligne 463: @@
   * ** ZIP gamelist.xml ** (checkbox): When creating the gamelist.xml a gamelist.zip file is created.
+  * ** ScummVM folders ** (checkbox): When creating gamelist.xml, if you are using Batocera, and if this checkbox is checked, ARRM will automatically create <folder> tag  with informations and image from the ScummVM game like this :
+<code>
+<folder>
+    <path>./leisure suit larry 1 - in the land of the lounge lizards.scummvm</path>
+    <name>leisure suit larry 1 - in the land of the lounge lizards (floppy dos vga remake)</name>
+    <image>./media/images/lsl1sci-mix.png</image>
+    <desc>Leisure Suit Larry 1: In the Land of the Lounge Lizards is a remake of the first game in the Leisure Suit Larry series. It introduces a new interface. Instead of typing commands, the player performs the desired actions by choosing appropriate icons, and then clicking on objects on the screen to interact with them. The graphics are now 256 color VGA. There is also much more music than in the original version, and it supports more advanced sound formats.</desc>
+</folder>
+</code>
+  * **ARRM folders** (checkbox) : When saving the gamelist.xml, allows ARRM to automatically create <folder> tags if it finds the following files in the directories current system: 'folder-name of the folder.png' and 'folder-name of the folder.txt'. Uncheck if you use your own <folder> tags. See [[custom_subfolder_en|Customize subfolders with image and description]]
   * ** Open created xml ** (checkbox): Open with, your default text editor, the file gamelist.xml after its backup / creation.
-  * ** Backup all gamelists ** (button): Create a backup folder in each system folder and create a copy with the date and time of each gamelist.xml. Make sure to make a backup before starting to edit your gamelist.xml
+  * ** Backup all gamelists ** (button): Create a backup folder in folder %appdata%\Nexouille soft\arrm\temp\backup\%systeme% and create a copy with the date and time of each gamelist.xml. Make sure to make a backup before starting to edit your gamelist.xml
+** Export gamelist as **
+See dedicated section : [[export_gamelist_en|Export gamelist in Hyperspin, Pegasus, AttractMode format]]
+  * ** Hyperspin ** (checkbox): When saving the gamelist.xml via the 'Create gamelist.xml' button, a **% system% .xml ** file is created in the current system directory at format expected by Hyperspin.
+Example of Hyperspin XML file for the snes (** snes.xml **):
+<code>
+<?xml version="1.0" encoding="utf-8"?>
+<menu>
+  <header>
+    <listname>snes</listname>
+  </header>
+  <game name="bounty bob strikes back! (usa)">
+    <description>Bounty Bob Strikes Back</description>
+    <score>4</score>
+    <year>1984</year>
+    <dev>Big Five Software</dev>
+    <manufacturer>Big Five Software</manufacturer>
+    <genre>Action</genre>
+    <player>1-2</player>
+    <story>Bounty Bob Strikes Back est la suite du jeu Miner 2049er et reprend le même gameplay. Cette version est le portage de la version initiale Atari 8-bits. L'objectif est de parcourir chaque centimètre des 25 mines tout en évitant les monstres irradiés, pour ce faire vous pourrez sauter ou utiliser les divers objets à disposition (échelles, télé-transporteurs, cannons, ...), et attention aux chutes qui pourraient être fatales.</story>
+    <enabled>true</enabled>
+    <crc />
+  </game>
+  ...
+</code>
+__ ** <color # ed1c24> Since version 1882 beta 8 </color> ** __
+  * ** Pegasus ** (checkbox): When saving the gamelist.xml via the 'Create gamelist.xml' button, a ** metadata.txt ** file is created in the current system directory in the expected format by Pegasus.
+  * ** Pegasus ** (clickable link): Used to display the association used between the Pegasus TAGs and the TAGs from the gamelist.xml
+{{arrm: options: pegasus_tags.png? direct}}
+{{ youtube>7EwE3KDXxWE?large }}
+\\
+[[https://youtu.be/7EwE3KDXxWE|See video]]
+Example ** Pegasus ** ** metadata.txt ** file for the snes system
+<code>
+collection: snes
+game: Bounty Bob Strikes Back
+file: ./bounty bob strikes back! (usa).zip
+developer: Big Five Software
+publisher: Big Five Software
+genre: Action
+description:
+	Bounty Bob Strikes Back est la suite du jeu Miner 2049er et reprend le même gameplay. Cette version est le portage de la version initiale Atari 8-bits. L'objectif est de parcourir chaque centimètre des 25 mines tout en évitant les monstres irradiés, pour ce faire vous pourrez sauter ou utiliser les divers objets à disposition (échelles, télé-transporteurs, cannons, ...), et attention aux chutes qui pourraient être fatales.
+release: 1984-01-01
+players: 1-2
+x-id:
+assets.boxfront: ./downloaded_images/bounty bob strikes back! (usa)-boxart.png
+assets.cartridge: ./downloaded_images/bounty bob strikes back! (usa)-cartridge.png
+assets.marquee: ./downloaded_images/bounty bob strikes back! (usa)-wheel.png
+assets.screenshot: ./downloaded_images/bounty bob strikes back! (usa)-screenshot.png
+assets.video: ./downloaded_images/bounty bob strikes back! (usa)-video.mp4
+assets.logo: ./downloaded_images/bounty bob strikes back! (usa)-wheel.png
+assets.background:
+assets.music:
+rating: 0.80
+</code>
+__ ** <color # ed1c24> Since version 1882 beta 8 </color> ** __
+   * ** AttractMode ** (checkbox): When saving the gamelist.xml via the 'Create gamelist.xml' button, a ** %% systeme_attractmode% .txt ** file is created in the Romlists Folders directory of 'AttractMode (to be initialized in the' Folder 'tab.
+Example file ** AttractMode ** ** Super Nintendo Entertainment System.txt ** for the snes system
+<code>
+#Name;Title;Emulator;CloneOf;Year;Manufacturer;Category;Players;Rotation;Control;Status;DisplayCount;DisplayType;AltRomname;AltTitle;Extra;Buttons
+bounty bob strikes back! (usa);Bounty Bob Strikes Back;Super Nintendo Entertainment System;;1984;Big Five Software;Action;1-2;;;;;;;;;;;;;;;;;;
+</code>
+**<color #ed1c24> Since version 1899 beta 11 </color> **, ** Game descriptions ** are saved in individual text files per game (% romfile% .txt). They are located in the Romlists folder (to be initialized in the 'Folder' tab) and in a sub-directory named after the system being processed. It's up to you to copy them wherever they need in your Attract Mode configuration.
+  * ** Edit AttractMode association ** (Button): Allows you to edit the file **%appdata%\nexouille soft\arrm\database\attractmode_association.txt ** which makes it possible to make the link between the directories of the ARRM systems and the AttractMode systems
+  * ** CSV ** (checkbox): When saving the gamelist.xml, export the gamelist data in a csv file named 'SystemName_export.csv' located in the roms directory of the current system ")
+Sample file
+<code>
+Name;Path;Rating;Date;Developer;Publisher;Genre;Players;Hidden;Favorite;Image;playcount;Lastplayed;md5;core;emulator;screenshot;boxart;wheel;cartridge;mix;video;hash;manual;region;thumbnail;fanart;map;titleshot;lang;arcadesystem;gametime;boxback;temporary
+-Yard Fight;./10-yard Fight.zip;0,40;19850101T000000;Irem;Nintendo;Sport / Football Américain, Sport;1-2;false;false;./media/images/10-yard Fight-mix.png;0;;;;;./media/screenshots/10-yard Fight-screenshot.png;./media/boxarts/10-yard Fight-boxart.png;./media/wheels/10-yard Fight-wheel.png;./media/cartridges/10-yard Fight-cartridge.png;./media/images/10-yard Fight-mix.png;;;;jp;./media/boxarts/10-yard Fight-boxart.png;;;;;;0;./media/boxbacks/10-yard Fight-boxback.png;
+;./1942.zip;0,60;19850101T000000;Micronics / Khaos;Capcom;Action, Shoot'em Up;1-2;false;false;./media/images/1942-mix.png;0;;;fbneo;libretro;./media/screenshots/1942-screenshot.png;./media/boxarts/1942-boxart.png;./media/wheels/1942-wheel.png;./media/cartridges/1942-cartridge.png;./media/images/1942-mix.png;./media/videos/1942-video.mp4;;;;./media/boxarts/1942-boxart.png;./media/fanarts/1942-fanart.png;;./media/titleshots/1942-titleshot.png;;;0;./media/boxbacks/1942-boxback.png;
+: The Loop Master;./1944.zip;0,80;20000101T000000;Capcom;Capcom;Shoot'em Up, Shoot'em Up / Vertical;1-2;false;false;./media/images/1944-mix.png;0;;;fbneo;libretro;;./media/boxarts/1944-boxart.png;./media/wheels/1944-wheel.png;;./media/images/1944-mix.png;;;;us;./media/boxarts/1944-boxart.png;./media/fanarts/1944-fanart.png;;;;cps2;0;./media/boxbacks/1944-boxback.png;
+XX : The Warinst Destiny;./19xx.zip;0,60;19960101T000000;Capcom;Capcom;Shoot'em Up, Shoot'em Up / Vertical;1-2;false;true;./media/images/19xx-mix.png;0;;;fbneo;libretro;./media/screenshots/19xx-screenshot.png;./media/boxarts/19xx-boxart.png;./media/wheels/19xx-wheel.png;;./media/images/19xx-mix.png;./media/videos/19xx-video.mp4;;./media/manuals/19xx_(us).pdf;us;./media/boxarts/19xx-boxart.png;./media/fanarts/19xx-fanart.png;;./media/titleshots/19xx-titleshot.png;;cps2;0;./media/boxbacks/19xx-boxback.png;
+Super Baseball;./2020bb.zip;0,60;19910101T000000;Pallas;SNK;Sport, Sport / Baseball;1-2;false;false;./media/images/2020bb-mix.png;0;;;fbneo;libretro;./media/screenshots/2020bb-screenshot.png;./media/boxarts/2020bb-boxart.png;./media/wheels/2020bb-wheel.png;;./media/images/2020bb-mix.png;;;./media/manuals/2020bb_(jp).pdf;wor;./media/boxarts/2020bb-boxart.png;./media/fanarts/2020bb-fanart.png;;;;snk;0;./media/boxbacks/2020bb-boxback.png;
+</code>
 ----
+===== Gamelist Tags =====
+{{arrm:options:options_gamelist_tags_en.png?direct}}
+Available since version <color #ed1c24>1.9.0.2 Beta 9</color>
+This tab allows you to select the media TAGs that you want to appear in Gamelist.xml. \\
+When creating/saving the **gamelist.xml**, ARRM will automatically create a **gamelist_ARRM.xml** containing all the tags usable by ARRM.
+If the associated media exists, the TAG will be written in the gamelist.xml when you click on the **Create gamelist.xml** button.
+<note important> 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. </note>
+  * **Provider Custom** (checkbox): Allows, when creating the gamelist.xml, to add personal information between the <provider> tags. The information added is that contained in the file **%appdata%\Nexouille soft\arrm\database\provider_custom.txt** . You can click on {{:arrm:eye-icon-1481.png?direct}} to edit this file.
+This file is made up as follows:
+Tag name (your choice) | comment/description
+example :
+<code>
+scraped_by|Nexusone13
+information|This pack was done by Nexusone13
+version|Updated on 01/31/2022
+</code>
+<note>You can give any name to the tags, except **provider**</note>
+When the gamelist.xml will be generated it will give:
+<code>
+<?xml version="1.0" encoding="utf-8"?>
+<gameList>
+  <provider>
+    <system>neogeo</system>
+    <software>ARRM</software>
+    <web>http://jujuvincebros.fr/wiki/arrm/doku.php</web>
+    <scraped_by>Nexusone13</scraped_by>
+    <information>This pack was done by Nexusone13</information>
+    <version>Updated on 01/31/2022</version>
+  </provider>
+  <gameid="37604">
+    <path>./- Metal Slug/mslug.zip</path>
+...
+</code>
+----
 ===== Batocera / Screenscraper / TGBD =====
 {{ARRM:Options:options_batocera_recalbox_options_en.png?direct}}
-  * ** Batocera ** (checkbox): Check if you use Batocera. Used for some specificities of this system (management of some systems, list core, script of stop/start; overlays management etc...)
+  * **Recalbox** (checkbox): Check if you use Recalbox. Used for some specifics of this system
-  * ** Retropie ** (checkbox): Check if you use Retropie. Used for some specificities of this system (script of stop/restart, es_systems.cfg file management, overlays management etc...)
+  * **Retropie** (checkbox): Check if you use Retropie. Used for certain specificities of this system (stop/start script, management of the es_systems.cfg file, management of overlays, etc.)
-If Batocera and Retropie are not checked, Recalbox is assumed as the selected Frontend.
+  * **Batocera** (checkbox): Check if you use Batocera. Used for certain specificities of this system (management of certain systems, core list, stop/start script, management of overlays, etc.)
+    * **Retrobat** (checkbox): Check if you are using Retrobat. Used for some specifics of this system
+    * **Batocera Plus** (checkbox): Check if you use Batocera Plus. Used for some specifics of this system
-  * ** API v2 Screenscraper (beta) ** (checkbox): You have to check it, otherwise scrap will not work
+<note>When you choose **Retrobat** or **Batocera Plus**, the **Batocera** checkbox will also be checked, as the systems have some common features with **Batocera**
+\\
+\\
+If **Batocera** and **Retropie** are not checked, **Recalbox** is assumed as the selected Frontend.</note>
+  * ** Search limit TGDB** (textbox): indicates the maximum number of games to list when searching on TheGamesDB
+  * ** Search limit Others ** (textbox): indicates the maximum number of games to list when searching on HFS-DB / Steam-DB / GOG
-  * ** TGBD Requests left ** (label): TheGamesDb API limits the number of requests to 1500 per user per month . You will see here the number of calls you have left.
+  * ** Auto validation TGDB / Others** (checkbox): When only one game is found in the API, the game is selected automatically without displaying the choice window. Please note that the validated game may not be the one you are looking for (game title close to the one you are looking for, etc.). If more than one game is found, the game selection window will appear.
-  * ** Search limit TGDB ** (textbox): When TheGamesDB finds several results, the display will be limited to the specified number.
+  * ** Exact search** (checkbox): performs an exact search on the name of the game. Example: With this option checked, a search on the name 'Grand Theft Auto' will only return the game 'Grand Thef Auto 'while with this option unchecked all Grand Theft Auto titles will be returned. Works on  HFSDB, Lanchbox, GameTDB, SteamDB, GOG, IGDB
-  * ** Auto search TGDB ** (checkbox): Automatically searches on the exact name of the game without asking any questions on TheGamesDB.net. Be careful, with the new API the automatic search is no longer as accurate. It is best not to activate it.
+  * **Ignore platform** (checkbox) : Allows not to filter on the platform when searching for a game. Works on TGDB, HFSDB, Launchbox, Gametdb, Igdb.
-  * ** Preview images on TGDB ** (checkbox): On the window for selecting a game found on TheGameDB, displays or not a screenshot thumbnail / title / box found. Warning this consumes API requests on TheGamesDB.
+  * ** Preview images on TGDB ** (checkbox): On the selection window of a game found on TheGameDB, display or not a thumbnail of the screenshot / title / boxart found. Be careful, this consumes API calls on TheGamesDB.
+  * ** TGBD Requests rest ** (label): TheGamesDb API limits the number of calls to 1500 requests per user per month. Here you will see the number of calls you have left.
   * ** Stop EmulationStation ** (button): Before modifying your gamelist.xml it is necessary to stop the EmulationStation service. To do only if you work directly on the FrontEnd via a network share. Remember to check Batocera or Retropie if you are on this system because the scripts are different.
@@ Ligne 282: / Ligne 713: @@
 {{arrm:functionality:sort_es_systems_en.png?direct}}
-ARRM uses the file '%appdata%\roaming\nexouille soft\database\systems_sorting.txt' that you can adapt to your systems. It looks like this:
+ARRM uses the file '%appdata%\nexouille soft\database\systems_sorting.txt' that you can adapt to your systems. It looks like this:
 <code>
@@ Ligne 320: / Ligne 751: @@
-  * ** Backup configuration files ** (button): Create a backup with the current date of the user-modifiable parameter files that are in this directory: '%appdata%\roaming\nexouille soft\database\. A backup subdirectory is created. Remember to do this backup before uninstalling ARRM.
+  * ** Backup configuration files ** (button): Create a backup with the current date of the user-modifiable parameter files that are in this directory: '%appdata%\nexouille soft\database\. A backup subdirectory is created. Remember to do this backup before uninstalling ARRM.
-  * ** SpeedUp ** (checkbox): Accelerates image processing by removing the validity check from the recovered image file (file in the correct png format etc). When loading the 'gamelist.xml', do not check if the images referenced in the 'gamelist.xml' file exist locally.
+  * ** Web Request TimeOut (sec) ** (textbox): Sets the timeout for web requests in seconds. Increase the value if the scrape site is overloaded.
-  * ** Web Request TimeOut (sec) ** (textbox): Sets the timeout for web requests in seconds. Increase the value if the scrap site is overloaded.
+  * <del>** Best Arcade Core Update ** (button): allows you to update the database with the best core arcade based games. Uses the files 'fba_libretro.csv', 'mame2003.csv', 'mame2010.csv' from [[https://github.com/Voljega/BestArcade|BestArcade]]. These files are located in '%appdata%\nexouille soft\arrm\database'. The 'Update Core' button uses this database.</del>
+  * ** Get systems Wheels** (button): get, on Screenscraper, the ** carbon wheels & Wheels ** on Screenscraper for the systems present and for the arcade from the systems contained in the files ** systemes_screenscraper.txt ** and ** arcadesystemname_long.txt **. Carbon Wheels are used to display system name logo in template (tag : **system**). The system must be recognized on Screenscraper for this procedure to return wheels & wheels carbon.
-  * ** Pngequant parameters ** (textbox): allows to modify pngquant image compression parameters. If empty, the following default values are applied: --force --verbose --ordered --speed=1 --quality=30-90 --ext .png
+  * ** Add Flag ** (button): Adds flags to the image without having to re-scrape. The template selected must be the one originally used on the existing image and have the <region1> and <region2> tags that indicate the position of the flag. Note: the <region>true</ region> tag is not needed.
+  * ** Pad 2 Keyb **: By clicking on {{:arrm:eye-icon-1481.png?Direct}} you will be able to create/modify the file **.P2k.cfg ** (or .keys for Batocera) for the selected system. This file is used to assign keyboard keys to the joypad. Useful for computer emulators that sometimes use keyboard keys in games. See explanations: https://wiki.recalbox.com/en/advanced-usage/pad-to-keyboard
+<note>
+If you want to convert Recalbox .p2k files into Batocera compatible .keys files I invite you to use the [[https://github.com/soaresden/RecopierBox/|RecopierBox]] utility from Soaresden, which also offers other utilities for Recalbox / Batocera
+</note>
+  * ** Arcade systems list **: allows you to edit the List of systems to be considered as an Arcade system (**%appdata%\Nexouille Soft\Arrm\Database\arcade_systems_list.txt**). This list is used when loading gamelists as well as when checking arcade names. You can add here your arcade systems separated by a semicolon (;) . Restart ARRM when you modify this file.
+{{arrm:options:options_tools_2_en.png?direct}}
+**<color #ed1c24>Since ARRM 1917 Beta 9</color>**, you can now specify systems names that match **Arcade, PC/DOS, ScummVM, Daphne/Singe**. (used by ARRM for processing specific to these systems). Usefull if your systems folders doesn't match arcade/pc/dos/scummvm/daphne/singe. Items must be separated by a **;**
+__**Video Encoder**__
   * **Handbrake parameters** (textbox) : allows to modify handbrake video compression parameters. If empty, the following default values are applied: -Z "Gmail Small 10 Minutes 288p30" --crop 0:0:0:0 -f av_mp4 .List of [[https://handbrake.fr/docs/en/latest/technical/official-presets.html|differents presets]] (-Z) usable. The default preset can reduce videos by more than half. See : [[compress_video_en|Compress videos to save storage space]]
   * **FFmpeg parameters** (textbox): allows to modify the video compression parameters of FFmpeg. If empty, the following default values are applied: **-ac 1 -c:v libx264 -preset:v slow -profile:v main -level 3.1 -filter_complex “format=yuv420p,scale='if(gt(in_w,in_h),288,-2):if(gt(in_w,in_h),-2,288)'” -r 30 -f mp4 -y**
-You can try this other parameters for FFmpeg : **-ac 1 -c:v libx264 -pix_fmt yuv420p -crf 35 -preset:v slow  -y**
+\\
+You can try this other parameters for FFmpeg :
+**-ac 1 -c:v libx264 -pix_fmt yuv420p -crf 35 -preset:v slow  -y**
+Other user setting **Fourch** which allows to keep the original duration, 60 fps, and have a quality equivalent to normalized videos, for almost the same weight. A little longer to encode but better quality: \\
+**-acodec libmp3lame -b:a 64k -ar 24000 -c:v libxvid -preset veryslow -crf 30 -vf "scale=-1:480,fps=60,pad=ceil(iw/2)*2:ceil(ih/2)*2" -y**
 [[https://ffmpeg.org/ffmpeg.html|Documentation FFmpeg]]. See : [[compress_video_en|Compress videos to save storage space]]
-  * **Compress video** (checkbox) : If checked, compresse video with handbrake. Compressing the videos also makes them compatible with the OMX player on Retropie. See : [[compress_video_en|Compress videos to save storage space]]
-  * ** Compress selected videos ** (button): With this button you can compress all the videos of a system. Open the system, select the roms and click on the button 'Compress selected videos'. See : [[compress_video_en|Compress videos to save storage space]]
+  * **Video+Overlay compress parameters** (textbox): allows to modify the video compression parameters of FFmpeg which will apply on video generated by 'Video+Overlay' button if 'Compress video' checkbox is checked. If empty, the following default values are applied: **-ac 1 -c:v libx264 -preset:v slow -profile:v main -level 3.1 -filter_complex "format=yuv420p,scale='if(gt(in_w,in_h),480,-2):if(gt(in_w,in_h),-2,480)'" -r 30 -f mp4 -y**
-  * ** Best Arcade Core Update ** (button): allows you to update the database with the best core arcade based games. Uses the files 'fba_libretro.csv', 'mame2003.csv', 'mame2010.csv' from [[https://github.com/Voljega/BestArcade|BestArcade]]. These files are located in '%appdata%\nexouille soft\arrm\database'. The 'Update Core' button uses this database.
-  * ** Recover Media ** (button): retrieves, on Screenscraper, the wheels of the present systems. (allows to have updated systems wheels for display in the '** Rom Information **' panel)
-   * ** Add Flag ** (button): Adds flags to the image without having to re-scrape. The template selected must be the one originally used on the existing image and have the <region1> and <region2> tags that indicate the position of the flag. Note: the <region>true</ region> tag is not needed.
+__**Image Encoder**__
-   * ** World Flag ** (checkbox): Forces the addition of the World flag when no region is found.
+  * ** Pngequant parameters ** (textbox): allows to modify pngquant image compression parameters. If empty, the following default values are applied: --force --verbose --ordered --speed=1 --quality=30-90 --ext .png
+__**Convert Recalbox Overlays**__
+If you already have Recalbox overlays but you want to convert them in order to use them on Batocera.
+ARRM offers a converter. It will browse your Overlays Recalbox folder, retrieve positioning information in the associated .cfg, and recreate Batocera compatible .info files. The .png files cab be also recovered. <color #ed1c24>(since beta 1882)</color>
+  * ** Overlays converted Folder **: Indicate here the temporary directory which will contain the Overlays converted in ** Batocera ** format. After the conversion, it will then be necessary to put them under \\batocera\share\decorations\**your_overlays_folders**
+<note> You can also indicate the directory \\batocera\share\decorations\**your_overlays_folders** if you have access to it </note>
+  * ** Recalbox Overlays Folders **: Indicate here the Overlays directory of ** Recalbox **. This can be **\\recalbox\share\overlays** or any other directory containing the ** overlays ** folder with the tree structure specific to the overlays ** Recalbox **.
+  * ** Copy PNG ** (checkbox) : Check it if you want to copy overlays .PNG files, otherwise only the .info will be created
+  * **Convert to BATOCERA ** (button) : launch the conversion of Recalbox overlays configuration files to Batocera overlay configuration files (.info)
+When the conversion is complete, you can access the ** Overlays converted Folder ** directory by clicking on {{: {{:arrm:eye-icon-1481.png?direct}}.\\
+<note>
+Remember to copy the content into \\batocera\share\decorations\**your_overlays_folders**
+</note>
+__**Parameter File**__
+**<color #ed1c24>From 1882 beta 22</color>**
+You can view and modify ARRM configuration files. By clicking on a file you have its description. Clicking on {{:arrm:eye-icon-1481.png?Direct}} will open the file in your default text editor.
+<note important>
+After modifying configuration files, it is necessary, to avoid any problem, to restart ARRM. </note>
+* ** Create empty Rom file when no exists (Dev) ** (checkbox): **<color #ed1c24>From 1903 Beta 3</color>** When loading the gamelist.xml, if the ROM file does not exist, ARRM will create an empty file. This feature is used by the developer and is not remembered.
 ----
+===== Update =====
+Available since version <color #ed1c24>**1.9.1.1 beta 9**</color>
+Regularly files are updated.\\
+If you want to take advantage of it without having to wait for a final version, you can go through the **Update** tab
+The last update date of a file is displayed after the file name in **yyyy/mm/dd** format
+{{arrm:options:options_update_en.png?direct}}
+This tab allows you to update various ARRM configuration files:
+  * **Update LaunchBox DB**: the media and information offered by LaunchBox are regularly updated by the community. It is therefore necessary to update LaunchBox on ARRM. An update is offered with each new version of ARRM, included in the application zip. But between two versions you will have to do this update via this button. The last update date is in mm/dd/yyyy format
+  * **Update Steam DB**: the media and information offered by Steam are regularly updated (addition of new games etc...). It is therefore necessary to do a Steam DB update on ARRM. An update is offered with each new version of ARRM, included in the application zip. But between two versions you will have to do this update via this button. The last update date is in mm/dd/yyyy format
+  * **Configurations files**: Select the files you want to update then click on the **Update** button. The old file will be renamed to .old as a precaution. These configuration files offered with each new version of ARRM, included in the zip of the application. But between two versions you will have to do this update via this button.
+  * **DAT to Database**: To update the search database by Datfiles. The treatment can be very long. See wiki for the procedure: [[rename_game_with_datfiles_fr#mise_a_jour_la_database_avec_des_nouveaux_datfiles_dat|Update the Database with new Datfiles]] . By clicking on {{:arrm:eye-icon-1481.png?direct}} you access the directory containing the DatFiles (%appdata%\Nexouille Soft\Arrm\Database\Tosec)
+  * **ARCADE to Database**: To update the search database by Datfiles on **Arcade** systems. It is used in the 'Rename with DAT' function on **Arcade** systems. This functionality aims to find in the ARRM database, the right title of an **Arcade** game based on its file name which is standardized for the Arcade. The treatment can be very long. See wiki for the procedure: [[rename_game_with_datfiles_en##update_arcade_database_with_new_datfiles_dat_xml|Rename game titles with the help of Datfiles]] . By clicking on {{:arrm:eye-icon-1481.png?direct}} you access the directory containing the DatFiles (%appdata%\Nexouille Soft\Arrm\Database\dat)
+----
 ===== Contact =====
@@ Ligne 362: / Ligne 874: @@
   * [[http://jujuvincebros.fr/hard-soft/tutoriels/628-arrm-another-recalbox-roms-manager|Site ARRM]] (at JujuVinceBros)
   * Link to access the [[http://jujuvincebros.fr/forum|forum ARRM]] on the Jujuvincebros website
-  * Link to [[https://streamlabs.com/jujuvincebrosfr|make a donation]] via Streamlab or Utip
+  * Links to make a donation
   * Link to access this [http://jujuvincebros.fr/wiki/arrm/|WIKI]]
+  * ** Send debug info to developer ** (button): If you encounter a bug or an unexpected behavior of ARRM, click on this button to automatically send by email to the developer, a log of your ARRM config and last report scrape.
 ----