ioBroker OpenLigaDB Adapter für Sportergebnisse und Spielinformationen
ioBroker OpenLigaDB 2026: Bundesliga-Ergebnisse und Tabellen in VIS anzeigen
Bundesliga-Ergebnisse, aktuelle Spieltage oder die Tabelle direkt im eigenen ioBroker-Dashboard anzeigen? Genau dafür gibt es den ioBroker OpenLigaDB Adapter. Er ruft Spielinformationen von OpenLigaDB ab und stellt die Daten anschließend als ioBroker-Datenpunkte und passende Widgets für die Visualisierung bereit.
Ich zeige dir in dieser Anleitung, wie du OpenLigaDB in ioBroker installierst, die Bundesliga 2026/2027 einrichtest und Ergebnisse, Tabellen und Spieltage in einer VIS-Visualisierung anzeigen kannst.
Der ursprüngliche Artikel stammt aus dem Jahr 2021. Der Adapter wurde seitdem deutlich weiterentwickelt. Die Screenshots in dieser Anleitung zeigen teilweise noch die ältere ioBroker- und VIS-Oberfläche, der grundsätzliche Aufbau ist aber weiterhin vergleichbar.
Was ist OpenLigaDB?
OpenLigaDB ist eine frei nutzbare Datenbank für Sportergebnisse. Besonders umfangreich sind die Daten für Fußball-Ligen.
Über eine öffentliche JSON-API können unter anderem folgende Informationen abgerufen werden:
- Spielpläne und einzelne Begegnungen
- aktuelle Ergebnisse
- Spieltag
- Ligatabelle
- Mannschaften
- Torschützen
- vergangene und kommende Spiele
Ein API-Schlüssel oder eine vorherige Anmeldung ist für den Abruf der Daten nicht erforderlich. OpenLigaDB wird als Community-Projekt gepflegt, weshalb die Verfügbarkeit und Vollständigkeit einzelner Ligen unterschiedlich sein kann.
Was macht der OpenLigaDB Adapter in ioBroker?
Der Adapter übernimmt den Abruf der OpenLigaDB-Daten und stellt sie innerhalb von ioBroker zur Verfügung. Dadurch musst du die REST-API nicht selbst per JavaScript abfragen.
Für jede konfigurierte Liga und Saison legt der Adapter passende Datenpunkte an. Diese können anschließend in Scripts, Blockly oder einer Visualisierung weiterverwendet werden.
Der Adapter wird weiterhin gepflegt. Im März 2026 wurde Version 1.9.3 veröffentlicht.
Projekt und Dokumentation findest du hier:
ioBroker OpenLigaDB auf GitHub
OpenLigaDB Adapter in ioBroker installieren
Die Installation erfolgt wie bei anderen ioBroker-Adaptern über die Adapterverwaltung.
- Öffne die ioBroker-Administration.
- Wechsle zu Adapter.
- Suche nach OpenLigaDB oder openliga.
- Installiere den Adapter.
- Lege anschließend eine Instanz des Adapters an.
OpenLigaDB für die Bundesliga 2026/2027 konfigurieren
Nach der Installation öffnest du die Konfiguration der OpenLigaDB-Instanz. Dort werden die gewünschten Ligen und Saisons eingetragen.
OpenLigaDB arbeitet dabei mit sogenannten Liga-Shortcuts. Für die aktuelle Bundesliga-Saison 2026/2027 lautet die Konfiguration beispielsweise:
| Liga | Shortcut | Saison |
|---|---|---|
| 1. Bundesliga 2026/2027 | bl1 | 2026 |
| 2. Bundesliga 2026/2027 | bl2 | 2026 |
| 3. Liga 2026/2027 | bl3 | 2026 |
| Champions League 2026/2027 | ucl | 2026 |
| DFB-Pokal 2026/2027 | dfb | 2026 |
| WM 2026 | wm26 | 2026 |
| Frauen-Bundesliga | ffb1 | 2026 |
Wichtig ist vor allem die Angabe der Saison. Bei einer Saison wie 2026/2027 wird nur das Startjahr 2026 eingetragen.
Die aktuelle Liste aller verfügbaren Ligen und deren Kürzel findest du direkt bei OpenLigaDB:
Verfügbare OpenLigaDB-Ligen anzeigen
Im Beispiel meines ursprünglichen Projekts war noch die Bundesliga-Saison 2020 eingetragen. Für die Saison 2026/2027 verwendest du entsprechend bl1 und 2026.
Mehrere Ligen gleichzeitig verwenden
Du bist nicht auf eine einzige Liga beschränkt. So kannst du beispielsweise Bundesliga, Champions League und DFB-Pokal parallel hinzufügen.
Das ist besonders interessant, wenn du in deiner Visualisierung die nächsten Spiele deines Lieblingsvereins ligaübergreifend anzeigen möchtest.
OpenLigaDB Datenpunkte in ioBroker
Nach dem Speichern benötigt der Adapter kurz Zeit, um die Daten von OpenLigaDB abzurufen. Anschließend findest du unter Objekte → openligadb.0 für jede konfigurierte Liga und Saison einen eigenen Bereich.
Ein Datenpunkt kann beispielsweise so aufgebaut sein:
openligadb.0.bl1.2026.allmatches
Besonders wichtig sind die Datenpunkte allmatches und currgameday. allmatches enthält die Spiele und Ergebnisse der konfigurierten Liga als JSON-Daten. currgameday enthält den vom Adapter berechneten aktuellen Spieltag.
Je nach Liga stehen weitere Daten wie beispielsweise die Torschützen zur Verfügung.
Bundesliga-Tabelle in ioBroker VIS anzeigen
Ein großer Vorteil des Adapters sind die mitgelieferten Widgets. Dadurch kannst du die OpenLigaDB-Daten ohne eigenes JavaScript direkt in einer VIS-Visualisierung darstellen.
Suche in der Widget-Auswahl nach openligadb. In der aktuellen Adapter-Dokumentation werden fünf Widgets beschrieben.
- Table 4: Ligatabelle anzeigen
- Games of Gameday v2: Spiele eines Spieltags anzeigen
- Games of favorite clubs 2: Spiele ausgewählter Vereine anzeigen
- Pivot Table 2: Ergebnisse in einer Kreuztabelle darstellen
- Goal getters 2: Torschützenliste anzeigen
Aktuelle Bundesliga-Tabelle mit Table 4
Für eine klassische Bundesliga-Tabelle verwendest du das Widget Table 4.
Das wichtigste Feld ist allmatches. Dort wählst du beispielsweise für die Bundesliga 2026/2027 folgenden Datenpunkt:
openligadb.0.bl1.2026.allmatches
Zusätzlich wird currgameday benötigt:
openligadb.0.bl1.2026.currgameday
Die Tabelle wird anschließend aus den vorhandenen Spieldaten berechnet. In der aktuellen Version kannst du verschiedene Ansichten verwenden, darunter Gesamttabelle, Heimtabelle, Auswärtstabelle sowie Hin- und Rückrunde.
Gesamt-, Heim- und Auswärtstabelle anzeigen
Das aktuelle Tabellen-Widget bietet mehrere Modi. Damit kannst du beispielsweise nur Heimspiele oder Auswärtsspiele für die Berechnung berücksichtigen.
| Modus | Anzeige |
|---|---|
1total | Gesamttabelle |
2home | Heimtabelle |
3away | Auswärtstabelle |
4round1 | Hinrunde |
5round2 | Rückrunde |
Zusätzlich lassen sich unter anderem Vereinsnamen verkürzen, Vereinslogos begrenzen, Trends anzeigen oder bestimmte Vereine hervorheben.
Aktuellen Bundesliga-Spieltag anzeigen
Wenn du statt der Tabelle lieber die aktuellen Begegnungen sehen möchtest, eignet sich das Widget Games of Gameday v2.
Das Widget kann den aktuellen Spieltag automatisch verwenden. Alternativ lässt sich ein bestimmter oder ein relativ zum aktuellen Spieltag liegender Spieltag anzeigen.
Praktisch ist das beispielsweise für drei Ansichten:
- letzter Spieltag
- aktueller Spieltag
- nächster Spieltag
Das Widget kann außerdem Torschützeninformationen anzeigen und bestimmte Vereine hervorheben.
Spiele des Lieblingsvereins anzeigen
Besonders interessant finde ich das Widget Games of favorite clubs 2. Damit kannst du gezielt kommende Spiele eines oder mehrerer Vereine anzeigen.
Der Vorteil ist, dass mehrere Ligen eingebunden werden können. So lassen sich beispielsweise Bundesliga-, Champions-League- und DFB-Pokal-Spiele eines Vereins gemeinsam in einer View darstellen.
Über das Feld highlight definierst du den Vereinsnamen beziehungsweise einen passenden Teil des Namens.
Torschützenliste in ioBroker anzeigen
Mit Goal getters 2 steht außerdem ein Widget für Torschützen zur Verfügung. Voraussetzung ist, dass die jeweilige OpenLigaDB-Liga entsprechende Daten liefert.
Die Zahl der angezeigten Spieler lässt sich begrenzen. Außerdem können bestimmte Spielernamen hervorgehoben oder gefiltert werden.
OpenLigaDB-Daten mit JavaScript verwenden
Die Daten müssen nicht zwingend über die fertigen Widgets verwendet werden. Da allmatches als JSON vorliegt, kannst du die Informationen auch mit einem eigenen JavaScript auswerten.
Damit lassen sich beispielsweise eigene Automationen bauen:
- Beleuchtung in Vereinsfarben vor dem Spiel einschalten
- Telegram-Nachricht vor Spielbeginn senden
- nächstes Spiel auf einem eigenen Dashboard anzeigen
- Spielergebnisse automatisch auswerten
- besondere Aktionen bei einem Heimspiel starten
Der aktuelle Adapter bietet außerdem einen sendTo-Befehl namens getMatchData, über den gezielt Spiele einer Liga innerhalb eines bestimmten Zeitraums abgefragt werden können.
Grundlagen zur Verarbeitung solcher Daten findest du auch in meiner ioBroker JavaScript Übersicht.
Welche Ligen gibt es 2026 bei OpenLigaDB?
OpenLigaDB ist längst nicht auf die Bundesliga beschränkt. Für die Saison 2026 sind beispielsweise folgende Wettbewerbe vorhanden:
- 1. Bundesliga
- 2. Bundesliga
- 3. Liga
- Champions League
- DFB-Pokal
- Fußball-WM 2026
- Frauen-Bundesliga
- DEL
- DEL2
- Champions Hockey League
Da OpenLigaDB ein Community-Projekt ist, können außerdem weitere Ligen und Sportarten hinzukommen.
OpenLigaDB API ohne ioBroker Adapter nutzen
Interessant für eigene Projekte ist auch die eigentliche OpenLigaDB-API. Sie kann ohne Benutzerkonto und ohne API-Key abgefragt werden.
Eine Abfrage der Bundesliga-Saison sieht beispielsweise so aus:
https://api.openligadb.de/getmatchdata/bl1/2026
OpenLigaDB stellt außerdem Endpunkte für Tabellen, Mannschaften, Spieltage und einzelne Spiele bereit.
Die komplette API-Dokumentation findest du hier:
OpenLigaDB bittet darum, die API nicht unnötig häufig aufzurufen. Für eigene Anwendungen gilt aktuell ein Limit von 60 Anfragen pro Minute und IP-Adresse.
OpenLigaDB aktualisiert keine Daten?
Falls nach der Einrichtung keine Ergebnisse erscheinen, würde ich zuerst diese Punkte prüfen:
- Ist der Liga-Shortcut korrekt?
- Wurde bei einer Saison 2026/2027 als Saison
2026eingetragen? - Ist die OpenLigaDB-Instanz grün und verbunden?
- Existiert die gewünschte Liga überhaupt bei OpenLigaDB?
- Wurden unter
openligadb.0Datenpunkte angelegt? - Ist beim Widget der richtige
allmatches-Datenpunkt ausgewählt?
Da die Daten von einem externen Dienst stammen, kann es außerdem vorkommen, dass Ergebnisse noch nicht eingetragen wurden oder OpenLigaDB vorübergehend nicht erreichbar ist.
Häufige Fragen zu ioBroker OpenLigaDB
Was muss ich für die Bundesliga 2026/2027 eintragen?
Für die 1. Bundesliga verwendest du den Liga-Shortcut bl1 und als Saison 2026. Bei einer Saison über zwei Kalenderjahre wird nur das Startjahr eingetragen.
Kann ich die 2. Bundesliga mit OpenLigaDB anzeigen?
Ja. Für die Saison 2026/2027 lautet der Shortcut bl2 und die Saison 2026.
Kann ich DFB-Pokal und Champions League einbinden?
Ja. OpenLigaDB führt 2026 unter anderem den DFB-Pokal mit dfb und die Champions League mit ucl. Beide Wettbewerbe können zusätzlich zur Bundesliga konfiguriert werden.
Brauche ich für OpenLigaDB einen API-Key?
Nein. Die OpenLigaDB-API kann ohne Registrierung und ohne API-Schlüssel gelesen werden.
Kann ich meinen Lieblingsverein in VIS hervorheben?
Ja. Mehrere OpenLigaDB-Widgets besitzen eine Highlight-Funktion. Darüber können Vereinsnamen gesucht und anschließend über die vorhandenen CSS-Klassen optisch hervorgehoben werden.
Kann ioBroker die Spiele meines Vereins aus mehreren Wettbewerben anzeigen?
Ja. Das Widget „Games of favorite clubs 2“ kann Daten aus mehreren konfigurierten Ligen verwenden. Damit lassen sich beispielsweise Bundesliga, Champions League und DFB-Pokal kombinieren.
Fazit
Der ioBroker OpenLigaDB Adapter ist auch 2026 noch eine interessante Erweiterung, wenn Fußball-Ergebnisse oder andere Sportdaten im eigenen Smart Home angezeigt werden sollen. Die Einrichtung ist überschaubar: Liga und Saison eintragen, Daten abrufen lassen und anschließend den gewünschten Datenpunkt mit einem der OpenLigaDB-Widgets verbinden.
Spannend finde ich inzwischen vor allem die zusätzlichen Möglichkeiten gegenüber meiner ursprünglichen Anleitung aus dem Jahr 2021. Neben der klassischen Tabelle können aktuelle Spieltage, Lieblingsvereine, Torschützen und mehrere Wettbewerbe wesentlich flexibler dargestellt werden.
Weitere Anleitungen zu Adaptern, Blockly, JavaScript und Visualisierungen findest du in meiner ioBroker Übersicht.

Vielen Dank !Sehr gut gemacht.
Danke für Dein Feedback, das freut mich sehr 🙂
Super und wie bekomme ich das in Jarvis angezeigt ?