Repolode
Enviar
JudoChinX

JudoChinX/rangarr

Servicio de orquestación que escalona y alterna búsquedas automáticas entre instancias de Radarr, Sonarr, Lidarr, Readarr y Whisparr para proteger los indexadores y respetar los límites de las API.

Ver en GitHub
Estrellas
265
Forks
7
Issues abiertos
0
Último commit
hace 27 días

¿Qué es?

Rangarr es un servicio ligero que coordina búsquedas automáticas de contenido multimedia en varias instancias de *arr: Radarr, Sonarr, Lidarr, Readarr y Whisparr (v2 y v3). En lugar de que cada instancia lance búsquedas al mismo tiempo, asigna un grupo global de turnos de búsqueda, alterna las solicitudes entre las instancias y los indexadores compartidos, y las espacia para no saturar los indexadores ni superar los límites de las API.

El comportamiento de las búsquedas se puede configurar. Las búsquedas de elementos faltantes y las búsquedas de mejoras se ejecutan en intervalos distintos; la distribución ponderada permite dar prioridad a ciertas instancias, y los filtros por etiquetas o las franjas horarias de actividad limitan qué elementos se buscan y cuándo. Las búsquedas de Sonarr y Whisparr v2 se pueden agrupar por temporada. También se pueden incluir elementos de Radarr, Sonarr y Whisparr que no alcancen el objetivo de puntuación de su formato personalizado, que el endpoint Cutoff Unmet de *arr no devuelve.

La configuración se guarda en un archivo config.yaml que admite la expansión de variables de entorno, o se puede definir íntegramente mediante variables de entorno. El proyecto se ejecuta como contenedor Docker, solo se comunica con las instancias de *arr que se configuren y no almacena bases de datos ni estado persistente.

Funciones clave

  • 01Gestiona Radarr, Sonarr, Lidarr, Readarr y Whisparr v2 y v3 desde un solo servicio.
  • 02Distribuye globalmente los turnos de búsqueda y alterna las solicitudes entre instancias.
  • 03Ejecuta las búsquedas de elementos faltantes y de mejoras con programaciones independientes.
  • 04Agrupa por temporada las búsquedas de Sonarr y Whisparr v2, con la opción de recurrir a los episodios en las temporadas que están en emisión.
  • 05Encuentra elementos que no alcanzan los objetivos de puntuación de formato personalizado y que Cutoff Unmet no detecta.
  • 06Filtra las búsquedas por etiquetas y las limita a las franjas horarias de actividad configuradas.

Casos de uso

  • Gestionar una biblioteca grande de Radarr y Sonarr sin saturar con búsquedas un indexador compartido.
  • Buscar contenido faltante de forma intensiva y comprobar si hay mejoras con menos frecuencia.
  • Limitar las búsquedas automáticas a las horas de la noche para evitar los periodos de mayor carga del indexador.
  • Implementar el servicio junto con los contenedores *arr existentes en Docker Compose.

Inicio rápido

  1. 1

    Descarga del repositorio los archivos de ejemplo config.yaml y compose.yaml, cámbiales el nombre y configura los permisos de archivo

  2. 2

    Edita config.yaml con las claves API y los nombres de host de *arr

    nano config.yaml
  3. 3

    Inicia Rangarr con Docker Compose (mantén dry_run: true hasta que los registros parezcan correctos)

    docker compose up -d

Antes de usarlo

  • Necesitas instancias existentes de Radarr, Sonarr, Lidarr, Readarr o Whisparr, y sus claves API.
  • La configuración requiere bastante trabajo: tendrás que crear config.yaml manualmente o definir muchas variables de entorno.

En colecciones

Apps autoalojadas

Temas

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

Preguntas frecuentes

¿Qué es rangarr?
Servicio de orquestación que escalona y alterna búsquedas automáticas entre instancias de Radarr, Sonarr, Lidarr, Readarr y Whisparr para proteger los indexadores y respetar los límites de las API. Rangarr es un servicio ligero que coordina búsquedas automáticas de contenido multimedia en varias instancias de *arr: Radarr, Sonarr, Lidarr, Readarr y Whisparr (v2 y v3). En lugar de que cada instancia lance búsquedas al mismo tiempo, asigna un grupo global de turnos de búsqueda, alterna las solicitudes entre las instancias y los indexadores compartidos, y las espacia para no saturar los indexadores ni superar los límites de las API.
¿rangarr es gratuito? ¿Qué licencia tiene?
rangarr es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿rangarr sigue mantenido?
Mantenimiento activo. El último commit de rangarr fue el 10 oct 2026.
¿Para qué puedo usar rangarr?
Gestionar una biblioteca grande de Radarr y Sonarr sin saturar con búsquedas un indexador compartido. Buscar contenido faltante de forma intensiva y comprobar si hay mejoras con menos frecuencia. Limitar las búsquedas automáticas a las horas de la noche para evitar los periodos de mayor carga del indexador. Implementar el servicio junto con los contenedores *arr existentes en Docker Compose.
¿Cómo se instala rangarr?
Descarga del repositorio los archivos de ejemplo config.yaml y compose.yaml, cámbiales el nombre y configura los permisos de archivo Edita config.yaml con las claves API y los nombres de host de *arr: nano config.yaml Inicia Rangarr con Docker Compose (mantén dry_run: true hasta que los registros parezcan correctos): docker compose up -d
¿Dónde consigo rangarr?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/JudoChinX/rangarr

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados