Plex-Meta-Manager/docs/builders/letterboxd.md
2023-11-06 15:38:00 -05:00

3.8 KiB
Raw Blame History

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:
  Vultures 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:
  Vultures 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
rating1 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
year1 Description: Search for the specified year range.
Values: range of int i.e. 1990-1999
note1 Description: Search for the specified value in the note. The note is the list owner's note not sitewide note.
Values: Any String

1 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:
  Vultures 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