Créer les fichiers .m3u à la main est simple pour trois jeux, fastidieux pour trois cents. Recalbox M3U Master est un script Windows écrit par un membre de la communauté qui parcourt vos dossiers de roms, repère les jeux découpés en plusieurs disques et écrit les playlists à votre place — ou vérifie celles que vous avez déjà.
Si vous ne savez pas encore ce qu'est un fichier
.m3uni à quoi il sert, lisez d'abord Gérer les jeux multi-disques avec un fichier .m3u. Cet outil ne fait qu'automatiser ce qui y est décrit.
recalbox_m3u_master_v2_37_nobom.bat — version 2.37.
C'est un fichier .bat qui pilote PowerShell : il fonctionne sur Windows uniquement. Il travaille sur vos roms depuis votre ordinateur, pas depuis la Recalbox — utilisez-le sur une copie locale de vos jeux, ou directement sur le partage réseau de votre Recalbox monté en lecteur.
Cet outil n'est pas développé par l'équipe Recalbox et n'est pas fourni avec le système. Comme tout script qui écrit et supprime des fichiers, faites un essai en mode « vérification seule » avant de le lâcher sur toute votre collection.
.bat à la racine de votre dossier roms, ou directement dans le dossier d'un système.Le script reconnaît les dossiers de systèmes à la présence du fichier _lisezmoi.txt que Recalbox dépose dans chacun d'eux. C'est aussi dans ce fichier qu'il lit le nom lisible du système (« Panasonic 3DO » plutôt que 3do) et, quand il les y trouve, la liste des extensions acceptées — ce qui lui permet de ne scanner que les fichiers pertinents. À défaut de _lisezmoi.txt, il utilise le nom du dossier et scanne toutes les extensions.
Ces fichiers
_lisezmoi.txtsont créés par Recalbox lui-même dans chaque dossier système, quelle que soit la langue de votre interface. Si vous avez fait le ménage dans vos dossiers de roms et les avez supprimés, le script fonctionnera quand même, mais en mode dégradé.
| Option | Ce qu'elle fait |
|---|---|
| 1 — Create M3U only | Recrée les .m3u de tous les jeux multi-disques détectés. Un .m3u existant est déplacé dans un dossier M3U Backup avant d'être réécrit. |
| 2 — Create + verify | Comme l'option 1, puis vérifie que chaque playlist correspond bien à ce qui était attendu. |
| 3 — Verify only | Ne modifie rien. Signale les .m3u absents et ceux dont le contenu diffère de l'attendu. |
| 4 — Count multi-disc per system | Ne modifie rien. Compte les jeux multi-disques par système — utile pour un état des lieux. |
| 5 — Create missing M3U only | Ne crée que les playlists manquantes, sans toucher aux .m3u existants. |
| 6 — Delete ALL M3U | Supprime tous les .m3u trouvés, sauf ceux rangés dans les dossiers M3U Backup. |
| 7 — Delete ALL "M3U Backup" folders | Supprime tous les dossiers de sauvegarde M3U Backup. |
| 8 — Quit | Ferme le script. |
Dans le doute, commencez toujours par l'option 3 pour voir l'état de votre collection, puis l'option 5 pour compléter ce qui manque sans rien écraser. L'option 2 est celle à utiliser quand vous voulez repartir sur des playlists entièrement régénérées.
Les numéros de disque sont reconnus dans plusieurs notations courantes : (Disc 1), (Disk 1), (CD 1), ainsi que Disc 1, Disk 2, CD 3 et CD1, CD2 sans parenthèses.
La détection est volontairement limitée à cinq disques par jeu. C'est un garde-fou contre les faux positifs : sans cette limite, un jeu dont le nom contient un nombre élevé produirait des avertissements absurdes du type « disques 33 à 6808 manquants ».
Sont exclus du scan :
.xml (les gamelists, notamment) ;videos, images, CUE et M3U Backup, ainsi que tout leur contenu.Les chemins écrits dans les .m3u sont toujours relatifs — de simples noms de fichiers, un par ligne :
Resident Evil - Code - Veronica (France) (Disc 1).chd
Resident Evil - Code - Veronica (France) (Disc 2).chd
À la fin de chaque passage, le script affiche un tableau de compteurs :
| Indicateur | Signification |
|---|---|
| Folders | Nombre de dossiers systèmes traités |
| ROMs | Nombre de roms scannées, exclusions déduites |
| Multi | Nombre de jeux multi-disques détectés |
| Created | Nombre de .m3u créés |
| Overwrote | Nombre de .m3u remplacés, l'ancien étant parti en sauvegarde |
| Unchanged | .m3u déjà présents et laissés tels quels (option 5) |
| Verify OK | .m3u présents et conformes |
| Missing | .m3u attendus mais absents |
| Different | .m3u présents dont le contenu ne correspond pas à l'attendu |
| Orphans | .m3u ne correspondant à aucun jeu multi-disque détecté |
| Warnings | Anomalies détectées : disque manquant dans une série, extensions mélangées… |
| Notes | Informations non bloquantes, par exemple un fichier « Disc 4 » isolé |
| Errors | Échecs d'accès disque, de lecture, d'écriture ou de suppression |
Une ligne M3U Missing Summary récapitule le total : Total M3U : 42 / 63 signifie que 42 playlists existent sur les 63 attendues.
Pour garder la console lisible, le détail des avertissements n'est pas affiché à l'écran : tout est écrit dans recalbox_m3u_master_log.txt, créé à côté du script. On y trouve les motifs exacts, par exemple :
| Motif | Signification |
|---|---|
HOLE: <jeu> missing 2 |
Il manque le disque 2 dans la série |
MIXED_EXT: <jeu> has .chd .cue |
Les disques d'un même jeu n'ont pas tous le même format |
SINGLE_DISC_TAG: <jeu> only disc 4 found |
Un fichier marqué « Disc 4 » sans les autres disques |
WRITE_FAIL / READ_FAIL / DELETE_FAIL |
Un fichier n'a pas pu être écrit, lu ou supprimé |
.chd et un autre en .cue.Script écrit et partagé par Zaker, membre de la communauté Recalbox, en réponse à un besoin personnel.
Une question, un bug, une suggestion sur cet outil ? Le Discord Recalbox est le bon endroit pour en parler.