Bundesliga-Ergebnisse direkt im Home-Assistant-Dashboard anzeigen, das nächste Spiel des Lieblingsvereins einblenden oder bei einem Tor automatisch das Licht blinken lassen? Mit OpenLigaDB und Home Assistant ist genau das möglich.
OpenLigaDB stellt Spielpläne, Ergebnisse und Tabellen verschiedener Fußball-Ligen kostenlos über eine API bereit. Eine neue Custom Integration bringt diese Daten direkt als Sensoren nach Home Assistant. Unterstützt werden unter anderem Bundesliga, 2. Bundesliga, 3. Liga und DFB-Pokal.
In dieser Anleitung zeige ich dir, wie du OpenLigaDB in Home Assistant über HACS installierst, deinen Lieblingsverein auswählst und Ergebnisse, Spielstände und die Bundesliga-Tabelle im Dashboard anzeigen kannst.
Was ist OpenLigaDB?
OpenLigaDB ist eine frei nutzbare Sportdatenbank. Besonders bekannt ist der Dienst für Daten rund um die deutschen Fußball-Ligen.
Über die OpenLigaDB-API lassen sich unter anderem folgende Informationen abrufen:
- aktuelle Spielergebnisse
- kommende Begegnungen
- Spieltag
- Bundesliga-Tabelle
- Mannschaften
- Torschützen
- einzelne Spiele
Ein API-Key oder Benutzerkonto wird für das reine Abrufen der Daten nicht benötigt. OpenLigaDB ist ein Community-Projekt. Die Daten werden von den Nutzern gepflegt, weshalb Umfang und Aktualität je nach Wettbewerb unterschiedlich sein können.
Welche Fußball-Ligen funktionieren 2026?
Für die Saison 2026/2027 sind bei OpenLigaDB zahlreiche Wettbewerbe vorhanden. Für Home Assistant sind vor allem diese interessant:
| Wettbewerb | Liga-Kürzel | Saison |
|---|---|---|
| 1. Bundesliga | bl1 | 2026 |
| 2. Bundesliga | bl2 | 2026 |
| 3. Liga | bl3 | 2026 |
| DFB-Pokal | dfb | 2026 |
| Champions League | ucl | 2026 |
| Frauen-Bundesliga | ffb1 | 2026 |
| Fußball-WM 2026 | wm26 | 2026 |
Bei einer Saison wie 2026/2027 verwendet OpenLigaDB immer das Startjahr, also 2026.
OpenLigaDB in Home Assistant: Welche Integration verwenden?
Für Home Assistant stehen inzwischen mehrere Community-Lösungen zur Verfügung. Für dieses Projekt verwende ich die Custom Integration HA-OpenLigaDB.
Sie stellt zwei grundlegende Sensortypen bereit:
- Team-Sensor: liefert Informationen zu einem bestimmten Verein.
- Liga-Sensor: liefert unter anderem Spieltag und komplette Tabelle.
Der Team-Sensor enthält Informationen zum letzten, aktuellen und nächsten Spiel. Zusätzlich können Vereinslogo, Gegner, Spielort, Ergebnis und weitere Spieldaten als Attribute zur Verfügung stehen.
Besonders interessant für Automationen sind die Ereignisse, welche die Integration während eines Spiels erzeugen kann. Dazu gehören ein Tor, Spielbeginn und Spielende.
OpenLigaDB über HACS installieren
Die Integration gehört derzeit nicht zum offiziellen Home-Assistant-Core. Sie wird als Custom Integration über HACS installiert.
Falls du HACS bereits eingerichtet hast, gehst du folgendermaßen vor:
- Öffne HACS in Home Assistant.
- Wechsle zu Integrationen.
- Öffne oben rechts das Menü mit den drei Punkten.
- Wähle Benutzerdefinierte Repositories / Custom repositories.
- Füge das Repository
Belgadon/HA-OpenLigaDBals Integration hinzu. - Installiere anschließend OpenLigaDB.
- Starte Home Assistant neu.
Da es sich um eine Community-Integration handelt, würde ich wie bei anderen HACS-Erweiterungen vor größeren Änderungen ein aktuelles Home-Assistant-Backup erstellen.
OpenLigaDB in Home Assistant einrichten
Nach dem Neustart wird die Integration über die normale Home-Assistant-Oberfläche eingerichtet.
- Öffne Einstellungen → Geräte & Dienste.
- Klicke auf Integration hinzufügen.
- Suche nach OpenLigaDB.
- Wähle aus, ob du einen Verein oder eine komplette Liga hinzufügen möchtest.
Für die Bundesliga wird das Liga-Kürzel bl1 verwendet. Anschließend kannst du deinen gewünschten Verein auswählen.
Diese Sensoren entstehen in Home Assistant
Nach der Einrichtung stehen die OpenLigaDB-Daten als normale Home-Assistant-Entitäten zur Verfügung. Dadurch können sie wie andere Sensoren in Dashboards, Templates und Automationen verwendet werden.
Nächstes Spiel
Der Team-Sensor kann das nächste Spiel des ausgewählten Vereins enthalten. Dazu gehören beispielsweise:
- Gegner
- Datum und Uhrzeit
- Heim- oder Auswärtsspiel
- Spieltag
- Austragungsort
Letztes Spiel
Auch die zuletzt abgeschlossene Begegnung steht zur Verfügung. So kannst du beispielsweise das letzte Ergebnis dauerhaft auf deinem Smart-Home-Dashboard anzeigen.
Live-Spielstand
Während eines laufenden Spiels kann die Integration den aktuellen Spielstand aktualisieren. Die Abfrage erfolgt normalerweise in größeren Zeitabständen. Erkennt die Integration ein laufendes Spiel, wird häufiger aktualisiert.
Bundesliga-Tabelle
Ein Liga-Sensor stellt die komplette Tabelle als Attribut bereit. Enthalten sein können unter anderem Platzierung, Spiele, Siege, Unentschieden, Niederlagen, Tore, Tordifferenz und Punkte.
Nächstes Spiel im Home-Assistant-Dashboard anzeigen
Die einfachste Möglichkeit ist eine normale Entitäten-Karte. Interessanter wird es mit einer Markdown-Karte, weil sich dort mehrere Attribute eines Spiels gemeinsam darstellen lassen.
Ein mögliches Dashboard könnte beispielsweise folgende Informationen anzeigen:
- Vereinsname
- Gegner
- Anstoßzeit
- Heim- oder Auswärtsspiel
- aktueller Spielstand
- Spieltag
Die genaue Entity-ID hängt vom ausgewählten Verein ab. Du findest sie unter Entwicklerwerkzeuge → Zustände. Suche dort nach openligadb oder nach dem Namen deines Vereins.
Bundesliga-Tabelle in Home Assistant anzeigen
Auch eine komplette Bundesliga-Tabelle lässt sich mit einer Markdown-Karte darstellen. Die Tabelle liegt als Attribut des Liga-Sensors vor und kann über ein kleines Jinja-Template ausgegeben werden.
type: markdown
title: Bundesliga Tabelle
content: >-
| # | Team | Sp | TD | Pkt |
|---:|:-----|---:|---:|---:|
{% for team in state_attr('sensor.openligadb_bl1_tabelle_2026', 'table') or [] %}
| {{ team.rank }} | {{ team.short_name or team.team_name }} | {{ team.matches }} | {{ team.goal_diff }} | **{{ team.points }}** |
{% endfor %}
Die Entity-ID musst du gegebenenfalls an deine Installation anpassen. Gerade auf einem Wandtablet ergibt das eine sehr schöne Ergänzung zu Wetter, Energieverbrauch oder Kalender.
Bei einem Tor automatisch eine Aktion ausführen
Hier wird OpenLigaDB für das Smart Home besonders interessant. Die Integration erzeugt bei einem erkannten Tor das Ereignis openligadb_goal.
Darauf kann eine Home-Assistant-Automation reagieren. Du könntest beispielsweise eine Lampe kurz blinken lassen oder eine Push-Nachricht auf dein Smartphone schicken.
alias: Fußball - Tor Benachrichtigung
triggers:
- trigger: event
event_type: openligadb_goal
actions:
- action: notify.notify
data:
title: "Tor!"
message: >
{{ trigger.event.data.team }}
hat getroffen.
Spielstand: {{ trigger.event.data.score }}
Welche Daten im Event vorhanden sind, kann sich mit neuen Versionen der Community-Integration ändern. Prüfe deshalb bei einer eigenen Automation zunächst unter Entwicklerwerkzeuge → Ereignisse, welche Informationen bei dir übertragen werden.
Licht bei einem Tor blinken lassen
Zusätzlich zur Benachrichtigung kannst du natürlich auch Geräte im Smart Home ansteuern.
alias: Fußball - Licht bei Tor
triggers:
- trigger: event
event_type: openligadb_goal
actions:
- action: light.turn_on
target:
entity_id: light.wohnzimmer
data:
flash: short
Welche Flash-Funktionen verfügbar sind, hängt von der verwendeten Lampe und Integration ab. Alternativ kannst du über eine Szene oder mehrere Ein- und Ausschaltvorgänge einen eigenen Effekt bauen.
Benachrichtigung vor dem nächsten Spiel
Ein weiteres interessantes Projekt ist eine Erinnerung vor dem nächsten Spiel des eigenen Vereins. Der Sensor enthält beim kommenden Spiel einen Zeitstempel, der sich über einen Template-Sensor oder eine Automation auswerten lässt.
Damit könntest du beispielsweise 30 Minuten vor dem Anpfiff folgende Aktionen starten:
- Push-Nachricht auf das Smartphone
- Fernseher einschalten
- passende Lichtszene aktivieren
- Rollläden schließen
- Dashboard automatisch auf die Fußballansicht umschalten
OpenLigaDB Team Tracker als Alternative
Neben HA-OpenLigaDB gibt es mit OpenLigaDB Team Tracker eine weitere Home-Assistant-Integration.
Sie konzentriert sich stärker auf einen bestimmten Verein und erzeugt aktuell sechs Sensoren pro Team:
- Tabellenplatz
- Punkte
- nächstes Spiel
- letztes Spiel
- Spiele
- komplette Tabelle
Zusätzlich werden Vereinslogos als entity_picture bereitgestellt. Mehrere Vereine und Ligen können parallel eingerichtet werden.
Für eine einfache Vereinsübersicht ist diese Integration ebenfalls interessant. Wenn du dagegen Live-Ereignisse wie Tore direkt als Trigger für Automationen verwenden möchtest, bietet HA-OpenLigaDB dafür bereits eigene Events.
HA-OpenLigaDB oder OpenLigaDB Team Tracker?
| Funktion | HA-OpenLigaDB | Team Tracker |
|---|---|---|
| Lieblingsverein | Ja | Ja |
| Nächstes Spiel | Ja | Ja |
| Letztes Spiel | Ja | Ja |
| Ligatabelle | Ja | Ja |
| Vereinslogo | Ja | Ja |
| Live-Spielstand | Ja | Spielinformationen vorhanden |
| Tor-Event für Automationen | Ja | nicht Schwerpunkt der Integration |
| Installation | HACS Custom Repository | HACS Custom Repository |
Beide Projekte sind Community-Integrationen und werden unabhängig von Home Assistant entwickelt. Dadurch können sich Funktionen und Einrichtung mit zukünftigen Versionen verändern.
OpenLigaDB direkt über REST in Home Assistant verwenden
Wer keine Custom Integration installieren möchte, kann die OpenLigaDB-API grundsätzlich auch direkt über REST-Sensoren oder eigene Templates abfragen.
Die API stellt dafür unter anderem Endpunkte für komplette Spielzeiten, einzelne Spieltage, Tabellen, Teams und das nächste Spiel einer Liga bereit.
Für die meisten Home-Assistant-Nutzer würde ich jedoch zunächst eine der fertigen Integrationen verwenden. Dadurch müssen JSON-Strukturen, Aktualisierungsintervalle und Saisonwechsel nicht vollständig selbst verwaltet werden.
OpenLigaDB aktualisiert den Spielstand nicht
Falls keine aktuellen Daten erscheinen, würde ich folgende Punkte überprüfen:
- Ist die OpenLigaDB-Integration geladen?
- Ist die richtige Liga ausgewählt?
- Existiert der Wettbewerb für die aktuelle Saison bei OpenLigaDB?
- Wurde Home Assistant nach der HACS-Installation neu gestartet?
- Werden unter Entwicklerwerkzeuge → Zustände OpenLigaDB-Sensoren angezeigt?
- Sind die Ergebnisse bereits bei OpenLigaDB eingetragen?
Da OpenLigaDB ein Community-Projekt ist, kann ein Ergebnis gelegentlich etwas später eingetragen werden.
Welche Daten liefert OpenLigaDB kostenlos?
Der Datenabruf über OpenLigaDB benötigt keinen API-Key. Die Schnittstelle unterstützt unter anderem komplette Spielpläne, Tabellen, Mannschaften, einzelne Spieltage und Torschützen.
Für direkte API-Abfragen gilt ein Limit von 60 Anfragen pro Minute und IP-Adresse. OpenLigaDB empfiehlt außerdem, Daten sparsam abzurufen. Die Home-Assistant-Integration übernimmt das Aktualisieren für dich und erhöht die Abfragefrequenz während eines laufenden Spiels.
Häufige Fragen zu Home Assistant und OpenLigaDB
Kann Home Assistant Bundesliga-Ergebnisse anzeigen?
Ja. Über OpenLigaDB lassen sich Ergebnisse, kommende Spiele und die Bundesliga-Tabelle als Sensoren in Home Assistant integrieren und anschließend im Dashboard darstellen.
Brauche ich für OpenLigaDB einen API-Key?
Nein. Für das Abrufen der öffentlich verfügbaren OpenLigaDB-Daten ist kein API-Key erforderlich.
Funktioniert auch die 2. Bundesliga?
Ja. Die 2. Bundesliga verwendet bei OpenLigaDB das Kürzel bl2. Für die Saison 2026/2027 wird als Saison das Jahr 2026 verwendet.
Kann ich die 3. Liga in Home Assistant anzeigen?
Ja. Genau hier ist OpenLigaDB besonders interessant. Die 3. Liga ist mit dem Kürzel bl3 verfügbar und kann über die vorgestellten Community-Integrationen eingebunden werden.
Kann Home Assistant bei einem Tor reagieren?
Ja. Die HA-OpenLigaDB-Integration erzeugt bei erkannten Toren das Ereignis openligadb_goal. Dieses Event kann als Trigger für eine Home-Assistant-Automation verwendet werden.
Kann ich die Bundesliga-Tabelle im Dashboard anzeigen?
Ja. Der Liga-Sensor stellt die Tabelle als Attribut bereit. Mit einer Markdown-Karte lässt sich daraus eine kompakte Tabelle für das Home-Assistant-Dashboard erstellen.
Kann ich mehrere Vereine einbinden?
Ja. Je nach verwendeter Integration können mehrere Teams beziehungsweise mehrere Konfigurationseinträge eingerichtet werden. Damit lassen sich auch verschiedene Vereine und Wettbewerbe parallel verfolgen.
Fazit: Bundesliga und Fußball passen erstaunlich gut ins Smart Home
OpenLigaDB macht aus Home Assistant mehr als nur eine Oberfläche für Lampen, Heizungen und Sensoren. Spielpläne, Bundesliga-Ergebnisse und Tabellen lassen sich direkt in das bestehende Dashboard integrieren.
Besonders spannend sind die Automationen. Ein Tor kann eine Push-Nachricht auslösen, eine Lampe blinken lassen oder eine Szene starten. Das nächste Spiel kann auf dem Wandtablet stehen und die aktuelle Bundesliga-Tabelle direkt darunter erscheinen.
Da die Integration ohne eigenen OpenLigaDB-API-Key funktioniert, ist der Einstieg relativ unkompliziert. Beachten solltest du lediglich, dass es sich bei den vorgestellten Home-Assistant-Erweiterungen um Community-Projekte handelt.
Weitere Grundlagen, Installationsanleitungen und Projekte findest du in meiner Home-Assistant-Übersicht.
