Recalbox, Retropie, Batocera and EmulationStation compatible

 Développé par Franck Pouilly / Nexusone13 et les JujuVinceBros

 

 

Description en Français

 La video présente une des toutes premières version d'ARRM qui a fortement évolué

J’utilise l’excellent Recalbox depuis quelques temps.  Souhaitant modifier qq descriptions, ajouter des favoris ou cacher certaines roms de façon simple et scapper qq roms sur ScreenScraper, MameDb et theGamesDb, j’ai écrit ce petit utilitaire ARRM (Another Recalbox Roms Manager) pour mon usage personnel. Je le mets à disposition s’il peut vous être utile.  Toutes les zones de saisie ainsi que les boutons possèdent leur Info Bulle afin de connaitre leur fonction. Ce logiciel est également compatible avec Batocera, Retropie et EmulationStation.

 

Avertissement

ARRM ne propose pas de Roms de jeux, ni ne permet de les télécharger; il utilise les Roms que vous possèdez. La récupération des images se fait sur les sites suivants : Screenscraper, TheGamesDb et The MameDb.

 

Attention :

- Je vous recommande d'activer le mode 'Extra Tag (4 images)' via le menu 'Options générales' cela permet d'offrir plus de possibilité.
- Avant de mettre à jour vos gamelist.xml, pensez à stopper Emulationstation en cliquant sur le bouton "Stop EmulationStation"
- Pensez à utiliser le bouton "Backup all gamelist" avant de travailler sur vos gamelist.
- Avant de désinstaller une version antérieure, pensez à faire un backup de vos Mix personnalisés (si vous en avez fait)

 

Quelques fonctionnalités 

- Compatible avec Recalbox , Batocera, Retropie et EmulationStation
- Interface en français, anglais, espagnol, portugais, allemand.
- Tous les boutons possèdent des infos bulles afin de guider l'utilisateur
- Possibilité de scrapper à l’unité ou en masse de façon automatique des roms sur ScreenScraper, MameDb et TheGamesDb.net avec récupération des images et informations
- Peut récupérer les infos de boxart, screenshot, wheel, mix image, cartridge, video et les mettre dans la gamelist.xml avec des noms de balises personnalisables (utile pour des thèmes personnalisés)
- Récupération des infos textuelles dans la langue choisie.
- Un module Mix'Me permet de choisir les images que l'on souhaite (drag & drop possible) et de les appliquer au Template choisi
- Images par defaut lorsqu'aucune image n'est trouvée lors du scrape
- Mise à niveau de la gamelist.xml en fonction des fichiers roms présents sur le disque
- Mise en favoris , caché, normal de Roms en masse.
- Tri possible de la gamelist selon 5 niveaux de critères.
- Filtre des roms sans images
- Filtre des roms sans description
- Filtre sur les genres , ou sur une chaine de caractère sur le nom fichier ou titre de rom.
- Possibilité de forcer un scrape avec un MD5 entré par l'utilisateur.
- Modification des diverses informations d’une rom
- Suppression en masse des fichiers images ne correspondant à aucune rom de la gamelist
- Backup des gamelist.xml de tous les systèmes
- Sauvegarde des gamelist.xml modifiées via le programme
- Deplacement de roms dans un sous repertoire du répertoire parent tout en conservant les informations scrapées
- Deplacement de roms dans un repertoire racine d'un autre système tout en conservant les informations scrapées
- Peut retrouver le bon titre d'une rom via son MD5 via screenscraper
- Peut ajouter le n° de disk, face ou k7 après le nom du jeu (si présent dans le nom du fichier)
- Missing liste pour les jeux non trouvés
- Peut récupérer spécifiquement les boxart Japonaises
- Export de la gamelist dans un fichier au format .csv
- Possibilité d'utiliser des templates prédéfinis (ou les créer vous même) pour les image mixées (screenshot+boxart+marquee+cartridge) et de les personnaliser via des fichiers XML de configuration
- Possibilité de récupérer les boxart 2D ou 3D
- Application d'un template de votre choix sans rescrape en utilisant les images précedemment téléchargées via ARRM ( utilisation des 4 images récupérées via l option "extra tags" de ARRM)
- ARRM récupère automatiquement les images issues d'autres scraps, ou créees manuellement si présentes dans le repertoire downloaded_images
- Mix Scrape avec 10 layers possibles (couches)
- Plusieurs templates sont disponibles et personnalisables
- Possibilité de déplacer les articles (le, la, les et ceux des autres langues ES/POR/GER/FR)  en fin de nom. Exemples :  The Legend of Zelda : Ocarina of Time -> Legend of Zelda, The : Ocarina of Time   ou  The Bard's Tale -> Bard's Tale, The
- Calcul du hash pour les jeux en Netplay

 

