KIT ABIERTO · EJECUCIÓN LOCAL · v1.0.0
Del guion al vídeo vertical.
Transforma clips, voz y una idea clara en un vídeo con cortes, palabras destacadas y sonido sincronizado.
Transforma clips, voz y una idea clara en un vídeo con cortes, palabras destacadas y sonido sincronizado.
video-viral-9x16 es un kit de producción de vídeos verticales para quienes crean contenido y quieren controlar la edición mediante código. Reúne un motor de textos animados, subtítulos sincronizados, montaje de escenas y mezcla de audio. Incluye un ejemplo completo de 48 segundos cuyo guion y archivos multimedia puedes adaptar a otros temas. Para ejecutarlo necesitas Linux, Node.js, Python y FFmpeg; los archivos multimedia del ejemplo ya están incluidos.
Los archivos proporcionados están organizados para que puedas estudiar, ejecutar y adaptar el proyecto. “Viral” describe el estilo de edición; no promete alcance.
El guion define el gancho, el beneficio y la llamada final. project.json almacena los cortes y tiempos; scenes.js controla la presentación.
El texto animado y los subtítulos usan los tiempos de cada palabra. La música baja durante la narración y los efectos entran en los momentos indicados.
Genera una hoja de vistas previas, valida los archivos de entrada y comprueba la cantidad de fotogramas del MP4. Escucha y mira el resultado antes de publicarlo.
Una idea principal, un gancho rápido y una acción final. Cada escena debe apoyar lo que se está diciendo.
Recomendado: Linux, Node.js 18+, Python 3.10+ y FFmpeg con ffprobe. La instalación descarga dependencias; el renderizado usa archivos locales.
Clona el repositorio e instala las dependencias de Python en un entorno aislado y el motor Canvas en Node.
# comando
git clone https://github.com/inematds/video-viral-9x16.git
cd video-viral-9x16
bash scripts/setup.shEjecuta los comandos desde la raíz del repositorio. El ejemplo contiene clips, narración, música, efectos y transcripción.
El validador comprueba los archivos, la continuidad de los cortes y los tiempos de las palabras.
.venv/bin/python scripts/viral.py validate exemplo-inemaccbot-v2/project.json
Abre out/prev/review.jpg dentro de la carpeta del ejemplo. Revisa el texto, el rostro y el contraste.
.venv/bin/python scripts/viral.py preview exemplo-inemaccbot-v2/project.json
El comando vuelve a generar la música, la base, la mezcla, el MP4 y la revisión técnica. La interpolación de cámara lenta puede tardar. Cada etapa tiene un límite de 30 minutos.
.venv/bin/python scripts/viral.py build exemplo-inemaccbot-v2/project.json
La copia incluye los archivos multimedia. Elige una carpeta nueva y después modifica los textos en scenes.js y los cortes en project.json.
.venv/bin/python scripts/viral.py new ../meu-video --example
Sin --example, obtienes una estructura que debes completar. Añade clips, narración, música, SFX y una transcripción con tiempos por palabra.
.venv/bin/python scripts/viral.py new ../novo-video # Después de preparar los archivos: .venv/bin/python scripts/viral.py validate ../novo-video/project.json
48 segundos, 20 fragmentos en el montaje, vídeo de 1080 × 1920 a 30 fps. Contenido y archivos multimedia del kit original, en portugués.
El vídeo se guarda en exemplo-inemaccbot-v2/out/INEMACCBOT_v2_9x16.mp4. La hoja técnica se guarda en out/qc/final_sheet.jpg. El control de calidad (QC) informa de la sonoridad; la revisión humana debe comprobar la voz, la música y la legibilidad.
La generación de nuevos archivos multimedia es una etapa independiente que tú eliges.