Aller au contenu principal

Intégration domotique Maintenance reminders, gratuite et open source

Intégration Maintenance reminders pour Gladys Assistant

Entretiens récurrents (chaudière, filtres, ramonage…) : jours restants, rappels, bouton Fait.

Voir sur GitHubToutes les intégrations

Les entretiens récurrents de la maison, gardés dans Gladys même : l'entretien de la chaudière chaque année, les filtres de VMC tous les six mois, le ramonage, le contrôle technique, le détartrage, les piles des détecteurs de fumée… Chaque tâche compte les jours restants, prévient avant l'échéance, signale le retard, et un appui sur Fait relance le compteur. Sans compte, sans cloud.

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 marche 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 (le formulaire du bouton du widget).
  • Rien d'autre : les tâches sont stockées par l'intégration dans son propre volume.

Mise en place​

  1. Installez l'intégration, ouvrez son onglet Configuration.
  2. Créer ou modifier une tâche :
    • choisissez une tâche proposée (entretien de la chaudière 1 an, ramonage 1 an, contrôle technique 2 ans, filtres de VMC 6 mois, filtre de l'aspirateur 3 mois, détartrage 2 mois, piles des détecteurs de fumée 1 an, climatisation, filtre de la hotte, cartouche filtrante, gouttières, fosse septique, extincteur) : nom, période et délai de prévenance sont remplis pour vous ;
    • ou saisissez un nom et une période : Tous les (un nombre) et une Unité (jours, semaines, mois, ans), dix ans au plus ;
    • Dernière fois faite : 2026-03-14, 14/03/2026, ou -30 pour il y a 30 jours ; vide, aujourd'hui ;
    • Délai de prévenance (jours) : combien de jours avant l'échéance la tâche est « bientôt due » (vide : celui de la tâche proposée, sinon 7).
  3. Ouvrez l'onglet Découverte et ajoutez la tâche : elle devient un appareil de Gladys, que vous pouvez renommer et placer dans une pièce.
  4. Ajoutez le widget Prochains entretiens à un tableau de bord.

La même action modifie une tâche : donnez son nom et seulement ce qui change (la période, le délai, ou une dernière date corrigée). Marquer une tâche comme faite enregistre qu'elle a été faite, aujourd'hui ou à la date saisie. Afficher les tâches donne chaque tâche et sa prochaine échéance. Supprimer une tâche la supprime avec son historique, définitivement : saisissez son nom exact pour confirmer, puis supprimez aussi son appareil dans Gladys.

Langue des noms de fonctionnalités : la langue des noms donnés aux fonctionnalités à l'ajout d'une tâche, des dates qu'elles affichent et des textes envoyés aux scènes (français par défaut).

L'échéance d'une tâche mensuelle ou annuelle garde le jour du mois, ou prend le dernier jour d'un mois plus court : faite le 31 janvier, une tâche mensuelle est due le 28 février (le 29 une année bissextile). Les jours changent à minuit, dans le fuseau horaire de Gladys.

Appareils​

Un appareil par tâche, avec six fonctionnalités :

FonctionnalitéValeur
Jours restantsjours jusqu'à l'échéance, négatif une fois en retard
Période restantela part de la période qui reste, 100 % le jour où c'est fait, 0 à l'échéance
Bientôt dû1 dans le délai de prévenance, jusqu'à l'échéance
En retard1 dès le lendemain de l'échéance, jusqu'à ce que ce soit fait
Dernière foisla dernière date où ça a été fait
Prochaine échéancel'échéance

Les noms sont ceux de la langue configurée (ici, le français). Gladys ne propose pas d'événements de calendrier à une intégration d'appareils : les échéances sont des fonctionnalités, le widget et les scènes, pas des entrées du calendrier de Gladys.

Tableau de bord​

Le widget Prochains entretiens affiche combien de tâches sont bientôt dues ou en retard, puis les prochaines tâches par échéance : en retard en rouge (« retard de 8 j »), bientôt dues en orange (« dans 11 j »), les autres avec leur date. Fait ouvre un formulaire : choisissez la tâche, et la date où elle a été faite (vide : aujourd'hui).

Réglages : les tâches affichées (toutes, ou seulement celles bientôt dues ou en retard), le nombre de lignes (3 à 10), et les éléments à masquer (le nombre, le bouton Fait).

Scènes​

Déclencheurs​

  • Entretien bientôt dû : une tâche entre dans son délai de prévenance (ex. 30 jours avant l'entretien de la chaudière). Une fois par échéance.
  • Entretien en retard : une tâche a dépassé son échéance sans être marquée comme faite. Une fois par échéance.

Les deux peuvent se limiter à une tâche (vide : toutes) et donnent le nom de la tâche, son échéance (AAAA-MM-JJ) et ses jours restants.

Actions​

  • Marquer un entretien comme fait : le compteur de la tâche repart, d'aujourd'hui ou d'une date (2026-03-14, 14/03/2026, -2). Donne la dernière date, la prochaine échéance et les jours restants.
  • Lire les tâches d'entretien : ce qui est bientôt dû ou en retard en un texte (« Filtres de VMC (retard de 8 j), Entretien de la chaudière (dans 11 j) »), ou toutes les tâches, avec le nombre de tâches en retard et bientôt dues, et la prochaine tâche.

Idées de scènes​

  • « Entretien bientôt dû » : un message Telegram « Prendre rendez-vous pour la chaudière avant le {{due}} ».
  • Chaque lundi à 8 h : Lire les tâches d'entretien, puis un message avec le texte quand quelque chose est dû.
  • Un tag NFC sur l'aspirateur : Marquer un entretien comme fait pour son filtre.

Vos données​

Tout est stocké dans un seul fichier, tasks.json, dans le volume de l'intégration (/data), avec la version précédente en tasks.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 tasks.json.corrupt et la sauvegarde est lue à la place. Les vingt dernières dates de chaque tâche sont gardées. Désinstaller l'intégration supprime son volume, et les tâches avec.

Dépannage​

  • La tâche n'apparaît pas dans les scènes ni dans les réglages du widget : ajoutez d'abord son appareil dans l'onglet Découverte.
  • « Date incomprise » : utilisez 2026-03-14, 14/03/2026 ou -7.
  • « Cette date est dans le futur » : indiquez le jour où ça a été fait.
  • « Les tâches 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​

  • 100 tâches, 40 caractères par nom, une période de dix ans au plus, un délai de prévenance de 365 jours au plus. Les jours restants affichés sont bornés à ±3660.
  • Une date par tâche : pas d'heure, pas de sous-tâches, pas de rappel répété chaque jour (une scène sur « En retard » peut le faire).
  • Pas d'entrées dans le calendrier de Gladys (voir Appareils), pas d'import depuis un autre service.

Paramètres de configuration​

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

ParamètreTypeObligatoireDescription
Vos tâches d'entretiensectionNonCréez une tâche avec les boutons ci-dessous (une proposée, ou la vôtre), puis ajoutez-la dans l'onglet Découverte : elle devient un appareil avec ses jours restants, pour le tableau de bord (widget Prochains entretiens) et les scènes. Tout reste dans Gladys.
Langue des noms de fonctionnalitésselectNonNoms donnés aux fonctionnalités à l'ajout d'une tâche, dates et textes envoyés aux scènes.

Comment installer Maintenance reminders dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Maintenance reminders 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-entretien: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-entretien.

Maintenance reminders 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​

Maintenance reminders 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