Skip to main content

Letterboxd

Create and sync Plex collections from any public Letterboxd list. No API key required - homescreen-hero scrapes the list page directly, so all you need is the URL.

Setup​

No API key or credentials needed. Just enable the integration in the Setup Wizard, on the Lists page, or directly in config.yaml:

letterboxd:
  enabled: true

Adding a List​

  1. Go to the Integrations page in the dashboard
  2. Click Add Source under Letterboxd
  3. Enter a name for the collection (this becomes the Plex collection name)
  4. Paste the Letterboxd list URL (e.g., https://letterboxd.com/username/list/list-name/)
  5. Select which Plex library to sync to
  6. Click Save, then hit Sync to pull in the list
tip

Short URLs (e.g., boxd.it/abc123) work too - homescreen-hero will follow the redirect automatically.

How Syncing Works​

Since Letterboxd doesn't have a public API, homescreen-hero scrapes the list page directly:

  1. Scrapes the Letterboxd list page by page, with a 1-second delay between requests to be respectful
  2. Extracts movie titles and years from the page
  3. Matches each movie to your Plex library by title + year search
  4. Creates or updates the Plex collection with all matched items
  5. Removes stale items - if something is removed from the Letterboxd list, it gets removed from the collection on the next sync
  6. Tracks missing items - any movies on the list that aren't in your Plex library are logged and viewable from the dashboard
note

Because Letterboxd matching is title + year based (no TMDb/IMDb IDs available from scraping), match accuracy may be slightly lower than Trakt or MDBList for titles with ambiguous names.

Sync on Rotation​

Letterboxd sources can be synced automatically every time a rotation runs, controlled by the same sync_all_on_rotation setting as the other integrations:

rotation:
  sync_all_on_rotation: true  # Sync all sources before each rotation

When disabled, only sources whose collection names match the selected rotation collections will be synced.

Missing Items​

After a sync, you can view which movies from the Letterboxd list weren't found in your Plex library. Each missing item includes the title, year, and a link back to the Letterboxd page.

If you have Seerr configured, you can enable auto-request on a per-source basis to automatically request missing items after each sync.