librosa

Python library for audio and music analysis

https://github.com/librosa/librosa

Science Score: 59.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 6 DOI reference(s) in README
  • Academic publication links
    Links to: zenodo.org
  • Committers with academic emails
    13 of 126 committers (10.3%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (17.3%) to scientific vocabulary

Keywords

audio dsp librosa music python scipy

Keywords from Contributors

deep-neural-networks distributed tensor optimizing-compiler urban-sound environmental-sound bioacoustics transpiler gbdt gbm
Last synced: 6 months ago · JSON representation

Repository

Python library for audio and music analysis

Basic Info
  • Host: GitHub
  • Owner: librosa
  • License: isc
  • Language: Python
  • Default Branch: main
  • Homepage: https://librosa.org/
  • Size: 36.7 MB
Statistics
  • Stars: 7,826
  • Watchers: 135
  • Forks: 1,000
  • Open Issues: 66
  • Releases: 46
Topics
audio dsp librosa music python scipy
Created over 13 years ago · Last pushed 6 months ago
Metadata Files
Readme Contributing License Code of conduct Authors Zenodo

README.md

librosa logo

librosa

A python package for music and audio analysis.

PyPI Anaconda-Server Badge License DOI

CI codecov Docs

Table of Contents


Documentation

See https://librosa.org/doc/ for a complete reference manual and introductory tutorials.

The advanced example gallery should give you a quick sense of the kinds of things that librosa can do.


Back To Top ↥

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 ↥

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 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 or gstreamer binaries from this website

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

python -m pip install pygobject


Back To Top ↥

Discussion

Please direct non-development questions and discussion topics to our web forum at https://groups.google.com/forum/#!forum/librosa


Back To Top ↥

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 cite the version you used as indexed at Zenodo:

    DOI

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

  • 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.


Back To Top ↥

Owner

  • Name: librosa
  • Login: librosa
  • Kind: organization

Python tools for music and audio analysis

Committers

Last synced: 9 months ago

All Time
  • Total Commits: 2,914
  • Total Committers: 126
  • Avg Commits per committer: 23.127
  • Development Distribution Score (DDS): 0.213
Past Year
  • Commits: 26
  • Committers: 7
  • Avg Commits per committer: 3.714
  • Development Distribution Score (DDS): 0.269
Top Committers
Name Email Commits
Brian McFee b****e@n****u 2,293
Vincent Lostanlen v****n@g****m 62
mattmcvicar m****r@h****m 38
Alexandros Metsai a****i@g****m 38
Stefan Balke s****e@a****e 34
Carl Thomé c****e@g****m 33
Eric Battenberg e****g@g****m 28
Frank Zalkow f****w@a****e 19
Vincent Lostanlen v****n@n****u 18
SuperKogito k****o@h****r 18
Colin Raffel c****l@g****m 17
Rachel Bittner r****r@s****m 17
danagilliann d****6@g****m 14
Uri Nieto o****o@g****m 13
kyungyunlee k****3@g****m 11
Jack Mason j****2@g****m 11
Bryce b****n@u****) 11
Dawen Liang d****1@c****u 11
Dan Ellis d****e@e****u 10
Eric Battenberg e****g@g****m 10
scjs s****2@o****u 10
Ryuichi YAMAMOTO z****i@g****m 10
Viktor Andreevich Morozov v****v@g****m 8
jmoore j****h@g****m 7
Rachel Bittner r****r@n****u 6
Keunwoo Choi g****b@g****m 6
Shunsuke Hidaka g****c@g****m 6
Ziyao Wei z****y@g****m 6
nullmightybofo n****o 5
Dawen Liang d****l@D****l 4
and 96 more...

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 243
  • Total pull requests: 153
  • Average time to close issues: 3 months
  • Average time to close pull requests: 26 days
  • Total issue authors: 163
  • Total pull request authors: 40
  • Average comments per issue: 4.61
  • Average comments per pull request: 3.35
  • Merged pull requests: 113
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 48
  • Pull requests: 62
  • Average time to close issues: 14 days
  • Average time to close pull requests: 22 days
  • Issue authors: 30
  • Pull request authors: 12
  • Average comments per issue: 1.81
  • Average comments per pull request: 2.03
  • Merged pull requests: 38
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • bmcfee (60)
  • lostanlen (6)
  • stefan-balke (3)
  • davies-w (3)
  • Nilsonfsilva (2)
  • mcepl (2)
  • DUOLabs333 (2)
  • th0ger (2)
  • arothenberg2 (2)
  • mathpopo (2)
  • drscotthawley (2)
  • thewh1teagle (2)
  • brucenielson (1)
  • JuvenileLocksmith (1)
  • yl8414 (1)
