Aller au contenu principal

Intégration domotique USGS Volcanoes, gratuite et open source

Intégration USGS Volcanoes pour Gladys Assistant

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églageDéfautEffet
Volcans suivisvideNoms, numéros de volcan ou codes d'observatoire, séparés par des virgules
Volcans proches : rayon200 kmDésactivé, 50, 100, 200, 500 ou 1 000 km autour du centre
Latitude du centrevideLaissez les deux coordonnées vides pour utiliser la position de votre maison
Longitude du centrevideDegrés décimaux, ouest négatif (-121.7603)
Intervalle de rafraîchissement15 minutes10, 15, 30 ou 60 minutes
Langue des textesFrançaisNoms 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 volcanique0 Normal, 1 Vigilance, 2 Veille, 3 Alerte (niveau de risque)
Code couleur aviation0 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 haut0 à 3, comme ci-dessus
Volcans au-dessus de la normalenombre 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, watch ou warning ;
  • 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 summary et notice_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=debug pour 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ètreTypeObligatoireDescription
Vos volcanssectionNonLes 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 suivisstringNonNoms 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 : rayonselectNonUn 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 centrestringNonLaissez les deux coordonnées vides pour utiliser la position de votre maison dans Gladys.
Longitude du centrestringNonDegrés décimaux, ouest négatif.
Intervalle de rafraîchissementselectNonLes observatoires publient quelques bulletins par jour au plus ; un changement de niveau vient toujours avec un bulletin.
Langue des textesselectNonNoms des appareils et fonctionnalités (à leur création) et textes envoyés aux scènes.
Sources et limitessectionNonDonné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​

  1. Dans Gladys, ouvrez Intégrations : USGS Volcanoes 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-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).
  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-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.

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 🙂