Sommaire · English

Destination et transferts

Tout ce qui est décrit sur cette page se règle dans l'étape Sortie, en quatre cadres : Destination (le dossier, et que faire s'il n'est pas vide), Écriture des fichiers (mode, conflits, vérification, archives d'un seul jeu), Jeux multi-disques (sous-dossier, playlist) et Arborescence (modèle, articles, dossiers des DAT d'un lot, aperçu). La croix au bout du champ de la destination le vide.

L'étape Sortie

Modèle d'arborescence

Le Modèle décrit les dossiers créés pour chaque jeu, avec des variables entre accolades. Par exemple, avec {publisher}/{year}/{title}/, le fichier Another World (1991)(Delphine)(FR)[!].adf va dans Delphine/1991/Another World/.

Saisissez le modèle dans le champ, ou utilisez les deux menus placés dessous :

Insérer une variable insère une variable à la position du curseur (à la fin, comme nouveau dossier, si vous n'avez pas cliqué dans le champ). Les variables de toutes les conventions viennent d'abord ; suivent celles des noms TOSEC (éditeur, année, chipset...), celles des catégories MAME (genre, catégorie), puis celle du DAT. Toutes restent dans le menu : celles qui n'ont pas de valeur avec la convention actuelle sont grisées, et leur infobulle dit quand elles s'appliquent (les variables TOSEC quand la convention est TOSEC ou pas encore connue, ou qu'un DAT TOSEC d'un lot est coché, celles des catégories en MAME, celle du DAT dès qu'un DAT est choisi).
Préréglages remplace le modèle par un modèle tout prêt :

Préréglage	Modèle	Pour
Éditeur / année / titre (TOSEC)	`{publisher}/{year}/{title}/`	Les collections TOSEC
Pays / titre (No-Intro, Redump)	`{country}/{title}/`	Les consoles rangées par région
Lettre / titre	`{letter}/{title}/`	Des dossiers alphabétiques
Chipset / lettre / titre (Amiga)	`{chipset}/{letter}/{title}/`	Un dossier par Amiga (AGA, OCS-AGA, OCS-ECS)

Choisir un préréglage repasse sur Dans des dossiers, selon le modèle si Tout à la racine était choisi (voir plus bas).

Aperçu en direct

En bas du cadre Arborescence, l'aperçu montre où le tri écrirait trois fichiers avec les options actuelles : destination, dossiers et nom du fichier (une archive .zip en mode ZIP). Il se met à jour pendant la saisie, et quand changent la source, la convention, le DAT, la destination, le mode ou les options ci-dessous.

Les fichiers sont les premiers de la source dont le nom suit la convention. Seuls leurs noms sont lus : aucun CRC n'est calculé et aucune archive n'est ouverte. Une archive est donc montrée sous son propre nom.
Sans source, ou si aucun de ses premiers fichiers ne suit la convention, l'aperçu montre des exemples intégrés de la convention, sous le titre Exemples.
Avec un DAT, le tri nomme un fichier identifié par le DAT d'après l'entrée du DAT : l'aperçu, qui ne lit aucun CRC, garde le nom de la source.
Avec un lot de DAT, les exemples vont dans le dossier du premier DAT coché de leur convention, comme ses fichiers.

L'aperçu signale un modèle qui ne ferait pas ce qu'il dit : une variable inconnue (le tri la supprime), une accolade sans paire (elle resterait dans le nom du dossier), ou un modèle qui écrit dans _unmatched, le dossier des fichiers non conformes.

Variables

Variable	Contenu	Exemple
`{title}`	Titre, sans les balises techniques	`Another World`
`{letter}`	Première lettre du titre (`#` pour les chiffres et symboles)	`A`
`{country}`	Pays ou région, tel qu'écrit dans le nom	`FR`, `Europe`
`{language}`	Langue, telle qu'écrite dans le nom ; à défaut, celle de son pays (un nom TOSEC comme `(FR)` l'omet)	`fr`, `M3`
`{version}`	Version ou révision	`v1.1`
`{publisher}`	Éditeur (TOSEC)	`Delphine`
`{year}`	Année de sortie (TOSEC)	`1991`
`{system}`	Système ou modèle d'ordinateur (TOSEC)	`A500`
`{chipset}`	Chipset qu'une version Amiga demande (TOSEC) : `AGA` (AGA seulement), `OCS-AGA` (les deux, ou corrigée pour AGA), `OCS-ECS` (tout le reste, un nom sans marque compris)	`AGA`
`{video}`	Standard vidéo (TOSEC)	`PAL`
`{dump_status}`	Statut du dump (TOSEC)	`Verified`, `Clean`, `Cracked`, `BadDump`
`{genre}`	Genre de la machine, d'après le fichier de catégories (MAME)	`Shooter`
`{category}`	Genre et sous-genre de la machine (MAME)	`Shooter - Flying Vertical`
`{dat}`	Nom d'en-tête du DAT du fichier : le DAT choisi, ou le DAT du lot avec lequel il est rangé	`Nintendo - Game Boy`

Une valeur inconnue donne Unknown (vide pour {version}). Les noms sont débarrassés des caractères interdits par Windows ou Linux, et les chemins très longs sont pris en charge sous Windows.

Sortie à la racine

La ligne Organisation, en tête du cadre Arborescence, propose deux choix : Dans des dossiers, selon le modèle (par défaut) ou Tout à la racine (aucun sous-dossier), qui place tous les fichiers à la racine de la destination. C'est une option à part entière : le modèle reste dans son champ, grisé avec Insérer une variable, et resservira quand vous reviendrez aux dossiers ou choisirez un préréglage. Une phrase sous les deux choix le rappelle. Restaurer les articles initiaux reste actif, car il s'applique aussi au sous-dossier d'un jeu multi-disques. Un jeu multi-disques garde son sous-dossier si Un sous-dossier par jeu (cadre Jeux multi-disques) est coché.

Un logiciel d'une liste de logiciels MAME va toujours dans le dossier de sa liste, où MAME le cherche : avec Tout à la racine, megadriv/sonic.zip sous la destination ; avec un modèle, ses dossiers viennent au-dessus de celui de la liste.

Un dossier par DAT

Avec un lot de DAT, deux cases sous Restaurer les articles initiaux placent les fichiers de chaque DAT à part :

Un dossier par DAT (cochée par défaut) : les fichiers de chaque DAT vont dans un dossier à son nom, au-dessus des dossiers du modèle. Avec {title}, Tetris (World).gb va dans Nintendo - Game Boy/Tetris/. Décochée, tous les DAT partagent les mêmes dossiers : la variable {dat} permet alors de placer le DAT ailleurs dans le modèle, et deux fichiers de DAT différents qui visent la même cible suivent la règle des conflits.
Reproduire l'arborescence des DAT : le dossier de chaque DAT va sous les dossiers de son chemin dans le dossier ou l'archive de DAT, comme dans le pack (TOSEC/Commodore/Amiga/Commodore Amiga - Games - [ADF]/...). Seulement avec un dossier par DAT, et pour les DAT rangés dans des sous-dossiers (--dir-dat-mirror en ligne de commande).

Les deux cases sont grisées avec un fichier DAT ou une archive d'un seul DAT : un DAT seul n'a jamais de dossier à lui, et sa sortie ne change pas. Le dossier _unmatched des fichiers non conformes reste à la racine de la destination.

Options associées

Restaurer les articles initiaux, sous le modèle : Legend of Zelda, The devient The Legend of Zelda dans les noms de dossiers.

Le cadre Jeux multi-disques, à côté de Écriture des fichiers :

Un sous-dossier par jeu : les disques d'un jeu multi-disques vont dans un sous-dossier à son nom.
Une playlist .m3u par jeu : écrit une playlist qui liste les disques d'un jeu multi-disques, pour que les émulateurs et frontends (RetroArch, Batocera, Recalbox...) puissent les échanger. Emplacement, en retrait juste en dessous, choisit où elle va :
- Dossier parent (recommandé) : la playlist est à côté du dossier du jeu (recommandé pour les frontends) ;
- Dossier parent avec sous-dossier masqué (.*) : le dossier du jeu commence par un point, pour que les frontends n'affichent que la playlist ;
- Dans le sous-dossier du jeu : la playlist est avec les disques.

Modes de transfert

Mode est une liste : chaque entrée donne le nom du mode et une phrase qui dit ce qu'il fait (son infobulle donne le détail), et la phrase du mode choisi reste affichée sous la liste.

Mode	Effet	Source	Remarques
Copier	Les fichiers sont copiés	Inchangée	Le choix le plus sûr.
Déplacer	Les fichiers sont déplacés	Vidée des fichiers retenus	Instantané sur un même disque ; d'un disque à l'autre, copie, écriture sur le disque, puis suppression. Une archive inspectée n'est jamais déplacée : ses fichiers sont extraits (sauf avec Conserver les archives contenant un seul jeu).
Hard link	Un second nom pour les mêmes données	Inchangée	Aucun espace supplémentaire. Sur un même disque uniquement ; pas en FAT32 / exFAT. Un émulateur qui écrit dans le fichier (une disquette ADF sous WinUAE, par exemple) modifie aussi celui de la source : ce sont les mêmes données.
Symlink	Un raccourci vers la source	Doit rester en place	Aucun espace supplémentaire. Sous Windows, créer des liens symboliques peut exiger le mode développeur ou les droits d'administrateur. Un émulateur qui écrit dans le fichier modifie celui de la source.
ZIP	Une archive ZIP par fichier	Inchangée	Un descripteur et ses pistes partagent la même archive.

À propos du mode ZIP : les archives sont au format TorrentZip, celui que reconnaissent RomVault et igir. Ce format fixe tout ce qui pourrait changer d'un outil à l'autre (ordre des fichiers, date, compression, en-têtes) : une archive ne dépend que de son contenu, et deux tris des mêmes fichiers donnent des archives identiques à l'octet près, comme celles de ces outils. Un gestionnaire de ROMs les tient donc pour déjà rangées, sans les recompresser, et une collection partagée reste identique d'un utilisateur à l'autre. La compression prend plus de temps qu'une copie. Avec Vérifier les fichiers copiés, chaque archive est relue et sa signature TorrentZip contrôlée. Un set MAME, qui est déjà une archive, et ses CHD sont copiés tels quels (voir DAT MAME), de même qu'un logiciel d'une liste MAME.

Les fichiers Exclus par un filtre et les Doublons ne sont jamais écrits : ils restent dans la source, même en mode Déplacer. Les fichiers Non conformes sont transférés dans _unmatched/ à la racine de la destination.

Isoler les fichiers non conformes dans _unmatched

Isoler les fichiers non conformes dans _unmatched, sous Conserver les archives contenant un seul jeu, est cochée par défaut. Décochez-la pour laisser les fichiers non conformes dans la source : les résultats les montrent toujours Non conformes, avec laissé dans la source dans leur raison et sans cible, mais le tri ne les écrit pas, même en mode Déplacer. Ils ne comptent ni dans le volume écrit ni dans l'alerte FAT32, leur case dans les résultats ne peut pas être cochée, et le journal les compte en une ligne. L'option est enregistrée dans la configuration et dans les profils : la ligne de commande la suit donc aussi.

Vérifier les fichiers copiés

Avec Vérifier les fichiers copiés, sous Conflits, chaque fichier copié, extrait d'une archive ou déplacé vers un autre disque est relu, et son CRC32 est comparé à celui des données lues à la source (en mode ZIP, chaque fichier de l'archive, et la signature TorrentZip de l'archive). En cas d'écart (disque, câble ou réseau défaillant), la copie est supprimée, la source est conservée et le fichier est marqué en erreur. Les liens ne sont pas vérifiés. Le tri est plus lent, puisque chaque fichier est lu deux fois.

Conserver les archives contenant un seul jeu

Conserver les archives contenant un seul jeu, sous Vérifier les fichiers copiés, est décochée par défaut. Cochée, une archive de la source (ZIP, 7z, RAR) est écrite telle quelle, au lieu que son contenu soit extrait, quand elle contient un seul jeu (un fichier, ou un descripteur et ses pistes) et que le tri retient tous ses fichiers. Une archive qui contient un fichier de plus, comme un lisez-moi ou un .nfo, voit son contenu extrait, comme sans l'option.

L'archive est copiée, déplacée (instantanément sur un même disque ; d'un disque à l'autre, copiée, puis supprimée) ou liée, selon le mode : une image de disque de plusieurs gigaoctets n'est ni décompressée ni recompressée. L'option est grisée en mode ZIP, qui écrit toujours une nouvelle archive TorrentZip.

L'archive prend le nom de son jeu, tel que le DAT nomme son fichier (sans DAT, tel que l'archive le nomme), avec sa propre extension : tetris.7z, qui contient tetris.gb identifié comme Tetris (World).gb, devient Tetris (World).7z. Les fichiers qu'elle contient gardent leur nom, même quand le DAT leur en donne un autre : l'archive contient toujours tetris.gb.
Avec Vérifier les fichiers copiés, une archive copiée, ou déplacée vers un autre disque, est relue, et son CRC32 est comparé à celui de l'archive de la source.
L'espace requis sur la destination et l'alerte FAT32 comptent la taille de l'archive, pas celle de son contenu.
La playlist .m3u d'un jeu multi-disques liste les archives de ses disques. Certains émulateurs ouvrent un .cue dans un .zip, mais la plupart n'en ouvrent aucun dans un .7z ou un .rar.

Conflits

Conflits décide de ce qui se passe quand un fichier du même nom existe déjà à la cible :

Renommer automatiquement (suffixe _01) : le nouveau fichier devient nom_01.ext, nom_02.ext...
Ignorer (Skip) : le fichier existant est conservé et le nouveau n'est pas écrit.
Écraser (Overwrite) : le fichier existant est remplacé, une fois le nouveau entièrement écrit : si le transfert échoue (disque plein, partage réseau perdu, fichier verrouillé), le fichier existant est conservé. Le fichier remplacé est perdu : Annuler le dernier tri ne peut pas le remettre en place, ce que rappelle la confirmation du tri.

Un descripteur et ses pistes sont toujours traités ensemble : ils reçoivent tous le même suffixe, et le descripteur est réécrit pour désigner les pistes renommées.

Une playlist .m3u suit la même règle : une playlist déjà présente est conservée (Ignorer), complétée d'une nouvelle nom_01.m3u (Renommer) ou remplacée (Écraser).

Un set MAME et ses CHD ne sont jamais renommés, pas plus qu'un logiciel d'une liste MAME, car MAME ne les trouve que par leur nom : avec Renommer automatiquement, ils sont ignorés comme des doublons.

Destination non vide

Avec Compléter une destination non vide coché, le tri ajoute ses fichiers au contenu existant ; la règle de conflits s'applique.
Sinon, RomSieve propose de purger la destination d'abord. Rien n'est supprimé : le contenu précédent est déplacé dans _purged/<date>/ à l'intérieur de la destination, et l'annulation le remet en place.
Un tri partiel ne purge jamais : il complète toujours la destination.