ioBroker.openmeteo

Tests:

ioBroker adapter for Open-Meteo weather forecasts

This adapter retrieves weather forecast data from the free Open-Meteo API and makes it available as ioBroker data points. No API key is required.

Features

• Free & no API key – Open-Meteo is a free, open-source weather API
• Multiple locations – configure as many locations as you like
• System location fallback – uses ioBroker system coordinates if no location is configured
• Configurable forecast range – up to 16 days daily, up to 16 days hourly
• Configurable update interval – 60 min, 120 min, or daily at 01:00
• Units – temperature (°C / °F), wind speed (km/h, m/s, mph, kn), precipitation (mm / inch)
• 3 weather icon sets with live preview in settings:
  • Meteocons by Bas Milius – static PNG (default)
  • Meteocons by Bas Milius – animated SVG
  • WMO OGC meteorological symbols – PNG
• Day/night icons – Meteocons automatically switch to night variants based on is_day
• Wind direction – degrees, compass text (N/NE/E/…), arrow emoji (⬆️↗️…), SVG arrow icon
• Wind strength – Beaufort scale (0–12) with Meteocons Beaufort icons
• info.lastUpdate – timestamp of last successful update

Optional data groups (individually switchable, each with "also hourly" option)

| Group | Default | Data points | |-------|---------|-------------| | Air Quality | on | european_aqi, PM10, PM2.5, NO₂, CO, dust, ozone → current.air_quality / hXX.air_quality | | Astronomy | on | sunrise, sunset, moon phase, moonrise, moonset → dayX.astronomy / hXX.astronomy | | Agriculture / Solar | off | solar radiation, CAPE, soil temperature, irradiance → *.agriculture | | Pollen | off | alder, birch, grass, mugwort, olive, ragweed with level text → dayX.pollen / hXX.pollen |

When a group is disabled, its data point channels are automatically deleted on the next update.

Installation

Install via the ioBroker Admin interface (search for "openmeteo").

Configuration

| Setting | Description | Default | |---------|-------------|---------| | Locations | Name, latitude, longitude | ioBroker system location | | Forecast days | Daily forecast range (1–16) | 7 | | Hourly days | Days with hourly data (0–16) | 3 | | Temperature unit | °C or °F | °C | | Wind speed unit | km/h, m/s, mph, kn | km/h | | Precipitation unit | mm or inch | mm | | Icon set | Weather icon set | Meteocons static | | Update interval | 60 min / 120 min / daily at 01:00 | 60 min | | Air Quality | Enable AQI + particulate matter | on | | Air Quality – also hourly | Hourly AQI/PM under hXX.air_quality | off | | Astronomy | Enable sun & moon data | on | | 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 | | Pollen | Enable pollen data (Europe only) | off | | Pollen – also hourly | Hourly pollen per type | off |

Data points

The adapter creates data points under openmeteo.<instance>.<location>.

Current weather (current)

| Data point | Description | Unit | |-----------|-------------|------| | temperature | Current temperature | °C/°F | | feels_like | Feels-like temperature | °C/°F | | weathercode | WMO weather code | | | description | Weather description | | | 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 | | 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 | ⬆️↗️… | | winddirection_icon_url | Wind direction arrow icon URL | | | windbeaufort | Wind strength Beaufort | 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) | |

Daily forecast (day1 … day16)

| Data point | Description | |-----------|-------------| | date / weekday | Date / day of week | | icon / icon_url | Weather icon (day/night variant) | | description | Weather description | | temp_max / temp_min | Temperature max/min | | feels_like_max / feels_like_min | Feels-like max/min | | weathercode | WMO weather code | | precipitation | Precipitation sum | | rain / snowfall | Rain / snowfall sum | | rain_probability | Precipitation probability | | windspeed / windgusts | Wind speed / gusts max | | winddirection / _text / _icon / _icon_url | Wind direction | | windbeaufort / windbeaufort_icon_url | Beaufort scale | | uv_index | UV index max | | sunshine_hours / daylight_hours | Sunshine / daylight duration | h | | cloud_cover_max | Max cloud cover | % | | 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.moon_phase_val / _text / _icon_url | Moon phase (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) | |

Hourly values (day1.hourly.h00 … h23)

