Python library for audio and music analysis
Python Matlab Shell
Latest commit f47fb11 Feb 17, 2017 @bmcfee bmcfee pushing new doi badge


A python package for music and audio analysis.

PyPI Anaconda-Server Badge License DOI

Build Status Coverage Status Dependency Status

Linux OSX Windows


See for a complete reference manual and introductory tutorials.

Demonstration notebooks

What does librosa do? Here are some quick demonstrations:


The latest stable release is available on PyPI, and you can install it by saying

pip install librosa

Anaconda users can install using conda-forge:

conda install -c conda-forge librosa

To build librosa from source, say python build. Then, to install librosa, say python install. If all went well, you should be able to execute the demo scripts under examples/ (OS X users should follow the installation guide given below).

Alternatively, you can download or clone the repository and use pip to handle dependencies:

pip install -e librosa


git clone
pip install -e librosa

By calling pip list you should see librosa now as an installed pacakge:

librosa (0.x.x, /path/to/librosa)

Hints for the Installation


Note that audioread needs at least one of the programs to work properly.

librosa uses audioread to load audio files.

To fuel audioread with more audio-decoding power (e. g. for reading MP3 files), you can either install ffmpeg or GStreamer.

If you are using Anaconda, install ffmpeg by calling

conda install -c conda-forge ffmpeg

If you are not using Anaconda, here are some common commands for different operating systems:

  • Linux (apt-get): apt-get install ffmpeg or apt-get install gstreamer1.0-plugins-base gstreamer1.0-plugins-ugly
  • Linux (yum): yum install ffmpeg or yum install gstreamer1.0-plugins-base gstreamer1.0-plugins-ugly
  • Mac: brew install ffmpeg or brew install gstreamer
  • Windows: download binaries from the website

For GStreamer, you also need to install the Python bindings with

pip install pygobject


Please direct non-development questions and discussion topics to our web forum at!forum/librosa


Please refer to the Zenodo link below for citation information. DOI