Saltar al contenido principal

Integración domótica Overseerr / Jellyseerr / Ombi, gratuita y de código abierto

Integración Overseerr / Jellyseerr / Ombi para Gladys Assistant

Solicitudes de películas y series de Overseerr, Jellyseerr, Seerr u Ombi: aprobaciones, llegadas.

Ver en GitHubTodas las integraciones

Siga en Gladys las solicitudes de películas y series de su hogar: lo que espera su aprobación, lo que se está descargando, lo que acaba de llegar a la mediateca y los problemas que notifican sus usuarios. Funciona con Overseerr (Plex), Jellyseerr (Jellyfin, Emby, Plex) y Seerr (su sucesor): los tres comparten la misma API.

Es la compañera de la integración «Sonarr & Radarr», que sigue las descargas en sí; esta sigue las solicitudes de sus usuarios.

Probada con servidores reales Overseerr 1.35.0, Jellyseerr 2.7.3 y Seerr 3.5.0, pero todavía no en una instalación completa (Plex o Jellyfin, Sonarr, Radarr y Gladys juntos): comentarios bienvenidos en GitHub.

Ombi (v4) también es compatible, con su propia API: un Ombi junto a uno o dos servidores Overseerr, Jellyseerr o Seerr. Probada con un Ombi 4.53.10 real.

Requisitos​

  • Gladys Assistant 5.1.0 o posterior.

  • Un servidor Overseerr, Jellyseerr o Seerr al que Gladys pueda acceder en su red (por ejemplo http://192.168.1.2:5055).

  • Su clave de API: en la interfaz web, Settings → General → API Key. La clave actúa como el administrador del servidor: guárdela para usted.

  • Para Ombi: Ombi v4, su dirección (puerto 3579 por defecto) y su clave de API, en Settings → Ombi → API Key. También actúa como un administrador.

Configuración​

Integraciones → Overseerr / Jellyseerr / Ombi → Configuración:

  • Dirección: la dirección IP o el nombre del servidor con su puerto, y su base de URL si está detrás de un proxy inverso (https://example.org/overseerr). También sirve una dirección copiada del navegador.
  • Clave de API: véase más arriba.
  • Nombre: el nombre del dispositivo en Gladys. Vacío: el nombre de la aplicación seguido de la dirección.
  • Un segundo servidor es opcional: una instancia 4K, o un Jellyseerr junto a un Overseerr.
  • Permitir aprobar y rechazar: desactivado por defecto. Activado, las acciones de escena y los botones del widget pueden aprobar o rechazar la solicitud pendiente más reciente. Desactivado, Gladys solo lee.
  • Aceptar certificados autofirmados: para una dirección https:// servida con su propio certificado.
  • Intervalo de actualización: de 30 segundos a 10 minutos (1 minuto por defecto).
  • Idioma de los textos: los nombres de las funciones (asignados al añadir el dispositivo y luego fijados por Gladys), los títulos de las películas y series, y las palabras enviadas a las escenas. Francés por defecto.

Probar la conexión lee cada servidor ahora e indica lo que encuentra.

Después, en la pestaña Descubrir, añada a Gladys el dispositivo de cada servidor.

La sección Ombi (opcional) tiene los mismos tres campos (dirección, clave de API, nombre) para un Ombi v4.

Dispositivo​

Un dispositivo por servidor, de solo lectura:

FunciónLo que indica
En línea1 mientras el servidor responde
Solicitudes pendientes de aprobaciónSolicitudes que nadie ha aprobado ni rechazado todavía
Solicitudes aprobadas en cursoAprobadas, todavía no en la mediateca
Solicitudes disponiblesAprobadas y en la mediateca
Solicitudes fallidasSonarr o Radarr las ha rechazado
Total de solicitudesTodas las solicitudes, sea cual sea su estado
Problemas abiertosProblemas notificados por los usuarios, todavía sin resolver
Última solicitudTítulo de la solicitud más reciente
Solicitada porQuién la hizo
VersiónVersión del servidor
Actualización disponible1 cuando el servidor anuncia una nueva versión (Overseerr, Jellyseerr)

Los contadores guardan su historial: un gráfico de las solicitudes pendientes muestra cuánto tiempo espera su familia.

El dispositivo Ombi tiene las mismas funciones, salvo Solicitudes fallidas y Actualización disponible: Ombi no tiene estado de fallo y no anuncia sus actualizaciones. Su total es la suma de lo que Ombi cuenta (pendientes, aprobadas, disponibles, rechazadas).

Disparadores de escena​

  • Nueva solicitud: alguien ha solicitado una película o una serie. Filtros: servidor, películas o series, estado (pendiente de aprobación, o aprobada directamente para los usuarios con ese permiso), solicitante. Información transmitida a la escena: título, película o serie, solicitante, estado, temporadas, solicitud en 4K, número de la solicitud.
  • Solicitud disponible: una película solicitada, o todas las temporadas solicitadas de una serie, ya está en la mediateca. Filtros: servidor, películas o series, solicitante. Información: título, película o serie, solicitante, solicitud en 4K.
  • Nuevo problema notificado: un usuario ha notificado un problema con una película o un episodio. Filtros: servidor, películas o series, tipo (vídeo, audio, subtítulos, otro). Información: título, tipo, quién lo notificó, su mensaje, temporada y episodio.

Cada evento se anuncia una vez, también tras un reinicio de la integración: lo que ya conocía no se vuelve a anunciar. Una solicitud o un problema creado más de una hora antes de su lectura (la integración estaba detenida) no se anuncia como nuevo; una llegada siempre.

Ombi envía los mismos tres eventos, con la misma información. Sus tipos de problema son las categorías creadas por su administrador: se reconoce una categoría que nombre el vídeo, el audio o los subtítulos, cualquier otra se transmite como «otro».

Acciones de escena​

Necesitan Permitir aprobar y rechazar; si no, fallan con un mensaje que indica dónde activarlo.

  • Aprobar la última solicitud: aprueba la solicitud pendiente más reciente, en un servidor o en cualquiera, películas, series o ambas. El servidor la envía entonces a Sonarr o Radarr, como cuando la aprueba en su interfaz.
  • Rechazar la última solicitud: la rechaza. Una solicitud rechazada todavía puede aprobarse más tarde en la interfaz de Overseerr o Jellyseerr.

Resultados transmitidos a las acciones siguientes: si se encontró una solicitud (que no haya ninguna pendiente no es un error), su título, su solicitante, película o serie.

En Ombi, las acciones aprueban o rechazan la solicitud mediante su API, como su interfaz; una solicitud rechazada puede aprobarse más tarde.

Widget​

Solicitudes de medios: tres casillas (por aprobar, en curso, problemas abiertos), las ocho solicitudes más recientes con su póster, su solicitante y su estado (pendiente, aprobada, parcial, disponible, rechazada, fallida), y una fila por servidor con su versión. Todos los servidores, o el elegido en la configuración del widget.

Con Permitir aprobar y rechazar, una leyenda nombra la solicitud pendiente más reciente y dos botones actúan sobre ella: Aprobar y Rechazar, cada uno pidiendo antes una confirmación.

Los pósteres vienen del propio servidor (su caché de imágenes): ni su navegador ni la integración contactan con TMDB.

Ombi no guarda los pósteres (su interfaz los carga desde TMDB): las solicitudes de un Ombi se muestran sin póster.

Ejemplos de escenas​

  • Avisar al solicitante: disparador «Solicitud disponible», solicitante alice; acción «Enviar un mensaje» a Alice, con el título elegido en la información de la escena: «… ya está disponible, ¡que lo disfrute!».
  • Aprobar las solicitudes de los niños durante el día: disparador «Nueva solicitud», estado pendiente de aprobación, solicitante leo; condición: entre las 9:00 y las 20:00; acción «Aprobar la última solicitud».
  • Un problema de subtítulos: disparador «Nuevo problema notificado», tipo Subtítulos; acción «Enviar un mensaje» al administrador con el título y el mensaje.
  • Resumen matinal: cada día a las 8:00, enviar el valor de «Solicitudes pendientes de aprobación» cuando sea mayor que 0.

Los ejemplos funcionan igual con un Ombi: elija su dispositivo en el filtro «Servidor».

Uso de la API​

  • Todo se queda en su red: la integración solo habla con la API local de su servidor, con la clave de API en la cabecera X-Api-Key (nunca en una dirección, nunca en los registros).
  • Una lectura = dos peticiones pequeñas (/request/count, /issue/count). La lista de las 50 solicitudes más recientes y de los 20 últimos problemas solo se lee cuando esos contadores cambian, y cada 10 minutos de todos modos; la versión una vez por hora. Cada lectura de la lista hace que el servidor pida a Sonarr y Radarr sus perfiles de calidad: mantenga un intervalo de actualización razonable.
  • Los títulos y pósteres se piden al servidor (que los pide una vez a TMDB y los guarda), solo para las solicitudes más recientes y los eventos.
  • La integración guarda en /data/seerr-state.json los últimos números de solicitud y de problema vistos y las solicitudes que esperan su medio. Ni contraseña ni clave.

Ombi: la clave viaja en la cabecera ApiKey. Una lectura = /Request/count y /Issues/count; cuando cambian, y cada 10 minutos, las 50 solicitudes de películas y las 50 de series más recientes, y los problemas. Los títulos llegan con las solicitudes: no se pide nada más a Ombi.

Solución de problemas​

  • «clave de API rechazada»: vuelva a copiar la clave desde Settings → General. Una clave nueva generada en el servidor invalida la anterior.

  • «no responde»: compruebe la dirección y el puerto (5055 por defecto), y que Gladys pueda acceder al servidor (misma red, cortafuegos, red Docker).

  • «certificado rechazado»: marque Aceptar certificados autofirmados, o use la dirección http:// de su red.

  • «la dirección redirige»: introduzca la dirección final, con su base de URL.

  • Títulos mostrados como «Película n.º 550»: el servidor no pudo acceder a TMDB en ese momento; los títulos vuelven solos unos minutos después.

  • Ningún evento: los eventos se refieren a lo que ocurre después del inicio de la integración; ejecute Probar la conexión para ver lo que responde el servidor. Para más detalle, configure LOG_LEVEL=debug en la integración y lea sus registros.

  • «no hay ninguna API de Ombi en esta dirección» (Ombi): la dirección responde, pero no con la API de Ombi: compruebe el puerto (3579 por defecto) y la base de URL configurada en Ombi.

Limitaciones​

  • Solo se siguen hasta su llegada las 50 solicitudes más recientes: en una instalación con más solicitudes pendientes a la vez, las más antiguas no se anuncian a su llegada.

  • Una serie se anuncia disponible cuando todas las temporadas de la solicitud están en la mediateca; una solicitud de una temporada de una serie ya presente en parte se anuncia del mismo modo.

  • Sin webhook: Overseerr puede enviar notificaciones, pero Gladys ejecuta la integración sin puerto de entrada. Un evento aparece por tanto en un intervalo de actualización (la llegada de una temporada: en 10 minutos como máximo).

  • La aprobación actúa como el administrador del servidor (la clave de API); un rechazo nunca elimina nada. No se realiza ningún otro cambio en el servidor.

  • El filtro por solicitante compara el nombre exactamente como lo muestra Overseerr.

  • Sin relación con los proyectos Overseerr, Jellyseerr o Seerr.

  • Ombi: no se sigue la parte 4K de una solicitud de película (solo la solicitud normal), sin póster, sin estado de fallo, sin indicador de actualización. Ombi responde «Request successfully deleted» cuando rechaza una solicitud: la solicitud permanece, rechazada.

  • Sin relación con el proyecto Ombi.

Parámetros de configuración​

Estos son los parámetros que Overseerr / Jellyseerr / Ombi te pide en su pantalla de configuración en Gladys.

ParámetroTipoObligatorioDescripción
Overseerr / JellyseerrsectionNoDirección y clave de API de su Overseerr, Jellyseerr o Seerr (Settings → General → API Key).
DirecciónstringNoDirección IP o nombre con el puerto, y la base de URL si la hay (p. ej. http://192.168.1.2:5055).
Clave de APIsecretNoSettings → General → API Key. Actúa como el administrador del servidor.
NombrestringNoNombre del dispositivo en Gladys. Vacío: el nombre de la aplicación seguido de la dirección.
Segundo servidor (opcional)sectionNoLos mismos campos, para otro servidor (una instancia 4K, un Jellyseerr junto a un Overseerr…).
DirecciónstringNoDirección IP o nombre con el puerto, y la base de URL si la hay (p. ej. http://192.168.1.2:5055).
Clave de APIsecretNoSettings → General → API Key. Actúa como el administrador del servidor.
NombrestringNoNombre del dispositivo en Gladys. Vacío: el nombre de la aplicación seguido de la dirección.
Ombi (opcional)sectionNoDirección y clave de API de su Ombi v4 (Settings → Ombi → API Key).
DirecciónstringNoDirección IP o nombre con el puerto, y la base de URL si la hay (p. ej. http://192.168.1.2:3579).
Clave de APIsecretNoSettings → Ombi → API Key. Actúa como un administrador de Ombi.
NombrestringNoNombre del dispositivo en Gladys. Vacío: Ombi seguido de la dirección.
OpcionessectionNo
Permitir aprobar y rechazarbooleanNoPermite que las escenas y el widget aprueben o rechacen la última solicitud pendiente. Desactivado: Gladys solo lee.
Aceptar certificados autofirmadosbooleanNoPara direcciones https:// servidas con su propio certificado. Márquelo solo para sus propios servidores.
Intervalo de actualizaciónselectNoCon qué frecuencia se leen los servidores: contadores, nuevas solicitudes, llegadas, problemas.
Idioma de los textosselectNoNombres de las funciones al añadir un dispositivo, títulos de las películas, palabras enviadas a las escenas.

Cómo instalar Overseerr / Jellyseerr / Ombi en Gladys​

  1. En Gladys, abre Integraciones: Overseerr / Jellyseerr / Ombi aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
  2. Haz clic en Instalar. Gladys descarga la imagen Docker (ghcr.io/guim31/gladys-seerr:1.1.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración).
  3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
  4. También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-seerr.

Overseerr / Jellyseerr / Ombi requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.

¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.

Sobre las integraciones externas​

Overseerr / Jellyseerr / Ombi es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene guim31, no el equipo principal de Gladys.

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂
Última actualización en