Temperature, feels-like, precipitation, rain, snowfall, snow depth, rain probability, cloud cover, humidity, dew point, pressure, visibility, is_day, wind speed, wind direction (text/emoji/icon), Beaufort, weather code, icon/icon_url, description.

Optional per hour (if enabled + "also hourly"):

| Channel | Data points | |---------|-------------| | 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.pollen | alder … ragweed + level text (Keine/Niedrig/Mittel/Hoch) |

Summary

| Data point | Description | |-----------|-------------| | weather_short | Short text overview of all forecast days | | info.lastUpdate | Timestamp of last successful update |

Icon credits

• Meteocons by Bas Milius – MIT License
• WMO meteorological symbols by OGC MetOcean DWG – CC BY 4.0

Disclaimer

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.0.36

• Multilingual weather descriptions, moon phases and pollen levels (11 languages: de, en, fr, it, es, pt, nl, pl, ru, uk, zh-cn)
• Weekday abbreviations localized per language
• Timezone now read from ioBroker system config (system.config.common.timezone); fallback: auto

0.0.35

• Add real Basmilius Meteocons sleet icons for WMO codes 56/57/66/67 (day, night, animated)
• Previously these codes had placeholder/missing icons; now using correct partly-cloudy/overcast sleet variants

0.0.34

• Add missing WMO codes 56/57 (freezing drizzle) and 66/67 (freezing rain) to descriptions, emoji icons and rain detection
• Day icons for codes 56/57/66/67 fall back to nearest equivalent in basmilius/wmo sets (night icons are complete)

0.0.33

• Fix: setting hourlyDays to 0 was ignored (0 || 3 evaluated to 3) – hourly folders were never cleaned up

0.0.32

• Fix: pollen channels not deleted when "pollen hourly" was disabled (early return prevented cleanup)
• Fix: enablePollenHourly defaulted to true on upgrades from old config – now correctly defaults to false
• Fix: when both pollen and air quality disabled, leftover channels now properly cleaned up
• New: daily air quality max values under dayX.air_quality (european_aqi_max, pm10_max, pm2_5_max, …)

0.0.31

• Remove @iobroker/plugin-sentry dependency (not needed)
• Fix admin globalDependency minVersion to >=7.6.17
• README.md now English-only; German documentation moved to README.de.md

0.0.30

• Fix: hourly air quality data not written when pollen is disabled
• Fix: timer reference not cleared on timeout callback
• Fix: JSDoc for pollenLevelText corrected (4 levels, not 5)

0.0.29

• Default for pollen hourly changed to off

0.0.28

• "Also hourly" toggle for all 4 optional data groups (Air Quality, Astronomy, Agriculture, Pollen)
• Air Quality hourly: real hourly PM10/PM2.5/AQI data from Air Quality API
• Astronomy hourly: daily sun/moon values echoed per hourly slot
• Update interval options: 60 min, 120 min, or daily at 01:00 (scheduled exactly)

0.0.27

• "Also hourly" toggle for Agriculture and Pollen categories

0.0.26

• Optional data groups: Air Quality, Astronomy, Agriculture/Solar – each with auto-cleanup when disabled
• Pollen cleanup: dayX.pollen channels removed when pollen is disabled

0.0.25

• Moon phase per day: moon_phase_val/text/icon_url, moonrise, moonset (via SunCalc)
• Day/night icon variants for Basmilius PNG and animated SVG (based on is_day)
• AQI current data under current.air_quality: european_aqi, PM10, PM2.5, NO₂, CO, dust, ozone
• Pollen level text (_text) DPs: Keine/Niedrig/Mittel/Hoch at current/daily/hourly level
• Configurable update interval in settings
• info.lastUpdate written after each successful update
• Additional daily DPs: cloud_cover_max, dew_point_mean, humidity_mean, pressure_mean
• Additional hourly DPs: soil_temp, irradiance

0.0.11

• Add React admin UI with icon set picker and live preview
• Add Meteocons (static PNG + animated SVG) icon sets

0.0.4

• Read ioBroker system.config coordinates as fallback location

0.0.2

• Switch to daemon mode for immediate fetch on start

0.0.1

• Initial release

License

MIT License

Copyright (c) 2026 David G. [email protected]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.