← GIZMONET
2026-07-25 ยท ๐Ÿ“– 2 min read ยท ๐Ÿ‘ 7

Beach Weather - HA Integration

Beach Weather - HA Integration

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):

HACS โ†’ Integrations โ†’ โ‹ฎ โ†’ Custom repositories
Add https://github.com/LuckyTriple7/ha-beach-weather as an Integration
Install, restart HA, add via Settings โ†’ Devices & Services
Repo: https://github.com/LuckyTriple7/ha-beach-weather

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.

#home-assistant#integration#beach#conditions#surf

Log in to react or comment.

Comments (0)

No comments yet โ€” be the first.

← All posts