Édition vidéo mesurée
Principe : la couleur se juge par mesure. Toute modification de couleur que je propose s'accompagne du nombre qui l'a motivée (scope, percentile, angle de teint) et du nombre après. Chaque règle de cette compétence a une source à côté ; ce qui n'a pas de source apparaît comme [sans source] et jamais comme règle.
Limite déclarée : je vois des images et des chiffres, je ne regarde pas la vidéo en cours. Le rythme, la sensation de la coupe et le goût du look sont le jugement de la personne qui a demandé. À la livraison, je demande explicitement que la personne regarde sur son téléphone.
Prérequis : ffmpeg et ffprobe (testé avec la version 8.1.2, avec libvidstab pour la R61), Python 3.10+ avec numpy et Pillow (pip install numpy pillow).
Fichiers
| Fichier | Utilité |
|---|---|
scripts/escopos.py | diagnostic par scène : fiche de scopes (waveform, parade RGB, vectorscope avec ligne de teint, histogramme) + diagnostico.md/json avec alertes et source |
scripts/comparar.py | avant × après par scène : fiche, split_cenaN.png en 1080, tableau de chiffres et alertes résolues/nouvelles |
scripts/graduar.py | applique le plan de correction (JSON) dans l'ordre du signal, en RGB 16 bits ; --previa génère des images fixes avant/après |
scripts/gerar_lut.py | transforme la correction approuvée en un .cube (33/65) pour Premiere/Resolve/CapCut et vérifie par PSNR |
scripts/montar.py | assemble les segments avec coupe sèche, J cut et L cut à partir d'une liste (JSON) |
scripts/receitas.py | 38 recettes ffmpeg avec source ; testar clipe.mp4 les exécute toutes ; md génère referencias/receitas-ffmpeg.md |
referencias/cor-fluxo.md | ordre du signal, contraste, courbes, saturation, précision 16 bits |
referencias/niveis-e-escopos.md | BT.709, EBU R103 v3.0, comment lire chaque scope, comment le script mesure |
referencias/pele.md | ligne de teint, plage de chroma, symptôme → cause → correction |
referencias/hdr-hlg.md | HLG iPhone → SDR, niveaux BT.2408, chaîne mesurée |
referencias/corte.md | Murch (règle des six, clignement), coupe dans l'action, J/L cut, raccords audio, synchronie |
referencias/plataformas.md | Meta et TikTok : format, zone de sécurité, durée, ce qui est officiel et ce qui ne l'est pas |
referencias/receitas-ffmpeg.md | les 38 recettes par groupe (entrée, diagnostic, couleur, look, coupe, calques, mouvement, finition, audio, livraison) |
Dossier de travail : un dossier par pièce (ex. : editar-video/<projet>/<pièce>) : brut, plan, prévisualisations, fiches et final ensemble.
Dans les commandes ci-dessous, ~/.claude/skills/editar-video est l'endroit où la compétence a été installée. Ajustez si installée ailleurs.
Étape 0 — Entrée (sans validation)
python ~/.claude/skills/editar-video/scripts/receitas.py mostrar R01 # et exécuter avec le fichier
Décider avant tout, à partir des chiffres de ffprobe :
color_transfer=arib-std-b67(HLG) ousmpte2084(PQ) → convertir d'abord en SDR (referencias/hdr-hlg.md, R03). Ne jamais simplement changer l'étiquette.r_frame_rate ≠ avg_frame_rate→ débit variable : R02 avant de couper (Meta exige un débit fixe, Ads Guide).color_range=pc→ vérifier si le contenu est vraiment 0–255 avant de convertir (R04).signalstatsignore l'étiquette de plage.- Fichier IA, enregistrement d'écran : viennent souvent sans balise ou en pleine plage. Mesurer avant de supposer.
Étape 1 — Diagnostic mesuré (validation 1)
python ~/.claude/skills/editar-video/scripts/escopos.py bruto.mp4 -o diag # SDR
python ~/.claude/skills/editar-video/scripts/escopos.py bruto.mp4 -o diag --sdr # HLG : mesure après le tonemap
python ~/.claude/skills/editar-video/scripts/escopos.py bruto.mp4 --pele 0.35,0.15,0.3,0.25 # région du visage
Lire la fiche par la méthode VOIR → AGRANDIR → CONFIRMER : l'image, puis chaque scope, puis le chiffre. Montrer :
- la fiche (
folha_escopos.png) et le tableau par scène ; - faits mesurés, un par ligne, avec la règle et la source : « Scène 2 : hauts R 98,6 / G 90,0 / B 80,2 → dominante chaude dans les hauts, si le mur est blanc (Adobe, parade RGB) » ;
- ce que je ne sais pas grâce à la mesure (ex. : si le ton chaud est intentionnel).
Le masque de peau automatique (Chai & Ngan) capture le bois, le beige et l'orange. Si le visage est petit ou s'il y a un objet de la même couleur, passer --pele avec la région du visage.
Validation 1 : la personne qui a demandé confirme ce qui est un problème et ce qui est une intention. Je ne corrige pas une dominante que la personne veut.
Étape 2 — Plan de correction et prévisualisation (validation 2)
Écrire plano.json (format en haut de graduar.py). Chaque opération porte le motif mesuré dans un champ "porque". Ordre fixe : conformer → global → scènes (égaliser) → look → finition → légaliser (referencias/cor-fluxo.md, section 1).
- Normaliser : points de noir/blanc par canal (
niveis) à partir debaixas_RGB/altas_RGB. - Équilibrer : température d'abord, puis vert/magenta (
temperatura,balanco). - Égaliser les scènes : choisir la scène de référence (la plus ouverte ou la plus proche du look souhaité, Colorist Guide 20, leçon 2) et approximer Y moyen, hauts RGB et teint des autres.
- Look : seulement après l'égalisation. Saturation de style, LUT créative. Le look est une question de goût : je propose, la personne décide.
python ~/.claude/skills/editar-video/scripts/graduar.py plano.json --mostrar # chaîne de filtres
python ~/.claude/skills/editar-video/scripts/graduar.py plano.json --previa # avant|après du milieu de chaque scène
Validation 2 : approbation de la prévisualisation. L'ajustement vient avec la scène et la mesure (« scène 3 moins chaude, moitié »). Je modifie uniquement ce qui a été demandé.
Étape 3 — Rendu et comparaison mesurée (validation 3)
python ~/.claude/skills/editar-video/scripts/graduar.py plano.json
python ~/.claude/skills/editar-video/scripts/comparar.py bruto.mp4 corrigido.mp4 -o comparacao --zoom-vs 2
Livrer folha_antes_depois.png + comparacao.md (chiffres avant → après, alertes résolues et nouvelles, amplitude entre scènes). Si une nouvelle alerte apparaît, je corrige avant de montrer.
Validation 3 : approbation de la vidéo corrigée, visionnée par la personne qui a demandé.
Étape 4 — Coupe, calques, texte, mouvement (sur demande)
- Coupe : liste de segments en JSON →
montar.py(sec, J, L). Règles et sources dansreferencias/corte.md. Je mesure la durée des plans et les coupes par minute ; le rythme est jugé par la personne. - Texte, sous-titre, logo : R50–R52, toujours dans la zone de sécurité de la plateforme (
referencias/plataformas.md). Texte littéral d'une liste fermée. Les sous-titres suivent la parole, avec un temps de lecture de 1 s pour 3 mots + 1 s. - Mouvement sur la vidéo : zoom/pan avec easing (R60), stabilisation (R61), vitesse (R62).
- Motion graphics à partir de zéro (typographie cinétique, chiffres animés) : compétence
/motion, avec la vidéo entrant comme une séquence d'images. - Ordre : les graphiques et les sous-titres arrivent après la couleur et la conversion HDR→SDR (ITU-R BT.2408-9 §9).
Étape 5 — Révision et livraison
Checklist avant de montrer :
comparar.pysans alerte de niveau/gamut à la fin ; balises BT.709 vérifiées avec ffprobe.- Résolution, fps fixe, durée, nombre d'images, pas d'image noire au début/fin.
- Texte dans la zone de sécurité ; sous-titres correspondant à la parole.
- Loudness mesuré (R80) et signalé. La cible de -14 LUFS est [sans source officielle] ; je l'utilise si la personne est d'accord.
- Encodage R90 (H.264, yuv420p, BT.709, +faststart).
- Pas de flash fort ni de blanc uni dans les 3 premières secondes si c'est pour TopView de TikTok (
plataformas.md). - Demander le visionnage de la personne qui a demandé, sur son téléphone : rythme, sensation, teint.
Look approuvé qui sera réutilisé → gerar_lut.py --plano plano.json -o <projet>_look.cube et --conferir pour prouver.
Règles de code (mesurées avec ffmpeg 8.1.2, 05/11/2026)
- Le filtre de couleur en RGB vient après
format=gbrp16le. En 8 bits l'aller-retour perd 1,1 code de Y moyen ; en 16 bits il est exact. - Ne pas utiliser
eqen flux 10 bits/HLG : il force 8 bits. - Chemin dans le filtre :
file='/dossier/fichier.cube'(guillemets simples ; un chemin avec:ou un espace nécessite un échappement avec\). - Balises en sortie :
-colorspace bt709 -color_primaries bt709 -color_trc bt709 -color_range tv(+setparamsà la fin de la chaîne degraduar.py). - Légaliser seulement à la fin (EBU R103 v3.0). Le
limiterne corrige pas le gamut RGB ; l'étape RGB16 recadre déjà. -ssavant-iavec réencodage = coupe précise ; avec-c copyla coupe tombe sur le keyframe.