CLI de HyperFrames
Todo se ejecuta mediante npx hyperframes. Requiere Node.js >= 22 y FFmpeg.
Flujo de trabajo
- Andamiaje —
npx hyperframes init my-video - Escribir — crea composiciones HTML (consulta la skill
hyperframes) - Validar —
npx hyperframes lint - Previsualizar —
npx hyperframes preview - Renderizar —
npx hyperframes render
Valida antes de previsualizar — detecta data-composition-id faltantes, pistas superpuestas, líneas de tiempo no registradas.
Andamiaje
npx hyperframes init my-video # asistente interactivo
npx hyperframes init my-video --example warm-grain # elegir un ejemplo
npx hyperframes init my-video --video clip.mp4 # con archivo de video
npx hyperframes init my-video --audio track.mp3 # con archivo de audio
npx hyperframes init my-video --non-interactive # omitir prompts (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 correcta, copia archivos multimedia, transcribe audio con Whisper e instala skills de IA. Úsalo en lugar de crear archivos manualmente.
Validación
npx hyperframes lint # directorio actual
npx hyperframes lint ./my-project # proyecto específico
npx hyperframes lint --verbose # hallazgos de nivel informativo
npx hyperframes lint --json # 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 el directorio actual
npx hyperframes preview --port 4567 # puerto personalizado (predeterminado 3002)
Recarga en caliente ante cambios de archivos. Abre el estudio automáticamente en tu navegador.
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 transparente
npx hyperframes render --docker # byte-idéntico
| Bandera | Opciones | Predeterminado | Notas |
|---|---|---|---|
--output | ruta | renders/nombre_timestamp.mp4 | Ruta de salida |
--fps | 24, 30, 60 | 30 | 60fps duplica el tiempo de render |
--quality | draft, standard, high | standard | draft para iterar |
--format | mp4, webm | mp4 | WebM soporta 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 validación |
--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 en
npx hyperframes transcribe subtitles.srt # importar existente
npx hyperframes transcribe subtitles.vtt
npx hyperframes transcribe openai-response.json
Texto a Voz
npx hyperframes tts "Texto aquí" --voice af_nova --output narracion.wav
npx hyperframes tts script.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 empaquetado
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 en el proyecto
npx hyperframes docs # abrir documentación
npx hyperframes benchmark . # evaluar rendimiento del renderizado