ioBroker

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.

  1. Öffne die ioBroker-Administration.
  2. Wechsle zu Adapter.
  3. Suche nach OpenLigaDB oder openliga.
  4. Installiere den Adapter.
  5. Lege anschließend eine Instanz des Adapters an.
OpenLigaDB Adapter in ioBroker installieren
Installation des OpenLigaDB-Adapters. Der Screenshot zeigt eine ältere ioBroker-Oberfläche.

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:

LigaShortcutSaison
1. Bundesliga 2026/2027bl12026
2. Bundesliga 2026/2027bl22026
3. Liga 2026/2027bl32026
Champions League 2026/2027ucl2026
DFB-Pokal 2026/2027dfb2026
WM 2026wm262026
Frauen-Bundesligaffb12026

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

OpenLigaDB Adapter Konfiguration in ioBroker
Konfiguration des OpenLigaDB-Adapters in ioBroker.

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.

Bundesliga Liga und Saison im ioBroker OpenLigaDB Adapter eintragen
Liga und Saison werden über Shortcut und Startjahr hinterlegt. Der Screenshot zeigt noch die Saison 2020.

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.

OpenLigaDB Datenpunkte mit Bundesliga Ergebnissen in ioBroker
Die Liga-Daten werden unter openligadb.0 als ioBroker-Datenpunkte angelegt. Hier ist noch die ältere Saison 2020 zu sehen.

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.

Bundesliga Tabelle mit OpenLigaDB in ioBroker VIS
OpenLigaDB-Tabelle in einer ioBroker-VIS. Das Bild stammt aus der ursprünglichen Anleitung von 2021.

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.

ModusAnzeige
1totalGesamttabelle
2homeHeimtabelle
3awayAuswärtstabelle
4round1Hinrunde
5round2Rückrunde

Zusätzlich lassen sich unter anderem Vereinsnamen verkürzen, Vereinslogos begrenzen, Trends anzeigen oder bestimmte Vereine hervorheben.

OpenLigaDB Bundesliga Tabelle und Einstellungen in ioBroker
Eine Bundesliga-Tabelle mit Vereinswappen und den zugehörigen Widget-Einstellungen.

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 API Dokumentation

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 2026 eingetragen?
  • Ist die OpenLigaDB-Instanz grün und verbunden?
  • Existiert die gewünschte Liga überhaupt bei OpenLigaDB?
  • Wurden unter openligadb.0 Datenpunkte 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.

Matthias Korte

Hauptberuflich Software-Entwickler und seit einigen Jahren Smart-Home Fan. Angefangen hat alles mit einem RaspberryMatic und einer schaltbaren Steckdose. Mittlerweile habe ich einige Steckdosen, Sensoren, und Thermostate sowie ioBroker zur Visualisierung im Einsatz.

3 Kommentare zu „ioBroker OpenLigaDB Adapter für Sportergebnisse und Spielinformationen“

    • Matthias KorteBeitragsautor

      Danke für Dein Feedback, das freut mich sehr 🙂

      Antworten
  • Flopsi

    Super und wie bekomme ich das in Jarvis angezeigt ?

    Antworten

Schreibe einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert