Intégration domotique Moon phase, gratuite et open source
Widget phase de la lune : illumination, lever et coucher, prochains événements lunaires.
Publiée par William-De71
- Appareils
- Version 1.1.1
- Nécessite Gladys >=5.1.1
- ★ 0
Cette intégration ajoute à Gladys un widget de tableau de bord « Phase de la lune » : la phase du jour, l'illumination et l'âge de la lune, son disque éclairé, son lever et son coucher, et les prochains événements lunaires. Les scènes peuvent réagir aux événements lunaires (pleine lune, nouvelle lune, éclipse…) et lire la phase de la lune.
Prêt à l'emploi
Rien à configurer : tout est calculé localement à partir de la position de votre maison, sans compte, sans clé et sans accès Internet.
La maison doit être localisée : renseignez sa position dans Paramètres → Maisons.
Ajouter le widget
Éditez un tableau de bord, choisissez Phase de la lune dans les widgets d'intégration, puis réglez :
| Réglage | Rôle |
|---|---|
| Maison | Nom de la maison dont la position sert au calcul. Laisser vide pour la première maison localisée (le cas d'une seule maison). |
| Afficher les détails | Affiche la liste sous la lune (distance, trajectoire, constellation, prochains événements). Décochez pour ne garder que la phase, le disque, le lever et le coucher. |
| Calculer les valeurs à minuit | Calcule l'illumination, la distance, l'âge et les décomptes à minuit, comme les calendriers lunaires, pour pouvoir les comparer ligne à ligne. Le lever et le coucher ne changent pas. |
Ce que montre le widget
- La phase (Nouvelle Lune, Premier Croissant, Premier Quartier, Gibbeuse Croissante, Pleine Lune…), le pourcentage éclairé et l'âge de la lune (jours écoulés depuis la dernière nouvelle lune).
- Le disque lunaire (photo de la NASA) avec sa partie éclairée.
- Le lever et le coucher de la lune du jour, à l'heure de Gladys.
--:--quand la lune ne se lève pas ou ne se couche pas ce jour-là (cela arrive environ un jour par mois). - Aujourd'hui : distance Terre-Lune, trajectoire (ascendante ou descendante), constellation (zodiaque sidéral, comme les calendriers lunaires) et le prochain nœud.
- À venir : pleine lune, nouvelle lune, périgée, apogée et prochaine éclipse de lune, avec le nombre de jours et la date.
Le widget est mis à jour toutes les 10 minutes et juste après minuit.
Scènes
Déclencheur « Lune : événement lunaire »
Déclenché à la minute de l'événement, à l'heure de Gladys :
| Événement | Quand |
|---|---|
| Nouvelle lune | la lune passe entre la Terre et le soleil |
| Premier quartier | la moitié du disque est éclairée, la lune croît |
| Pleine lune | tout le disque est éclairé |
| Dernier quartier | la moitié du disque est éclairée, la lune décroît |
| Périgée | la lune est au plus près de la Terre |
| Apogée | la lune est au plus loin de la Terre |
| Éclipse de lune | une pleine lune qui passe dans l'ombre de la Terre |
Choisissez les événements auxquels réagir (vide : tous). La scène reçoit l'événement, son nom, sa date et son heure, l'illumination, la distance Terre-Lune et une phrase Résumé prête à envoyer : « Pleine lune à 05:11 : la lune est éclairée à 100 %, à 368 600 km de la Terre. »
Un événement n'est déclenché qu'une fois, même après un redémarrage. Si l'intégration était arrêtée à cette minute, l'événement n'est pas déclenché plus tard (une scène « pleine lune » une heure après surprendrait plus qu'elle n'aiderait).
Idées : passer l'éclairage du jardin en ambiance « pleine lune », recevoir un message le soir d'une éclipse de lune, un rappel pour semer à la nouvelle lune.
Action « Lune : phase de la lune »
Donne la lune d'une maison maintenant (vide : la première maison localisée) : phase, pourcentage éclairé, âge, croissante ou non, lever et coucher, la date de la prochaine pleine lune et de la prochaine nouvelle lune avec le nombre de jours, et un résumé, par exemple pour répondre à « quelle lune ce soir ? » dans un message.
Langue des textes de scène
Gladys ne donne la langue qu'aux widgets. Les noms d'événements et les résumés des scènes suivent le réglage Langue des textes de scène de l'intégration : anglais, français, allemand, espagnol, ou automatique (la langue de votre tableau de bord, dès que le widget a été affiché).
Questions fréquentes
Le widget dit qu'aucune maison n'est localisée. Renseignez la position d'une maison dans Paramètres → Maisons.
Le widget dit « Aucune maison nommée … ». Le nom saisi dans le réglage Maison ne correspond à aucune maison : le message liste les noms à utiliser.
Les heures sont décalées. Vérifiez le fuseau horaire de Gladys (Paramètres → Système) ; l'intégration prend celui-ci. Redémarrez l'intégration après l'avoir changé.
Ma langue n'est pas l'anglais, le français, l'allemand ou l'espagnol. Le widget s'affiche alors en anglais.
Les textes de scène sont en anglais. Réglez Langue des textes de scène dans les réglages, ou affichez une fois le widget.
Paramètres de configuration
Voici les paramètres demandés par Moon phase dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Prêt à l'emploi | section | Non | Rien à configurer : tout est calculé localement à partir de la position de votre maison, sans compte ni accès Internet. Ajoutez le widget « Phase de la lune » à un tableau de bord. La maison doit être localisée (Paramètres → Maisons). Les scènes disposent d’un déclencheur sur les événements lunaires et d’une action donnant la phase de la lune. |
| Langue des textes de scène | select | Non | Noms des événements et résumés des scènes. Automatique : la langue de votre tableau de bord, dès que le widget a été affiché. |
Comment installer Moon phase dans Gladys
- Dans Gladys, ouvrez Intégrations : Moon phase 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-moon-phase:1.1.1), 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-moon-phase.
Moon phase nécessite Gladys >=5.1.1. 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
Moon phase 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