Du packst den Divoom Times Gate aus, schließt ihn an und siehst zu, wie fünf LCD-Bildschirme mit Börsenkursen, Wetterdaten und Pixel-Art-Animationen aufleuchten. Die App funktioniert problemlos. Aber du fragst dich weiterhin: Kann ich eigene Daten an diese Bildschirme senden? Kann ich ein Skript schreiben, das auf Bildschirm drei ein benutzerdefiniertes Dashboard anzeigt, während auf Bildschirm eins weiterhin die Uhr läuft?
Die kurze Antwort lautet: ja – aber nicht so, wie du vielleicht erwartest. Divoom hat keine offizielle API-Dokumentation für den Times Gate veröffentlicht. Stattdessen hat die Entwicklergemeinschaft die lokale Netzwerk-API des Geräts per Reverse Engineering untersucht, Bibliotheken in Python, Rust und C# entwickelt und sie in Plattformen wie Home Assistant integriert. Dieser Leitfaden zeigt, wie der Times Gate tatsächlich kommuniziert, was seine lokale LAN-API leisten kann und mit welchen Tools du am schnellsten loslegen kannst.
Die offizielle Einrichtungsanleitung für den Times Gate auf dem YouTube-Kanal von Divoom.
Wie der Times Gate mit deinem Netzwerk kommuniziert
Bevor du auch nur eine einzige Codezeile schreibst, musst du eine Sache verstehen, die beim ersten Mal fast jeden Entwickler ins Stolpern bringt: Der Times Gate stellt nicht sofort nach dem Einschalten eine lokale API bereit. Beim Start verbindet sich das Gerät über MQTT für die Echtzeitkommunikation und HTTPS für die Datensynchronisierung mit den Cloud-Servern von Divoom. Erst nachdem dieser erste Cloud-Handshake abgeschlossen ist, wird der lokale HTTP-Endpunkt in deinem Netzwerk verfügbar.
Diese Architektur unterscheidet sich vom Pixoo-64, das als einfacheres lokales Gerät arbeitet. Wenn du die REST-API des Pixoo-64 bereits verwendet hast (behandelt in unserem Einsteigerleitfaden zur Pixoo-64-API), musst du dich beim Times Gate auf eine steilere Lernkurve einstellen. Aufgrund der Cloud-Abhängigkeit brauchst du während der Einrichtung eine funktionierende WLAN-Verbindung mit Internetzugang, und die lokale API verschwindet, wenn das Gerät seine Cloud-Verbindung verliert.
Warum ist das wichtig? Weil es jede Entscheidung beeinflusst, die du darüber triffst, wie du das Gerät steuern möchtest. Wenn du ein Smart-Home-Dashboard entwickelst, das einen Internetausfall überstehen muss, brauchst du eine Fallback-Strategie. Wenn du einfach nur Skripte von deinem Schreibtisch aus ausführst, ist der Cloud-Handshake ein einmaliger Einrichtungsschritt, und die lokale API funktioniert danach reibungslos.
Das Times Gate ist kein Gerät mit nur einem Bildschirm, an das nachträglich eine API angebaut wurde. Es ist ein Dashboard mit fünf Bildschirmen, das vollständig programmierbar ist – sobald du verstanden hast, wie du damit kommunizierst.
Die lokale LAN-API: Was du direkt steuern kannst
Sobald das Times Gate mit deinem WLAN verbunden ist und den Cloud-Handshake abgeschlossen hat, stellt es in deinem lokalen Netzwerk eine HTTP-API bereit. Entwickler aus der Community haben die wichtigsten Funktionen durch Experimente und Reverse Engineering ermittelt. Folgendes kannst du mit diesem Endpunkt tatsächlich tun:
- Bildschirmkanäle wechseln — jedem der fünf Bildschirme sagen, dass er einen anderen Kanal anzeigen soll (Uhr, Wetter, Börsenticker, Social-Media-Statistiken, benutzerdefinierte Grafik).
- Benutzerdefinierte Pixelgrafiken übertragen — rohe Pixeldaten an einen bestimmten Bildschirm senden, sodass du alles darstellen kannst, was in ein 128×128-Raster passt.
- Helligkeit und Lautstärke steuern — Anzeigeintensität und Audioausgabe programmgesteuert anpassen.
- Gerätestatus abfragen — aktuellen Zustand jedes Bildschirms, aktive Kanäle und Verbindungsinformationen auslesen.
Die API kommuniziert über standardmäßiges HTTP. Das bedeutet, dass du sie aus jeder Sprache aufrufen kannst, die Netzwerkanfragen stellen kann – Python, JavaScript, Rust, Go oder sogar ein Shell-Skript mit curl. Für lokale Anfragen ist weder ein Authentifizierungstoken noch ein API-Schlüssel erforderlich; das Gerät vertraut allem im selben lokalen Netzwerk.
Ein Entwickler in der Divoom-Community auf Reddit stellte dieselbe Frage wie viele neue Times-Gate-Besitzer: „Ich möchte das Gerät programmgesteuert steuern, statt nur die mobile App zu verwenden. Weiß jemand, ob es eine API gibt?“ Der Thread zeigte, dass die lokale API zwar von Divoom vollständig undokumentiert ist, aber durchaus aktiv und reaktionsfähig ist.
Einrichtungstipp
Bevor du mit dem Schreiben von API-Aufrufen beginnst, stelle sicher, dass sich das Times Gate im selben WLAN wie dein Entwicklungsrechner befindet und vollständig hochgefahren ist (die Bildschirme sollten Live-Daten und keinen Ladezustand anzeigen). Wenn der lokale API-Endpunkt nicht antwortet, starte das Gerät neu und überprüfe, ob es Internetzugang hat.
Benutzerdefinierte Widgets auf fünf Bildschirme übertragen
Hier wird die Times Gate interessant. Anders als bei einem Pixeldisplay mit nur einem Bildschirm stehen Ihnen fünf unabhängige 128×128-Raster zur Verfügung. Damit können Sie ein echtes Desktop-Dashboard erstellen: Live-Aktienkurse auf Bildschirm eins, Kryptodiagramme auf Bildschirm zwei, ein Wetter-Widget auf Bildschirm drei, Ihre YouTube-Abonnentenzahl auf Bildschirm vier und eine benutzerdefinierte Pixel-Art-Animation auf Bildschirm fünf.
Das Senden eigener Inhalte folgt demselben Muster, unabhängig davon, welchen Bildschirm Sie ansteuern. Sie rendern Ihre Daten in ein 128×128-Pixel-Bitmap, codieren es in dem von der API erwarteten Format (typischerweise als rohes RGB oder eine komprimierte Variante) und senden es als HTTP-POST an den lokalen Endpunkt, wobei Sie den Bildschirmindex angeben. Das Gerät aktualisiert die Anzeige sofort.
Für praktische Implementierungen rendern die meisten Entwickler ihre Daten serverseitig mit einer schlanken Grafikbibliothek – Pythons Pillow ist eine gängige Wahl – und senden das resultierende Bitmap anschließend in festgelegten Intervallen an die Times Gate. Ein einfaches Python-Skript, das Aktienkurse über eine kostenlose API abruft, sie als Text und kleines Diagramm auf einer 128×128 großen Zeichenfläche darstellt und das Ergebnis alle 60 Sekunden an Bildschirm eins sendet, ist ein Projekt, das Sie an einem Nachmittag umsetzen können.
Die zweiseitige Ambientebeleuchtung mit 12 anpassbaren RGB-Effekten kann ebenfalls über die API angesteuert werden, allerdings ist die Unterstützung der Community für die programmatische Steuerung der Beleuchtung im Vergleich zu den Endpunkten für die Bildschirmsteuerung noch nicht so ausgereift.
Community-Tools für die Entwicklung mit Times Gate
Sie müssen nicht alles von Grund auf neu entwickeln. Die Entwickler-Community rund um Divoom-Geräte hat mehrere Bibliotheken und Tools entwickelt, die die rohe HTTP-API in eine komfortablere Form bringen. Wenn Sie die Pixoo-64-API bereits verwendet haben, werden Ihnen einige dieser Tools bekannt vorkommen – mehrere wurden ursprünglich für den Pixoo entwickelt und später um Unterstützung für Times-Gate-Endpunkte erweitert.
| Tool | Sprache | Funktion | Am besten geeignet für |
|---|---|---|---|
| pixoo-rest | Python (REST-Server) | Führt einen lokalen REST-Server aus, der die Divoom-HTTP-APIs kapselt; unterstützt das Zeichnen von Pixeln, Linien, Rechtecken und Text sowie das automatische Herunterladen von Bildern | Entwickler, die eine REST-Middleware-Schicht zwischen ihrer Anwendung und dem Gerät benötigen |
| divoom-cli | Rust | Kommandozeilentool und Bibliothek; umfasst die Erkennung von Geräten im LAN, Kanalwechsel und das Senden roher Pixel | Rust-Entwickler und alle, die CLI-Skripte dem Schreiben eines Servers vorziehen |
| Divoom.Api | C# / .NET | .NET-Bibliothek als Wrapper für Divoom-Geräte-APIs; ursprünglich für Timebox-Geräte entwickelt | C#-Entwickler im .NET-Ökosystem |
| divoom-gateway | REST-Gateway (Swagger UI) | Eigenständiges REST-API-Gateway mit OpenAPI-Spezifikation und Swagger UI; kapselt rohe Divoom-HTTP-APIs für jede Sprache | Teams, die eine dokumentierte, sprachunabhängige API-Schicht mit integrierter Erkundungsoberfläche wünschen |
Jedes Tool verfolgt einen anderen Ansatz. Pixoo-rest ist der beliebteste Ausgangspunkt für Python-Entwickler, da es die Protokolldetails übernimmt und dir übersichtliche Endpunkte wie /api/draw/text oder /api/draw/rectangle. Das auf Rust basierende divoom-cli eignet sich hervorragend, wenn du eine kompilierte Binärdatei aus Shell-Skripten oder Cronjobs aufrufen möchtest. Divoom.Api deckt die .NET-Seite ab. Und divoom-gateway ist die richtige Wahl, wenn du etwas Sprachübergreifendes entwickelst und Swagger-Dokumentation direkt mitgeliefert haben möchtest.
Das Rust-Ökosystem verdient besondere Erwähnung, da sowohl das Projekt pixoo-rest als auch das Rust-Div oom-Crate eine API zur Gerätesuche enthalten – du rufst eine Funktion auf und sie findet jedes Divoom-Gerät in deinem LAN. Das ist besonders nützlich, wenn du mehrere Displays hast oder sich die IP-Adresse des Geräts nach einem Neustart des Routers ändert.
Home-Assistant-Integration
Wenn du Home Assistant verwendest, musst du keine eigene Anwendung zur Steuerung des Times Gate schreiben. Die lokale HTTP-API ist direkt über die REST-Befehl-Integration von Home Assistant zugänglich. Dadurch kannst du API-Aufrufe als Teil jeder Automatisierung senden.
Die Einrichtung ist unkompliziert. Du definierst in deiner configuration.yaml einen REST-Befehl, der auf die lokale IP-Adresse des Times Gate und den aufzurufenden API-Endpunkt verweist. Anschließend löst du diesen Befehl über eine beliebige Automatisierung aus – durch einen Tastendruck, einen Zeit-Trigger, eine Statusänderung eines anderen Sensors oder einen Sprachbefehl. Die Diskussion in der Home-Assistant-Community zu Divoom-Geräten enthält funktionierende Beispiele für REST-Befehlskonfigurationen, die Bildschirmkanäle umschalten, benutzerdefinierte Bilder übertragen und die Helligkeit anhand von Umgebungslichtsensoren anpassen.
Praktische Automatisierungsideen, die Times-Gate-Besitzer mit Home Assistant umgesetzt haben, sind unter anderem das Umschalten aller fünf Bildschirme auf eine Uhr im „Fokusmodus“, sobald ein Pomodoro-Timer startet, das Anzeigen von Wetterwarnungen bei einer Sturmwarnung, das Einblenden einer Türklingelbenachrichtigung mit einer benutzerdefinierten Pixelanimation, wenn jemand klingelt, sowie das Durchlaufen von Social-Media-Statistiken alle paar Minuten während eines Livestreams.
Beachte: Da das Times Gate seine anfängliche Cloud-Verbindung benötigt, bevor die lokale API verfügbar ist, solltest du deiner Home-Assistant-Automatisierung eine Bedingung hinzufügen, die prüft, ob das Gerät reagiert, bevor Befehle gesendet werden. Eine einfache Ping-Prüfung verhindert, dass sich bei einem Internetausfall immer mehr Fehlereinträge in den Protokollen ansammeln.
Was die API derzeit noch nicht kann
Einschränkungen ehrlich anzusprechen, gehört zu einem guten Entwicklerleitfaden. Die Community-API des Times Gate ist leistungsfähig, hat aber echte Einschränkungen, die du kennen solltest, bevor du darauf ein Produktivsystem aufbaust.
Erstens gibt es keine offizielle API-Dokumentation. Alles, was die Community weiß, stammt aus Reverse Engineering. Das bedeutet, dass sich die API mit einem Firmware-Update ohne Vorankündigung ändern könnte. Wenn du etwas Kritisches auf Grundlage der lokalen API entwickelst, solltest du einen Ausweichplan haben – selbst wenn dieser nur darin besteht, nach jedem Firmware-Update zu prüfen, ob deine Skripte noch funktionieren.
Zweitens ist die Abhängigkeit von der Cloud eine zwingende Voraussetzung. Ein Nutzer im Home-Assistant-Subreddit musste dies auf die harte Tour erfahren, als er versuchte, sein Divoom-Gerät in einem isolierten VLAN ohne Internetzugang zu betreiben. Die REST-API reagierte einfach nicht, bis er dem Gerät erlaubte, zunächst die Cloud-Server von Divoom zu erreichen. Wenn du ein vollständig vom Netz getrenntes Smart-Home-Setup planst, ist das Times Gate möglicherweise nicht das richtige Display für diese Umgebung.
Drittens befindet sich die Unterstützung durch Community-Tools speziell für das Times Gate noch im Ausbau. Viele Bibliotheken wurden ursprünglich für den Pixoo-64 oder die Timebox entwickelt und später um Unterstützung für Times-Gate-Endpunkte erweitert, aber nicht jede Funktion wurde auf allen Gerätemodellen überprüft. Wenn du eine Bibliothek verwendest, die ursprünglich nicht für das Times Gate entwickelt wurde, teste jeden API-Aufruf einzeln, bevor du dich darauf verlässt.
Sicherheit bei Firmware-Updates
Führe nach jedem Firmware-Update des Times Gate einen kurzen Test deiner API-Skripte durch, bevor du davon ausgehst, dass weiterhin alles funktioniert. Fixiere die Firmware-Version, wenn du eine stabile Automatisierungspipeline hast, deren Ausfall du dir nicht leisten kannst.
FAQ
Verfügt das Times Gate über eine offizielle API?
Nein. Divoom hat kein offizielles API-Dokument für das Times Gate veröffentlicht. Die Entwicklergemeinschaft hat die lokale HTTP-API jedoch per Reverse Engineering analysiert und Bibliotheken in Python, Rust und C# entwickelt, mit denen sich das Gerät praktisch programmatisch steuern lässt.
Kann ich die Times Gate ohne Internetverbindung steuern?
Nicht vollständig. Die Times Gate benötigt zunächst eine Cloud-Verbindung über MQTT und HTTPS, bevor ihre lokale LAN-API verfügbar wird. Sobald dieser Handshake abgeschlossen ist, funktionieren lokale API-Aufrufe ohne laufenden Internetzugang – wenn das Gerät jedoch neu startet oder die Stromversorgung verliert, muss es sich erneut mit den Cloud-Servern von Divoom verbinden, bevor die lokale API wieder antwortet.
Welche Programmiersprachen werden von Community-Bibliotheken unterstützt?
Python (pixoo-rest), Rust (divoom-cli und die divoom-Crate) und C# (Divoom.Api für .NET). Außerdem gibt es divoom-gateway, ein eigenständiges REST-API-Gateway mit Swagger UI, das mit jeder Sprache funktioniert, die HTTP-Anfragen senden kann.
Unterstützt Home Assistant die Times Gate?
Ja, über die REST-Command-Integration von Home Assistant. Sie definieren einen REST-Befehl, der auf den lokalen API-Endpunkt der Times Gate verweist, und lösen ihn über jede beliebige Automatisierung aus. In der Home-Assistant-Community gibt es funktionierende Beispiele für die Integration von Divoom-Geräten.
Kann ich benutzerdefinierte Widgets an einzelne Bildschirme senden?
Ja. Jeder der fünf 128×128-LCD-Bildschirme kann unabhängige Inhalte anzeigen. Sie können benutzerdefinierte Pixelgrafiken, Text oder gerenderte Daten an jeden beliebigen Bildschirm senden, indem Sie ihn über den Bildschirmindex-Parameter der API ansprechen.
Wie es weitergeht
Wenn Sie bereits eine Times Gate besitzen, beginnen Sie mit einem einfachen curl-Befehl an die lokale API, um den Kanal eines Bildschirms zu wechseln – das ist Ihr „Hallo Welt“-Moment. Wählen Sie anschließend das Community-Tool, das zu Ihrer bevorzugten Sprache passt, und erstellen Sie ein kleines Projekt: einen Börsenticker, ein Wetter-Dashboard oder eine benutzerdefinierte Benachrichtigungsanimation. Die Times Gate lädt zum Experimentieren ein, und sobald ein Bildschirm etwas Benutzerdefiniertes anzeigt, folgen die anderen vier ganz natürlich.
Wenn Sie aus der Pixoo-64-Welt kommen, behandelt unser Einsteigerleitfaden zur Pixoo-64-API das einfachere lokale REST-API-Modell, das die Pixoo verwendet – ein nützlicher Kontext, um zu verstehen, was sich mit der cloudverbundenen Architektur der Times Gate geändert hat. Für die Hardwareeinrichtung und die offizielle Produktdokumentation finden Sie auf der Seite mit den Divoom-Produktanleitungen die aktuellen Anleitungen.
Divoom Times Gate
Fünf unabhängige 128×128-LCD-Bildschirme, per WLAN verbunden und vollständig über eine lokale API und Community-Tools programmierbar. Integrierte Widgets für Aktien, Kryptowährungen, Wetter und Social-Media-Statistiken.
Times Gate anzeigen
