zroeschen/Video-Production-Factory

CLI de HyperFrames

Todo se ejecuta mediante npx hyperframes. Requiere Node.js >= 22 y FFmpeg.

Flujo de trabajo

1. Iniciar — npx hyperframes init mi-video
2. Escribir — crear composición HTML (consulta la skill hyperframes)
3. Validar — npx hyperframes lint
4. Previsualizar — npx hyperframes preview
5. Renderizar — npx hyperframes render

Valida antes de previsualizar: detecta data-composition-id faltantes, pistas superpuestas y líneas de tiempo no registradas.

Inicialización

npx hyperframes init mi-video                        # asistente interactivo
npx hyperframes init mi-video --example warm-grain   # elegir un ejemplo
npx hyperframes init mi-video --video clip.mp4        # con archivo de video
npx hyperframes init mi-video --audio pista.mp3       # con archivo de audio
npx hyperframes init mi-video --non-interactive       # saltar indicaciones (CI/agentes)

Plantillas: blank, warm-grain, play-mode, swiss-grid, vignelli, decision-tree, kinetic-type, product-promo, nyt-graph.

init crea la estructura de archivos adecuada, copia los medios, transcribe el audio con Whisper e instala las skills de codificación de IA. Úsalo en lugar de crear archivos manualmente.

Validación (Lint)

npx hyperframes lint                  # directorio actual
npx hyperframes lint ./mi-proyecto    # proyecto específico
npx hyperframes lint --verbose        # hallazgos a nivel informativo
npx hyperframes lint --json           # salida legible por máquina

Valida index.html y todos los archivos en compositions/. Reporta errores (deben corregirse), advertencias (deberían corregirse) e información (con --verbose).

Previsualización

npx hyperframes preview                   # servir directorio actual
npx hyperframes preview --port 4567       # puerto personalizado (por defecto 3002)

Recarga automática al cambiar archivos. Abre el estudio en el navegador automáticamente.

Renderizado

npx hyperframes render                                # MP4 estándar
npx hyperframes render --output final.mp4             # salida con nombre
npx hyperframes render --quality draft                # iteración rápida
npx hyperframes render --fps 60 --quality high        # entrega final
npx hyperframes render --format webm                  # WebM con transparencia
npx hyperframes render --docker                       # salida byte-idéntica

Banderas	Opciones	Por defecto	Notas
--output	ruta	renders/nombre_timestamp.mp4	Ruta de salida
--fps	24, 30, 60	30	60fps duplica tiempo de render
--quality	draft, standard, high	standard	draft para iterar
--format	mp4, webm	mp4	WebM admite transparencia
--workers	1-8 o auto	auto	Cada uno inicia Chrome
--docker	bandera	off	Salida reproducible
--gpu	bandera	off	Codificación acelerada por GPU
--strict	bandera	off	Fallar en errores de lint
--strict-all	bandera	off	Fallar en errores y advertencias

Guía de calidad: draft mientras iteras, standard para revisión, high para entrega final.

Transcripción

npx hyperframes transcribe audio.mp3
npx hyperframes transcribe video.mp4 --model medium.en --language es
npx hyperframes transcribe subtitulos.srt   # importar existente
npx hyperframes transcribe subtitulos.vtt
npx hyperframes transcribe openai-response.json

Texto a Voz (TTS)

npx hyperframes tts "Texto aquí" --voice af_nova --output narracion.wav
npx hyperframes tts guion.txt --voice bf_emma
npx hyperframes tts --list  # mostrar todas las voces

Solución de Problemas

npx hyperframes doctor       # verificar entorno (Chrome, FFmpeg, Node, memoria)
npx hyperframes browser      # gestionar Chrome incluido
npx hyperframes info         # versión y detalles del entorno
npx hyperframes upgrade      # buscar actualizaciones

Ejecuta doctor primero si el renderizado falla. Problemas comunes: FFmpeg faltante, Chrome faltante, poca memoria.

Otros

npx hyperframes compositions   # listar composiciones del proyecto
npx hyperframes docs           # abrir documentación
npx hyperframes benchmark .    # medir rendimiento de renderizado