BPMgraph

BPMgraph es una herramienta de software que permite cuantificar gráficamente los pulsos por minuto de colecciones musicales. Su diseño está pensado para funcionar como una herramienta de análisis de pistas musicales, evaluando sus ritmos, cadencias y tempos expresados en BPM.

El BPM (pulsos por minuto, o beats per minute en inglés) es una medida del ritmo o tempo de una pista de audio, indicando cuántos pulsos o golpes (generalmente, estos “golpes” corresponden a la pulsación de la base rítmica) ocurren en un minuto. Es una forma estándar de cuantificar la velocidad de la música, especialmente útil en géneros como el dance, la electrónica o la música de baile, donde el tempo es un aspecto clave para la organización y mezcla de canciones.

En otras palabras, BPMgraph representa visualmente estos pulsos por minuto, permitiendo analizar la variabilidad y consistencia de los ritmos a lo largo de una colección musical.

La herramienta está diseñada para que puedas especificar un directorio con un conjunto de piezas musicales, calcular el BPM de cada una y generar una gráfica con los resultados.

Los archivos de sonido soportados son .mp3, .wav, .flac y .ogg.

Instalación y uso

Este manual te guiará en los pasos necesarios para instalar, configurar y utilizar el script para calcular los BPM de las canciones en un directorio.

Requisitos previos

Antes de comenzar, asegúrate de cumplir con los siguientes requisitos:

• Python 3.7 o superior: Puedes descargarlo desde python.org.
• Paquetes necesarios (dependencias): librosa, matplotlib, y tqdm
• Archivos de audio compatibles: El script

Instalación y uso del script

Instalar dependencias

Abre una terminal y ejecuta los siguientes comandos en los sistemas operativos GNU/Linux:

pip install librosa matplotlib tqdm

Esto instalará las bibliotecas necesarias.

Descargar el script

Descarga o copia el script y guárdalo como BPMgrpah.py o bien directamente por medio del comando git

git clone https://github.com/nvjacobo/BPMgraph

Uso del script

Preparar el entorno

Coloca las canciones que deseas analizar en un directorio específico (por ejemplo: /ruta/a/mis/canciones).

Ejecutar el script

En la terminal, navega hasta el directorio donde guardaste el script:

 cd BPMgraph

Ejecuta el script:

 python BPMgraph.py

El script te pedirá que ingreses la ruta del directorio que contiene tus canciones. Por ejemplo:

/ruta/a/mis/canciones

Resultados

Salida:

Mensajes de progreso mientras se procesan las canciones:

Procesando canciones: 100%|███████████████████████████████| 5/5 [00:15<00:00,  3.00s/canción]
Generando gráfico...
Gráfico guardado en bpm_graph.png

Archivo generado:
    Nombre: bpm_graph.png
    Contenido: BPM graph: pulsaciones por minuto.

Solución de problemas

Error: No se encuentran canciones

Asegúrate de que el directorio contiene archivos con extensiones compatibles: .mp3, .wav, .flac, .ogg.

Error: No se puede abrir el archivo

Personalización

Si deseas personalizar el script:

Cambiar colores:
Modifica los colores alternados en la función plot_bpm_data:

color=['#4caf50' if i % 2 == 0 else '#2196f3' for i in range(len(song_names))]

Guardar la gráfica en otro lugar:

Cambia la ruta de salida output_path:

output_path = “/ruta/deseada/bpm_graph.png”