書生氣的

利布羅薩

用於音樂和音訊分析的 python 套件。

目錄

• 文件
• 安裝
  • 使用 PyPI
  • 使用水蟒
  • 從源頭構建
  • 安裝提示
    • soundfile
    • audioread
      • Linux（ apt get ）
      • Linux（ yum ）
      • 蘋果
      • 視窗
• 討論
• 引用

---

文件

請參閱 https://librosa.org/doc/ 以取得完整的參考手冊和介紹性教學。

進階範例庫應該讓您快速了解 librosa 可以做的事情。

---

回到頂部 ↥

安裝

使用 PyPI

PyPI 上提供了最新的穩定版本，您可以透過以下方式安裝它

 python -m pip install librosa

使用水蟒

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，請透過呼叫安裝ffmpeg

 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

• 蘋果：

 brew install ffmpeg

或者

 brew install gstreamer

• 視窗：

從該網站下載 ffmpeg 二進位檔案或從該網站下載 gstreamer 二進位文件

對於 GStreamer，您還需要安裝 Python 綁定

 python -m pip install pygobject

---

回到頂部 ↥

討論

請將非開發問題和討論主題直接發送至我們的網路論壇：https://groups.google.com/forum/#!forum/librosa

---

回到頂部 ↥

引用

如果您想在學術著作中引用 librosa，有兩種方法可以實現。

• 如果您在工作中使用該庫，為了重現性，請引用您在 Zenodo 索引中使用的版本：

  從 librosa 版本 0.10.2 或更高版本開始，您也可以使用librosa.cite()取得任何版本的 librosa 的 DOI 連結。

• 如果您想引用 librosa 的設計、動機等，請引用在 SciPy 2015 上發表的論文：

  McFee、Brian、Colin Raffel、樑大文、Daniel PW Ellis、Matt McVicar、Eric Battenberg 和 Oriol Nieto。 “librosa：Python 中的音訊和音樂訊號分析。”第 14 屆 Python 科學會議論文集，第 18-25 頁。 2015年。

---

回到頂部 ↥