Aller au contenu principal

Intégration domotique Solunar, gratuite et open source

Intégration Solunar pour Gladys Assistant

Périodes solunaires de pêche et de chasse calculées en local : majeures, mineures, note du jour.

Les périodes solunaires dans Gladys, pour la pêche et la chasse : les moments de la journée où poissons et gibier seraient les plus actifs, selon la théorie publiée par John Alden Knight en 1926. Tout est calculé dans le conteneur d'après la position de la Lune et du Soleil : sans compte, sans clé, sans accès à internet.

Ce que vous obtenez​

  • Un appareil par lieu : chaque maison localisée de Gladys, et jusqu'à trois coins de pêche saisis dans la configuration. Chaque appareil donne la période en cours (aucune, majeure ou mineure, et sa fin), un indicateur « période active », la prochaine période et les minutes qui restent avant elle, la note du jour de 0 à 4, la phase de la lune et son illumination.
  • Un widget de tableau de bord : les périodes du jour en un lieu, celle en cours en vert, la note du jour et la lune.
  • Un déclencheur de scène : une période solunaire commence, filtré par lieu, type (majeure ou mineure) et note du jour.
  • Une action de scène : les périodes, la note et la lune d'aujourd'hui ou de demain en un lieu, en une phrase à envoyer par message.

Cette intégration donne les périodes de pêche. Pour la lune elle-même (phase, lever et coucher, événements lunaires), voyez le widget gladys-moon-phase : les deux fonctionnent côte à côte.

Prérequis​

  • Gladys Assistant 5.1.0 ou plus récent (widgets, déclencheurs et actions de scène).
  • Une maison localisée dans Gladys (Paramètres → Maisons), ou les coordonnées d'un coin.

L'intégration s'installe depuis GitHub : Intégrations → Installer depuis GitHub, adresse https://github.com/guim31/gladys-solunar.

Configuration​

RéglageDéfautRôle
Langue des valeursFrançaisLangue des noms de fonctionnalités et des textes envoyés à Gladys.
Un appareil par maison localiséeActivéUtilise les coordonnées des maisons réglées dans Gladys.
Coin 1 à 3 : nomvideNom de l'appareil du coin (renommable ensuite dans Gladys).
Coin 1 à 3 : latitude, longitudevidelatitude, longitude en degrés décimaux, par ex. 43.6047, 1.4442.

Les coordonnées se copient depuis n'importe quelle carte (clic droit dans OpenStreetMap ou Google Maps). La virgule décimale marche aussi : 43,6047; 1,4442. Videz les coordonnées d'un coin pour le retirer. Enregistrez, puis créez les appareils dans l'onglet Découverte. Le bouton Vérifier les lieux liste chaque lieu avec sa note du jour.

Les coordonnées des maisons sont lues au démarrage, à chaque recherche et toutes les 6 heures : après avoir déplacé une maison, appuyez sur Vérifier les lieux.

Appareils​

FonctionnalitéTypeExemple
Période solunairetexteMajeure jusqu'à 18:40
Période solunaire activebinaire1 pendant toute période
Prochaine période solunairetexteMineure demain à 05:10
Prochaine période dans (min)durée95
Note du jour (0-4)nombre3
Phase de la lunetexteGibbeuse croissante
Illumination de la lune (%)nombre78

Les heures sont celles du fuseau horaire de Gladys, une journée va de minuit à minuit. Les valeurs sont calculées chaque minute et seuls les changements sont envoyés.

Widget de tableau de bord​

Périodes solunaires : choisissez un lieu (le premier par défaut). Il affiche la note du jour, l'illumination de la lune, puis chaque période du jour : passée, en cours (en vert) ou à venir. Un ☀ signale une période qui rencontre un lever ou un coucher du soleil. Le réglage Afficher la lune masque la tuile et la phase de la lune.

Déclencheur de scène​

Période solunaire commencée, quand une période majeure ou mineure débute en un lieu. Filtres : le lieu, le type de période, la note du jour. Variables : place (le lieu), start (début), end (fin), with_sun (la période rencontre un lever ou un coucher du soleil) et summary, une phrase toute prête.

