Ligne de commande

romsieve-cli exécute la même analyse et le même tri que l'interface, sans fenêtre : sur un NAS, sur un serveur via SSH, ou dans une tâche planifiée. Il utilise les réglages de l'interface (ou un profil), et ne fait qu'une simulation tant que vous n'ajoutez pas --execute.

Commandes

Exemples

# Simulation avec les réglages de l'interface, rapport et ROMs manquantes exportés
romsieve-cli run --report rapport.json --miss-list manquantes.txt

# Tri réel avec un profil enregistré depuis l'interface (« Enregistrer comme profil… »)
romsieve-cli run --profile "Amiga 1G1R" --execute

# D'autres dossiers, DAT ou mode de transfert que ceux des réglages
romsieve-cli run -s /roms/arrivee -d /roms/triees --dat "Commodore - Amiga.dat" --mode zip --execute

# Un lot de DAT : tout un pack TOSEC, sous-dossiers compris, rangé comme le pack
romsieve-cli run --dat /dats/TOSEC --dat-recursive --dir-dat-mirror --execute
# ... ou deux de ses DAT seulement
romsieve-cli run --dat /dats/No-Intro --dat-only "Nintendo - Game Boy" --dat-only "Nintendo - Game Boy Color"
# ... ou le pack quotidien No-Intro tel qu'il a été téléchargé, sans l'extraire
romsieve-cli run --dat "No-Intro Love Pack (PC XML).zip" --dat-only "Nintendo - Game Boy"

# Compléter une destination non vide, ou la purger d'abord (son contenu est mis de côté dans _purged/)
romsieve-cli run --execute --append
romsieve-cli run --execute --purge --yes

# Annuler le dernier tri réel
romsieve-cli undo           # affiche ce qui serait annulé
romsieve-cli undo --yes     # l'annule

# Quarantaine des purges de la destination (dossier _purged)
romsieve-cli quarantine                         # affiche ce qu'elle contient
romsieve-cli quarantine --empty --yes           # la vide définitivement
romsieve-cli quarantine -d /mnt/roms/sorted     # celle d'une autre destination

# DAT filtré du catalogue : les jeux du DAT que les réglages gardent, sans source ni simulation
romsieve-cli dat --output "Amiga (RomSieve).xml"
romsieve-cli dat --profile "Amiga 1G1R" --dat "Commodore - Amiga.dat" -o amiga-1g1r.dat
romsieve-cli dat --dat /dats/No-Intro -o /dats/No-Intro-1G1R      # un lot : un dossier, un DAT par DAT

quarantine lit la destination des réglages ou du profil (--profile), ou celle de --destination.

Options de dat

dat ne lit ni la source ni la destination : voir Exports pour ce que contient le DAT filtré. Quand les réglages ne gardent aucun jeu, aucun fichier n'est écrit et le code de sortie est 4.

Options de run

Options communes à toutes les commandes :

Tous les autres réglages (filtres, 1G1R, modèle, conflits...) viennent du fichier de réglages ou du profil : préparez-les dans l'interface, puis enregistrez-les comme profil.

Avec un lot de DAT, le bilan donne, après les totaux, une ligne par DAT où un jeu a été trouvé (Nintendo - Game Boy : 12 jeux trouvés, 14/1 600 ROMs (0,9 %)), puis le nombre des autres DAT ; avec --miss-list ou --fixdat, une ligne compte les DAT complets et ceux sans aucun jeu trouvé, qui n'ont rien à exporter.

Garde-fous

• Sans --execute, rien n'est écrit.
• La source doit exister, le DAT doit être trouvé, et la destination ne doit pas chevaucher la source. Un dossier de DAT que le tri refuserait (deux DAT du même nom, un DAT de machines MAME, des listes de logiciels mêlées à d'autres DAT, tous les DAT décochés) est refusé avant tout, en code 3.
• Un tri réel dans une destination non vide exige --append, ou --purge --yes ; un dossier sans le marqueur .romsieve exige en plus --force-foreign-purge pour être purgé. Compléter une destination non vide, coché dans la configuration ou le profil, ne dispense pas de --append, comme l'interface demande encore confirmation ; et --purge --yes purge la destination même quand cette option est cochée.
• undo se contente d'afficher le tri à annuler tant que --yes n'est pas ajouté. Après une annulation incomplète (fichier verrouillé, emplacement d'origine occupé), undo --yes reprend les seules opérations restantes.
• quarantine --empty exige --yes, et ne touche qu'à la quarantaine d'une destination marquée par RomSieve : le contenu supprimé ne pourra plus être remis en place par l'annulation des tris qui l'ont purgé.
• Ctrl+C arrête l'exécution proprement : le fichier en cours d'écriture est supprimé.

Codes de sortie

Par exemple, dans un script :

romsieve-cli run --profile "Quotidien" --execute --append --quiet
case $? in
  0) echo "Trié" ;;
  4) echo "Trié avec des erreurs, voir le journal" ;;
  *) echo "Non trié" ;;
esac