Saltar al contenido principal

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

Integración Calibre-Web para Gladys Assistant

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​

  1. Instale la integración desde el catálogo de Gladys.
  2. 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.
  3. Si lo desea, elija la frecuencia de lectura del servidor (cada 5 minutos por defecto) y el idioma de los nombres.
  4. 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.
  5. En la pestaña Descubrimiento, añada el dispositivo Calibre-Web.

Dispositivo​

Calibre-Web (un dispositivo para el servidor, visto por el usuario configurado):

FuncionalidadSignificado
En línea1 mientras la integración lee el servidor
Libroslibros de la biblioteca
Autoresautores con al menos un libro
Seriesseries con al menos un libro
Último libro añadidotí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: localhost es 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ámetroTipoObligatorioDescripción
Conexión a su servidor Calibre-WebsectionNoIntroduzca 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 servidorstringSí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.
UsuariostringNoUn usuario de Calibre-Web: la integración ve los libros que ve este usuario. Basta con una cuenta de lector.
ContraseñasecretNo
ActualizaciónselectNoFrecuencia de lectura del servidor (una petición ligera; los recuentos una vez por hora o tras un libro nuevo).
Idioma de los nombresselectNoIdioma 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​

  1. En Gladys, abre Integraciones: Calibre-Web 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-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).
  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-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.

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 🙂