Pull Request Authors
  • bmcfee (114)
  • hunterhogan (6)
  • dana-gill (4)
  • dsuedholt (4)
  • erabinov (4)
  • BenedictSt (2)
  • shihkuanglee (2)
  • rishabh11336 (2)
  • alumkal (2)
  • orkunkinay (2)
  • kyaryunha (2)
  • dhunstack (2)
  • scottvr (2)
  • twoertwein (2)
  • ssslakter (2)
Top Labels
Issue Labels
question (49) discussion (28) Upstream/dependency bug (25) documentation (25) enhancement (23) management (19) functionality (16) API change (14) wontfix (14) bug (13) testing (11) already fixed (11) display (10) good for beginners (9) music theory (5) off topic (4) blocked (3) IO (3)
Pull Request Labels
documentation (52) management (50) enhancement (50) testing (29) functionality (15) bug (13) API change (12) display (9) Upstream/dependency bug (4) music theory (4) blocked (2)

Packages

  • Total packages: 5
  • Total downloads:
    • pypi 4,704,746 last-month
  • Total docker downloads: 1,246,651
  • Total dependent packages: 488
    (may contain duplicates)
  • Total dependent repositories: 8,706
    (may contain duplicates)
  • Total versions: 72
  • Total maintainers: 3
pypi.org: librosa

Python module for audio and music processing

  • Versions: 45
  • Dependent Packages: 482
  • Dependent Repositories: 8,642
  • Downloads: 4,704,710 Last month
  • Docker Downloads: 1,246,651
Rankings
Dependent packages count: 0.1%
Dependent repos count: 0.1%
Downloads: 0.2%
Stargazers count: 0.4%
Average: 0.5%
Docker downloads count: 0.9%
Forks count: 1.3%
Maintainers (1)
Last synced: 6 months ago
proxy.golang.org: github.com/librosa/librosa
  • Versions: 6
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Stargazers count: 0.7%
Forks count: 0.8%
Average: 4.5%
Dependent packages count: 7.0%
Dependent repos count: 9.3%
Last synced: 6 months ago
conda-forge.org: librosa
  • Versions: 18
  • Dependent Packages: 6
  • Dependent Repositories: 64
Rankings
Dependent repos count: 4.4%
Stargazers count: 4.6%
Forks count: 5.2%
Average: 5.8%
Dependent packages count: 9.0%
Last synced: 6 months ago
spack.io: py-librosa

A python package for music and audio analysis.

  • Versions: 2
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 0.0%
Stargazers count: 1.8%
Forks count: 2.9%
Average: 15.5%
Dependent packages count: 57.3%
Maintainers (1)
Last synced: 6 months ago
pypi.org: vflibrosa

Python module for audio and music processing

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 36 Last month
Rankings
Stargazers count: 0.4%
Forks count: 1.3%
Dependent packages count: 10.0%
Average: 19.8%
Dependent repos count: 67.6%
Maintainers (1)
Last synced: about 1 year ago

Dependencies

.github/workflows/ci.yml actions
  • actions/cache v3 composite
  • actions/checkout v3 composite
  • codecov/codecov-action v3 composite
  • conda-incubator/setup-miniconda v2 composite
.github/workflows/docs.yml actions
  • actions/cache v3 composite
  • actions/checkout v3 composite
  • conda-incubator/setup-miniconda v2 composite
  • tagus/git-deploy v0.4.1 composite
.github/workflows/lint_python.yml actions
  • actions/cache v3 composite
  • actions/checkout v3 composite
  • conda-incubator/setup-miniconda v2 composite
.github/workflows/publish.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
  • pypa/gh-action-pypi-publish master composite
.github/workflows/docs-ci.yml actions
  • actions/cache v3 composite
  • actions/checkout v3 composite
  • conda-incubator/setup-miniconda v2 composite
pyproject.toml pypi
setup.py pypi