Zum Hauptinhalt springen

Solunar Smart-Home-Integration, kostenlos und Open Source

Solunar-Integration für Gladys Assistant

Solunar-Perioden zum Angeln und Jagen, lokal berechnet: Haupt- und Nebenperioden, Tagesnote.

Die Solunar-Perioden in Gladys, zum Angeln und Jagen: die Zeiten des Tages, zu denen Fische und Wild am aktivsten sein sollen, nach der Theorie, die John Alden Knight 1926 veröffentlicht hat. Alles wird im Container aus der Position von Mond und Sonne berechnet: ohne Konto, ohne Schlüssel, ohne Internetzugang.

Was du bekommst​

  • Ein Gerät pro Ort: jedes verortete Haus von Gladys und bis zu drei Angelplätze aus der Konfiguration. Jedes Gerät liefert die laufende Periode (keine, Haupt- oder Nebenperiode und ihr Ende), einen Schalter „Periode aktiv“, die nächste Periode und die Minuten bis dahin, die Tagesnote von 0 bis 4, die Mondphase und die Mondbeleuchtung.
  • Ein Dashboard-Widget: die Perioden des Tages an einem Ort, die laufende in Grün, die Tagesnote und der Mond.
  • Ein Szenen-Auslöser: eine Solunar-Periode beginnt, gefiltert nach Ort, Art (Haupt- oder Nebenperiode) und Tagesnote.
  • Eine Szenen-Aktion: Perioden, Note und Mond von heute oder morgen an einem Ort, in einem Satz zum Versenden als Nachricht.

Diese Integration liefert die Angelzeiten. Für den Mond selbst (Phase, Auf- und Untergang, Mondereignisse) gibt es das Widget gladys-moon-phase: beide laufen nebeneinander.

Voraussetzungen​

  • Gladys Assistant 5.1.0 oder neuer (Widgets, Szenen-Auslöser und -Aktionen).
  • Ein in Gladys verortetes Haus (Einstellungen → Häuser) oder die Koordinaten eines Platzes.

Die Integration wird von GitHub installiert: Integrationen → Von GitHub installieren, Adresse https://github.com/guim31/gladys-solunar.

Konfiguration​

EinstellungStandardWirkung
Sprache der WerteFranzösischSprache der Funktionsnamen und der an Gladys gesendeten Texte.
Ein Gerät pro verortetem HausAnNutzt die Koordinaten der in Gladys eingestellten Häuser.
Platz 1 bis 3: NameleerName des Geräts des Platzes (später in Gladys umbenennbar).
Platz 1 bis 3: Breite, LängeleerBreite, Länge in Dezimalgrad, z. B. 43.6047, 1.4442.

Die Koordinaten lassen sich aus jeder Karte kopieren (Rechtsklick in OpenStreetMap oder Google Maps). Ein Dezimalkomma geht auch: 43,6047; 1,4442. Leere die Koordinaten eines Platzes, um ihn zu entfernen. Speichere und lege die Geräte dann im Tab Entdecken an. Der Knopf Orte prüfen listet jeden Ort mit seiner Tagesnote.

Die Koordinaten der Häuser werden beim Start, bei jeder Suche und alle 6 Stunden gelesen: Nachdem du ein Haus verschoben hast, drücke Orte prüfen.

Geräte​

FunktionTypBeispiel
Solunar-PeriodeTextHauptperiode bis 18:40
Solunar-Periode aktivbinär1 während jeder Periode
Nächste Solunar-PeriodeTextNebenperiode morgen um 05:10
Nächste Periode in (min)Dauer95
Tagesbewertung (0-4)Zahl3
MondphaseTextZunehmender Mond
Mondbeleuchtung (%)Zahl78

Die Zeiten sind die der Zeitzone von Gladys, ein Tag geht von Mitternacht bis Mitternacht. Die Werte werden jede Minute berechnet, nur die Änderungen werden gesendet.

Dashboard-Widget​

Solunar-Perioden: Wähle einen Ort (standardmäßig den ersten). Es zeigt die Tagesnote, die Mondbeleuchtung und dann jede Periode des Tages: vorbei, laufend (grün) oder kommend. Ein ☀ markiert eine Periode, die auf einen Sonnenauf- oder -untergang trifft. Die Einstellung Mond anzeigen blendet die Mondkachel und die Phase aus.

Szenen-Auslöser​

Solunar-Periode begonnen, wenn an einem Ort eine Haupt- oder Nebenperiode beginnt. Filter: der Ort, die Art der Periode, die Tagesnote. Variablen: place (Ort), start (Beginn), end (Ende), with_sun (die Periode trifft auf einen Sonnenauf- oder -untergang) und summary, ein fertiger Satz.

Ein Neustart der Integration mitten in einer Periode löst sie nicht noch einmal aus.

