Différences

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

--- settings-en [2019/11/07 22:59] – [Tools] nexusone13
+++ settings-en [2020/05/14 15:36] – [Gamelist Options] nexusone13
@@ Ligne 27: / Ligne 27: @@
       * You can set as directory name a path like this : 'media/images'
   * ** Videos Directory name ** (textbox): name of the directory containing the videos retrieved by the scraper.
-        * You can put the same directory as the images folder
+    * You can put the same directory as the images folder
-        * You can also put as directory name a path such as 'media/videos'
+    * 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 39: / Ligne 39: @@
   * ** Edit Arcade core ** (button): open the file ///**%appdata%\Nexouille soft\arrm\database\recalbox_arcade_core.txt**// or //**batocera_arcade_core.txt ** // which indicates which emulators and core to use for Arcade systems (Mame, FBA, FBA_Libretro) based on the file 'BestArcade4Recalbox-18-03-30'. (this file is used when pressing the 'Update Core' button)
-  * ** Template association ** (button): opens the file // **%appdata%\Nexouille soft\arrm\database\template_association.txt ** // which indicates which template mix associated with each system.
+  * ** Template association ** (button): opens the file // **%appdata%\Nexouille soft\arrm\database\template_association.txt ** // which indicates which template mix associated with each system. Template association is done when the checkbox '**Auto Template**' is checked.
   * **Overlays Path** (bouton) : Opens file : //**%appdata%\Nexouille soft\arrm\database\overlays_path.txt**//  which contains paths used when generating overlays. Here you can setup paths for Systems and Games overlays for Recalbox and Retropie. For Batocera, paths are currently hardcoded in the application
-  * ** Extra Tag + Default Image ** (button): Accesses the configuration menu for recovery of boxart, screenshot, marquee, video, cartridge, mix and setting custom tag setup. By activating the recovery of the boxart, screenshot, marquee 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 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:
 {{ARRM:functionality:arrm_tag_default_en.png?direct}}
-  * ** Activation of recovery of 4 images + TAG Custom ** (checkbox): By checking this box you get the 4 images (screenshot, box, cartridge and mark). 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.
+  * ** 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.
   * ** 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)
-  * ** Tags Custom section**: The tags used by default in ARRM (boxart, screenshot, mark, mix, cartridge, video) correspond to those used in Recalbox, Batocera, and Retropie. For one reason or another (new frontend, or personal need), it's possible to change the names of the tags that will appear in your gamelist.xml
+  * **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>
   * ** 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.
@@ Ligne 67: / Ligne 71: @@
     * 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) Examples:
+  * ** 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
+  * Examples:
     * Indiana Jones and the Last Crusade (1989) (en) (Disk 1 of 3) .st -> Indiana Jones And The Last Crusade - The Graphic Adventure (Disk 1 of 3)
     * Knockout (Alligata Software) (Side A) (Europe) .tzx -> Knockout (Side A)
@@ Ligne 76: / Ligne 82: @@
   * ** 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.
+  * ** Strict search ** (checkbox): Allows to retrieve only the games whose PlateformId corresponds to the sought platform.
   * ** Image as Rom file ** (checkbox): During a scrape, the image file is named with the name of the Rom and not with the name of the game returned by the scraper
@@ Ligne 82: / Ligne 90: @@
   * ** MD5 ** (checkbox): Arrm attempts a search on Screenscraper with the MD5 of the Rom when searching by filename does not work. Be careful calculating the MD5 can be a bit long with large files. To save time, you can prevent the calculation of the MD5 on some extensions by editing the list of extensions to avoid with the button 'Edit No MD5'on 'Main Options' configuration tab.
+  * ** In .ZIP/.7z ** (checkbox): Sometimes searching with the MD5 on the zip gives nothing. By activating this option, ARRM will decompress the .ZIP/.7z and calculate the MD5 of the file contained in the .ZIP/.7z
   * ** 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.
-  * ** Ignore Local Search ** (checkbox): When performing a 'Recompose image', or 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.
+  * **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.
+  * ** 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
+  * ** 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.
@@ Ligne 136: / Ligne 150: @@
   * ** No image, only texts ** (checkbox): If checked, ARRM only retrieves the text information on the scrape site.
+  * ** 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]]
     * ** {{:arrm:eye-icon-1481.png?direct}} ** (bouton) : Opens the directory containing the overlays models
-    * **Dev** (checkbox) : Retrieves an overlay image with the viewport area detected by Arrm surrounded by yellow. This allows overlay errors to be detected and corrected.
+  * ** 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.
-    * **4/3** : Only retrieves overlays in 4/3 format
+  * ** Custom ** (checkbox): Prioritize custom overlays (cus). It is advisable to activate this option because custom overlays often correct certain transparency problems.
-    * **16/9** : Only retrieves overlays in 16/9 format
+  * ** 4/3 ** (radio button): Only recover overlays in 4/3 format (native resolution on Screenscraper: 1024x768)
-    * **-> 720** : Convert 1080 overlays to 720 and change viewport coordinates accordingly. This option also applies to recovering system overlays.
+    * ** -> 1280x1024 ** (checkbox): convert the recovered 4/3 overlays to a resolution of 1280x1024
+  * ** 16/9 ** (radio button): Only recover overlays in 16/9 format native (resolution on Screenscraper: 1920x1080)
+    * ** -> 720 ** (checkbox): Convert the recovered 16/9 overlays to a resolution of 1280x720
+The coordinates of the viewports are calculated according to the resolutions chosen. These options also apply to the recovery of system overlays.
@@ Ligne 152: / Ligne 172: @@
   * ** Show Mix model ** (button): Displays the template selection menu used with the 'Mix' option
+**Force Media**
   * ** Japan Media ** (checkbox): If this option is checked ARRM recovers the Japanese media of the game (only on Screenscraper).  The text language will be that of the ARRM interface.
@@ Ligne 161: / Ligne 184: @@
   * ** SS Media ** (checkbox): If this option is checked ARRM recovers the media created by ScreenScraper (non official) (only on Screenscraper). The text will be that of the ARRM interface.
-If US Media, Japan, Europe et SS are not checked, ARRM retrieve media corresponding with the ARRM Interface language selected.
+  * ** Only ** (checkbox): Tells ARRM to retrieve only the country media checked (no fallback to other available media)
+If US Media, Japan, Europe, and SS are unchecked, ARRM retrieves the media in the language of the ARRM interface unless the ** Only ** checkbox is checked.
 ----
@@ Ligne 180: / Ligne 207: @@
   * ** 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.
   * ** 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.
@@ Ligne 188: / Ligne 217: @@
   * ** Temporary Gamelist ** (checkbox): A gamelist_tempo.xml file is created during the progression of the scrape in the directory of the scraped system. Thus during a crash of the application it is possible to retrieve the information from this file the next time the system is loaded.
+  * ** ZIP gamelist.xml ** (checkbox): When creating the gamelist.xml a gamelist.zip file is created.
   * ** Open created xml ** (checkbox): Open with, your default text editor, the file gamelist.xml after its backup / creation.
@@ Ligne 223: / Ligne 254: @@
   * ** Login Screenscraper ** (button): Displays a popup to enter your username / password on screenscraper. It is preferable (but not mandatory) to create an account on Screenscraper.fr because it favors registered users during scrapes.
+{{ARRM:Options:options_login_screenscraper_en.png?direct}}
+Click on '**Check identifier**' to view your authorisations, then click on '**validation**' to accept the current credentials
   * **Login** (textbox): Login for SSH access on your Recalbox / Batocera / Retropie systems
@@ Ligne 306: / Ligne 341: @@
   * ** 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
-  * **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.
+  * **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]]
-  * **Compress video** (checkbox) : If checked, compresse video with handbrake. Compressing the videos also makes them compatible with the OMX player on Retropie
+  * **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**
+[[https://ffmpeg.org/ffmpeg.html|Documentation FFmpeg]]. 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'
+  * **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]]
   * ** 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.
+   * ** World Flag ** (checkbox): Forces the addition of the World flag when no region is found.
 ----
@@ Ligne 331: / Ligne 374: @@
   * [[nexusone13@gmail.com?subject=About ARRM (Another Recalbox Roms Manager)|Author's Mail]]
   * [[http://jujuvincebros.fr/hard-soft/tutoriels/628-arrm-another-recalbox-roms-manager|Site ARRM]] (at JujuVinceBros)
-  * Link to access the [[http://jujuvincebros.fr/forum3/arrm-another-recalbox-roms-manager|forum ARRM]] on the Jujuvincebros website
+  * 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
+  * Link to [[https://streamlabs.com/jujuvincebrosfr|make a donation]] via Streamlab or Utip
   * Link to access this [http://jujuvincebros.fr/wiki/arrm/|WIKI]]