Letterboxd smart home integration, free and open source

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
| Setting | Description |
|---|---|
| Letterboxd profiles | Usernames or profile links (https://letterboxd.com/jane/), separated by commas. Ten at most. |
| Refresh interval | 30 minutes, 1 hour (default), 2 or 6 hours. One request per profile at each reading. |
| Language of the texts | Names 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
summaryto 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
titlevariable. - 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=debugdetails 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.
| Setting | Type | Required | Description |
|---|---|---|---|
| Profiles to follow | section | No | Letterboxd 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 limits | section | No | Read 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 profiles | string | No | Usernames or profile links, separated by commas. Ten at most. The profiles must be public. |
| Refresh interval | select | No | One request per profile at each reading. A film logged is seldom urgent: once an hour is enough. |
| Language of the texts | select | No | Names 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
- In Gladys, open Integrations: Letterboxd appears in the catalog, next to the native integrations, with a community badge.
- 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). - Open the Configuration screen of the integration, fill in the settings, and save.
- 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.
- Browse all integrations, native and community
- Build and publish your own external integration
- Source code on GitHub — source of this documentation