shithub: aubio


clone: git:// gits://
push: hjgit://
patches to: sigrid

Last commit

d2af4085 – Sigrid Solveig Haflínudóttir <> authored on 2023/08/21 11:45
examples: add a dumb /dev/audio support



[![CircleCI build status](]( "CircleCI build status")
[![Azure Pipelines](]( "Azure build status")
[![Appveyor build status](]( "Appveyor build status")
[![Pypi Downloads](](
[![Conda Downloads](](

[![Documentation](]( "Latest documentation")
[![Commits since last release](]( "Commits since last release")

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.

Python module

A python module for aubio is provided. For more information on how to use it,
please see the file [`python/`](python/ and the
[manual]( .


The python module comes with the following command line tools:

 - `aubio` extracts informations from sound files
 - `aubiocut` slices sound files at onset or beat timestamps

Additional command line tools are included along with the library:

 - `aubioonset` outputs the time stamp of detected note onsets
 - `aubiopitch` attempts to identify a fundamental frequency, or pitch, for
   each frame of the input sound
 - `aubiomfcc` computes Mel-frequency Cepstrum Coefficients
 - `aubiotrack` outputs the time stamp of detected beats
 - `aubionotes` emits midi-like notes, with an onset, a pitch, and a duration
 - `aubioquiet` extracts quiet and loud regions


  - [manual](, generated with sphinx
  - [developer documentation](, generated with Doxygen

The latest version of the documentation can be found at:

Build Instructions

aubio compiles on Linux, Mac OS X, Windows, Cygwin, and iOS.

To compile aubio, you should be able to simply run:


To compile the python module:

    ./ build

See the [manual]( for more information about
[installing aubio](


Please use the DOI link above to cite this release in your publications. For
more information, see also the [about
page]( in [aubio


The home page of this project can be found at:


aubio is free software: you can redistribute it and/or modify it under the
terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later


Patches are welcome: please fork the latest git repository and create a feature
branch. Submitted requests should pass all continuous integration tests.