Un redémarrage de l'intégration au milieu d'une période ne la déclenche pas une seconde fois.

Action de scène​

Obtenir la journée solunaire : pour un lieu et un jour (aujourd'hui ou demain), renvoie summary (une phrase), rating (la note), periods (la liste avec les heures), moon_phase et illumination.

Exemples de scènes​

  • Chaque soir à 20 h, Obtenir la journée solunaire pour demain au lac, puis envoyer le résumé par message : la sortie se prépare la veille.
  • Période solunaire commencée, type majeure, note 3 ou 4 : une notification « ça mord ».
  • Condition sur Prochaine période dans (min) inférieure à 30 à la maison : il est temps de préparer le matériel.

Comment c'est calculé​

  • Périodes majeures, deux heures : la Lune passe au méridien au-dessus de nous (passage supérieur) ou sous nos pieds (passage inférieur), centrées sur le passage.
  • Périodes mineures, une heure : lever et coucher de la lune, centrées sur l'événement.
  • Une période est avec le soleil quand un lever ou un coucher du soleil tombe dedans ou à moins de 30 minutes de ses bords.
  • Note du jour, de 0 à 4 : 2 points à moins d'un jour et demi d'une nouvelle ou pleine lune (1 point à moins de 3,5 jours), plus 2 points quand une période majeure rencontre le soleil (1 quand seule une mineure le fait).

La Lune revient environ 50 minutes plus tard chaque jour : certains jours n'ont que trois périodes (pas de lever de lune, ou un seul passage). Au-delà des cercles polaires, la Lune peut rester levée ou couchée plusieurs jours : seules les périodes majeures restent. Les positions viennent d'astronomy-engine (MIT) : les heures concordent à une ou deux minutes près avec les tables de l'US Naval Observatory.

Dépannage​

  • Aucun appareil dans l'onglet Découverte : aucune maison n'est localisée et aucun coin n'est rempli. Localisez une maison dans Paramètres → Maisons ou saisissez les coordonnées d'un coin, puis enregistrez.
  • « Coordonnées illisibles » dans l'état : saisissez latitude, longitude, la latitude d'abord, en degrés décimaux (pas en degrés et minutes).
  • Heures décalées d'une heure : vérifiez le fuseau horaire de Gladys dans ses paramètres.
  • Journaux : LOG_LEVEL=debug montre chaque calcul.

Limites​

  • La théorie solunaire est une tradition de pêcheurs et de chasseurs, pas une prévision scientifique : la météo, l'eau et la saison comptent tout autant.
  • La note est celle décrite plus haut ; d'autres tables (solunarforecast.com, applications) ont leurs propres échelles et peuvent différer.
  • Les heures d'un coin sont données dans le fuseau horaire de Gladys, même pour un coin situé dans un autre fuseau.
  • Trois coins au plus en plus des maisons.

Non affiliée à un éditeur de tables solunaires. Théorie : John Alden Knight (1926). Calcul : astronomy-engine de Don Cross (MIT).

Paramètres de configuration​

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

ParamètreTypeObligatoireDescription
Périodes solunairessectionNonCalculées dans le conteneur d'après la position de la Lune, sans compte ni internet : périodes majeures (Lune au zénith ou au nadir, 2 h) et mineures (lever et coucher de lune, 1 h). Un appareil par maison localisée et par coin de pêche : enregistrez, puis créez-les dans l'onglet Découverte.
Langue des valeursselectNonNoms des fonctionnalités et textes envoyés à Gladys.
Un appareil par maison localiséebooleanNonUtilise les coordonnées des maisons réglées dans Gladys (Paramètres → Maisons).
Coins de pêchesectionNonJusqu'à trois lieux de plus : un nom et les coordonnées, « latitude, longitude » en degrés décimaux (copiez-les depuis une carte). Videz les coordonnées pour retirer un coin.
Coin 1 : nomstringNon
Coin 1 : latitude, longitudestringNon
Coin 2 : nomstringNon
Coin 2 : latitude, longitudestringNon
Coin 3 : nomstringNon
Coin 3 : latitude, longitudestringNon

Comment installer Solunar dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Solunar 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-solunar: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-solunar.

Solunar 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​

Solunar 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 🙂