Intégration domotique Piwigo, gratuite et open source
Votre galerie Piwigo dans Gladys : compteurs, albums suivis, nouvelles photos en scène, widget.
Publiée par guim31
- Appareils
- Version 1.0.0
- Nécessite Gladys >=5.1.0
- ★ 0
Votre galerie photo Piwigo dans Gladys, sur votre réseau local : le nombre de photos, d'albums et d'utilisateurs, la dernière photo ajoutée, un appareil par album que vous voulez suivre, des scènes qui réagissent à l'arrivée de nouvelles photos ou à un album qui grandit, une action de scène qui lit les dernières photos, et un widget de tableau de bord avec les dernières photos.
L'intégration a été testée contre une vraie galerie Piwigo (l'image Docker
linuxserver/piwigo, Piwigo 16.4.0), pas encore dans une vraie installation de
Gladys : vos retours sont les bienvenus sur le
forum Gladys ou dans les
issues.
Ce qu'il faut
- Gladys Assistant 5.1.0 ou plus récent.
- Une galerie Piwigo joignable depuis Gladys (même réseau).
- Idéalement, une clé d'API (Piwigo 16 ou plus récent) : dans Piwigo,
ouvrez votre profil, Clés d'API, créez-en une et copiez la clé
entière : son identifiant, deux-points, son secret (
pkid-20261025-…:…). La clé agit comme son compte : une clé d'administrateur donne aussi le nombre d'utilisateurs. - Sinon, le nom et le mot de passe d'un compte (toute version de Piwigo avec l'API web).
- Sans l'un ni l'autre, l'intégration lit la galerie en invité : albums publics seulement.
Mise en place
- Installez l'intégration depuis le catalogue de Gladys.
- Dans Configuration, saisissez l'Adresse de la galerie avec son port
et son dossier (par exemple
http://192.168.1.20/piwigo; une page de la galerie copiée depuis le navigateur convient aussi) et collez la clé d'API dans le champ mot de passe, nom d'utilisateur vide. Avec un compte, saisissez plutôt son nom d'utilisateur et son mot de passe. - Si vous le souhaitez, indiquez les Albums à suivre : noms ou
identifiants séparés par des virgules (
Vacances, 12) ; un sous-album par son chemin (Vacances / Plage). L'identifiant est le nombre à la fin de l'adresse de l'album (index.php?/category/12) : utilisez-le pour un nom qui contient une virgule. - Choisissez le Rafraîchissement (5 minutes par défaut) et la Langue des noms, puis enregistrez. Tester la connexion lit la galerie tout de suite et signale les albums introuvables.
- Dans Découverte, ajoutez l'appareil Piwigo et les appareils d'album que vous voulez.
Appareils
L'appareil Piwigo montre toute la galerie (lecture seule) :
| Fonctionnalité | Ce qu'elle montre |
|---|---|
| Photos | Photos visibles par le compte |
| Albums | Albums visibles par le compte, sous-albums compris |
| Utilisateurs | Utilisateurs de la galerie (compte ou clé administrateur seulement) |
| Dernière photo ajoutée | Son nom, son album et le jour : Coucher de soleil · Vacances · 25 oct. 2026 |
Chaque album suivi donne un appareil Piwigo – chemin de l'album :
| Fonctionnalité | Ce qu'elle montre |
|---|---|
| Photos | Photos de l'album et de ses sous-albums |
| Dernier ajout | Jour et heure de la dernière photo ajoutée : 25 oct. 2026, 07:50 |
L'intégration lit la galerie elle-même (trois ou quatre petites requêtes par lecture) : rien à régler côté Gladys. Le badge de connexion des appareils passe au rouge quand la galerie ne répond plus.
Tableau de bord
Le widget Dernières photos montre les compteurs (photos, albums, utilisateurs) et les dernières photos ajoutées : nom, album, jour ; un appui montre l'heure d'ajout et le jour de prise de vue. Avec le réglage Album suivi, il montre l'un de vos albums suivis au lieu de toute la galerie.
Les miniatures sont désactivées par défaut : avec le réglage Afficher les miniatures, la petite miniature de chaque photo s'affiche, et vos photos apparaissent alors sur tout écran qui affiche ce tableau de bord (une tablette partagée, un tableau de bord public, Gladys Plus). Le navigateur ne charge jamais Piwigo directement : Gladys le demande à l'intégration, qui ne sert que les photos listées par le widget.
Scènes
Déclencheurs
- Nouvelles photos ajoutées : des photos ont été ajoutées à la galerie, quel que soit le moyen (envoi web, application mobile, synchronisation), vues à la lecture suivante. Variables : nombre de photos ajoutées, nom, album, date d'ajout et page de la dernière.
- Photos ajoutées à un album : un album, sous-albums compris, contient plus de photos qu'à la lecture précédente (un nouvel album compte depuis zéro). Filtre : le nom de l'album, exactement comme dans Piwigo, sans ses albums parents. Variables : nom, chemin et identifiant de l'album, photos ajoutées, photos dans l'album, page de l'album. Une photo ajoutée à un sous-album active aussi ce déclencheur pour ses albums parents.
Actions
- Lire les dernières photos : lit tout de suite les dernières photos ajoutées, de toute la galerie ou d'un album (nom, chemin ou identifiant ; sous-albums compris). Sorties pour les actions suivantes de la scène : photos ajoutées en 24 heures, photos au total, nom, album, date d'ajout et page de la dernière. Rien ne change dans Piwigo.
Idées de scènes
- Sur Nouvelles photos ajoutées, envoyez un message à la famille : « {{count}} nouvelles photos, la dernière : {{name}} dans {{album}} ».
- Chaque soir à 21 h, Lire les dernières photos de l'album « Famille », et si Photos ajoutées en 24 heures dépasse 0, affichez un message sur la tablette du salon.
- Sur Photos ajoutées à un album « Vacances 2026 », allumez le couloir en bleu.
Dépannage
- « clé d'API, nom d'utilisateur ou mot de passe refusé » : la clé a expiré, a été révoquée ou n'a pas été collée en entier (identifiant, deux-points, secret) ; avec un compte, vérifiez le mot de passe.
- « la galerie ne répond pas » : vérifiez l'adresse, le port et le dossier depuis la machine de Gladys.
- « aucune galerie Piwigo à cette adresse » : l'adresse mène à une autre page (page de connexion d'un proxy inverse, autre application) : saisissez l'adresse de la galerie elle-même.
- « certificat refusé » : un certificat auto-signé ; utilisez l'adresse en
http://de votre réseau. - Les nouvelles photos n'apparaissent pas : Piwigo peut garder les photos envoyées par l'application mobile ou l'API web dans une salle d'attente (le « lounge ») jusqu'à la fin de l'envoi ; elles apparaissent à la lecture suivante.
- Le nombre d'utilisateurs reste vide : le compte ou la clé n'est pas administrateur.
LOG_LEVEL=debugdans les logs de l'intégration montre chaque lecture.
Limites
- Les nouvelles photos sont vues à la lecture suivante (5 minutes par défaut), et seulement celles que le compte peut voir.
- L'intégration ne fait que lire : elle ne modifie, n'envoie ni ne supprime rien dans Piwigo.
- Aucune photo ne quitte votre réseau par l'intégration, sauf si vous activez les miniatures du widget.
- Les dates sont celles du serveur Piwigo, telles qu'il les affiche.
- Sans lien avec le projet Piwigo.
Paramètres de configuration
Voici les paramètres demandés par Piwigo dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Connexion à votre galerie Piwigo | section | Non | Saisissez l'adresse de la galerie et une clé d'API (Piwigo 16 : votre profil > Clés d'API, collez la clé entière dans le mot de passe), ou le nom et le mot de passe d'un compte. Un compte admin montre aussi les utilisateurs. Vide : albums publics seuls. |
| Adresse de la galerie | string | Oui | Adresse de la galerie, port et dossier compris. Une adresse https derrière un proxy inverse convient aussi. |
| Nom d'utilisateur (sans clé d'API) | string | Non | Laissez vide avec une clé d'API entière. Rempli : le mot de passe ci-dessous est celui de ce compte. |
| Clé d'API (ou mot de passe du compte) | secret | Non | |
| Albums à suivre | string | Non | Noms ou identifiants des albums à suivre comme appareils, séparés par des virgules (Vacances, 12). Un sous-album par son chemin : Vacances / Plage. Vide : aucun. |
| Rafraîchissement | select | Non | Fréquence de lecture de la galerie (trois ou quatre petites requêtes). |
| Langue des noms | select | Non | Langue des noms des fonctionnalités, du texte de la dernière photo et des erreurs de l'action de scène. Les noms sont fixés à la création de l'appareil : pour les changer, supprimez puis ajoutez de nouveau l'appareil. |
Comment installer Piwigo dans Gladys
- Dans Gladys, ouvrez Intégrations : Piwigo apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/guim31/gladys-piwigo:1.0.0), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-piwigo.
Piwigo nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.
Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.
À propos des intégrations externes
Piwigo est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par guim31, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations, natives et communautaires
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation