Radarr, Sonarr, Lidarr, Readarr, Whisparr용 셀프 호스팅 보조 도구로, 누락되었거나 품질 기준에 미달하는 미디어를 천천히 검색합니다.
JudoChinX/rangarr
Radarr, Sonarr, Lidarr, Readarr, Whisparr 인스턴스의 자동 검색을 분산·교차 실행해 인덱서와 API 한도를 보호하는 오케스트레이션 서비스입니다.
- 스타
- 266
- 포크
- 7
- 열린 이슈
- 0
- 마지막 커밋
- 29일 전
어떤 프로젝트인가요?
Rangarr는 Radarr, Sonarr, Lidarr, Readarr, Whisparr(v2 및 v3) 등 여러 *arr 인스턴스에서 미디어 자동 검색을 조율하는 경량 서비스입니다. 각 인스턴스가 동시에 검색을 시작하도록 두는 대신, 전체 검색 슬롯을 할당하고 인스턴스와 공유 인덱서 간에 요청을 교차 배치하며 간격을 두어 인덱서와 API 한도에 과부하가 걸리지 않도록 합니다.
검색 동작은 설정할 수 있습니다. 누락 항목 검색과 업그레이드 검색을 서로 다른 주기로 실행하고, 가중치 기반 분배로 특정 인스턴스의 우선순위를 높일 수 있으며, 태그 필터나 활성 시간대를 설정해 검색 대상과 시간을 제한할 수 있습니다. Sonarr 및 Whisparr v2 검색은 시즌별로 묶을 수 있고, Radarr, Sonarr, Whisparr에서 사용자 지정 포맷 점수 목표에 미달하는 항목도 검색에 포함할 수 있습니다. 이런 항목은 *arr의 Cutoff Unmet 엔드포인트에서 반환되지 않습니다.
설정은 환경 변수 치환을 지원하는 config.yaml 파일에 저장하거나 환경 변수만으로 구성할 수 있습니다. 프로젝트는 Docker 컨테이너로 실행되며, 사용자가 지정한 *arr 인스턴스와만 통신하고 데이터베이스나 영구 상태를 저장하지 않습니다.
핵심 기능
- 01하나의 서비스에서 Radarr, Sonarr, Lidarr, Readarr, Whisparr v2 및 v3를 관리합니다.
- 02검색 슬롯을 전역으로 배분하고 인스턴스 간 요청을 교차 배치합니다.
- 03누락 항목 검색과 업그레이드 검색을 서로 독립된 일정으로 실행합니다.
- 04Sonarr 및 Whisparr v2 검색을 시즌별로 묶고, 방영 중인 시즌은 에피소드 단위 검색으로 대체합니다.
- 05Cutoff Unmet에서 누락되는 사용자 지정 포맷 점수 목표 미달 항목을 찾습니다.
- 06태그로 검색을 필터링하고 설정한 활성 시간대로 검색 시간을 제한합니다.
활용 사례
- 대규모 Radarr 및 Sonarr 라이브러리를 운영하면서 공유 인덱서에 검색 요청이 몰리지 않게 합니다.
- 누락 콘텐츠는 적극적으로 검색하고 업그레이드는 더 드물게 확인합니다.
- 인덱서 사용량이 많은 시간대를 피해 야간에만 자동 검색을 실행합니다.
- 기존 *arr 컨테이너와 함께 Docker Compose로 서비스를 배포합니다.
빠른 시작
- 1
저장소에서 예제 config.yaml과 compose.yaml을 다운로드하고, 이름을 변경한 다음 파일 권한을 설정합니다
- 2
config.yaml을 편집해 *arr API 키와 호스트 이름을 설정합니다
nano config.yaml - 3
Docker Compose로 Rangarr를 시작합니다(로그가 올바르게 보일 때까지 dry_run: true로 유지하세요)
docker compose up -d
사용 전 알아둘 점
- 기존 Radarr, Sonarr, Lidarr, Readarr 또는 Whisparr 인스턴스와 각 인스턴스의 API 키가 필요합니다.
- 설정할 항목이 많아 config.yaml을 직접 작성하거나 여러 환경 변수를 설정해야 합니다.
포함된 컬렉션
토픽
자주 묻는 질문
- rangarr은(는) 무엇인가요?
- Radarr, Sonarr, Lidarr, Readarr, Whisparr 인스턴스의 자동 검색을 분산·교차 실행해 인덱서와 API 한도를 보호하는 오케스트레이션 서비스입니다. Rangarr는 Radarr, Sonarr, Lidarr, Readarr, Whisparr(v2 및 v3) 등 여러 *arr 인스턴스에서 미디어 자동 검색을 조율하는 경량 서비스입니다. 각 인스턴스가 동시에 검색을 시작하도록 두는 대신, 전체 검색 슬롯을 할당하고 인스턴스와 공유 인덱서 간에 요청을 교차 배치하며 간격을 두어 인덱서와 API 한도에 과부하가 걸리지 않도록 합니다.
- rangarr은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- rangarr은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- rangarr은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. rangarr의 마지막 커밋은 2026년 10월 10일입니다.
- rangarr은(는) 어디에 사용할 수 있나요?
- 대규모 Radarr 및 Sonarr 라이브러리를 운영하면서 공유 인덱서에 검색 요청이 몰리지 않게 합니다. 누락 콘텐츠는 적극적으로 검색하고 업그레이드는 더 드물게 확인합니다. 인덱서 사용량이 많은 시간대를 피해 야간에만 자동 검색을 실행합니다. 기존 *arr 컨테이너와 함께 Docker Compose로 서비스를 배포합니다.
- rangarr는 어떻게 설치하나요?
- 저장소에서 예제 config.yaml과 compose.yaml을 다운로드하고, 이름을 변경한 다음 파일 권한을 설정합니다 config.yaml을 편집해 *arr API 키와 호스트 이름을 설정합니다: nano config.yaml Docker Compose로 Rangarr를 시작합니다(로그가 올바르게 보일 때까지 dry_run: true로 유지하세요): docker compose up -d
- rangarr은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/JudoChinX/rangarr
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
Sonarr와 Radarr 인스턴스에 TRaSH Guides와 사용자 지정 설정을 동기화해 사용자 지정 포맷과 품질 프로필을 자동으로 관리하는 오픈소스 도구입니다.
Sonarr, Radarr 등 *arr 제품군의 상태와 성능을 모니터링하고 그래프로 확인할 수 있도록 데이터를 수집하는 Prometheus exporter입니다.
Jellyfin, Plex, Emby 라이브러리의 영화 및 TV 프로그램 요청과 승인 절차를 관리하는 오픈소스 웹 앱입니다.
Ombi는 사용자가 영화, 음악, TV 프로그램을 요청하고 Plex, Emby, Jellyfin과 동기화할 수 있는 셀프 호스팅 미디어 요청 도구입니다.
Radarr와 Sonarr의 품질 프로필과 커스텀 포맷을 관리하고 인스턴스 간 동기화하며 릴리스를 테스트하는 셀프 호스팅 플랫폼입니다.