National Weather Service Smart-Home-Integration, kostenlos und Open Source
Official US forecasts and alerts from the National Weather Service.
Veröffentlicht von William-De71
- Geräte
- Version 1.0.0
- Erfordert Gladys >=5.1.1
- ★ 0
Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.
This integration brings the forecasts and official alerts of the National Weather Service (NWS), the weather service of the United States, to Gladys. It feeds the dashboard weather widget, the assistant and the alert-driven scenes, and adds three widgets.
Community integration, not affiliated with or endorsed by the National Weather Service or NOAA.
Ready to use
No configuration is needed: the NWS API is free and keyless. Install the integration and it works right away.
The NWS covers the United States and its territories only (Alaska, Hawaii, Puerto Rico, Guam…). For a house elsewhere, Gladys automatically uses another weather provider.
Set the location of each house in its settings: the alert watch, the scene actions and the widgets need it.
What the integration provides
- Current conditions measured at the nearest weather station (temperature, feels-like, humidity, dew point, pressure, wind, gusts, visibility). When no station reported recently, the forecast of the running hour is used.
- Hourly forecast for 24 hours: temperature, feels-like, humidity, cloud cover, wind and gusts, rain amount and chance.
- Daily forecast for 6 to 7 days: high of the day, low of the following night, sky, chance of rain, amount, wind and gusts.
- Sunrise and sunset, computed locally.
- Official alerts (watches, warnings, advisories) with their full text and instructions.
The NWS publishes no UV index.
Alert levels
| Level | Meaning |
|---|---|
| Warning | the hazard is happening or imminent: take action now |
| Watch | conditions are favorable for it: be prepared |
| Advisory | a less serious hazard that may cause inconvenience |
| Statement | information or follow-up |
Alert-driven scenes
Gladys already offers the generic "Weather alert raised" and "Weather alert ended" triggers. Gladys checks the alerts every 30 minutes; this integration additionally watches them every minute and tells Gladys as soon as one changes, so your scene fires within seconds.
The integration adds its own, finer triggers under National Weather Service in the scene editor:
| Trigger | Fires when… | Filters |
|---|---|---|
| NWS alert issued | a new watch, warning or advisory covers the house | house, kind of alert, level, severity |
| NWS alert ended | an alert expired or was cancelled | house, kind of alert, level |
Kinds: tornado, hurricane / tropical storm, severe thunderstorm, flood, winter storm, cold, heat, wind, fire weather, fog, air quality, marine, other.
For instance, to be told about a tornado: trigger NWS alert issued, kind Tornado, level Warning, then a send-message action with the Summary and Instructions variables.
Good to know:
- The House field must hold the house name exactly as shown in Gladys, case included. Empty = every house.
- The NWS never edits an alert: it issues a new one replacing the previous. The integration follows these updates: an extended or amended alert does not fire your scene again.
- An alert that changes level (a Hurricane Watch replaced by a Hurricane Warning, for example) counts as a new alert: NWS alert ended for the old one, NWS alert issued for the new one.
- Alerts already in force when the integration starts fire nothing: only new ones do.
- An alert ends as soon as its end time has passed, or once it is missing from two checks in a row and for at least 5 minutes. If it comes back afterwards, it fires NWS alert issued again: every end is followed by a new start, never by a second end.
Scene actions
| Action | Returns |
|---|---|
| Get the NWS alerts | number of alerts, warnings, watches and advisories, list of events, the most serious one (kind, level, instructions, end), a summary |
| Get the NWS forecast of a day | today to 6 days ahead: high, low, sky, chance of rain, wind, the forecaster's text (day and night), a summary |
| Get the current NWS conditions | temperature, feels-like, humidity, dew point, pressure, wind, gusts, visibility, sky, station, a summary |
Every action has a Summary output, a sentence ready to send in a message.
Dashboard widgets
| Widget | Content |
|---|---|
| NWS alerts | warnings / watches / advisories counters, then each alert; tap one for its full text and instructions. Refreshed as soon as an alert changes. |
| NWS text forecast | the forecaster's narrative, period by period (Tonight, Saturday, Saturday Night…), with the NWS icons |
| NWS next hours | 12, 24 or 48 hours as a curve: temperature and feels-like, chance of rain, or wind and gusts |
Each widget has a House setting (empty = first located house), written exactly as in Gladys.
Configuration (optional)
| Setting | Default | Role |
|---|---|---|
| Contact email | — | the NWS asks every application to identify itself; your email lets it reach you before blocking traffic it finds abusive |
| Cache duration (s) | 600 | how long a forecast is reused (the NWS refreshes them about once an hour) |
| Alert check interval (s) | 60 | how often the alerts of your houses are checked, 30 to 900 seconds |
Konfigurationseinstellungen
Diese Einstellungen fragt National Weather Service in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Ready to use | section | Nein | Forecasts and alerts work with no configuration: the National Weather Service API is free and needs no key. It covers the United States and its territories only — a house elsewhere gets its weather from another provider. |
| Contact email (optional) | string | Nein | Added to the identification the NWS requires from every application, so it can reach you before blocking traffic it finds abusive. Never shared with anyone else. |
| Cache duration (s) | number | Nein | In seconds, between 0 and 3600. How long a forecast is reused before calling the NWS again. The NWS refreshes its forecasts about once an hour: the default of 600 (10 min) costs no freshness. Set to 0 to always call the API. Alerts are not affected: they are checked on their own schedule. |
| Alert check interval (s) | number | Nein | In seconds, between 30 and 900. How often the official alerts of your houses are checked, for the scene triggers and the alerts widget. A Tornado Warning lasts about 30 minutes: the default of 60 s fires your scenes within a minute of its issuance. |
So installierst du National Weather Service in Gladys
- Öffne in Gladys Integrationen: National Weather Service erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/william-de71/gladys-national-weather-service:1.0.0) 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/William-De71/gladys-national-weather-service.
National Weather Service benötigt Gladys >=5.1.1. 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
National Weather Service 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 William-De71 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle externen Integrationen durchsuchen
- Die nativen Integrationen entdecken, die in Gladys eingebaut sind
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation