#audio-processing #processing #recognition #aubio #ffi #safe-bindings

aubio-rs

Safe bindings for aubio library to label music and sounds

4 releases

0.2.0 Apr 30, 2021
0.1.3 Apr 4, 2020
0.1.2 Feb 14, 2020
0.1.0 Jan 23, 2020

#731 in Audio

34 downloads per month
Used in audio-similarity-search

GPL-3.0 license

4.5MB
114K SLoC

Rust 89K SLoC // 0.0% comments C 19K SLoC // 0.1% comments Python 6K SLoC // 0.2% comments Forge Config 300 SLoC // 0.8% comments Batch 165 SLoC Shell 48 SLoC // 0.1% comments

Safe aubio library bindings

github crate docs GPL-3.0 CI

This projects aims provide safe Rust bindings for aubio C library.

Aubio is a library to label music and sounds.

It listens to audio signals and attempts to detect events. For instance, when a drum is hit, at which frequency is a note, or at what tempo is a rhythmic melody.

Its features include segmenting a sound file before each of its attacks, performing pitch detection, tapping the beat and producing midi streams from live audio.

aubio provide several algorithms and routines, including:

  • several onset detection methods
  • different pitch detection methods
  • tempo tracking and beat detection
  • MFCC (mel-frequency cepstrum coefficients)
  • FFT and phase vocoder
  • up/down-sampling
  • digital filters (low pass, high pass, and more)
  • spectral filtering
  • transient/steady-state separation
  • sound file read and write access
  • various mathematics utilities for music applications

The name aubio comes from audio with a typo: some errors are likely to be found in the results.

Crate features

The following features can be used to customize crate configuration:

  • bindgen Force generate bindings itself instead of use pre-generated (useful for unsupported archs)
  • builtin Force compile builtin aubio C-library
  • pkg-config Use pkg-config to find installed libraries
  • shared Build shared aubio C-library
  • static Build static aubio C-library
  • fftw3 Enable using fftw3 library

When pkg-config feature is used the installed aubio library will be used if found. To force build and link builtin version you can use builtin feature.

Dependencies