Repolode
Enviar
JudoChinX

JudoChinX/rangarr

Serviço de orquestração que espaça e intercala buscas automatizadas entre instâncias do Radarr, Sonarr, Lidarr, Readarr e Whisparr para proteger indexadores e respeitar limites de API.

Ver no GitHub
Estrelas
266
Forks
7
Issues abertas
0
Último commit
há 29 dias

O que é?

O Rangarr é um serviço leve que coordena buscas automatizadas de mídia em várias instâncias *arr: Radarr, Sonarr, Lidarr, Readarr e Whisparr (v2 e v3). Em vez de permitir que cada instância dispare buscas ao mesmo tempo, ele aloca um pool global de slots de busca, intercala as solicitações entre as instâncias e os indexadores compartilhados e as espaça para não sobrecarregar os indexadores nem exceder os limites de API.

O comportamento das buscas é configurável. As buscas por itens ausentes e por upgrades são executadas em intervalos separados; a distribuição ponderada pode priorizar determinadas instâncias; e filtros por tags ou janelas de horário ativo limitam quais itens são buscados e quando. As buscas do Sonarr e do Whisparr v2 podem ser agrupadas por temporada, e itens do Radarr, Sonarr e Whisparr abaixo da pontuação-alvo de custom format podem ser incluídos — eles não aparecem no endpoint Cutoff Unmet do *arr.

A configuração fica em um arquivo config.yaml, que permite expandir variáveis de ambiente, ou pode ser feita inteiramente por variáveis de ambiente. O projeto é executado como um container Docker, se comunica apenas com as instâncias *arr definidas por você e não armazena banco de dados nem estado persistente.

Recursos principais

  • 01Gerencia Radarr, Sonarr, Lidarr, Readarr, Whisparr v2 e v3 em um único serviço.
  • 02Distribui globalmente os slots de busca e intercala solicitações entre as instâncias.
  • 03Executa buscas por itens ausentes e por upgrades em agendas independentes.
  • 04Agrupa por temporada as buscas do Sonarr e do Whisparr v2, com fallback para episódios nas temporadas em exibição.
  • 05Encontra itens abaixo das pontuações-alvo de custom format que o Cutoff Unmet não identifica.
  • 06Filtra buscas por tags e as limita aos horários ativos configurados.

Casos de uso

  • Executar uma biblioteca grande do Radarr e do Sonarr sem inundar um indexador compartilhado com buscas.
  • Buscar conteúdo ausente com frequência e verificar upgrades com menos frequência.
  • Limitar as buscas automatizadas ao período noturno para evitar os horários de pico dos indexadores.
  • Implantar o serviço junto aos containers *arr existentes no Docker Compose.

Início rápido

  1. 1

    Baixe do repositório os arquivos de exemplo config.yaml e compose.yaml, renomeie-os e configure as permissões dos arquivos

  2. 2

    Edite config.yaml com as chaves de API e os nomes de host do *arr

    nano config.yaml
  3. 3

    Inicie o Rangarr com Docker Compose (mantenha dry_run: true até que os logs pareçam corretos)

    docker compose up -d

Antes de usar

  • Você precisa de instâncias existentes do Radarr, Sonarr, Lidarr, Readarr ou Whisparr e das respectivas chaves de API.
  • A configuração exige bastante trabalho: é necessário criar config.yaml manualmente ou definir muitas variáveis de ambiente.

Em coleções

Apps auto-hospedados

Tópicos

#media-automation#radarr#sonarr#lidarr#docker#self-hosted#indexer#python

Perguntas frequentes

O que é rangarr?
Serviço de orquestração que espaça e intercala buscas automatizadas entre instâncias do Radarr, Sonarr, Lidarr, Readarr e Whisparr para proteger indexadores e respeitar limites de API. O Rangarr é um serviço leve que coordena buscas automatizadas de mídia em várias instâncias *arr: Radarr, Sonarr, Lidarr, Readarr e Whisparr (v2 e v3). Em vez de permitir que cada instância dispare buscas ao mesmo tempo, ele aloca um pool global de slots de busca, intercala as solicitações entre as instâncias e os indexadores compartilhados e as espaça para não sobrecarregar os indexadores nem exceder os limites de API.
rangarr é gratuito? Qual é a licença?
rangarr é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
rangarr ainda é mantido?
Manutenção ativa. O último commit de rangarr foi em 10 de out. de 2026.
Para que posso usar rangarr?
Executar uma biblioteca grande do Radarr e do Sonarr sem inundar um indexador compartilhado com buscas. Buscar conteúdo ausente com frequência e verificar upgrades com menos frequência. Limitar as buscas automatizadas ao período noturno para evitar os horários de pico dos indexadores. Implantar o serviço junto aos containers *arr existentes no Docker Compose.
Como instalar rangarr?
Baixe do repositório os arquivos de exemplo config.yaml e compose.yaml, renomeie-os e configure as permissões dos arquivos Edite config.yaml com as chaves de API e os nomes de host do *arr: nano config.yaml Inicie o Rangarr com Docker Compose (mantenha dry_run: true até que os logs pareçam corretos): docker compose up -d
Onde consigo rangarr?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/JudoChinX/rangarr

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados