Resumen
Esta skill genera un video que visualiza el audio (forma de onda o elementos sincronizados con el ritmo) a partir de un archivo de música utilizando una composición HyperFrames. Úsala cuando una pista necesite un acompañamiento visual sin edición manual. Renderiza el MP4 final de la composición.
HyperFrames — Música a Video
Una pista musical → un video sincronizado con el ritmo. Videolyric, presentación de diapositivas o promo cinética. La música marca el ritmo.
Cuándo Usarlo
- El usuario proporciona un archivo de audio y quiere un video para él.
- El usuario proporciona un video para extraer audio (extracción de música).
- El usuario proporciona un resumen de estado de ánimo ("lo-fi alegre para el lanzamiento de un producto").
- El usuario quiere un videolyric (palabras sincronizadas con las vocales).
- El usuario quiere una presentación de diapositivas sincronizada con el ritmo (imágenes que cambian con los beats).
- El usuario quiere una promo cinética (tipografía palpitante con la pista).
Cuándo NO Usarlo
- El usuario quiere un lanzamiento de producto desde una URL (usa
hyperframes-product-launch-video). - El usuario quiere un video de presentador (usa
hyperframes-talking-head-recut). - El usuario quiere narración/locución (usa
hyperframes-faceless-explainer). - No hay música involucrada (usa
hyperframes-motion-graphics).
Flujo de trabajo
1 · Resolver el audio
Tres vías de entrada:
- Archivo de audio proporcionado: analizar con
ffprobepara duración, BPM (estimar o detectar). - Video proporcionado: extraer con
ffmpeg -i input.mp4 -vn -acodec libmp3lame audio.mp3. - Resumen de estado de ánimo: generar mediante modelo TTS/música, o elegir de un catálogo de música de fondo.
2 · Mapear la estructura de beats
Escuchar (o analizar) las secciones:
- Intro (0-8s) → título/establecimiento.
- Verso → contenido/presentación.
- Estribillo/Clímax → clímax/pico cinético.
- Outro → CTA/desvanecimiento.
Escribir un mapa de beats: [{ time: 0, section: "intro" }, { time: 8, section: "verse" }, ...]
3 · Planificar escenas según las secciones
Cada sección musical recibe un tratamiento visual:
- Intro: desvanecimiento lento, movimiento mínimo.
- Verso: revelaciones constantes, un elemento por cada 2-4 beats.
- Estribillo: máxima energía — estallidos de escala, cambios de color, cortes rápidos.
- Puente: respiro visual — plano estático o paneo lento.
- Outro: resolver en pantalla final.
4 · Construir la composición
Anclar cada tiempo de inicio de animación al mapa de beats. Usar keyframes CSS o GSAP con tiempos absolutos que coincidan con los límites de las secciones.
<div id="main" data-composition-id="music-video"
data-start="0" data-duration="60" data-width="1080" data-height="1920" data-fps="30">
<div class="clip chorus-hit" data-start="32" data-duration="8" data-track-index="1">
<h1 class="lyric-line">AQUÍ VA LA LETRA DEL ESTRIBILLO</h1>
</div>
<audio data-start="0" data-duration="60" src="./track.mp3"></audio>
</div>
5 · Renderizar
npx hyperframes render --output music-video.mp4
Verificar sincronización: tomar muestras de fotogramas en los límites de las secciones, confirmar que los cambios visuales corresponden a los beats (tolerancia ±2 fotogramas).
Tabla de Antirracionalizaciones
| Racionalización | Realidad |
|---|---|
| "Haré la sincronización a ojo" | Primero el mapa de beats — cada escena anclada a los tiempos de las secciones |
| "Mantendré la misma energía en todo el video" | El estribillo golpea más fuerte que el verso — la dinámica importa |
| "Saltaré el análisis de audio" | La discrepancia de duración/BPM arruina todo el renderizado |
| "Animaré según el reloj de pared" | Todas las animaciones son buscables — tiempos absolutos en la composición |
Verificación
- Audio resuelto (archivo, extraído o generado)
- Mapa de beats escrito con límites de sección
- Cada sección tiene un tratamiento visual distinto
- Los tiempos de animación coinciden con el mapa de beats (±2 fotogramas)
- La duración de salida coincide con la duración del audio
- El estribillo/clímax es visualmente distinto del verso