Piwigo Smart-Home-Integration, kostenlos und Open Source
Deine Piwigo-Fotogalerie in Gladys: Zähler, verfolgte Alben, neue Fotos in Szenen, Widget.
Veröffentlicht von guim31
- Geräte
- Version 1.0.0
- Erfordert Gladys >=5.1.0
- ★ 0
Deine Piwigo-Fotogalerie in Gladys, über dein lokales Netzwerk: die Anzahl der Fotos, Alben und Benutzer, das zuletzt hinzugefügte Foto, ein Gerät pro Album, das du verfolgen willst, Szenen, die auf neue Fotos oder ein wachsendes Album reagieren, eine Szenenaktion, die die letzten Fotos liest, und ein Dashboard-Widget mit den neuesten Fotos.
Die Integration wurde mit einer echten Piwigo-Galerie getestet (das
Docker-Image linuxserver/piwigo, Piwigo 16.4.0), aber noch nicht in einer
echten Gladys-Installation: Rückmeldungen sind willkommen im
Gladys-Forum oder in den
Issues.
Was du brauchst
- Gladys Assistant 5.1.0 oder neuer.
- Eine Piwigo-Galerie, die von Gladys aus erreichbar ist (gleiches Netzwerk).
- Am besten einen API-Schlüssel (Piwigo 16 oder neuer): Öffne in Piwigo
dein Profil, API-Schlüssel, lege einen an und kopiere den ganzen
Schlüssel: seine Kennung, einen Doppelpunkt, sein Geheimnis
(
pkid-20261025-…:…). Der Schlüssel handelt wie sein Konto: Ein Administrator-Schlüssel liefert auch die Anzahl der Benutzer. - Sonst Benutzername und Passwort eines Kontos (jede Piwigo-Version mit Web-API).
- Ohne beides liest die Integration die Galerie als Gast: nur öffentliche Alben.
Einrichtung
- Installiere die Integration aus dem Gladys-Katalog.
- Gib in der Konfiguration die Adresse der Galerie mit Port und Ordner
ein (zum Beispiel
http://192.168.1.20/piwigo; eine aus dem Browser kopierte Seite der Galerie geht auch) und füge den API-Schlüssel ins Passwortfeld ein, den Benutzernamen leer. Mit einem Konto gibst du stattdessen Benutzername und Passwort ein. - Optional trägst du die Zu verfolgenden Alben ein: Namen oder IDs durch
Kommas getrennt (
Urlaub, 12); ein Unteralbum über seinen Pfad (Urlaub / Strand). Die ID ist die Zahl am Ende der Albumadresse (index.php?/category/12): Verwende sie für einen Namen mit Komma. - Wähle die Aktualisierung (standardmäßig 5 Minuten) und die Sprache der Namen und speichere. Verbindung testen liest die Galerie sofort und meldet die nicht gefundenen Alben.
- Füge unter Erkennung das Gerät Piwigo und die gewünschten Albumgeräte hinzu.
Geräte
Das Gerät Piwigo zeigt die ganze Galerie (nur lesend):
| Funktion | Was sie zeigt |
|---|---|
| Fotos | Fotos, die das Konto sehen kann |
| Alben | Alben, die das Konto sehen kann, Unteralben inbegriffen |
| Benutzer | Benutzer der Galerie (nur Administrator-Konto oder -Schlüssel) |
| Zuletzt hinzugefügtes Foto | Name, Album und Tag: Sonnenuntergang · Urlaub · 25. Okt. 2026 |
Jedes verfolgte Album ergibt ein Gerät Piwigo – Albumpfad:
| Funktion | Was sie zeigt |
|---|---|
| Fotos | Fotos des Albums und seiner Unteralben |
| Letzte Ergänzung | Tag und Uhrzeit des zuletzt hinzugefügten Fotos: 25. Okt. 2026, 07:50 |
Die Integration liest die Galerie selbst (drei oder vier kleine Anfragen pro Abfrage): Auf der Gladys-Seite ist nichts einzustellen. Das Verbindungssymbol der Geräte wird rot, wenn die Galerie nicht mehr antwortet.
Dashboard
Das Widget Neueste Fotos zeigt die Zähler (Fotos, Alben, Benutzer) und die zuletzt hinzugefügten Fotos: Name, Album, Tag; ein Tippen zeigt die Uhrzeit des Hinzufügens und den Aufnahmetag. Mit der Einstellung Verfolgtes Album zeigt es eines deiner verfolgten Alben statt der ganzen Galerie.
Vorschaubilder sind standardmäßig aus: Mit der Einstellung Vorschaubilder anzeigen erscheint das kleine Vorschaubild jedes Fotos, und deine Fotos sind dann auf jedem Bildschirm zu sehen, der dieses Dashboard zeigt (ein geteiltes Tablet, ein öffentliches Dashboard, Gladys Plus). Der Browser lädt Piwigo nie direkt: Gladys fragt die Integration, die nur die Fotos der Widget-Liste ausliefert.
Szenen
Auslöser
- Neue Fotos hinzugefügt: Der Galerie wurden Fotos hinzugefügt, egal auf welchem Weg (Web-Upload, mobile App, Synchronisierung), bei der nächsten Abfrage erkannt. Variablen: Anzahl hinzugefügter Fotos, Name, Album, Hinzufügedatum und Seite des letzten.
- Fotos zu einem Album hinzugefügt: Ein Album (mit Unteralben) enthält mehr Fotos als bei der letzten Abfrage (ein neues Album zählt ab null). Filter: der Albumname, genau wie in Piwigo, ohne übergeordnete Alben. Variablen: Name, Pfad und ID des Albums, hinzugefügte Fotos, Fotos im Album, Seite des Albums. Ein Foto in einem Unteralbum löst diesen Auslöser auch für die übergeordneten Alben aus.
Aktionen
- Letzte Fotos lesen: liest sofort die zuletzt hinzugefügten Fotos der ganzen Galerie oder eines Albums (Name, Pfad oder ID; Unteralben inbegriffen). Ausgaben für die nächsten Aktionen der Szene: in 24 Stunden hinzugefügte Fotos, Fotos insgesamt, Name, Album, Hinzufügedatum und Seite des letzten. In Piwigo ändert sich nichts.
Szenenideen
- Bei Neue Fotos hinzugefügt schickst du der Familie eine Nachricht: „{{count}} neue Fotos, das letzte: {{name}} in {{album}}“.
- Jeden Abend um 21 Uhr Letzte Fotos lesen für das Album „Familie“, und wenn In 24 Stunden hinzugefügte Fotos über 0 liegt, eine Nachricht auf dem Wohnzimmer-Tablet zeigen.
- Bei Fotos zu einem Album hinzugefügt „Urlaub 2026“ den Flur blau einschalten.
Fehlerbehebung
- „API-Schlüssel, Benutzername oder Passwort abgelehnt“: Der Schlüssel ist abgelaufen, wurde widerrufen oder nicht ganz eingefügt (Kennung, Doppelpunkt, Geheimnis); prüfe bei einem Konto das Passwort.
- „die Galerie antwortet nicht“: Prüfe Adresse, Port und Ordner vom Gladys-Rechner aus.
- „keine Piwigo-Galerie unter dieser Adresse“: Die Adresse führt zu einer anderen Seite (Anmeldeseite eines Reverse-Proxys, andere Anwendung): Gib die Adresse der Galerie selbst ein.
- „Zertifikat abgelehnt“: ein selbstsigniertes Zertifikat; verwende die
http://-Adresse in deinem Netzwerk. - Neue Fotos erscheinen nicht: Piwigo kann die über die mobile App oder die Web-API gesendeten Fotos in einem Warteraum (der „Lounge“) halten, bis der Upload fertig ist; sie erscheinen bei der nächsten Abfrage danach.
- Die Anzahl der Benutzer bleibt leer: Das Konto oder der Schlüssel ist kein Administrator.
LOG_LEVEL=debugin den Protokollen der Integration zeigt jede Abfrage.
Grenzen
- Neue Fotos werden bei der nächsten Abfrage erkannt (standardmäßig 5 Minuten), und nur die, die das Konto sehen kann.
- Die Integration liest nur: In Piwigo wird nichts geändert, hochgeladen oder gelöscht.
- Kein Foto verlässt dein Netzwerk über die Integration, außer du schaltest die Vorschaubilder des Widgets ein.
- Die Daten sind die des Piwigo-Servers, so wie er sie anzeigt.
- Nicht mit dem Piwigo-Projekt verbunden.
Konfigurationseinstellungen
Diese Einstellungen fragt Piwigo in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Verbindung zu deiner Piwigo-Galerie | section | Nein | Gib die Adresse der Galerie und einen API-Schlüssel ein (Piwigo 16: dein Profil > API-Schlüssel, den ganzen Schlüssel ins Passwortfeld), oder Benutzername und Passwort eines Kontos. Ein Admin-Konto zeigt auch die Benutzer. Leer: nur öffentliche Alben. |
| Adresse der Galerie | string | Ja | Adresse der Galerie mit Port und Ordner. Eine https-Adresse hinter einem Reverse-Proxy geht auch. |
| Benutzername (ohne API-Schlüssel) | string | Nein | Mit einem ganzen API-Schlüssel leer lassen. Ausgefüllt: Das Passwort darunter ist das dieses Kontos. |
| API-Schlüssel (oder Kontopasswort) | secret | Nein | |
| Zu verfolgende Alben | string | Nein | Namen oder IDs der Alben, die als Geräte verfolgt werden, durch Kommas getrennt (Urlaub, 12). Ein Unteralbum über seinen Pfad: Urlaub / Strand. Leer: keines. |
| Aktualisierung | select | Nein | Wie oft die Galerie gelesen wird (drei oder vier kleine Anfragen). |
| Sprache der Namen | select | Nein | Sprache der Funktionsnamen, des Textes zum letzten Foto und der Fehler der Szenenaktion. Die Namen werden beim Anlegen des Geräts festgelegt: Lösche das Gerät und füge es erneut hinzu, um sie zu ändern. |
So installierst du Piwigo in Gladys
- Öffne in Gladys Integrationen: Piwigo erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-piwigo: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-piwigo.
Piwigo 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
Piwigo 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