Zum Hauptinhalt springen

Letterboxd Smart-Home-Integration, kostenlos und Open Source

Letterboxd-Integration für Gladys Assistant

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​

EinstellungBeschreibung
Letterboxd-ProfileBenutzernamen oder Profillinks (https://letterboxd.com/jana/), durch Kommas getrennt. Höchstens zehn.
Aktualisierungsintervall30 Minuten, 1 Stunde (Standard), 2 oder 6 Stunden. Eine Anfrage pro Profil bei jedem Abruf.
Sprache der TexteNamen 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 summary an 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 title senden.
  • 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=debug zeigt 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.

EinstellungTypPflichtfeldBeschreibung
Zu verfolgende ProfilesectionNeinLetterboxd 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 GrenzensectionNeinAus 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-ProfilestringNeinBenutzernamen oder Profillinks, durch Kommas getrennt. Höchstens zehn. Die Profile müssen öffentlich sein.
AktualisierungsintervallselectNeinEine Anfrage pro Profil bei jedem Abruf. Ein eingetragener Film ist selten dringend: Einmal pro Stunde reicht.
Sprache der TexteselectNeinNamen der Funktionen (bei ihrer Erstellung) und Texte für die Szenen. Filmtitel bleiben, wie Letterboxd sie liefert.

So installierst du Letterboxd in Gladys​

  1. Öffne in Gladys Integrationen: Letterboxd erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. 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).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. 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.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