Créer des vidéos animées et vocales (Shorts)
Tout rendu utilise le pipeline fourni dans le dossier pipeline/ situé à côté de ce fichier
(le « Répertoire de base de ce skill » affiché lors du chargement du skill).
0. Configuration (une fois par projet)
Si le projet ne contient pas de dossier video_gen/ avec kinetic_build.py, créez-le :
mkdir -p video_gen && cp <dossier_skill>/pipeline/* video_gen/
cd video_gen
python3 -m venv .venv && .venv/bin/pip install -r requirements.txt # dessin (Python 3.11+)
python3.12 -m venv .venv-tts && .venv-tts/bin/pip install -r requirements-tts.txt # voix Kokoro
ffmpeg doit être accessible dans le PATH. voice.py exécute le worker TTS dans .venv-tts à côté de lui.
Exécutez toutes les commandes depuis video_gen/.
1. Lire les règles
DESIGN.md– le style visuel cinétique. Règles strictes : les boîtes s'empilent en une seule colonne pleine largeur, jamais côte à côte ; pas de barres d'accent sur les bords des boîtes ; texte grand ; chaque élément apparaît sur le mot prononcé correspondant ; les titres tiennent sur une ligne (environ 30 caractères) ; pas de sous-titres incrustés.PARTS.md– le formatpart.md, les règles de narration, et la manière de découper un guide.
Ne lisez pas engine_short.py, templates.py ou skin.py sauf pour les déboguer.
2. Nouvelle série : découpage d'abord, puis approbation
- Analysez le guide source et proposez une liste de parties (un concept par partie, environ 90–125 s chacune). Arrêtez-vous pour obtenir l'approbation de l'utilisateur. Ne coupez jamais le contenu pour atteindre une durée ; ajoutez plutôt des exemples et le « pourquoi ».
- Rédigez chaque
<série>/pNN_<slug>/part.md, ainsi que<série>/README.mdavec l'analyse et un tableau des parties. - Ajoutez le dossier de la série à
SERIESdansbuild_part.py(kicker + footer). Vous pouvez éventuellement ajouter un logo dansMARKSdekinetic.py. - Relisez la narration :
.venv/bin/python build_part.py <dossier_partie> --lintet corrigez tous les problèmes. Narration : pas de récapitulatif, pas de bienvenue, allez droit au sujet ; pas de symboles ni de code ; épellez les acronymes pour la voix ; maximum 45 mots par temps fort.
3. Scènes
Chaque partie possède un fichier scenes.py définissant SCENES. Deux styles (voir examples/) :
- Blocs déclaratifs (recommandé, rapide) :
SCENES = K.part(mot, tag, chips, [[blocs...], ...])utilisantTrack, Pipe, Rows, Code, Lanes, Bars, Ring, Fan, Chips, Big, Note. Un repère est un préfixe de mot (recherché après le repère précédent du bloc),(mot, temps)ou un numéro de temps. Exemple :examples/p03_*. - Classes
Sceneécrites à la main pour une métaphore que les blocs ne peuvent pas représenter. Exemple :examples/p01_*.
Listez les mots repères dans l'ordre parlé, sinon les repères reviennent comme MANQUANT.
4. Vérifier, puis rendre
.venv/bin/python kinetic_build.py <dossier_partie> --stills /tmp/pNN.png # planche contact + rapport des repères
.venv/bin/python kinetic_build.py <dossier_partie> --out <série>/output # <slug>_voiced.mp4 final
.venv/bin/python cue_scan.py <série>/p*_* # vérification de synchronisation texte seul
Corrigez chaque repère MANQUANT et tout dépassement avant le rendu final. Pour une série complète, effectuez le rendu des deux premières parties et obtenez l'accord de l'utilisateur sur l'apparence, puis lancez le reste par lots de 3 en arrière-plan
(xargs -P 3).
5. Rapport
Un tableau : lien MP4, sujet, durée, silence le plus long (cible sous 1 s). Marquez les parties rendues dans le README de la série. Dites clairement ce qui n'a pas été vérifié (images non visionnées, audio non écouté).
Jamais
- Mettre des boîtes côte à côte, des barres d'accent sur les bords, du petit texte ou des sous-titres incrustés.
- Proposer un calibrage vocal par vidéo ; la synchronisation est basée sur les mots et générique.
- Modifier directement
engine_short.py;build_part.pyle corrige en mémoire.