Intégration domotique Pirate Weather, gratuite et open source
Prévisions mondiales, pluie minute par minute et alertes météo officielles, clé d'API gratuite.
Publiée par guim31
- Appareils
- Version 1.1.0
- Nécessite Gladys >=5.1.0
- ★ 0
La météo dans Gladys par Pirate Weather, le successeur ouvert de l'API Dark Sky : conditions actuelles, prévisions sur 24 heures et sur 8 jours, la pluie et la neige des 60 prochaines minutes minute par minute, et les alertes météo officielles — tornades, orages violents, crues soudaines, ouragans, canicules, tempêtes de neige du National Weather Service aux États-Unis, ainsi que les alertes d'Environnement Canada et des services météo européens.
Elle fonctionne partout dans le monde avec une clé d'API gratuite.
Powered by Pirate Weather. Cette intégration est un projet communautaire, non affilié à Pirate Weather.
Ce que vous obtenez
- Le widget météo de Gladys et l'assistant de chat utilisent Pirate Weather : conditions actuelles, prochaines 24 heures, 8 prochains jours, lever et coucher du soleil, indice UV, et les alertes en cours avec leur texte complet. Tout s'affiche en °C et m/s ou en °F et mph, selon le système d'unités de chaque utilisateur de Gladys.
- Scènes sur alerte météo : le déclencheur « Alerte météo » intégré à Gladys fonctionne avec les alertes Pirate Weather — par exemple « quand une alerte orage extrême concerne ma maison, allumer toutes les lumières et m'envoyer un message ». L'intégration prévient Gladys dès qu'une alerte apparaît ou change : la scène démarre dans la minute qui suit la mise à jour qui l'a vue.
- Déclencheur de scène « Pluie ou neige attendue dans l'heure » : se déclenche quand la prévision minute par minute se met à annoncer des précipitations dans l'heure.
- Action de scène « Obtenir les précipitations de l'heure à venir » : dit à une scène si de la pluie ou de la neige arrive, quand et avec quelle intensité — pour rentrer le store ou sauter l'arrosage.
- Widget « Précipitations dans l'heure » : le graphique minute par minute des 60 prochaines minutes.
Avant de commencer : obtenir votre clé d'API gratuite
- Allez sur pirateweather.net et cliquez sur Sign up.
- Une fois connecté, souscrivez à l'API forecast avec l'offre gratuite (10 000 appels par mois). Sans cette étape, la clé est refusée.
- Copiez votre clé d'API (API key).
Une nouvelle clé peut mettre jusqu'à 20 minutes à fonctionner : si le test ci-dessous échoue juste après l'inscription, patientez un peu et réessayez.
Installation
- Dans Gladys, vérifiez que votre maison a une position : Paramètres → Maisons, puis renseignez l'adresse ou la position sur la carte. L'intégration met à jour la météo de chaque maison qui en a une.
- Installez Pirate Weather depuis le catalogue d'intégrations. Gladys vous demande d'autoriser l'accès à la position de vos maisons : il sert à récupérer leur météo.
- Ouvrez l'onglet Configuration, collez votre clé d'API et enregistrez.
- Cliquez sur Tester la clé d'API. La réponse indique la température actuelle à votre maison et les appels restants ce mois-ci.
C'est tout : le widget météo de votre tableau de bord affiche maintenant Pirate Weather. Si une autre intégration météo est installée, vous pouvez choisir le fournisseur dans les réglages du widget météo.
Configuration
- Clé d'API Pirate Weather — votre clé. Elle n'est envoyée qu'à Pirate Weather, et jamais écrite dans les journaux.
- Fréquence de mise à jour — laissez Automatique sauf raison particulière (voir plus bas). Les choix manuels vont de toutes les 15 minutes à toutes les 2 heures.
- Langue des textes de scène — la langue des phrases que l'intégration écrit dans les variables de scène (« Pluie forte attendue dans 12 minutes (probabilité 90 %). ») : anglais, français, allemand ou espagnol. Automatique suit la langue de votre Gladys.
Fréquence des mises à jour et quota
Chaque mise à jour coûte un appel par maison, et cet appel unique sert à tout : tableau de bord, chat, alertes, scènes et widget. Ouvrir le tableau de bord ne coûte rien : Gladys est servi depuis la prévision gardée en mémoire.
En mode Automatique, l'intégration garde ses mises à jour sous la moitié de votre quota mensuel, et ne descend jamais sous 15 minutes (l'intervalle recommandé par Pirate Weather) :
| Maisons avec une position | Offre gratuite (10 000 appels) | Offre à 2 $/mois (20 000 appels) |
|---|---|---|
| 1 | toutes les 15 min — 2 976/mois | toutes les 15 min — 2 976/mois |
| 2 | toutes les 20 min — 4 464/mois | toutes les 15 min — 5 952/mois |
| 3 | toutes les 30 min — 4 464/mois | toutes les 15 min — 8 928/mois |
| 4 | toutes les 45 min — 3 968/mois | toutes les 20 min — 8 928/mois |
L'autre moitié est une marge de sécurité : redémarrages, maison ajoutée en cours de mois, bouton de test, et tout autre usage de la même clé.
Chaque réponse de Pirate Weather indique le nombre d'appels restants jusqu'à la remise à zéro mensuelle, et l'intégration le surveille : si les appels restants ne suffisent pas à tenir le rythme jusqu'à la remise à zéro (clé partagée avec une autre application, par exemple), l'intervalle s'allonge pour tenir. Un intervalle manuel suit la même règle. Quand il ne reste qu'une poignée d'appels, les mises à jour s'arrêtent jusqu'à la remise à zéro : Gladys continue d'afficher la dernière prévision pendant 3 heures au plus, puis passe à son autre fournisseur météo s'il en a un.
Vous pouvez suivre votre consommation à tout moment sur la page de consommation Pirate Weather.
Scènes
Alertes météo (intégrées à Gladys)
Dans une scène, choisissez le déclencheur Alerte météo, la maison, un phénomène (tous, vent, orage, inondation, canicule, froid, neige…) et une sévérité minimale. Les alertes Pirate Weather sont classées pour lui :
- Sévérité : la sévérité officielle — Extrême pour une alerte tornade, Sévère pour la plupart des alertes, Modérée pour les veilles et vigilances jaunes, Mineure pour les bulletins.
- Phénomène : lu dans le titre de l'alerte, en anglais, français, allemand ou espagnol. Les tornades et orages violents sont orage ; les ouragans et tempêtes tropicales, vent ; les submersions, fortes houles et courants d'arrachement, côtier ; tempêtes de neige, blizzards, pluies verglaçantes, neige ; refroidissement éolien, gel, froid. Une alerte sans phénomène reconnu (risque d'incendie, qualité de l'air, bulletin spécial) déclenche quand même les scènes « tous phénomènes ».
Exemple : Alerte météo, maison Maison, phénomène orage, sévérité extrême → allumer toutes les lumières et envoyer un message à la famille.
Pluie ou neige attendue dans l'heure
Se déclenche une fois quand la prévision minute par minute annonce des précipitations dans l'heure, là où la mise à jour précédente n'en annonçait pas. Filtres : la maison (son nom, exactement comme dans Gladys ; vide pour toutes), le type de précipitations (pluie, neige, grésil, pluie verglaçante) et l'intensité la plus forte attendue (faible, modérée, forte).
Variables pour les actions suivantes : la maison, le type, l'intensité, les minutes avant le début, la probabilité, et une phrase toute prête — par exemple « Pluie forte attendue dans 18 minutes (probabilité 90 %). »
Une minute compte comme humide à partir de 0,1 mm/h avec une probabilité d'au moins 40 %. Faible : moins de 2,5 mm/h ; forte : plus de 7,6 mm/h. Le déclencheur ne se répète pas pour une même maison avant 45 minutes, et jamais à la première mise à jour après un redémarrage.
Obtenir les précipitations de l'heure à venir
Une action de scène qui lit la prévision minute par minute d'une maison (vide : votre première maison) et renvoie si des précipitations sont attendues, dans combien de minutes, leur type, leur intensité, leur probabilité, et une phrase. Placez une condition sur Précipitations attendues pour décider de la suite. Elle ne coûte aucun appel.
Tableau de bord
- Le widget Météo de Gladys affiche Pirate Weather dès que l'intégration est configurée.
- Le widget Précipitations dans l'heure, à ajouter à un tableau de bord comme tout widget, dessine les 60 prochaines minutes en mm/h ou en in/h. Laissez le réglage « Maison » vide pour votre première maison, ou saisissez le nom d'une autre.
Limites
- Le minute par minute vient d'un modèle, pas d'un radar. Aux États-Unis, du modèle HRRR infra-horaire ; ailleurs, de modèles mondiaux plus grossiers. Il est rafraîchi au rythme de votre quota, toutes les 15 minutes au mieux : une averse qui naît entre deux mises à jour est annoncée par la suivante. Pour la France, l'intégration Météo France et son radar de pluie à une heure restent plus précis.
- Les alertes dépendent de la région. États-Unis (National Weather Service), Canada et Europe sont bien couverts ; ailleurs, cela dépend de ce que le service national publie à l'OMM. Hors États-Unis, les titres des alertes sont dans la langue du service national.
- Pas de prévision minute par minute pour un lieu : le déclencheur reste muet, l'action et le widget le signalent.
- Les maisons sont désignées par leur nom dans les champs des scènes et du widget : saisissez le nom exactement comme dans Gladys.
- L'intégration demande Gladys 5.1 ou plus récent.
Dépannage
- « Pirate Weather refuse la clé d'API » — vérifiez la clé, et que vous avez souscrit à l'API forecast dans votre compte Pirate Weather. Une nouvelle clé peut mettre 20 minutes à fonctionner. Cliquez ensuite sur Tester la clé d'API : si cela fonctionne, les mises à jour reprennent d'elles-mêmes.
- « Quota mensuel Pirate Weather épuisé » — les mises à jour reprennent après la remise à zéro mensuelle (la date est indiquée). Réduisez le nombre de maisons ou allongez l'intervalle, ou soutenez Pirate Weather pour doubler votre quota.
- « Aucune maison de Gladys n'a de position » — renseignez la position de votre maison dans Paramètres → Maisons.
- Le tableau de bord affiche toujours un autre fournisseur — ouvrez les réglages du widget météo et choisissez Pirate Weather.
- Journaux : l'onglet Journaux de l'intégration montre chaque mise à jour et l'intervalle choisi (« next refresh in 15 min (auto) »).
Confidentialité
Les coordonnées de vos maisons et votre clé d'API sont envoyées à Pirate Weather pour obtenir la prévision, et nulle part ailleurs. Rien n'est écrit sur le disque.
Crédits
Données météo : Pirate Weather, créé par @alexander0042 — powered by Pirate Weather. Merci aux soutiens de Pirate Weather qui font vivre l'offre gratuite.
Paramètres de configuration
Voici les paramètres demandés par Pirate Weather dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Obtenez votre clé d'API gratuite | section | Non | Inscrivez-vous sur pirateweather.net, souscrivez à l'API forecast gratuite (10 000 appels par mois) et collez votre clé ci-dessous. Une nouvelle clé peut mettre jusqu'à 20 minutes à fonctionner. Powered by Pirate Weather ; cette intégration n'est pas affiliée à Pirate Weather. |
| Clé d'API Pirate Weather | secret | Oui | La clé affichée dans votre compte Pirate Weather. Elle n'est envoyée qu'à Pirate Weather. |
| Fréquence de mise à jour | select | Non | Automatique garde les mises à jour sous la moitié de votre quota mensuel : toutes les 15 minutes pour une maison avec l'offre gratuite. Chaque mise à jour coûte un appel par maison. |
| Langue des textes de scène | select | Non | Langue des phrases que l'intégration met dans les variables de scène. Automatique suit la langue de votre Gladys. |
Comment installer Pirate Weather dans Gladys
- Dans Gladys, ouvrez Intégrations : Pirate Weather 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-pirate-weather:1.1.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-pirate-weather.
Pirate Weather 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
Pirate Weather 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 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