Plex-Meta-Manager/docs/metadata/builders/letterboxd.md
2022-05-19 12:09:28 -04:00

3.3 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
rating Description: Search for the specified rating range
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
Values: Any String
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