집 안의 모든 스피커에서 스트리밍 음악을 하나로 합쳐 재생하는 방법
여러 음악 서비스의 곡을 하나의 목록으로 묶고, 집 안의 다양한 스피커에서 동시에 재생하는 장면을 떠올려 보세요. Music Assistant는 이런 일을 가능하게 하는 무료 오픈소스 미디어 라이브러리 관리자입니다. 이 서버는 항상 켜져 있어야 하는 장치에서 돌아가며, 음악 데이터를 중앙에서 정리하고 제어합니다.
Home Assistant와 함께 쓰는 이유
Music Assistant는 단독으로 사용할 수 있지만, Home Assistant와 함께 사용하는 것을 전제로 설계되었습니다. 자동화를 염두에 두고 만들어졌기 때문에, Home Assistant 앱으로 실행하는 것이 공식적으로 권장되는 설치 방법입니다. 서버는 음악 스트리밍 서비스와 연결된 스피커를 폭넓게 지원하여, 복잡한 설정 없이도 통합된 음악 환경을 구축할 수 있게 합니다.
설치 방법과 시스템 요구 사항
공식적으로 지원하는 설치 방법은 Home Assistant 앱과 Docker 컨테이너 두 가지입니다. 이 두 방식은 서버가 필요로 하는 모든 시스템 의존성을 함께 묶어 제공합니다. Music Assistant의 메인 코드는 Python으로 작성되었지만, 최신 ffmpeg(6.1 이상)와 특정 코덱 세트, jemalloc이나 CIFS/NFS 클라이언트 라이브러리 같은 외부 OS 구성 요소에 의존합니다. 이러한 이유로 PyPI에 공개되지 않으며, pip로 직접 설치하는 것은 지원하지 않습니다. 개발 목적으로 소스에서 실행하려면 Python 3.14 이상과 ffmpeg 6.1 이상이 필요합니다.
서버를 돌리기 위한 준비물
이 서버는 항상 켜져 있어야 하는 장치에서 실행되어야 합니다. Raspberry Pi, NAS, Intel NUC 같은 장치가 적합합니다. 서버가 정상적으로 작동하려면 위에서 언급한 하드웨어와 소프트웨어 환경이 충족되어야 하며, 특히 ffmpeg 버전과 코덱 지원 여부가 중요합니다. Home Assistant를 이미 사용 중이라면 앱 설치로 바로 시작할 수 있고, 그렇지 않다면 Docker 컨테이너를 통해 독립적으로 실행할 수 있습니다.
사용 전 확인해야 할 점
Music Assistant는 무료 오픈소스 프로젝트이지만, 특정 하드웨어와 소프트웨어 환경에 의존합니다. Home Assistant를 사용하지 않고 단독으로 사용하려면 Docker 컨테이너를 통해 실행해야 하며, 이 경우에도 시스템 의존성이 제대로 포함되었는지 점검이 필요합니다. 문서와 지원은 공식 웹사이트와 이슈 트래커를 통해 제공되므로, 문제 발생 시 해당 채널을 이용해야 합니다.