irm-kmi-ha/README.md

IRM KMI Weather integration for Home Assistant

Home Assistant weather provider using data from Belgian IRM KMI. The data is collected via their non-public mobile application API.

Although the provider is Belgian, the data is available for Belgium 🇧🇪, Luxembourg 🇱🇺, and The Netherlands 🇳🇱

Note: this is still under development, new versions may not be backward compatible.

Installing via HACS

1. Go to HACS > Integrations
2. Add this repo into your HACS custom repositories
3. Search for IRM KMI and download it
4. Restart Home Assistant
5. Configure the integration via the UI (search for 'IRM KMI')

Features

This integration provides the following things:

• A weather entity with current weather conditions
• Weather forecasts (hourly, daily and twice-daily) using the service weather.get_forecasts
• A camera entity for rain radar and short-term rain previsions

The following options are available:

• Styles for the radar
• Support for the old forecast attribute for components relying on this

Screenshots

Show screenshots

Limitations

1. The weather provider sometime uses two weather conditions for the same day (see below). When this is the case, only the first weather condition is taken into account in this integration.
   

2. The trends for 14 days are not shown

3. The warnings shown in the app are not shown by the integration

4. The provider only has data for Belgium, Luxembourg and The Netherlands

Mapping between IRM KMI and Home Assistant weather conditions

Mapping was established based on my own interpretation of the icons and conditions.

HA Condition	HA Description	IRM KMI icon	IRM KMI data (ww-dayNight)
clear-night	Clear night		0-n 1-n
cloudy	Many clouds		14-d 14-n 15-d 15-n
exceptional	Exceptional		21-d 21-n 27-d 27-n
fog	Fog		24-d 24-n 25-d 25-n 26-d 26-n
hail	Hail
lightning	Lightning/ thunderstorms
lightning-rainy	Lightning/ thunderstorms and rain		2-d 2-n 5-d 5-n 7-d 7-n 10-d 10-n 13-d 13-n 17-d 17-n
partlycloudy	A few clouds		3-d 3-n
pouring	Pouring rain		4-d 4-n 6-d 6-n 16-d 16-n 19-d 19-n
rainy	Rain		18-d 18-n
snowy	Snow		11-d 11-n 12-d 12-n 22-d 22-n 23-d 23-n
snowy-rainy	Snow and Rain		8-d 8-n 9-d 9-n 20-d 20-n
sunny	Sunshine		0-d 1-d
windy	Wind
windy-variant	Wind and clouds

Disclaimer

This is a personal project and isn't in any way affiliated with, sponsored or endorsed by The Royal Meteorological Institute of Belgium.

All product names, trademarks and registered trademarks in (the images in) this repository, are property of their respective owners. All images in this repository are used by the project for identification purposes only.