You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
A custom [Home Assistant](https://www.home-assistant.io/) integration for [Open-Meteo](https://open-meteo.com/) weather forecasting. Provides more accurate forecasts and richer weather data than the built-in `open_meteo` integration.
10
+
A custom [Home Assistant](https://www.home-assistant.io/) integration for [Open-Meteo](https://open-meteo.com/) weather forecasting. Provides more accurate forecasts and richer weather data than the built-in `open_meteo` integration — no cloud account or API key required.
6
11
7
12
## Why use this instead of the built-in Open-Meteo integration?
8
13
@@ -18,43 +23,48 @@ In addition, this integration exposes many more weather attributes and uses more
3. Search for "Open-Meteo Enhanced" and install it.
81
-
4. Restart Home Assistant.
86
+
[](https://my.home-assistant.io/redirect/hacs_repository/?owner=sayurin&repository=open_meteo_local&category=integration)
87
+
88
+
1. Select the button above, or search for **"Open-Meteo Enhanced"** in HACS.
89
+
2. Install the integration.
90
+
3. Restart Home Assistant.
82
91
83
92
### Manual
84
93
85
94
1. Copy the `custom_components/open_meteo_local` directory to your Home Assistant `config/custom_components/` directory.
86
95
2. Restart Home Assistant.
87
96
97
+
## Prerequisites
98
+
99
+
- Home Assistant with [HACS](https://hacs.xyz/) installed (for HACS installation) or access to the `custom_components` directory (for manual installation)
100
+
- Internet access to reach the [Open-Meteo API](https://open-meteo.com/) — no account or API key required
101
+
- At least one zone configured in Home Assistant to use as the weather location (**Settings → Areas, labels & zones**)
102
+
88
103
## Configuration
89
104
90
105
1. Go to **Settings** → **Devices & Services** → **Add Integration**.
91
106
2. Search for **Open-Meteo Enhanced**.
92
107
3. Select a zone to use for the weather location.
93
108
94
-
The integration creates a weather entity bound to the selected zone. The location (latitude/longitude) is read from the zone entity, so updating the zone will update the weather data location.
109
+
The integration creates a weather entity bound to the selected zone. The location (latitude/longitude) is read from the zone entity, so updating the zone coordinates will automatically update the weather data location.
110
+
111
+
Multiple instances can be added to get forecasts for different locations — one instance per zone.
112
+
113
+
## Known Limitations
114
+
115
+
- Requires internet access; there is no local or offline mode.
116
+
- Each configuration entry covers a single zone. Add multiple instances for multiple locations.
117
+
- Ozone is intentionally not fetched to keep all data on a single weather forecast API call.
118
+
- Forecast history is not retained — only current and future forecasts are available.
119
+
120
+
## Troubleshooting
121
+
122
+
### Weather entity shows as unavailable
123
+
124
+
The weather entity appears as unavailable after setup.
125
+
126
+
1. Check that Home Assistant has internet access and can reach `api.open-meteo.com`.
127
+
2. Verify the selected zone exists and has valid coordinates set in **Settings → Areas, labels & zones**.
128
+
3. Check **Settings → System → Logs** for any error messages related to `open_meteo_local`.
129
+
4. Try reloading the integration from **Settings → Devices & Services → Open-Meteo Enhanced → ⋮ → Reload**.
130
+
131
+
### Daily forecast temperatures look incorrect
132
+
133
+
Daily high or low temperatures seem wrong, especially around midnight.
134
+
135
+
This is the exact problem this integration solves — the built-in `open_meteo` integration uses UTC day boundaries. Confirm you are using **Open-Meteo Enhanced** and not the built-in integration. If the issue persists, verify the zone's latitude and longitude are correct.
136
+
137
+
### Weather condition shows "sunny" at night
138
+
139
+
Make sure day/night awareness is working by checking that the zone's coordinates are correct. This integration uses the `is_day` flag from the Open-Meteo API based on the zone's location.
140
+
141
+
## Removing the Integration
142
+
143
+
To remove the integration, go to **Settings → Devices & Services**, select **Open-Meteo Enhanced**, and select **Delete**.
95
144
96
-
## Technical details
145
+
## Acknowledgments
97
146
98
-
- Uses the [Open-Meteo API](https://open-meteo.com/) with FlatBuffers format (`openmeteo-sdk`) for efficient binary parsing, instead of the JSON-based `open-meteo` library used by the built-in integration.
99
-
- Polls every 15 minutes.
100
-
- Provides 48-hour hourly forecasts and 7-day daily forecasts.
101
-
- Timestamps use the local timezone (`auto`) for more intuitive forecast times.
147
+
-[Open-Meteo](https://open-meteo.com/) for the free, open-source weather API
148
+
-[openmeteo-sdk](https://github.com/open-meteo/sdk) for the FlatBuffers parsing library
0 commit comments