Skip to content

Kometa Wiki

Discovery

Letterboxd Discovery Builders¶

These builders use Letterboxd slugs instead of treating discovery and filmography pages as letterboxd_list URLs. The slug is the part of the Letterboxd URL that identifies the person, studio, category, or film.

All discovery builders support limit and year. All except letterboxd_similar also support sort_by.

The sync_mode: sync and collection_order: custom settings are recommended when the collection should remain synchronized and preserve Letterboxd's returned order. Custom ordering requires a single discovery builder value per collection.

Crew¶

letterboxd_crew requires a role and person.

Attribute	Values
`role`	`actor`, `director`, `writer`, `casting`, `editor`, `cinematography`, or `composer`
`person`	Letterboxd person slug, such as `marlon-brando`

collections:
  Marlon Brando:
    letterboxd_crew:
      role: actor
      person: marlon-brando

  Francis Ford Coppola:
    letterboxd_crew:
      role: director
      person: francis-ford-coppola

Other Discovery Builders¶

Pass the slug directly in the string form, such as letterboxd_studio: a24. In the object form, use the named slug attribute shown below and add limit, year, or sort_by as needed.

Builder	Slug attribute	Example values
`letterboxd_studio`	`studio`	`/studio/a24/` → `a24`
`letterboxd_country`	`country`	`/films/country/usa/` → `usa`
`letterboxd_language`	`language`	`/films/language/english/` → `english`
`letterboxd_genre`	`genre`	`/films/genre/crime/` → `crime`
`letterboxd_theme`	`theme`	`/films/theme/crime-drugs-and-gangsters/` → `crime-drugs-and-gangsters`
`letterboxd_similar`	`film`	`/film/the-godfather/similar/` → `the-godfather`
`letterboxd_collection`	`collection`	`/films/in/beetlejuice-collection-2/` → `beetlejuice-collection-2`

collections:
  A24:
    letterboxd_studio: a24

  A24 by Release:
    letterboxd_studio:
      studio: a24
      sort_by: release_date_newest

  English Language:
    letterboxd_language:
      language: english
      limit: 10

  Crime:
    letterboxd_genre:
      genre: crime
      limit: 20

  Crime, Drugs and Gangsters:
    letterboxd_theme:
      theme: crime-drugs-and-gangsters
      sort_by: best_match
      limit: 20

  Similar to The Godfather:
    letterboxd_similar: the-godfather

  Beetlejuice Collection:
    letterboxd_collection:
      collection: beetlejuice-collection-2
      sort_by: release_date_earliest

YAML Lists Explained

YAML supports different ways to define lists. Below are some common methods:

1. List Within a Mapping

fruits:
  - apple
  - banana
  - cherry

2. Inline Style

fruits: [ apple, banana, cherry ]

Each style can be used depending on your needs. The block style is typically more readable for longer lists, while the inline style is compact and useful for short lists.

YAML Dictionaries Explained

Dictionaries are used to associate key/value pairs that are unordered. Dictionaries can be nested by increasing the indentation, or new dictionaries can be created at the same level by resolving the previous one.

cache: true
cache_expiration: 60

The "keys" are cache and cache_expiration and the "values" are true and 60 respectively.

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) or to an account's Reviews (i.e. it should have /USERNAME/films/reviews/ in the URL).

This filter only works if the URL is to the List View of the Letterboxd list (i.e. it should have /detail/ in the URL).

When title is not provided and the mapping name was not specified as an ID, the default behaviour is to use the mapping name as title for matching.

When mapping_id is not provided and the mapping name was specified as an ID, the default behaviour is to use the mapping name as mapping_id for matching.

When the server does not have a Plex Pass then the Edition Field is not accessible. In this scenario, Kometa will check the movie's filepath for {edition-...} to determine what the edition is.

Each default has a key that when calling to effect a specific collection/overlay you must replace <<key>> with when calling.

You can use current_year to have Kometa use the current year's value. This can be combined with a -# at the end to subtract that number of years. i.e. current_year-2

Filters using the special episodes/tracks filter with the default percent.

Also filters out missing movies/shows from being added to Radarr/Sonarr. These values also cannot use the count modifiers.

You can use current_year to have Kometa use the current year's value. This can be combined with a -# at the end to subtract that number of years. i.e. current_year-2

Also filters out missing movies/shows from being added to Radarr/Sonarr. These values also cannot use the count modifiers.

Filters using the special episodes/tracks filter with the default percent.

Also filters out missing movies/shows from being added to Radarr/Sonarr. These values also cannot use the count modifiers.

Filters using the special episodes/tracks filter with the default percent.

You can use current_year to have Kometa use the current year's value. This can be combined with a -# at the end to subtract that number of years. i.e. current_year-2

Filters using the special episodes/tracks filter with the default percent.

Also filters out missing movies/shows from being added to Radarr/Sonarr. These values also cannot use the count modifiers.

Filters using the special episodes/tracks filter with the default percent.

Also filters out missing movies/shows from being added to Radarr/Sonarr. These values also cannot use the count modifiers.

The field will be locked if a previous mass_image_update lock operation was run, or if an Overlay has been applied to a poster.

Kometa checks for the Overlay label on the item in Plex to determine if an Overlay is applied.