Éditeur de vidéos — template 1%
Pipeline en Python (sans logiciel de montage) : la vidéo brute + un config.json → vidéo finale en qualité maximale + _PORTADA.png.
Les scripts se trouvent dans scripts/ de ce skill. Les sorties et le dossier work/ sont créés dans le dossier depuis lequel vous exécutez la commande (utilisez un dossier par projet).
0. Avant de commencer (une seule fois)
- Lisez
MARCA.mdde ce skill : couleur d'accent, nom de marque, pseudo, phrases. S'il est incomplet, demandez ces données à l'utilisateur et complétez-le. - Dépendances :
pip install -r scripts/requirements.txt(numpy, pillow, imageio-ffmpeg, faster-whisper). La première transcription télécharge le modèle Whisper « medium » (~1,5 Go).
Raccourci : dans les commandes ci-dessous, S = chemin vers scripts/ de ce skill (ex. ~/.claude/skills/editor-videos-1porciento/scripts).
1. Flux par vidéo
- Configuration : copiez
ejemplos/historia_ejemplo.json(9:16) ouejemplos/feed_ejemplo.json(4:5) dans le dossier du projet et complétezvideo,words,salida,marca,acento,cierre,portada.recorte: zone de la vidéo originale à utiliser (x, y, w, h en pixels de l'original). Doit respecter les proportions du format (9:16 story, 4:5 feed). Mesurez la taille de l'original avec ffprobe d'abord.
- Transcrire :
python S/editar_video.py transcribir config.json→ génère le fichierwords.jsonavec le temps par mot. - Corriger manuellement le words.json : noms propres, marques, nombres (« 1% »), expressions. Enregistrez-le sous
*_words_ok.jsonet pointez le config vers ce fichier. Ajoutez dans le config"vocabulario"avec les noms qui se répètent pour que Whisper les identifie correctement. - Silences :
python S/auto_cortes.py video.mov 0.12→ imprime la liste descortes(mesurée par énergie audio, PAS avec les temps de Whisper). Collez-la dans"cortes". Si une coupure tombe entre deux parties d'un même mot, supprimez-la. - Mots-clés (
claves) : les mots qui sont colorés avec la couleur d'accent dans les sous-titres. Écrivez-les exactement comme ils apparaissent dans le words.json (avec la ponctuation attachée, ex."tiempo."). - Motion graphics (
motion) : utilisez-les TOUJOURS par défaut, 3 à 6 par vidéo, aux moments forts du script. Voir tableau ci-dessous. - Zoom (
zoom) et musique (musica) : activés par défaut. - Vérifier les images avant le rendu long :
python S/editar_video.py preview config.json 4.5→work/_prev_4.5.jpg(seconde de la vidéo finale). Vérifiez les sous-titres, motion graphics et le cadrage du visage. - Rendu :
python S/editar_video.py render config.json→salida.mp4+salida_PORTADA.png. - Examinez des images du résultat (ffmpeg select de 3-4 images en une bande) avant de livrer. Une fois terminé, ouvrez le dossier avec les vidéos pour l'utilisateur.
Si l'utilisateur demande story ET feed, faites deux configs (même words.json, format/cadrage/position des sous-titres différents). On peut les rendre en parallèle avec 8 Go de RAM.
2. Règles que nous avons apprises (ne pas sauter)
- Transcrire sans VAD (déjà configuré dans le script) : avec VAD, on perd la première phrase.
- Vidéos iPhone HDR (HLG, 4K60) : NE PAS appliquer de tonemap avec zscale (introduit des artefacts). La vidéo brute avec l'égalisation douce du script donne un bon rendu.
- Qualité maximale toujours : H.264 crf 14 preset slow, audio AAC 320k, voix normalisée à -14 LUFS. Ne réduisez pas la qualité pour réduire le poids, sauf demande explicite.
- Position des sous-titres :
subs_y~1300 en story (zone sécurisée IG), ~1060 en feed. Les motion graphics sont placés en haut, loin du visage et des sous-titres. - Textes à l'écran : courts, en MAJUSCULES, directs. Pas de longues phrases.
3. Référence du config
| clé | description |
|---|---|
formato | "historia" (1080×1920) ou omis = feed (1080×1350) |
video, words, salida | chemins de la vidéo brute, du words.json et du mp4 final |
recorte | {x,y,w,h} de l'original |
pre / post | secondes de silence avant le premier mot / après le dernier |
subs_y | hauteur des sous-titres |
claves | mots en couleur d'accent |
cortes | [[ini, fin], ...] en secondes de l'original, supprimés |
acento | couleur de marque [R,G,B] (défaut corail [255,104,74]) |
marca | nom de la marque (plaque d'entrée/sortie et couverture) |
logo | chemin vers un PNG carré du logo (couverture, optionnel) |
logo_led | photo d'un panneau néon avec le logo → entrée/sortie « LED ». Sans cela, on utilise la plaque de couleur |
placa | entrée/sortie personnalisés : {"marca","color","kicker","filas":[...],"pie","size","entrada","cierre"} |
sin_intro | true = démarre directement avec la vidéo |
cierre | {"titulo":[...],"by","fecha","plataformas","handle"} (sortie LED) — avec plaque, on utilise by, fecha, handle |
cierre_seg | durée de la sortie |
portada | {"segundo","kicker","titulo":[lignes],"size","fecha","pie"} |
zoom | `{"push":0.05,"cortes":0.08,"cara":[x,y],"punch":[{"palabra","hasta" |
musica | {"bpm":92,"seed":3,"vol":0.2,"ducking":0.75} — beat généré (sans droits d'auteur), baisse automatiquement quand il y a de la voix. Changez seed pour une autre variation |
vocabulario | texte avec noms propres pour aider Whisper |
Motion graphics (motion : liste d'événements)
Chaque événement : {"tipo", "palabra", "hasta" ou "dur", "extra", "txt", "pos":[x,y], "size", "rot", "anim", "escala", "offset"}. pos = centre de l'élément dans l'image finale.
Il apparaît quand palabra est dite (si elle se répète, "n": 2 = deuxième occurrence) et disparaît avec hasta (+ extra s) ou après dur s. anim : "pop" (défaut), "slide" (avec "desde" px), "slam".
| type | description | champs propres |
|---|---|---|
texto | grand texte avec contour | txt, size, coral:true = couleur d'accent |
chip | étiquette arrondie | txt, size, claro |
sello | tampon incliné comme un timbre | txt, size, rot |
slam | grand nombre/mot qui frappe | txt, size |
calendario | feuille de calendrier | txt (jour), big (nombre), sub |
envivo | badge « EN VIVO » | txt |
plataforma | badge de réseau social avec sa couleur (TIKTOK, YOUTUBE, KICK ; autre texte = badge sombre) | txt |
contador | nombre qui compte | voir motion.py |
misterio | panneau d'invité avec point d'interrogation | lineas |
Chaque motion graphic amène automatiquement son effet sonore.
4. Showreel (clips sans voix au rythme de la musique)
python S/showreel.py config.json — config avec clips (chaque clip dure beats temps et peut avoir label), bpm, formato, etiqueta_y, textos, placa, seed, vol. Avant d'en créer un, lisez main() dans showreel.py pour voir les champs exacts de chaque clip.
5. Quand utiliser un autre outil
- Animations/motion design plus complexes (titres animés, explications, intros 3D, graphiques) : skill
hyperframes(routeur officiel de HyperFrames). - Montage long pour YouTube, couper erreurs/répétitions, storytelling : skills du kit de Nate Herk (
edit-video,cut-mistakes,short-form-edit,video-storytelling), exécutés depuis le dossier du kit.