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 [![Documentation Status](https://readthedocs.org/projects/aubio/badge/?version=latest)](http://aubio.readthedocs.io/en/latest/?badge=latest "Documentation status")
8 [![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 [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.438682.svg)](https://doi.org/10.5281/zenodo.438682)
11 aubio is a library to label music and sounds. It listens to audio signals and
12 attempts to detect events. For instance, when a drum is hit, at which frequency
13 is a note, or at what tempo is a rhythmic melody.
15 Its features include segmenting a sound file before each of its attacks,
16 performing pitch detection, tapping the beat and producing midi streams from
19 aubio provide several algorithms and routines, including:
21 - several onset detection methods
22 - different pitch detection methods
23 - tempo tracking and beat detection
24 - MFCC (mel-frequency cepstrum coefficients)
25 - FFT and phase vocoder
27 - digital filters (low pass, high pass, and more)
29 - transient/steady-state separation
30 - sound file read and write access
31 - various mathematics utilities for music applications
33 The name aubio comes from _audio_ with a typo: some errors are likely to be
39 A python module for aubio is provided. For more information on how to use it,
40 please see the file [`python/README.md`](python/README.md) and the
41 [manual](https://aubio.org/manual/latest/) .
46 The python module comes with the following command line tools:
48 - `aubio` extracts informations from sound files
49 - `aubiocut` slices sound files at onset or beat timestamps
51 Additional command line tools are included along with the library:
53 - `aubioonset` outputs the time stamp of detected note onsets
54 - `aubiopitch` attempts to identify a fundamental frequency, or pitch, for
55 each frame of the input sound
56 - `aubiomfcc` computes Mel-frequency Cepstrum Coefficients
57 - `aubiotrack` outputs the time stamp of detected beats
58 - `aubionotes` emits midi-like notes, with an onset, a pitch, and a duration
59 - `aubioquiet` extracts quiet and loud regions
61 The latest version of the documentation can be found at:
63 https://aubio.org/documentation
68 aubio compiles on Linux, Mac OS X, Windows, Cygwin, and iOS.
70 To compile aubio, you should be able to simply run:
74 To compile the python module:
78 See also the [manual](https://aubio.org/manual/latest/) for more information
79 about [installing aubio](https://aubio.org/manual/latest/installing.html).
81 Credits and Publications
82 ------------------------
84 This library gathers music signal processing algorithms designed at the Centre
85 for Digital Music and elsewhere. This software project was developed along the
86 research I did at the Centre for Digital Music, Queen Mary, University of
87 London. Most of this C code was written by myself, starting from published
88 papers and existing code. The header files of each algorithm contains brief
89 descriptions and references to the corresponding papers.
91 Special thanks go Juan Pablo Bello, Chris Duxbury, Samer Abdallah, Alain de
92 Cheveigne for their help and publications. Also many thanks to Miguel Ramirez
93 and Nicolas Wack for their bug fixing.
95 Substantial informations about the algorithms and their evaluation are gathered
98 - Paul Brossier, _[Automatic annotation of musical audio for interactive
99 systems](https://aubio.org/phd)_, PhD thesis, Centre for Digital music,
100 Queen Mary University of London, London, UK, 2006.
102 Additional results obtained with this software were discussed in the following
105 - P. M. Brossier and J. P. Bello and M. D. Plumbley, [Real-time temporal
106 segmentation of note objects in music signals](https://aubio.org/articles/brossier04fastnotes.pdf),
107 in _Proceedings of the International Computer Music Conference_, 2004, Miami,
110 - P. M. Brossier and J. P. Bello and M. D. Plumbley, [Fast labelling of note
111 objects in music signals] (https://aubio.org/articles/brossier04fastnotes.pdf),
112 in _Proceedings of the International Symposium on Music Information Retrieval_,
113 2004, Barcelona, Spain
116 Contact Info and Mailing List
117 -----------------------------
119 The home page of this project can be found at: https://aubio.org/
121 Questions, comments, suggestions, and contributions are welcome. Use the
122 mailing list: <aubio-user@aubio.org>.
124 To subscribe to the list, use the mailman form:
125 https://lists.aubio.org/listinfo/aubio-user/
127 Alternatively, feel free to contact directly the author.
130 Copyright and License Information
131 ---------------------------------
133 Copyright (C) 2003-2016 Paul Brossier <piem@aubio.org>
135 aubio is free software: you can redistribute it and/or modify it under the
136 terms of the GNU General Public License as published by the Free Software
137 Foundation, either version 3 of the License, or (at your option) any later