Vídeo com Batida Musical (Beat Sync)
Use
librosapara detectar as batidas da música de fundo e sincronize as imagens exatamente nos pontos de batida, com efeitos visuais, criando vídeos curtos energéticos de "beat sync". Tudo passa peloskills/shared/scripts/beatsync.py– não conte batidas manualmente, nem monte filtros à mão – o script já cuida de: detecção de batidas, divisão de intervalos, loop de material e sincronização áudio-visual.
Para um slideshow suave com duração fixa por imagem, veja slideshow-video; para vídeos automáticos com tema e narração por IA, veja auto-short-video.
Entrada
| Campo | Obrigatório | Descrição |
|---|---|---|
| Música de fundo | Sim | Arquivo de música que define as batidas (quanto mais ritmado, melhor; se não fornecido, pergunte) |
| Material | Sim | Conjunto de imagens e/ou clipes curtos (na ordem, em loop), ou um diretório |
| Proporção | Sim | Se o usuário ou tarefa upstream não especificar paisagem/retrato (ou resolução exata), obrigatório perguntar antes de produzir e aguardar confirmação; não inferir silenciosamente por plataforma, perfil ou padrão |
| Frequência de troca | Não | A cada quantas batidas trocar (padrão: 2 batidas) |
| Efeito | Não | zoom (aproximação, padrão) / flash (flash branco) / none |
Saída (outputs/NomeDoTema/)
- Vídeo final sincronizado (
*.mp4) - Relatório: número de segmentos, duração total, BPM detectado, efeito utilizado
Passos de Execução
Caminho do script (relativo à raiz do projeto): skills/shared/scripts/beatsync.py (build -h / beats -h).
1. (Opcional) Visualizar as batidas primeiro
python skills/shared/scripts/beatsync.py beats --music <música>
# Imprime tempo (BPM) e os instantes das batidas – ajuda a decidir --every
2. Gerar o vídeo sincronizado
python skills/shared/scripts/beatsync.py build \
-i 1.jpg 2.jpg 3.jpg 4.jpg --music <música> \
-o outputs/NomeDoTema/show.mp4 \
--size 1080x1920 --every 2 --effect zoom
- Material = imagens ou clipes curtos; pode ser menor que o número de segmentos (reutiliza automaticamente em loop).
--every 1troca a cada batida (estilo rápido, requer mais material);--every 4troca a cada 4 batidas (mais suave).--effect flashflash branco no início de cada segmento (mais "explosivo");--effect nonecorte seco sem efeito.--max-duration 15limita o comprimento do vídeo (ex.: para TikTok de 15s).- Também é possível usar
--images-dir <diretório>para fornecer material em lote (ordenado por nome de arquivo).
Sensibilidade ao Perfil
- Com perfil:
platforms.mdusado apenas para sugerir proporção – ainda requer confirmação do usuário; estilo (rápido/suave) e efeito alinhados com a identidade da conta (contas de moda/esportes tendem a flash rápido; contas de estilo de vida/bem-estar tendem a zoom suave). - Sem perfil: confirmar paisagem/retrato primeiro; padrão: every 2 batidas, efeito zoom.
Regras
- Quanto mais clara a batida musical, mais preciso o sincronismo; se não houver batidas perceptíveis, o script degrada automaticamente para intervalos iguais e relata no relatório.
- Use corte seco (sem transições suaves) – caso contrário, perde-se a sensação de batida – é intencional.
- Material insuficiente → loop automático; material suficiente → recomendar
--every 1~2para renovar o quadro em cada segmento. - O vídeo final terá a mesma duração da música por padrão; use
--max-durationpara limitar conforme plataforma. - Saídas sempre em
outputs/NomeDoTema/.
Referência
A detecção de batidas usa librosa beat_track (intensidade de ataque + programação dinâmica para encontrar as batidas). O corte seco nos pontos de batida é a prática padrão para vídeos "beat sync". O processo (batidas → intervalos → renderização segmento por segmento → sincronização áudio-visual) é encapsulado em um script determinístico, evitando o trabalho manual de alinhar as batidas.