| 1 | aubio |
|---|
| 2 | ===== |
|---|
| 3 | |
|---|
| 4 | [](https://travis-ci.org/aubio/aubio "Travis build status") |
|---|
| 5 | [](https://ci.appveyor.com/project/piem/aubio "Appveyor build status") |
|---|
| 6 | [](https://landscape.io/github/aubio/aubio/master "Landscape code health") |
|---|
| 7 | [](http://aubio.readthedocs.io/en/latest/?badge=latest "Documentation status") |
|---|
| 8 | [](https://github.com/aubio/aubio "Commits since last release") |
|---|
| 9 | [](https://doi.org/10.5281/zenodo.438682) |
|---|
| 10 | |
|---|
| 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. |
|---|
| 14 | |
|---|
| 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 |
|---|
| 17 | live audio. |
|---|
| 18 | |
|---|
| 19 | aubio provide several algorithms and routines, including: |
|---|
| 20 | |
|---|
| 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 |
|---|
| 26 | - up/down-sampling |
|---|
| 27 | - digital filters (low pass, high pass, and more) |
|---|
| 28 | - spectral filtering |
|---|
| 29 | - transient/steady-state separation |
|---|
| 30 | - sound file read and write access |
|---|
| 31 | - various mathematics utilities for music applications |
|---|
| 32 | |
|---|
| 33 | The name aubio comes from _audio_ with a typo: some errors are likely to be |
|---|
| 34 | found in the results. |
|---|
| 35 | |
|---|
| 36 | Python module |
|---|
| 37 | ------------- |
|---|
| 38 | |
|---|
| 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/) . |
|---|
| 42 | |
|---|
| 43 | Examples tools |
|---|
| 44 | -------------- |
|---|
| 45 | |
|---|
| 46 | The python module comes with the following command line tools: |
|---|
| 47 | |
|---|
| 48 | - `aubio` extracts informations from sound files |
|---|
| 49 | - `aubiocut` slices sound files at onset or beat timestamps |
|---|
| 50 | |
|---|
| 51 | Additional command line tools are included along with the library: |
|---|
| 52 | |
|---|
| 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 |
|---|
| 60 | |
|---|
| 61 | The latest version of the documentation can be found at: |
|---|
| 62 | |
|---|
| 63 | https://aubio.org/documentation |
|---|
| 64 | |
|---|
| 65 | Build Instructions |
|---|
| 66 | ------------------ |
|---|
| 67 | |
|---|
| 68 | aubio compiles on Linux, Mac OS X, Windows, Cygwin, and iOS. |
|---|
| 69 | |
|---|
| 70 | To compile aubio, you should be able to simply run: |
|---|
| 71 | |
|---|
| 72 | make |
|---|
| 73 | |
|---|
| 74 | To compile the python module: |
|---|
| 75 | |
|---|
| 76 | ./setup.py build |
|---|
| 77 | |
|---|
| 78 | See the [manual](https://aubio.org/manual/latest/) for more information about |
|---|
| 79 | [installing aubio](https://aubio.org/manual/latest/installing.html). |
|---|
| 80 | |
|---|
| 81 | Citation |
|---|
| 82 | -------- |
|---|
| 83 | |
|---|
| 84 | Please refer to the following link to cite this software in your publication: |
|---|
| 85 | [](https://doi.org/10.5281/zenodo.438682) |
|---|
| 86 | |
|---|
| 87 | Contact Info and Mailing List |
|---|
| 88 | ----------------------------- |
|---|
| 89 | |
|---|
| 90 | The home page of this project can be found at: https://aubio.org/ |
|---|
| 91 | |
|---|
| 92 | Questions, comments, suggestions, and contributions are welcome. Use the |
|---|
| 93 | mailing list: <aubio-user@aubio.org>. |
|---|
| 94 | |
|---|
| 95 | To subscribe to the list, use the mailman form: |
|---|
| 96 | https://lists.aubio.org/listinfo/aubio-user/ |
|---|
| 97 | |
|---|
| 98 | Alternatively, feel free to contact directly the author. |
|---|
| 99 | |
|---|
| 100 | |
|---|
| 101 | Copyright and License Information |
|---|
| 102 | --------------------------------- |
|---|
| 103 | |
|---|
| 104 | Copyright (C) 2003-2016 Paul Brossier <piem@aubio.org> |
|---|
| 105 | |
|---|
| 106 | aubio is free software: you can redistribute it and/or modify it under the |
|---|
| 107 | terms of the GNU General Public License as published by the Free Software |
|---|
| 108 | Foundation, either version 3 of the License, or (at your option) any later |
|---|
| 109 | version. |
|---|
