Latest version
Close
Last released:
Python module for audio and music processing
Project description
Install build tools yum -y install autoconf automake libtool yum -y install pyparsing Build spice protocol cd spice-protocol./autogen.sh -prefix=/usr make make install cd.
A python package for music and audio analysis.
Documentation
See http://librosa.github.io/librosa/ for a complete reference manual and introductory tutorials.
Demonstration notebooks
What does librosa do? Here are some quick demonstrations:
- Introduction notebook: a brief introduction to some commonly used features.
- Decomposition and IPython integration: an intermediate demonstration, illustrating how to process and play back sound
Installation
The latest stable release is available on PyPI, and you can install it by saying
Anaconda users can install using
conda-forge
:To build librosa from source, say
python setup.py build
.Then, to install librosa, say python setup.py 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:or
By calling
pip list
you should see librosa
now as an installed package:Hints for the Installation
librosa
uses soundfile
and audioread
to load audio files.Note that soundfile
does not currently support MP3, which will cause librosa tofall back on the audioread
library.soundfile
If you're using
conda
to install librosa, then most audio coding dependencies (except MP3) will be handled automatically.If you're using
pip
on a Linux environment, you may need to install libsndfile
manually. Please refer to the SoundFile installation documentation for details.audioread and MP3 support
To fuel
audioread
with more audio-decoding power (e.g., for reading MP3 files),you may need to install either ffmpeg or GStreamer.Note that on some platforms,
audioread
needs at least one of the programs to work properly.If you are using Anaconda, install ffmpeg by calling
If you are not using Anaconda, here are some common commands for different operating systems:
- Linux (apt-get):
apt-get install ffmpeg
orapt-get install gstreamer1.0-plugins-base gstreamer1.0-plugins-ugly
- Linux (yum):
yum install ffmpeg
oryum install gstreamer1.0-plugins-base gstreamer1.0-plugins-ugly
- Mac:
brew install ffmpeg
orbrew install gstreamer
- Windows: download binaries from this website
For GStreamer, you also need to install the Python bindings with
Discussion
Please direct non-development questions and discussion topics to our web forum athttps://groups.google.com/forum/#!forum/librosa
Citing
If you want to cite librosa in a scholarly work, there are two ways to do it.
- If you are using the library for your work, for the sake of reproducibility, please citethe version you used as indexed at Zenodo:
- If you wish to cite librosa for its design, motivation etc., please cite the paperpublished at SciPy 2015:McFee, Brian, Colin Raffel, Dawen Liang, Daniel PW Ellis, Matt McVicar, Eric Battenberg, and Oriol Nieto. 'librosa: Audio and music signal analysis in python.' In Proceedings of the 14th python in science conference, pp. 18-25. 2015.
Release historyRelease notifications
0.7.1
0.7.0
0.7.0rc1 pre-release
0.6.3
0.6.2
0.6.1
0.6.1rc0 pre-release
0.6.0
0.6.0rc1 pre-release
0.6.0rc0 pre-release
0.5.1
0.5.0
0.5.0rc0 pre-release
0.4.3
0.4.3rc0 pre-release
0.4.2
0.4.1
0.4.1rc0 pre-release
0.4.0
0.4.0rc2 pre-release
0.4.0-pre pre-release
0.3.1
0.3.0
0.2.1
0.2.0
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Filename, size | File type | Python version | Upload date | Hashes |
---|---|---|---|---|
Filename, size librosa-0.7.1.tar.gz (1.6 MB) | File type Source | Python version None | Upload date | Hashes |
Hashes for librosa-0.7.1.tar.gz
Algorithm | Hash digest |
---|---|
SHA256 | cca58a2d9a47e35be63a3ce36482d241453bfe9b14bde2005430f969bd7d013a |
MD5 | 3827d0e8fd5c79ae2f2918624da73a68 |
BLAKE2-256 | 0b71c21ccef81276d85b9e3a36d80dad5baaf8a91f912e65eff0fd0d74a5a19c |