Précisions à propos du processus de recherche d'images manquantes en local:

Arrm permet de récupérer automatiquement des images stockées localement lorsqu'aucune image n'est trouvée sur le site de scraping. Ces images peuvent être issues d'un précedent scrap (Arrm ou autres scraper) ou créees par l'utilisateur
Plusieurs formats sont possibles :
<fichier_rom> peut être égal à <nom_du_ficher_rom> ou <titre_du_jeu> en fonction de la case à cocher "image comme rom" dans 'Image options'
Vous pouvez ajouter manuellement vos fichiers images en respecant le format ci-dessous (privilégiez le format avec suffixe "_screenscraper_screenshot_arrm" , "_screenscraper_boxart_arrm", "_screenscraper_wheel_arrm", "_screenscraper_cartridge_arrm")

Quand le scrape ou le recompose ne trouve pas d'image pour le type correspondant (screenshot, boxart, wheel, cartridge), ARRM recherche dans l'ordre indiqué ci-dessous les images suivantes (le dernier trouvé sera celui utilisé) :
Le bouton recompose image essaye de reconstituer une image à partir des url des Tag images (screenshot, boxart, wheel, cartridge) présents dans la database. Si un Tag est absent, le processus de recherche d'images locales est executé.

******** Screenshot ***************
<fichier_rom>.png/jpg
ou <fichier_rom>-image.png/jpg
ou <fichier_rom>.png/jpg
ou <fichier_rom>_screenshot.png / jpg

