This custom component for Home Assistant integrates weather data (measurements and forecasts) from the Deutscher Wetterdienst Open Data server into Home Assistant via weather entities.
Deutscher Wetterdienst (DWD) is not affiliated in any way with this project.
The conditions from Deutscher Wetterdienst (DWD) for using their data and accessing their servers apply.
stations.md and custom_components/dwd/stations.json are generated from data from Deutscher Wetterdienst (DWD) with the Python script at tools/generate_stations/generate_stations.py.
- Current measurement data from the weather stations from https://opendata.dwd.de/weather/weather_reports/poi/ as state attributes of a weather entity.
- condition
- temperature
- dew_point
- cloud_coverage
- humidity
- pressure
- visibility
- wind_gust_speed
- wind_speed
- wind_bearing
- Hourly forecast data from the weather stations from https://opendata.dwd.de/weather/local_forecasts/mos/MOSMIX_L/single_stations/ in the forecast list of a weather entity.
- datetime
- condition
- temperature
- dew_point
- cloud_coverage
- precipitation
- precipitation_probability
- pressure
- wind_gust_speed
- wind_speed
- wind_bearing
- Daily forecast data calculated by the component from the hourly forecast data. This is the most tricky part. I have compared the result of this with what the official Warnwetter app displays and the results seems to be very close.
- datetime
- condition
- temperature (the maximum temperature for the day)
- templow (the minimum temperature for the day)
- cloud_coverage (arithmetic average over the day)
- precipitation (sum over the day)
- pressure (arithmetic average over the day)
- wind_gust_speed (maximum over the day)
- wind_speed (arithmetic average over the day)
- Uses the HTTP ETag mechanism to only download new data if the data has changed. This allows more frequent polling (currently about every 10 minutes) while still keeping the load low.
- Configuration via UI
This quick setup guide is based on My Home Assistant links and the Home Assistant Community Store (HACS). For more details and other setup methods, see setup.md.
As this integration is currently not part of Home Assistant Core, you have to download it first into your Home Assistant installation. To download it via HACS, click the following button to open the download page for this integration in HACS.
After a restart of Home Assistant, this integration is configurable by via "Add Integration" at "Devices & Services" like any core integration. Select "Deutscher Wetterdienst" and follow the instructions.
To get there in one click, use this button:
This adds one device and three entities for the selected station. By default, only the entity that provides all forecasts in one entity is enabled. If you still need the deprecated weather entities with daily and houry forecasts separately or via the old mechanism, you can still enable them for now, but you should really switch to the new entity now. To add more stations, just repeat the "Add Integration" step.
If you have questions, they might already be answered at questions_and_answers.md.
It's always worth reporting bugs, if they haven't been reported yet and after having at look at Questions & Answers.
When reporting a bug, please follow these guidelines.
For issues with measurement data (current condition, current temperature, ...), please include the following items in your bug report.
- Always include the station ID.
- When the problem occurs, go to the Developer Tools and copy immediately the state value + all state attributes (YAML) of entity where the issue occurs. You could skip the forecast part, but to be safe, just copy the whole YAML.
- When the problem occurs, download immediately
https://opendata.dwd.de/weather/weather_reports/poi/{station_id}-BEOB.csv. Replace{station_id}with your actual station ID. If your station ID has less than 5 characters, it has to be padded with trailing underscores, so e.g. "A191" becomes "A191_" here.
For issues with hourly forecasts, please include the following items in your bug report.
- Always include the station ID.
- When the problem occurs, go to the Developer Tools and copy immediately all state attributes (YAML) of the hourly entity (the entity ending with "_hourly").
- When the problem occurs, download immediately
https://opendata.dwd.de/weather/local_forecasts/mos/MOSMIX_L/single_stations/{station_id}/kml/MOSMIX_L_LATEST_{station_id}.kmz. Replace{station_id}with your actual station ID. No padding needed here.
For issues with daily forecasts, please include the following items in your bug report.
- Always include the station ID.
- When the problem occurs, go to the Developer Tools and copy immediately all state attributes (YAML) of the hourly entity (the entity ending with "_hourly"). This is important, because the daily forecasts are calculated from hourly forecasts.
- When the problem occurs, go to the Developer Tools and copy immediately all state attributes (YAML) of the daily entity (the entity ending with "_daily").
- When the problem occurs, download immediately
https://opendata.dwd.de/weather/local_forecasts/mos/MOSMIX_L/single_stations/{station_id}/kml/MOSMIX_L_LATEST_{station_id}.kmz. Replace{station_id}with your actual station ID. No padding needed here.
Unfortunately, most of the following documentation is only available in German.
- Deutscher Wetterdienst Open Data.
- List of documents related to Deutscher Wetterdienst Open Data, e.g. documents that describe the various file formats. The most relevant ones used during development of this component are listed below.
- Explanation of the elements used in the MOSMIX forecast KML files.
- Explanation of the weather codes (ww, ww3, WPc11, WPc31, WPc61, WPcd1, WPch1 and W1W2) used in the MOSMIX forecast KML files.
- Binary Codes (BUFR). Actually, this should not be so much relevant, because everything should be covered by the previous documents, but there is some interesting overlap with the table "Aktuelles Wetter" on page 229 of this document.
- General explanation of forecast symbols. This doesn't explain the data format, but it is still quite interesting, because it shows the relations of the symbols to other data like cloud coverage and precipitation.
For more information about stations see also stations.md.