# librosa > Python module for audio and music processing - **URL**: https://www.freshcrate.ai/projects/librosa - **Author**: Brian McFee - **Category**: Frameworks - **Latest version**: `0.11.0` (2026-04-21) - **License**: ISC - **Source**: https://github.com/librosa/librosa/releases - **Homepage**: https://librosa.org - **Language**: Python - **GitHub**: 8,341 stars, 1,046 forks - **Registry**: pypi (`librosa`) - **Tags**: `pypi` ## Description [![librosa logo](docs/img/librosa_logo_text.svg)](https://librosa.org/) # librosa A python package for music and audio analysis. [![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) # Table of Contents - [Documentation](#Documentation) - [Installation](#Installation) - [Using PyPI](#using-pypi) - [Using Anaconda](#using-anaconda) - [Building From Source](#building-from-source) - [Hints for Installation](#hints-for-the-installation) - [`soundfile`](#soundfile) - [`audioread`](#audioread-and-mp3-support) - [Linux (`apt get`)](#linux-apt-get) - [Linux (`yum`)](#linux-yum) - [Mac](#mac) - [Windows](#windows) - [Discussion](#discussion) - [Citing](#citing) --- ## Documentation See https://librosa.org/doc/ for a complete reference manual and introductory tutorials. The [advanced example gallery](https://librosa.org/doc/latest/advanced.html) should give you a quick sense of the kinds of things that librosa can do. --- [Back To Top ↥](#librosa) ## Installation ### Using PyPI The latest stable release is available on PyPI, and you can install it by saying ``` python -m pip install librosa ``` ### Using Anaconda Anaconda users can install using ```conda-forge```: ``` conda install -c conda-forge librosa ``` ### Building from source 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 following commands from a python console: ``` import librosa librosa.show_versions() ``` This should print out a description of your software environment, along with the installed versions of other packages used by librosa. 📝 OS X users should follow the installation guide given below. Alternatively, you can download or clone the repository and use `pip` to handle dependencies: ``` unzip librosa.zip python -m pip install -e librosa ``` or ``` git clone https://github.com/librosa/librosa.git python -m pip install -e librosa ``` By calling `pip list` you should see `librosa` now as an installed package: ``` librosa (0.x.x, /path/to/librosa) ``` --- [Back To Top ↥](#librosa) ### Hints for the Installation `librosa` uses `soundfile` and `audioread` to load audio files. 📝 Note that older releases of `soundfile` (prior to 0.11) do not support MP3, which will cause librosa to fall back on the `audioread` library. ### `soundfile` If you're using `conda` to install librosa, then audio encoding dependencies 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](https://python-soundfile.readthedocs.io/#installation) 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 ``` 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 ffmpeg binaries from this [website](https://www.gyan.dev/ffmpeg/builds/) or gstreamer binaries from this [website](https://gstreamer.freedesktop.org/) For GStreamer, you also need to install the Python bindings with ``` python -m pip install pygobject ``` --- [Back To Top ↥](#librosa) ## Discussion Please direct non-development questions and discussion topics to our web forum at https://groups.google.com/forum/#!forum/librosa --- [Back To Top ↥](#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 wor ## Recent releases | Version | Date | Urgency | Changes | | --- | --- | --- | --- | | `0.11.0` | 2026-04-21 | Low | Imported from PyPI (0.11.0) | | `0.11.0rc1` | 2025-02-21 | Low | This is the second pre-release for version 0.11.0. ## Known issues Full python 3.13 support currently requires manually installing the following packages: - `standard-aifc` - `standard-sunau` With pip, this can be done by calling `python -m pip install standard-aifc standard-sunau`. This step is not required for python 3.12 or earlier. Windows users with python 3.13 environments may encounter problems with the optional `samplerate` backend package for sample rate conversion. O | | `0.11.0rc0` | 2025-02-11 | Low | This is a pre-release for version 0.11.0. ## Known issues Full python 3.13 support currently requires manually installing the following packages: - `standard-aifc` - `standard-sunau` With pip, this can be done by calling `python -m pip install standard-aifc standard-sunau`. This step is not required for python 3.12 or earlier. ## What's Changed * Bump minimum matplotlib to 3.5.0 by @bmcfee in https://github.com/librosa/librosa/pull/1839 * Fix name collision for norm argument | | `0.10.2.post1` | 2024-05-14 | Low | ## What's Changed * Bump minimum matplotlib to 3.5.0 by @bmcfee in https://github.com/librosa/librosa/pull/1839 **Full Changelog**: https://github.com/librosa/librosa/compare/0.10.2...0.10.2.post1 | | `0.10.2` | 2024-05-02 | Low | ## What's Changed * Multiple accidentals by @erabinov in https://github.com/librosa/librosa/pull/1739 * Avoid deprecated matplotlib functions by @bmcfee in https://github.com/librosa/librosa/pull/1755 * Mode support by @erabinov in https://github.com/librosa/librosa/pull/1756 * Mode support by @erabinov in https://github.com/librosa/librosa/pull/1762 * Switch from pkg_resources to importlib.resources by @mattpitkin in https://github.com/librosa/librosa/pull/1765 * Add python 3.11 to build | | `0.10.1` | 2023-08-16 | Low | This release consists primarily of corrections to documentation and updates to tests and development environment specifications. ## What's Changed * VQT octave boundaries by @bmcfee in https://github.com/librosa/librosa/pull/1677 * redoing 0.10.0.post1 release by @bmcfee in https://github.com/librosa/librosa/pull/1684 * Pin pooch < 1.7 by @bmcfee in https://github.com/librosa/librosa/pull/1686 * Post-release 2 for 0.10.0, pin pooch by @bmcfee in https://github.com/librosa/librosa/pull/168 | | `0.10.0.post2` | 2023-03-17 | Low | This maintenance release updates the dependency specifications to avoid an incompatibility with pooch >= 1.7.0. This restriction only affects loading of specific example files, and does not otherwise affect functionality of the library. | | `0.10.0.post1` | 2023-03-16 | Low | This maintenance release updates the dependency specifications to avoid an incompatibility with numpy versions 1.22.0, 1.22.1, and 1.22.2. Functionality is otherwise identical to librosa version 0.10.0. | | `0.10.0` | 2023-02-20 | Low | This release provides many speedups and enhancements to core operations, faster importing and loading, and full type annotations. A detailed changelog is provided below, and summarized at https://librosa.org/doc/main/changelog.html#v0-10-0 ## What's Changed * Square plots when different axis types are compatible by @kianelbo in https://github.com/librosa/librosa/pull/1501 * Add instructions for updating test_display images in CONTRIBUTING.md by @kianelbo in https://github.com/librosa/lib | | `0.10.0rc1` | 2023-02-17 | Low | Second release candidate for 0.10.0. This RC includes some minor documentation updates and incremented the minimum supported python-soundfile to 0.12.1. | ## Citation - HTML: https://www.freshcrate.ai/projects/librosa - Markdown: https://www.freshcrate.ai/projects/librosa.md - Dependencies JSON: https://www.freshcrate.ai/api/projects/librosa/deps _Generated by freshcrate.ai. Indexes pypi releases for AI-agent ecosystem packages._