-aubio library
-=============
+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")
+[](https://github.com/aubio/aubio "Commits since last release")
+
+[](http://aubio.readthedocs.io/en/latest/?badge=latest "Latest documentation")
+[](https://zenodo.org/badge/latestdoi/396389)
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
- digital filters (low pass, high pass, and more)
- spectral filtering
- transient/steady-state separation
- - sound file and audio devices read and write access
+ - 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
+-------------
-Implementation and Design Basics
---------------------------------
-
-The library is written in C and is optimised for speed and portability. A
-python module to access the library functions is also provided. A few simple
-applications are included along with the library:
-
- - `aubioonset` outputs the time stamp of detected note onsets
- - `aubiotempo` does the same for the tempo
- - `aubionotes` emits midi-like notes, with an onset, a pitch, and a duration
- - `aubiocut` slices an input sound and cuts it in several smaller files, sliced
- at each detected onset or beat
- - `aubiopitch` attempts to identify a fundamental frequency, or pitch, for each
- frame of the input sound
-
-The C API is designed in the following way:
-
- aubio_something_t * new_aubio_something (void * args);
- audio_something_do (aubio_something_t * t, void * args);
- smpl_t aubio_something_get_a_parameter (aubio_something_t *t);
- uint_t aubio_something_set_a_parameter (aubio_something_t *t, smpl_t a_parameter);
- void del_aubio_something (aubio_something_t * t);
+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/) .
-For performance and real-time operation, no memory allocation or freeing take
-place in the `_do` methods. Instead, memory allocation should always take place
-in the `new_` methods, whereas free operations are done in the `del_` methods.
+Tools
+-----
+The python module comes with the following command line tools:
-Installation and Build Instructions
------------------------------------
+ - `aubio` extracts informations from sound files
+ - `aubiocut` slices sound files at onset or beat timestamps
-A number of distributions already include aubio. Check your favorite package
-management system, or have a look at the [download
-page](http://aubio.org/download).
+Additional command line tools are included along with the library:
-aubio uses [waf](https://code.google.com/p/waf/) to configure, compile, and
-test the source:
-
- ./waf configure
- ./waf build
- sudo ./waf install
-
-aubio compiles on Linux, Mac OS X, Cygwin, and iPhone.
-
-
-Credits and Publications
-------------------------
+ - `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
-This library gathers music signal processing algorithms designed at the Centre
-for Digital Music and elsewhere. This software project was developed along the
-research I did at the Centre for Digital Music, Queen Mary, University of
-London. Most of this C code was written by myself, starting from published
-papers and existing code. The header files of each algorithm contains brief
-descriptions and references to the corresponding papers.
+Documentation
+-------------
-Special thanks go Juan Pablo Bello, Chris Duxbury, Samer Abdallah, Alain de
-Cheveigne for their help and publications. Also many thanks to Miguel Ramirez
-and Nicolas Wack for their bug fixing.
+ - [manual](https://aubio.org/manual/latest/), generated with sphinx
+ - [developer documentation](https://aubio.org/doc/latest/), generated with Doxygen
-Substantial informations about the algorithms and their evaluation are gathered
-in:
+The latest version of the documentation can be found at:
- - Paul Brossier, _[Automatic annotation of musical audio for interactive
- systems](http://aubio.org/phd)_, PhD thesis, Centre for Digital music,
-Queen Mary University of London, London, UK, 2006.
+ https://aubio.org/documentation
-Additional results obtained with this software were discussed in the following
-papers:
+Build Instructions
+------------------
- - P. M. Brossier and J. P. Bello and M. D. Plumbley, [Real-time temporal
- segmentation of note objects in music signals](http://aubio.org/articles/brossier04fastnotes.pdf),
-in _Proceedings of the International Computer Music Conference_, 2004, Miami,
-Florida, ICMA
+aubio compiles on Linux, Mac OS X, Windows, Cygwin, and iOS.
- - P. M. Brossier and J. P. Bello and M. D. Plumbley, [Fast labelling of note
- objects in music signals] (http://aubio.org/articles/brossier04fastnotes.pdf),
-in _Proceedings of the International Symposium on Music Information Retrieval_,
-2004, Barcelona, Spain
+To compile aubio, you should be able to simply run:
+ make
-Contact Info and Mailing List
------------------------------
+To compile the python module:
-The home page of this project can be found at: http://aubio.org/
+ ./setup.py build
-Questions, comments, suggestions, and contributions are welcome. Use the
-mailing list: <aubio-user@aubio.org>.
+See the [manual](https://aubio.org/manual/latest/) for more information about
+[installing aubio](https://aubio.org/manual/latest/installing.html).
-To subscribe to the list, use the mailman form:
-http://lists.aubio.org/listinfo/aubio-user/
+Citation
+--------
-Alternatively, feel free to contact directly the author.
+Please use the DOI link above to cite this release in your publications. For
+more information, see also the [about
+page](https://aubio.org/manual/latest/about.html) in [aubio
+manual](https://aubio.org/manual/latest/).
+Homepage
+--------
-Copyright and License Information
----------------------------------
+The home page of this project can be found at: https://aubio.org/
-Copyright (C) 2003-2013 Paul Brossier <piem@aubio.org>
+License
+-------
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.
+
+Contributing
+------------
+
+Patches are welcome: please fork the latest git repository and create a feature
+branch. Submitted requests should pass all continuous integration tests.
projects / aubio.git / blobdiff