Guide d'utilisation

Ce guide couvre les différentes manières d’exécuter le script convert.ps1 et les paramètres de ligne de commande disponibles.

Exécution de base

Lancez le script depuis la racine du dépôt :

.\app\convert.ps1

Par défaut, le script va :

Vous demander de sélectionner un Playbook.
Vous demander un Nom de session.
Scanner récursivement le répertoire de travail actuel à la recherche d’extensions vidéo courantes (.mp4, .mkv, .avi, etc.).
Traiter les fichiers un par un, en enregistrant la progression dans app/convert_jobs/.

Vous pouvez automatiser la configuration en passant des paramètres au script :

Paramètre	Alias	Description
`-Path`	`FullName`, `FilePath`	Chemin(s) vers les fichiers ou répertoires à traiter. Supporte l’entrée par pipeline.
`-Session`		Nom de la session. Utile pour reprendre des travaux spécifiques.
`-Playbook`		Chemin vers un fichier JSON de playbook.
`-NoRecurse`		Désactiver le scan récursif des dossiers.
`-RetryFailed`		Forcer le script à réessayer les fichiers qui ont échoué lors d’une session précédente.

Traiter un dossier spécifique avec un playbook spécifique :

.\app\convert.ps1 -Path "D:\Videos\Movies" -Playbook "app\playbooks\av1-archive.json" -Session "MovieArchival"

Utilisation du pipeline pour traiter des fichiers spécifiques :

Get-ChildItem "C:\RawFootage" -Filter "*.mov" | .\app\convert.ps1 -Playbook "app\playbooks\av1-archive.json"

Chaque travail créé est stocké dans app/convert_jobs/<NomDeSession>.json.

Reprise : Si vous relancez le script avec le même nom -Session (ou si vous le sélectionnez interactivement), il ignorera les fichiers déjà marqués comme Completed (Terminé).
Opérations atomiques : Les fichiers sont d’abord encodés dans un fichier .tmp. Ce n’est qu’après une réussite complète (code de sortie FFmpeg 0) que le fichier original est “remplacé” (ou que le nouveau fichier est finalisé).
Sécurité : Le script ne supprime jamais vos fichiers originaux, sauf configuration spécifique dans un profil personnalisé (pas le comportement par défaut).