Intégration domotique Anniversaries, gratuite et open source
Compte à rebours des anniversaires et dates importantes : jours, années, scènes, widgets.
Publiée par William-De71
- Appareils
- Version 0.1.0
- Nécessite Gladys >=5.1.0
- ★ 0
Présentation
Cette intégration fait le compte à rebours des dates qui comptent : anniversaires, anniversaires de mariage, commémorations, événements. Pour chaque date, elle indique le nombre de jours restants, l’âge atteint ou le nombre d’années écoulées, et peut démarrer vos scènes le jour J, quelques jours avant ou au rappel propre à chaque date.
- Chaque date devient un appareil : jours restants, années au prochain anniversaire et années écoulées, jours écoulés (option), jours avant le demi-anniversaire (option), prochaine date.
- Déclencheurs de scène : une date est aujourd’hui, une date est dans N jours, rappel d’une date. Action de scène : obtenir les prochaines dates en texte à envoyer.
- Deux widgets de tableau de bord : prochaines dates, compte à rebours d’une date.
L’image ci-dessus est une illustration générée, pas une capture d’écran.
Prérequis
- Gladys Assistant 5.1.0 ou plus récent.
- Le fuseau horaire de Gladys correctement réglé (Paramètres > Système) : les jours changent à son minuit.
- Rien d’autre : ni compte, ni appareil, ni accès à Internet.
Configuration
Les dates ne se saisissent pas en JSON : chacune est un petit formulaire, derrière les boutons en bas de la page de configuration.
| Champ ou bouton | Description |
|---|---|
| Heure des événements de scène | L’heure (0 à 23) à laquelle les scènes « aujourd’hui », « dans N jours » et de rappel démarrent chaque jour. 9 par défaut. |
| Rappel par défaut | Jours avant une date pour ses scènes « Rappel d’une date », pour les dates sans rappel propre. 7 par défaut, 0 pour aucun. |
| Langue des textes | Noms des fonctionnalités, prochaine date, résumés des scènes, messages des boutons. Automatique : la langue de votre tableau de bord dès qu’un widget a été affiché. |
| Ajouter une date | Nom, jour, mois, année (vide si inconnue), type, chaque année ou une seule fois, rappel propre, « compter les jours écoulés », « demi-anniversaire ». |
| Modifier une date | Le nom ou le numéro de la date (tel que « Lister les dates » l’affiche), puis seulement les champs à changer. Une année à 0 retire l’année. |
| Supprimer une date | Son nom ou son numéro. Son appareil reste dans Gladys jusqu’à ce que vous le supprimiez. |
| Lister les dates | Toutes les dates avec leur numéro, leur prochaine occurrence, leurs années et options, ainsi que le jour et le fuseau horaire utilisés par l’intégration. |
Les dates sont enregistrées dans la configuration de l’intégration dans Gladys : elles suivent vos sauvegardes de Gladys.
Utilisation
Dates
- Avec ou sans l’année : sans elle, l’intégration compte les jours mais pas les années.
- Chaque année ou une seule fois : une date unique (un événement, une échéance) a besoin de son année ; une fois passée, ses jours restants deviennent négatifs et elle quitte les widgets.
- Le 29 février tombe le 28 février les autres années.
- Type : anniversaire, anniversaire de mariage, date anniversaire, commémoration, événement ou autre. Les scènes et les widgets peuvent filtrer dessus.
Appareils
Après Ajouter une date, ouvrez l’onglet Découverte de l’intégration et ajoutez la date : elle devient un appareil qui porte son nom.
- Jours restants (jours ; 0 le jour J).
- Années au prochain anniversaire et années écoulées (si l’année est connue ; « âge » pour un anniversaire).
- Jours écoulés (option « compter les jours écoulés ») : depuis la dernière occurrence, ou depuis une date unique.
- Jours avant le demi-anniversaire (option), six mois après la date.
- Prochaine date, écrite dans la langue de l’intégration.
Les valeurs changent à minuit dans le fuseau horaire de Gladys. Quand vous changez les options d’une date, son appareil reçoit de nouvelles fonctionnalités : cliquez sur Mettre à jour dans l’onglet Découverte.
Widgets du tableau de bord
- Prochaines dates : les prochaines dates (1 à 8), avec les années atteintes, le jour et un badge (vert le jour J, orange dans la période de rappel). Réglages : combien, dans combien de jours, quels types. Touchez une date pour ses détails.
- Compte à rebours : une date parmi les appareils ajoutés : jours restants, années, jours écoulés, date d’origine, demi-anniversaire et rappel.
Scènes
Déclencheurs, envoyés une fois par jour à l’heure de la configuration (jamais deux fois pour la même date le même jour ; si Gladys était arrêtée à cette heure, ils arrivent à son retour, le même jour) :
- Une date est aujourd’hui : filtres sur la date et les types.
- Une date est dans N jours : vous choisissez N (1 à 60), par exemple 7 pour « une semaine avant ».
- Rappel d’une date : quand une date atteint son propre rappel (ou celui par défaut).
Variables : nom, type, années atteintes, date d’origine, jour, jours restants et une phrase de résumé toute prête (« Marie : dans 7 jours, jeudi 24 décembre 2026 (31 ans) »).
Action Obtenir les prochaines dates : dans les N jours (0 pour aujourd’hui seulement), éventuellement pour certains types ; renvoie le nombre, un résumé (une ligne par date) et la date la plus proche.
Exemples :
- Quand un anniversaire est aujourd’hui → envoyer « {{triggerEvent.data.summary}} » à la famille et mettre la lumière du salon en couleur festive.
- Quand une date est dans 7 jours, type anniversaire de mariage → vous envoyer un message pour réserver le restaurant.
- Chaque lundi à 8 h → obtenir les prochaines dates sur 7 jours → envoyer le résumé par message.
Transport
Local : l’intégration n’appelle aucun service en ligne, rien ne quitte votre Gladys. Son badge dans le catalogue indique « local ».
Dépannage
- Une date est décalée d’un jour : vérifiez le fuseau horaire de Gladys (Paramètres > Système) ; « Lister les dates » affiche le jour et le fuseau utilisés par l’intégration.
- Une scène n’a pas démarré : les événements arrivent à l’heure de la configuration, pas à minuit. Une date ajoutée après cette heure envoie tout de suite ses événements du jour ; une date n’envoie jamais deux fois le même événement le même jour.
- Une fonctionnalité manque après une modification : cliquez sur Mettre à jour sur l’appareil dans l’onglet Découverte.
- Autre chose : ouvrez une issue sur GitHub (https://github.com/William-De71/gladys-anniversaries/issues) avec les versions de Gladys et de l’intégration, le résultat de « Lister les dates » et les journaux de l’intégration (Paramètres > Supervision).
Paramètres de configuration
Voici les paramètres demandés par Anniversaries dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Vos dates | section | Non | Déclarez chaque anniversaire ou date importante avec le bouton « Ajouter une date » ci-dessous, puis ajoutez-la depuis l’onglet Découverte : elle devient un appareil qui compte les jours. Rien ne quitte votre Gladys : l’intégration n’appelle aucun service en ligne. |
| Heure des événements de scène | number | Non | Les scènes « aujourd’hui », « dans N jours » et de rappel démarrent chaque jour à cette heure (0 à 23, dans le fuseau horaire de Gladys). Les jours changent à minuit. |
| Rappel par défaut (jours avant) | number | Non | Pour les dates sans rappel propre. 0 : aucun rappel. |
| Langue des textes | select | Non | Noms des fonctionnalités, prochaine date, résumés des scènes et messages des boutons. Automatique : la langue de votre tableau de bord, dès qu’un widget de l’intégration a été affiché. |
Comment installer Anniversaries dans Gladys
- Dans Gladys, ouvrez Intégrations : Anniversaries 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/william-de71/gladys-anniversaries:0.1.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/William-De71/gladys-anniversaries.
Anniversaries 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
Anniversaries 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 William-De71, 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