Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
docs mock imports Aug 15, 2017
medleydb fix bad version, update docs Aug 15, 2017
tests test for bad delimiters Jul 20, 2017
.gitignore add audio formats to gitignore May 27, 2015
.travis.yml update documentation Oct 15, 2016 add hack so librosa installs in travis Oct 15, 2016 update documentation Oct 15, 2016
LICENSE Initial commit Sep 8, 2014 Update Feb 16, 2017
setup.cfg remove import, fix top level files Jul 13, 2016


Annotations and Python tools for MedleyDB. Read the Docs here.

Documentation Status GitHub license PyPI

Build Status Coverage Status

Maintained by Rachel Bittner rachel (dot) bittner (at) nyu (dot) edu.

This code is released along with MedleyDB and is a component of the work presented in the following publications:

R. Bittner, J. Salamon, M. Tierney, M. Mauch, C. Cannam and J. P. Bello, "MedleyDB: A Multitrack Dataset for Annotation-Intensive MIR Research", in 15th International Society for Music Information Retrieval Conference, Taipei, Taiwan, Oct. 2014.

R. Bittner, J. Wilkins, H. Yip and J. P. Bello, "MedleyDB 2.0: New Data and a System for Sustainable Data Collection", in Proceedings of the 17th International Society for Music Information Retrieval Conference Late Breaking and Demo Papers, New York City, USA, Aug. 2016.

See Also


MedleyDB Manager


As of v1.2, this repository contains the most up to date version of the medleydb annotations. If you find any problems with an annotation, or would like to contribute annotations, please report an issue submit a pull request. :)


First clone this repository:

git clone

Install the package

cd medleydb
pip install .

Next, set the environment variable MEDLEYDB_PATH to the local path where the MedleyDB directory (or MedleyDB_sample) lives:

export MEDLEYDB_PATH="path/to/your/copy/of/MedleyDB"

To avoid doing this step every time, copy the line above to ~/.bash_profile or ~/.bashrc.


If you use homebrew, you can install sox by doing:

brew install sox  # install the binary
pip install sox  # install the python package

Known Issues

Known issues with the Audio and Metadata can be found here.