source: README.md @ fb4ab89

feature/autosinkfeature/cnnfeature/cnn_orgfeature/constantqfeature/crepefeature/crepe_orgfeature/pitchshiftfeature/pydocstringsfeature/timestretchfix/ffmpeg5
Last change on this file since fb4ab89 was fb4ab89, checked in by Paul Brossier <piem@piem.org>, 6 years ago

README.md, doc/statuslinks.rst: use latest for commits-since

  • Property mode set to 100644
File size: 4.0 KB
RevLine 
[70ab9fe]1aubio
2=====
3
[d24b5c7]4[![Travis build status](https://travis-ci.org/aubio/aubio.svg?branch=master)](https://travis-ci.org/aubio/aubio "Travis build status")
[0eca01f]5[![Appveyor build status](https://img.shields.io/appveyor/ci/piem/aubio/master.svg)](https://ci.appveyor.com/project/piem/aubio "Appveyor build status")
[d24b5c7]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")
[fb4ab89]7[![Commits since last release](https://img.shields.io/github/commits-since/aubio/aubio/latest.svg)](https://github.com/aubio/aubio "Commits since last release")
[f4dbf64b]8
9[![Documentation](https://readthedocs.org/projects/aubio/badge/?version=latest)](http://aubio.readthedocs.io/en/latest/?badge=latest "Latest documentation")
[b678858]10[![DOI](https://zenodo.org/badge/396389.svg)](https://zenodo.org/badge/latestdoi/396389)
[050a8f3]11
12aubio is a library to label music and sounds. It listens to audio signals and
13attempts to detect events. For instance, when a drum is hit, at which frequency
14is a note, or at what tempo is a rhythmic melody.
15
16Its features include segmenting a sound file before each of its attacks,
17performing pitch detection, tapping the beat and producing midi streams from
18live audio.
19
20aubio provide several algorithms and routines, including:
21
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
27  - up/down-sampling
28  - digital filters (low pass, high pass, and more)
29  - spectral filtering
30  - transient/steady-state separation
[c3b1a7d]31  - sound file read and write access
[050a8f3]32  - various mathematics utilities for music applications
33
34The name aubio comes from _audio_ with a typo: some errors are likely to be
35found in the results.
36
[ac4a6b8]37Python module
38-------------
[050a8f3]39
[c2e2362]40A python module for aubio is provided. For more information on how to use it,
41please see the file [`python/README.md`](python/README.md) and the
42[manual](https://aubio.org/manual/latest/) .
[ac4a6b8]43
[ede63e3]44Tools
45-----
[050a8f3]46
[067d794]47The python module comes with the following command line tools:
48
49 - `aubio` extracts informations from sound files
50 - `aubiocut` slices sound files at onset or beat timestamps
51
52Additional command line tools are included along with the library:
[050a8f3]53
54 - `aubioonset` outputs the time stamp of detected note onsets
[ac4a6b8]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
[050a8f3]59 - `aubionotes` emits midi-like notes, with an onset, a pitch, and a duration
[ac4a6b8]60 - `aubioquiet` extracts quiet and loud regions
61
[ede63e3]62Documentation
63-------------
64
65  - [manual](https://aubio.org/manual/latest/), generated with sphinx
66  - [developer documentation](https://aubio.org/doc/latest/), generated with Doxygen
67
[ac4a6b8]68The latest version of the documentation can be found at:
69
[f4cc4a8]70  https://aubio.org/documentation
[050a8f3]71
[c35e701]72Build Instructions
73------------------
[050a8f3]74
[714ef0d]75aubio compiles on Linux, Mac OS X, Windows, Cygwin, and iOS.
[050a8f3]76
[4e2173e]77To compile aubio, you should be able to simply run:
[c35e701]78
[4e2173e]79    make
[c35e701]80
[4e2173e]81To compile the python module:
[c35e701]82
[4e2173e]83    ./setup.py build
[c35e701]84
[7a2666f]85See the [manual](https://aubio.org/manual/latest/) for more information about
86[installing aubio](https://aubio.org/manual/latest/installing.html).
[c35e701]87
[7a2666f]88Citation
89--------
[050a8f3]90
[f4dbf64b]91Please use the DOI link above to cite this release in your publications. For
92more information, see also the [about
93page](https://aubio.org/manual/latest/about.html) in [aubio
94manual](https://aubio.org/manual/latest/).
[050a8f3]95
[ede63e3]96Homepage
97--------
[050a8f3]98
[f4cc4a8]99The home page of this project can be found at: https://aubio.org/
[050a8f3]100
[ede63e3]101License
102-------
[050a8f3]103
104aubio is free software: you can redistribute it and/or modify it under the
105terms of the GNU General Public License as published by the Free Software
106Foundation, either version 3 of the License, or (at your option) any later
107version.
[ede63e3]108
109Contributing
110------------
111
112Patches are welcome: please fork the latest git repository and create a feature
113branch. Submitted requests should pass all continuous integration tests.
Note: See TracBrowser for help on using the repository browser.