This module wraps the aubio library for Python using the numpy module.
After installing python-aubio, you will be able to import the aubio module:
$ python [...] >>> import aubio >>> help(aubio.miditofreq)
Some examples are available in the
python/demos directory. These scripts are
small programs written in python and using python-aubio.
demo_source.py reads a media file.
$ ./python/demos/demo_source.py /path/to/sound/sample.wav
demo_timestretch_online.py stretches the original file into a new one:
$ ./python/demo/demo_timestretch_online.py loop.wav stretched_loop.wav 0.92`
Python tests are in
python/tests and use the nose2 python package.
To run the all the python tests, use the script:
Each test script can also be called one at a time. For instance:
$ ./python/tests/test_note2midi.py -v
You should be able to install python-aubio directly from the top source directory of aubio.
First, create a virtualenv to hold the required python module:
$ virtualenv pyaubio $ source pyaubio/bin/activate
Now install and build the python extension using:
$ pip install .
Before compiling this module, you must have compiled libaubio.
A simple way to do this is with pip:
$ pip install -r requirements.txt
To build the aubio Python module, run the following command from the top source directory of aubio:
$ ./setup.py build
Note: if libaubio was previously built using waf, the script will use it. Otherwise, the entire library will be built inside the python extension.
To find out more about
$ ./setup.py --help
To install the Python module:
$ ./setup.py install
Alternatively, you may want to use the Python module without installing it by setting your PYTHONPATH, for instance as follows:
$ export PYTHONPATH=$PYTHONPATH:$PWD/`ls -rtd build/lib.* | head -1`:$PWD/tests