{"id":30226598,"url":"https://github.com/victorigualada/surf-forecast-integration","last_synced_at":"2026-04-18T04:01:46.297Z","repository":{"id":309625422,"uuid":"1036160895","full_name":"victorigualada/surf-forecast-integration","owner":"victorigualada","description":"A HomeAssistant integration for getting surfing forecast reports","archived":false,"fork":false,"pushed_at":"2025-08-12T22:13:58.000Z","size":61,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-13T00:21:10.534Z","etag":null,"topics":["homeassistant","homeassistant-integration","surf","surf-forecast"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/victorigualada.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-11T16:40:15.000Z","updated_at":"2025-08-12T22:14:02.000Z","dependencies_parsed_at":"2025-08-13T00:22:09.490Z","dependency_job_id":"5397ce20-61a8-408f-8f45-3d903da1a02e","html_url":"https://github.com/victorigualada/surf-forecast-integration","commit_stats":null,"previous_names":["victorigualada/surf-forecast-integration"],"tags_count":null,"template":false,"template_full_name":"ludeeus/integration_blueprint","purl":"pkg:github/victorigualada/surf-forecast-integration","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/victorigualada%2Fsurf-forecast-integration","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/victorigualada%2Fsurf-forecast-integration/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/victorigualada%2Fsurf-forecast-integration/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/victorigualada%2Fsurf-forecast-integration/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/victorigualada","download_url":"https://codeload.github.com/victorigualada/surf-forecast-integration/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/victorigualada%2Fsurf-forecast-integration/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31955919,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T00:39:45.007Z","status":"online","status_checked_at":"2026-04-18T02:00:07.018Z","response_time":103,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["homeassistant","homeassistant-integration","surf","surf-forecast"],"created_at":"2025-08-14T17:01:30.678Z","updated_at":"2026-04-18T04:01:46.291Z","avatar_url":"https://github.com/victorigualada.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🌊 Surf Forecast Integration for Home Assistant 🌊\r\n\r\nThis custom integration brings Surfline surf forecasts and conditions into Home Assistant, providing sensors, selects, and automations for your favorite surf spots.\r\n**Get notified on your phone** when your desired surf conditions are met for each spot.\r\n\r\n## Features\r\n\r\n- Surf rating sensor for each configured spot\r\n- Blueprint for phone notifications when good conditions are met\r\n- First met condition sensor (date when desired conditions are first met)\r\n- Select entity to set minimum desired surf rating\r\n- Supports multiple surf spots\r\n\r\n## Automation Blueprints\r\n\r\n\r\n- `surf_incoming_notification.yaml`: Notifies your phone when desired conditions are met for a spot.\r\n\r\n  [![Open your Home Assistant instance and show the blueprint import dialog with a specific blueprint pre-filled.](https://my.home-assistant.io/badges/blueprint_import.svg)](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)\r\n\r\n## Installation\r\n\r\n### HACS\r\n\r\n\r\n### Manual\r\n\r\n1. Copy the `surf_forecast` folder to your Home Assistant `custom_components` directory:\r\n\r\n\t ```bash\r\n\t custom_components/surf_forecast/\r\n\t ```\r\n2. Restart Home Assistant.\r\n3. Add the integration via the Home Assistant UI (Settings → Devices \u0026 Services → Add Integration → Surf Forecast).\r\n\r\n## Configuration\r\n\r\n1. Search for your surf spot by name in the config flow.\r\n2. Select the correct spot from the list.\r\n3. Repeat for additional spots (each spot can only be added once).\r\n4. 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.\r\n\r\n## Entities\r\n\r\n- **Sensor:**\r\n\t- `sensor.\u003cspot\u003e_surf_rating`: Current/next surf rating\r\n\t- `sensor.\u003cspot\u003e_incoming_surf_date`: Date when good conditions are first met\r\n- **Select:**\r\n\t- `select.\u003cspot\u003e_minimum_surf_rating`: Set your minimum desired surf rating\r\n- **Binary Sensor:**\r\n\t- `binary_sensor.\u003cspot\u003e_incoming_surf`: On when forecast meets/exceeds your minimum rating\r\n\r\n## Troubleshooting\r\n\r\n- If the integration or entities do not appear, check the Home Assistant logs for errors.\r\n- Ensure the `domain` in `manifest.json` matches the folder name.\r\n- Restart Home Assistant after any changes to translation or integration files.\r\n- Only one entry per surf spot is allowed.\r\n\r\n---\r\n\r\nThanks to ludeeus for the original integration template.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvictorigualada%2Fsurf-forecast-integration","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvictorigualada%2Fsurf-forecast-integration","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvictorigualada%2Fsurf-forecast-integration/lists"}