Rendu vidéo longue durée
Étape 9 du workflow vidéo longue durée. Sortie : rendus de révision (basse qualité) jusqu'à l'approbation, puis une vidéo finale haute qualité.
Une scène correspond à un clip du script, numéroté dans l'ordre dans la vidéo, comme dans les étapes précédentes. Les numéros de scène sont incrustés dans la vidéo de révision, afin que le relecteur puisse les désigner.
Avant de commencer
- Trouver le projet dans
~/.long-video/projects/<slug>/. Exigervideo-script.mdavecstatus: approved. - Charger la configuration du projet : résolution, ratio d'aspect, mode de sous-titrage (
visuals.captions), besoins en loudness, plateforme. - Vérifier ffmpeg et ffprobe (
ffmpeg -version). Le moteur de rendu intégré nécessite ffmpeg avec libx264 et libass. - Si
render/existe déjà, demander : continuer (lister les versions) ou recommencer.
Étape 1 : Inventaire
Vérifier chaque scène et lister ce qui existe :
| Élément | Où | Utilisé comme |
|---|---|---|
| Clip vidéo | clips/scene-<NNN>_clip.* (ou _take2 et suivants, selon ce que l'utilisateur a approuvé) | L'image de la scène |
| Images uniquement | frames/scene-<NNN>_start.* | Un plan fixe avec un mouvement de caméra du script (push-in, pull-out, pan) |
| Voix | audio/lines/scene-<NNN>_<speaker>_<NN>.* | Narration et dialogue |
| Pistes sonores | sound/mix/sfx_track.wav, amb_track.wav, music_track.wav | Effets, ambiance, musique |
Signaler les lacunes dans un petit tableau. Une scène sans clip et sans image est un blocage : lister ces scènes et proposer de revenir à long-video-keyframes ou long-video-clips. L'absence de voix ou de son n'est autorisée que si l'utilisateur a choisi de sauter ces étapes. Si une étape a été sautée, ne pas la redemander.
Si l'étape des clips a été sautée (clips_mode: images-only), chaque scène devient un plan fixe avec un mouvement de caméra tiré du script.
Étape 2 : Choisir l'outil d'assemblage
- Vérifier la présence d'un éditeur vidéo que Claude peut piloter : un serveur MCP d'édition connecté dans cette session, ou une CLI sur l'appareil (FilmCraft :
filmcraft-cli commands; EffectCraft :effectcraft-cli --help). Voir../long-video-sound/references/tools.md, section 5. - Si l'un est disponible, demander : l'utiliser (l'utilisateur peut ouvrir le projet et l'ajuster), ou utiliser le moteur de rendu intégré. Par défaut, utiliser le moteur de rendu intégré. Si l'utilisateur choisit l'éditeur, lire d'abord sa liste de commandes et sa documentation, travailler sur une copie, demander avant d'installer ou de construire quoi que ce soit, et conserver les mêmes noms de fichiers.
- Dire quel outil sera utilisé.
Le reste de ce skill décrit le moteur de rendu intégré. Avec un éditeur, effectuer les mêmes étapes via ses commandes et exporter les fichiers de révision et finaux dans les mêmes dossiers et avec les mêmes noms.
Étape 3 : Construire la liste de montage
Lire references/edl-format.md. Écrire render/edl.json à partir des fichiers du projet :
- une entrée par scène avec sa durée (du script, ou la durée réelle du clip si plus courte ou plus longue dans les limites de la durée de la scène), source de l'image, mouvement de caméra pour les plans fixes, et transition de sortie,
- placements des voix : le temps de début de la scène plus un court décalage (0,3 s par défaut), lignes dans l'ordre avec de petits écarts,
- les pistes sonores,
- les sous-titres à partir du texte des voix (début et fin selon la durée de chaque fichier voix), si la configuration le demande,
- largeur, hauteur et fps de la configuration. Le fps par défaut est 24. La cible de loudness par défaut est -14 LUFS avec un pic vrai en dessous de -1,5 dBTP.
Règles :
- Utiliser les durées exactes des scènes du script approuvé. Ne pas étirer ou raccourcir l'histoire pour l'adapter.
- Un clip plus long que sa scène est rogné à la fin. Un clip plus court que sa scène conserve sa dernière image. Signaler les deux.
- Une ligne de voix qui dépasse la fin de sa scène, ou la fin de la vidéo, est signalée comme un avertissement.
- Transitions :
cutpar défaut.fade(fondu au noir) uniquement là où le script le dit. Les cross-dissolves nécessitent un outil d'édition. - Vérifier le plan avant le rendu :
node <skill folder>/scripts/build-render.mjs render/edl.json review render/review --plan.
Afficher un court résumé : nombre de scènes, durée totale par rapport à la cible, clips par rapport aux plans fixes, avertissements. Corriger les problèmes qui peuvent l'être sans changer l'histoire. Demander à l'utilisateur pour tout ce qui ne peut pas être corrigé.
Étape 4 : Rendre la version de révision
Qualité de révision : basse résolution (environ 360p), compression élevée, numéro de scène et timecode incrustés dans le coin supérieur gauche, et sous-titres si la configuration utilise des sous-titres incrustés.
node <skill folder>/scripts/build-render.mjs render/edl.json review render/review --version 1
- Sortie :
render/review/<slug>_review_v1.mp4, plus un.report.jsonavec durée, taille et loudness. - Les segments de scène sont mis en cache. Les révisions suivantes ne rendent que les scènes modifiées, donc elles sont beaucoup plus rapides.
- Pour les vidéos de plus de quelques minutes, exécuter la commande en arrière-plan et attendre qu'elle se termine. Ne pas interroger.
- Si le mode de sous-titrage est
srt, un fichier.srtest écrit à côté de la vidéo.
Vérifier le rapport : durée réelle par rapport à la durée prévue, loudness, flux. Puis indiquer à l'utilisateur le chemin complet et la taille.
Expliquer comment réviser : regarder le fichier, noter le numéro de scène et le timecode affichés dans le coin avec chaque commentaire. Claude n'envoie ni ne télécharge le fichier. L'utilisateur le partage avec le client. Proposer de préparer un téléchargement uniquement si l'utilisateur le demande, et demander d'abord.
Étape 5 : Collecter les modifications
Demander : "Des modifications ? Si c'est final, dites-le et je rendrai la version haute qualité."
L'utilisateur peut coller les retours du client. Lire references/review-feedback.md. Pour chaque commentaire :
- Trouver le numéro de scène ou l'heure à laquelle il fait référence. Si le commentaire est vague, poser une question courte.
- Le classer et choisir la route :
- Niveau montage (trim, longueur, ordre, texte des sous-titres, sous-titres activés ou désactivés, transition, niveaux de la voix, musique ou effets) : le corriger ici dans
edl.jsonou le gain des pistes. - Image d'une scène (aspect, personnage, composition, mouvement) : revenir à
long-video-keyframesoulong-video-clipspour ces scènes. Les nouveaux fichiers reçoivent des noms de style_take2. Puis mettre à jour la liste de montage. - Ligne de voix (prononciation, formulation) :
long-video-voicepour ces lignes. Un changement de formulation du script approuvé nécessite l'approbation de l'utilisateur et une révision du script. - Son (effet, ambiance, musique) :
long-video-soundpour ces repères, puis remixer. - Histoire ou structure (ajouter ou supprimer des scènes) :
long-video-director, puis refaire uniquement les scènes affectées en aval.
- Niveau montage (trim, longueur, ordre, texte des sous-titres, sous-titres activés ou désactivés, transition, niveaux de la voix, musique ou effets) : le corriger ici dans
- Écrire la liste dans
render/review-log.mdavec la version, la scène, la demande, la route et le statut. - Montrer à l'utilisateur le plan dans un court tableau. Demander un oui avant toute régénération qui coûte des crédits ou du temps.
- Appliquer les modifications, puis rendre la révision suivante (
--version 2, etc.). Conserver chaque ancien fichier de révision. - Dire à l'utilisateur ce qui a changé, scène par scène, et le chemin du nouveau fichier.
Répéter jusqu'à ce que l'utilisateur approuve. Le silence ou "ça a l'air bien pour l'instant" n'est pas une approbation.
Étape 6 : Rendre la vidéo finale
Seulement après que l'utilisateur a dit explicitement qu'une version de révision spécifique est finale.
- Confirmer : "Rendre la finale à partir de la révision v ?" Vérifier que la liste de montage correspond à cette version, et qu'aucune demande de modification n'est encore ouverte dans le journal de révision.
- Qualité finale : la résolution de la configuration, H.264 haute qualité (crf 18, presse slow), AAC 192k, normalisation du volume en deux passes vers la cible, aucune étiquette de révision. Les sous-titres sont incrustés uniquement si la configuration le demande. Sinon, un fichier
.srtest écrit. - Exécuter, en arrière-plan pour les longues vidéos :
node <skill folder>/scripts/build-render.mjs render/edl.json final render/final
- Vérifier avec le rapport et
ffprobe: la durée correspond au plan, la résolution et le fps sont corrects, il y a un flux vidéo et un flux audio, le volume est proche de la cible (à environ 1 LU près) et le pic vrai est inférieur à -1 dBFS. - Optionnellement, rechercher des images noires inattendues et de longs silences :
ffmpeg -i FILE -vf blackdetect=d=0.5 -af silencedetect=noise=-50dB:d=3 -f null -. Signaler les résultats. - Mettre à jour
project.json:"stage": "final-rendered","final_video": "<chemin>", et la version de révision approuvée. - Indiquer à l'utilisateur le chemin complet, la taille et la durée. Lui rappeler les crédits dans
sound/credits.mdpour la description de la vidéo. - Proposer de continuer avec
long-video-publish(options de titre YouTube, description, tags et suggestion de miniature). Commencer uniquement si l'utilisateur accepte. Ne pas publier ni télécharger. Ne pas démarrer d'autre étape ultérieure sauf si l'utilisateur le demande et que cette étape existe.
Règles
- Ne jamais rendre la version finale sans une approbation explicite d'une version de révision spécifique.
- Ne jamais modifier le script approuvé. Si les retours l'exigent, le rediriger et demander.
- Ne jamais envoyer, partager ou télécharger une vidéo sans demande claire de l'utilisateur.
- Ne jamais supprimer les anciens rendus de révision.
- Ne jamais régénérer d'images, clips, voix ou sons sans l'accord de l'utilisateur sur le plan.
- Garder les messages de chat courts. Mettre la liste des modifications dans
render/review-log.md.