pyaudio 설치가 잘 안되는 경우

pip3 install pyaudio

알다시피, 파이썬 라이브러리를 설치하려는 경우 "pip install"을 사용하는 것이 일반적이다. 음악 관련 대표적인 파이썬 라이브러리인 pyaudio를 설치하는 경우에도 pip을 사용하게 된다. 그런데, 위의 방법으로 설치를 진행하려고 하면 알 수 없는 이유로 인하여 pyaudio의 설치가 진행되지 않는 경우가 발생하곤 한다.

 

pyaudio 설치 오류 원인은 십중팔구 portaudio 때문이다. portaudio는 음악 재생 및 녹음을 위한 오픈소스 크로스 플랫폼 소프트웨어로 리눅스, 윈도우, 그리고 맥북에서 사용이 가능하다. pyaudio는 내부에서 이 portaudio를 사용하는데, 이 portaudio가 설치되어 있지 않거나, 제대로 설치가 안 되어 있거나, 설치 중에 오류가 난 경우 pyaudio 설치가 실패하게 된다.

 

안타깝게도 윈도우 기기가 없는 관계로 윈도우에서는 테스트를 해보지 못한 관계로 맥북과 리눅스에서의 해결법만 써 넣도록 하겠다.

 

1. Mac OS

 

맥북의 경우 m1과 intel 맥북이 해결방법이 조금씩 상이하다. 하지만 두 방법 모두 homebrew를 사용하기 때문에, 반드시 homebrew를 먼저 설치해 놓아야 한다.

 

Intel Macbook에서는 homebrew를 통해서 portaudio를 설치한 뒤 pyaudio를 다시 설치하면 된다.

brew install portaudio
pip3 install pyaudio

 

M1 맥북의 경우에는 다음과 같다.

# 1. Install portaudio
brew install portaudio

# 2. link portaudio
brew link portaudio

# 3. Copy the path where portaudio was installed
brew --prefix portaudio

# 4. Create .pydisutils.cfg in your home dir
sudo vi $HOME/.pydisutils.cfg

# then paste the followings
[build_ext]
include_dirs=<PATH_FROM_STEP3>/include/
library_dirs=<PATH_FROM_STEP3>/lib/

# 5. Install pyaudio
pip3 install pyaudio

4번에서 vi 대신 nano 등 더 편한 텍스트 에디터를 사용해도 된다.

 

 

2. 리눅스

 

리눅스에서 pyaudio가 설치되기 위해서는 portaudio development 파일들이 있어야만 한다. 따라서, 아래와 같이 portaudio의 dev 버전을 다운로드하면 된다.

# install portaudio dev
sudo apt install portaudio19-dev

# install pyaudio
pip3 install pyaudio