Nous détaillerons ici les 7 panels qui composent l'interface d'ARRM

Merci de consulter le chapitre précédent qui détaille tous les onglets du panel de configuration d'ARRM.

• Dossier Roms (textbox) : Indiquez ici le chemin d'accès au répertoire roms (réseau ou local). Exemple :
  • \\recalbox\share\roms (si vous accédez à votre recalbox par réseau)
  • E:\recalbox\share\roms (si vous accédez à la carte mémoire/disque de votre recalbox connecté à votre PC

• Répertoire des overlays (textbox) : Indiquez ici le chemin d'accès au répertoire racine qui contiendra les overlays. :
  • Pour Batocera : \\batocera\share
  • Pour Recalbox : \\recalbox\share
  • Pour Retropie : \\retropie

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.

• Avec Recalbox les répertoires générés seront 'overlays' et 'system' à recopier dans '\\recalbox\share'
• Avec Batocera le répertoire généré sera 'decorations' à recopier dans '\\batocera\share'
• Avec Retropie le répértoire généré sera 'configs' à recopier dans '/opt/retropie' sur votre Retropie

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.

• Afficher / Screenscraper (bouton) : Si vous ne sélectionnez qu'un système, le bouton 'Afficher' apparaît. Si plusieurs systèmes sont sélectionnés, le bouton Screenscraper apparait.
  • Afficher (bouton) : En cliquant sur ce bouton, ARRM va charger dans la database le fichier Gamelist.xml ou le créer puis vérifier la cohérence avec les Roms présentes dans le répertoire. Si des Roms ne sont pas présentes dans le Gamelist.xml elles seront ajoutées dans la Database. Inversement si des Roms présentes dans la gamelist.xml n'existent pas dans le répertoire, elle ne seront pas prises en compte dans la Database. Pendant cette phase, ARRM vérifie l'existence des fichiers images présents dans la gamelist.xml et supprime la référence si le fichier image n'existe pas dans le répertoire. Une fois ces traitements terminés, la database s'affiche.
  • Screenscraper (bouton): En cliquant sur ce bouton, ARRM va traiter séquentiellement chacun des systèmes automatiquement. Il effectue le traitement du bouton 'Afficher' ci-dessus puis lance un scrape automatiquement sur Screenscraper (uniquement), sauvegarde la gamelist.xml, puis passe au système suivant.

• Recompose image (bouton) : Si plusieurs systèmes sont sélectionnés, le bouton 'Recompose image' apparaît. Il permet d'appliquer le template à toutes les roms des systèmes sélectionnés. Le template sera celui par défaut, si 'Template auto association' ou 'Auto template' ne sont pas cochés; sinon ce sera le template associé au système traité qui sera appliqué.

• Pad 2 Keyb : En cliquant sur vous pourrez créer/modifier le fichier .p2k.cfg 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://recalbox.gitbook.io/documentation/v/francais/utilisateur-avance/configurations/pad-to-keyboard

• All (bouton) : Sélectionne tous les systèmes.

• Reset Systèmes (bouton) : Dé-sélectionne tous les systèmes cochés.

• Ouvrir dossier (bouton) : Permet d'ouvrir le dossier système sélectionné.

• Overlay système (bouton) : Récupération des overlays des systèmes sélectionnés, et création des fichiers de configuration des overlays. Il seront stockés dans le répertoire mentionné dans Répertoire des overlays. Voir le paragraphe spécifiquement consacré à la récupération des overlays jeux et systèmes. Le bouton permet d'accèder au répertoire contenant les fichier modèles d'overlays.

• Utiliser gamelist ARRM (checkbox) : lorsque qu'une gamelist.xml est créée par ARRM, ARRM créé une copie gamelist_ARRM.xml. Lorsqu'on choisit un système, si la checkbox 'utiliser ARRM gamelist' est cochée, ARRM utilisera ce fichier gamelist_ARRM.xml et non pas le fichier gamelist.xml qui a pu être modifié par le frontend. Cela permet de ne pas perdre les tags customs d'ARRM qui ont pu être éffacés par le Frontend. Ceci est utile pour quelqu'un qui revient sur les gamelists pour effectuer par exemple une «recomposition d'images» ou d'autres manipulations proposées par ARRM. Sinon, cela ne devrait pas poser de problèmes.

Remarque : Vous pouvez également retrouver des sauvegardes de gamelist dans le répertoire %system%\backup

• 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%\roaming\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.

Cette fenêtre que j'appelle la Database contient les informations qui seront écrites dans la gamelist.xml lors de sa sauvegarde/création. Certains champs sont éditables, mais il est préférable de passer par le panel 'Rom Informations' qui applique des contrôles de saisie.

Cette database est remplie lors de la sélection d'un système. Elle va contenir les infos de la gamelist.xml (si elle existe) et les fichiers présents dans le répertoire système en cours (s'ils n'existaient pas dans la gamelist.xml existante)

En tapant sur une lettre sur la Database (si triée par ordre alphabetique), l'index (surbrillance) se positionnera sur le 1er nom de jeu trouvé commençant par cette lettre.

Undock/Dock (bouton) : permet de détacher la database du formulaire principal et ainsi de pouvoir le déplacer le redimensionner. Exemple avec la database détachée :

Tout sélectionner (bouton) : Sélectionne tous les éléments de la database.
Tout désélectionner (bouton) : Dé-sélectionne tous les éléments de la database.
Aucun filtre (bouton) : Supprime tous les filtres appliqués à la database.

Sur cette Database nous allons pouvoir appliquer des

• Filtres
• Recherches
• Des actions, déclenchées par divers boutons du panel 'Actions possibles sur Roms sélectionnées' (4)

Les Filtres :

• Sans image (checkbox) : Filtre la Database pour afficher les Roms ayant le Tag image vide
• Sans description (checkbox) : Filtre la Database pour afficher les Roms ayant le Tag description vide
• Sans video (checkbox) : Filtre la Database pour afficher les Roms ayant le Tag video vide
• Sans screenshot (checkbox) : Filtre la Database pour afficher les Roms ayant le Tag screenshot vide
• Sans boxart (checkbox) : Filtre la Database pour afficher les Roms ayant le Tag boxart vide
• Sans marquee (checkbox) : Filtre la Database pour afficher les Roms ayant le Tag marquee vide
• Sans manuel (checkbox) : Filtre la Database pour afficher les Roms ayant le Tag manual vide

Ces filtres peuvent être combinés entre eux en appliquant l'opérateur ET / OU qui s'appliquera sur l'ensemble des conditions cochées. L'opérateur OR et le plus souvent utilisé. Exemple :

• Avec ET : 'Sans description' ET 'Sans image'
• Avec OU : 'Sans description' OU 'Sans video'

• Filtrer (bouton) : Permet d'activer les filtres définis ci-dessus

• Overlays manquants (bouton) : Sélectionne les overlays non trouvés lors de la précédente recherche d'overlays. Les overlays manquants se trouvent dans le fichier _missing_overlays_%SYSTEM%.txt dans le répertoire logs_arrm du système en cours.

Remarque : Lorsque vous scrapez tout ou partie des roms en demandant la récupération des overlays, les roms dont les overlays n'ont pas été trouvés seront écrites dans le fichier missing_overlays_%SYSTEM%.txt situé dans le répertoire du logs_arrm du système en cours. Lors d'un prochain scrap, le précédent fichier sera sauvegardé avec la date du jour. exemple : _missing_overlays_ATARI2600_20191116-1520.txt

• Liste Favoris (bouton) : Filtre la Database pour n'afficher que les Roms ayant le Tag favoris coché
• Liste Cachés (bouton) : Filtre la Database pour n'afficher que les Roms ayant le Tag cachés coché
• Tout sélectionner (bouton) : Sélectionne toutes les Roms de la Database
• Tout désélectionner (bouton) : Ne sélectionne aucune Rom de la Database
• Aucun filtre (bouton) : Désactive tous les filtres appliqués à la Database
• Montrer cachés (bouton) : Si coché (par défaut), affiche également les Roms ayant le Tag caché coché. Ce filtre est persistant.

Les Recherches :

• Genre (Listbox) (bouton) : Permet de filtrer la Database sur un Genre (parmi ceux trouvés dans les Roms du système sélectionné)
• Recherche chaine dans Titre, Desc ou nom Rom (Listbox) : Permet de filtrer la Database sur une chaîne de caractère. La recherche s'effectue sur les champs Titre ou Description ou Nom de fichier Rom
• Filtrer les roms dupliquées sur (bouton) : Permet de faire une recherche des roms dupliquées suivant 3 modes. Les recherches se font sur les noms de roms ou de fichiers expurgés des () et des [] :
  • Nom : recherche les Roms contenant dans le nom de jeu une partie de nom d'une autre rom. Exemple : les nom de jeu suivant apparaissent comme dupliqués jeu 'Astérix' , 'Astérix And The Great Rescue' et 'Astérix And The Secret Mission'. Charge à vous de faire votre sélection.
  • Nom exact : recherche les Roms contenant dans le nom de jeu le nom exact d'une autre rom. Utile si vous possédez des clones (fichier rom différent) mais dont le nom de jeu est identique. A appliquer une fois les jeux scrappés car les noms de jeux retournés seront exacts. Exemple : les roms 'Speedball (Europe) (Mirrorsoft).zip' et 'Speedball (Europe) (Virgin).zip' retourneront le même nom de jeu (Speedball)
  • Fichier : recherche les Roms contenant dans le nom de fichier une partie du nom de fichier d'une autre Rom. Exemple : 'Back to the Future Part II (Europe).zip' et 'Back to the Future Part III' (Europe).zip

Pensez à supprimer le filtre en cliquant sur 'Aucun filtre' après usage.

Toutes les actions associées aux boutons de ce menu s'appliquent sur les Roms sélectionnées (mise en surbrillance) dans la Database

• Tag en Favori (bouton) : Met en Favoris les Roms sélectionnées
• Tag en Caché (bouton) : Met en Caché les Roms sélectionnées
• Tag en Normal (bouton) : Met en Normal les Roms sélectionnées (enlève les tags Favoris et Caché)
• Verif nom via MD5 (bouton) : Vérifie le bon nom du jeu sur Screenscraper avec son MD5
• Créer M3U (bouton) : Voir Créer des fichier .M3U pour des Roms multi-disques
• Verification des Roms (bouton) : Applique les checkbox 'Nettoie nom', 'Ajout disk, 'Garde nom Rom' et 'Ajouter Pays' pour les Roms sélectionnées
• Rom comme nom du jeu (bouton) : Renomme les fichiers sélectionnés avec le nom du jeu. Les checkbox 'Nettoie nom', 'Ajout disk, 'Garde nom Rom' et 'Ajouter Pays' sont également appliquées. Attention lorsque vous renommez des fichiers .bin/.cue .iso/.cue .bin/.lst , le contenu des fichiers textes (.cue/.lst) n'est pas modifié. Pensez à le modifier pour être en accord avec le nouveau nom de fichier .bin/.iso.
• Maj du Core (bouton) : Pour les systèmes Arcade (FBA, MAME, Neogeo), permet d'affecter l'emulateur et le core le mieux adapté d'après le fichier BestArcade4Recalbox.
• Supprimer image (bouton) : Efface physiquement les fichiers images des Roms sélectionnées.
• Vérifier si image existe (bouton) : Vérifie si les images indiquées dans le database existent bien, sinon supprime les références à ces images dans la Database
• Déplacer dans dossier (bouton) : Déplace les Roms sélectionnées dans un autre dossier. Si le dossier destination est en dehors du dossier parent, la Rom sera déplacée et supprimée de la gamelist actuelle. Si le dossier destination est un dossier racine d'un système, la gamelist du dossier destination sera mise à jour.
• Recompose image (bouton) : Applique le template par défaut choisi ou celui associé (si 'Auto template' est coché) sur les Roms sélectionnées en utilisant les images déjà récupérées en utilisant les balises screenshot, boxart, marquee, cartridge de la database. Si un tag est absent et que l'option 'ignore recherche locale' n'est pas activée, ARRM recherche la présence des images manquantes dans le répertoire images.
• CRC32 (bouton) : Calcule et stocke le CRC32 dans la balise <hash> pour les Roms sélectionnées. Utilisé pour le Netplay sous Recalbox
• MD5 (bouton) : Calcule le MD5 et stocke dans la balise <md5> pour les Roms sélectionnées. Le MD5 est calculé sur le fichier Roms et non pas sur la Rom contenu dans le fichier .Zip ou .7z.
• .Zip (checkbox) : En cochant cette case le calcul du MD5 ou du CRC32 se fait en priorité sur le fichier contenu dans le fichier .Zip/.7z
• Réinit core/emu (bouton) : Permet d'appliquer un émulateur et un core à partir d'une liste pour les Roms sélectionnées.
• Supprimer METADATA (bouton) : Supprime les METADATA (info de la gamelist) et ne conserve que le nom de fichier ROM et le nom du jeu extrait du nom de fichier Rom.
• mamedb.org (bouton) : Recherche les infos des Roms sélectionnées (en surbrillance) sur le site MameDB.org. Ce site ne donne que des infos relatives aux jeux mêmes. Les infos ont assez succintes et il ne retourne qu'un screenshot.
• TheGamesDB.net (bouton) : Recherche les infos des Roms sélectionnées (en surbrillance) sur le site TheGamesDb. Priorisez plutôt la plateforme Screenscraper qui est beaucoup plus fournie.
• Screenscraper (bouton) : Recherche les infos des Roms sélectionnées (en surbrillance) sur le site Screenscraper. Priorisez ce scraper qui est complet et rapide.
• (bouton) : Pour chacun des scraper (TheGamesDb.net et Screenscraper), permet d'associer le nom de système présent sur votre Recalbox/Batocera avec son identification sur le site de Scrape. les fichiers se trouvent dans %appdata%\roaming\Nexouille Soft\arrm\database\systemes_screenscraper.txt et systemes_tgbd.txt. Vous pouvez ajouter d'autres systèmes.

Exemple de contenu du fichier 'systemes_screenscraper.txt' :

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

• Choisir Mix Modèle (bouton) : Permet de choisir à partir d'une liste, le Template à appliquer lorsque 'Mix'a été choisi dans 'Image Options'
• Auto template (checkbox) : Lors d'un scrap, permet d'associer un template à un système grâce au fichier '%appdata%\roaming\Nexouille soft\arrm\database\template_association.txt', que vous pouvez éditer en cliquant sur le bouton .

Cet écran vous permet de choisir les templates à utiliser. Vous pouvez ici paramétrer trois types de templates : Default (non auto template) , Default (auto template) , System (auto template)

Sur la gauche de l'écran :

Le panel Default (non auto template) indique le template par défaut qui sera utilisé pour tous les systèmes scrapés lorsque la checkbox 'Auto template' n'est pas cochée. Pour le sélectionner, il vous suffit de choisir un template dans la liste est de cocher sur le bouton 'Définir comme template par défaut' situé sous le template sélectionné.

Sur la droite de l'écran, dans la section 'Auto Template Settings':

Le panel Default (auto template) indique le template par défaut qui sera utilisé pour tous les systèmes scrapés lorsque la checkbox 'Auto template' est cochée. Pour le sélectionner, il vous suffit de choisir un template dans la liste est de cocher sur le bouton 'Définir comme template par défaut'.

Le panel System (auto template) indique le template qui sera utilisé pour le système séléctionné lorsque la checkbox 'Auto template' est cochée. Pour le sélectionner, il vous suffit de choisir un template dans la liste est de cocher sur le bouton 'Définir comme template pour 'nom du système''.

Ces actions mettent à jour le fichier '%appdata%\roaming\Nexouille soft\arrm\database\template_association.txt'

Le bouton 'Editer le fichier XML' permet d'ouvrir dans votre éditeur de fichier texte, le fichier XML du template sélectionné et de le modifier. Voir la section Créer son propre template pour ARRM

Le bouton 'Voir Répertoire' permet d'ouvrir le répertoire contenant le fichier .XML et les fichiers images associés.

Le bouton 'Quitter' permet de fermer cet écran et revenir à l'écran principal.

Merci de lire la section consacrée : Modifier des informations de Roms

• Export as Hyperspin XML (checkbox) : Lors de la sauvegarde de la gamelist.xml, un fichier XML compatible Hyperspin contenant les informations textuelles est également créé.

• 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.

Attention : pour repasser en minuscule il faudra re-scraper les infos textuelles.

le fichier 'scrape_log.txt' est positionné dans le sous-répertoire 'logs_arrm' du système sélectionné.