4 [![Travis build status](https://travis-ci.org/aubio/aubio.svg?branch=master)](https://travis-ci.org/aubio/aubio "Travis build status")
5 [![Appveyor build status](https://img.shields.io/appveyor/ci/piem/aubio/master.svg)](https://ci.appveyor.com/project/piem/aubio "Appveyor build status")
6 [![Landscape code health](https://landscape.io/github/aubio/aubio/master/landscape.svg?style=flat)](https://landscape.io/github/aubio/aubio/master "Landscape code health")
7 [![Commits since last release](https://img.shields.io/github/commits-since/aubio/aubio/0.4.4.svg)](https://github.com/aubio/aubio "Commits since last release")
9 [![Documentation](https://readthedocs.org/projects/aubio/badge/?version=latest)](http://aubio.readthedocs.io/en/latest/?badge=latest "Latest documentation")
10 [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.438682.svg)](https://doi.org/10.5281/zenodo.438682)
12 aubio is a library to label music and sounds. It listens to audio signals and
13 attempts to detect events. For instance, when a drum is hit, at which frequency
14 is a note, or at what tempo is a rhythmic melody.
16 Its features include segmenting a sound file before each of its attacks,
17 performing pitch detection, tapping the beat and producing midi streams from
20 aubio provide several algorithms and routines, including:
22 - several onset detection methods
23 - different pitch detection methods
24 - tempo tracking and beat detection
25 - MFCC (mel-frequency cepstrum coefficients)
26 - FFT and phase vocoder
28 - digital filters (low pass, high pass, and more)
30 - transient/steady-state separation
31 - sound file read and write access
32 - various mathematics utilities for music applications
34 The name aubio comes from _audio_ with a typo: some errors are likely to be
40 A python module for aubio is provided. For more information on how to use it,
41 please see the file [`python/README.md`](python/README.md) and the
42 [manual](https://aubio.org/manual/latest/) .
47 The python module comes with the following command line tools:
49 - `aubio` extracts informations from sound files
50 - `aubiocut` slices sound files at onset or beat timestamps
52 Additional command line tools are included along with the library:
54 - `aubioonset` outputs the time stamp of detected note onsets
55 - `aubiopitch` attempts to identify a fundamental frequency, or pitch, for
56 each frame of the input sound
57 - `aubiomfcc` computes Mel-frequency Cepstrum Coefficients
58 - `aubiotrack` outputs the time stamp of detected beats
59 - `aubionotes` emits midi-like notes, with an onset, a pitch, and a duration
60 - `aubioquiet` extracts quiet and loud regions
62 The latest version of the documentation can be found at:
64 https://aubio.org/documentation
69 aubio compiles on Linux, Mac OS X, Windows, Cygwin, and iOS.
71 To compile aubio, you should be able to simply run:
75 To compile the python module:
79 See the [manual](https://aubio.org/manual/latest/) for more information about
80 [installing aubio](https://aubio.org/manual/latest/installing.html).
85 Please use the DOI link above to cite this release in your publications. For
86 more information, see also the [about
87 page](https://aubio.org/manual/latest/about.html) in [aubio
88 manual](https://aubio.org/manual/latest/).
90 Contact Info and Mailing List
91 -----------------------------
93 The home page of this project can be found at: https://aubio.org/
95 Questions, comments, suggestions, and contributions are welcome. Use the
96 mailing list: <aubio-user@aubio.org>.
98 To subscribe to the list, use the mailman form:
99 https://lists.aubio.org/listinfo/aubio-user/
101 Alternatively, feel free to contact directly the author.
104 Copyright and License Information
105 ---------------------------------
107 Copyright (C) 2003-2017 Paul Brossier <piem@aubio.org>
109 aubio is free software: you can redistribute it and/or modify it under the
110 terms of the GNU General Public License as published by the Free Software
111 Foundation, either version 3 of the License, or (at your option) any later