Metadata-Version: 2.4
Name: librosa
Version: 1.0.0rc0
Summary: Python module for audio and music processing
Home-page: https://librosa.org
Author: Brian McFee, librosa development team
Author-email: brian.mcfee@nyu.edu
License: ISC
Project-URL: Documentation, https://librosa.org/doc
Project-URL: Download, https://github.com/librosa/librosa/releases
Project-URL: Source, https://github.com/librosa/librosa
Project-URL: Tracker, https://github.com/librosa/librosa/issues
Project-URL: Discussion forum, https://groups.google.com/g/librosa
Classifier: License :: OSI Approved :: ISC License (ISCL)
Classifier: Programming Language :: Python
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Topic :: Multimedia :: Sound/Audio :: Analysis
Classifier: Framework :: Matplotlib
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.12
Description-Content-Type: text/markdown; charset=UTF-8
License-File: LICENSE.md
Requires-Dist: numba>=0.61.0
Requires-Dist: numpy>=2.1.0
Requires-Dist: scipy>=1.15.0
Requires-Dist: scikit-learn>=1.6.0
Requires-Dist: joblib>=1.2
Requires-Dist: decorator>=5.2.1
Requires-Dist: soundfile>=0.12.1
Requires-Dist: pooch>=1.7
Requires-Dist: soxr>=1.0.0
Requires-Dist: lazy_loader>=0.3
Requires-Dist: msgpack>=1.0.5
Provides-Extra: docs
Requires-Dist: numpydoc>=1.8.0; extra == "docs"
Requires-Dist: sphinx!=1.3.1; extra == "docs"
Requires-Dist: matplotlib>=3.10.0; extra == "docs"
Requires-Dist: pydata-sphinx-theme>=0.18.0; extra == "docs"
Requires-Dist: sphinx-gallery>=0.7; extra == "docs"
Requires-Dist: sphinx-design>=0.7.0; extra == "docs"
Requires-Dist: mir_eval>=0.5; extra == "docs"
Requires-Dist: ipython>=7.0; extra == "docs"
Requires-Dist: sphinxcontrib-svg2pdfconverter; extra == "docs"
Requires-Dist: sphinxcontrib-googleanalytics>=0.4; extra == "docs"
Requires-Dist: presets; extra == "docs"
Requires-Dist: sphinx-copybutton>=0.5.2; extra == "docs"
Requires-Dist: myst-parser>=2.0; extra == "docs"
Requires-Dist: pandas>=2.0; extra == "docs"
Requires-Dist: umap-learn>=0.5.4; extra == "docs"
Provides-Extra: tests
Requires-Dist: matplotlib>=3.10.0; extra == "tests"
Requires-Dist: packaging>=23.2; extra == "tests"
Requires-Dist: pytest-mpl; extra == "tests"
Requires-Dist: pytest-cov; extra == "tests"
Requires-Dist: pytest; extra == "tests"
Requires-Dist: samplerate; extra == "tests"
Requires-Dist: resampy>=0.4.3; extra == "tests"
Requires-Dist: scipy-stubs; extra == "tests"
Requires-Dist: types-decorator; extra == "tests"
Provides-Extra: display
Requires-Dist: matplotlib>=3.10.0; extra == "display"
Dynamic: license-file

[![librosa logo](docs/img/librosa_logo_text.svg)](https://librosa.org/)

# 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](https://img.shields.io/pypi/v/librosa.svg)](https://pypi.python.org/pypi/librosa)
[![Anaconda-Server Badge](https://anaconda.org/conda-forge/librosa/badges/version.svg)](https://anaconda.org/conda-forge/librosa)
[![License](https://img.shields.io/pypi/l/librosa.svg)](https://github.com/librosa/librosa/blob/main/LICENSE.md)
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.591533.svg)](https://doi.org/10.5281/zenodo.591533)

[![CI](https://github.com/librosa/librosa/actions/workflows/ci.yml/badge.svg)](https://github.com/librosa/librosa/actions/workflows/ci.yml)
[![codecov](https://codecov.io/gh/librosa/librosa/branch/main/graph/badge.svg?token=ULWnUHaIJC)](https://codecov.io/gh/librosa/librosa)
[![Docs](https://github.com/librosa/librosa/actions/workflows/docs.yml/badge.svg)](https://librosa.org/doc/latest/index.html)
[![Scientific Python Ecosystem Coordination](https://img.shields.io/badge/SPEC-0,1,7-green?labelColor=%23004811&color=%235CA038)](https://scientific-python.org/specs/)

## Documentation

Full documentation is available at:

* https://librosa.org/doc/

If you're new to librosa, we recommend starting with the
[tutorials](https://librosa.org/doc/latest/auto_tutorials).

If you're looking for API details, head directly to the [API reference](https://librosa.org/doc/latest/api).

To see what's new, check out the [change log](https://librosa.org/doc/latest/changelog.html).

## 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](https://zenodo.org/badge/DOI/10.5281/zenodo.591533.svg)](https://doi.org/10.5281/zenodo.591533)

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:

```python
import librosa
librosa.cite()
```

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

```python
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.
