https://github.com/victorigualada/surf-forecast-integration
A HomeAssistant integration for getting surfing forecast reports
https://github.com/victorigualada/surf-forecast-integration
homeassistant homeassistant-integration surf surf-forecast
Last synced: about 2 months ago
JSON representation
A HomeAssistant integration for getting surfing forecast reports
- Host: GitHub
- URL: https://github.com/victorigualada/surf-forecast-integration
- Owner: victorigualada
- License: mit
- Created: 2025-08-11T16:40:15.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-08-12T22:13:58.000Z (10 months ago)
- Last Synced: 2025-08-13T00:21:10.534Z (10 months ago)
- Topics: homeassistant, homeassistant-integration, surf, surf-forecast
- Language: Python
- Homepage:
- Size: 59.6 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# 🌊 Surf Forecast Integration for Home Assistant 🌊
This custom integration brings Surfline surf forecasts and conditions into Home Assistant, providing sensors, selects, and automations for your favorite surf spots.
**Get notified on your phone** when your desired surf conditions are met for each spot.
## Features
- Surf rating sensor for each configured spot
- Blueprint for phone notifications when good conditions are met
- First met condition sensor (date when desired conditions are first met)
- Select entity to set minimum desired surf rating
- Supports multiple surf spots
## Automation Blueprints
- `surf_incoming_notification.yaml`: Notifies your phone when desired conditions are met for a spot.
[](https://my.home-assistant.io/redirect/blueprint_import/?blueprint_url=https%3A%2F%2Fgithub.com%2Fvictorigualada%2Fsurf-forecast-integration%2Fblob%2Fmain%2Fblueprints%2Fsurf_incoming_notification.yaml)
## Installation
### HACS
### Manual
1. Copy the `surf_forecast` folder to your Home Assistant `custom_components` directory:
```bash
custom_components/surf_forecast/
```
2. Restart Home Assistant.
3. Add the integration via the Home Assistant UI (Settings → Devices & Services → Add Integration → Surf Forecast).
## Configuration
1. Search for your surf spot by name in the config flow.
2. Select the correct spot from the list.
3. Repeat for additional spots (each spot can only be added once).
4. Set your desired minimum surf rating for each spot using the select entity. This will be used by the blueprint to determine when to notify you.
## Entities
- **Sensor:**
- `sensor._surf_rating`: Current/next surf rating
- `sensor._incoming_surf_date`: Date when good conditions are first met
- **Select:**
- `select._minimum_surf_rating`: Set your minimum desired surf rating
- **Binary Sensor:**
- `binary_sensor._incoming_surf`: On when forecast meets/exceeds your minimum rating
## Troubleshooting
- If the integration or entities do not appear, check the Home Assistant logs for errors.
- Ensure the `domain` in `manifest.json` matches the folder name.
- Restart Home Assistant after any changes to translation or integration files.
- Only one entry per surf spot is allowed.
---
Thanks to ludeeus for the original integration template.