Welcome to Realtime BPM Analyzer, a powerful and easy-to-use TypeScript/JavaScript library for detecting the beats-per-minute (BPM) of an audio or video source in real-time.
To install this module to your project, just launch the command below:
npm install realtime-bpm-analyzerTo learn more about how to use the library, you can check out the documentation.
- Dependency-free library that utilizes the Web Audio API to analyze audio or video sources and provide accurate BPM detection.
- Can be used to analyze audio or video nodes, streams as well as files.
- Allows you to compute the BPM while the audio or video is playing.
- Lightweight and easy to use, making it a great option for web-based music production and DJing applications.
- Supports MP3, FLAC and WAV formats.
If you encounter issues along the way, remember I have a chat and the new discussion feature of github !
Measure or detect the BPM from a web player.
This example shows how to deal with a simple audio node.
- An AudioNode to analyze. So something like this:
<audio src="./new_order-blue_monday.mp3" id="track"></audio>- Create the AudioWorkletProcessor with
createRealTimeBpmProcessor, create and pipe the filters to the AudioWorkletNode (realtimeAnalyzerNode).
import { createRealTimeBpmProcessor, getBiquadFilter } from 'realtime-bpm-analyzer';
const realtimeAnalyzerNode = await createRealTimeBpmProcessor(audioContext);
// Set the source with the HTML Audio Node
const track = document.getElementById('track');
const source = audioContext.createMediaElementSource(track);
const lowpass = getBiquadFilter(audioContext);
// Connect nodes together
source.connect(lowpass).connect(realtimeAnalyzerNode);
source.connect(audioContext.destination);
realtimeAnalyzerNode.port.onmessage = (event) => {
if (event.data.message === 'BPM') {
console.log('BPM', event.data.data.bpm);
}
if (event.data.message === 'BPM_STABLE') {
console.log('BPM_STABLE', event.data.data.bpm);
}
};Analyze the BPM of a source continuously. This feature is quite simple and basically get rid of all data inside the analyzer after the stabilizationTime is reached. Why ? Because we store all the "valid peaks" for each thresholds in order to find the best candidates. And we would keep all those data forever, we would have memory leaks.
Note: This approach is NOT recommended if you are using a microphone as source. Except if the microphone gets correct audio source. Typically, if the BPM is never computed using this approach, you probably capture low intensity audio with your microphone (too far from the source, too much noise, directional microphone could be reasons why it's not working).
- Streams can be played with AudioNode, so the approach is quite similar to the Player strategy.
<audio src="https://ssl1.viastreaming.net:7005/;listen.mp3" id="track"></audio>Thank you IbizaSonica for the stream.
- As for the Player strategy, except that we need to turn on the
continuousAnalysisflag to periodically delete collected data.
import { createRealTimeBpmProcessor, getBiquadFilter } from 'realtime-bpm-analyzer';
const realtimeAnalyzerNode = await createRealTimeBpmProcessor(audioContext, {
continuousAnalysis: true,
stabilizationTime: 20_000, // Default value is 20_000ms after what the library will automatically delete all collected data and restart analyzing BPM
});
// Set the source with the HTML Audio Node
const track = document.getElementById('track');
const source = audioContext.createMediaElementSource(track);
const lowpass = getBiquadFilter(audioContext);
// Connect nodes together
source.connect(lowpass).connect(realtimeAnalyzerNode);
source.connect(audioContext.destination);
realtimeAnalyzerNode.port.onmessage = (event) => {
if (event.data.message === 'BPM') {
console.log('BPM', event.data.data.bpm);
}
if (event.data.message === 'BPM_STABLE') {
console.log('BPM_STABLE', event.data.data.bpm);
}
};Analyze the BPM from files located on your desktop, tablet or mobile!
- Import the library
import * as realtimeBpm from 'realtime-bpm-analyzer';- Use an
input[type=file]to get the files you want.
<input type="file" accept="wav,mp3,flac" onChange={event => this.onFileChange(event)}/>- You can listen to the
changeevent like so, and analyze the BPM of the selected files. You don't need to be connected to the Internet for this to work.
function onFileChange(event) {
const audioContext = new AudioContext();
// Get the first file from the list
const file = event.target.files[0];
const reader = new FileReader();
reader.addEventListener('load', () => {
// The file is uploaded, now we decode it
audioContext.decodeAudioData(reader.result, audioBuffer => {
// The result is passed to the analyzer
realtimeBpm.analyzeFullBuffer(audioBuffer).then(topCandidates => {
// Do something with the BPM
console.log('topCandidates', topCandidates);
});
});
});
reader.readAsArrayBuffer(file);
};Realtime BPM Analyzer is using Web Test Runner to handle Unit tests and Web Dev Server to handle Dataset testing.
You will first need to install the project following these commands:
npm install
npm run prepareTo run the unit tests, you just have to run npm test.
To test a whole dataset of audio files you have to drop those files into testing/datasets and then run: npm run testing:prepare to create a manifest that contains the file name and the BPM (typically the verified one) from the metadata.
{
"my music file.mp3": 130
}You also need to build the library with npm run build.
Once those steps are done you can run npm run testing to challenge the library against your dataset. The Local/Offline strategy is used here.
If you're developing a new feature and you want to test it in another project, you can run bin/build/to-project.sh nameOfTheProject. This command will create package with npm pack and copy it into the target project nameOfTheProject sitting next to this one. You will then be able to test a production-like package.
TypeDoc is used to build the technical documentation of Realtime BPM Analyzer. To build the documentation run: npm run build:docs;
This library is distributed under the terms of the Apache License, Version 2.0. However, if you are interested in using this library in a commercial context or require a commercial license, please feel free to contact me.
For inquiries regarding commercial usage, licensing options, or any other questions, please contact me:
David Lepaux
[email protected]
I am open to discussing custom licensing arrangements to meet your specific needs and ensure that you can use this library in your commercial projects with confidence.
- Add confidence level of Tempo
- Combine Amplitude Thresholding strategy with others to improve BPM accuracy
- Improve the continuous analysis in order to ignore drops and cuts
- Monitor memory usage
Let me know what your most wanted feature is by opening an issue.
This library was inspired by the Tornqvist project, which was also based on Joe Sullivan's algorithm. Thank you to both of them.
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
![greenkeeper[bot] avatar](https://avatars.githubusercontent.com/in/505?v=4 "greenkeeper[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent