music-assistant/server

어떤 프로젝트인가요?

핵심 기능

• 01여러 스트리밍 서비스를 하나의 미디어 라이브러리로 통합합니다
• 02다양한 연결형 스피커를 제어합니다
• 03자동화를 위해 Home Assistant 앱으로 실행하도록 설계되었습니다
• 04셀프 호스팅용 Docker 이미지로 제공됩니다
• 05오디오 처리를 위해 ffmpeg를 사용하는 Python 기반 프로젝트입니다

활용 사례

• 집 안 곳곳의 스피커에서 스트리밍 서비스의 음악을 재생합니다
• Home Assistant 자동화 환경에 음악 재생 기능을 추가합니다
• Raspberry Pi 또는 NAS에서 홈 음악 서버를 실행합니다

빠른 시작

1. 1

   Home Assistant에 Music Assistant 앱을 설치합니다(권장).

2. 2

   또는 공식 Docker 컨테이너 이미지를 실행합니다.

   docker pull ghcr.io/music-assistant/server
3. 3

   개발: setup 스크립트로 가상 환경을 만들고 종속 항목을 설치합니다.

   scripts/setup.sh
4. 4

   개발: http://localhost:8095에서 서버를 로컬로 실행합니다.

   python -m music_assistant --log-level debug

사용 전 알아둘 점

• !PyPI에 게시되지 않아 pip install을 지원하지 않습니다.
• !앱이나 컨테이너로 실행하지 않는 경우 최신 ffmpeg(7.0+)와 시스템 종속 항목이 필요합니다.
• !항상 켜져 있는 기기에서 실행하도록 설계되었으며 Home Assistant와 함께 사용할 때 가장 잘 작동합니다.
• !타사 배포 패키지는 지원하지 않습니다.

포함된 컬렉션

토픽

자주 묻는 질문

server은(는) 무엇인가요?

Home Assistant와 함께 실행하는 경우가 많은, 스트리밍 서비스와 다양한 연결형 스피커를 연동하는 셀프 호스팅 음악 라이브러리 관리자입니다. Music Assistant는 무료 오픈소스 미디어 라이브러리 관리자입니다. 스트리밍 서비스와 다양한 연결형 스피커를 연동해 한곳에서 음악을 관리하고 재생할 수 있습니다. 서버는 핵심 구성 요소로, Raspberry Pi, NAS 또는 소형 Intel NUC 같은 기기에서 계속 실행하도록 설계되었습니다.

server은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

server은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

server은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. server의 마지막 커밋은 2026년 10월 24일입니다.

server은(는) 어디에 사용할 수 있나요?

집 안 곳곳의 스피커에서 스트리밍 서비스의 음악을 재생합니다 Home Assistant 자동화 환경에 음악 재생 기능을 추가합니다 Raspberry Pi 또는 NAS에서 홈 음악 서버를 실행합니다

server는 어떻게 설치하나요?

Home Assistant에 Music Assistant 앱을 설치합니다(권장). 또는 공식 Docker 컨테이너 이미지를 실행합니다.: docker pull ghcr.io/music-assistant/server 개발: setup 스크립트로 가상 환경을 만들고 종속 항목을 설치합니다.: scripts/setup.sh 개발: http://localhost:8095에서 서버를 로컬로 실행합니다.: python -m music_assistant --log-level debug

server은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/music-assistant/server