Météo Bénélux integration for Gladys Assistant
IRM/KMI current weather, forecasts and alerts for Belgium, Luxembourg and the Netherlands.
Published by gboulvin
- Devices
- Version 1.0.2
- Requires Gladys >=4.85.0
- ★ 0
Overview
This integration brings Royal Meteorological Institute of Belgium (IRM/KMI) weather data to Gladys for supported locations in Belgium, Luxembourg and the Netherlands.1 Gladys supplies the requested location, so you do not need to configure a town, station or API key.
IRM/KMI does not publish official documentation for the mobile API used here. Its behaviour may change without notice; if the provider becomes unavailable, the integration records a clear error in its logs.2
| Available data | Display in Gladys |
|---|---|
| Current conditions | Temperature, sky condition, pressure, wind, gust and UV index whenever the provider sends them. |
| Hourly forecasts | Up to 24 temperature, precipitation, precipitation-probability, wind and pressure entries. |
| Daily forecasts | Up to 8 full days with minimum and maximum temperatures, precipitation, wind and solar times. |
| Warnings | Wind, rain, snow/ice, thunderstorm, fog, cold, heat and coastal warnings when available. |
Installation
Install the integration from the Gladys catalog once its Docker image has been published. If you install the repository manually, first build an image compatible with your server architecture, then reference that image in the integration manifest.
The project is based on Gladys’ official integration template. If you publish your own copy, replace your-github-username in both docker_image and cover_image of gladys-assistant-integration.json. The supplied release workflow builds a multi-architecture image for every version.3
Configuration
No personal information is needed. The optional Cache duration setting defaults to 600 seconds. It controls how long a downloaded forecast can be reused for the same location and unit system. Set it to 0 to disable the cache; doing so increases calls to the IRM/KMI service.
| Value | Recommended use |
|---|---|
0 | Occasional troubleshooting or an exceptional need to force every network request. |
300 to 900 | Normal use; reduces calls without making forecasts stale. |
3600 | Only for installations that request the same location very frequently. |
How it works and units
Gladys sends a request with latitude, longitude, language and the user’s preferred units. The integration rounds the coordinates, queries the IRM/KMI API and returns the result in Gladys’ standard weather format. Source data is metric; it is converted to Fahrenheit, miles per hour and inches whenever Gladys requests US units.4
Warning messages are selected in the requested language where available. IRM/KMI warning levels 1, 2 and 3 are represented by minor, moderate and severe severities. Warnings lacking a dependable type or severity are deliberately omitted to avoid ambiguous notifications.
Limitations
The reference API does not expose humidity or dew-point data, so those values are not displayed. A daily forecast can contain two conditions; only the first is retained. Rain-radar animation and pollen information are outside this version because Gladys’ main weather interface does not convey them in an appropriate form.1 2
Troubleshooting
If no forecast is displayed, first confirm that the Gladys location falls within the supported Benelux area. Then check the integration logs: an unsuccessful HTTP response, invalid response or timeout is explicitly recorded. A temporary provider outage can be addressed by retrying later; increasing the cache duration can also reduce failures from repeated requests.
References
Configuration settings
These are the settings Météo Bénélux asks for in its configuration screen in Gladys.
| Setting | Type | Required | Description |
|---|---|---|---|
| IRM/KMI data | section | No | This integration uses the undocumented mobile API of the Royal Meteorological Institute of Belgium. No account or personal key is required. The service covers Belgium, Luxembourg and the Netherlands; its interface may change without notice. |
| Cache duration (seconds) | number | No | How long a forecast for the same location is kept. Set to 0 to disable caching. |
How to install Météo Bénélux in Gladys
- In Gladys, open Integrations: Météo Bénélux appears in the catalog, next to the native integrations, with a community badge.
- Click Install. Gladys pulls the Docker image (
ghcr.io/gboulvin/gladys-irm-kmi-v2:1.0.2), starts it in a sandbox isolated from the core, and generates the integration's interface (devices, discovery and configuration). - Open the Configuration screen of the integration, fill in the settings, and save.
- You can also install it directly from its repository URL: https://github.com/gboulvin/Gladys-IRM-KMI-V2.
Météo Bénélux requires Gladys >=4.85.0. The catalog inside Gladys refreshes every hour, so a new version becomes available at most one hour after its release.
Not running Gladys yet? It is free and open source: follow the installation guide to get started.
About external integrations
Météo Bénélux is an external integration: a community integration packaged as a Docker container and published on GitHub, that Gladys installs in one click and runs in a sandbox isolated from its core. It is published and maintained by gboulvin, not by the Gladys core team.
- Browse all external integrations
- Discover the native integrations built into Gladys
- Build and publish your own external integration
- Source code on GitHub — source of this documentation