Que fait reel : production vidéo pour Claude Code ?
Un outil en couches construit sur ffmpeg. Vous (Claude) examinez le matériau, décidez quoi montrer et rédigez un plan ; le code s'occupe de la géométrie du cadrage, du rendu et des vérifications. La taille de sortie est configurable (par défaut vertical 1080×1920).
Les commandes et formats de fichiers sont documentés dans docs/ENGINE.md du dépôt reel. Lisez-le avant la première commande : cat "$(reel --root)/docs/ENGINE.md". reel <command> --help liste toutes les options. Chaque commande imprime un objet JSON ({"ok": true, "result": ...} ou {"ok": false, "error": {"code": ..., ...}}) et se termine avec un code 1 en cas d'échec.
Ordre de travail : d'abord la direction, puis le montage
Pour toute vidéo qu'une autre personne que l'utilisateur verra, suivez SOP.md : S0 réception, S1 pack source, S2 inventaire des actifs, S3-S4 un agent director écrit direction/BRIEF.md et un storyboard, puis montez immédiatement (l'étape d'approbation G1 ne bloque pas par défaut), puis la porte de livraison ci-dessous. En S7, un agent director distinct révise le montage par rapport au BRIEF. Installé comme plugin, l'agent s'appelle reel:director.
- Donnez au réalisateur les chemins du matériau original, pas vos propres conclusions à son sujet.
- Si un BRIEF approuvé existe et que le but, le public et la portée du matériau n'ont pas changé, suivez-le.
- Si l'utilisateur dit que la vidéo est ennuyeuse ou inutile, revenez à S3 et repensez la pièce ; ne vous contentez pas de remonter.
Porte de livraison (obligatoire)
Chaque étape est imposée par le code : en sautez une et vous ne pouvez pas livrer un montage final.
- Rédigez d'abord le brief (
$P/brief.json, modèle ci-dessous) et enregistrez-le :reel register brief.json. Langue de livraison, finale ou échantillon, dossier de livraison et ce qui ne doit pas changer : si vous ne pouvez pas remplir ces champs, demandez à l'utilisateur. Une fois enregistré, le crochet Bash de protection refuse les écriturescp/mv/ffmpegdans le dossier de livraison. - Auditionnez la voix. Il n'y a pas de voix par défaut. Choisissez-en une qui correspond au brief, générez un échantillon de 10 à 20 s et exécutez
reel voice check sample.mp3 --script sample.txt --brief brief.json. Le whisper local retranscrit l'échantillon et le compare au texte (--langpar défauten; pour une voix-off en chinois passez--lang zh, qui compare en pinyin sans tons, donc l'orthographe homophone n'est pas considérée comme une erreur) ; seul un taux d'erreur de 10 % ou moins inscrit l'approbation dansbrief.voice.approved(by : claude, avec la transcription comme preuve). Si l'utilisateur a écouté, enregistrez ses mots exacts à la place.- La STT prouve que les mots sont lus correctement et clairement. Elle ne prouve pas que la voix convient à la pièce : dites dans votre réponse que vous avez choisi la voix, et changez de voix dans la version suivante si l'utilisateur ne l'aime pas.
- Une nouvelle voix nécessite une nouvelle vérification. La voix macOS
sayest réservée aux brouillons internes, jamais pour une vidéo livrée.
- Vérifiez le rendu :
reel check final.mp4 --plan plan.json --brief brief.json [--profile vertical-strict|project-profile.json] [--text caption.txt].- Un code de sortie 1 signifie qu'il ne peut pas être livré. Lisez
result.gate.blockers(échecs techniques : même un échantillon ne peut pas être livré) etresult.gate.pending_review(éléments qu'un relecteur doit examiner). - Ne vous fiez pas uniquement à
ok.result.gate.not_coveredliste ce qui n'a pas été vérifié (par exemple le texte à l'écran, qui n'a pas d'OCR) ; ne dites jamais que ces éléments ont été vérifiés.
- Un code de sortie 1 signifie qu'il ne peut pas être livré. Lisez
- Révisez. Examinez chaque élément
needs_review(reel scrub, captures d'écran) et rédigez un enregistrement de révision par élément avec des observations temporelles. Regardez l'intégralité du montage vous-même et signezfinal_watch(au moins une image par plan) ; écoutez du début à la fin et signezfinal_listen(une signature d'agent nécessite des observations temporelles ; si l'utilisateur a écouté, enregistrez ses mots exacts commequote). Lorsque vous avez signé les deux, livrez-le comme final : le reçu indiqueapproved_by : agent, et votre réponse dit « montage final, révisé par Claude, pas encore vu par vous ». Les retours de l'utilisateur deviennent la version suivante. Le formatreviews.jsonse trouve dansdocs/ENGINE.md. - Livrez :
reel deliver final.mp4 --brief brief.json --version v3 --plan plan.json --reviews reviews.json.- Si les conditions finales ne sont pas remplies, la commande échoue avec
DELIVERY_NOT_FINALet liste les raisons. Alors seul--sampleest possible : le nom du fichier portesample-pending-review, et vous devez l'appeler échantillon lorsque vous le dites à l'utilisateur. - Un numéro de version ne peut être livré qu'une fois ; les anciennes versions ne sont jamais supprimées ni écrasées. Seulement lorsque l'utilisateur demande explicitement de supprimer les anciennes versions :
reel register brief.json --remove, supprimez, puis enregistrez à nouveau.
- Si les conditions finales ne sont pas remplies, la commande échoue avec
- Dire « terminé » nécessite un reçu avec
status : final(reel receipt <receipt.json>le revérifie). Sinon, indiquez le vrai statut : « pas fini », « échantillon en attente de révision », « voix non auditionnée ». Le crochet Stop bloque une prétention d'achèvement qui n'a pas de reçu correspondant. - Les vidéos réalisées par le script de rendu d'un projet (
build_*.pyet autres), ou composées dans un autre outil et exportées, passent également par les étapes 3 à 6.
{"version": "reel.brief.v1", "name": "spring-promo", "language": "en", "deliverable": "final",
"delivery_root": "~/Videos/deliveries/spring-promo", "must_not_change": ["end card credit"],
"voice": {"mode": "recorded"}, "profile": "default"}
voice.mode:none(pas de voix),recorded(un véritable enregistrement),ttsouclone(ces deux derniers nécessitent aussivoice_idet un blocapprovedécrit parreel voice check, ou une approbation humaine avecquote,sampleetsample_sha256).delivery_rootdoit être un chemin absolu existant (ou commencer par~). Il ne peut pas être le dossier personnel, Bureau, Documents, Téléchargements, la racine iCloud Drive, le dossier du projet ou un de ses parents.- Une version silencieuse utilise un profil projet :
{"extends": "default", "audio": "silent"}. - Profils :
default(seuils généraux de départ) etvertical-strict(1080×1920 30 ips, -16 LUFS, strict). Mettez les différences de projet dans un profil projet avecextends; enregistrez les longues tenues prévues dansallowavec une raison ; ajoutez les mots bannis (anciens noms de produits, texte de remplissage) àtext.extra_banned.
En haut de chaque appel Bash
Chaque appel Bash démarre un nouveau shell, donc commencez chaque appel par :
REEL_PROJECT=spring-promo # ce nom de projet
command -v reel >/dev/null || { echo "reel n'est pas dans le PATH (activez le plugin, ou exécutez ./install.sh --link)" >&2; return 1 2>/dev/null || exit 1; }
command -v ffmpeg >/dev/null || { echo "ffmpeg introuvable" >&2; return 1 2>/dev/null || exit 1; }
P="${REEL_PROJECTS_DIR:-$HOME/reel-projects}/$REEL_PROJECT"; mkdir -p "$P/preview" && cd "$P"
Toutes les sorties vivent dans $P, jamais dans un dossier temporaire ; les chemins relatifs ci-dessous sont relatifs à $P.
Réalisation du montage
Vous prenez les décisions (quels plans, quel sujet, mouvements de caméra, rythme) ; la perception, la géométrie, le rendu et les vérifications sont effectués par le code. La syntaxe complète des commandes se trouve dans docs/ENGINE.md.
- Matériau dans
$P(actifs,observations.json,plan.json, aperçus, rendus et rapports de vérification y vivent tous ; un plan par dossier). - Script et voix. Rédigez le script de voix-off, choisissez une voix qui correspond au brief et réussissez l'audition (étape 2 de la porte). Produisez
voice.mp3(ou.wav) et, si vous voulez des sous-titres,voice.vtt. Pour un travail publié, préférez un véritable enregistrement ou une voix dont la licence couvre l'utilisation ; pour un morceau uniquement musical, pointezaudio.voicevers la piste musicale (c'est l'ancre de la timeline). - Regardez et sélectionnez les cibles :
reel inspect(lister chaque fichier) →reel frame(lire l'image avec la grille 0-1 et lire la boîte du sujet) →reel observepour l'enregistrer, oureel locate --query ... --check-png ...(OWLv2 ; regardez l'image de vérification avant d'utiliser une détection). - Écrivez
plan.json(EditPlan v1) :camera : []maintient l'image fixe ;zoom_toavec unobservation_idpousse sur un sujet enregistré ; utiliseztracklorsque le sujet se déplace dans une vidéo ;transition_outpour les transitions. Ne laissez pas un plan vidéo traverser une coupe de scène signalée parinspect.audio.voiceest requis et se résout par rapport àsrc_dir. - Validez et prévisualisez :
reel validate→reel compile→reel preview plan.json s2 --out preview/s2.mp4 --sheet preview/s2.png, puis lisez la planche contact pour juger du mouvement de caméra. - Rendu :
reel render plan.json --out "$P/final.mp4" --sheet "$P/preview/final.png" --where local(utilisez--where remoteuniquement si l'utilisateur a configuré un GPU distant et l'a demandé). Le fait de passer les vérifications de rendu signifie seulement que le fichier n'est pas corrompu ; continuez avec les étapes 3 à 6 de la porte.
Autres points d'entrée, chacun avec une section dans docs/ENGINE.md :
- Inspectez et modifiez la timeline :
reel timeline(--format textou une image--pngmultitrack),reel scrub(images autour de chaque coupe),reel edit/undo/history,reel preview --range(aperçu basse résolution avec son). - Coupez au tempo :
reel beats music.mp3 --out beats.json→reel snap plan.json --beats beats.json --mode downbeat; puis vérifiez chaque coupe avecreel timeline --png --beats. Nécessite./install.sh --beats. - Narrez une page web avec des surlignements : un plan avec
kind : "web"; les positions du texte proviennent du DOM (pas d'OCR), donc une phrase surlignée doit correspondre exactement au texte de la page ;reel words voice.mp3donne le timing mot par mot. Nécessite./install.sh --web. - Projets Shotcut :
reel mlt project.mlt --video-only;--dupestrouve les séquences source utilisées deux fois.
Disponible : assemblage de plans, push-ins sub-pixel sur une boîte sujet, suivi d'un sujet en mouvement, transitions xfade, sous-titres incrustés, musique de fond, étalonnage et LUTs, plans web, recherche de sujet OWLv2, vérifications techniques, livraison avec porte. Pas intégré : transitions avec easing, interpolation d'images, clonage vocal.
GPU distant (optionnel)
Les parties --where remote sont imposées par le code.
- Utilisez-le uniquement lorsque l'utilisateur a configuré
REEL_REMOTE(une destination ssh) et le demande ; sinon effectuez le rendu avec--where local. - L'utilisation de la VRAM est plafonnée à 80 % par défaut. Quand un travail en nécessite davantage, l'outil renvoie
NEED_USER_APPROVAL: informez d'abord l'utilisateur, et ajoutez--allow-over-80uniquement avec son consentement. Une utilisation GPU de 50 % ou plus signifie que quelqu'un d'autre l'utilise ; ne le prenez pas. - Un travail GPU reel à la fois (verrouillage de fichier distant). Ne modifiez pas les limites de puissance. Ne redémarrez ni n'éteignez jamais l'hôte.
reel remote proberapporte l'hôte ;reel remote setup-visioninstalle un venv séparé avec torch et les poids OWLv2 sur l'hôte distant.
Fichiers compagnons
SOP.md: workflow direction d'abord, rôles, étapes et conditions de sortie.- L'agent
director(agents/director.mddans le dépôt) : brief, storyboard et révision. docs/ENGINE.mddans le dépôt : commandes, EditPlan, brief, révisions, reçus et profils.