{"id":13396946,"url":"https://github.com/librosa/librosa","last_synced_at":"2025-05-12T13:04:57.619Z","repository":{"id":5142925,"uuid":"6309729","full_name":"librosa/librosa","owner":"librosa","description":"Python library for audio and music analysis","archived":false,"fork":false,"pushed_at":"2025-04-21T13:57:14.000Z","size":33696,"stargazers_count":7593,"open_issues_count":64,"forks_count":984,"subscribers_count":136,"default_branch":"main","last_synced_at":"2025-05-03T10:55:28.654Z","etag":null,"topics":["audio","dsp","librosa","music","python","scipy"],"latest_commit_sha":null,"homepage":"https://librosa.org/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"Shopify/dashing","license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/librosa.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.md","dei":null,"publiccode":null,"codemeta":null,"zenodo":".zenodo.json"}},"created_at":"2012-10-20T14:21:01.000Z","updated_at":"2025-05-02T14:16:54.000Z","dependencies_parsed_at":"2023-10-24T15:41:11.646Z","dependency_job_id":"c9f77cef-7ac1-4691-98b8-d09b25e393fc","html_url":"https://github.com/librosa/librosa","commit_stats":{"total_commits":2898,"total_committers":133,"mean_commits":"21.789473684210527","dds":"0.48895790200138023","last_synced_commit":"460c3352f55affe3409f817f57e0368c9a9af3c8"},"previous_names":[],"tags_count":46,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/librosa%2Flibrosa","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/librosa%2Flibrosa/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/librosa%2Flibrosa/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/librosa%2Flibrosa/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/librosa","download_url":"https://codeload.github.com/librosa/librosa/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252332927,"owners_count":21731106,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["audio","dsp","librosa","music","python","scipy"],"created_at":"2024-07-30T18:01:08.255Z","updated_at":"2025-05-04T12:27:53.779Z","avatar_url":"https://github.com/librosa.png","language":"Python","funding_links":[],"categories":["Audio","Python","Software","资源列表","Libraries","Analysis \u0026 Feature Extraction","Computer Audition","音频","音频处理","Open source projects","Data Processing","HarmonyOS","Tooling \u0026 Infrastructure","Audio [🔝](#readme)","Music Analysis \u0026 MIR","Audio Libraries","📚 فهرست","Feature Extraction","Music"],"sub_categories":["Audio feature extraction","音频","Audio Processing","Data Transformation and Manipulation","Others","Data Pre-processing \u0026 Loading","Windows Manager","Frameworks \u0026 SDKs","Drone Frames","NLP","کار با فایل های صوتی","Audio"],"readme":"[![librosa logo](docs/img/librosa_logo_text.svg)](https://librosa.org/)\n\n# librosa\n\n\nA python package for music and audio analysis.  \n\n[![PyPI](https://img.shields.io/pypi/v/librosa.svg)](https://pypi.python.org/pypi/librosa)\n[![Anaconda-Server Badge](https://anaconda.org/conda-forge/librosa/badges/version.svg)](https://anaconda.org/conda-forge/librosa)\n[![License](https://img.shields.io/pypi/l/librosa.svg)](https://github.com/librosa/librosa/blob/main/LICENSE.md)\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.591533.svg)](https://doi.org/10.5281/zenodo.591533)\n\n[![CI](https://github.com/librosa/librosa/actions/workflows/ci.yml/badge.svg)](https://github.com/librosa/librosa/actions/workflows/ci.yml)\n[![codecov](https://codecov.io/gh/librosa/librosa/branch/main/graph/badge.svg?token=ULWnUHaIJC)](https://codecov.io/gh/librosa/librosa)\n[![Docs](https://github.com/librosa/librosa/actions/workflows/docs.yml/badge.svg)](https://librosa.org/doc/latest/index.html)\n\n#  Table of Contents\n\n- [Documentation](#Documentation)\n- [Installation](#Installation)\n  - [Using PyPI](#using-pypi)\n  - [Using Anaconda](#using-anaconda)\n  - [Building From Source](#building-from-source)\n  - [Hints for Installation](#hints-for-the-installation)\n    - [`soundfile`](#soundfile)\n    - [`audioread`](#audioread-and-mp3-support)\n      - [Linux (`apt get`)](#linux-apt-get)\n      - [Linux (`yum`)](#linux-yum)\n      - [Mac](#mac)\n      - [Windows](#windows)\n- [Discussion](#discussion)\n- [Citing](#citing)\n\n---\n\n## Documentation\n\n\nSee https://librosa.org/doc/ for a complete reference manual and introductory tutorials.\n\nThe [advanced example gallery](https://librosa.org/doc/latest/advanced.html) should give you a quick sense of the kinds\nof things that librosa can do.\n\n---\n\n[Back To Top ↥](#librosa)\n\n\n## Installation\n\n\n### Using PyPI\n\nThe latest stable release is available on PyPI, and you can install it by saying\n```\npython -m pip install librosa\n```\n\n### Using Anaconda\n\nAnaconda users can install using ```conda-forge```:\n```\nconda install -c conda-forge librosa\n```\n\n### Building from source\n\nTo build librosa from source, say \n```\npython setup.py build\n```\nThen, to install librosa, say \n```\npython setup.py install\n```\nIf all went well, you should be able to execute the following commands from a python console:\n```\nimport librosa\nlibrosa.show_versions()\n```\nThis should print out a description of your software environment, along with the installed versions of other packages used by librosa.\n\n📝 OS X users should follow the installation guide given below.\n\nAlternatively, you can download or clone the repository and use `pip` to handle dependencies:\n\n```\nunzip librosa.zip\npython -m pip install -e librosa\n```\nor\n\n```\ngit clone https://github.com/librosa/librosa.git\npython -m pip install -e librosa\n```\n\nBy calling `pip list` you should see `librosa` now as an installed package:\n```\nlibrosa (0.x.x, /path/to/librosa)\n```\n\n---\n\n[Back To Top ↥](#librosa)\n\n### Hints for the Installation\n\n`librosa` uses `soundfile` and `audioread` to load audio files.\n\n📝 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.\n\n### `soundfile`\n\nIf you're using `conda` to install librosa, then audio encoding dependencies will be handled automatically.\n\nIf you're using `pip` on a Linux environment, you may need to install `libsndfile`\nmanually.  Please refer to the [SoundFile installation documentation](https://python-soundfile.readthedocs.io/#installation) for details.\n\n### `audioread` and MP3 support\n\nTo fuel `audioread` with more audio-decoding power (e.g., for reading MP3 files),\nyou may need to install either *ffmpeg* or *GStreamer*.\n\n📝*Note that on some platforms, `audioread` needs at least one of the programs to work properly.*\n\nIf you are using Anaconda, install *ffmpeg* by calling\n\n```\nconda install -c conda-forge ffmpeg\n```\n\nIf you are not using Anaconda, here are some common commands for different operating systems:\n\n- ####  Linux (`apt-get`): \n\n```\napt-get install ffmpeg\n```\nor\n \n```\napt-get install gstreamer1.0-plugins-base gstreamer1.0-plugins-ugly\n```\n- #### Linux (`yum`):\n```\nyum install ffmpeg\n```\nor\n\n\n```\nyum install gstreamer1.0-plugins-base gstreamer1.0-plugins-ugly\n```\n\n- #### Mac: \n```\nbrew install ffmpeg\n```\nor\n\n```\nbrew install gstreamer\n```\n\n- #### Windows: \n\ndownload ffmpeg binaries from this [website](https://www.gyan.dev/ffmpeg/builds/) or gstreamer binaries from this [website](https://gstreamer.freedesktop.org/)\n\nFor GStreamer, you also need to install the Python bindings with \n\n```\npython -m pip install pygobject\n```\n\n---\n\n[Back To Top ↥](#librosa)\n\n## Discussion\n\n\nPlease direct non-development questions and discussion topics to our web forum at\nhttps://groups.google.com/forum/#!forum/librosa\n\n---\n\n[Back To Top ↥](#librosa)\n\n## Citing\n\n\nIf you want to cite librosa in a scholarly work, there are two ways to do it.\n\n- If you are using the library for your work, for the sake of reproducibility, please cite\n  the version you used as indexed at Zenodo:\n\n    [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.591533.svg)](https://doi.org/10.5281/zenodo.591533)\n\n  From librosa version 0.10.2 or later, you can also use `librosa.cite()`\n  to get the DOI link for any version of librosa.\n\n- If you wish to cite librosa for its design, motivation, etc., please cite the paper\n  published at SciPy 2015:\n\n    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.\n\n---\n\n[Back To Top ↥](#librosa)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flibrosa%2Flibrosa","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flibrosa%2Flibrosa","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flibrosa%2Flibrosa/lists"}