Mercurial > hg > vamp-aubio-plugins
diff README.md @ 113:3aee7fc5c39c
README.md: rewrite readme
author | Paul Brossier <piem@piem.org> |
---|---|
date | Sat, 31 Jan 2015 17:35:07 +0100 |
parents | |
children | f1cda26b578c |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/README.md Sat Jan 31 17:35:07 2015 +0100 @@ -0,0 +1,93 @@ +vamp-aubio-plugins +================== + +A set of [Vamp plugins](http://vamp-plugins.org/) for audio feature extraction +using the [aubio library](http://aubio.org/). + +This set includes the following plugins: + + - Spectral Descriptors + + - Aubio Beat Tracker + - *Time → Tempo* + - Estimate the musical tempo and track beat positions. + - Aubio Mel-frequency Band Energy Detector + - *Low Level Features* + - Computes Energy in each Mel-Frequency Bands. + - Aubio Mfcc Detector + - *Low Level Features* + - Computes Mel-Frequency Cepstrum Coefficients. + - Aubio Note Tracker + - *Notes* + - Estimate note onset positions, pitches and durations. + - Aubio Onset Detector + - *Time → Onsets* + - Estimate note onset times. + - Aubio Pitch Detector + - *Pitch* + - Track estimated note pitches. + - Aubio Silence Detector + - *Low Level Features* + - Detect levels below a certain threshold. + - Aubio Spectral Descriptor + - *Low Level Features* + - Computes spectral descriptor. + +Build Instructions +------------------ + +Please refer to the detailed instructions to build vamp-aubio-plugins for your +platform in the following files: + + - `INSTALL.osx` for Mac OS X + - `INSTALL.linux64` for Linux amd64 + - `INSTALL.linux32` for Linux i686 + - `INSTALL.mingw32` to cross-compile using [Mingw](http://www.mingw.org/) + +You can try running the corresponding file directly from the current directory. +For instance, on a `Linux x86_64` host: + + $ sh INSTALL.osx + +### Linux + +Use Makefile.linux to compile vamp-aubio-plugins: + + $ make -f Makefile.linux clean all + +### Mac OS X + +Use Makefile.osx to compile vamp-aubio-plugins: + + $ make -f Makefile.linux clean all + +### Windows + +Use Makefile.mingw32 to compile vamp-aubio-plugins: + + $ make -f Makefile.mingw32 clean all + +Installation Instructions +------------------------- + +The Vamp plugin is defined by the following three files. Depending on your +platform, the extension of the binary file will vary. + + vamp-aubio.cat + vamp-aubio.n3 + vamp-aubio.{so,dll,dylib} + +Follow the [Vamp installation +instructions](http://vamp-plugins.org/download.html#install) to copy the +above three files to your preferred plugin directory. + +Copyright and License Information +--------------------------------- + + Copyright (C) 2006-2012 Chris Cannam and Queen Mary University of London + Copyright (C) 2006-2015 Paul Brossier <piem@aubio.org> + +vamp-aubio-plugins 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.