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.3.2
- Nécessite Gladys >=5.2.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 (filtre « années rondes »), une date atteint un millier de jours. Action de scène : obtenir les prochaines dates en texte à envoyer.
- Trois widgets de tableau de bord : prochaines dates, compte à rebours d’une date, dates du mois. Un bouton Ajouter une date directement depuis le tableau de bord.
- Les noces des anniversaires de mariage : noces de coton, de porcelaine, d’or…
L’image ci-dessus est une illustration générée, pas une capture d’écran.
Prérequis
- Gladys Assistant 5.2.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é, devinée d’après le fuseau horaire de Gladys avant cela. Choisissez-la avant d’ajouter vos appareils : un appareil garde les noms de fonctionnalités avec lesquels il a été créé. |
| 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.
- Anniversaire de mariage avec son année : l’intégration donne le nom traditionnel des noces (noces de coton la 1re année, de porcelaine à 20 ans, d’or à 50 ans… liste française de 1 à 80 ans), dans les widgets et les scènes. Chaque langue suit sa propre tradition : en anglais, allemand ou espagnol, les noms (et les années nommées) ne sont pas les mêmes.
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 : la date la plus proche est mise en avant en haut (son nom, son type et son jour, une tuile colorée des jours restants et une tuile de l’âge ou des années), puis les suivantes en lignes sur toute la largeur : à gauche une icône du type (cadeau, cœur, étoile…), le nom et les années, à droite le jour et les jours restants (« 24 déc. · 69 j », « Aujourd’hui » le jour J). Couleurs de l’icône : vert le jour J, orange dans la période de rappel, bleu pour une année ronde (10, 20, 25, 30… et 18 ans pour un anniversaire), gris ensuite (les tuiles restent bleues). Réglages : combien (la date mise en avant comprise), dans combien de jours, quels types, afficher ou non le bouton. Le nom des noces figure dans la légende de la date mise en avant et dans le widget Compte à rebours.
- Compte à rebours : une date parmi les appareils ajoutés : jours restants, années, jours écoulés, date du mariage ou de l’événement (pas la date de naissance : l’âge et le jour suffisent), demi-anniversaire et noces. « Prochain âge » est l’âge atteint au prochain anniversaire, « Jours écoulés » les jours depuis la dernière occurrence. Le rappel n’y figure pas : il ne sert qu’aux scènes.
- Dates du mois : toutes les dates du mois en cours (ou du mois suivant), jours passés compris, dans l’ordre des jours, avec les mêmes lignes et couleurs ; la prochaine date à venir du mois est mise en avant par ses tuiles. 8 au maximum, la légende indique combien il y en a. Réglages : quel mois, quels types, afficher ou non le bouton.
Prochaines dates et Dates du mois ont un bouton Ajouter une date : un petit formulaire avec le nom, la date (le jour d’abord : 24/12/1995, ou 24/12 sans l’année), le type et la répétition. Le rappel propre et les options se règlent ensuite avec « Modifier une date » dans la configuration. Comme pour le bouton de la configuration, ajoutez ensuite la date depuis l’onglet Découverte pour obtenir son appareil.
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).
- Une date atteint un millier de jours : tous les 1 000 jours depuis la date, pour les dates dont l’année est connue (10 000 jours de vie, 1 000 jours depuis l’emménagement). Variables : nom, type, nombre de jours, date de naissance ou de l’événement, phrase de résumé.
Les trois premiers ont un filtre Années rondes : laissé vide, toutes les années ; « Années rondes seulement », les dizaines, 25, 75 et les autres multiples de 25, et 18 ans pour un anniversaire.
Variables : nom, type, années atteintes, noces (pour un anniversaire de mariage, vide sinon), date de naissance ou de l’événement (celle que vous avez saisie), jour de la prochaine occurrence, jours restants et une phrase de résumé toute prête (« Marie : dans 7 jours, jeudi 24 décembre 2026 (31 ans) », « Claire & Alex : aujourd’hui (20 ans, noces de porcelaine) »).
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.
- Quand un anniversaire de mariage est dans 30 jours, années rondes seulement → vous envoyer « Bientôt les {{triggerEvent.data.wedding}} ! » pour préparer une fête.
- 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
- Les fonctionnalités d’un appareil sont en anglais : l’appareil a été créé avant que l’intégration connaisse votre langue, et Gladys ne renomme jamais les fonctionnalités d’un appareil existant. Choisissez la « Langue des textes » dans la configuration, supprimez l’appareil (onglet Appareils) et ajoutez-le de nouveau depuis l’onglet Découverte. La date elle-même n’est pas perdue.
- 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 | Comment ça marche : 1. Choisissez d’abord la « Langue des textes » ci-dessous : un appareil garde les noms de fonctionnalités avec lesquels il a été créé. 2. Déclarez chaque anniversaire ou date importante avec « Ajouter une date » (ou le bouton des widgets du tableau de bord). 3. Ouvrez l’onglet Découverte et ajoutez la date : elle devient un appareil qui compte les jours. 4. Ajoutez les widgets à un tableau de bord, et utilisez les déclencheurs de scène (une date aujourd’hui, dans N jours, à son rappel, tous les 1 000 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é, devinée d’après le fuseau horaire de Gladys avant cela. Un appareil déjà créé garde ses noms de fonctionnalités : supprimez-le et ajoutez-le de nouveau depuis l’onglet Découverte pour les renommer. |
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.3.2), 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.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
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