Visão Geral
Esta skill gera um vídeo que visualiza áudio — formas de onda ou elementos sincronizados com a batida — a partir de um arquivo de música usando uma composição HyperFrames. Use quando uma faixa precisar de um visual complementar sem edição manual. Ela renderiza o MP4 final a partir da composição.
HyperFrames — Música para Vídeo
Uma faixa de música → um vídeo sincronizado com a batida. Letra, apresentação de slides ou promo cinético. A música dita o ritmo.
Quando Usar
- O usuário fornece um arquivo de áudio e quer um vídeo para ele
- O usuário fornece um vídeo para extrair áudio (extração de música)
- O usuário fornece um briefing de humor ("lofi animado para lançamento de produto")
- O usuário quer um vídeo de letra (palavras sincronizadas com vocais)
- O usuário quer uma apresentação de slides sincronizada com a batida (imagens mudando nas batidas)
- O usuário quer um promo cinético (tipografia pulsando com a faixa)
Quando NÃO Usar
- O usuário quer um lançamento de produto a partir de uma URL (use
hyperframes-product-launch-video) - O usuário quer um vídeo de cabeça falante (use
hyperframes-talking-head-recut) - O usuário quer narração/locução (use
hyperframes-faceless-explainer) - Sem música envolvida (use
hyperframes-motion-graphics)
Fluxo de Trabalho
1 · Resolver o áudio
Três caminhos de entrada:
- Arquivo de áudio fornecido: investigue com
ffprobepara duração, BPM (estimar ou detectar) - Vídeo fornecido: extraia com
ffmpeg -i input.mp4 -vn -acodec libmp3lame audio.mp3 - Briefing de humor: gere via modelo TTS/música, ou selecione do catálogo BGM
2 · Mapear a estrutura da batida
Ouça (ou analise) para seções:
- Intro (0-8s) → título/estabelecimento
- Verso → conteúdo/apresentação de slides
- Refrão/Pico → clímax/pico cinético
- Final → CTA/desaparecimento
Escreva um mapa de batidas: [{ time: 0, section: "intro" }, { time: 8, section: "verse" }, ...]
3 · Planejar cenas para seções
Cada seção musical recebe um tratamento visual:
- Intro: fade-in lento, movimento mínimo
- Verso: revelações constantes, um elemento a cada 2-4 batidas
- Refrão: energia máxima — explosões de escala, mudanças de cor, cortes rápidos
- Ponte: pausa visual — parada estática ou panorâmica lenta
- Final: resolver até o cartão final
4 · Construir a composição
Ancore cada tempo de início de animação ao mapa de batidas. Use keyframes CSS ou GSAP com tempos absolutos correspondentes aos limites das seções.
<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">LETRA DO REFRÃO AQUI</h1>
</div>
<audio data-start="0" data-duration="60" src="./track.mp3"></audio>
</div>
5 · Renderizar
npx hyperframes render --output music-video.mp4
Verifique a sincronização: amostre quadros nos limites das seções, confirme que as mudanças visuais ocorrem nas batidas (tolerância de ±2 quadros).
Tabela de Antirracionalização
| Racionalização | Realidade |
|---|---|
| "Vou ajustar o tempo no olho" | Mapa de batidas primeiro — cada cena ancorada aos tempos das seções |
| "Vou usar a mesma energia o tempo todo" | O refrão é mais intenso que o verso — a dinâmica importa |
| "Vou pular a investigação do áudio" | Incompatibilidade de duração/BPM quebra todo o render |
| "Vou animar no tempo real" | Todas as animações são buscáveis — tempos absolutos na composição |
Verificação
- Áudio resolvido (arquivo, extraído ou gerado)
- Mapa de batidas escrito com limites das seções
- Cada seção tem um tratamento visual distinto
- Tempos de animação correspondem ao mapa de batidas (±2 quadros)
- Duração da saída corresponde à duração do áudio
- O refrão/clímax é visualmente distinto do verso