Letterboxd Smart-Home-Integration, kostenlos und Open Source

Dein Letterboxd-Tagebuch in Gladys: letzter Film, Bewertung, Filme des Monats, Auslöser je Film.
Verfolge in Gladys Assistant die Filme, die auf Letterboxd, dem sozialen Netzwerk der Filmfans, gesehen werden: den zuletzt eingetragenen Film jedes verfolgten Profils, seine Bewertung, die Filme des Monats und des Jahres, einen Szenen-Auslöser bei jedem neuen Film und ein Dashboard-Widget mit den neuesten Plakaten.
Nicht mit Letterboxd verbunden. Die Integration liest den öffentlichen RSS-Feed jedes Profils, ohne Konto.
Was du bekommst
- Ein Gerät pro verfolgtem Profil („Letterboxd Jana“), mit fünf Funktionen:
- Zuletzt gesehener Film: „Mouse (2026) · ★★★★“, mit „erneut gesehen“, wenn es eine Wiederholung ist;
- Bewertung des letzten Films: 0,5 bis 5 in halben Sternen, 0, wenn der Film nicht bewertet wurde;
- Filme diesen Monat und Filme dieses Jahr, im Tagebuch gezählt (nach dem vom Mitglied angegebenen Datum, in der Zeitzone von Gladys, Wiederholungen eingeschlossen);
- Durchschnittsbewertung dieses Jahr, der bewerteten Filme des Jahres, 0, wenn es keine gibt.
- Ein Szenen-Auslöser „Letterboxd: neuer Film gesehen“, mit Titel, Jahr, Bewertung und einem fertigen Satz.
- Ein Dashboard-Widget „Letterboxd-Filme“: die neuesten Filme mit Plakat und Sternen, für ein Profil oder alle.
Voraussetzungen
- Gladys Assistant 5.1 oder neuer.
- Internetzugang von Gladys aus (die Integration liest
letterboxd.com). - Ein oder mehrere öffentliche Letterboxd-Profile. Du brauchst weder ein Letterboxd-Konto noch ein Passwort: Die Integration liest nur, was jeder auf dem Profil sehen kann.
Konfiguration
Einstellungen
| Einstellung | Beschreibung |
|---|---|
| Letterboxd-Profile | Benutzernamen oder Profillinks (https://letterboxd.com/jana/), durch Kommas getrennt. Höchstens zehn. |
| Aktualisierungsintervall | 30 Minuten, 1 Stunde (Standard), 2 oder 6 Stunden. Eine Anfrage pro Profil bei jedem Abruf. |
| Sprache der Texte | Namen der Funktionen (bei ihrer Erstellung festgelegt) und Sätze für die Szenen. Standard: Französisch. |
Speichere, öffne dann den Tab Entdecken der Integration und lege die gewünschten Geräte an. Ein Profil, das Letterboxd nicht kennt, wird im Status der Integration gemeldet und bekommt kein Gerät.
Der Benutzername
Der Benutzername ist das Ende der Profiladresse: https://letterboxd.com/jana/ → jana. Es ist nicht der auf dem
Profil angezeigte Name. Groß- und Kleinschreibung spielen keine Rolle.
Geräte
Das Gerät eines Profils wird von der Integration selbst im gewählten Intervall aktualisiert (Gladys fragt es nicht ab). Die Werte bleiben zwischen zwei Abrufen erhalten; ist Letterboxd nicht erreichbar, bleiben die letzten stehen.
Zu den Zählungen. Der RSS-Feed enthält die 50 neuesten Tagebucheinträge eines Profils. Die Filme des Monats und des Jahres werden darauf gezählt: Bei einem Mitglied, das dieses Jahr mehr als 50 Filme eingetragen hat, endet die Jahreszählung bei dem, was der Feed zeigt (das Widget zeigt dann „50+“). Ein Film, der nur als gesehen markiert ist, ohne Tagebucheintrag, steht nicht im Feed und wird nicht gezählt.
Dashboard-Widget
Füge das Widget Letterboxd-Filme zu einem Dashboard hinzu. Einstellungen:
- Profil: ein Profil, mit seinem Namen und den Filmen des Monats und des Jahres oben; leer, alle Profile gemischt, neueste Filme zuerst.
- Plakate anzeigen: standardmäßig an. Die Plakate werden von der Integration bei den Bildservern von Letterboxd geladen (nie von deinem Browser); schalte es aus, um keine zu laden.
Jede Zeile zeigt Plakat, Titel und Jahr, Sterne, Mitglied und Datum. Tippe auf eine Zeile, um Bewertung, Datum, Wiederholung und „Gefällt mir“ zu sehen, mit einem Link zum Eintrag auf Letterboxd.
Szenen-Auslöser
Letterboxd: neuer Film gesehen löst aus, wenn ein verfolgtes Profil einen Film ins Tagebuch eingetragen hat, beim nächsten Abruf (innerhalb des Aktualisierungsintervalls). Filter:
- Profil: ein Gerät, oder leer für alle Profile;
- Ansehen: erstes Ansehen, erneutes Ansehen oder beides (leer).
Variablen für die folgenden Aktionen: member (der Name des Geräts in Gladys, ohne „Letterboxd“), title, year,
rating (0,5 bis 5, 0 = keine Bewertung), liked (1, wenn dem Mitglied der Film gefällt), url (der Eintrag auf
Letterboxd) und summary, ein Satz wie „Jana hat Mouse (2026) gesehen, Bewertung 4/5.“
Der erste Abruf eines Profils löst nichts aus: Die Filme, die schon im Feed stehen, sind keine Neuigkeiten. Die gesehenen Filme werden in den Daten der Integration gespeichert, ein Neustart löst also nichts erneut aus. Höchstens 10 Filme werden pro Abruf gemeldet, der Rest beim nächsten.
Szenen-Beispiele
- Rückblick auf den Filmabend: Auslöser „neuer Film gesehen“ → eine Nachricht mit
summaryan die Familie senden. - Ein Lieblingsfilm: Auslöser „neuer Film gesehen“ → Bedingung auf das Gerät „Bewertung des letzten Films“ gleich
5 → eine Nachricht mit der Variable
titlesenden. - Wohnzimmer: Auslöser „neuer Film gesehen“ für dein eigenes Profil → nach dem Film das Licht wieder einschalten.
Datenquelle, Bedingungen und Kontingente
- Quelle: der öffentliche RSS-Feed
https://letterboxd.com/<benutzer>/rss/jedes Profils. Die API von Letterboxd wird nur auf Anfrage vergeben, und die Integration nutzt sie nicht. - Die Integration gibt sich mit einem ehrlichen User-Agent zu erkennen und sendet eine Anfrage pro Profil bei jedem Abruf (standardmäßig einmal pro Stunde), dazu die Plakat-Vorschaubilder, die das Widget zeigt, im Speicher gehalten.
- Die Watchlist wird nicht gelesen: Für sie gibt es keinen RSS-Feed, und ihre Seite ist für Browser gebaut.
- Filmtitel, Plakate und Daten gehören Letterboxd und ihren Rechteinhabern; die Integration zeigt sie nur auf deinem Dashboard an.
Fehlerbehebung
- „Profil auf Letterboxd nicht gefunden“: Prüfe den Benutzernamen in der Profiladresse, nicht den angezeigten Namen.
- Ein Profil ohne Gerät: Das Profil ist vielleicht privat, deaktiviert oder existiert nicht.
- „Letterboxd ist nicht erreichbar“: Gladys hat keinen Internetzugang, oder Letterboxd ist gestört; die Integration versucht es bei jedem Abruf erneut und meldet die Rückkehr.
- Ein Film fehlt: Nur Tagebucheinträge stehen im Feed. Trage den Film auf Letterboxd ins Tagebuch ein (mit Datum).
- Funktionsnamen in der falschen Sprache: Die Namen werden bei der Erstellung des Geräts festgelegt. Ändere die Sprache, lösche dann das Gerät und lege es neu an.
- Protokolle: Die Seite der Integration in Gladys zeigt ihre Protokolle;
LOG_LEVEL=debugzeigt jeden Abruf im Detail.
Grenzen
- Ohne eigenes Letterboxd-Konto entwickelt, auf öffentlichen Feeds: Rückmeldungen willkommen.
- Zählungen auf Basis der 50 neuesten Tagebucheinträge des Feeds (siehe oben).
- Keine Watchlist, keine Listen, kein Kritiktext: nur das Tagebuch.
- Ein Film wird beim nächsten Abruf gesehen, nicht sofort.
Konfigurationseinstellungen
Diese Einstellungen fragt Letterboxd in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Zu verfolgende Profile | section | Nein | Letterboxd ist das soziale Netzwerk der Filmfans. Gib die Benutzernamen der öffentlichen Profile ein, die du verfolgen willst (deines, die deiner Familie): Jedes wird ein Gerät mit dem zuletzt gesehenen Film und seiner Bewertung. Speichere und lege dann die Geräte im Tab „Entdecken“ an. |
| Quelle und Grenzen | section | Nein | Aus dem öffentlichen RSS-Feed jedes Profils gelesen, ohne Konto. Der Feed enthält die 50 neuesten Tagebucheinträge: Die Filme des Jahres werden darauf gezählt. Die Watchlist hat keinen Feed und wird nicht gelesen. Nicht mit Letterboxd verbunden. |
| Letterboxd-Profile | string | Nein | Benutzernamen oder Profillinks, durch Kommas getrennt. Höchstens zehn. Die Profile müssen öffentlich sein. |
| Aktualisierungsintervall | select | Nein | Eine Anfrage pro Profil bei jedem Abruf. Ein eingetragener Film ist selten dringend: Einmal pro Stunde reicht. |
| Sprache der Texte | select | Nein | Namen der Funktionen (bei ihrer Erstellung) und Texte für die Szenen. Filmtitel bleiben, wie Letterboxd sie liefert. |
So installierst du Letterboxd in Gladys
- Öffne in Gladys Integrationen: Letterboxd erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-letterboxd:1.0.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/guim31/gladys-letterboxd.
Letterboxd benötigt Gladys >=5.1.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
Letterboxd 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 guim31 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