Trakt Smart-Home-Integration, kostenlos und Open Source

Ihre Serien und Filme von Trakt: Kalender, Wiedergabe, Poster, Szenen und Widgets.
Überblick
Diese Integration bringt Ihr Trakt-Konto in Gladys. Die Folgen der Serien, denen Sie folgen, und die Starts der Filme Ihrer Watchlist landen in einem Kalender „Serien und Filme“ für jeden Benutzer, der die Integration aktiviert. Szenen können am Tag einer Ausstrahlung reagieren (oder am Vortag, oder eine Woche vorher), genau zur Minute der Ausstrahlung, wenn sich ein Termin ändert, und wenn Sie auf Plex, Kodi, Jellyfin, Infuse oder in den Trakt-Apps etwas starten oder beenden. Szenenaktionen setzen einen Titel auf Ihre Watchlist oder markieren ihn als gesehen, und drei Dashboard-Widgets zeigen, was kommt, Ihre laufenden Serien und die aktuelle Wiedergabe, mit Postern.
Alles stammt aus der offiziellen Trakt-API, mit Ihrer eigenen kostenlosen Trakt-App. Gladys Trakt nutzt Trakt, ist aber weder von Trakt unterstützt noch zertifiziert.
Voraussetzungen
- Gladys Assistant 5.3.0 oder neuer (Kalender-Integrationen).
- Internetzugang.
- Ein Trakt-Konto (kostenlos genügt) und ein GitHub-Konto, das Trakt einmalig verlangt, damit Sie eine API-App erstellen können.
- Für „Aktuelle Wiedergabe“: ein Player, der an Trakt meldet (Plex, Kodi, Jellyfin, Emby, Infuse, die Trakt-Apps…), oder Check-ins.
Konfiguration
- Öffnen Sie auf trakt.tv Settings → My Apps (beim ersten Mal verlangt Trakt die Verknüpfung eines verifizierten GitHub-Kontos) und erstellen Sie eine App: beliebiger Name, zum Beispiel „Gladys“, Redirect-URI
urn:ietf:wg:oauth:2.0:oob. Kopieren Sie ihre Client-ID. Ein Client Secret wird nicht benötigt. - Fügen Sie in Gladys die Client-ID in die Konfiguration der Integration ein und speichern Sie.
- Klicken Sie auf Verbinden: Die Aktivierungsseite von Trakt öffnet sich. Melden Sie sich bei Trakt an und geben Sie den Code ein, der im Verbindungsstatus der Konfigurationsseite steht. Wenige Sekunden später zeigt der Status „Verknüpft mit <Ihr Trakt-Name>“.
- Drücken Sie unter Meine Kalender auf derselben Seite auf Für mich aktivieren. Jeder Benutzer, der den Kalender möchte, aktiviert die Integration für sich; das Trakt-Konto ist für alle dasselbe.
Trakt löscht eine App, die 30 Tage nicht genutzt wird: Lassen Sie die Integration laufen. Eine Entwicklungs-App (Standard) reicht für Sie und bis zu 16 eingeladene Personen.
| Feld | Beschreibung |
|---|---|
| Client ID | Die Client-ID Ihrer Trakt-App (64 Zeichen). Sie identifiziert die App; sie ist kein Passwort. |
| Trakt-Konto | Die Schaltfläche Verbinden: verknüpft das Konto über einen auf trakt.tv/activate eingegebenen Code. |
| Was verfolgt wird | Serienfolgen, Filmstarts und Streaming-Starts von Filmen (standardmäßig alle drei). |
| Im Voraus gelesene Tage | 30, 60 (Standard) oder 90 Tage. |
| Specials behalten | Folgen der „Staffel 0“ (Bonus, Making-of). Standardmäßig aus. |
| Aktuelle Wiedergabe | Fragt Trakt jede Minute, was das Konto ansieht. Standardmäßig an. |
| Abfrage des Kalenders | Jede Stunde, alle 3 Stunden (Standard), 6 oder 12 Stunden. |
| Uhrzeit des Auslösers „Erscheinungstag“ | Von 0 bis 23, Ortszeit (standardmäßig 9). |
| Sprache der Szenentexte | Sprache der fertigen Sätze und der Meldungen der Schaltflächen. Automatisch: die Sprache des Dashboards. |
Die Schaltflächen Jetzt neu lesen und Trakt-Konto trennen befinden sich unten in der Konfiguration. Widerrufen Sie nach einer Trennung auch die App in Ihren Trakt-Einstellungen (Connected apps).
Verwendung
Kalender
Jeder Benutzer erhält einen Kalender namens „Serien und Filme“:
- eine Folge ist ein Termin zur Sendezeit (umgerechnet in die Zeitzone von Gladys), so lang wie ihre Laufzeit: „Severance S02E05 – Trojan’s Horse“. Eine auf einmal veröffentlichte Staffel ist ein einziger Termin: „Andor S02E01–E08“;
- ein Filmstart und ein Streaming-Start eines Films Ihrer Watchlist sind ganztägige Termine.
Trakt listet die Folgen der Serien, die Sie gesehen haben oder auf der Watchlist führen, und die Filme Ihrer Watchlist. Der Kalender behält die letzten 7 Tage und die im Voraus gelesenen Tage. Eine verschobene Folge zieht mit; eine von der Watchlist entfernte Serie verschwindet.
Ein neuer Kalender ist privat. Schalten Sie unter Meine Kalender Mit dem Haushalt teilen ein, um ihn in den Szenen des Haushalts zu nutzen (auch mit dem eingebauten Auslöser „Ein Kalenderereignis steht bevor“), oder schalten Sie Diesen Kalender synchronisieren aus, um ihn zu überspringen.
Dashboard-Widgets

- Kommende Serien und Filme: die nächsten 3, 5 oder 8 Einträge mit Tag, Uhrzeit, Abstand, einem Badge (Premiere, Finale, Art) und dem Poster. Tippen Sie auf einen Eintrag für Details und seine Trakt-Seite. Lässt sich auf bestimmte Arten beschränken.
- Laufende Serien: die nächste Folge jeder verfolgten Serie und wie viele Sie gesehen haben.
- Aktuelle Wiedergabe: was das Konto ansieht, die Restzeit, Beginn und voraussichtliches Ende, das Poster; ohne Wiedergabe der zuletzt gesehene Titel.
Die Poster werden einmal heruntergeladen und von der Integration aufbewahrt (Trakt verbietet, sie von seinen Servern zu laden): Sie erscheinen kurz nach der ersten Abfrage.
Szenen
Auslöser (Filter: Arten und der Titel der Serie oder des Films, genau wie Trakt ihn schreibt):
- Trakt: neu im Kalender: Eine Folge oder ein Film ist in den bereits gelesenen Tagen aufgetaucht (verlängerte Serie, neuer Termin, auf trakt.tv zur Watchlist hinzugefügter Titel).
- Trakt: Erscheinungstag: Eine Folge läuft oder ein Film erscheint heute, morgen oder in einer Woche (unter „Wann“ wählen), zur Stunde der Konfiguration.
- Trakt: eine Folge läuft jetzt: Die Sendezeit einer Folge ist gerade verstrichen.
- Trakt: Termin geändert: Tag oder Uhrzeit eines kommenden Eintrags hat sich geändert;
previous_dateenthält den alten Tag. - Trakt: Wiedergabe gestartet und Trakt: Wiedergabe gestoppt: benötigen „Aktuelle Wiedergabe“. „Gestoppt“ sagt, ob das Ende erreicht wurde (
finished) und wie viele Minuten gesehen wurden. Eine Pause zählt ebenfalls als Stopp, das Fortsetzen als Start. - Trakt: Konto erneut verknüpfen: Trakt lehnt die Anmeldung ab (App gelöscht, Zugriff widerrufen): Klicken Sie erneut auf Verbinden.
Die Variablen: full_title („Severance S02E05 – Trojan’s Horse“), title, episode („S02E05“), episode_title, kind (episode, movie, streaming), kind_name, season, number, premiere, finale, date, time, date_text, days, network, url, text (ein fertiger Satz).
Aktionen:
- Trakt: nächste Folge oder Veröffentlichung: der nächste Eintrag Ihres Kalenders (bestimmter Arten oder eines Titels), mit Tag, Uhrzeit, verbleibenden Tagen und einem fertigen Satz
text. - Trakt: zur Watchlist hinzufügen: ein Film oder eine Serie, per Titel („Dune (2021)“), IMDb-Kennung oder trakt.tv-Adresse. Folgen und Starts erscheinen danach im Kalender.
- Trakt: als gesehen markieren: die nächste Folge einer laufenden Serie oder ein Film. Derselbe Titel wird nie zweimal innerhalb einer Stunde markiert.
Beispiele:
- Wenn die Wiedergabe startet → das Wohnzimmerlicht dimmen und die Rollläden schließen; wenn die Wiedergabe stoppt mit
finished= true → das Licht wieder einschalten. - Wenn morgen eine Folge von Severance läuft → um 9 Uhr
{{triggerEvent.data.text}}per Telegram senden. - Wenn etwas Neues im Kalender erscheint →
{{triggerEvent.data.full_title}}, {{triggerEvent.data.date_text}}und den Link{{triggerEvent.data.url}}senden.
Transport
Nur Cloud. Die Integration spricht mit der Trakt-API und lädt die Poster von den Trakt-Servern. Ihre Client-ID und Ihre Trakt-Tokens gehen nur an Trakt. Nichts über Ihr Zuhause verlässt Ihr Netzwerk: Trakt erhält nur, was die Szenenaktionen schreiben (Watchlist, Verlauf).
Fehlerbehebung
- Verbinden meldet, dass Trakt diese Client-ID nicht kennt: Kopieren Sie die Client-ID erneut aus Settings → My Apps (nicht das Client Secret), speichern Sie und klicken Sie auf Verbinden.
- Der Code ist abgelaufen oder wurde abgelehnt: Klicken Sie erneut auf Verbinden und geben Sie den neuen Code innerhalb von 10 Minuten ein.
- „Trakt lehnt die Anmeldung ab: Klicken Sie erneut auf Verbinden“: Der Zugriff wurde auf trakt.tv widerrufen, die App wurde gelöscht (30 Tage ungenutzt) oder Gladys war lange aus. Verbinden Sie sich erneut; gibt es die App nicht mehr, erstellen Sie eine neue und fügen Sie ihre Client-ID ein.
- „Trakt lehnt die Client-ID ab“: Die App wurde gelöscht oder wartet auf eine Freigabe; prüfen Sie sie unter My Apps.
- Der Kalender bleibt leer: Prüfen Sie, dass Sie unter Meine Kalender auf Für mich aktivieren gedrückt haben und dass das Konto Serien verfolgt (gesehen oder auf der Watchlist), die in den nächsten Tagen Folgen haben.
- Die Uhrzeiten weichen um eine Stunde ab: Es sind die Zeiten der Erstausstrahlung der Folge, in der Zeitzone von Gladys (Einstellungen → System). Manche Streamingdienste veröffentlichen in Ihrem Land zu einer anderen Uhrzeit.
- „Aktuelle Wiedergabe“ ändert sich nie: Ihr Player muss an Trakt melden (prüfen Sie, ob die Wiedergabe auf trakt.tv als „watching now“ erscheint); die Option muss eingeschaltet sein.
- „Trakt bittet um Verlangsamung“: Die Anfragen werden zur angezeigten Uhrzeit fortgesetzt; nichts geht verloren.
- Kein Poster: Die Poster werden nach einer Abfrage heruntergeladen; manche Titel haben auf Trakt keines.
Für einen Fehlerbericht geben Sie die Versionen von Gladys und der Integration, Ihre Player und die Zeilen des Protokoll-Tabs der Integration an; im Entwicklermodus fügt DEBUG=gladys-integration-sdk die SDK-Protokolle hinzu.
Konfigurationseinstellungen
Diese Einstellungen fragt Trakt in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| 1. Erstellen Sie Ihre Trakt-App | section | Nein | Trakt verlangt für jede Installation eine eigene, kostenlose API-App. Öffnen Sie auf trakt.tv Settings → My Apps (beim ersten Mal verlangt Trakt ein verifiziertes GitHub-Konto), erstellen Sie eine App (beliebiger Name, Redirect-URI „urn:ietf:wg:oauth:2.0:oob“) und kopieren Sie die Client-ID nach unten. Ein Client Secret wird nicht benötigt. Trakt löscht eine 30 Tage ungenutzte App: Lassen Sie die Integration laufen. |
| Client ID | string | Ja | Die Client-ID Ihrer Trakt-App (64 Zeichen). Sie identifiziert die App; sie ist kein Passwort. |
| 2. Verknüpfen Sie Ihr Trakt-Konto | section | Nein | Zuerst speichern, dann auf Verbinden klicken: Die Aktivierungsseite von Trakt öffnet sich. Melden Sie sich an und geben Sie den Code ein, der im Verbindungsstatus dieser Seite steht. Ein Trakt-Konto speist den Kalender aller Benutzer, die die Integration unter „Meine Kalender“ aktivieren. Entwicklungs-Apps akzeptieren den Besitzer der App und die eingeladenen Personen. |
| Trakt-Konto | account_link | Nein | |
| Kalender | section | Nein | Trakt listet die Folgen der Serien, die das Konto gesehen hat oder auf der Watchlist führt, sowie die Starts der Filme der Watchlist. Die Zeiten sind die der Erstausstrahlung, umgerechnet in die Zeitzone von Gladys. Titel bleiben, wie Trakt sie schreibt. |
| Was verfolgt wird | multi_select | Ja | Kalender, Widgets und Szenen sehen nur diese. |
| Im Voraus gelesene Tage | select | Nein | |
| Specials behalten | boolean | Nein | Folgen der „Staffel 0“: Bonus, Making-of, Rückblicke. |
| Abfrage und Szenen | section | Nein | Eine Abfrage braucht etwa zehn Anfragen; „Aktuelle Wiedergabe“ fügt eine pro Minute hinzu. Trakt erlaubt 500 Anfragen pro 5 Minuten. |
| Aktuelle Wiedergabe | boolean | Nein | Fragt Trakt jede Minute, was das Konto ansieht (gemeldet von Plex, Kodi, Jellyfin, Infuse, den Trakt-Apps…): Auslöser „Wiedergabe gestartet / gestoppt“ und Widget „Aktuelle Wiedergabe“. |
| Abfrage des Kalenders | select | Nein | |
| Uhrzeit des Auslösers „Erscheinungstag“ | number | Nein | Von 0 bis 23, Ortszeit: Die Szenen laufen zu dieser Stunde am Tag selbst (oder am Vortag, eine Woche vorher). |
| Sprache der Szenentexte | select | Nein | Für die fertigen Sätze der Szenen und die Meldungen der Schaltflächen. Automatisch: die Sprache des zuletzt angezeigten Dashboards. |
So installierst du Trakt in Gladys
- Öffne in Gladys Integrationen: Trakt erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/william-de71/gladys-trakt:0.1.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/William-De71/gladys-trakt.
Trakt benötigt Gladys >=5.3.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Trakt ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von William-De71 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation