Aller au contenu principal

Intégration domotique Local lists, gratuite et open source

Intégration Local lists pour Gladys Assistant

Listes de courses et de tâches stockées dans Gladys : tableau de bord, scènes, retards. Sans cloud.

Voir sur GitHubToutes les intégrations

Des listes de courses et de tâches gardées dans Gladys elle-même : ni compte, ni cloud, ni autre serveur. Affichez une liste au tableau de bord, ajoutez ou cochez un élément d'un geste, laissez une scène mettre « sacs poubelle » dans la liste de courses, vous rappeler une tâche en retard, ou lire la liste à voix haute avant de partir.

Vos retours sont les bienvenus. Cette intégration a été testée avec le Gladys de test du SDK et dans son image Docker, pas encore au quotidien avec un vrai Gladys. Si quelque chose ne fonctionne pas comme décrit, dites-le sur le forum Gladys ou dans les issues.

Ce qu'il faut​

  • Gladys Assistant 5.2.0 ou plus récent (les formulaires des boutons du widget).
  • Rien d'autre : l'intégration stocke les listes dans son propre volume.

Mise en place​

  1. Installez l'intégration, ouvrez son onglet Configuration.
  2. Créer une liste : saisissez son nom (ex. Courses) et choisissez son type :
    • Liste de courses : des articles à acheter ;
    • Liste de tâches (échéances) : des tâches, chacune avec une échéance facultative.
  3. Ouvrez l'onglet Découverte et ajoutez la liste : elle devient un appareil de Gladys, que vous pouvez renommer et placer dans une pièce.
  4. Ajoutez le widget Liste locale à un tableau de bord.

Afficher les listes donne les listes et le nombre d'éléments restants de chacune. Supprimer une liste supprime une liste et ses éléments définitivement : saisissez son nom exact pour confirmer. Supprimez ensuite aussi son appareil dans Gladys. Une liste ne se renomme pas ici : renommez son appareil dans Gladys, le widget et les scènes utilisent ce nom.

Langue des noms de fonctionnalités : la langue des noms donnés aux fonctionnalités à l'ajout d'une liste, et des messages envoyés aux scènes (français par défaut).

Appareils​

Un appareil par liste, avec :

  • Articles à acheter (liste de courses) ou Tâches à faire (liste de tâches) : le nombre d'éléments pas encore cochés ;
  • Tâches en retard (listes de tâches seulement) : les tâches dont l'échéance est passée.

Ces nombres sont gardés dans l'historique et servent dans les conditions des scènes de Gladys (« s'il y a plus de 10 articles à acheter… »). Une échéance sans heure est en retard le lendemain ; une échéance avec une heure, la minute suivante.

Tableau de bord​

Le widget Liste locale affiche une liste : le nombre d'éléments restants, les éléments (dix lignes au plus ; les tâches avec leur échéance, celles en retard en rouge), et quatre boutons :

  • Ajouter : un élément, et pour une liste de tâches une échéance facultative ;
  • Cocher et Décocher : choisissez l'élément dans une liste ;
  • Vider les faits : retire les éléments cochés, après confirmation.

Réglages : la liste (vide : la première), Afficher les éléments faits, et Boutons à masquer (ex. une tablette murale qui ne fait qu'afficher la liste).

Scènes​

Déclencheurs​

  • Élément ajouté à une liste locale : un élément a été ajouté depuis le widget ou une scène, ou un élément coché revient dans la liste. Variables : l'élément, la liste, l'échéance.
  • Élément coché dans une liste locale : variables : l'élément, la liste, le nombre d'éléments restants.
  • Liste locale terminée : le dernier élément restant d'une liste a été coché.
  • Tâche en retard : une tâche a dépassé son échéance sans être cochée, une fois par tâche (de nouveau si elle est décochée puis de nouveau en retard). Une tâche passée en retard pendant que Gladys était arrêtée se déclenche au démarrage suivant.

Chaque déclencheur peut se limiter à une liste (vide : toutes les listes).

Actions​

  • Ajouter à une liste locale : la liste, l'élément, et pour une liste de tâches une échéance facultative : 2026-11-20, 20/11/2026, 20/11/2026 18:30, ou +N pour dans N jours (+0 pour aujourd'hui, +1 08:00 pour demain à 8 h). Un élément déjà dans la liste n'est pas ajouté deux fois (une tâche prend la nouvelle échéance) ; un élément coché auparavant est remis à faire.
  • Cocher un élément de liste locale : d'après son texte (majuscules et accents ignorés), fait ou de nouveau à faire. Sorties : trouvé, modifié, nombre restant.
  • Vider les éléments faits d'une liste locale : sortie : le nombre retiré.
  • Lire une liste locale : sorties : les éléments restants en un texte (Lait, Œufs, Pain), leur nombre, les tâches en retard. À envoyer dans un message ou à faire dire.

Idées de scènes​

  • Chaque lundi à 19 h : « Ajouter à une liste locale » Sortir les poubelles, dans la liste Maison, échéance +0 20:00. Pas fait à 20 h : « Tâche en retard » vous le rappelle.
  • Un tag NFC sur le placard : « Ajouter à une liste locale » café.
  • Quand vous quittez la maison (présence) : « Lire une liste locale », puis envoyez son texte sur votre téléphone.
  • « Tâche en retard » : un message Telegram avec la tâche et sa liste.
  • « Liste locale terminée » : une notification « Tout est acheté ».

L'assistant du chat de Gladys ne peut pas lire ni remplir les listes de lui-même : le SDK des intégrations n'en donne pas le moyen dans Gladys 5.3. Les scènes sont le moyen.

Vos données​

Tout est stocké dans un fichier, lists.json, dans le volume de l'intégration (/data), avec la version précédente en lists.json.bak. Chaque modification est écrite dans un fichier temporaire puis renommée : une coupure de courant ne laisse jamais un fichier à moitié écrit. Si le fichier est illisible au démarrage, il est gardé en lists.json.corrupt et la sauvegarde est lue à la place. Désinstaller l'intégration supprime son volume, et les listes avec.

Dépannage​

  • La liste n'apparaît ni dans les scènes ni dans les réglages du widget : ajoutez d'abord son appareil dans l'onglet Découverte.
  • « Échéance incomprise » : utilisez 2026-11-20, 20/11/2026 18:30 ou +3.
  • « Les listes n'ont pas pu être enregistrées » : le volume de l'intégration est plein ou en lecture seule ; rien n'a été modifié. Voir les logs de l'intégration.
  • Logs : dans Gladys, la page de l'intégration, Logs. Démarrez l'intégration avec LOG_LEVEL=debug pour plus de détails.

Limites​

  • 50 listes, 500 éléments par liste, 200 caractères par élément, 40 par nom de liste.
  • Pas de sous-tâches, pas de tâches récurrentes, pas de partage hors de Gladys : les listes vivent dans Gladys seulement. Une tâche récurrente, c'est une scène qui l'ajoute.
  • Le widget affiche dix lignes ; les formulaires proposent les cinquante premiers éléments.
  • Pas d'import depuis un autre service, ni d'export vers lui.

Paramètres de configuration​

Voici les paramètres demandés par Local lists dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
Vos listessectionNonCréez une liste avec les boutons ci-dessous, puis ajoutez-la dans l'onglet Découverte : elle devient un appareil, à afficher au tableau de bord (widget Liste locale) et à utiliser dans les scènes. Tout reste dans Gladys.
Langue des noms de fonctionnalitésselectNonNoms donnés aux fonctionnalités à l'ajout d'une liste, et textes envoyés aux scènes.

Comment installer Local lists dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Local lists apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
  2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/guim31/gladys-local-lists: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).
  3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
  4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-local-lists.

Local lists nécessite Gladys >=5.2.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​

Local lists 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.

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂
Dernière mise à jour le