Paramétrage du logiciel ARRM
Video Tutorial
Voir video
Lorsque vous exécutez ARRM, vous obtenez cet écran principal (interface)
Avant de se lancer dans la manipulation de gamelists, roms et autres scraps, il est nécessaire de paramétrer l'application afin qu'elle puisse répondre à votre configuration et vos besoins.
Dans le screenshot ci-dessus, la partie paramétrage est entourée de rouge afin de la mettre en évidence pour ce wiki. Nous allons nous attarder sur les 6 onglets qui composent la partie paramétrage.
Dossiers des Systèmes et des Overlays
Cela peut être un répertoire réseau (si vous accédez à votre frontend par réseau) :
ou un disque local (si vous accédez à la carte mémoire/disque de votre frontend connecté à votre PC) :
Pour qu'ARRM fonctionne avec
Retropie, il faut que sur Retropie les chemins suivants soient respectés
Pour Batocera, Recalbox et Retropie vous pouvez indiquer également un autre répertoire temporaire qui recevra les overlays générés, mais dans ce cas il vous faudra copier/coller ce contenu sur votre Box.
Pensez à cliquer sur les boutons 'V' pour valider les répertoires.
Les icônes permettent d'ouvrir le répertoire dans votre explorateur de fichier.
Extensions (label) : affiche la liste des extensions reconnus pour ce système. Seules les fichiers contenant ces extensions seront affichés dans la database. Cette liste est alimentée par le fichier
%appdata%\Nexouille soft\arrm\database\systemes_extensions.txt qui contient les extensions reconnues par Recalbox,T Batocera ET Retropie. si vous souhaitez supprimer/ajouter des extensions, référez vous aux fichiers '_lisezmoi.txt/_readme.txt' pour Recalbox et '_infos.txt' pour Batocera présents dans chaque répertoire système qui contient la liste des extensions reconnues. Vous pouvez éditer ce fichier via le panel de configuration, onglet 'Options générales', bouton 'Edite Extensions'. Il vous faudra redémarrer ARRM pour la prise en compte des changements.
Pour plus d'infos : ARRM n'affiche pas tous mes jeux. Comment ajouter une extension ?
Options générales
Aperçus des médias (checkbox) : (depuis la version 1.9.0.1 Beta 3) Quand coché, permet d'avoir automatiquement un aperçu des medias existants (en local) pour la ROM sélectionnée. Vous pouvez déplacer cette fenêtre d'aperçu. Son emplacement est sauvegardée lors de sa fermeture. Voici la fenêtre qui apparaît quand vous sélectionnez une ROM et que cette option est cochée:
Si vous rencontrez des ralentissements, veuillez décocher cette option Aperçu média et cliquez sur le bouton Média dans le panneau Informations ROM pour afficher le Formulaire d'aperçu média sur chaque ROM .
Vérifier si le media existe (checkbox) : Lors du chargement de la gamelist, vérifie si les media référencés existent en local, sinon la référence du media est supprimée de la database (à partir de la version 1882 beta 12)
Si votre gamelist est déjà finalisée, vous pouvez désactiver cette option pour accélérer le chargement de la gamelist dans ARRM
Rechercher les images manquantes (checkbox) : Lorsqu'une gamelist.xml est chargée, si des Tags de media sont vides, ARRM tente de trouver localement les medias manquants. Si le système chargé ne possède pas de gamelist.xml, il faut enregistrer la gamelist.xml vide, puis la ré-ouvrir afin qu'ARRM tente de trouver localement les medias manquants.
Attention : ceci ralenti énormment le chargement de la gamelist.xml
Si votre gamelist est déjà finalisée, vous pouvez désactiver cette option pour accélérer le chargement de la gamelist dans ARRM
Activation du mode 4 images (checkbox) : En cochant cette case vous récupérez les 4 images (screenshot, boxart, cartouche et wheel). Lors d'un scrape ces 4 images sont récupérées séparément, vous pourrez ainsi utiliser le bouton 'recompose image' pour recréer, à loisir, vos mix ou autres formats sans avoir à re-scraper. L'image retenue dans la gamelist.xml sera celle choisie dans l'onglet de configuration 'Images Options'. La contrepartie étant la place un peu plus importante occupée par les images et une durée de scrap un peu plus longue.
Pour bénéficier de toutes les fonctionnalités d'ARRM, il est conseillé d'activer le mode 4 images
ScummVM noms courts (bouton) : ouvre le site
scummvm.org indiquant les noms court à utiliser pour les jeux Scummvm
Edite extension (bouton) : Modifie les extensions de fichier autorisées par système.Vous devez redémarrer le programme si des changements ont été effectués dans ce fichier. Le fichier %appdata%\Nexouille soft\arrm\database\systemes_extensions.txt contient les extensions reconnues par Recalbox ET Batocera. si vous souhaitez supprimer/ajouter des extensions, référez vous aux fichiers _lisezmoi.txt/_readme.txt pour Recalbox et _infos.txt pour Batocera présents dans chaque répertoire système qui contient la liste des extensions reconnues.
Edite Arcade core (bouton) : ouvre le fichier %appdata%\Nexouille soft\arrm\database\recalbox_arcade_core.txt ou batocera_arcade_core.txt qui permet d'indiquer les émulateurs et les core à utiliser pour les systèmes Arcade (Mame,FBA, FBA_Libretro) basé sur le fichier 'BestArcade4Recalbox'. (ce fichier est utilisé lors du l'appui sur le bouton 'Maj du Core')
Overlays Path (bouton) : ouvre le fichier %appdata%\Nexouille soft\arrm\database\overlays_path.txt qui contient les chemins utilisés lors de la génération des overlays. Vous pouvez ici paramétrer les chemins d'Overlays Systèmes et Jeux pour Recalbox et Retropie. Pour Batocera, les chemins sont, actuellement, intégrés dans l'application.
Affectation des media Screenscraper + Ordre des media (bouton) (depuis la 1.8.1.6) : Accède à la page qui permet d'assigner les media Screenscraper aux différents TAGs d'ARRM et d'affecter l'ordre dans lequel les media images et textes doivent être récupéré en priorité sur Screenscraper.
voir la section dédiée.
Affectation des media Launchbox (bouton) (depuis la 1.9.0.2 Beta 11) : Accède à la page qui permet d'assigner les media Launchbox aux différents TAGs d'ARRM.
voir la section dédiée.
Profil (Sauver/Charger) (bouton)
(depuis la 1.9.2.8 Beta 2) : Permet de créer et restaurer des profiles qui contiennent les paramétrages d'ARRM. Voir :
Gérer les profils de scrape
Dossiers
Dans cet onglet, on peut paramétrer les chemins pour chacun des medias (image, screenshot, boxart, wheel, cartridge, titleshot, map, fanart, manual, video)
il peut être de la forme :
downloaded_images
media/images
media/screenshot
media/cartridge
manuals
media/manual
media/videos
etc…
Depuis la version 1923 Beta 5 il est possible de paramétrer les suffixes que l'on souhaite mettre en fin des fichiers media récupérés.
Exemple :
Par défaut les suffixes sont les suivants :
-image
-screenshot
-boxart
-wheel
-cartridge
-titleshot
-map
-fanart
-manual
-video
-mixvideo
-music
-boxback
-extra1
Il est possible de ne pas mettre de suffixe en laissant la textbox vide.
Si vous utilisez un seul dossier pour tous vos media, indiquez des suffixes différents afin de ne pas écraser vos images.
Lors du scrape de media, ces suffixes seront appliqués sur les media récupérés.
Utilisez la barre de défilement pour accéder au reste des répertoires de media / suffixes
Scrape Options
Nettoyer rom (checkbox) : Nettoie le nom lorsqu'un jeu est sauvegardé (suite à un scrape ou sauvegarde manuelle). Attention, il faut que la checkbox Nom du jeu soit cochée dans le panel Rom informations pour que cette modification soit prise en compte . ARRM supprime les caractères entre () et [] et déplace les articles (le, la, les et ceux des autres langues ES/POR/GER/FR) en fin de nom du jeu. Exemples :
The Legend of Zelda : Ocarina of Time → Legend of Zelda, The : Ocarina of Time
The Bard's Tale → Bard's Tale, The
Ajouter disque (checkbox) : Lors du scrape ou de la vérification du nom par MD5, ARRM ajoute le numéro de disquette, de face de K7 ainsi que AGA/CD32 (pour Amiga) à la fin du nom (si cette information est présente dans le nom de fichier)
La checkbox
ajouter disque s'appuie désormais sur le fichier
multi_part_add_disk.txt pour rechercher et récupérer des informations multi-disques dans les noms de fichiers
Ce fichier se trouve dans
%appdata%\Nexouille Soft\arrm\database\multi_part_add_disk.txt
Le contenu du fichier ressemble à ceci :
disc|disk|file|part|side|tape
Exemples :
Indiana Jones et la Derniere Croisade (1989)(fr)(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)
Ajouter langage (case à cocher) : Permet de Rechercher des langues dans le nom du fichier lors du chargement de la gamelist et l'affecte au champ Langues s'il est vide. Fonctionne également avec le bouton Vérification Roms. Exemple : Daffy Duck in Hollywood (Europe) (En,Fr,De,Es,It).zip
MD5 (checkbox) : Tente une recherche sur Screenscraper avec le MD5 de la Rom quand la recherche par nom de fichier ne donne rien. Attention le calcul du MD5 peut être un peu long avec les gros fichiers. Pour gagner du temps, vous pouvez empêcher le calcul du MD5 sur certaines extensions en éditant la liste des extensions à éviter avec le bouton 'Edit No MD5' dans l'onglet de configuration 'Options générales'.
Pad to Keyboard cfg (checkbox) : Lors du scrape, si cette option est activée, ARRM récupère le fichier de configuration .p2k.cfg (ou .keys pour Batocera) de la Rom en cours. Le fichier est stocké dans le répertoire où se trouve la rom est porte le nom de '
nom_fichier_rom.extension.p2k.cfg'. Ce fichier permet d'assigner au joypad, des touches du clavier. Utile pour les émulateurs d'ordinateurs qui utilisent parfois dans les jeux, des touches du clavier. Voir explications :
https://wiki.recalbox.com/fr/advanced-usage/pad-to-keyboard
Si vous souhaitez convertir les fichiers .p2k de Recalbox en fichiers .keys compatibles Batocera je vous invite à utiliser l'utilitaire
RecopierBox de Soaresden, qui proprose également d'autres utilitaires pour Recalbox/Batocera
PC/DOS : files mode : Les systèmes devant être gérés comme des répertoires (PC, DOS, Windows, PS3…) sont indiqués dans le fichier systemes_as_folder.txt situé dans %appdata%\Nexouille Soft\Arrm\database\. Cette checkbox permet de passer outre et forcer le mode fichier sur ces systèmes.
GamesDB Music : Recherche les musiques sur le site GamesDatabase, les stockent dans le répertoire défini dans Dossiers, et ajoute un tag <music> dans la gamelist. Utilisable par exemple avec mon jeu JVB_QUIZZ.
ONLY use ARRM detection of 'viewport' for 'Bezels' (checkbox) : Si coché, ARRM essaie de détecter automatiquement les coordonnées du 'viewport' du 'Bezel' téléchargé afin de créer les fichiers de configurations de l'overlay, sinon il utilisera les coordonnées fournies par l'
API de ScreenScraper.
Sans media uniquement (checkbox) : Depuis la version 1.9.0.3 beta 11 vous pouvez scraper uniquement les media (artworks) manquants en cochant
sans media uniquement dans l'onglet
Scrape Options. Seuls les media (artworks) manquants, cochés dans l'onglet
Images options seront récupérés.Dans les moteurs de scrape, seuls ces media (artworks) manquant seront présentés et sélectionnables. Voir :
Scraper uniquement les Artworks (media) manquants
Exemples :
Actraiser (Japan).zip,
Legend of Zelda, The (Europe) (Rev A).zip,
Batman Forever (F) [!].zip
Les pays reconnus sont :
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
Traduire description (checkbox) :
Disponible depuis la version 1.9.1.3 Beta 11, permet de traduire, en masse ou lors d'un scrape, les descriptions des jeux dans la langue de votre choix. Voir wiki :
Traduire les descriptions
Ignore recherche locale (checkbox) : Lors d'un scrape, si cette option est activée, ARRM ignore la recherche d'image manquante en local dans le répertoire images du système scrapé. Cette option s'active automatiquement lors de l'utilisation de 'Mix'Me'. Si vous scrapez un système pour la première fois cochez cette option pour accélérer le processus.
Quand l'option Ignore recherche locale est décochée, la section 'Images locales considérées comme' apparait. Voici ces options :
Screenshot (checkbox) : Si cette option est cochée, quand aucune image n'est retournée par le scraper, les images, provenant d'autres scrapers, trouvées sur le disque sont considérées automatiquement comme un Screenshot et donc le template est appliqué
Mix (checkbox) : Si cette option est cochée, quand aucune image n'est retournée par le scraper, les images, provenant d'autres scrapers, trouvées sur le disque sont considérées automatiquement comme déjà Mixée et donc le template n'est pas appliqué.
Ignorer autres scrapers (checkbox) : Lors d'un 'Recompose image', si aucune image n'est renseignée dans la database, on peut ignorer ou autoriser la recherche en local des images issues de scrapers autre qu'ARRM
Si aucune des 2 options ci-dessus (Screenshot ou Mix) n'est cochée, un popup (voir image ci-dessous) demandera à l'utilisateur d'indiquer si l'image est un Screenshot ou un Mix.
Media order (combobox) : permet de sélectionner le preset pays, qui contient l'ordre des pays dans lequel doivent être recherché les media (images et textes).
Voir la section dédiée. Cliquer sur le bouton (avec les flèches) pour actualiser la combobox (dans le cas ou des presets on été modifiés/ajoutés)
Images Options
Utilisez la barre de défilement pour accéder au reste des répertoires de media
Sans media uniquement (checkbox) : Depuis la version 1.9.0.3 beta 11 vous pouvez scraper uniquement les media (artworks) manquants en cochant
sans media uniquement dans l'onglet
Scrape Options. Seuls les media (artworks) manquants, cochés dans l'onglet
Images options seront récupérés.Dans les moteurs de scrape, seuls ces media (artworks) manquant seront présentés et sélectionnables. Voir :
Scraper uniquement les Artworks (media) manquants
Activation du mode 4 images (checkbox) : En cochant cette case vous récupérez les 4 images (screenshot, boxart, cartouche et wheel). Lors d'un scrape ces 4 images sont récupérées séparément, vous pourrez ainsi utiliser le bouton 'recompose image' pour recréer, à loisir, vos mix ou autres formats sans avoir à re-scraper. L'image retenue dans la gamelist.xml sera celle choisie dans l'onglet de configuration 'Images Options'. La contrepartie étant la place un peu plus importante occupée par les images et une durée de scrap un peu plus longue.
Pour bénéficier de toutes les fonctionnalités d'ARRM, il est conseillé d'activer le mode 4 images
Pas d'image, uniquement les textes (checkbox) : Si cochée, le choix 'NONE' sera appliquée sur la combobox de choix d'image TAG. ARRM ne récupère sur le site de scrape que les informations textuelles ainsi que les media cochés dans 'Force Media Download'
Vous pouvez sélectionner dans le combobox (Choisissez le TAG d'image que vous voulez) l'image qui sera affecter au TAG image et qui sera celle utilisée dans votre frontend (Recalbox, Batocera, Retropie etc) pour représenter le jeu. :
Le combobox permet de choisir entre ces différents media :
NONE (si vous ne souhaitez pas affecter ou modifier le TAG image)
BOXART
BOXBACK
CARTRIDGE
EXTRA1
FANART
MAP
MIX (le choix MIX permet d'appliquer un template MIX)
MIXRBV1 (correspond à un MIX déjà fait proposé par Screenscraper)
MIXRBV2 (correspond au deuxième MIX déjà fait proposé par Screenscraper)
ROUNDWHEEL
SCREENSHOT
TITLESHOT
WHEEL
Attention lorsque vous sélectionnez un des éléments (excepté MIX, MIXRBV1, MIXRBV2), le media en question sera coché automatiquement dans la section Force Media Donwload
En sélectionnant NONE comme image TAG, aucune image ne sera affectée au TAG Image. La checkbox 'Pas d'image, uniquement les textes' sera cochée. Le mode 'Activation du mode 4 images' sera également désactivé. Vous pouvez cependant forcer la récupération de certaines images en cliquant sur les images que vous souhaitez dans la section 'Force Media Download'.
Pour Screenscraper et Launchbox, vous pouvez associer ces Media à ceux utilisés sur Screenscraper et Launcbhox. Voir Assignation des media Screenscraper dans ARRM et Assignation des media Launchbox dans ARRM
Si l'option '4 images' est activée, les 4 images seront récupérées (Screenshot, Boitier, Marquee, Cartouche) mais seule celle indiqué dans le combobox (Choisissez le TAG d'image que vous voulez) sera l'image par défaut du jeu dans le frontend (tag : image).
Par défaut ARRM récupère les images des jeux dans les versions correspondant au langage sélectionné sur l'interface (excepté le russe qui n'est pas présent sur Screenscraper). il est toutefois possible de changer l'ordre de recherche via le formulaire 'Affectation des media 'Screenscraper' + Ordre des medias' . Voir ce chapitre : Assignation des media Screenscraper dans ARRM
Custom Marquee : permet de créer un mini marquee avec wheel/logo intégré en se basant sur le template marque_fanart (marquee). Vous devez posséder les Fanarts et Wheel/Logo des jeux à traiter et faire un '
Recompose Image'. Voir :
Générer des Marquees personnalisés
Force Media Download
Si vous souhaitez forcer la récupération d'autres media/tag lors du scrape, il faut forcer leur récupération en cochant les media voulus ci-dessous. (Ils seront également écrits dans la gamelist)
Récupérer le Manuel (checkbox) : Si cochée, lors du scrape, ARRM récupère également le manual du jeu (la priorité des langues et celles des media textuels) (uniquement sur Screencraper) qu'il place dans le répertoire des manuels du système scrapé. Cela alimente dans la gamelist.xml le Tag 'MANUAL'
Récupérer la Map (checkbox) : Si cochée, lors du scrape, ARRM récupère également la Map du jeu (si existante) (uniquement sur Screencraper) qu'il place dans le répertoire des Maps du système scrapé. Cela alimente dans la gamelist.xml le Tag 'MAP'
Récupérer le Fanart (checkbox) : Si cochée, lors du scrape, ARRM récupère également le Fanart du jeu (si existant) qu'il place dans le répertoire des Fanart du système scrapé. Cela alimente dans la gamelist.xml le Tag 'FANART'
Récupérer le Titleshot (checkbox) : Si cochée, lors du scrape, ARRM récupère également le Titleshot du jeu (si existante) qu'il place dans le répertoire des Titleshot du système scrapé. Cela alimente dans la gamelist.xml le Tag 'TITLESHOT'
Récupérer le Boxback (checkbox) : Si cochée, lors du scrape, ARRM récupère également le Boxback du jeu (image 2D du dos de la Boxart), qu'il place dans le répertoire des Boxback du système scrapé. Cela alimente dans la gamelist.xml le Tag 'BOXBACK'
Récupérer le Extra1 (checkbox) : Si cochée, lors du scrape, ARRM récupère également le media correspondant à la balise Extra1 définit dans 'Affectation des media 'Screenscraper' + Ordre des medias', qu'il place dans le répertoire des Extra1 du système scrapé. Cela permet d'utiliser le media Extra1 dans les templates ARRM. Utilisation possible : media 'marquee' (screenscraper) associé à Extra1 permet d'afficher le marquee arcade dans les templates présentant des bornes d'arcade. Extra1 n'apparaitra pas dans la gamelist, car ARRM se charge de vérifier s'il est présent dans le répertoire dédié à Extra1
Round Wheel (HFSDB / Screenscraper) (checkbox) : disponible depuis la 1913 Beta 4. Si cochée, permet de récupérer les Round Wheels sur HFSDB et Screenscraper dans le répertoire des wheels avec le suffixe -wheelround. Pour Screenscraper le type (carbon ou steel) est sélectionnable dans le module Assignation media Screenscraper. Ce media n'est pas n'est pas enregistrée dans la gamelist. ARRM retrouve le media s'il est présent dans son répertoire dédié
Thème Hyperspin (checkbox) : Si cochée, lors du scrape, ARRM récupère également le Theme Hyperspin sous forme de fichier .zip (uniquement sur Screencraper) qu'il place dans le répertoire des theme du système scrapé. Il n'y a pas de tag dans la gamelist pour le thème hyperspin'
Récupérer le Screenshot (checkbox) : Si cochée, lors du scrape, ARRM récupère également le Screenshot du jeu (si existante) (uniquement sur Screencraper) qu'il place dans le répertoire des Screenshot du système scrapé. Cela alimente dans la gamelist.xml le Tag 'SCREENSHOT'
Récupérer le Boxart (checkbox) : Si cochée, lors du scrape, ARRM récupère également le Boxart du jeu (si existante) (uniquement sur Screencraper) qu'il place dans le répertoire des Boxart du système scrapé. Cela alimente dans la gamelist.xml le Tag 'BOXART'
Récupérer le Wheel (checkbox) : Si cochée, lors du scrape, ARRM récupère également le Wheel du jeu (si existante) (uniquement sur Screencraper) qu'il place dans le répertoire des Wheel du système scrapé. Cela alimente dans la gamelist.xml le Tag 'WHEEL'
Récupérer la Cartouche (checkbox) : Si cochée, lors du scrape, ARRM récupère également le Cartouche du jeu (si existante) (uniquement sur Screencraper) qu'il place dans le répertoire des Cartridge du système scrapé. Cela alimente dans la gamelist.xml le Tag 'CARTRIDGE'
Si vous souhaitez ne récupérer qu'un ou plusieurs de ces éléments de la section 'Force Media Download', il vous suffit de cocher un ou plusieurs de ces éléments et de cocher la case 'Pas d'image, uniquement les textes'. Lors du scrape seules les informations textuelles ainsi que les media cochés seront récupérés.
Overlays (checkbox) : Si cochée, ARRM récupère les overlays des jeux (uniquement sur Screenscraper). Les overlays sont stockés dans le répertoire des overlays que vous avez indiqué. Si vous ne souhaitez récupérer que les overlays, cochez 'Overlays' et 'Pas d'image' et lancez le scrap“). ARRM crée les fichiers de configuration automatiquement en détectant les zones du viewport. Pour beaucoup plus de détail voir le chapitre dédié:
Comment récupérer les overlays des systèmes et des jeux
(bouton) : permet d'accèder aux répertoires contenant les modèles d'overlays.
Dev (checkbox) : Permet de récupérer une image d'overlay avec la zone de viewport détectée par Arrm entourée de jaune. Cela permet de détecter les erreurs d'overlay et des les corriger.
Custom (checkbox) : Priorise les overlays customs (cus). Il est conseillé d'activer cette option car les overlays custom corrigent, bien souvent, certains problèmes de transparence.
4/3 (radio button) : Ne récupère que les overlays au format 4/3 (résolution native sur Screenscraper : 1024×768)
16/9 (radio button) : Ne récupère que les overlays au format 16/9 (résolution native sur Screenscraper : 1920×1080)
Les coordonnées des viewports sont calculées en fonction des résolutions choisies. Ces options s'appliquent également sur la récupération des overlays systèmes.
Défaut Image + Video (button) : (Depuis la version 1.9.0.2 Beta 15) Lorsqu'un scrape trouve une ROM mais que les medias Boxart, Screenshot, Cartridge, Wheel et Video sont manquants, il est possible d'afficher une image/video de substitution. Il faut pour cela cocher la checkbox Activation des images par défaut.
Si l'ensemble de ces quatre media (Boxart, Screenshot, Cartridge, Wheel) sont vides suite à un scrape, les images de substitution ne seront pas utilisées
Gamelist Options
Cet onglet de configuration permet de gérer le comportement du fichier gamelist.xml
Ajout Index (checkbox) : ARRM possède un module de tri sur 5 critères. Actuellement seuls Retropie et Batocera depuis la version 5.22 savent gérer le tri multi critère via un tag <sortname>. Pour Recalbox, il faut utiliser une astuce qui permet ainsi de conserver ce tri et sélectionner dans Emulationstation le tri par nom. Cette option permet donc d'ajouter un index dans la gamelist.xml devant le nom des jeux pour permettre la gestion des tris multi critère. Le tag <sortname> est également écrit dans votre gamelist.xml au cas où votre frontend saurait le prendre en compte. Si le résultat ne vous convient pas il suffira de désactiver cette option et de sauvegarder à nouveau votre gamelist.xml. Exemple de noms de fichiers avec Index :
ARRM utilise ce tag, en ajoutant un index devant le nom dans le <sortname>, afin de pouvoir trier la database suivant certains critères. La contrepartie est que, dans votre Frontend, cela annule la possibilité de faire un 'saut à une lettre donnée'. Si vous souhaitez continuer à faire des 'sauts à une lettre donnée' dans votre frontend, il faut coché cette checkbox Pas de sortname tag et sauvergarder votre gamelist.xml pour prise en compte.
XML en majuscule (checkbox) : Lors de la sauvegarde de la gamelist.xml les champs Nom jeu, Description, Développeur, Editeur, Genre sont mis en majuscule.
pour repasser en minuscule il faudra re-scraper les infos textuelles.</color>
Il suffira de recopier les lignes de ce fichier dans votre fichier batocera.conf.
Cliquez sur l'icône de pour accéder au répertoire contenant ce fichier généré par ARRM. Voir Changer l'émulateur et le core par jeu
ScummVM folders (checkbox) : Lors de la création de gamelist.xml, si vous utilisez Batocera, et si cette case est cochée, ARRM créera automatiquement une balise <folder> avec des informations et l'image du jeu ScummVM comme ceci :
<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>
ARRM folders (checkbox) : Lors de la sauvegarde de la gamelist.xml, permet à ARRM de créér automatiquement des tags <folder> s'il trouve les fichiers suivants dans les répertoires du système en cours : 'folder-nom du dossier.png' et 'folder-nom du dossier.txt'. A décocher si vous utilisez vos propres tags <folder>” . Voir
Personnaliser les sous-dossiers avec image et description
Export gamelist as
Voir la section dédiée : Exporter la gamelist au format Hyperspin, Pegasus, AttractMode, CSV
Exemple de fichier XML Hyperspin pour la snes (snes.xml) :
<?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>
...
Depuis la version 1882 beta 8
Voir video
Exemple de fichier Pegasus metadata.txt pour le système snes
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
Depuis la version 1882 beta 8
Exemple de fichier AttractMode Super Nintendo Entertainment System.txt pour le système snes
#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;;;;;;;;;;;;;;;;;;
Depuis la version 1899 beta 11, Les descriptions des jeux sont sauvegardés dans des fichiers textes individuels par jeux (%romfile%.txt). Ils sont situés dans le dossiers des Romlists (à initialiser dans l'onglet 'Dossier') et dans un sous-répertoire au nom du système traité. Charge à vous de les copier là où ils faut dans votre configuration Attract Mode.
Exemple de fichier
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
10-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;./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;
1944 : 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;
19XX : 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;
2020 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;
Disponible depuis la version 1.9.0.2 Beta 9
Cet onglet permet de sélectionner les TAGs media que l'on souhaite voir apparaitre dans Gamelist.xml.
Lors de la création/sauvegarde de la gamelist.xml, ARRM va créer automatiquement une gamelist_ARRM.xml contenant tous les tags utilisables par ARRM.
Si le media associé existe, le TAG sera écrit dans la gamelist.xml lorsque vous cliquerez sur le bouton Créer gamelist.xml .
Si vous souhaitez utiliser la fonction 'Recompose image', il est important de cocher la checkbox 'Utiliser Gamelist_ARRM.xml' lorsque vous chargez un système afin d'avoir à disposition tous les medias.
Provider Custom (checkbox) : Permet, lors de la création de la gamelist.xml d'ajouter des informations personnelles entre les balises <provider>. Les informations ajoutées sont celles contenues dans le fichier
%appdata%\Nexouille soft\arrm\database\provider_custom.txt. Vous pouvez modifier ce fichier en cliquant sur
Ce fichier est ainsi constitué :
Nom de la balise (au choix) | commentaire/descriptif
exemple :
scraped_by|Nexusone13
information|This pack was done by Nexusone13
version|Updated on 01/31/2022
Vous pouvez donner le nom que vous souhaitez aux balises, excepté provider
Lorsque la gamelist.xml sera générée cela donnera :
<?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>
<game id="37604">
<path>./- Metal Slug/mslug.zip</path>
...
Recalbox/Batocera/Screenscraper/TGBD
Batocera (checkbox) : A cocher si vous utilisez Batocera. Utilisé pour certaines spécificités de ce système (gestion de certains systèmes, liste core, script de d'arrêt/démarrage, gestion des overlays etc…)
Retrobat (checkbox) : A cocher si vous utilisez Retrobat. Utilisé pour certaines spécificités de ce système.
Batocera Plus (checkbox) : A cocher si vous utilisez Batocera Plus. Utilisé pour certaines spécificités de ce système
Lorsque vous choisissez Retrobat ou Batocera Plus, la checkbox Batocera sera également cochée, car les systèmes ont certaines fonctionnalités communes avec Batocera
If Batocera and Retropie are not checked, Recalbox is assumed as the selected Frontend.
Si Batocera et Retropie ne sont pas cochés, Recalbox est considéré comme étant le frontend sélectionné.
Validation auto TGDB / Autres (checkbox) : Lorsqu'un seul jeu est trouvé dans l'
API, la sélection du jeu se fait automatiquement sans afficher la fenêtre de choix. Attention, il se peut que le jeu validé ne soit pas celui recherché (titre de jeu proche de celui cherché etc…). Si plus d'un jeu est trouvé, la fenêtre de sélection de jeu apparaitra.
Ignorer quand # jeux > 1 : Dans le mode Validation Auto, si plus d'un jeu est trouvé, la fenêtre de sélection de jeu n'apparaitra pas si l'option Igorer quand # jeux > 1. Le jeu sera ignoré et non scrapé.
Recherche exacte (checkbox) : effectue une recherche exacte sur le nom du jeu. Exemple : Avec cette option cochée, une recherche sur le nom 'Grand Theft Auto' ne retournera que le jeu 'Grand Thef Auto' alors qu'avec cette option décochée tous les titres Grand Theft Auto seront retournés. Fonctionne sur HFSDB, Lanchbox, GameTDB, SteamDB, GOG, IGDB.
Ignorer la plate-forme (checkbox) : Permet de ne pas filtrer sur la plate-forme (système) lors de la recheche d'un jeu. Fonctionne pour HTGDB, HFSDB, Launchbox, Gametdb, Igdb.
Prévisualise les images sur TGDB (checkbox) : Sur la fenêtre de sélection d'un jeu trouvé sur TheGameDB, affiche ou non un vignette du screenshot/titre/boxart trouvé. Attention cela consomme des appels
API sur TheGamesDB.
TGBD Requêtes rest (label) : l'
API de TheGamesDb limite le nombre d'appel à 1500 requêtes par utilisateur par mois. Vous verrez ici le nombre d'appel qu'il vous reste.
Cliquez sur 'Vérifier identifiant' pour afficher vos autorisations, puis cliquez sur 'validation' pour accepter les informations d'identification actuelles
A partir de la version 1.7.2.0
Cet onglet vous propose différents outils :
ARRM utilise le fichier '%appdata%\nexouille soft\database\systems_sorting.txt' que vous pouvez adapter à vos systèmes. Il ressemble à ceci :
# system_id;system_name;system_manufacturer;system_releasedate;system_type;system_custom_sort (table systems_sorting)
# you can adjust more precisely your sort by assigning a different number to system_custom_sort and sorting on this criteria
#
3do;3DO;Panasonic;1993;console;0
3ds;Nintendo 3DS;Nintendo;2011;portable;0
amiga;Amiga 500;Commodore;1987;computer;0
amiga500;Amiga 500;Commodore;1987;computer;0
amiga500+;Amiga 500+;Commodore;1991;computer;0
amiga600;Amiga 600;Commodore;1991;computer;0
amiga1000;Amiga 1000;Commodore;1985;computer;0
amiga1200;Amiga 1200;Commodore;1992;computer;0
amiga3000;Amiga 3000;Commodore;1990;computer;0
amiga4000;Amiga 4000;Commodore;1992;computer;0
amigacd32;Amiga CD32;Commodore;1993;console;0
amigacdtv;CDTV;Commodore;1991;console;0
amstradcpc;Amstrad CPC;Amstrad;1984;computer;0
apple2;Apple II;Apple;1977;computer;0
arcade;Arcade;Various;1980;arcade;0
atari2600;Atari 2600;Atari;1977;console;0
atari5200;Atari 5200;Atari;1982;console;0
atari7800;Atari 7800;Atari;1986;console;0
atari800;Atari 800;Atari;1979;computer;0
atarifalcon;Atari Falcon030;Atari;1992;computer;0
atarijaguar;Jaguar;Atari;1993;console;0
atarijaguarcd;Atari Jaguar CD;Atari;1995;console;0
atarilynx;Lynx;Atari;1989;portable;0
atarist;Atari ST;Atari;1985;computer;0
atarixe;Atari XE;Atari;1985;computer;0
atomiswave;Atomiswave;Sammy;2003;arcade;0
...
Si vous avez des systèmes non standard dans votre 'es_systems.cfg' il est impératif de les ajouter dans ce fichier, en respectant la syntaxe, avant d'exécuter le tri. Modifier le fichier, quitter, puis relancer le module de tri pour prise en compte des changements du fichier.
Update Best Arcade Core (button) : permet de mettre à jour la database avec les meilleures core arcade en fonction des jeux. Utilise les fichiers 'fba_libretro.csv' , 'mame2003.csv' , 'mame2010.csv' issue de BestArcade . Ces fichiers se trouvent dans '%appdata%\nexouille soft\arrm\database'. Le bouton 'Maj Core' utilise cette database.
Récupère Systèmes Wheels” (button) : récupère, sur Screenscraper, les wheels & Wheels carbon sur Screenscraper pour les systèmes présents et pour l'arcade à partir des systèmes contenu dans les fichiers systemes_screenscraper.txt et arcadesystemname_long.txt. Utilisé pour afficher les logos des systèmes dans les templates (tag : system). Le système doit être reconnu sur Screenscraper afin que cette procédure retourne des wheels & wheels carbon.
Pad 2 Keyb : En cliquant sur
vous pourrez créer/modifier le fichier
.p2k.cfg (ou
.keys pour Batocera) pour le système sélectionné. Ce fichier permet d'assigner au joypad, des touches du clavier. Utile pour les émulateurs d'ordinateurs qui utilisent parfois dans les jeux, des touches du clavier. Voir explications :
https://wiki.recalbox.com/fr/advanced-usage/pad-to-keyboard
Si vous souhaitez convertir les fichiers .p2k de Recalbox en fichiers .keys compatibles Batocera je vous invite à utiliser l'utilitaire
RecopierBox de Soaresden, qui proprose également d'autres utilitaires pour Recalbox/Batocera
Depuis ARRM 1917 Beta 9, vous pouvez maintenant spécifier des noms de systèmes qui correspondent à Arcade, PC/DOS, ScummVM, Daphne/Singe. (utilisé par ARRM pour les traitements spécifiques à ces systèmes). Utile si vos dossiers systèmes ne correspondent pas à arcade/pc/dos/scummvm/daphne/singe. Les éléments doivent être séparés par un ;
Video Encoder
Handbrake parameters (textbox) : permet de modifier les paramètres de compression video de handbrake. Si vide, les valeurs par défaut suivantes sont appliquées :
-Z “Gmail Small 10 Minutes 288p30” –crop 0:0:0:0 -f av_mp4 . Liste des
differents presets (-Z) utilisables. Le preset par défaut permet de réduire les videos de plus de la moitié. Voir :
Compresser les videos pour gagner de l'espace de stockage
FFmpeg parameters (textbox) : permet de modifier les paramètres de compression video de FFmpeg. Si vide, les valeurs par défaut suivantes sont appliquées :
-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 Documentation FFmpeg Voir :
Compresser les videos pour gagner de l'espace de stockage
Vous pouvez essayer ces autres paramètres pour FFmpeg :
-ac 1 -c:v libx264 -pix_fmt yuv420p -crf 35 -preset:v slow -y
Autre Paramétrage de l'utilisateur Fourch qui permet de garder la durée d'origine, 60 fps, et avoir une qualité équivalente aux vidéo normalisées, pour quasiment le même poids. Un peu plus de temps à encoder mais meilleure qualité :
-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
Documentation FFmpeg. See : Compresser les vidéos pour économiser de l'espace de stockage
Video+Overlay compress parameters (textbox): permet de modifier les paramètres de compression vidéo de FFmpeg qui s'appliqueront à la vidéo générée par le bouton 'Video+Overlay' si la checkbox 'Compresser vidéo' est cochée. Si vide, les valeurs par défaut suivantes sont appliquées: -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
Image Encoder
Convert Recalbox Overlays
Si vous avez déjà des overlays Recalbox mais que vous souhaitez les convertir afin de les utiliser sur Batocera.
ARRM propose un convertisseur. Il parcourra votre dossier Overlays Recalbox, récupérera les informations de positionnement dans le fichier .cfg associé et recréera les fichiers .info compatibles Batocera. Les fichiers .png peuvent également être récupérés. (depuis la beta 1882)
Recalbox Overlays Folders : Indiquez ici le répertoire Overlays de
Recalbox . Cela peut être
\\recalbox\share\overlays ou tout autre répertoire contenant le dossier
overlays avec l'arborescence spécifique aux superpositions
Recalbox .
Une fois la conversion terminée, vous pouvez accéder au répertoire Overlays converti Folder en cliquant sur .
Parameter File
A partir de la 1882 beta 22
Vous pouvez visualiser et modifier les fichiers de configuration de ARRM. En cliquant sur un fichier vous avez sa description. En cliquant sur vous ouvrez le fichier dans votre éditeur de texte par défaut.
Après avoir modifié des fichiers de configuration, il est nécessaire, pour éviter tout problème, de relancer ARRM.
Create empty Rom file when no exists (Dev) (checkbox) : Depuis la version 1903 Beta 3 Lors du chargement de la gamelist.xml, si le fichier ROM n'existe pas, ARRM crééra un fichier vide. Cette fonctionnalité est utilisée par le développeur et n'est pas mémorisée.
Mise à jour
Disponible depuis la version 1.9.1.1 beta 9
Régulièrement des fichiers sont mis à jour.
Si vous souhaitez en profiter sans avoir à attendre une version finale, vous pouvez passer par l'onglet Mise à jour
La date de la dernière mise à jour d'un fichier est affichée après le nom du fichier au format aaaa/mm/jj
Cet onglet vous permet de mettre à jour différents fichiers de configuration d' ARRM :
Configurations files : Sélectionnez les fichiers que vous souhaitez mettre à jour puis cliquez sur le bouton Mettre à jour. L'ancien fichier sera renommé en .old par précaution. Ces fichiers de configurations proposés avec chaque nouvelle version d'ARRM, inclus dans le zip de l'application. Mais entre deux versions il vous faudra faire cette mise à jour via ce bouton.
Arcade to Database : Vous pouvez mettre à jour les fichiers DAT/XML dans la base de données ARRM. Elle est utilisée avec la fonction 'Renommer avec DAT' sur les systèmes Arcade. Cette fonctionnalité a pour but de trouver dans la base de données ARRM, le bon titre d'un jeu Arcade basé sur son nom de fichier (normalisé pour l'Arcade). Pour mettre à jour la base de données ARRM vous devez mettre vos fichiers DAT (.dat ou .xml) dans le dossier : %appdata%\Nexouille Soft\arrm\Database\dat , puis cliquez sur ce bouton. De nouveaux enregistrements seront ajoutés ou modifiés à la base de données existante. Cela peut être long. Vous pouvez voir quel format de fichier .xml ou .dat est compatible en regardant les fichiers présents dans le dossier %appdata%\Nexouille Soft\arrm\Database\dat\samples . Il est nécessaire que ces fichiers .dat/.xml respectent cette structure.
DAT to Database : Pour mettre à jour la database de recherche par Datfiles. Le traitement peut être très long. Voir wiki pour le mode opératoire :
Mettre à jour la Database avec des nouveaux Datfiles . En cliquant sur
vous accéder au répertoire contenant les DatFiles (%appdata%\Nexouille Soft\Arrm\Database\Tosec)
Cet onglet vous permet d'accèder à différentes pages :
Discord ARRM pour suivre l'évolution du logiciel, faire des demandes ou discuter.
Video tuto sur Youtube (la video date et ne présente pas les nombreuses autres fonctions ajoutées depuis sa mise en ligne)
-
-
-
Lien pour accéder au
forum ARRM sur le site des Jujuvincebros
Liens pour faire une donation
-
Send debug info to developer (bouton) : Si vous rencontrez un bug ou un comportement non attendu d'ARRM, cliquez sur ce bouton pour envoyer automatiquement par mail au développeur, un log de votre config ARRM et rapport de dernier scrape.
Aller à Présentation de l'interface d'ARRM