Letterboxd Builders¶

You can find items using the lists on Letterboxd.com (Letterboxd).

No configuration is required for these builders.

Attribute	Description	Works with Movies	Works with Shows	Works with Playlists and Custom Sort
`letterboxd_list`	Finds every movie in the Letterboxd List	✅	❌	✅
`letterboxd_list_details`	Finds every movie in the Letterboxd List and updates the collection with the description of the Letterboxd list	✅	❌	✅

Letterboxd List¶

Finds every movie in the Letterboxd List or Letterboxd Films Search.

The expected input is a Letterboxd List URL or Letterboxd Film Search URL. Multiple values are supported as either a list or a comma-separated string.

The sync_mode: sync and collection_order: custom Details are recommended since the lists are continuously updated and in a specific order.

Using the limit filter attribute is recommended when using a Letterboxd Film Search as the number of results returned could be very large.

collections:
  Vulture’s 101 Best Movie Endings:
    letterboxd_list: https://letterboxd.com/brianformo/list/vultures-101-best-movie-endings/
    collection_order: custom
    sync_mode: sync

You can update the collection details with the Letterboxd List’s description by using letterboxd_list_details.
You can specify multiple collections in letterboxd_list_details but it will only use the first one to update the collection summary.

collections:
  Vulture’s 101 Best Movie Endings:
    letterboxd_list_details: https://letterboxd.com/brianformo/list/vultures-101-best-movie-endings/
    collection_order: custom
    sync_mode: sync

You can add different filters directly to this builder.

Filter Attribute	Description
`limit`	Description: Max number of items per returned. Values: number greater than `1`
`rating`¹	Description: Search for the specified rating range. The rating is the list owner’s rating not sitewide rating. Values: range of int i.e. `80-100`
`year`¹	Description: Search for the specified year range. Values: range of int i.e. `1990-1999`
`note`¹	Description: Search for the specified value in the note. The note is the list owner’s note not sitewide note. Values: Any String

¹ These filters only work if the URL is to the List View of the Letterboxd list. (i.e. it should have /detail/ in the url)

collections:
  Vulture’s 101 Best Movie Endings From the 90s:
    letterboxd_list_details: 
      url: https://letterboxd.com/brianformo/list/vultures-101-best-movie-endings/
      year: 1990-1999
    collection_order: custom
    sync_mode: sync