자체 음악 라이브러리와 추천, 플레이리스트 기능을 제공하는 셀프 호스팅 음악 발견 앱이며, Lidarr는 선택적으로 연동할 수 있습니다.
Dodelidoo-Labs/sonobarr
Lidarr 라이브러리와 Last.fm 추천을 연동하고 AI 지원 웹 UI를 제공하는 셀프 호스팅 음악 탐색 도구입니다.
- 스타
- 382
- 포크
- 5
- 열린 이슈
- 8
- 마지막 커밋
- 2개월 전
어떤 프로젝트인가요?
Sonobarr는 기존 Lidarr 음악 라이브러리를 바탕으로 새로운 아티스트를 찾는 셀프 호스팅 웹 앱입니다. Lidarr에서 아티스트를 가져와 Last.fm에서 비슷한 아티스트를 조회한 뒤, 결과를 브라우저의 그리드에 표시합니다. 여기서 미리 듣기를 하고, 아티스트 소개를 읽고, 후보를 클릭 한 번으로 Lidarr에 추가할 수 있습니다.
Lidarr와 Last.fm 외에도 저장된 Last.fm 스크로블과 ListenBrainz Weekly Exploration 플레이리스트를 기반으로 추천을 생성할 수 있습니다. 선택 사항인 AI 어시스턴트는 원하는 분위기나 장르를 자연어로 입력받아, OpenAI 호환 모델로 새 세션에 사용할 시드 아티스트를 고릅니다.
백엔드는 Flask와 Socket.IO, 프런트엔드는 Bootstrap으로 구축했습니다. 멀티유저 기능으로 역할 기반 접근 제어, 관리자 승인 절차가 포함된 아티스트 요청 기능, 사용자별 API 키, 선택 사항인 OIDC 싱글 사인온을 지원합니다. 설정 파일과 환경 파일을 사용해 Docker Compose로 배포합니다.
핵심 기능
- 01모니터링 중인 Lidarr 아티스트를 동기화하고, 선택한 아티스트를 Lidarr에 다시 추가합니다.
- 02Lidarr, Last.fm 스크로블, ListenBrainz 플레이리스트를 바탕으로 탐색 목록을 만듭니다.
- 03OpenAI 호환 모델을 통해 텍스트 설명에서 세션의 시드 아티스트를 고르는 AI 어시스턴트를 제공합니다.
- 04관리자 승인 기능과 실시간 Socket.IO 업데이트를 갖춘 아티스트 요청 절차를 제공합니다.
- 05YouTube 또는 iTunes 미리 듣기와 Last.fm 아티스트 소개 및 통계를 제공합니다.
- 06OIDC 싱글 사인온과 사용자별 API 키를 지원합니다.
활용 사례
- 기존 Lidarr 라이브러리에 반영된 취향에 맞는 새로운 아티스트를 찾는 경우.
- 여러 가족 구성원이 별도 계정으로 하나의 셀프 호스팅 Lidarr 인스턴스를 함께 사용하는 경우.
- 관리자가 승인해 Lidarr에 추가할 수 있도록 관리자 외 사용자가 아티스트를 요청하게 하는 경우.
빠른 시작
- 1
작업 디렉터리를 만들고 컨테이너의 UID/GID에 소유권을 설정합니다
mkdir -p sonobarr && cd sonobarr sudo chown -R 1000:1000 . - 2
샘플 docker-compose.yml 및 .env 설정 파일을 다운로드합니다
curl -L https://raw.githubusercontent.com/Dodelidoo-Labs/sonobarr/develop/docker-compose.yml -o docker-compose.yml curl -L https://raw.githubusercontent.com/Dodelidoo-Labs/sonobarr/develop/.sample-env -o .env - 3
secret_key, Lidarr 주소와 API 키, Last.fm API 키와 시크릿을 설정하도록 .env를 편집합니다
- 4
Docker Compose로 Sonobarr를 시작하고 http://localhost:5000을 엽니다
docker compose up -d
사용 전 알아둘 점
- 사용하려면 실행 중인 Lidarr 인스턴스와 Last.fm API 키가 필요합니다.
- Docker를 우선으로 하는 설정 방식이며, README에는 최종 사용자를 위한 비-Docker 네이티브 설치 방법이 안내되어 있지 않습니다.
- 공개 API 문서는 추후 제공될 예정입니다.
포함된 컬렉션
토픽
자주 묻는 질문
- sonobarr은(는) 무엇인가요?
- Lidarr 라이브러리와 Last.fm 추천을 연동하고 AI 지원 웹 UI를 제공하는 셀프 호스팅 음악 탐색 도구입니다. Sonobarr는 기존 Lidarr 음악 라이브러리를 바탕으로 새로운 아티스트를 찾는 셀프 호스팅 웹 앱입니다. Lidarr에서 아티스트를 가져와 Last.fm에서 비슷한 아티스트를 조회한 뒤, 결과를 브라우저의 그리드에 표시합니다. 여기서 미리 듣기를 하고, 아티스트 소개를 읽고, 후보를 클릭 한 번으로 Lidarr에 추가할 수 있습니다.
- sonobarr은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- sonobarr은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- sonobarr은(는) 아직 유지보수되고 있나요?
- 6개월 이내 업데이트. sonobarr의 마지막 커밋은 2026년 9월 9일입니다.
- sonobarr은(는) 어디에 사용할 수 있나요?
- 기존 Lidarr 라이브러리에 반영된 취향에 맞는 새로운 아티스트를 찾는 경우. 여러 가족 구성원이 별도 계정으로 하나의 셀프 호스팅 Lidarr 인스턴스를 함께 사용하는 경우. 관리자가 승인해 Lidarr에 추가할 수 있도록 관리자 외 사용자가 아티스트를 요청하게 하는 경우.
- sonobarr는 어떻게 설치하나요?
- 작업 디렉터리를 만들고 컨테이너의 UID/GID에 소유권을 설정합니다: mkdir -p sonobarr && cd sonobarr sudo chown -R 1000:1000 . 샘플 docker-compose.yml 및 .env 설정 파일을 다운로드합니다: curl -L https://raw.githubusercontent.com/Dodelidoo-Labs/sonobarr/develop/docker-compose.yml -o docker-compose.yml curl -L https://raw.githubusercontent.com/Dodelidoo-Labs/sonobarr/develop/.sample-env -o .env secret_key, Lidarr 주소와 API 키, Last.fm API 키와 시크릿을 설정하도록 .env를 편집합니다 Docker Compose로 Sonobarr를 시작하고 http://localhost:5000을 엽니다: docker compose up -d
- sonobarr은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/Dodelidoo-Labs/sonobarr
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
Last.fm 데이터를 활용해 Lidarr 라이브러리의 아티스트를 바탕으로 새로운 아티스트와 앨범을 추천하는 음악 발견 도구입니다.
프리랜서와 팀을 위한 셀프 호스팅 시간 추적 및 인보이스 앱으로, 타이머, 프로젝트, PDF 인보이스, Peppol 전자 인보이스 기능을 제공합니다.
Radarr, Sonarr, Lidarr, Readarr, Whisparr 인스턴스의 자동 검색을 분산·교차 실행해 인덱서와 API 한도를 보호하는 오케스트레이션 서비스입니다.
GitHub 저장소의 Docker Compose 앱을 자체 서버에 배포하는 셀프 호스팅 배포 플랫폼으로, Vercel과 비슷합니다.
Sonarr와 Radarr 인스턴스에 TRaSH Guides와 사용자 지정 설정을 동기화해 사용자 지정 포맷과 품질 프로필을 자동으로 관리하는 오픈소스 도구입니다.