音频和音乐处理Python模块
项目描述
librosa
音乐和音频分析的Python包。
目录
文档
有关完整参考手册和入门教程，请参阅https://librosa.org/doc/。
高级示例画廊应能快速了解librosa能做什么。
安装
使用PyPI
最新稳定版本可在PyPI上找到，您可以通过以下命令安装它
python -m pip install librosa
使用Anaconda
Anaconda用户可以使用conda-forge安装
conda install -c conda-forge librosa
从源代码构建
要从源代码构建librosa，请说
python setup.py build
然后，要安装librosa，请说
python setup.py install
如果一切顺利，您应该能够从Python控制台执行以下命令
import librosa
librosa.show_versions()
这将打印出您的软件环境描述，以及librosa使用的其他包的安装版本。
📝 OS X用户应遵循下面的安装指南。
或者，您可以下载或克隆仓库，并使用pip来处理依赖项
unzip librosa.zip
python -m pip install -e librosa
或者
git clone https://github.com/librosa/librosa.git
python -m pip install -e librosa
通过调用pip list，您应该能看到librosa现在作为一个已安装的包
librosa (0.x.x, /path/to/librosa)
安装提示
librosa使用soundfile和audioread来加载音频文件。
📝 注意，soundfile的旧版本（0.11之前）不支持MP3，这会导致librosa回退到audioread库。
soundfile
如果您使用conda安装librosa，那么音频编码依赖项将被自动处理。
如果您在Linux环境下使用pip，您可能需要手动安装libsndfile。请参阅SoundFile安装文档获取详细信息。
audioread和MP3支持
为了给audioread提供更多的音频解码能力（例如，读取MP3文件），您可能需要安装ffmpeg或GStreamer。
📝请注意，在某些平台上，audioread至少需要一个程序才能正常工作。
如果您使用Anaconda，可以通过调用
conda install -c conda-forge ffmpeg
如果您不使用Anaconda，以下是一些不同操作系统的常用命令
-
Linux（《apt-get》）
apt-get install ffmpeg
或者
apt-get install gstreamer1.0-plugins-base gstreamer1.0-plugins-ugly
-
Linux (
yum)
yum install ffmpeg
或者
yum install gstreamer1.0-plugins-base gstreamer1.0-plugins-ugly
-
Mac
brew install ffmpeg
或者
brew install gstreamer
-
Windows
从此网站下载ffmpeg二进制文件或从此网站下载gstreamer二进制文件
对于GStreamer，您还需要安装Python绑定，使用
python -m pip install pygobject
讨论
请将非开发问题和讨论主题发送到我们的Web论坛
引用
如果您想在学术作品中引用librosa，有两种方法可以做到。
-
如果您在作品中使用此库，为了可重复性，请引用您使用的版本，该版本在Zenodo上有索引
从librosa版本0.10.2或更高版本开始，您也可以使用
librosa.cite()来获取任何版本librosa的DOI链接。 -
如果您想引用librosa的设计、动机等，请引用在SciPy 2015上发表的论文
McFee, Brian, Colin Raffel, Dawen Liang, Daniel PW Ellis, Matt McVicar, Eric Battenberg, 和 Oriol Nieto. "librosa: Audio and music signal analysis in python." In Proceedings of the 14th python in science conference, pp. 18-25. 2015.
下载文件
下载适用于您平台的文件。如果您不确定选择哪个，请了解更多关于 安装包 的信息。