Integración domótica Calibre-Web, gratuita y de código abierto

Su biblioteca Calibre-Web en Gladys: libros, autores, series, una escena por cada libro nuevo.
Conecte su biblioteca Calibre-Web (la interfaz web de una biblioteca de libros electrónicos Calibre, autoalojada) a Gladys: el número de libros, autores y series, el último libro añadido, las últimas novedades con sus portadas en el panel y un evento de escena por cada libro nuevo. Calibre-Web Automated funciona de la misma manera.
La integración se probó con servidores reales de Calibre-Web 0.6.27 y Calibre-Web Automated (sus imágenes Docker), 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 Calibre-Web o Calibre-Web Automated accesible desde Gladys, en su red (o detrás de un proxy inverso).
- Un usuario de Calibre-Web y su contraseña. La integración lee el catálogo OPDS de Calibre-Web como este usuario: ve los libros que él ve. Basta con una cuenta de lector; una cuenta dedicada es buena idea. Si la navegación anónima está activada en el servidor, el usuario puede quedar vacío.
- En los ajustes de este usuario, la lista Añadidos recientemente debe seguir visible (lo está por defecto).
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:8083; detrás de un proxy inverso,https://example.org/books), el Usuario y la Contraseña. - 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: indica el servidor (Calibre-Web o Calibre-Web Automated), el usuario y los números encontrados.
- En la pestaña Descubrimiento, añada el dispositivo Calibre-Web.
Dispositivo
Calibre-Web (un dispositivo para el servidor, visto por el usuario configurado):
| Funcionalidad | Significado |
|---|---|
| En línea | 1 mientras la integración lee el servidor |
| Libros | libros de la biblioteca |
| Autores | autores con al menos un libro |
| Series | series con al menos un libro |
| Último libro añadido | título y autores del último libro añadido («Título — Autor») |
Si la lista de autores o de series está oculta para el usuario (ajustes del usuario en Calibre-Web), su número queda vacío.
Panel
- Calibre-Web: novedades: una cuadrícula de los 12 últimos libros añadidos, con sus portadas y autores, y el número de libros y de autores. El ajuste Mostrar el número de libros y autores oculta estas dos cifras.
Escenas
Disparadores
- Nuevo libro añadido: un nuevo libro aparece en la biblioteca de Calibre
(subido en Calibre-Web, añadido con Calibre o importado por Calibre-Web
Automated). Filtro: el autor, exactamente como aparece en Calibre-Web (varios
autores:
Autor Uno, Autor Dos). Información: título del libro, autor(es).
No se anuncia nada en el primer arranque: los libros ya presentes son el punto de partida.
Acciones
- Leer las últimas novedades de Calibre-Web: una frase para una notificación o un altavoz, por ejemplo «2 libro(s) nuevo(s) en Calibre-Web en los últimos 7 días: Pride and Prejudice (Jane Austen) y Twenty Years After (Alexandre Dumas).» Resultados: la frase, el número de libros nuevos, el título del último (entre la primera página de «Añadidos recientemente», 60 libros por defecto).
Ideas de escenas
- Un libro nuevo de mi autor favorito: cuando Nuevo libro añadido con el autor indicado, enviar una notificación «Nuevo libro: {title}».
- Resumen del domingo: cada domingo a las 10, Leer las últimas novedades de Calibre-Web y enviar la frase como mensaje.
- Biblioteca familiar: cuando Nuevo libro añadido, decir «Hay un libro nuevo en la biblioteca: {title}» en el altavoz del salón.
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. - «usuario o contraseña rechazados»: compruébelos iniciando sesión en Calibre-Web. Un servidor sin navegación anónima necesita un usuario.
- «la lista «Añadidos recientemente» está oculta para este usuario»: en Calibre-Web, Administración → el usuario → vuelva a mostrar «Añadidos recientemente».
- «no hay ningún catálogo Calibre-Web (OPDS) en esta dirección» o «la
dirección redirige»: un servidor detrás de un proxy inverso necesita su
ruta base (
https://example.org/books); una página de inicio de sesión del proxy bloquea el catálogo. - «certificado rechazado»: HTTPS con un certificado autofirmado no está
soportado; use la dirección
http://de su red. - Sin portada en el widget: el libro no tiene, o Calibre-Web sirve una portada de más de 300 KB (Calibre-Web envía la portada completa, Calibre-Web Automated una miniatura): se omite.
- La integración solo registra su ciclo de vida; con
LOG_LEVEL=debug, registra también cada libro nuevo, con su título.
Limitaciones
- Calibre-Web no tiene API para integraciones: todo viene de su catálogo OPDS, el de los lectores electrónicos. El servidor se lee cada 1 a 15 minutos (una petición ligera); un libro nuevo llega a Gladys en ese intervalo.
- El catálogo OPDS no da totales: la integración los encuentra leyendo algunas páginas de cada lista (unas 2 × log2(páginas) peticiones), al arrancar, cada hora y cuando cambian los libros recientes.
- El progreso de lectura, las descargas y la página de estadísticas de Calibre-Web no son accesibles por OPDS sin imitar un navegador: no se leen.
- Como máximo 10 eventos por lectura (una primera gran importación anuncia 10 libros, no cientos), entre los libros de la primera página de «Añadidos recientemente» (60 por defecto).
- Un servidor Calibre-Web y un usuario por instalación de la integración.
- Sin relación con los proyectos Calibre-Web y Calibre.
Parámetros de configuración
Estos son los parámetros que Calibre-Web te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Conexión a su servidor Calibre-Web | section | No | Introduzca la dirección del servidor (por ejemplo http://192.168.1.20:8083), un usuario de Calibre-Web y su contraseña. La integración lee el catálogo OPDS: Calibre-Web Automated también funciona. Deje el usuario vacío si la navegación anónima está activada. |
| URL del servidor | string | Sí | Dirección del servidor, puerto incluido (8083 por defecto). También funciona una dirección https detrás de un proxy inverso, con su ruta base. |
| Usuario | string | No | Un usuario de Calibre-Web: la integración ve los libros que ve este usuario. Basta con una cuenta de lector. |
| Contraseña | secret | No | |
| Actualización | select | No | Frecuencia de lectura del servidor (una petición ligera; los recuentos una vez por hora o tras un libro nuevo). |
| Idioma de los nombres | select | No | Idioma de los nombres de las funcionalidades y de la frase de la acción de escena. Los nombres se fijan al crear un dispositivo: para cambiarlos, elimine el dispositivo y vuelva a añadirlo. |
Cómo instalar Calibre-Web en Gladys
- En Gladys, abre Integraciones: Calibre-Web 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-calibre-web: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-calibre-web.
Calibre-Web 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
Calibre-Web 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