Integración domótica Komga, gratuita y de código abierto
Su servidor de cómics y mangas Komga en Gladys: nuevas series y tomos, lecturas en curso, escaneos.
Publicado por guim31
- Dispositivos
- Versión 1.0.0
- Requiere Gladys >=5.1.0
- ★ 0
Conecte su servidor Komga (cómics, manga, libros, autoalojado) a Gladys: las cifras de sus bibliotecas, sus series en curso y los tomos leídos hoy, las últimas novedades con sus portadas en el panel, y escenas que reaccionan cuando llega una nueva serie o un nuevo tomo, o cuando termina una serie.
La integración se ha probado con un servidor Komga 1.29.1 real (la imagen Docker oficial), todavía no en una instalación real de Gladys: sus comentarios son bienvenidos en el foro de Gladys o en las issues.
Requisitos
- Gladys Assistant 5.1.0 o posterior.
- Un servidor Komga accesible desde Gladys: en su red, o en Internet detrás de un proxy inverso. Probado con Komga 1.29.
- Una clave de API de su cuenta Komga (Komga 1.12 y posteriores): en Komga, Ajustes de la cuenta → Claves de API, cree una clave y cópiela. En un Komga más antiguo sirven el correo y la contraseña de la cuenta. La integración ve lo que ve esa cuenta: sus bibliotecas, su progreso de lectura.
- Una cuenta de administrador da además la versión de Komga y permite los escaneos de bibliotecas; una cuenta de lector basta para todo lo demás.
Configuración
- Instale la integración desde el catálogo de Gladys.
- En Configuración, introduzca la URL del servidor con su puerto (por
ejemplo
http://192.168.1.20:25600; detrás de un proxy inverso,https://example.org/komga) y la clave de API (o, en un Komga más antiguo, el Correo y la Contraseña de la cuenta). - Si lo desea, elija la frecuencia de lectura del servidor (cada 5 minutos por defecto) y el idioma de los nombres.
- Guarde y haga clic en Probar la conexión: muestra la versión, la cuenta (administrador o lector) y las cifras encontradas.
- En la pestaña Descubrimiento, añada el dispositivo Komga.
Dispositivo
Komga (un dispositivo para el servidor, visto desde su cuenta):
| Funcionalidad | Significado |
|---|---|
| En línea | 1 mientras la integración lee el servidor |
| Bibliotecas | bibliotecas visibles para su cuenta |
| Series | series de esas bibliotecas |
| Tomos | tomos (volúmenes, números) de esas bibliotecas |
| Series en curso | series empezadas y no terminadas |
| Tomos leídos hoy | tomos terminados hoy (entre los 20 últimos leídos) |
| Versión | versión de Komga (solo cuenta de administrador) |
Panel
- Komga: novedades: una cuadrícula de las últimas series añadidas, con sus portadas, la fecha, la biblioteca y el número de tomos, el número de series y de tomos y (cuenta de administrador) un botón Escanear bibliotecas, el mismo que la acción de escena de abajo.
- Komga: seguir leyendo: sus tomos en curso con sus portadas, la página alcanzada y el progreso, el número de series en curso y los tomos leídos hoy.
Escenas
Disparadores
- Nueva serie añadida: una nueva serie (cómic, manga, libro) aparece en una biblioteca tras un escaneo. Filtro: la biblioteca, exactamente como aparece en Komga. Información: título de la serie, biblioteca, número de tomos.
- Nuevo tomo: se añade un nuevo tomo (volumen, número) a una serie que ya está en Komga. Filtro: la serie que sigue, su título exactamente como aparece en Komga. Información: título de la serie, título del tomo, biblioteca.
- Serie leída hasta el final: termina el último tomo sin leer de una serie, o marca la serie como leída. Filtro: la biblioteca. Información: título de la serie, biblioteca, número de tomos.
Acciones
- Escanear bibliotecas de Komga: Komga busca archivos nuevos en una biblioteca (su nombre, sin distinguir mayúsculas) o en todas; el escaneo se hace en segundo plano y las nuevas series llegan unos segundos después. Solo con cuenta de administrador. Resultado: el número de bibliotecas escaneadas.
- Leer las últimas novedades de Komga: una frase para una notificación o un altavoz, por ejemplo «2 serie(s) nueva(s) en Komga en los últimos 7 días: Blue Skies y Green Leaf.» Resultados: la frase, el número de series nuevas, el título de la última (12 series como máximo).
Ideas de escenas
- Nuevo tomo de mi manga: cuando Nuevo tomo con su serie, enviar la notificación «Nuevo tomo de {series}: {title}».
- Resumen del domingo: cada domingo a las 10 h, Leer las últimas novedades de Komga y enviar la frase como mensaje.
- Después de las descargas: cada noche a las 3 h, Escanear bibliotecas de Komga, para que los archivos que dejan sus herramientas de descarga estén ahí por la mañana.
Solución de problemas
- «el servidor no responde»: compruebe la dirección y el puerto desde la
máquina de Gladys. Gladys ejecuta la integración en un contenedor:
localhostes el propio contenedor, use la dirección IP de la máquina. - «clave de API o contraseña rechazada»: la clave se eliminó en Komga, o la contraseña cambió; cree una clave nueva.
- «esta cuenta no es de administrador»: el escaneo requiere una cuenta de administrador.
- «no hay ningún servidor Komga en esta dirección» o «la dirección
redirige»: un servidor detrás de un proxy inverso necesita su ruta base
(
https://example.org/komga); una página de inicio de sesión del proxy bloquea la API. - «certificado rechazado»: HTTPS con un certificado autofirmado no está
soportado; use la dirección
http://de su red. - La integración solo registra su ciclo de vida; con
LOG_LEVEL=debug, registra también cada evento, con los títulos.
Limitaciones
- El servidor se lee cada 1 a 15 minutos. La integración escucha también los eventos de Komga (un tomo o una serie añadidos, un progreso de lectura) para volver a leerlo en pocos segundos; un proxy inverso que retenga esos eventos solo retrasa las escenas hasta la siguiente lectura.
- Como máximo 10 eventos de un mismo tipo por lectura (un primer gran escaneo anuncia 10 series, no cientos). Los tomos añadidos hace más de 24 horas no se anuncian (un Gladys parado dos días no los repite).
- Serie leída hasta el final y Tomos leídos hoy siguen los 20 últimos tomos leídos.
- Una cuenta de Komga y un servidor por instalación de la integración.
- Sin relación con el proyecto Komga.
Parámetros de configuración
Estos son los parámetros que Komga te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Conexión a su servidor Komga | section | No | Introduzca la dirección (p. ej. http://192.168.1.20:25600) y una clave de API de su cuenta: en Komga, Ajustes de la cuenta > Claves de API (Komga 1.12+). Servidores antiguos: el correo y la contraseña en su lugar. Una cuenta admin da también la versión y los escaneos. |
| URL del servidor | string | Sí | Dirección del servidor, puerto incluido (25600 por defecto). También funciona una dirección https detrás de un proxy inverso, con su ruta base. |
| Clave de API | secret | No | Recomendado. Déjelo vacío para usar el correo y la contraseña de abajo. |
| Correo (sin clave de API) | string | No | Solo para un Komga anterior a la 1.12: el correo con el que inicia sesión. |
| Contraseña (sin clave de API) | secret | No | |
| Actualización | select | No | Frecuencia de lectura del servidor (unas siete peticiones ligeras cada vez). Los nuevos tomos y las lecturas adelantan también la siguiente lectura. |
| Idioma de los nombres | select | No | Idioma de los nombres de las funcionalidades y de los textos de las acciones de escena. Los nombres se fijan al crear un dispositivo: para cambiarlos, elimine el dispositivo y vuelva a añadirlo. |
Cómo instalar Komga en Gladys
- En Gladys, abre Integraciones: Komga aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/guim31/gladys-komga:1.0.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-komga.
Komga 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
Komga 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.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación