Skip to main content

Letterboxd smart home integration, free and open source

Letterboxd integration for Gladys Assistant

Your Letterboxd diary in Gladys: last film watched, rating, films of the month, new film trigger.

Follow the films watched on Letterboxd, the social network of film lovers, in Gladys Assistant: the last film each followed profile logged, its rating, the films of the month and of the year, a scene trigger at every new film and a dashboard widget with the latest posters.

Not affiliated with Letterboxd. The integration reads the public RSS feed of each profile, without an account.

What you get​

  • One device per followed profile ("Letterboxd Jane"), with five features:
    • Last film watched: "Mouse (2026) · ★★★★", "rewatch" when it is one;
    • Rating of the last film: 0.5 to 5 by half stars, 0 when the film was not rated;
    • Films watched this month and Films watched this year, counted on the diary (by the watch date the member gave, in the time zone of Gladys, rewatches included);
    • Average rating this year, of the rated films of the year, 0 when none.
  • A scene trigger "Letterboxd: new film watched", with the title, the year, the rating and a ready-made sentence.
  • A dashboard widget "Letterboxd films": the latest films with their poster and stars, for one profile or all.

Requirements​

  • Gladys Assistant 5.1 or later.
  • Internet access from Gladys (the integration reads letterboxd.com).
  • One or more public Letterboxd profiles. You do not need a Letterboxd account, nor to give a password: the integration only reads what anyone can see on the profile.

Configuration​

Settings​

SettingDescription
Letterboxd profilesUsernames or profile links (https://letterboxd.com/jane/), separated by commas. Ten at most.
Refresh interval30 minutes, 1 hour (default), 2 or 6 hours. One request per profile at each reading.
Language of the textsNames of the features (frozen at their creation) and sentences sent to the scenes. French by default.

Save, then open the Discover tab of the integration and create the devices you want. A profile Letterboxd does not know is said in the status of the integration and gets no device.

The username​

The username is the end of the profile address: https://letterboxd.com/jane/ → jane. It is not the display name shown on the profile. Case does not matter.

Devices​

The device of a profile is refreshed by the integration itself at the chosen interval (it is not polled by Gladys). The values are kept between two readings; when Letterboxd cannot be reached, the last ones stay.

About the counts. The RSS feed holds the 50 latest diary entries of a profile. The films of the month and of the year are counted on them: for a member who logged more than 50 films this year, the year count stops at what the feed shows (the widget then says "50+"). A film watched without a diary entry (only marked as watched) is not in the feed and is not counted.

Dashboard widget​

Add the Letterboxd films widget to a dashboard. Settings:

  • Profile: one profile, with its name and the films of the month and of the year at the top; empty, every profile mixed, newest films first.
  • Show the posters: on by default. The posters are loaded from Letterboxd's image servers by the integration (never by your browser); turn it off to load none.

Each row shows the poster, the title and year, the stars, the member and the watch date. Tap a row to see the rating, the date, rewatch and like, and a link to the entry on Letterboxd.

Scene trigger​

Letterboxd: new film watched fires when a followed profile logged a film in its diary, at the next reading (within the refresh interval). Filters:

  • Profile: one device, or empty for every profile;
  • Viewing: first watch, rewatch, or both (empty).

Variables for the next actions: member (the name of the device in Gladys, without "Letterboxd"), title, year, rating (0.5 to 5, 0 = not rated), liked (1 if the member liked the film), url (the entry on Letterboxd) and summary, a sentence such as "Jane watched Mouse (2026), rated 4/5."

The first reading of a profile fires nothing: the films already in its feed are not news. The films seen are kept in the integration's data, so a restart fires nothing again. At most 10 films are announced per reading, the rest at the next one.

Scene examples​

  • Movie night recap: trigger "new film watched" → send a message with summary to the family.
  • A favourite: trigger "new film watched" → condition on the device "Rating of the last film" equal to 5 → send a message with the title variable.
  • Living room: trigger "new film watched" for your own profile → turn the lights back on after the film.

Data source, terms and quotas​

  • Source: the public RSS feed https://letterboxd.com/<username>/rss/ of each profile. Letterboxd's API is only granted on request, and the integration does not use it.
  • The integration identifies itself with an honest User-Agent and sends one request per profile at each reading (once an hour by default), plus the poster thumbnails the widget shows, kept in memory.
  • The watchlist is not read: it has no RSS feed, and its page is built for browsers.
  • Film titles, posters and data belong to Letterboxd and their owners; the integration only shows them on your dashboard.

Troubleshooting​

  • "Profile not found on Letterboxd": check the username in the profile address, not the display name.
  • A profile without device: the profile may be private or deactivated, or not exist.
  • "Letterboxd cannot be reached": Gladys has no internet access, or Letterboxd is down; the integration tries again at every reading and says when it answers again.
  • A film is missing: only diary entries are in the feed. Log the film in the diary (with a date) on Letterboxd.
  • Feature names in the wrong language: they are frozen at the creation of the device. Change the language, then delete and create the device again.
  • Logs: the integration's page in Gladys shows its logs; LOG_LEVEL=debug details every reading.

Limits​

  • Developed without a Letterboxd account of its own, on public feeds: feedback welcome.
  • Counts based on the 50 latest diary entries of the feed (see above).
  • No watchlist, no lists, no reviews text: the diary only.
  • A film is seen at the next reading, not instantly.

Configuration settings​

These are the settings Letterboxd asks for in its configuration screen in Gladys.

SettingTypeRequiredDescription
Profiles to followsectionNoLetterboxd is the social network of film lovers. Type the usernames of the public profiles to follow (yours, your family's): each becomes a device with the last film watched and its rating. Save, then create the devices in the Discover tab.
Source and limitssectionNoRead from the public RSS feed of each profile, without an account. The feed holds the 50 latest diary entries: the films of the year are counted on them. The watchlist has no feed and is not read. Not affiliated with Letterboxd.
Letterboxd profilesstringNoUsernames or profile links, separated by commas. Ten at most. The profiles must be public.
Refresh intervalselectNoOne request per profile at each reading. A film logged is seldom urgent: once an hour is enough.
Language of the textsselectNoNames of the features (at their creation) and texts sent to the scenes. Film titles stay as Letterboxd gives them.

How to install Letterboxd in Gladys​

  1. In Gladys, open Integrations: Letterboxd appears in the catalog, next to the native integrations, with a community badge.
  2. Click Install. Gladys pulls the Docker image (ghcr.io/guim31/gladys-letterboxd:1.0.0), starts it in a sandbox isolated from the core, and generates the integration's interface (devices, discovery and configuration).
  3. Open the Configuration screen of the integration, fill in the settings, and save.
  4. You can also install it directly from its repository URL: https://github.com/guim31/gladys-letterboxd.

Letterboxd requires Gladys >=5.1.0. The catalog inside Gladys refreshes every hour, so a new version becomes available at most one hour after its release.

Not running Gladys yet? It is free and open source: follow the installation guide to get started.

About external integrations​

Letterboxd is an external integration: a community integration packaged as a Docker container and published on GitHub, that Gladys installs in one click and runs in a sandbox isolated from its core. It is published and maintained by guim31, not by the Gladys core team.

Subscribe to the Gladys Assistant newsletter

A few emails per month about new releases and project news. Sent by Pierre-Gilles Leymarie, founder of the project. Unsubscribe anytime 🙂