Calibre-Web Smart-Home-Integration, kostenlos und Open Source

Deine Calibre-Web-Bibliothek in Gladys: Bücher, Autoren, Serien, eine Szene für jedes neue Buch.
Verbinde deine Calibre-Web-Bibliothek (die Weboberfläche einer selbst gehosteten Calibre-E-Book-Bibliothek) mit Gladys: die Zahl der Bücher, Autoren und Serien, das zuletzt hinzugefügte Buch, die neuesten Zugänge mit ihren Covern auf dem Dashboard und ein Szenen-Ereignis für jedes neue Buch. Calibre-Web Automated funktioniert genauso.
Die Integration wurde mit echten Calibre-Web-0.6.27- und Calibre-Web-Automated-Servern (ihren Docker-Images) getestet, noch nicht in einer echten Gladys-Installation: Rückmeldungen sind willkommen im Gladys-Forum oder in den Issues.
Voraussetzungen
- Gladys Assistant 5.1.0 oder neuer.
- Ein Calibre-Web- oder Calibre-Web-Automated-Server, den Gladys erreicht, in deinem Netzwerk (oder hinter einem Reverse Proxy).
- Ein Calibre-Web-Benutzer und sein Passwort. Die Integration liest den OPDS-Katalog von Calibre-Web als dieser Benutzer und sieht so die Bücher, die er sieht. Ein Leserkonto genügt; ein eigenes Konto ist eine gute Idee. Ist anonymes Stöbern auf dem Server aktiv, kann der Benutzer leer bleiben.
- In den Einstellungen dieses Benutzers muss die Liste Kürzlich hinzugefügt sichtbar bleiben (Standard).
Einrichtung
- Installiere die Integration aus dem Gladys-Katalog.
- Gib unter Konfiguration die Server-URL mit Port ein (zum Beispiel
http://192.168.1.20:8083; hinter einem Reverse Proxyhttps://example.org/books), den Benutzer und das Passwort. - Wähle bei Bedarf, wie oft der Server gelesen wird (standardmäßig alle 5 Minuten), und die Sprache der Namen.
- Speichere und klicke auf Verbindung testen: Es zeigt den Server (Calibre-Web oder Calibre-Web Automated), den Benutzer und die gefundenen Zahlen.
- Füge im Tab Entdecken das Gerät Calibre-Web hinzu.
Gerät
Calibre-Web (ein Gerät für den Server, aus Sicht des eingestellten Benutzers):
| Funktion | Bedeutung |
|---|---|
| Online | 1, solange die Integration den Server liest |
| Bücher | Bücher der Bibliothek |
| Autoren | Autoren mit mindestens einem Buch |
| Serien | Serien mit mindestens einem Buch |
| Zuletzt hinzugefügtes Buch | Titel und Autoren des zuletzt hinzugefügten Buchs („Titel — Autor“) |
Ist die Autoren- oder Serienliste für den Benutzer ausgeblendet (Benutzereinstellungen in Calibre-Web), bleibt ihre Zahl leer.
Dashboard
- Calibre-Web: neu hinzugefügt: ein Raster der 12 zuletzt hinzugefügten Bücher mit Covern und Autoren sowie die Zahl der Bücher und Autoren. Die Einstellung Bücher- und Autorenzahl anzeigen blendet die beiden Zahlen aus.
Szenen
Auslöser
- Neues Buch hinzugefügt: Ein neues Buch erscheint in der
Calibre-Bibliothek (in Calibre-Web hochgeladen, mit Calibre hinzugefügt oder
von Calibre-Web Automated importiert). Filter: der Autor, genau wie in
Calibre-Web angezeigt (mehrere Autoren:
Autor Eins, Autor Zwei). Informationen: Buchtitel, Autor(en).
Beim ersten Start wird nichts gemeldet: Die schon vorhandenen Bücher sind der Ausgangspunkt.
Aktionen
- Neueste Calibre-Web-Zugänge vorlesen: ein Satz für eine Benachrichtigung oder einen Lautsprecher, zum Beispiel „2 neue(s) Buch/Bücher auf Calibre-Web in den letzten 7 Tagen: Pride and Prejudice (Jane Austen) und Twenty Years After (Alexandre Dumas).“ Ergebnisse: der Satz, die Zahl der neuen Bücher, der Titel des neuesten (unter der ersten Seite von „Kürzlich hinzugefügt“, standardmäßig 60 Bücher).
Szenen-Ideen
- Ein neues Buch meines Lieblingsautors: bei Neues Buch hinzugefügt mit ausgefülltem Autor eine Benachrichtigung „Neues Buch: {title}“ senden.
- Sonntags-Überblick: jeden Sonntag um 10 Uhr Neueste Calibre-Web-Zugänge vorlesen und den Satz als Nachricht senden.
- Familienbibliothek: bei Neues Buch hinzugefügt „Ein neues Buch ist in der Bibliothek: {title}“ über den Wohnzimmer-Lautsprecher sagen.
Fehlerbehebung
- „der Server antwortet nicht“: Prüfe Adresse und Port von der
Gladys-Maschine aus. Gladys führt die Integration in einem Container aus:
localhostist dort der Container selbst, nimm die IP-Adresse der Maschine. - „Benutzer oder Passwort abgelehnt“: Prüfe beides mit einer Anmeldung in Calibre-Web. Ein Server ohne anonymes Stöbern braucht einen Benutzer.
- „die Liste „Kürzlich hinzugefügt“ ist für diesen Benutzer ausgeblendet“: In Calibre-Web unter Verwaltung → der Benutzer → „Kürzlich hinzugefügt“ wieder einblenden.
- „kein Calibre-Web-Katalog (OPDS) unter dieser Adresse“ oder „die
Adresse leitet um“: Ein Server hinter einem Reverse Proxy braucht seinen
Basispfad (
https://example.org/books); eine Anmeldeseite des Proxys blockiert den Katalog. - „Zertifikat abgelehnt“: HTTPS mit selbst signiertem Zertifikat wird
nicht unterstützt; verwende die
http://-Adresse in deinem Netzwerk. - Kein Cover im Widget: Das Buch hat keines, oder Calibre-Web liefert ein Cover über 300 KB (Calibre-Web sendet das volle Cover, Calibre-Web Automated ein kleines Vorschaubild): Es wird weggelassen.
- Die Integration protokolliert nur ihren Lebenszyklus; mit
LOG_LEVEL=debugauch jedes neue Buch mit seinem Titel.
Einschränkungen
- Calibre-Web hat keine API für Integrationen: Alles kommt aus seinem OPDS-Katalog, dem der E-Reader. Der Server wird alle 1 bis 15 Minuten gelesen (eine leichte Anfrage); ein neues Buch erreicht Gladys in diesem Intervall.
- Der OPDS-Katalog liefert keine Summen: Die Integration ermittelt sie, indem sie einige Seiten jeder Liste liest (etwa 2 × log2(Seiten) Anfragen), beim Start, stündlich und wenn sich die neuesten Bücher ändern.
- Lesefortschritt, Downloads und die Statistikseite von Calibre-Web sind über OPDS nicht erreichbar, ohne einen Browser nachzuahmen: Die Integration liest sie nicht.
- Höchstens 10 Ereignisse pro Lesung (ein erster großer Import meldet 10 Bücher, nicht Hunderte), unter den Büchern der ersten Seite von „Kürzlich hinzugefügt“ (standardmäßig 60).
- Ein Calibre-Web-Server und ein Benutzer pro Installation der Integration.
- Keine Verbindung zu den Projekten Calibre-Web und Calibre.
Konfigurationseinstellungen
Diese Einstellungen fragt Calibre-Web in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Verbindung zu deinem Calibre-Web-Server | section | Nein | Gib die Adresse des Servers (zum Beispiel http://192.168.1.20:8083) sowie einen Calibre-Web-Benutzer und sein Passwort ein. Die Integration liest den OPDS-Katalog: Calibre-Web Automated funktioniert auch. Lass den Benutzer leer, wenn anonymes Stöbern aktiv ist. |
| Server-URL | string | Ja | Adresse des Servers mit Port (standardmäßig 8083). Eine https-Adresse hinter einem Reverse Proxy funktioniert ebenfalls, mit ihrem Basispfad. |
| Benutzer | string | Nein | Ein Calibre-Web-Benutzer: Die Integration sieht die Bücher, die dieser Benutzer sieht. Ein Leserkonto genügt. |
| Passwort | secret | Nein | |
| Aktualisierung | select | Nein | Wie oft der Server gelesen wird (eine leichte Anfrage; die Zählungen einmal pro Stunde oder nach einem neuen Buch). |
| Sprache der Namen | select | Nein | Sprache der Funktionsnamen und des Satzes der Szenenaktion. Die Namen werden beim Erstellen eines Geräts festgelegt: Um sie nach einer Änderung umzubenennen, lösche das Gerät und füge es erneut hinzu. |
So installierst du Calibre-Web in Gladys
- Öffne in Gladys Integrationen: Calibre-Web erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-calibre-web:1.0.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-calibre-web.
Calibre-Web benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Calibre-Web ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation