ref: 7a2666f1213f55dc8fb22e086eddc2d8771a8f06
dir: /README.md/
aubio
=====
[](https://travis-ci.org/aubio/aubio "Travis build status")
[](https://ci.appveyor.com/project/piem/aubio "Appveyor build status")
[](https://landscape.io/github/aubio/aubio/master "Landscape code health")
[](http://aubio.readthedocs.io/en/latest/?badge=latest "Documentation status")
[](https://github.com/aubio/aubio "Commits since last release")
[](https://doi.org/10.5281/zenodo.438682)
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/README.md`](python/README.md) and the
[manual](https://aubio.org/manual/latest/) .
Examples tools
--------------
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
The latest version of the documentation can be found at:
https://aubio.org/documentation
Build Instructions
------------------
aubio compiles on Linux, Mac OS X, Windows, Cygwin, and iOS.
To compile aubio, you should be able to simply run:
make
To compile the python module:
./setup.py build
See the [manual](https://aubio.org/manual/latest/) for more information about
[installing aubio](https://aubio.org/manual/latest/installing.html).
Citation
--------
Please refer to the following link to cite this software in your publication:
[](https://doi.org/10.5281/zenodo.438682)
Contact Info and Mailing List
-----------------------------
The home page of this project can be found at: https://aubio.org/
Questions, comments, suggestions, and contributions are welcome. Use the
mailing list: <aubio-user@aubio.org>.
To subscribe to the list, use the mailman form:
https://lists.aubio.org/listinfo/aubio-user/
Alternatively, feel free to contact directly the author.
Copyright and License Information
---------------------------------
Copyright (C) 2003-2016 Paul Brossier <piem@aubio.org>
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
version.