TMDb Movie¶

Finds the movie specified.

This Builder is expected to have the full URL to the item or the TMDb ID of the item. Multiple values are supported as either a list or a comma-separated string.

Example TMDb Movie Builder(s)¶

Press the + icon to learn more

collections:
  Anaconda:
    tmdb_movie: #(1)!
      - 336560
  Wizard of Oz & Wicked:
    tmdb_movie_details: #(2)!
      - 630 #(3)!
      - 402431

You can replace tmdb_movie with tmdb_movie_details if you would like to fetch and use the TMDb show's summary, poster, and background from the list
You can specify multiple shows in tmdb_movie_details but it will only use the first one to update the collection details
https://www.themoviedb.org/movie/630-the-wizard-of-oz also accepted
Posters and background in the library's asset directory will be used over the collection details unless tmdb_poster/tmdb_background is also specified.

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