ARRM (Another Recalbox Roms & Gamelist Manager)

arrm

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

Description en Français

Depuis quelques temps, j’utilise l’excellent Recalbox. Ce frontend, utilisable sur raspberry ou pc/linux permet de faire tourner des emulateurs d'anciennes console, ainsi que le très bon media center Kodi. 
Souhaitant modifier les descriptions de  roms de jeux, les ajouter aux favoris ou les cacher de façon simple et accessoirement de scapper quelques 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.

 

 

Quelques fonctionnalités :

- Compatible avec Recalbox ,  Batocera et EmulationStation
- Interface en français ou en anglais
- Récupération des vrais noms de jeu Mame/Fba/Neogeo/Scummvm via une database
- 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 différents critères (date, note, nom, genre....)
- Filtre des roms sans images
- Filtre des roms sans description
- 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
- Filtre sur les genres , ou sur une chaine de caractère sur le nom des roms.
- 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 scrappées
- Deplacement de roms dans un repertoire d'un autre système
- Peut retrouver le bon titre d'une rom via son CRC32 via une database local ou sur screescraper
- 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
- Peut récupérer les infos de boxart, screenshot, wheel, mix image, video et les mettre dans la gamelist.xml avec des noms de balises personnalisables (utile pour des thèmes personnalisés)

 

mises à jour:

v 1.4.3.5 (15/04/2018)

* Prise en compte du playcount et du lastplayed dans la gamelist
* Possibilité d'ajouter des balises personalisées dans le gamelist.xml via le bouton "Extra Tag + Defaut Image". Les informations concernant le boxart, screenshot, marquee, mix et la video (télécharge la video) peuvent être récupérées et mises dans la gamelist.xml.
     Le nom des balises peut être personnalisé, mais il faut conserver une balise "image" pour la compatibilité avec Recalbox.
     (La dernière version d'emulationstation, pas encore disponible sur Recalbox, reconnait les balises "video" et "marquee")
* Possibilité de mettre une image par défaut (pour chaque tag personnalisé) lorsque l'image n est pas trouvée lors d'un scrap.
* Possibilité de rechercher le bon nom d'un jeu grâce à son MD5 sur screenscraper via le bouton "Verif nom via MD5" (suppression de la database locale des crc qui n'était pas à jour)
* Ajout des Checkbox "Ajout Disk" et "Nettoie Nom" activable lors d'un scrap, d'une recherche "Verif nom via MD5", ou de l'ajout du n° disk/tape/side
     "Nettoie nom" permet de supprimer les caractères entre () et [] et place les articles (le, la, les...) en début de nom
     "Ajout disk" permet d'ajouter en fin de nom le n° disk/tape/side ainsi que AGA/CD32 (pour amiga)
* Ajout d'un bouton "Join the chat discord" pour rejoindre le chat textuel discord afin de signaler des bugs ou demander des fonctionnalités
* Ajout d'un lien cliquable "changelog" pour voir l'historique des changements de l'application
* Zone "Statut" augmentée afin d'afficher plusieurs lignes de messages applicatifs
* Les fichiers textes tels que la gamelist & extensions s'ouvrent désormais avec votre editeur de texte par défaut
* Liste editable (bouton : 'Edit No MD5') des extensions sur lesquelles le calcul du MD5 ne se fera pas (afin de gagner du temps)
* correction bug avec autosave : Tous les jeux sont selectionnés automatiquement quand "Sauve auto Gamelist" est coché et que vous cliquez sur "créer gamelist.xml des roms selectionnées"
* Ajout d'un button 'ScummVM noms courts' qui pointe sur un site web indiquant les noms courts utiliser avec vos fichier .scummvm
* Correction de nombreux bugs

 

v 1.4.3.2 (03/28/2018)

* Correction d'un bug de database qui empéchait le fonctionnement de l'application
* ajout d'une verification de la bonne version de database au lancement du programme
* correction bug : le nombre de joueur n'était pas récupéré via screenscraper (merci outlaw)

v 1.4.3.1 du 27/03/2018

* correction d'un bug de la v 1.4.3.0 : le scrap sur scummvm et dos indiquait des roms manquantes par erreur.
* déplacement du bouton 'extra tag' afin qu'il soit accessible dés le lancement de l'appli

v 1.4.3.0 du 25/03/2018

* possibilité d'ajouter des balises personalisées dans le gamelist.xml via le bouton 'extra tag'. Les informations concernant le boxart, screenshot,wheel, mix et video peuvent être récupérée et mis dans la gamelist.xml.
Le nom des balises peut être personnalisé, mais il faut conserver une balise 'image' pour la compatibilité avec Recalbox. (requête d'Outlaw)
* correction d'un bug, lors de scrap sur des sous dossiers (tel que DOS ou Scummvm) le fichier rom était considéré manquant

- v 1.4.2.0 (22/03/2018)

* Meilleure recherche sur screenscraper via md5 et sha1 (si CRC box cochée, à utiliser pour les roms n'ayant pas de media lors de la rercherche sans crc)
* Ajout d'une case à cocher "JAP" permettant de récupérer les Boxarts japonais si existant sur la database de Screenscraper
* Lors de la recherche de rom dans le système Amiga1200, si le terme "AGA", "CD32" , "CD 32" (avec ou sans parenthèse) est trouvé dans le nom de fichier, la recherche
s'effectue sur la bonne plateforme dans screenscraper (le terme AGA ou CD32 est ensuite ajouté au nom du jeu, pour le différencier) (demande de NinjaW)
* Ajout d'un fichier indiquant les roms non trouvées dans le scrapper (format : _missing_arrm_%SYSTEM%_%SCRAPPER%.txt) (demande de Virus-Man)
* Les noms de fichier media sont modifiés les suffixes suivants sont ajoutés au nom de fichier image :
screenshots : "_nomduscrapper_screenshot_arrm"
boxart : "_nomduscrapper_boxart_arrm"
mixed : "_nomduscrapper_mix_arrm"
le suffixe JAP est ajouté si un boxart japonais est présent dans l'image
* Correction de quelques bugs

- v 1.4.1.1 (11/03/2018) :
correction bug exception sur recherche avec certains nom de jeu (samsho2ka.zip par exemple) sur screenscraper

- v 1.4.1.0 (10/03/2018) :
Gestion différente du mix si screenshot au format portrait (shmup verticaux) ou paysage
Les tag <folder> dans le gamelist sont préservés si vous en aviez et remis tel quel dans la nouvelle gamelist. Utile si vous aviez personnalisé des sous-dossiers avec une image. (merci virus-man)
Correction d'un bug lors de l'appui sur le bouton 'effacer rom' et divers bugs

- v 1.4.0.0 (09/03/2018) : Ajout du support de Screenscraper pour la récupération d'informations (en Fr ou En) et d'images (merci à screenscraper pour leur base de données complète et rapide)
La recherche sur ScreenScraper se fait sur le nom du fichier, puis le nom du jeu et finalement crc (si coché, attention le calcul de crc peut être long sur les images iso )
Ajout d'un bouton "sauve auto gamelist" pour sauvegarder automatiquement votre gamelist lorsque vous changez de système ou fermez l'application.
Correction de quelques bugs

- v 1.3.3.0 (20/02/2018) : 
Ajout de la gamecube, Nintendo DS, Saturn, WII dans la recherche sur TheGamesDB
Ajout bouton permettant d'ajouter le n° de disk, face ou k7 après le nom du jeu (si présent dans le nom du fichier)
Changement du comportement lors de la récupération d'image Mix : 
- Si pas de screenshot, on récupére uniquement le boxart en grand format.
- Dans l'image Mix, le boxart et le Logo/Titre sont désormais un peu plus grand.

 - v 1.3.2.0 (10/02/2018) : mise à jour pour inclure les nouveaux systèmes de la dernière version de recalbox (database mise à jour pour les crc des nouveaux systèmes. Correction de divers bugs.

- v 1.3.1.0 (20/01/2018) : L'application fait désormais 1240x670 afin d'être affichable dans son intégralité sur des écrans en 1280x720. La fenêtre de recherche de TheGamesDB est désormais centrée sur la fenêtre parent. 

- v 1.3.0.0 (13/01/2018) :
Bouton (Verif bon nom via CRC) pour tenter de retrouver le bon titre d'une rom via son CRC32. Permet à TheGamesDB de trouver plus facilement les jeux.
Checkbox (nettoie nom) associée au bouton (Verif bon nom via CRC) permet lors de cette vérification de formater le titre du jeu en supprimant les caractères entre () et [] et autres embellissements
Correction de divers petits bugs.

 

Attention : Depuis la version 1.3.0.0 une nouvelle table a été ajoutée dans la database.
Si vous rencontrez ce message d erreur :
"Unhandled exception has occured in your application... The Microsoft Jet database engine cannot find the input table or query "dat_database". Make sure it exists and that its name is spelled correctly".
Pensez à bien supprimer vos anciennes installations. et supprimer le répertoire c:\users\votre_identifiant\appdata\roaming\nexouille soft\arrm (s'il existe tjs) avant de reinstaller la nouvelle version.


- v 1.2.9.0 (05/01/2018) : Interface et info bulles en Français et Anglais (merci TotalRecall pour la suggestion). Correction d'un bug sur le renommage de roms, et divers autres petits bug.
- v 1.2.7.0 (30/12/2017) : Deplacement des roms dans un sous répertoire du répertoire parent sans perdre les informations scrappées. Correction de nombreux bugs.
- v 1.2.5.0 (28/12/2017) : Correction d'un bug avec la base de registre; ajout d'une checkbox "No Image" afin d'éviter le téléchargement d'images sur thegamesdb et MameDb et ainsi ne pas écraser les scrapp existants. Ajout d'une checkbox pour vérifier l'existence de mise à jour au lancement du programme. Ajout d'un lien donation via paypal.
- v 1.2.0.0 (26/12/2017)  : Recherche des roms dans les sous répertoires (merci Virus-Man pour le report), Choix du type d'image (boxart, screenshot, mixed) à récupérer lors du scrapp en auto sur TheGamesDB, Backup de la database et de la liste des extensions par système (ils sont écrasés à chaque mise à jour)

 

 

Attention :

- 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.
- Lorsque vous avez fini vos modifications sur la database, selectionnez les elements de la database (Select all, ou select ceux que vous voulez dans la gamelist) et cliquer sur le bouton : "Create gamelist.xml for selected roms" 

 

 

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

 

 

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

Site Officiel Recalbox : http://www.recalbox.com

 

Ecran principal (Français):    Ouvrir l'image dans une nouvelle fenêtre pour la voir en grand

arrm front

 

Ecran des Tags (balises xml) Personnalisés et images par defaut (si image absente lors du scrap). Ouvrir l'image dans une nouvelle fenêtre pour la voir en grand

arrm front

 

Scrapping form from The GamesDB.net.  Ouvrir l'image dans une nouvelle fenêtre pour la voir en grand

arrm scrapp


 


Description in English

I use the excellent Recalbox for some time. Wishing to change descriptions, add favorites or hide some roms in a simple way and scapped  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 too.

 

Some features:

- Compatible with Recalbox , Batocera and EmulationStation
- Interface in english or french
- Recovery of the real names of game Mame / Fba / Neogeo / Scummvm via a database
- Upgrading the gamelist.xml based on the roms files on the disk
- Set rom to favorite, hidden, normal
- gamelist can be sorted on several criteria (date, name, genre...)
- Filter roms without images
- Filter roms without description
- Ability to scrape one or several roms, manually or automaticall (search for exact name without prompt) on ScreenScraper, MameDb and TheGamesDb.net with recovery of images and informations
- Filter on genres, or on a string on the name of the roms.
- Changing the various informations of a roms
- Bulk deletion of image files that do not match any roms in the gamelist
- Backup of gamelist.xml from all systems
- Backup of modified gamelist.xml via the program.
- Moving romfiles in a subfolder of the parent folder wiithout losing scrapped informations
- Moving romfiles in a folder of different system
- Can retrieve the right name of a game from his CRC32 via a local database
- Can add disk number, side number or K7 number after the gametitle (if présents in the filename)
- Can retrieve Japanese Boxart
-Can retrieve boxart info, screenshot, wheel, mix image, video and put them in the gamelist.xml with customizable tag names (useful for custom themes)

 

Updates:

v 1.4.3.5 (04/15/2018)

* Taking into account the "playcount" and "lastplayed" in the gamelist
* Ability to add custom tags in the gamelist.xml via the button "Extra Tag + Default Image". The information about boxart, screenshot, marquee, mix and video (download video) can be retrieved and put in the gamelist.xml.
     Tag names can be customized, but you need to keep an "image" tag for compatibility with Recalbox.
     (The latest version of Emulationstation, not yet available on Recalbox, recognizes the tags "video" and "marquee")
* Ability to put a default image (for each custom tag) when no image is found during a scrap.
* Ability to search for the correct name of a game via its MD5 on screenscraper via the button "Check name with MD5" (deletion of the local database of CRC that was not up to date)
* Add Checkbox "Add Disk" and "Clean Name" activable during a scrap, a search of correct name, or the addition of the # Disk/Tape/Side
     "Cleans name" allows to delete the characters between () and [] and places the articles (the, a, an, they ...) at the beginning of the name
     "Add disk" allows to add at the end of the name the disk/tape/side as well as AGA/CD32 (for amiga)
* Added a "Join the chat discord" button to join the discord text chat to report bugs or request features
* Added a changelog clickable link to view application change history
* "Status" zone increased to display several lines of application messages
* Text files like gamelist & Extensions now opens with your system default text editor
* Editable list (button : 'Edit No MD5') of extensions on which the calculation of the MD5 will not be done (in order to save time)
* bug fix with autosave: All games are automatically selected when "autosave Gamelist" is checked and you click on "create gamelist.xml for selected roms"
* Added a 'ScummVM short names' button that points to a website indicating short names to use with your .scummvm files
* Fixed many bugs

v 1.4.3.2 (03/28/2018)

* Fixed a database bug that prevented the application from working
* Added a check of the correct version of database when launching the application
* Bug fix: the player count was not recovered via screenscraper (thx outlaw)

v 1.4.3.1 (03/27/2018)

* bug fix of v 1.4.3.0: scraping scummvm and Dos Roms can indicate missing roms by mistake.
* move the 'extra tag' button so that it is accessible when the app is launched

v 1.4.3.0 (03/25/2018)

* You can add custom tags in the gamelist.xml via the button 'extra tag'. Informations about boxart, screenshot, wheel, mix and video can be retrieved and put in the gamelist.xml.
Tag names can be customized, but you need to keep an 'image' tag for compatibility with Recalbox. (Outlaw request)
* Fixed a bug, when scraped on subfolders (such as DOS or Scummvm) the rom file was considered missing

v 1.4.2.0 (03/22/2018)

* Improve search on screenscraper via md5 and sha1 (if CRC box is checked, to use for Rom who do not have media when searching without CRC)
* Added a Checkbox "JAP" to retrieve Japanese Boxarts if existing on the Screenscraper database
* When searching roms for Amiga1200 system, if the term "AGA", "CD32", "CD 32" (with or without parenthesis) is found in the file name, search
is done on the correct platform on screenscraper (the term AGA or CD32 is then added to the name of the game, to differentiate it) (NinjaW request)
* Added a file indicating the roms not found in the scrapper (format: _missing_arrm_%SYSTEM% _%SCRAPPER% .txt) (Virus-Man request)
* The media file names are changed and the following suffixes are added to the image file name:
screenshots: "_scrappername_screenshot_arrm"
boxart: "_scrappername_boxart_arrm"
mixed: "_scrappername_mix_arrm"
the suffix JAP is added if a Japanese boxart is present in the image
* Fixed some bugs

- v 1.4.1.1 (03/11/2018) :
exception bug fix when searching with some games name (samsho2ka.zip for example) on screenscraper

- v 1.4.1.0 (03/10/2018) :

Manage mixed images differently if screenshot is in portrait format (vertical shmup) or landscape
The <folder> tags in the gamelist are preserved if you had them and put them back in the new gamelist. Useful if you had customized subfolders with an image. (thanks virus-man)
Fixed a bug when pressing the 'clear rom' button and various bugs

- v 1.4.0.0 (03/09/2018): Added support for Screenscraper for information retrieval (in Fr or En) and images (thanks to screenscraper for their complete and fast database)
The search on ScreenScraper is done on the name of the file, then the name of the game and finally crc (if checked, attention the calculation of crc can be long on the images iso)
Added a "save auto gamelist" button to automatically save your gamelist when you switch systems or close the application.
Fixed some bugs

- v 1.3.3.0 (02/20/2018) : 
Add Gamecube, Nintendo DS, Saturn, Wii in TheGamesDB search.
Add a button to add disk number, side number or K7 number after the gametitle (if présents in the filename)
When retrieving Mixed image : 
- if there is no screenshot, retrieve only the Boxart in a large format.
- In Mixed image, Boxart and Logo/Title are little bigger.

- v 1.3.2.0 (02/10/2018) : updated to include new systems from the new version of recalbox (databse updated with crc from this new systems). Fix some bugs.

- v 1.3.1.0 (01/20/2018) : the application window is now 1240x670 so it can be displayed in its entirety on 1280x720 screens. TheGamesDB search window is now centered on the parent window.
- v 1.3.0.0 (01/13/2018) :
Button (Check good name with CRC) to try to find the good title of a rom via its CRC32. Allows TheGamesDB to find games more easily.
Checkbox (clean name) associated with the button (Check good name with CRC) allows during this verification to format the title of the game by deleting the characters between () and [] and other embellishments
Fixed various small bugs.

 

Warning: Since version 1.3.0.0 a new table has been added to the database.
If you encounter this error message:
"Unhandled exception has occured in your application... The Microsoft Jet database engine cannot find the input table or query "dat_database". Make sure it exists and that its name is spelled correctly".
Remember to delete your old installations. and delete the directory "c:\users\votre_identifiant\appdata\roaming\nexouille soft\arrm" (if it still exists) before reinstalling the new version.


- v 1.2.9.0 (01/05/2018) : Interface and tooltips in french and english. Fix bug on renaming roms and others little bugs.
- v 1.2.7.0 (12/30/2017) : Moving roms in a subfolder of the parent folder without losing scrapped informations. Fixes of several bugs.
- v 1.2.5.0 (12/28/2017) : Fixed a bug with the registry base; added a "No Image" checkbox to avoid downloading images on thegamesdb and MameDb and thus not overwrite existing scrapp. Addition of a checkbox to check the existence of update at the launch of the program. Add a donation link via paypal.
- v 1.2.0.0 (12/26/2017)  : Search for roms in subfolders (thx Virus-Man for the report), Selection of the image type (boxart, screenshot, mixed) to download when scappring auto from TheGamesDB, Backup of the database and extension list (they are deleted when updating)

 

 

 

 Warning
-  Before updating yout 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.
- When you have finished your changes on the database, select the elements of the database (Select all, or select the ones you want in the gamelist) and click on the button: "Create gamelist.xml for selected roms"

 

 

 

 

 

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

 

 

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

Officel Recalbox site : http://www.recalbox.com

Main Form (English) : open the picture in a new windows to maximize

arrm front

 

Screen form for custom Tags (xml tag) and default images (when image is missing from scrap) open the picture in a new windows to maximize

arrm front

 

Scrapping form from The GamesDB.net  open the picture in a new windows to maximize

arrm scrapp