iobroker.openmeteo-notify 0.1.2 → 0.1.3

package/README.de.md

@@ -53,7 +53,8 @@ Der Adapter erzeugt natürlichsprachige Wetterzusammenfassungen (`current.summar
 |--------|----------|-------------|
 | **Luftqualität** | an | european_aqi, PM10, PM2.5, NO₂, CO, Staub, Ozon → `current.air_quality` / `hXX.air_quality` |
 | **Astronomie** | an | Sonnenauf/-untergang, Sonnenhöchststand, Mittagszeit, Mondphase, Mondauf/-untergang → `dayX.astronomy` / `hXX.astronomy` |
-| **Agrar / Solar** | aus | Solarstrahlung, CAPE, Bodentemperatur, Globalstrahlung → `*.agriculture` |
+| **Solar & Klima** | aus | Solarstrahlung, CAPE, Bodentemperatur, Globalstrahlung → `*.agriculture` |
+| **Komfortindizes** | aus | Hitzeindex, Windchill, Humidex, UV-Index → `*.comfort` |
 | **Pollen** | aus | Erle, Birke, Gräser, Beifuß, Olive, Ambrosia mit Textstufe → `dayX.pollen` / `hXX.pollen` |
 | **DWD-Warnungen** | aus | Offizielle Warnungen des Deutschen Wetterdienstes (nur Deutschland) → `standort.warnings.*` |
 
@@ -97,8 +98,10 @@ Adapter über die ioBroker-Admin-Oberfläche installieren (nach „openmeteo-not
 | Luftqualität – auch stündlich | Stündliche AQI/PM unter `hXX.air_quality` | aus |
 | Astronomie | Sonne & Mond aktivieren | an |
 | Astronomie – auch stündlich | Astronomiedaten pro Stundenslot | aus |
-| Agrar / Solar | Strahlung, CAPE, Bodentemperatur aktivieren | aus |
-| Agrar – auch stündlich | Stündliche Agrardaten | aus |
+| Solar & Klima | Strahlung, CAPE, Bodentemperatur aktivieren | aus |
+| Solar & Klima – auch stündlich | Stündliche Agrardaten | aus |
+| Komfortindizes | Hitzeindex, Windchill, Humidex, UV-Index aktivieren | aus |
+| Komfortindizes – auch stündlich | Stündliche Komfortdaten | aus |
 | Pollen | Pollendaten aktivieren (nur Europa) | aus |
 | Pollen – auch stündlich | Stündliche Pollen pro Typ | aus |
 | DWD-Warnungen | DWD-Daten aktivieren (nur Deutschland) | aus |
@@ -116,33 +119,41 @@ Der Adapter legt Datenpunkte unter `openmeteo-notify.<instanz>.<standort>` an.
 | Datenpunkt | Beschreibung | Einheit |
 |-----------|--------------|---------|
 | `temperature` | Aktuelle Temperatur | °C/°F |
-| `feels_like` | Gefühlte Temperatur | °C/°F |
-| `weathercode` | WMO-Wettercode | |
-| `description` | Wetterbeschreibung | |
+| `feels_like` | Gefühlte Temperatur – kombiniert Hitze, Luftfeuchte und Wind | °C/°F |
+| `weathercode` | WMO-Wettercode (0 = klar, 95/99 = Gewitter) – vollständige Tabelle: [WMO 4677](https://open-meteo.com/en/docs#weathercode) | |
+| `description` | Lesbare Wetterbeschreibung (11 Sprachen) | |
 | `icon` | Wetter-Emoji | |
-| `icon_url` | Wetter-Icon-URL | |
-| `precipitation` | Gesamtniederschlag | mm/inch |
-| `rain` | Regen | mm/inch |
-| `snowfall` | Schneefall | cm |
-| `snow_depth` | Schneehöhe | cm |
+| `icon_url` | Wetter-Icon-URL (Icon-Set in den Einstellungen wählbar) | |
+| `precipitation` | Gesamtniederschlag letzte Stunde | mm/inch |
+| `rain` | Regen letzte Stunde | mm/inch |
+| `snowfall` | Schneefall letzte Stunde | cm |
+| `snow_depth` | Aktuelle Schneehöhe am Boden | cm |
 | `cloudcover` | Bewölkung | % |
 | `humidity` | Relative Luftfeuchtigkeit | % |
-| `dew_point` | Taupunkt | °C/°F |
-| `pressure` | Luftdruck (MSL) | hPa |
-| `visibility` | Sichtweite | m |
-| `is_day` | Tag/Nacht | boolean |
-| `windspeed` | Windgeschwindigkeit | km/h … |
-| `windgusts` | Windböen | km/h … |
-| `winddirection` | Windrichtung | ° |
-| `winddirection_text` | Windrichtungstext | N/NE/… |
-| `winddirection_icon` | Windrichtungs-Emoji | ⬆️↗️… |
+| `dew_point` | Taupunkt – Temperatur, bei der die Luft gesättigt ist; nahe an der Lufttemperatur = hohe Luftfeuchte | °C/°F |
+| `pressure` | Luftdruck auf Meereshöhe reduziert (MSL) | hPa |
+| `visibility` | Horizontale Sichtweite | m |
+| `is_day` | `true` zwischen Sonnenauf- und -untergang | boolean |
+| `windspeed` | Windgeschwindigkeit (Einheit wählbar: km/h, m/s, mph, kn) | km/h … |
+| `windgusts` | Maximale Windböengeschwindigkeit | km/h … |
+| `winddirection` | Windrichtung (meteorologisch: Richtung, aus der der Wind kommt) | ° |
+| `winddirection_text` | Himmelsrichtungstext | N/NE/… |
+| `winddirection_icon` | Himmelsrichtungs-Emoji | ⬆️↗️… |
 | `winddirection_icon_url` | Windrichtungs-Pfeilicon-URL | |
-| `windbeaufort` | Windstärke Beaufort | 0–12 |
+| `windbeaufort` | Windstärke nach Beaufort-Skala (0 = Stille, 8 = Sturm, 12 = Orkan) | 0–12 |
 | `windbeaufort_icon_url` | Beaufort-Icon-URL | |
 | `summary` | Natürlichsprachige Wetterzusammenfassung (11 Sprachen) | |
 | `air_quality.*` | AQI, PM10, PM2.5, NO₂, CO, Staub, Ozon *(wenn aktiviert)* | |
 | `pollen.*` | Aktuelle Pollen pro Typ *(wenn aktiviert)* | Körner/m³ |
-| `agriculture.*` | Solarstrahlung, CAPE, Bodentemperatur *(wenn aktiviert)* | |
+| `agriculture.solar_radiation` | Kurzwellige Solarstrahlung am Boden *(wenn aktiviert)* | W/m² |
+| `agriculture.cape` | CAPE – konvektive verfügbare potenzielle Energie: Energie für Gewitterentwicklung; > 500 J/kg = nennenswert, > 2000 J/kg = heftig *(wenn aktiviert)* | J/kg |
+| `agriculture.soil_temp` | Bodentemperatur in 0 cm Tiefe *(wenn aktiviert)* | °C/°F |
+| `comfort.heat_index` | Hitzeindex (Rothfusz) – wie heiß es sich durch Temperatur und Luftfeuchte anfühlt; nur sinnvoll ≥ 27 °C und ≥ 40 % rF, sonst `null` *(wenn aktiviert)* | °C/°F |
+| `comfort.windchill` | Windchill (NWS) – wie kalt es sich durch Wind anfühlt; nur sinnvoll ≤ 10 °C und Wind > 4,8 km/h, sonst `null` *(wenn aktiviert)* | °C/°F |
+| `comfort.humidex` | Humidex (kanadische Formel) – kombinierter Hitze-Feuchte-Index; ab 40 unangenehm, ab 46 gefährlich *(wenn aktiviert)* | °C/°F |
+| `comfort.humidex_level` | Humidex-Unbehagen-Stufe: 1 = kein Unbehagen (<29) · 2 = leicht (29–34) · 3 = deutlich (35–39) · 4 = stark (40–45) · 5 = gefährlich (≥46) *(wenn aktiviert)* | 1–5 |
+| `comfort.uv_index` | UV-Index (0–11+) – Intensität der UV-Strahlung am Boden *(wenn aktiviert)* | |
+| `comfort.uv_level` | UV-Schutzstufe (WHO-Skala): `low` (0–2, kein Schutz nötig) · `moderate` (3–5, Sonnenschutz) · `high` (6–7) · `very_high` (8–10) · `extreme` (≥11) *(wenn aktiviert)* | |
 
 ### Tagesvorhersage (`day1` … `day16`)
 
@@ -160,23 +171,34 @@ Der Adapter legt Datenpunkte unter `openmeteo-notify.<instanz>.<standort>` an.
 | `windspeed` / `windgusts` | Windgeschwindigkeit / Böen max |
 | `winddirection` / `_text` / `_icon` / `_icon_url` | Windrichtung |
 | `windbeaufort` / `windbeaufort_icon_url` | Beaufort-Skala |
-| `uv_index` / `uv_index_clear_sky` | UV-Index max / UV-Index bei wolkenlosem Himmel | |
-| `sunshine_hours` / `daylight_hours` | Sonnenschein- / Tageslichtdauer | h |
-| `cloud_cover_max` | Bewölkung max | % |
+| `uv_index` | Tagesmaximum UV-Index *(mit Wolkeneinfluss)* | |
+| `uv_index_clear_sky` | Tagesmaximum UV-Index bei vollständig wolkenlosem Himmel – zeigt das UV-Potenzial unabhängig von Wolken | |
+| `sunshine_hours` | Stunden mit direkter Sonneneinstrahlung | h |
+| `daylight_hours` | Gesamtstunden zwischen Sonnenauf- und -untergang | h |
+| `cloud_cover_max` | Maximale Bewölkung des Tages | % |
 | `temp_mean` / `feels_like_mean` | Tagesmitteltemperatur / gefühlte Temperatur | °C/°F |
-| `precipitation_hours` | Stunden mit Niederschlag | h |
-| `showers` | Konvektiver Niederschlag | mm/inch |
-| `snowfall_height_min` | Niedrigste Schneefallgrenze bei Niederschlag | m |
+| `precipitation_hours` | Anzahl der Stunden mit messbarem Niederschlag | h |
+| `showers` | Konvektiver (schauertypischer) Niederschlag – kurz und intensiv; getrennt von kontinuierlichem `rain` | mm/inch |
+| `snowfall_height_min` | Niedrigste Schneefallgrenze am Tag (0 m = Schnee bis ins Tal) | m ü. M. |
+| `freezing_level_height_min` | Niedrigste Höhe der 0-°C-Isothermen am Tag | m ü. M. |
 | `dew_point_mean` / `humidity_mean` / `pressure_mean` | Tages-Mittelwerte | |
 | `summary_day` / `summary_night` | Tages- / Nacht-Wetterzusammenfassung (11 Sprachen) | |
 | `has_storm` / `has_thunderstorm` | Sturm- / Gewitterwarnung für den Tag | boolean |
 | `air_quality.european_aqi_max` … `ozone_max` | Tagesmax. AQI, PM10, PM2.5, NO₂, CO, Staub, Ozon *(wenn aktiviert)* | |
 | `astronomy.sunrise` / `astronomy.sunset` | Sonnenauf/-untergang *(wenn aktiviert)* | |
-| `astronomy.solar_noon` / `astronomy.solar_elevation_max` | Sonnenmittag / max. Sonnenhöhenwinkel *(wenn aktiviert)* | / ° |
-| `astronomy.moon_phase_val` / `_text` / `_icon_url` | Mondphase *(wenn aktiviert)* | |
+| `astronomy.solar_noon` | Zeitpunkt der höchsten Sonnenposition *(wenn aktiviert)* | |
+| `astronomy.solar_elevation_max` | Sonnenwinkel über dem Horizont zum Sonnenmittag – 90° = senkrecht, 0° = Horizont *(wenn aktiviert)* | ° |
+| `astronomy.moon_phase_val` | Mondphase als Zahl: 0 = Neumond · 0,25 = erstes Viertel · 0,5 = Vollmond · 0,75 = letztes Viertel *(wenn aktiviert)* | 0–1 |
+| `astronomy.moon_phase_text` / `_icon_url` | Mondphase als Text / Icon *(wenn aktiviert)* | |
 | `astronomy.moonrise` / `astronomy.moonset` | Mondauf/-untergang *(wenn aktiviert)* | |
-| `agriculture.solar_radiation_sum` / `.evapotranspiration` | Solar / Evapotranspiration *(wenn aktiviert)* | |
-| `pollen.alder` … `pollen.ragweed` | Tagesmax. Pollen + Textstufe *(wenn aktiviert, Tag 1–4)* | |
+| `agriculture.solar_radiation_sum` | Gesamte Solarstrahlung des Tages *(wenn aktiviert)* | MJ/m² |
+| `agriculture.evapotranspiration` | FAO-56-Referenz-Evapotranspiration (ET₀) – wie viel Wasser Pflanzen und Boden abgeben; für Bewässerungsplanung *(wenn aktiviert)* | mm |
+| `agriculture.lifted_index_min` | Tagesminimum Lifted Index – atmosphärische Stabilität: negativ = instabil/Gewitterrisiko, stark negativ (< −6) = heftiges Gewitterrisiko *(wenn aktiviert)* | K |
+| `comfort.heat_index_max` | Tagesmaximum Hitzeindex *(wenn aktiviert)* | °C/°F |
+| `comfort.windchill_min` | Tagesminimum Windchill *(wenn aktiviert)* | °C/°F |
+| `comfort.humidex_max` / `.humidex_level` | Maximum Humidex / Unbehagen-Stufe (1–5, siehe Abschnitt Aktuell) *(wenn aktiviert)* | |
+| `comfort.uv_index_max` / `.uv_level` | Maximum UV-Index / Stufe (siehe Abschnitt Aktuell) *(wenn aktiviert)* | |
+| `pollen.alder` … `pollen.ragweed` | Tagesmax. Pollen + Textstufe (Keine/Niedrig/Mittel/Hoch) *(wenn aktiviert, Tag 1–4)* | Körner/m³ |
 
 ### Stundenwerte (`day1.hourly.h00` … `h23`)
 
@@ -188,7 +210,8 @@ Optional pro Stunde (wenn Gruppe aktiviert + „auch stündlich"):
 |-------|-------------|
 | `hXX.air_quality` | european_aqi, PM10, PM2.5, NO₂, CO, Staub, Ozon |
 | `hXX.astronomy` | Sonnenauf/-untergang, Mondphase (val/text/icon), Mondauf/-untergang |
-| `hXX.agriculture` | Solarstrahlung, CAPE, Bodentemperatur, Globalstrahlung |
+| `hXX.agriculture` | solar_radiation (W/m²), CAPE (J/kg), soil_temp (°C/°F), irradiance = Globalstrahlung auf geneigter Fläche (W/m²), lifted_index (K) |
+| `hXX.comfort` | heat_index, windchill, humidex, humidex_level, uv_index, uv_level |
 | `hXX.pollen` | Erle … Ambrosia + Textstufe (Keine/Niedrig/Mittel/Hoch) |
 
 ### Amtliche Warnungen (`warnings`)
@@ -198,7 +221,7 @@ Optional pro Stunde (wenn Gruppe aktiviert + „auch stündlich"):
 | `warnings.source` | Warnquelle: `"DWD"` oder `"MeteoAlarm"` |
 | `warnings.active` | Mindestens eine aktive Warnung |
 | `warnings.count` | Anzahl aktiver Warnungen |
-| `warnings.max_level` | Höchste Warnstufe (1–4) |
+| `warnings.max_level` | Höchste Warnstufe: 1 = Gering · 2 = Mäßig · 3 = Schwer · 4 = Extrem |
 | `warnings.max_level_text` | Warnstufe als Text |
 | `warnings.warning_N.active` | Warnslot N aktiv |
 | `warnings.warning_N.event` | Ereignistyp |
@@ -233,7 +256,11 @@ Dieser Adapter verwendet die Open-Meteo API. Der Name und das Logo von Open-Mete
 ## Changelog
 
 ### **WORK IN PROGRESS**
-* (ipod86) Fix: detaillierte API-Fehlermeldung bei HTTP-4xx-Antworten im Log
+* (ipod86) Eigenes SVG-Icon-Set mit Nacht-Icons und Base64-Einbettung im Widget-HTML
+* (ipod86) WMO OGC SVG-Icons mit themenabhängiger Farbinvertierung
+* (ipod86) Widget: responsives Layout via CSS Container Queries, konfigurierbare Breite, eigenes Farbschema, MDI-SVG-Icons
+* (ipod86) Komfort-Indizes: Hitzeindex, Windchill, Humidex, UV-Index (optional, auch stündlich)
+* (ipod86) Einstellungen: Inline-Validierung, Speichern bei ungültiger Konfiguration gesperrt
 
 ### 0.1.1 (2026-04-19)
 * (ipod86) Adapter umbenannt zu ioBroker.openmeteo-notify

package/README.md

@@ -54,6 +54,7 @@ The adapter generates natural-language weather summaries (`current.summary`, `da
 | **Air Quality** | on | european_aqi, PM10, PM2.5, NO₂, CO, dust, ozone → `current.air_quality` / `hXX.air_quality` |
 | **Astronomy** | on | sunrise, sunset, solar noon, max sun elevation, moon phase, moonrise, moonset → `dayX.astronomy` / `hXX.astronomy` |
 | **Agriculture / Solar** | off | solar radiation, CAPE, soil temperature, irradiance → `*.agriculture` |
+| **Comfort Indices** | off | heat index, windchill, humidex, UV index → `*.comfort` |
 | **Pollen** | off | alder, birch, grass, mugwort, olive, ragweed with level text → `dayX.pollen` / `hXX.pollen` |
 | **DWD warnings** | off | Official warnings from Deutscher Wetterdienst (Germany only) → `location.warnings.*` |
 
@@ -99,6 +100,8 @@ Install via the ioBroker Admin interface (search for "openmeteo-notify").
 | Astronomy – also hourly | Echo astronomy data per hourly slot | off |
 | Agriculture / Solar | Enable radiation, CAPE, soil temp | off |
 | Agriculture – also hourly | Hourly agricultural data | off |
+| Comfort Indices | Enable heat index, windchill, humidex, UV index | off |
+| Comfort – also hourly | Hourly comfort data | off |
 | Pollen | Enable pollen data (Europe only) | off |
 | Pollen – also hourly | Hourly pollen per type | off |
 | DWD weather warnings | Enable DWD data (Germany only) | off |
@@ -116,32 +119,40 @@ The adapter creates data points under `openmeteo-notify.<instance>.<location>`.
 | Data point | Description | Unit |
 |-----------|-------------|------|
 | `temperature` | Current temperature | °C/°F |
-| `feels_like` | Feels-like temperature | °C/°F |
-| `weathercode` | WMO weather code | |
-| `description` | Weather description | |
+| `feels_like` | Apparent temperature – combines heat, humidity, wind | °C/°F |
+| `weathercode` | WMO weather code (0 = clear sky, 95/99 = thunderstorm) – full table: [WMO 4677](https://open-meteo.com/en/docs#weathercode) | |
+| `description` | Human-readable weather description (11 languages) | |
 | `icon` | Weather emoji | |
-| `icon_url` | Weather icon URL | |
-| `precipitation` | Total precipitation | mm/inch |
-| `rain` | Rain amount | mm/inch |
-| `snowfall` | Snowfall | cm |
-| `snow_depth` | Snow depth | cm |
+| `icon_url` | Weather icon URL (icon set selectable in settings) | |
+| `precipitation` | Total precipitation last hour | mm/inch |
+| `rain` | Rain amount last hour | mm/inch |
+| `snowfall` | Snowfall last hour | cm |
+| `snow_depth` | Current snow depth on the ground | cm |
 | `cloudcover` | Cloud cover | % |
 | `humidity` | Relative humidity | % |
-| `dew_point` | Dew point | °C/°F |
-| `pressure` | Atmospheric pressure (MSL) | hPa |
-| `visibility` | Visibility | m |
-| `is_day` | Daylight indicator | boolean |
-| `windspeed` | Wind speed | km/h … |
-| `windgusts` | Wind gusts | km/h … |
-| `winddirection` | Wind direction | ° |
-| `winddirection_text` | Wind direction text | N/NE/… |
-| `winddirection_icon` | Wind direction emoji | ⬆️↗️… |
+| `dew_point` | Dew point – temperature at which air becomes saturated; close to air temp = high humidity | °C/°F |
+| `pressure` | Atmospheric pressure reduced to mean sea level (MSL) | hPa |
+| `visibility` | Horizontal visibility | m |
+| `is_day` | `true` between sunrise and sunset | boolean |
+| `windspeed` | Wind speed (unit selectable: km/h, m/s, mph, kn) | km/h … |
+| `windgusts` | Maximum wind gust speed | km/h … |
+| `winddirection` | Wind direction (meteorological: direction the wind comes from) | ° |
+| `winddirection_text` | Cardinal direction text | N/NE/… |
+| `winddirection_icon` | Cardinal direction emoji | ⬆️↗️… |
 | `winddirection_icon_url` | Wind direction arrow icon URL | |
-| `windbeaufort` | Wind strength Beaufort | 0–12 |
+| `windbeaufort` | Wind strength on Beaufort scale (0 = calm, 8 = gale, 12 = hurricane) | 0–12 |
 | `windbeaufort_icon_url` | Beaufort icon URL | |
 | `air_quality.*` | AQI, PM10, PM2.5, NO₂, CO, dust, ozone *(if enabled)* | |
 | `pollen.*` | Current pollen per type *(if enabled)* | Grains/m³ |
-| `agriculture.*` | Solar radiation, CAPE, soil temperature *(if enabled)* | |
+| `agriculture.solar_radiation` | Shortwave solar radiation at ground level *(if enabled)* | W/m² |
+| `agriculture.cape` | CAPE – Convective Available Potential Energy: energy available for thunderstorm development; > 500 J/kg = notable risk, > 2000 J/kg = severe *(if enabled)* | J/kg |
+| `agriculture.soil_temp` | Soil temperature at 0 cm depth *(if enabled)* | °C/°F |
+| `comfort.heat_index` | Heat index (Rothfusz) – how hot it feels combining temperature and humidity; only meaningful ≥ 27 °C and ≥ 40 % RH, `null` otherwise *(if enabled)* | °C/°F |
+| `comfort.windchill` | Wind chill (NWS) – how cold it feels due to wind; only meaningful ≤ 10 °C and wind > 4.8 km/h, `null` otherwise *(if enabled)* | °C/°F |
+| `comfort.humidex` | Humidex (Canadian formula) – combined heat+humidity discomfort index; values above 40 are uncomfortable, above 46 dangerous *(if enabled)* | °C/°F |
+| `comfort.humidex_level` | Humidex discomfort level: 1 = none (<29) · 2 = slight (29–34) · 3 = noticeable (35–39) · 4 = intense (40–45) · 5 = dangerous (≥46) *(if enabled)* | 1–5 |
+| `comfort.uv_index` | UV index (0–11+) – intensity of UV radiation at ground level *(if enabled)* | |
+| `comfort.uv_level` | UV protection level (WHO scale): `low` (0–2, no protection) · `moderate` (3–5, sunscreen) · `high` (6–7) · `very_high` (8–10) · `extreme` (≥11) *(if enabled)* | |
 
 ### Daily forecast (`day1` … `day16`)
 
@@ -159,21 +170,32 @@ The adapter creates data points under `openmeteo-notify.<instance>.<location>`.
 | `windspeed` / `windgusts` | Wind speed / gusts max |
 | `winddirection` / `_text` / `_icon` / `_icon_url` | Wind direction |
 | `windbeaufort` / `windbeaufort_icon_url` | Beaufort scale |
-| `uv_index` / `uv_index_clear_sky` | UV index max / UV index under clear sky | |
-| `sunshine_hours` / `daylight_hours` | Sunshine / daylight duration | h |
-| `cloud_cover_max` | Max cloud cover | % |
+| `uv_index` | Daily max UV index *(accounting for cloud cover)* | |
+| `uv_index_clear_sky` | Daily max UV index assuming completely clear sky – useful to see potential UV regardless of clouds | |
+| `sunshine_hours` | Hours of actual sunshine (direct radiation) | h |
+| `daylight_hours` | Total hours between sunrise and sunset | h |
+| `cloud_cover_max` | Maximum cloud cover during the day | % |
 | `temp_mean` / `feels_like_mean` | Daily mean temperature / feels-like | °C/°F |
-| `precipitation_hours` | Hours with precipitation | h |
-| `showers` | Convective precipitation sum | mm/inch |
-| `snowfall_height_min` | Minimum snowfall level during precipitation | m |
+| `precipitation_hours` | Number of hours with measurable precipitation | h |
+| `showers` | Convective (shower-type) precipitation – short, intense; distinct from continuous `rain` | mm/inch |
+| `snowfall_height_min` | Lowest altitude during the day at which snow falls (0 m = snow to valley floor) | m a.s.l. |
+| `freezing_level_height_min` | Lowest altitude of the 0 °C isotherm during the day | m a.s.l. |
 | `dew_point_mean` / `humidity_mean` / `pressure_mean` | Daily mean values | |
 | `air_quality.european_aqi_max` … `ozone_max` | Daily max AQI, PM10, PM2.5, NO₂, CO, dust, ozone *(if enabled)* | |
 | `astronomy.sunrise` / `astronomy.sunset` | Sunrise / sunset *(if enabled)* | |
-| `astronomy.solar_noon` / `astronomy.solar_elevation_max` | Solar noon time / max sun elevation angle *(if enabled)* | / ° |
-| `astronomy.moon_phase_val` / `_text` / `_icon_url` | Moon phase *(if enabled)* | |
+| `astronomy.solar_noon` | Time of highest sun position *(if enabled)* | |
+| `astronomy.solar_elevation_max` | Sun angle above the horizon at solar noon – 90° = directly overhead, 0° = horizon *(if enabled)* | ° |
+| `astronomy.moon_phase_val` | Moon phase as number: 0 = new moon · 0.25 = first quarter · 0.5 = full moon · 0.75 = last quarter *(if enabled)* | 0–1 |
+| `astronomy.moon_phase_text` / `_icon_url` | Moon phase as text / icon *(if enabled)* | |
 | `astronomy.moonrise` / `astronomy.moonset` | Moon rise / set *(if enabled)* | |
-| `agriculture.solar_radiation_sum` / `.evapotranspiration` | Solar / evapotranspiration *(if enabled)* | |
-| `pollen.alder` … `pollen.ragweed` | Daily max pollen + level text *(if enabled, day1–4)* | |
+| `agriculture.solar_radiation_sum` | Total solar radiation received during the day | MJ/m² |
+| `agriculture.evapotranspiration` | FAO-56 reference evapotranspiration (ET₀) – how much water plants and soil release; used for irrigation planning | mm |
+| `agriculture.lifted_index_min` | Daily minimum Lifted Index – atmospheric stability: negative = unstable/storm risk, strongly negative (< −6) = severe thunderstorm risk *(if enabled)* | K |
+| `comfort.heat_index_max` | Max heat index of the day *(if enabled)* | °C/°F |
+| `comfort.windchill_min` | Min wind chill of the day *(if enabled)* | °C/°F |
+| `comfort.humidex_max` / `.humidex_level` | Max humidex / discomfort level (1–5, see current section) *(if enabled)* | |
+| `comfort.uv_index_max` / `.uv_level` | Max UV index / level (see current section) *(if enabled)* | |
+| `pollen.alder` … `pollen.ragweed` | Daily max pollen concentration + level text (None/Low/Medium/High) *(if enabled, day1–4 only)* | Grains/m³ |
 
 ### Hourly values (`day1.hourly.h00` … `h23`)
 
@@ -185,7 +207,8 @@ Optional per hour (if enabled + "also hourly"):
 |---------|-------------|
 | `hXX.air_quality` | european_aqi, PM10, PM2.5, NO₂, CO, dust, ozone |
 | `hXX.astronomy` | sunrise, sunset, moon_phase_val/text/icon_url, moonrise, moonset |
-| `hXX.agriculture` | solar_radiation, CAPE, soil_temp, irradiance |
+| `hXX.agriculture` | solar_radiation (W/m²), CAPE (J/kg), soil_temp (°C/°F), irradiance = global tilted irradiance on a flat surface (W/m²), lifted_index (K) |
+| `hXX.comfort` | heat_index, windchill, humidex, humidex_level, uv_index, uv_level |
 | `hXX.pollen` | alder … ragweed + level text (Keine/Niedrig/Mittel/Hoch) |
 
 ### Official warnings (`warnings`)
@@ -195,7 +218,7 @@ Optional per hour (if enabled + "also hourly"):
 | `warnings.source` | Warning service: `"DWD"` or `"MeteoAlarm"` |
 | `warnings.active` | At least one active warning |
 | `warnings.count` | Number of active warnings |
-| `warnings.max_level` | Highest severity level (1–4) |
+| `warnings.max_level` | Highest severity level: 1 = Minor · 2 = Moderate · 3 = Severe · 4 = Extreme |
 | `warnings.max_level_text` | Severity text |
 | `warnings.warning_N.active` | Warning slot N active |
 | `warnings.warning_N.event` | Event type |
@@ -228,6 +251,13 @@ Optional per hour (if enabled + "also hourly"):
 This adapter uses the Open-Meteo API. The Open-Meteo name and logo are property of their respective owners. This adapter is an independent community project and is not affiliated with or endorsed by Open-Meteo.
 
 ## Changelog
+### 0.1.3 (2026-04-25)
+* (ipod86) Custom SVG icon set with night icon support and Base64 embedding in widget HTML
+* (ipod86) WMO OGC SVG icon set with theme-aware color inversion
+* (ipod86) Widget: responsive layout via CSS container queries, configurable width, custom color theme, MDI SVG icons
+* (ipod86) Comfort indices: heat index, windchill, humidex, UV index (optional, hourly option)
+* (ipod86) Settings: inline validation, save blocked on invalid config
+
 ### 0.1.2 (2026-04-19)
 * (ipod86) Fix: log detailed API error reason for HTTP 4xx responses
 
@@ -246,16 +276,6 @@ This adapter uses the Open-Meteo API. The Open-Meteo name and logo are property
 ### 0.0.46 (2026-04-08)
 * (ipod86) add CHANGELOG_OLD.md; add release-script
 
-### 0.0.45
-* Weather warnings (storm/thunderstorm) via ioBroker notification system
-* Configurable Beaufort threshold for storm warnings (Bft 1–12, default Bft 8)
-* Daily `has_storm` / `has_thunderstorm` datapoints per location
-* Hourly `is_storm` / `is_thunderstorm` datapoints (when hourly data enabled)
-* Storm detection based on wind gusts (`windgusts_10m`)
-* Warning message includes from/to time; day offset shown when event spans midnight
-* Warnings use raw API data — no minimum `hourlyDays` setting required
-* i18n translations for all new settings in 11 languages
-
 ## License
 
 MIT License