Intégration domotique USGS Volcanoes, gratuite et open source

Niveaux d'alerte des volcans américains (Hawaï, Alaska, Cascades, Yellowstone…) publiés par l'USGS
Suivez depuis Gladys le niveau d'alerte des volcans des États-Unis : Hawaï, l'Alaska, les Cascades, la Californie, Yellowstone, les îles Mariannes du Nord et les Samoa américaines. Les cinq observatoires volcanologiques de l'USGS (United States Geological Survey) évaluent chaque volcan surveillé deux fois :
- le niveau d'alerte volcanique, pour la population au sol : Normal, Vigilance (Advisory), Veille (Watch), Alerte (Warning) ;
- le code couleur aviation, pour les avions : vert, jaune, orange, rouge.
L'intégration les lit dans HANS, le système de notification public de l'USGS. Ni compte, ni clé d'API.
C'est un complément, pas un système d'alerte de sécurité : en cas d'urgence, suivez les bulletins officiels et les consignes des autorités locales. Non affiliée à l'USGS.
Ce que vous obtenez
- Un appareil par volcan suivi : niveau d'alerte, code couleur aviation et dernier bulletin de l'USGS (type, date et, pour les volcans les plus actifs, un résumé d'une ligne), avec leur historique.
- Un appareil Volcans proches : le niveau d'alerte le plus haut des volcans surveillés dans un rayon autour de votre maison, le nombre au-dessus de la normale et le volcan concerné.
- Un widget de tableau de bord qui liste vos volcans, les plus actifs en premier, chacun avec son bulletin et sa page USGS.
- Un déclencheur de scène quand le niveau d'alerte ou le code couleur d'un volcan suivi ou proche change.
- Une action de scène qui lit les niveaux en une phrase, à envoyer par message ou à faire lire à voix haute.
Prérequis
- Gladys Assistant 5.3 ou plus récent.
- Un accès à Internet depuis la machine de Gladys (l'intégration lit
volcanoes.usgs.gov). - Pour les volcans proches : une position pour votre maison dans Gladys (Paramètres → Maisons), ou des coordonnées saisies dans la configuration.
Configuration
Installez l'intégration depuis le store (ou Intégrations → Installer depuis GitHub, avec l'adresse
https://github.com/guim31/gladys-usgs-volcanoes), puis ouvrez son onglet Configuration.
Réglages
| Réglage | Défaut | Effet |
|---|---|---|
| Volcans suivis | vide | Noms, numéros de volcan ou codes d'observatoire, séparés par des virgules |
| Volcans proches : rayon | 200 km | Désactivé, 50, 100, 200, 500 ou 1 000 km autour du centre |
| Latitude du centre | vide | Laissez les deux coordonnées vides pour utiliser la position de votre maison |
| Longitude du centre | vide | Degrés décimaux, ouest négatif (-121.7603) |
| Intervalle de rafraîchissement | 15 minutes | 10, 15, 30 ou 60 minutes |
| Langue des textes | Français | Noms des appareils et fonctionnalités (à la création) et textes des scènes |
Enregistrez, puis ouvrez l'onglet Découverte : un appareil par volcan suivi, plus Volcans proches si un rayon est choisi. Ajoutez à Gladys ceux que vous voulez.
Choisir les volcans
Saisissez les noms comme l'USGS les écrit, séparés par des virgules. Majuscules, accents et
« Mount »/« Mt » n'ont pas d'importance : kilauea, Kīlauea, St. Helens et mt rainier fonctionnent,
de même qu'une partie d'un seul nom (shasta). Une partie commune à plusieurs volcans (sitkin : Great
Sitkin et Little Sitkin) est ambiguë et ignorée. Vous pouvez aussi saisir le numéro Smithsonian du volcan
(332010) ou un code d'observatoire pour suivre tous ses volcans. L'onglet Configuration liste les noms
introuvables.
Les volcans surveillés au 12/11/2026, par observatoire :
avo, Alaska Volcano Observatory : Akutan, Aniakchak, Atka volcanic complex, Augustine, Cleveland, Dutton, Edgecumbe, Fisher, Gareloi, Great Sitkin, Griggs, Iliamna, Isanotski, Kanaga, Katmai, Korovin, Little Sitkin, Mageik, Makushin, Martin, Novarupta, Okmok, Pavlof, Redoubt, Semisopochnoi, Shishaldin, Snowy Mountain, Spurr, Takawangha, Tanaga, Trident, Ugashik-Peulik, Ukinrek Maars, Veniaminof, Westdahl, Wrangell.calvo, California Volcano Observatory : Clear Lake Volcanic Field, Coso Volcanic Field, Lassen Volcanic Center, Long Valley Caldera, Mammoth Mountain, Medicine Lake volcano, Mono Lake Volcanic Field, Mono-Inyo Craters, Mount Shasta, Salton Buttes, Ubehebe Craters.cvo, Cascades Volcano Observatory : Crater Lake, Glacier Peak, Mount Adams, Mount Baker, Mount Hood, Mount Jefferson, Mount Rainier, Mount St. Helens, Newberry, Three Sisters.hvo, Hawaiian Volcano Observatory : Haleakala, Hualalai, Kilauea, Mauna Kea, Mauna Loa, et aux Samoa américaines Ofu-Olosega, Ta'u Island, Tutuila Island.nmi, îles Mariannes du Nord : Ahyi Seamount.yvo, Yellowstone Volcano Observatory : Yellowstone.
Les autres volcans américains n'ont pas de niveau d'alerte (pas de surveillance en temps réel) : ils ne peuvent pas être suivis.
Appareils
Chaque volcan suivi est un appareil à son nom (« Volcan Kilauea ») :
| Fonctionnalité | Valeurs |
|---|---|
| Niveau d'alerte volcanique | 0 Normal, 1 Vigilance, 2 Veille, 3 Alerte (niveau de risque) |
| Code couleur aviation | 0 vert, 1 jaune, 2 orange, 3 rouge (niveau de risque) |
| Dernier bulletin USGS | « Bulletin quotidien, 11/11/2026: … » — type, date, résumé |
Volcans proches résume les volcans surveillés dans le rayon :
| Fonctionnalité | Valeurs |
|---|---|
| Niveau d'alerte le plus haut | 0 à 3, comme ci-dessus |
| Volcans au-dessus de la normale | nombre de volcans au-dessus de Normal ou de vert |
| Volcan le plus actif | « Mount Rainier : Veille / Orange, à 94 km », ou « aucun » |
Les niveaux d'alerte ont une valeur numérique : une condition de scène « niveau d'alerte supérieur ou égal à 2 » réagit à Veille et Alerte, les cas où l'USGS juge une éruption probable ou en cours. L'historique de la fonctionnalité de niveau d'alerte donne la date de chaque changement.
Widget de tableau de bord
Ajoutez le widget Volcans USGS à un tableau de bord : le nombre de volcans au-dessus de la normale, puis vos volcans suivis et les volcans proches au-dessus de la normale (8 au plus), les plus actifs en premier. Chaque ligne montre le code couleur aviation, l'observatoire et la distance ; touchez-la pour le dernier bulletin, son résumé, la date du dernier changement de niveau (dès que l'intégration en a vu un) et les liens vers le bulletin et la page du volcan.
Deux réglages : Seulement au-dessus de la normale masque les volcans calmes, Lien vers USGS HANS affiche ou masque le bouton du bas.
Déclencheurs de scène
Volcan USGS : niveau d'alerte changé se déclenche quand le niveau d'alerte ou le code couleur aviation d'un volcan suivi, ou d'un volcan dans le rayon, change. Filtres, tous facultatifs : le nouveau niveau d'alerte, la nouvelle couleur aviation et le sens (en hausse ou en baisse).
Variables : alert_level, aviation_color et direction (mots anglais stables), volcano, vnum,
observatory, alert_level_name et aviation_color_name (dans la langue de la configuration),
previous_alert_level, previous_aviation_color, distance_km (vide sans centre), summary
(« Kilauea : Veille / Orange, à 4 317 km ») et notice_url.
Les niveaux déjà là au premier démarrage ne déclenchent rien, pas plus qu'un volcan que vous commencez à suivre : seuls comptent les changements vus par l'intégration. Les derniers niveaux sont gardés : un changement survenu pendant un arrêt de l'intégration se déclenche au démarrage suivant, rien d'autre.
Action de scène
Volcans USGS : lire les niveaux relit HANS si besoin et renvoie :
text: une phrase, par exemple « 1 volcan au-dessus de la normale : Kilauea : Vigilance / Jaune ; Mount Rainier : Normal / Vert, à 94 km. » (5 volcans au plus, puis « et N de plus ») ;max_level:none,normal,advisory,watchouwarning;elevated_count: le nombre de volcans au-dessus de la normale.
Le bouton Afficher les niveaux actuels de l'onglet Configuration donne la même phrase.
Exemples de scènes
- Recevoir un message quand un volcan proche passe en Veille ou en Alerte : déclencheur « Volcan USGS :
niveau d'alerte changé », filtres « Veille, Alerte » et « En hausse », puis envoyer
summaryetnotice_url. - Chaque matin, lire les niveaux à voix haute : déclencheur planifié, action « Volcans USGS : lire les
niveaux », puis dire
text. - Allumer une lampe en orange tant que le Mount Rainier est au-dessus de la normale : condition sur son appareil de niveau d'alerte.
Sources des données, conditions et quotas
Les données viennent du Volcano Hazards Program de l'USGS, par l'API publique HANS
(https://volcanoes.usgs.gov/hans-public/api/) : les volcans surveillés et leurs niveaux à chaque
rafraîchissement, les résumés des plus actifs (alertes CAP) et la position des volcans américains une fois
par jour. Les données de l'USGS sont dans le domaine public ; l'intégration cite la source dans le widget.
HANS ne publie pas de quota : l'intégration demande au plus trois petits documents par rafraîchissement,
toutes les 15 minutes par défaut.
Lisez les niveaux d'alerte expliqués par l'USGS (en anglais).
Dépannage
- « Introuvable parmi les volcans surveillés, ou ambigu » : vérifiez l'orthographe dans la liste ci-dessus, ou saisissez le numéro du volcan. Un volcan sans surveillance en temps réel n'a pas de niveau.
- « Aucun centre pour les volcans proches » : indiquez la position de votre maison dans Gladys, ou saisissez des coordonnées.
- « L'USGS (HANS) ne répond pas » : les valeurs restent les mêmes ; l'intégration réessaie au rafraîchissement suivant. Vérifiez l'accès à Internet de la machine de Gladys.
- Pas de nouvel appareil après un changement de la liste : ouvrez l'onglet Découverte et ajoutez-le.
- Lancez le conteneur avec
LOG_LEVEL=debugpour voir chaque rafraîchissement dans ses logs.
Limites
- Seulement les volcans des États-Unis surveillés par l'USGS ; les niveaux sont ceux du dernier bulletin.
- La date du dernier changement de niveau n'est connue que par l'observation de l'intégration (HANS ne la donne pas) ; l'historique de la fonctionnalité dans Gladys la garde.
- Les bulletins et résumés sont en anglais, comme l'USGS les écrit.
- Le nom d'un appareil et de ses fonctionnalités est fixé à sa création, dans la langue choisie alors.
Paramètres de configuration
Voici les paramètres demandés par USGS Volcanoes dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Vos volcans | section | Non | Les observatoires volcanologiques de l'USGS classent les volcans américains surveillés : niveau d'alerte au sol (Normal, Vigilance, Veille, Alerte) et code couleur aviation (vert à rouge). Suivez des volcans par leur nom, et/ou tous ceux autour de votre maison. |
| Volcans suivis | string | Non | Noms séparés par des virgules (Kilauea, Mount St. Helens…), numéros de volcan, ou un observatoire (avo, calvo, cvo, hvo, nmi, yvo) pour tous ses volcans. Un appareil par volcan. |
| Volcans proches : rayon | select | Non | Un appareil « Volcans proches » donne le niveau d'alerte le plus haut des volcans surveillés à cette distance de votre maison. Désactivé : pas d'appareil. |
| Latitude du centre | string | Non | Laissez les deux coordonnées vides pour utiliser la position de votre maison dans Gladys. |
| Longitude du centre | string | Non | Degrés décimaux, ouest négatif. |
| Intervalle de rafraîchissement | select | Non | Les observatoires publient quelques bulletins par jour au plus ; un changement de niveau vient toujours avec un bulletin. |
| Langue des textes | select | Non | Noms des appareils et fonctionnalités (à leur création) et textes envoyés aux scènes. |
| Sources et limites | section | Non | Données : USGS Volcano Hazards Program (domaine public), lues sans compte. Non affiliée à l'USGS. Pas un système d'alerte de sécurité : suivez les bulletins officiels et les autorités locales. |
Comment installer USGS Volcanoes dans Gladys
- Dans Gladys, ouvrez Intégrations : USGS Volcanoes 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/guim31/gladys-usgs-volcanoes: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). - 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/guim31/gladys-usgs-volcanoes.
USGS Volcanoes nécessite Gladys >=5.3.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
USGS Volcanoes 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.
- 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