Beach Weather – water temperature, waves, wind & surf score for any location (Open-Meteo, no API key)

Share your Projects! Custom Integrations
1

Hey everyone,

I’ve built a custom integration for anyone who wants beach/water conditions in Home Assistant without maintaining a pile of YAML rest: sensors. It’s called Beach Weather and pulls everything from the free Open-Meteo Marine + Forecast APIs — no API key, no account, no rate-limit tier to worry about.

What it does

Add as many locations as you want (one config entry each), by map pin, manual coordinates, or just pasting a lat, lon pair / typing a place name — it auto-suggests the location name and beach orientation for you to confirm.

Each location gets a full set of sensors:

  • Water temperature, wave height/period/direction, swell height/period/direction
  • Wind speed/gusts/direction, air temperature, humidity, precipitation/rain/showers, pressure, cloud cover, UV index, day/night, human-readable weather condition
  • Bathing Conditions — computed text/icon rating, thresholds fully configurable via sliders (global, not per-location)
  • Surf Score — a 0-100 score blending wave period, wave height, swell/wind direction alignment (against the beach’s orientation), wind speed and water temperature, with adjustable weights and a full breakdown in the attributes so it’s never a black box. Comes with a category sensor and a ★ star-rating sensor too.
  • Manual Update Now button per location (bypasses backoff/rate-limit for a deliberate refresh)
  • Diagnostic HTTP-status sensors + full HA “Download Diagnostics” support

Everything is translated (EN/DE currently, PRs welcome for more), entity names and state values both.

Why not just YAML rest: sensors?

If you run more than a couple of locations, Open-Meteo will 403 you when several sensors’ update cycles line up and fire in parallel. This integration routes every request, across every location, through one shared rate limiter with automatic error backoff — so it scales to as many locations as you want without babysitting update intervals.

Install

Via HACS custom repository (not yet in the default list — PR pending review):

  1. HACS → Integrations → ⋮ → Custom repositories
  2. Add https://github.com/LuckyTriple7/ha-beach-weather as an Integration
  3. Install, restart HA, add via Settings → Devices & Services

Repo: GitHub - LuckyTriple7/ha-beach-weather: Home Assistant custom integration for beach/water conditions (water temp, waves, wind) via Open-Meteo · GitHub

Open to feedback, bug reports, and feature requests — it’s had a lot of iteration this week but real-world use on other people’s beaches will surface things I haven’t thought of.

1 Like