explaingit

adya84/ha-world-cup-2026

16PythonAudience · generalComplexity · 2/5Setup · easy

TLDR

A Home Assistant integration that brings live FIFA World Cup 2026 match data, group standings, knockout brackets, statistics, and countdown timers to your home automation dashboard, supporting 48 teams and 12 languages.

Mindmap

mindmap
  root((repo))
    What It Does
      Live match tracking
      Group standings
      Knockout brackets
      Tournament statistics
    Features
      12 language support
      Demo mode
      Pre-built dashboard
      HACS install
    Tech Stack
      Python
      Home Assistant
      HACS
    Tournament Coverage
      48 teams
      104 matches
      All knockout stages
    Audience
      Football fans
      Home automation users
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Add a live World Cup 2026 match tracker to your Home Assistant dashboard showing current scores, group standings, and upcoming fixtures.

USE CASE 2

Display tournament statistics like goals per match, top scorers, and biggest wins on a home automation screen updated in real time.

USE CASE 3

Use demo mode to set up and test the full dashboard layout before the tournament begins without needing a live API connection.

USE CASE 4

Install via HACS and import the pre-built dashboard to get a full multi-section World Cup view on desktop, tablet, or mobile.

Tech stack

PythonHome AssistantHACS

Getting it running

Difficulty · easy Time to first run · 30min

Requires Home Assistant with HACS, a live data API connection is needed for real match data, but demo mode works without it.

In plain English

This is a Home Assistant integration for following the FIFA World Cup 2026 tournament. Home Assistant is a popular home automation platform that lets people track all kinds of data on a dashboard in their home. This project adds World Cup match data to that dashboard so you can follow the entire tournament, covering all 48 teams, 12 groups, and 104 matches hosted across the United States, Canada, and Mexico. The integration pulls in live match data and tournament information, including current fixtures, results, group standings, goal scorers, match venues, and countdown timers to upcoming games. It also tracks which teams have qualified or been eliminated from the knockout rounds, covering every stage from the Round of 32 through to the Final. A Statistics Hub provides summary numbers across the whole tournament: total goals, goals per match, draw rates, and what percentage of games have finished with a particular scoreline pattern. A separate Tournament Records section tracks things like the biggest win, the highest-scoring match, the top-scoring team, and the best defensive record. The project includes a ready-to-import dashboard you can load directly into Home Assistant, along with a full application with sidebar navigation to move between sections like the Live Centre, Group Standings, Knockout bracket, Player Statistics, and Stadium directory. The dashboard works on desktop, tablet, and mobile. It also supports 12 languages, selectable from within the Home Assistant interface. A demo mode is included so you can set up and test the dashboard without needing a live API connection before the tournament is underway. Installation is compatible with HACS, the community package manager for Home Assistant add-ons.

Copy-paste prompts

Prompt 1
I have Home Assistant with HACS installed. Walk me through installing ha-world-cup-2026 and loading the pre-built dashboard.
Prompt 2
I want a Home Assistant automation that sends me a notification 15 minutes before any World Cup 2026 match involving my country starts. How do I use the integration's sensors for that?
Prompt 3
How do I create a Lovelace card that displays the knockout bracket and highlights matches where a specific team is playing?
Prompt 4
How do I switch the ha-world-cup-2026 integration to display in a different language and which 12 languages does it support?
Open on GitHub → Explain another repo

← adya84 on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.