Vídeo musical con cortes al ritmo (Beat Sync Mashup)
Usa
librosapara detectar los beats de la música de fondo, haciendo que las imágenes cambien justo en los beats con cortes duros y efectos sincronizados al ritmo, creando un videoclip enérgico. Todo el proceso se maneja medianteskills/shared/scripts/beatsync.py. No cuentes beats manualmente ni crees filtros a mano: el script ya realiza la detección de beats, segmentación de intervalos, loop de material y alineación audio-video.
Para un pase de diapositivas suave con duración fija por imagen, consulta slideshow-video; para un video completo con tema → imágenes generadas por IA + locución, consulta auto-short-video.
Entrada
| Campo | Obligatorio | Descripción |
|---|---|---|
| Música de fondo | Sí | Archivo de música que determina los beats (cuanto más rítmica, mejor efecto; si no se proporciona, preguntar) |
| Material | Sí | Conjunto de imágenes y/o clips cortos (en orden, se reciclan cíclicamente), o un directorio |
| Relación de aspecto | Sí | Si el usuario o la tarea upstream no especifica explícitamente horizontal/vertical (o resolución concreta), se debe preguntar antes de producir y esperar confirmación; no inferir en silencio basándose en plataforma, perfil o valores por defecto. Si ya está claro, no repetir la pregunta |
| Frecuencia de cambio | No | Cada cuántos beats cambiar (por defecto cada 2 beats) |
| Efecto | No | zoom (acercamiento, por defecto) / flash (destello blanco) / none |
Salida (outputs/nombre-del-tema/)
- Video final con cortes al ritmo (
*.mp4) - Informe: número de segmentos sincronizados, duración total, BPM detectado, efecto usado
Pasos de ejecución
Ruta del script (relativa a la raíz del proyecto): skills/shared/scripts/beatsync.py (build -h / beats -h).
1. (Opcional) Visualizar beats primero
python skills/shared/scripts/beatsync.py beats --music <música>
# Imprime tempo (BPM) y marcas de tiempo de beats, útil para decidir el valor de --every
2. Generar el video con cortes al ritmo
python skills/shared/scripts/beatsync.py build \
-i 1.jpg 2.jpg 3.jpg 4.jpg --music <música> \
-o outputs/nombre-del-tema/show.mp4 \
--size 1080x1920 --every 2 --effect zoom
- Material = imágenes o clips cortos; la cantidad puede ser menor que el número de segmentos sincronizados (el script recicla automáticamente).
--every 1: cambia en cada beat (rápido, se necesita más material);--every 4: cambia cada compás (más relajado).--effect flash: destello blanco al inicio de cada segmento, más "enérgico";--effect none: corte duro limpio.--max-duration 15: limita la duración del video (por ejemplo, para un TikTok de 15s).- También se puede usar
--images-dir <directorio>para alimentar material en lote (ordenado por nombre de archivo).
Reconocimiento de perfil
- Con perfil:
platforms.mdse usa solo para sugerir relación de aspecto, pero se debe confirmar con el usuario; el estilo de corte (rápido/relajado) y el efecto deben ajustarse al tono de la cuenta (cuentas de tendencias/deportes prefieren rápido flash, cuentas de estilo de vida/saludables prefieren zoom relajado). - Sin perfil: primero confirmar horizontal/vertical; por defecto cada 2 beats, efecto zoom.
Reglas
- Cuanto más claro sea el ritmo musical, más preciso será el sincronismo; si no hay ritmo evidente, el script degrada automáticamente a cambios equidistantes e informa en el reporte.
- Se usan cortes duros (sin transiciones) para no difuminar la sensación de ritmo — es una decisión de diseño.
- Material insuficiente se recicla automáticamente; si hay suficiente, se sugiere
--every 1~2para que cada segmento tenga una imagen nueva. - Por defecto, el video tiene la misma duración que la música; usar
--max-durationpara ajustar a límites de plataforma. - Los archivos de salida van a
outputs/nombre-del-tema/.
Referencia
La detección de beats usa librosa con beat_track (intensidad de onset + programación dinámica para encontrar beats). El cambio de imagen justo en los beats es el estándar para mashups con cortes al ritmo. Este flujo de trabajo (beats → intervalos → renderizado por segmento → alineación audio-video) se encapsula en un script determinista para evitar contar beats manualmente y desincronizaciones.