ISS Overhead Smart-Home-Integration, kostenlos und Open Source
Predicts visible ISS passes over your house and can trigger a scene when one starts.
Veröffentlicht von cicoub13
- Geräte
- Version 0.5.1
- Erfordert Gladys >=5.2.0
- ★ 0
Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.
Overview
Predicts the next visible passes of the International Space Station over your house, shows them on a dashboard widget, and can trigger a scene right before one starts — perfect for "go look outside" automations.
What it shows
The ISS Passes widget displays:
- a photo of the station, and how long until the next visible pass, with its maximum elevation;
- the next few passes, with their time, duration and the direction the ISS rises from (local time, in the language of your Gladys);
- whether the ISS is visible tonight, and whether the orbital data used to compute passes is fresh.
A pass is only shown as visible when the ISS is above the horizon, your house is in the dark, and the ISS itself is still lit by the sun — the same conditions that make it a bright, fast-moving "star" in the evening or early-morning sky.
Automations
- Trigger: "ISS pass starting" — fires shortly before a visible pass begins. Optionally filter by the direction it rises from. Use it to turn on a "look up!" notification, or to switch off outdoor lights that would spoil the view.
- Action: "Get next ISS pass" — fetches the next predicted pass on demand, for scenes that want to announce it (e.g. a voice message) rather than react to it.
Both expose the pass as variables. For a message, prefer the ready-to-read
ones, written in the Scene language of the configuration and in your
local time: start_date (e.g. "Monday, September 28"), start_hour
(e.g. "07:49 PM") and direction_name (e.g. "west"). direction (compass
code, e.g. "W") stays available for scenes that compare it. For example "The ISS passes on start_date at start_hour,
rising in the direction_name." gives "The ISS passes on Monday, September 28
at 07:49 PM, rising in the west.", for a notification as well as a voice
message.
Prerequisites
- Gladys 5.2 or later. The house picker of the configuration needs Gladys 5.2 (the dashboard widget and the scene trigger/action ship with Gladys 5.1); on an earlier version the integration cannot be installed.
- A house with a location in Gladys (house settings, map): the passes are computed for its coordinates.
- Internet access from the Gladys server, to download the orbital data from Celestrak.
No API key needed
Orbital data (TLE) is fetched from Celestrak, a free public source — nothing to sign up for.
Configuration
| Key | Default | Description |
|---|---|---|
| House | (empty) | House the passes are predicted for (see below). |
| Minimum elevation | 10° | Passes that never rise above this angle are ignored. |
| Prediction window | 5 days | How far ahead passes are predicted (3, 5 or 7 days). |
| Scene lead time | 5 minutes | How long before a pass starts the "ISS pass starting" trigger fires (≤60). |
| Scene language | French | Language of the date, time and direction handed to scenes. |
The integration needs your house's location, granted automatically when you install it (no address to type in).
With several houses in Gladys, pick the one to watch the sky from in House. Left empty, or if the chosen house is deleted or has no location anymore, the first house (in alphabetical order) that has a location is used. Make sure the house is located in Gladys (house settings, map): a house without a location cannot be used.
Troubleshooting
- Status "Initialization failed, check the integration logs.": the
integration could not read the location of your house or download the
orbital data. It tries again on its own, waiting a bit longer each time (up
to 30 minutes). Open the Logs tab of the integration to see why:
No house with a known location: no house in Gladys has a location. Place your house on the map in its settings.Celestrak request failed with status …, or a timeout: Celestrak could not be reached. Check the internet access of the Gladys server.
- The widget only shows "Visible soon: No": no visible pass was found in the prediction window. The ISS is only visible under the conditions described above, so several days in a row without a visible pass are normal. You can lower the Minimum elevation or widen the Prediction window to 7 days. The widget also looks like this while the integration has no house location or no orbital data yet (see the previous point).
- "Orbital data: Stale" on the widget: the orbital data is more than 24 hours old, because Celestrak could not be reached. The integration keeps computing the passes with the last data it got and tries again every 6 hours. Check the internet access of the Gladys server if it lasts.
- The passes are computed for the wrong house: the house chosen in
House no longer exists or has no location anymore. The logs then show
The chosen house "…" is unknown or has no location, using "…" instead. Pick a located house in House, or place the chosen one on the map. - The house moved, but the passes did not change: the location is read when the integration starts and each time you save its configuration. Save the configuration again.
- The "ISS pass starting" trigger did not fire: it only fires for visible passes that rise above the Minimum elevation and, when its filter has directions selected, only for those directions. A pass whose trigger time (start minus the Scene lead time) is already over when the integration starts or when you save the configuration is skipped.
- "Get next ISS pass" gives empty variables: no visible pass is predicted in the prediction window. The A pass was found variable is then false: check it in your scene before using the others.
Konfigurationseinstellungen
Diese Einstellungen fragt ISS Overhead in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| House | select | Nein | House the passes are predicted for. Left empty, the first house with a location is used. |
| Minimum elevation (°) | number | Nein | Passes rising below this elevation angle are ignored. |
| Prediction window | select | Nein | How many days ahead to predict passes for. |
| Scene lead time (minutes) | number | Nein | How long before a pass starts the "ISS pass starting" trigger fires. |
| Scene language | select | Nein | Language of the date, time and direction handed to your scenes (notifications, voice messages). |
So installierst du ISS Overhead in Gladys
- Öffne in Gladys Integrationen: ISS Overhead erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/cicoub13/gladys-iss:0.5.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/cicoub13/gladys-iss.
ISS Overhead benötigt Gladys >=5.2.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
ISS Overhead 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 cicoub13 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation