Skip to content

marl/medleydb

Repository files navigation

medleydb

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

MedleyDeBugger

MedleyDB Manager

Annotations

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. :)

Setup

First clone this repository:

git clone https://github.com/marl/medleydb.git

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.

Dependencies

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.