Crear Shorts cinéticos con voz
Todo se renderiza con el pipeline incluido en pipeline/ junto a este archivo
(el "Directorio base para este skill" que se muestra al cargar el skill).
0. Configuración (una vez por proyecto)
Si el proyecto no tiene una carpeta video_gen/ con kinetic_build.py, créala:
mkdir -p video_gen && cp <directorio del skill>/pipeline/* video_gen/
cd video_gen
python3 -m venv .venv && .venv/bin/pip install -r requirements.txt # dibujo (Python 3.11+)
python3.12 -m venv .venv-tts && .venv-tts/bin/pip install -r requirements-tts.txt # Kokoro voz
ffmpeg debe estar en el PATH. voice.py ejecuta el worker de TTS en .venv-tts junto a él.
Ejecuta todos los comandos desde video_gen/.
1. Lee las reglas
DESIGN.md- el estilo visual cinético. Reglas estrictas: las cajas se apilan en una sola columna de ancho completo, nunca una al lado de la otra; sin barras decorativas en los bordes de las cajas; texto grande; cada elemento aparece en su palabra hablada; los títulos caben en una línea (unas 30 caracteres); sin subtítulos incrustados.PARTS.md- el formato depart.md, reglas de narración y cómo dividir una guía. No leasengine_short.py,templates.pyniskin.pya menos que los estés depurando.
2. Serie nueva: dividir primero, obtener aprobación
- Analiza la guía fuente y propón una lista de partes (un concepto por parte, de unos 90–125 s cada una). Detente para obtener la aprobación del usuario. Nunca recortes contenido para alcanzar una longitud; en su lugar, añade ejemplos y el "por qué".
- Escribe cada
<serie>/pNN_<slug>/part.md, más<serie>/README.mdcon el análisis y una tabla de partes. - Agrega la carpeta de la serie a
SERIESenbuild_part.py(introducción + pie de página). Opcionalmente agrega una marca de logotipo aMARKSenkinetic.py. - Revisa la narración:
.venv/bin/python build_part.py <directorio de la parte> --linty corrige cualquier problema. Narración: sin resumen, sin bienvenida, ve directo al tema; sin símbolos ni código; deletrea los acrónimos para la voz; los beats tienen como máximo 45 palabras.
3. Escenas
Cada parte obtiene un scenes.py que define SCENES. Dos estilos (ver examples/):
- Bloques de etapa declarativos (preferido, rápido):
SCENES = K.part(palabra, etiqueta, chips, [[bloques...], ...])usandoTrack, Pipe, Rows, Code, Lanes, Bars, Ring, Fan, Chips, Big, Note. Una cue es un prefijo de palabra (buscado después de la cue anterior del bloque),(palabra, beat)o un número de beat. Ejemplo:examples/p03_*. - Clases
Sceneescritas a mano para una metáfora que los bloques no pueden mostrar. Ejemplo:examples/p01_*. Enumera las palabras cue en orden hablado, o las cues aparecerán como MISSING.
4. Verifica, luego renderiza
.venv/bin/python kinetic_build.py <directorio de la parte> --stills /tmp/pNN.png # hoja de contacto + informe de cues
.venv/bin/python kinetic_build.py <directorio de la parte> --out <serie>/output # <slug>_voiced.mp4 final
.venv/bin/python cue_scan.py <serie>/p*_* # verificación de sincronización solo texto
Corrige cualquier cue MISSING y overflow antes del render final. Para una serie completa, renderiza las dos primeras
partes y obtén la aprobación del usuario sobre el aspecto, luego ejecuta el resto de 3 en 3 en segundo plano
(xargs -P 3).
5. Informe
Una tabla: enlace MP4, tema, duración, silencio más largo (objetivo inferior a 1 s). Marca las partes renderizadas en el README de la serie. Indica claramente lo que no se ha comprobado (fotogramas no vistos, audio no escuchado).
Nunca
- Pongas cajas una al lado de la otra, barras decorativas en los bordes, texto pequeño ni subtítulos incrustados.
- Propongas calibración de voz por vídeo; la sincronización está basada en palabras y es genérica.
- Edites
engine_short.pydirectamente;build_part.pylo modifica en memoria.