Pour les 3 types d'images ci-dessus, ARRM verifie si "Considéré comme mix" est coché, sinon ARRM demande, via un popup, à l utilisateur d'indiquer si c'est un Mix (aucun template ne sera appliqué) ou si c'est un screenshot (le template s'appliquera).
Dans le cas de choix de Mix, le fichier Mix issue de ces images aura le suffixe "_customnomix_screenshot_arrm"

ou <fichier_rom>_screenscraper_screenshot_arrm.png / jpg
ou <fichier_rom>_screenscraper_screenshot_arrm_JAP.png / jpg
ou <fichier_rom>_thegamesdb_screenshot_arrm.png / jpg
ou <fichier_rom>_custom_screenshot_arrm.png / jpg
si MIX est choisi <fichier_rom>_customnomix_screenshot_arrm.png / jpg
si MIX est choisi <fichier_rom>_customnomix_mix_arrm.png / jpg

******** Boxart ***************
<fichier_rom>_boxart.png / jpg
ou <fichier_rom>_screenscraper_boxart_arrm.png / jpg
ou <fichier_rom>_screenscraper_boxart_arrm_JAP.png / jpg
ou <fichier_rom>_thegamesdb_boxart_arrm.png / jpg
ou <fichier_rom>_custom_boxart_arrm.png / jpg

******** Wheel/Marquee ***************
<fichier_rom>_marquee.png / jpg or or
ou <fichier_rom>_wheel.png / jpg
ou <fichier_rom>_screenscraper_wheel_arrm.png / jpg
ou <fichier_rom>_screenscraper_wheel_arrm_JAP.png / jpg
ou <fichier_rom>_thegamesdb_wheel_arrm.png / jpg
ou <fichier_rom>_custom_wheel_arrm.png / jpg

******** Cartridge ***************
<fichier_rom>_cartridge.png / jpg
ou <fichier_rom>_screenscraper_cartridge_arrm.png / jpg
ou <fichier_rom>_screenscraper_cartridge_arrm_JAP.png / jpg
ou <fichier_rom>_custom_cartridge_arrm.png / jpg

 

Accès aux contenus des mises à jour / changelog

 Vous pouvez télécharger de nouveaux Templates pour ARRM (contient les fichiers et parfois le .pfi associé) : cliquez ici

 

 Vous pouvez signaler les bugs, ou discuter de cet outil dans le forum dédié ou nous rejoindre sur le chat textuel Discord 

Dons (Merci beaucoup :D ) : https://streamlabs.com/jujuvincebrosfr

 

---

 

Description in English

The video presents one of the very first version of ARRM which evolved strongly

I use the excellent Recalbox for some time. Wishing to change descriptions, add favorites or hide some roms in a simple way and scape some roms on ScreenScraper, MameDb and theGamesDb, I wrote this little utility ARRM (Another Recalbox Roms Manager) for my personal use. I make it available if it can be useful to you. All input areas and buttons have their Bubble Info to know their function. This tool is compatible with Batocera, Retropie and EmulationStation too.

 

Disclaimer

ARRM does not offer gaming ROMs, nor does it allow them to be downloaded; he uses the ROMs you own. Image recovery is done on the following sites: Screenscraper, TheGamesDb and The MameDb.

 

Some features:

- Compatible with Recalbox, Batocera, Retopie and EmulationStation
- Interface in French, English, Spanish, Portugues, German
- All buttons have bubble info to guide the user
- Ability to scrape to the unit or mass automatically roms on ScreenScraper, MameDb and TheGamesDb.net with recovery of images and information
- Can retrieve boxart info, screenshot, wheel, mix image, cartridge, video and put them in the gamelist.xml with customizable tag names (useful for custom themes)
- Retrieving text information in the chosen language.
- Default images when no image has been retrieved during the scrape
- Upgrading the gamelist.xml based on the roms files on the disk
- Setting favorites, hidden, normal Rom in mass.
- It is possible to sort the gamelist.xml on 5 criteria levels
- Filter of roms without images
- Filter of roms without description
- Filter on genres, or on a string on the file name or title of rom.
- Ability to force a scrape with an MD5 entered by the user.
- Modification of various information of a rom
- Bulk deletion of image files that do not match any rom in the gamelist
- Backup of gamelist.xml from all systems
- Backup of modified gamelist.xml via the program
- Moving roms into a subdirectory of the parent directory while keeping the scraped informations
- Moving roms in a root directory of another system while keeping the scraped informations
- Can find the good title of a rom via its MD5 via screenscraper
- Can add the disk number, face or k7 after the name of the game (if present in the file name)
- Missing list for games not found
- Can specifically recover Japanese boxart
- Export the gamelist to a file in .csv format
- Ability to use predefined templates (or create them yourself) for mixed images (screenshot + boxart + marquee) and customize them via XML configuration files
- Ability to recover 2D or 3D boxart
- Application of a template of your choice without rescrape by using the images previously downloaded via ARRM (use activation of the 3 images recovery via the option "extra tags" of ARRM)
- Scrape Mix with 10 layers
- ARRM automatically retrieves images from other scraps, or manually created if present in the downloaded_images directory
- Several customisable Templates are included
- A Mix'Me module allow the user to choose image (pickup or drag & drop) and to apply chosen template on them
- Ability to move items (the, the, and those of other languages ES / POR / GER / FR) at the end of the name. Examples: The Legend of Zelda: Ocarina of Time -> The Legend of Zelda, The: Ocarina of Time or The Bard's Tale -> Bard's Tale, The
- Rom Hash computation for Netplay

 

Warning
- I recommend you to activate the mode 'Extra Tag (4 images)' via the menu 'General Options' it allows to offer more possibilities.
- Before updating your gamelist.xml, remember to stop emulationstation by clicking on "stop emulationstation" button.
- Remember to use the "Backup all gamelist" button before working on your gamelist.
- Before uninstall previous version, remember to backup you custom mix (if you have done some)

 

Details about the search process for missing images locally :

Arrm can automatically retrieve locally stored images when no image is found on the scraping site. These images can be from a previous scrap (Arrm or other scraper) or created by the user
Several formats are possible:
<rom_file> can be <rom_filename> or <game_title> depending on the "image as rom" checkbox in 'Image options'
You can manually add your image files by following the format below (it it better to use the format with the suffix "_screenscraper_screenshot_arrm", "_screenscraper_boxart_arrm", "_screenscraper_wheel_arrm", "_screenscraper_cartridge_arrm"

When the scrape or the "recompose image" does not find an image for the corresponding type (screenshot, boxart, wheel, cartridge), ARRM searches in the order indicated below the following images (the last found will be the one used):
The button recompose image tries to reconstitute an image from the url of the image tags (screenshot, boxart, wheel, cartridge) present in the database. If a tag is missing, the local image search process is executed.

 

******** Screenshot ***************
<rom_file>.png/jpg
ou <rom_file>-image.png/jpg
ou <rom_file>.png/jpg
ou <rom_file>_screenshot.png / jpg

For the 3 types of images above, ARRM checks if "Considered as mix" is checked, otherwise ARRM asks, via a popup, to the user to indicate if it's a Mix (no template will be applied) or if it's a screenshot (the template will apply).
In the case of choice of Image Mix, the Mix file resulting from these images will have the suffix "_customnomix_screenshot_arrm"

ou <rom_file>_screenscraper_screenshot_arrm.png / jpg
ou <rom_file>_screenscraper_screenshot_arrm_JAP.png / jpg
ou <rom_file>_thegamesdb_screenshot_arrm.png / jpg
ou <rom_file>_custom_screenshot_arrm.png / jpg

if MIX is chosen <rom_file>_customnomix_screenshot_arrm.png / jpg
if MIX is chosen <rom_file>_customnomix_mix_arrm.png / jpg

******** Boxart ***************
<rom_file>_boxart.png / jpg
ou <rom_file>_screenscraper_boxart_arrm.png / jpg
ou <rom_file>_screenscraper_boxart_arrm_JAP.png / jpg
ou <rom_file>_thegamesdb_boxart_arrm.png / jpg
ou <rom_file>_custom_boxart_arrm.png / jpg

******** Wheel/Marquee ***************
<rom_file>_marquee.png / jpg or or
ou <rom_file>_wheel.png / jpg
ou <rom_file>_screenscraper_wheel_arrm.png / jpg
ou <rom_file>_screenscraper_wheel_arrm_JAP.png / jpg
ou <rom_file>_thegamesdb_wheel_arrm.png / jpg
ou <rom_file>_custom_wheel_arrm.png / jpg

******** Cartridge ***************
<rom_file>_cartridge.png / jpg
ou <rom_file>_screenscraper_cartridge_arrm.png / jpg
ou <rom_file>_screenscraper_cartridge_arrm_JAP.png / jpg
ou <rom_file>_custom_cartridge_arrm.png / jpg

 

Access to the content of the updates / changelog

You can download new Templates for ARRM (contains files et sometimes the associated .pfi so you can modify the templates) : click here

 

 

You can report bugs or discuss about this tool in the dedicated forum or join us on the Discord text chat : 

Donate (Many thanks :D ) : https://streamlabs.com/jujuvincebrosfr

 

---

 

Captures d'écran / Screenshots

cliquez sur l'image pour l'agrandir / click on picture to enlarge

 

FR : Ecran principal
EN : Main screen

 

 

FR :  Ecran de choix des Templates
EN : Templates choice screen

 

 

FR : Ecran des Tags (balises xml) personnalisés et images par defaut (si image absente lors du scrap) et activation de la récupération des 4 images (screenshot / boxart / marquee / cartridge)
EN : Customized Tags (Xml tags) screen (if no image during scrap) and activation of 4 images recovery (screenshot / boxart / marquee / cartridge)

 

 

FR : Ecran de choix entre Mix et Screenshot lors de la découverte d'image en local lorsque le scrap n a pas trouvé d'image. 
EN : Screen of choice between Mix or Screenshot during the discovery of local image when the scrap did not find an image.

 

 

FR : Ecran du Mix'Me qui permet de composer son propre Mix en selectionnant les fichiers images (drag & drop possible) correspondant aux 4 tags disponibles. Il est aussi possible de choisir une image d'un Mix déjà fait.
EN : Mix'Me screen that allows you to compose your own Mix by selecting the image files (drag & drop possible) corresponding to the 4 available tags. It is also possible to choose an image of a Mix already made.

 

 

FR : Ecran de Scrape sur TheGamesDB.net 
EN : Scraping form from The GamesDB.net.

  

---

 

Directories structures recognized in Recalbox / Batocera / Retropie
Structure des répertoires reconnue dans Recalbox / Batocera / Retropie

Vous pouvez choisir un autre nom pour 'downloaded_images' dans le menu de configuration général d'ARRM. 
You can choose another name for 'downloaded_images' in ARRM main configuration menu.

\\recalbox\share\roms
│  
├───atari7800
│   │   Ace of Aces (USA).a78
│   │   Alien Brigade (USA).a78
│   │   Asteroids (USA).a78
│   │   …
│   │   gamelist.xml
│   │   …
│   └───downloaded_images
│       │   Ace of Aces (USA)_screenscraper_boxart_arrm.png
│       │   Ace of Aces (USA)_screenscraper_cartridge_arrm.png
│       │   Ace of Aces (USA)_screenscraper_mix_arrm.png
│       │   Ace of Aces (USA)_screenscraper_screenshot_arrm.png
│       │   Ace of Aces (USA)_screenscraper_wheel_arrm.png
│       │   Alien Brigade (USA)_screenscraper_boxart_arrm.png
│       │   Alien Brigade (USA)_screenscraper_cartridge_arrm.png
│       │   Alien Brigade (USA)_screenscraper_mix_arrm.png
│       │   Alien Brigade (USA)_screenscraper_screenshot_arrm.png
│       │   Alien Brigade (USA)_screenscraper_wheel_arrm.png
│       │   Asteroids (USA)_screenscraper_boxart_arrm.png
│       │   Asteroids (USA)_screenscraper_cartridge_arrm.png
│       │   Asteroids (USA)_screenscraper_mix_arrm.png
│       │   Asteroids (USA)_screenscraper_screenshot_arrm.png
│       │   Asteroids (USA)_screenscraper_wheel_arrm.png
│       │   …              
├───atarist
├───colecovision
├───…

 

---

 

 

Merci aux personnes suivantes pour leur don

Thanks to the following people for the donation

• Stephane R. (from Canada)
• Gaetan D.
• ViRuS-Man (from the Recalbox forum)

Merci aux personnes suivantes pour leurs suggestions et remontées de bug

Thanks to the following people for their suggestions and bug reports

• AnkX (from the recalbox forum)
• ViRuS-Man (from the recalbox forum)
• Secamfr (from the recalbox forum)
• Outlaw (from the recalbox forum)
• chris256 (from the recalbox forum)
• ninjaw (from the recalbox forum)
• TotalRecall (from the recalbox forum)
• Jay (from the recalbox forum)
• RetroVadus (from the recalbox forum)
• Zing (from the recalbox forum)

   

• Tuxboy (from the recalbox forum)
• PilafSama (from the recalbox forum)
• Marwyn91 (from the recalbox forum)

Un grand merci à Zing pour la promotion d'ARRM auprès de la communauté de langue Portuguaise sur le forum Recalbox et l'aide à la traduction d'ARRM en portugais :)
Many thanks to Zing for promoting ARRM to portuguese speaking community on the Recalbox forum and help with the translation of ARRM into Portuguese :)