Szenen-Aktion​

Solunar-Tag abrufen: Für einen Ort und einen Tag (heute oder morgen) liefert sie summary (ein Satz), rating (die Note), periods (die Liste mit Uhrzeiten), moon_phase und illumination.

Szenen-Beispiele​

  • Jeden Abend um 20 Uhr Solunar-Tag abrufen für morgen am See und die Zusammenfassung als Nachricht senden: Der Ausflug wird am Vortag geplant.
  • Solunar-Periode begonnen, Art Hauptperiode, Note 3 oder 4: eine Benachrichtigung „sie beißen“.
  • Bedingung auf Nächste Periode in (min) unter 30 am Haus: Zeit, die Ausrüstung vorzubereiten.

Wie gerechnet wird​

  • Hauptperioden, zwei Stunden: Der Mond kreuzt den Meridian über uns (obere Kulmination) oder unter unseren Füßen (untere Kulmination), zentriert auf den Durchgang.
  • Nebenperioden, eine Stunde: Mondaufgang und Monduntergang, zentriert auf das Ereignis.
  • Eine Periode ist mit der Sonne, wenn ein Sonnenauf- oder -untergang in sie fällt oder weniger als 30 Minuten von ihren Rändern entfernt liegt.
  • Tagesnote, 0 bis 4: 2 Punkte bis 1,5 Tage um Neu- oder Vollmond (1 Punkt bis 3,5 Tage), dazu 2 Punkte, wenn eine Hauptperiode auf die Sonne trifft (1, wenn nur eine Nebenperiode es tut).

Der Mond kommt jeden Tag etwa 50 Minuten später: Manche Tage haben nur drei Perioden (kein Mondaufgang oder nur eine Kulmination). Jenseits der Polarkreise kann der Mond tagelang über oder unter dem Horizont bleiben: Dann bleiben nur die Hauptperioden. Die Positionen stammen von astronomy-engine (MIT): Die Zeiten stimmen auf ein bis zwei Minuten mit den Tabellen des US Naval Observatory überein.

Fehlerbehebung​

  • Kein Gerät im Tab Entdecken: Kein Haus ist verortet und kein Platz ausgefüllt. Verorte ein Haus unter Einstellungen → Häuser oder gib die Koordinaten eines Platzes ein und speichere.
  • „Unlesbare Koordinaten“ im Status: Gib Breite, Länge ein, die Breite zuerst, in Dezimalgrad (nicht in Grad und Minuten).
  • Zeiten um eine Stunde verschoben: Prüfe die Zeitzone von Gladys in den Einstellungen.
  • Protokolle: LOG_LEVEL=debug zeigt jede Berechnung.

Grenzen​

  • Die Solunar-Theorie ist eine Tradition von Anglern und Jägern, keine wissenschaftliche Vorhersage: Wetter, Wasser und Jahreszeit zählen genauso.
  • Die Note ist die oben beschriebene; andere Tabellen (solunarforecast.com, Apps) haben eigene Skalen und können abweichen.
  • Die Zeiten eines Platzes stehen in der Zeitzone von Gladys, auch für einen Platz in einer anderen Zeitzone.
  • Höchstens drei Plätze zusätzlich zu den Häusern.

Mit keinem Herausgeber von Solunar-Tabellen verbunden. Theorie: John Alden Knight (1926). Berechnung: astronomy-engine von Don Cross (MIT).

Konfigurationseinstellungen​

Diese Einstellungen fragt Solunar in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Solunar-PeriodensectionNeinIm Container aus der Mondposition berechnet, ohne Konto und ohne Internet: Hauptperioden (Mond im Zenit oder Nadir, 2 h) und Nebenperioden (Mondauf- und -untergang, 1 h). Ein Gerät pro verortetem Haus und pro Angelplatz: speichere und lege sie dann im Tab „Entdecken“ an.
Sprache der WerteselectNeinNamen der Funktionen und an Gladys gesendete Texte.
Ein Gerät pro verortetem HausbooleanNeinNutzt die Koordinaten der Häuser in Gladys (Einstellungen → Häuser).
AngelplätzesectionNeinBis zu drei weitere Orte: ein Name und die Koordinaten, „Breite, Länge“ in Dezimalgrad (kopiere sie aus einer Karte). Leere die Koordinaten, um einen Platz zu entfernen.
Platz 1: NamestringNein
Platz 1: Breite, LängestringNein
Platz 2: NamestringNein
Platz 2: Breite, LängestringNein
Platz 3: NamestringNein
Platz 3: Breite, LängestringNein

So installierst du Solunar in Gladys​

  1. Öffne in Gladys Integrationen: Solunar erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/guim31/gladys-solunar:1.0.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-solunar.

Solunar benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Über externe Integrationen​

Solunar ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