jdejaegh/irm-kmi-ha
1
0
Fork 0
mirror of https://github.com/jdejaegh/irm-kmi-ha.git synced 2025-06-26 19:35:40 +02:00
Code Issues Projects Releases Packages Wiki Activity
Home Assistant weather provider using data from Belgian IRM KMI 🇧🇪 🇱🇺 🇳🇱
82 commits 2 branches 44 tags 4.7 MiB
Find a file
Jules Dejaeghere 2cca89f5ba
Add tests for config flow
2024-01-08 20:20:31 +01:00
.github/workflows Update pytest pipeline: run on pull request and push 2023-12-27 11:48:41 +01:00
custom_components/irm_kmi Add tests for config flow 2024-01-08 20:20:31 +01:00
img Update README 2024-01-04 21:20:56 +01:00
tests Start adding repairs and better error handling 2024-01-07 11:20:03 +01:00
.gitignore Update .gitignore 2023-12-22 18:47:25 +01:00
hacs.json Update hacs.json 2023-12-23 21:21:46 +01:00
LICENSE Initial commit 2023-12-17 16:35:01 +00:00
README.md Update README 2024-01-04 21:28:43 +01:00
requirements.txt Start adding repairs and better error handling 2024-01-07 11:20:03 +01:00
requirements_tests.txt Start adding repairs and better error handling 2024-01-07 11:20:03 +01:00
setup.cfg Add tests for config flow 2024-01-08 20:20:31 +01:00

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.
    Example of two weather conditions

  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.