Intégration ISS Overhead pour Gladys Assistant

Prédit les passages visibles de l'ISS au-dessus de chez vous et peut déclencher une scène.
Nécessite Gladys 5.1 ou supérieur. Le widget de dashboard et le déclencheur/action de scène dont cette intégration est faite sont livrés avec Gladys 5.1 ; sur une version antérieure, elle ne peut pas être installée.
Prédit les prochains passages visibles de la Station Spatiale Internationale au-dessus de votre maison, les affiche sur un widget de dashboard, et peut déclencher une scène juste avant qu'un passage commence — parfait pour une automatisation "va voir dehors".
Ce qui est affiché
Le widget Passages ISS affiche :
- une photo de la station, et dans combien de temps aura lieu le prochain passage, avec son élévation maximale ;
- les prochains passages, avec leur heure, leur durée et la direction depuis laquelle l'ISS se lève ;
- si l'ISS est visible ce soir, et si les données orbitales utilisées pour le calcul sont à jour.
Un passage n'est affiché comme visible que si l'ISS est au-dessus de l'horizon, que votre maison est dans le noir, et que l'ISS elle-même est encore éclairée par le soleil — les conditions qui en font une "étoile" brillante et rapide dans le ciel du soir ou du petit matin.
Automatisations
- Déclencheur « Passage ISS en cours de démarrage » — se déclenche peu avant le début d'un passage visible. Filtrable par direction de lever. Utile pour une notification "regarde le ciel !", ou pour éteindre un éclairage extérieur qui gênerait l'observation.
- Action « Obtenir le prochain passage ISS » — récupère le prochain passage prédit à la demande, pour une scène qui veut l'annoncer (message vocal, par exemple) plutôt que réagir à son démarrage.
Configuration
| Clé | Défaut | Description |
|---|---|---|
| Élévation minimale | 10° | Les passages ne dépassant jamais cette élévation sont ignorés. |
| Fenêtre de prédiction | 5 jours | Sur combien de jours prédire les passages (3, 5 ou 7). |
L'intégration a besoin de la localisation de votre maison, accordée automatiquement à l'installation (aucune adresse à saisir).
Aucune clé API nécessaire
Les données orbitales (TLE) sont récupérées sur Celestrak, une source publique gratuite — rien à créer comme compte.
Paramètres de configuration
Voici les paramètres demandés par ISS Overhead dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Élévation minimale (°) | number | Non | Les passages ne dépassant pas cette élévation sont ignorés. |
| Fenêtre de prédiction | select | Non | Nombre de jours à l'avance pour lesquels prédire les passages. |
Comment installer ISS Overhead dans Gladys
- Dans Gladys, ouvrez Intégrations : ISS Overhead 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/cicoub13/gladys-iss:0.2.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). - 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/cicoub13/gladys-iss.
ISS Overhead 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
ISS Overhead 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 cicoub13, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations externes
- Découvrir les intégrations natives intégrées à Gladys
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation