Intégration domotique Fête du jour, gratuite et open source

Les fêtes du calendrier : un calendrier Gladys, un déclencheur de scène, un widget.

• Publiée par William-De71
• Appareils
• Version 0.1.0
• Nécessite Gladys >=5.2.0
• ★ 0

Voir sur GitHubToutes les intégrations

Présentation

Cette intégration apporte dans Gladys la fête de chaque jour du calendrier traditionnel français : « Bonne fête Valérie » le 28 avril, « Fête nationale · Bonne fête Camille » le 14 juillet.

• Un calendrier Gladys « Fêtes du jour » pour chaque utilisateur qui l’active : un événement d’une journée par jour, de 7 jours en arrière à un an en avance.
• Un déclencheur de scène « Fête du jour », chaque jour à l’heure choisie, ou seulement le jour de la fête des prénoms que vous choisissez (le vôtre, ceux de vos proches).
• Une action de scène « Obtenir la fête du jour » (aujourd’hui ou demain), avec une phrase toute prête à envoyer.
• Un widget « Fête du jour » : la fête d’aujourd’hui et celles des jours suivants.

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 (intégrations de type calendrier).
• Le fuseau horaire de Gladys correctement réglé (Paramètres > Système) : les jours changent à son minuit.
• Rien d’autre avec la liste intégrée. Pour fetedujour.fr : une clé gratuite et une adresse IP publique fixe (voir plus bas).

Configuration

Champ	Description
Heure de l’événement de scène	L’heure (0 à 23) à laquelle le déclencheur « Fête du jour » démarre chaque jour. 8 par défaut.
Langue des textes	Résumés des scènes et état. Automatique : la langue de votre tableau de bord dès que le widget a été affiché, devinée d’après le fuseau horaire avant. Le calendrier suit la langue de chaque utilisateur.
Clé fetedujour.fr	Facultative. Vide : la liste intégrée.

Puis, dans le bloc Mes calendriers de la page de l’intégration, cliquez sur Activer pour moi : votre calendrier « Fêtes du jour » apparaît dans le calendrier de Gladys. Il est privé au départ : pour l’utiliser dans les scènes ou le montrer au foyer, activez Partager avec le foyer. Chaque utilisateur active le sien.

D’où viennent les noms

• Liste intégrée (par défaut) : le calendrier traditionnel français, un saint par jour (351 prénoms), avec les fêtes et jours fériés (Toussaint, Noël, Fête nationale…). Quand une fête a un prénom associé, il est donné avec elle : Martin le 11 novembre, Camille le 14 juillet, Marie le 15 août. Aucune connexion n’est nécessaire. Le 29 février (Auguste) n’existe que les années bissextiles.
• fetedujour.fr (facultatif) : générez une clé gratuite sur fetedujour.fr/api en indiquant l’adresse IP publique de votre box, puis collez-la dans la configuration. Cette clé ne fonctionne que depuis cette adresse IP : si votre fournisseur d’accès vous donne une adresse qui change, la clé cessera de fonctionner. L’intégration demande chaque jour de l’année une seule fois (une requête toutes les 30 secondes, environ trois heures la première fois, aujourd’hui d’abord) et garde les réponses ; les fêtes de la liste intégrée restent telles quelles. Tant qu’un jour n’est pas lu, et chaque fois que fetedujour.fr refuse la clé ou ne répond pas, la liste intégrée prend le relais.

L’état en haut de la page de configuration indique la source utilisée et l’avancement (« fetedujour.fr : 120 jours sur 366 lus »).

Utilisation

Calendrier

Le calendrier « Fêtes du jour » s’affiche dans la vue calendrier de Gladys, avec les autres. Le déclencheur Gladys « Un évènement dans le calendrier arrive » fonctionne aussi dessus, une fois le calendrier partagé avec le foyer.

Widget

Fête du jour : le prénom du jour en grand (ou la fête), la date et un « Bonne fête aux Valérie ! », puis les jours suivants (0 à 7, réglage « Jours suivants »). Les fêtes sont en bleu.

Scènes

Déclencheur Fête du jour, envoyé une fois par jour à l’heure de la configuration (jamais deux fois le même jour ; si Gladys était arrêtée à cette heure, il arrive à son retour, le même jour). Filtre Prénoms : laissé vide, la scène démarre chaque jour ; sinon seulement le jour de la fête des prénoms choisis.

Variables : prénom du jour, fête ou jour férié (vide la plupart des jours), jour (AAAA-MM-JJ) et une phrase toute prête (« Aujourd’hui, nous fêtons les Valérie. »).

Action Obtenir la fête du jour : aujourd’hui ou demain ; renvoie le prénom, la fête, le jour et la phrase (« Demain, nous fêterons les Catherine de Sienne. »).

Exemples :

• Chaque jour à 8 h (déclencheur Fête du jour) → envoyer « {{triggerEvent.data.summary}} » sur la messagerie de la famille.
• Fête du jour, prénoms Valérie et Martin → envoyer un message pour ne pas oublier de leur souhaiter leur fête.
• Chaque soir à 20 h → obtenir la fête de demain → l’annoncer sur l’enceinte du salon.

Transport

Local avec la liste intégrée : rien ne quitte votre Gladys. Avec une clé, l’intégration appelle aussi fetedujour.fr (cloud), et uniquement ce site.

Dépannage

• « fetedujour.fr a refusé la clé » : la clé est liée à une adresse IP publique fixe. Vérifiez que l’adresse de votre box est celle donnée à la création de la clé, sinon générez-en une nouvelle. La liste intégrée est utilisée en attendant ; l’intégration réessaie toutes les 6 heures, et tout de suite après un changement de clé.
• Le calendrier n’apparaît pas : activez l’intégration pour vous dans « Mes calendriers ». Pour les scènes, partagez-le avec le foyer.
• La fête est décalée d’un jour : vérifiez le fuseau horaire de Gladys (Paramètres > Système).
• Autre chose : ouvrez une issue sur GitHub (https://github.com/William-De71/gladys-fete-du-jour/issues) avec les versions de Gladys et de l’intégration, la source utilisée, l’état affiché dans la configuration et les journaux de l’intégration (Paramètres > Supervision). Ne collez jamais votre clé.

Paramètres de configuration

Voici les paramètres demandés par Fête du jour dans son écran de configuration dans Gladys.

Paramètre	Type	Obligatoire	Description
Fêtes du jour	section	Non	Comment ça marche : 1. Activez l’intégration pour vous dans « Mes calendriers » ci-dessous : vous obtenez un calendrier « Fêtes du jour », un événement d’une journée par jour, sur un an. Partagez-le avec le foyer pour l’utiliser dans les scènes. 2. Ajoutez le widget « Fête du jour » à un tableau de bord. 3. Dans une scène, le déclencheur « Fête du jour » démarre chaque jour à l’heure ci-dessous, ou seulement le jour de la fête des prénoms que vous choisissez. Les noms viennent du calendrier traditionnel français intégré à l’intégration : rien à régler, aucune connexion nécessaire.
Heure de l’événement de scène	number	Non	Le déclencheur « Fête du jour » démarre chaque jour à cette heure (0 à 23, dans le fuseau horaire de Gladys).
Langue des textes	select	Non	Résumés des scènes et état. Automatique : la langue de votre tableau de bord dès que le widget a été affiché, devinée d’après le fuseau horaire de Gladys avant cela. Le calendrier suit toujours la langue de chaque utilisateur.
fetedujour.fr (facultatif)	section	Non	Au lieu de la liste intégrée, les noms peuvent venir de fetedujour.fr. Sa clé est gratuite, mais liée à UNE adresse IP publique fixe : générez-la sur la page ci-dessous avec l’adresse publique de votre box. Avec une adresse qui change, la clé cesse de fonctionner et la liste intégrée prend le relais. Chaque jour de l’année est demandé une seule fois (une requête toutes les 30 secondes, environ trois heures la première fois), puis conservé.
Clé fetedujour.fr (facultative)	secret	Non	Vide : la liste intégrée.

Comment installer Fête du jour dans Gladys

1. Dans Gladys, ouvrez Intégrations : Fête du jour 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/william-de71/gladys-fete-du-jour: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).
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/William-De71/gladys-fete-du-jour.

Fête du jour 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

Fête du jour 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

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 🙂