golles / ha-knmi

KNMI [![GitHub Release][releases-shield]][releases] [![GitHub Repo stars][stars-shield]][stars] [![License][license-shield]](LICENSE) [![GitHub Activity][commits-shield]][commits] [![Code coverage][codecov-shield]][codecov] [![hacs][hacs-shield]][hacs] [![installs][hacs-installs-shield]][ha-active-installation-badges] [![Project Maintenance][maintenance-shield]][maintainer] [![BuyMeCoffee][buymecoffeebadge]][buymecoffee] KNMI custom component for Home Assistant. Weather data provided by KNMI, https://weerlive.nl. Installation HACS installation The most convenient method for installing this custom component is via HACS. Simply search for the name, and you should be able to locate and install it seamlessly. Manual installation guide: • Utilize your preferred tool to access the directory in your Home Assistant (HA) configuration, where you can locate the file. • Should there be no existing directory, you must create one. • Inside the newly created directory, generate a new directory named . • Retrieve and download all files from the directory in this repository. • Place the downloaded files into the newly created directory. • Restart Home Assistant. Configuration is done in the UI Within the HA user interface, navigate to "Configuration" -> "Integrations", click the "+" button, and search for "KNMI" to add the integration. Known limitations This integration is translated into English and Dutch, including entity names and attributes, the data (from the API) is only available in Dutch. Feel free to create a pull request with your language, see translations. Non-numerical values are only available in Dutch Entities This integration comes with multiple pre-built entities, most of which are initially deactivated. To enable additional entities, follow these steps: • Navigate to "Configuration" -> "Integrations" -> "KNMI" in the Home Assistant interface. • Click on the specific integration with "1 service" that you desire. • Click on "X entities hidden", and a summary of all entities in this integration will be displayed. • Choose the desired entity, click on the cogwheel icon, and access its settings. • Toggle the "Enabled" switch to activate the entity. • Click "Update" to save the changes. Repeat these steps for each entity you wish to enable. After completing this process, the newly enabled entities will receive values during the next update. Binary sensors | Name (EN) | Name (NL) | Attributes | Notes | | --------- | ------------ | ------------------------------------------------------------------ | ----------------------------------------------------------------------- | | Sun | Zon | Sunrise, Sunset, Sun chance today, tomorrow and day after tomorrow | Times of today, in UTC, frontend will convert this into your local time | | Warning | Waarschuwing | Title, Description, Code, Next code, Next warning | Code has its own entity, see Weather code below | Sensors Normal sensors: | Name (EN) | Name (NL) | Attributes | Notes | | ------------------------ | ---------------------------- | ----------------------------------- | --------------------- | | Dew point | Dauwpunt | | Unit configurable | | Solar irradiance | Globale stralingsintensiteit | | | | Wind chill | Gevoelstemperatuur | | Unit configurable | | Air pressure | Luchtdruk | | Unit configurable | | Humidity | Luchtvochtigheid | | | | Max temperature today | Max temperatuur vandaag | | Unit configurable | | Max temperature tomorrow | Max temperatuur morgen | | Unit configurable | | Min temperature today | Min temperatuur vandaag | | Unit configurable | | Min temperature tomorrow | Min temperatuur morgen | | Unit configurable | | Precipitation today | Neerslag vandaag | | | | Precipitation tomorrow | Neerslag morgen | | | | Description | Omschrijving | | State is in Dutch | | Temperature | Temperatuur | | Unit configurable | | Weather forecast | Weersverwachting | | State is in Dutch | | Wind speed | Windsnelheid | Bearing, Degree, Beaufort and Knots | Unit configurable | | Weather code | Weercode | | Raw state is in Dutch | | Visibility | Zicht | | Unit configurable | Diagnostic sensors: | Name (EN) | Name (NL) | Notes | | ---------------------- | ------------------------ | ----------------------- | | Location | Plaats | | | Remaining API requests | Resterende API verzoeken | | | Latest update | Laatste update | Server side update time | Weather The weather entity contains all the weather information, ideal for displaying a comprehensive overview in the Home Assistant frontend. It includes both a daily forecast spanning up to 5 days and an hourly forecast covering up to 24 hours. Daily forecast attributes: | Attribute | Notes | | ------------------------- | ------------------------------------------------------------- | | datetime | Times in UTC, frontend will convert this into your local time | | condition | | | templow | | | temperature | | | precipitation_probability | in a percentage | | wind_bearing | | | wind_speed | | | wind_speed_bft | Not officially supported, but nice addition | | sun_chance | Not officially supported, but nice addition | Hourly forecast attributes: | Attribute | Notes | | ---------------- | ------------------------------------------------------------- | | datetime | Times in UTC, frontend will convert this into your local time | | condition | | | temperature | | | precipitation | in millimeters | | wind_bearing | | | wind_speed | | | wind_speed_bft | Not officially supported, but nice addition | | solar_irradiance | Not officially supported, but nice addition | Examples Integration with entities, notice the hidden ones: Weather cards (hourly and daily forecast): Weather entity (with daily and hourly forecast tabs): Sun entity: Warning entity: Collect logs To activate the debug log necessary for issue reporting, follow these steps: • Go to "Configuration" -> "Integrations" -> "KNMI" within the Home Assistant interface. • On the left side, locate the "Enable debug logging" button an…