Studio Video Director
Un pipeline éprouvé et basé sur des mesures pour produire des vidéos de qualité studio avec des outils locaux gratuits. Chaque règle ci-dessous a été payée par de vrais échecs de construction : mixes mono, audio surcompressé, Shorts en diaporama, sous-titres tronqués et silences gênants. Toute construction qui enfreint une porte est une construction échouée — corrigez-la, ne la livrez pas.
Quand utiliser cette compétence
- Tout livrable vidéo : démo de hackathon, démo produit, Short/Reel, analyse de film, publicité, tutoriel, bande-annonce, extrait de podcast.
- Avant le rendu : planification, script, storyboard, prompts de plans.
- Après le rendu : le contrôle des 10 portes sur l'encodage FINAL.
- Quand une vidéo « a l'air bien mais semble amateur » : exécutez les portes, corrigez les portes défaillantes, revérifiez. La porte nomme le défaut exact.
Le flux de travail en 8 étapes
- Brief — un paragraphe : public, une idée, un appel à l'action, durée, ratio (choisissez UN SEUL et verrouillez-le :
16:9démo/format long ou9:16Shorts/Reels — NE JAMAIS mélanger les ratios dans un projet). - Plan de l'équipe (6 rôles) — Réalisateur (vision + liste de cuts), Scénariste (script, <=30 mots par plan, ~150 mots/min), Directeur de la photo (caméra + cadrage), Directeur artistique (palette + décor), VFX (mouvement + transitions), Designer sonore (VO + musique + SFX). Chaque rôle valide avant la génération.
- Storyboard + liste de cuts — écrit AVANT l'animation. Un cut visuel ou caméra au moins toutes les 3-4 s (pas d'écart > 4 s, échec dur). Accroche dans les 3 premières secondes : titre/question + mouvement. Jamais d'ouverture statique.
- Prompts (six parties) — par segment, <=10 s chacun, utilisant
references/prompt-template.md: durée/format, sujet, scène, beats avec horodatages, langage caméra, son/dialogue, contraintes. Réutilisez la description du sujet TEXTUELLEMENT entre les segments. - Générer les segments — mouvement réel uniquement : enregistrement d'écran (Playwright, deviceScaleFactor 2, 1920x1080@30fps pour les démos), B-roll, ou animation. Ken Burns sur images fixes : au plus UN segment de <=4 s par Short, jamais la vidéo entière.
- Assembler — normaliser chaque scène au cadre verrouillé (mise à l'échelle + padding, jamais d'étirement), joindre avec le concat demuxer, masteriser l'audio (Pro :
pro-bundle/scripts/assemble_multiscene.py). - Son — VO neuronale uniquement (edge-tts / studio TTS ; gTTS interdit). Musique : un morceau réel sous licence (Mixkit / Pixabay / YouTube Audio Library), ducké à -20 dB (Shorts) ou -22 dB (démos) sous la VO. SFX réels synchronisés avec les cuts. Lits synthétiques/SFX interdits.
- Porte + livrer — exécutez
scripts/quality_gate.pysur l'encodage FINAL. Les 10 portes doivent PASSER. Sauvegardez le master + .SRT dansrenders/et ne les jetez jamais.
Portes de qualité (toutes les 10, sans exception)
| # | Porte | Règle |
|---|---|---|
| 1 | Spécifications | durée/résolution/fps exacts ; canaux audio == 2 |
| 2 | Loudness | intégré -14..-16 LUFS, TP <= -1.5 dBTP, LRA >= 6 LU |
| 3 | Silence | pas de silence >= 0.5 s sauf une queue finale <= 1 s |
| 4 | Cadence des cuts | pas d'écart entre les cuts > 4 s |
| 5 | Couverture VO | la transcription faster-whisper couvre >= 80 % des mots du script |
| 6 | Images | les images à 00:02 / milieu / fin passent la checklist d'images nommées |
| 7 | Stéréo | ffprobe channels == 2 sur le mix final |
| 8 | Musique/SFX réels | attestation humaine de musique réelle sous licence + SFX réels |
| 9 | Pas de diaporama | aucun segment figé > 4 s |
| 10 | Protection du master | fichier .SRT sidecar présent, pas de fichiers *-broken / *-v1 / *-v2 |
Exécutez-le :
python3 scripts/quality_gate.py final.mp4 --aspect 16:9 \
--srt final.srt --script vo-script.txt --frames-dir checks/
Portes individuelles :
python3 scripts/audio_lufs_check.py final.mp4
python3 scripts/extract_frames_check.py final.mp4 --aspect 16:9 --frames-dir checks/
Règle des sous-titres
- Démos 16:9 : fichier
.SRTsidecar UNIQUEMENT. Zéro sous-titre de narration incrusté. Les légendes d'interface à l'écran sont autorisées — ce ne sont pas des sous-titres. - Shorts/Reels 9:16 : fichier
.SRTsidecar ET sous-titres stylisés dans la zone de sécurité inférieure (le lecteur Shorts ignore les sidecars ; les spectateurs en mode muet ont besoin de texte à l'écran).
Checklist d'images nommées (appliquée aux images à 00:02, milieu, fin)
(a) rien de coupé sur aucun bord, (b) pas de bande morte/zone vide > 25 % du cadre, (c) chaque mot à l'écran lisible à la taille d'un téléphone, (d) sous-titres visibles là où le script dit qu'ils doivent être, (e) pas de texte d'interface factice/faux, (f) le sujet remplit le cadre.
Outils gratuits (version gratuite)
- ffmpeg / ffprobe 8.x, Python 3.10+, faster-whisper (local, CPU).
- Crédits gratuits externes optionnels uniquement (tiers gratuits OpusClip / Vizard / Quso / 2short) — jamais invoqués par aucun script de ce repo, jamais d'API payante, jamais d'inscription, jamais de carte.
- Ce repo ne contient AUCUN identifiant, AUCUNE clé API, AUCUNE donnée personnelle.
Édition Pro
pro-bundle/ ajoute : assemblage FFmpeg multi-scènes avec mastering loudnorm en deux passes, ducking automatique VO + musique, générateur de sous-titres Whisper .SRT + incrustés, 18 modèles spécialisés et un contrôle par lots en une commande. Voir README.md (section Édition Pro) et pro-bundle/README.md.