Skip to main content

librosa logo

librosa

librosa is a Python library for audio and music signal processing. It provides the foundational algorithms and tools required for building music information retrieval (MIR) systems.

PyPI Anaconda-Server Badge License DOI EffVer Versioning Docs Scientific Python Ecosystem Coordination

CI codecov

Documentation

Full documentation is available at:

If you're new to librosa, we recommend starting with the tutorials.

If you're looking for API details, head directly to the API reference.

To see what's new, check out the change log.

Installation

Using PyPI

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

pip install librosa

Using conda

Anaconda users can install using conda-forge:

conda install -c conda-forge librosa

For optional dependencies and advanced setup, see the guide in the documentation.


Citing

There are two ways to cite librosa in scholarly work, depending on whether you are citing it for its use in your work or for its design and motivation.

We additionally encourage you to cite the original publications describing the methods implemented in librosa, in addition to citing librosa itself. References can often be found within function documentation.

Citing for use

If you are citing for use in your own work, please cite the version you used by retrieving the appropriate DOI and citation information from Zenodo.

DOI

This ensures that all contributing authors are credited for the work you are building on.

From librosa version 0.10.2 or later, you can also use librosa.cite() to get the DOI link for any version of librosa:

import librosa
librosa.cite()

And from 1.0 onward, you can directly retrieve the BibTeX entry for the version you are using:

print(librosa.cite(bib=True))

Citing for design

If you wish to cite librosa for its design, motivation, etc., please cite the paper published 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.

As a rule of thumb:

  • Use a versioned librosa citation to document the software implementation used in your experiments.
  • Cite the original methodological papers for the algorithms that are central to your work.
  • Cite the SciPy paper when discussing librosa itself, its design, or its contribution as a software library.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

librosa-1.0.0.tar.gz (378.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

librosa-1.0.0-py3-none-any.whl (294.6 kB view details)

Uploaded Python 3

File details

Details for the file librosa-1.0.0.tar.gz.

File metadata

  • Download URL: librosa-1.0.0.tar.gz
  • Upload date:
  • Size: 378.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for librosa-1.0.0.tar.gz
Algorithm Hash digest
SHA256 73ed480d4022e436e85dfa6f6b06ff38a259b9210039ac99939cd64854b61a57
MD5 2b66a0605d482ee178c9331144f4c8d9
BLAKE2b-256 8ec1ce66b20953b7370421dd13d22b4e04e401346c824ceacb9f4e722eec84dc

See more details on using hashes here.

Provenance

The following attestation bundles were made for librosa-1.0.0.tar.gz:

Publisher: publish.yml on librosa/librosa

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file librosa-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: librosa-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 294.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for librosa-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5910a6c0e1b2e494b92758c1615a7acbd0515a2315e138927ba2982f2af88857
MD5 4b2e28d92237f274993dcf91feca46fa
BLAKE2b-256 96140b2e4cc8017796dc8f69de740708601832c1e8d5377166eedb4db0a92264

See more details on using hashes here.

Provenance

The following attestation bundles were made for librosa-1.0.0-py3-none-any.whl:

Publisher: publish.yml on librosa/librosa

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page