{"id":51027237,"url":"https://github.com/johnbr/ha-world-cup-scoreboard","last_synced_at":"2026-06-21T20:30:56.847Z","repository":{"id":366025131,"uuid":"1274779101","full_name":"johnbr/ha-world-cup-scoreboard","owner":"johnbr","description":"Basic Home Assistant custom integration + Lovelace card for FIFA World Cup scores (ESPN feed). Lightweight cousin of mlb-live-scoreboard.","archived":false,"fork":false,"pushed_at":"2026-06-19T23:36:40.000Z","size":44,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-20T00:14:30.833Z","etag":null,"topics":["espn","hacs","home-assistant","home-assistant-custom","home-assistant-integration","lovelace","world-cup"],"latest_commit_sha":null,"homepage":null,"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/johnbr.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-19T22:09:47.000Z","updated_at":"2026-06-19T23:36:42.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/johnbr/ha-world-cup-scoreboard","commit_stats":null,"previous_names":["johnbr/ha-world-cup-scoreboard"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/johnbr/ha-world-cup-scoreboard","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnbr%2Fha-world-cup-scoreboard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnbr%2Fha-world-cup-scoreboard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnbr%2Fha-world-cup-scoreboard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnbr%2Fha-world-cup-scoreboard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/johnbr","download_url":"https://codeload.github.com/johnbr/ha-world-cup-scoreboard/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnbr%2Fha-world-cup-scoreboard/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34625624,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-21T02:00:05.568Z","response_time":54,"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":["espn","hacs","home-assistant","home-assistant-custom","home-assistant-integration","lovelace","world-cup"],"created_at":"2026-06-21T20:30:55.253Z","updated_at":"2026-06-21T20:30:56.835Z","avatar_url":"https://github.com/johnbr.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# World Cup Scoreboard (Home Assistant)\n\nA deliberately small custom integration that tracks **FIFA World Cup** scores\nfrom ESPN's public scoreboard feed and ships a matching Lovelace card.\n\nIt is the lightweight cousin of the MLB Live Scoreboard integration: one\nconfig entry → one `DataUpdateCoordinator` → one sensor that carries the whole\nmatch board as attributes, plus an auto-registered custom card.\n\n## What you get\n\n- **`sensor.world_cup_scoreboard`**\n  - `state`: number of matches currently in progress (`live_count`)\n  - attributes:\n    - `matches[]` — every match: `home`/`away` (`name`, `abbr`, `logo`, `score`,\n      `winner`), `status` (`state` `pre`/`in`/`post`, `detail`, `clock`,\n      `completed`), `note` (round/stage), `date`, `id`\n    - `featured` — the favorite team's most relevant match (live \u003e next \u003e last),\n      or `{}` if no favorite is set\n    - `league`, `season`, `favorite_team`, `match_count`, `live_count`\n- **`custom:world-cup-scoreboard-card`** — pinned featured match + a row per\n  match (crest, abbreviation, score, status pill). Auto-registered as a\n  Lovelace resource on setup.\n\n## Install\n\n1. Copy `custom_components/world_cup_scoreboard/` into your HA `config/custom_components/`\n   (or add this repo to HACS as a custom repository).\n2. Restart Home Assistant.\n3. **Settings → Devices \u0026 Services → Add Integration → \"World Cup Scoreboard\"**.\n   Optionally enter a favorite team as a 3-letter ESPN abbreviation (`USA`, `BRA`,\n   `ARG`, …); leave blank for no pinned team.\n\nThe card JS is copied into `www/community/world_cup_scoreboard/` and registered\nautomatically — no manual resource entry needed.\n\n## Card config\n\n```yaml\ntype: custom:world-cup-scoreboard-card\nentity: sensor.world_cup_scoreboard   # default\ntitle: World Cup                      # optional\nshow_featured: true                   # pin the favorite team at top\nshow_completed: true                  # include finished matches\nmax_matches: 0                        # 0 = no limit\nshow_day_nav: true                    # ◀ ▶ arrows to page between match days\nnav_snap_back_ms: 8000                # idle ms before snapping back to today (0 = sticky)\n```\n\nThe ◀ / ▶ arrows page back through previous days' results and forward through\nupcoming fixtures (bounded to the tournament window). Each day is fetched on\ndemand without disturbing the live sensor, and the card snaps back to today\nafter `nav_snap_back_ms` of inactivity — tap ⟳ to return immediately.\n\n## Data source\n\nESPN site API, men's World Cup slug `fifa.world`:\n`https://site.api.espn.com/apis/site/v2/sports/soccer/fifa.world/scoreboard`\n(unofficial, no key required). Polled every 30 s, tightening to 15 s while a\nmatch is live.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohnbr%2Fha-world-cup-scoreboard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjohnbr%2Fha-world-cup-scoreboard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohnbr%2Fha-world-cup-scoreboard/lists"}