JudoChinX/rangarr

Что это?

Ключевые возможности

• 01Управляет Radarr, Sonarr, Lidarr, Readarr, Whisparr v2 и v3 из одного сервиса.
• 02Распределяет поисковые слоты глобально и чередует запросы между экземплярами.
• 03Запускает поиск отсутствующих элементов и обновлений по независимым расписаниям.
• 04Группирует поиск в Sonarr и Whisparr v2 по сезонам, а для выходящих сезонов переключается на поиск по эпизодам.
• 05Находит элементы, не достигшие целевых значений оценки custom format, которые пропускает Cutoff Unmet.
• 06Фильтрует поиск по тегам и ограничивает его заданными активными часами.

Сценарии использования

• Работа с большой библиотекой Radarr и Sonarr без потока поисковых запросов к общему индексатору.
• Активный поиск отсутствующего контента при более редкой проверке обновлений.
• Ограничение автоматического поиска ночными часами, чтобы снизить нагрузку на индексаторы в пиковое время.
• Развёртывание сервиса рядом с существующими контейнерами *arr в Docker Compose.

Быстрый старт

1. 1

   Скачайте из репозитория примеры config.yaml и compose.yaml, переименуйте их и настройте права доступа к файлам

2. 2

   Отредактируйте config.yaml, указав API-ключи и имена хостов для *arr

   nano config.yaml
3. 3

   Запустите Rangarr с помощью Docker Compose (оставьте dry_run: true, пока логи не будут выглядеть корректно)

   docker compose up -d

Что важно знать

• !Нужны уже запущенные экземпляры Radarr, Sonarr, Lidarr, Readarr или Whisparr, а также их API-ключи.
• !Настройка требует много работы: config.yaml придётся написать вручную или задать множество переменных окружения.

В подборках

Темы

Частые вопросы

Что такое rangarr?

Сервис оркестрации, который распределяет и чередует автоматические поисковые запросы между экземплярами Radarr, Sonarr, Lidarr, Readarr и Whisparr, чтобы не перегружать индексаторы и не превышать лимиты API. Rangarr — лёгкий сервис, который координирует автоматический поиск медиафайлов в нескольких экземплярах *arr: Radarr, Sonarr, Lidarr, Readarr и Whisparr (v2 и v3). Вместо того чтобы запускать поиск одновременно в каждом экземпляре, сервис выделяет общий пул поисковых слотов, чередует запросы между экземплярами и общими индексаторами и распределяет их по времени, чтобы не перегружать индексаторы и не превышать лимиты API.

rangarr можно использовать бесплатно? Какая у него лицензия?

rangarr распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.

rangarr всё ещё поддерживается?

Активно поддерживается. Последний коммит в rangarr — 10 окт. 2026 г..

Для чего можно использовать rangarr?

Работа с большой библиотекой Radarr и Sonarr без потока поисковых запросов к общему индексатору. Активный поиск отсутствующего контента при более редкой проверке обновлений. Ограничение автоматического поиска ночными часами, чтобы снизить нагрузку на индексаторы в пиковое время. Развёртывание сервиса рядом с существующими контейнерами *arr в Docker Compose.

Как установить rangarr?

Скачайте из репозитория примеры config.yaml и compose.yaml, переименуйте их и настройте права доступа к файлам Отредактируйте config.yaml, указав API-ключи и имена хостов для *arr: nano config.yaml Запустите Rangarr с помощью Docker Compose (оставьте dry_run: true, пока логи не будут выглядеть корректно): docker compose up -d

Где скачать rangarr?

Исходный код и инструкции по установке — на GitHub: https://github.com/JudoChinX/rangarr