Um pacote python para análise de música e áudio.
soundfile
audioread
apt get
)yum
)Consulte https://librosa.org/doc/ para obter um manual de referência completo e tutoriais introdutórios.
A galeria de exemplos avançados deve lhe dar uma ideia rápida dos tipos de coisas que a librosa pode fazer.
Voltar ao início ↥
A versão estável mais recente está disponível no PyPI e você pode instalá-la dizendo
python -m pip install librosa
Os usuários do Anaconda podem instalar usando conda-forge
:
conda install -c conda-forge librosa
Para construir librosa a partir da fonte, digamos
python setup.py build
Então, para instalar o librosa, diga
python setup.py install
Se tudo correr bem, você poderá executar os seguintes comandos em um console python:
import librosa
librosa.show_versions()
Isto deve imprimir uma descrição do seu ambiente de software, juntamente com as versões instaladas de outros pacotes usados pela librosa.
Os usuários do OS X devem seguir o guia de instalação fornecido abaixo.
Alternativamente, você pode baixar ou clonar o repositório e usar pip
para lidar com dependências:
unzip librosa.zip
python -m pip install -e librosa
ou
git clone https://github.com/librosa/librosa.git
python -m pip install -e librosa
Ao chamar pip list
você deverá ver librosa
agora como um pacote instalado:
librosa (0.x.x, /path/to/librosa)
Voltar ao início ↥
librosa
usa soundfile
e audioread
para carregar arquivos de áudio.
Observe que versões mais antigas do soundfile
(anteriores a 0.11) não suportam MP3, o que fará com que a librosa volte para a biblioteca audioread
.
soundfile
Se você estiver usando conda
para instalar o librosa, as dependências de codificação de áudio serão tratadas automaticamente.
Se estiver usando pip
em um ambiente Linux, pode ser necessário instalar libsndfile
manualmente. Consulte a documentação de instalação do SoundFile para obter detalhes.
audioread
e MP3 Para alimentar audioread
com mais poder de decodificação de áudio (por exemplo, para ler arquivos MP3), você pode precisar instalar o ffmpeg ou o GStreamer .
Observe que em algumas plataformas, audioread
precisa de pelo menos um dos programas para funcionar corretamente.
Se você estiver usando o Anaconda, instale o ffmpeg chamando
conda install -c conda-forge ffmpeg
Se você não estiver usando o Anaconda, aqui estão alguns comandos comuns para diferentes sistemas operacionais:
apt-get
): apt-get install ffmpeg
ou
apt-get install gstreamer1.0-plugins-base gstreamer1.0-plugins-ugly
yum
): yum install ffmpeg
ou
yum install gstreamer1.0-plugins-base gstreamer1.0-plugins-ugly
brew install ffmpeg
ou
brew install gstreamer
baixe binários ffmpeg deste site ou binários gstreamer deste site
Para o GStreamer, você também precisa instalar as ligações Python com
python -m pip install pygobject
Voltar ao início ↥
Direcione perguntas e tópicos de discussão não relacionados ao desenvolvimento para nosso fórum da web em https://groups.google.com/forum/#!forum/librosa
Voltar ao início ↥
Se você quiser citar a librosa em um trabalho acadêmico, há duas maneiras de fazer isso.
Se você estiver utilizando a biblioteca para o seu trabalho, por uma questão de reprodutibilidade, cite a versão que você utilizou conforme indexada no Zenodo:
A partir da versão 0.10.2 ou posterior da librosa, você também pode usar librosa.cite()
para obter o link DOI para qualquer versão da librosa.
Se desejar citar librosa por seu design, motivação, etc., cite o artigo publicado no SciPy 2015:
McFee, Brian, Colin Raffel, Dawen Liang, Daniel PW Ellis, Matt McVicar, Eric Battenberg e Oriol Nieto. "librosa: Análise de sinais de áudio e música em python." Em Anais da 14ª conferência python em ciência, pp. 2015.
Voltar ao início ↥