https://github.com/zak-45/wledaudiosyncrtbeat
Real Time beat detection using aubio. Send BPM to OSC.
https://github.com/zak-45/wledaudiosyncrtbeat
beat beat-detection bpm music osc real-time
Last synced: about 2 months ago
JSON representation
Real Time beat detection using aubio. Send BPM to OSC.
- Host: GitHub
- URL: https://github.com/zak-45/wledaudiosyncrtbeat
- Owner: zak-45
- License: mit
- Created: 2023-10-27T09:02:46.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-08T22:59:38.000Z (4 months ago)
- Last Synced: 2025-03-27T05:02:24.159Z (2 months ago)
- Topics: beat, beat-detection, bpm, music, osc, real-time
- Language: Python
- Homepage:
- Size: 471 KB
- Stars: 14
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Onset Beat Detection to OSC
[](https://github.com/zak-45/WLEDAudioSyncRTBeat/actions/workflows/manual.yml)
This is a simple beat detector built with [aubio](https://github.com/aubio/aubio).
It will detect the beat and BPM on the default audio input.
On every beat, the current BPM is sent to one or more OSC servers.
Command line only.
This is a feature of [WLEDAudioSync Chataigne Module](https://github.com/zak-45/WLEDAudioSync-Chataigne-Module).
You can see a demo here : [WLEDAudioSyncRTBeat demo](https://youtu.be/VXM_zEzKo6M)
Chataigne view:
## Installation
Win / Mac / Linux
Take your release from there : https://github.com/zak-45/WLEDAudioSyncRTBeat/releases
```
No python need.
This is a portable version, put it on a nice folder and just run it according your OS.
```
** INFO **
---
Some anti virus could warn you, this is false positive.
If you do not trust you can still proceed with step below.
---
Other OS / all OS with Python installed
Install required modules
```
pip install -r requirements.txt
```
download WLEDAudioSyncRTBeat.py file and run it:
```
python WLEDAudioSyncRTBeat.py
```
## Usage
```
WLEDAudioSyncRTBeat-{OS} beat|list [-h] -s IP PORT ADDRESS MODE [-b BUFSIZE] [-v] [-d DEVICE]
optional arguments:
-h, --help show this help message and exit
-s IP PORT ADDRESS MODE, --server IP PORT ADDRESS
OSC Server address (multiple can be provided)
MODE can be PLAIN (bpm), HALF (bpm / 2), GMA3 sqrt(bpm / 240) * 100, default to PLAIN
-b BUFSIZE, --bufsize BUFSIZE
Size of audio buffer for beat detection (default: 512)
-v, --verbose Print BPM on beat / dB
-d DEVICE, --device DEVICE
Input device index (use list command to see available devices)
```
### `-s`/`--server`
Add an `IP`, `PORT` and OSC `ADDRESS` to which the BPM beat signal will be sent to. Example: `-s 127.0.0.1 21000 /foo/beat`
### `-b`/`--bufsize`
Select the size of the buffer used for beat detection.
A larger buffer is more accurate, but also more sluggish.
Refer to the [aubio](https://github.com/aubio/aubio) documentation of the tempo module for more details.
Example: `-b 128`
### `-v`/`--verbose`
Output a handy beat indicator and the current BPM / dB to stdout.
### `-d`/`--device`
Specify the index of input device to be used.
If not provided, the default system input is used.
Run `WLEDAudioSyncRTBeat list` to get all available devices.
## Example
```
$ WLEDAudioSyncRTBeat-Linux beat -s 127.0.0.1 12000 /WLEDAudioSync/BPM -s 10.10.13.37 12345 /test/baz GMA3 -v
```
This will send beat messages to the OSC address `/WLEDAudioSync/BPM ` on `127.0.0.1:12000` and `/test/baz` on `10.10.13.37:12345`.
Additionally, the current BPM will be printed to stdout, and for 10.10.13.37 will send GMA3 bpm value
## Info
```
First time you run WLEDAudioSyncRTBeat-{OS},
this will create folder ./WLEDAudioSyncRTBeat and extract all files on it.
To save some space and time,
you can then delete WLEDAudioSyncRTBeat-* and run the app from created folder.
```
## Credits
Thanks to : https://github.com/DrLuke/aubio-beat-osc.