OpenWeather Community-Integration, kostenlos und Open Source
Weather conditions, forecasts and alerts from OpenWeather.
Veröffentlicht von GladysAssistant
- Geräte
- Version 1.0.2
- Erfordert Gladys >=4.85.0
- ★ 0
Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.
This integration provides the weather displayed in Gladys: the dashboard weather widget, and the answers of the chat assistant when you ask "what is the weather like?".
Once installed and configured, it takes over from the OpenWeather service built into Gladys, with nothing else to do. If you stop or uninstall it, Gladys falls back to the built-in service automatically.
1. Get an OpenWeather API key
- Create a free account on openweathermap.org.
- Open the API keys tab of your account and copy the key (a 32-character string).
- Be patient: a brand-new key takes up to a couple of hours before
OpenWeather activates it. Until then, every request answers
401.
2. Configure the integration
Open the Configuration tab of the integration and fill in:
- API key — the key you just copied. It is stored as a secret: Gladys never sends it back to the browser.
- OpenWeather API — which API to call:
- Free (default): works with any account. Current conditions, 24 hours of 3-hourly forecast and 5 days.
- One Call 3.0: needs the "One Call by Call" subscription on your OpenWeather account (1000 calls a day are free, but a credit card is required to subscribe). It adds real hour-by-hour forecasts, the UV index, the dew point and the national weather alerts (Météo-France vigilance, NWS warnings…), which the free API does not carry.
- Cache duration — how long an answer is reused before calling OpenWeather again, in seconds (10 minutes by default). It keeps the dashboard well within the free quota. Set it to 0 if you want every refresh to hit the API.
Save. The status at the top of the page turns green as soon as the integration can serve the weather.
3. Check it works
The Test the connection button runs a real request to OpenWeather (Paris by default, change the coordinates to your own if you like) and shows the temperature, the condition and the number of forecast days it got back. It bypasses the cache, so it always tells you the truth about the current state of your key.
Then open your dashboard: the weather widget shows the location configured in your Gladys house.
Where the location comes from
The integration does not store a location: Gladys sends the coordinates of the house that asks, along with the language and the unit system (°C or °F) of the user who asks. Change your house address or your unit preference in Gladys and this integration follows.
Troubleshooting
| What you see | What it means |
|---|---|
| "OpenWeather rejected the API key (HTTP 401)" | The key is wrong, or it is not active yet (wait up to a couple of hours after creating it). |
| "OpenWeather does not serve /data/3.0/onecall for this account (HTTP 404)" | You selected One Call 3.0 without the matching subscription. Subscribe on the OpenWeather site, or switch back to the free API. |
| "OpenWeather quota exceeded (HTTP 429)" | Too many calls. Raise the cache duration, or upgrade your OpenWeather plan. |
| The widget shows the weather but no alerts | Weather alerts only exist on One Call 3.0, and only where a meteorological office has issued one. |
| The text of an alert is in English | OpenWeather serves the alert bulletins in English whatever the requested language — an API limitation. The alert label itself is translated by Gladys as soon as the phenomenon is recognized (wind, rain, thunderstorm, snow…). |
The integration logs every request it makes: open the integration logs from the
Gladys UI (or docker logs on the host). Set LOG_LEVEL=debug for the full
detail, including the URLs called (the API key is never logged).
Konfigurationseinstellungen
Diese Einstellungen fragt OpenWeather in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Your OpenWeather account | section | Nein | OpenWeather is a free weather API. Create an account, copy the API key from the "API keys" tab and paste it below. A new key takes up to a couple of hours to become active. |
| API key | secret | Ja | The OpenWeather API key used for every request. |
| OpenWeather API | select | Nein | "Free" works with any account. "One Call 3.0" needs the One Call subscription (1000 free calls a day, a credit card is required) and adds hourly detail, UV index, dew point and weather alerts. |
| Cache duration (s) | number | Nein | How long a weather answer is reused before calling OpenWeather again. Keeps the dashboard within the free quota. Set to 0 to always call the API. |
So installierst du OpenWeather in Gladys
- Öffne in Gladys Integrationen: OpenWeather erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/gladysassistant/gladys-openweather:1.0.2) 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/GladysAssistant/gladys-openweather.
OpenWeather benötigt Gladys >=4.85.0. 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
OpenWeather 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 GladysAssistant 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