Skip to content

Kometa Wiki

Show

TMDb Discover (Shows)¶

Uses TMDb's Discover Search to find every show based on the show search attributes provided.

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

Important

Note that a number of filters support being comma (,) or pipe (|) separated. Commas are treated like an AND query while pipes are treated like an OR. This allows for quite complex filtering depending on your desired results.

Value Types¶

These are the types of values you can use in your TMDb Discover queries. The type and formatting of attributes such as date and year is important to know when building your queries.

Type	Description
String	Any number of alphanumeric characters
Integer	Any whole number greater than zero i.e. 2, 10, 50
Number	Any number greater than zero i.e. 2.5, 7.4, 9
Boolean	Must be `true` or `false`
Date: `MM/DD/YYYY`	Date that fits the specified format
Year: `YYYY`	Year must be a 4 digit integer i.e. 1990

Discover Attributes¶

Attributes	Description
`limit`	Specify how many movies you want to be returned by the query. Type: Integer Default: 100
`sort_by`	Choose from one of the many available sort options. Type: Any sort option below Default: `popularity.desc`
`air_date.gte`	Filter and only include TV shows that have an air date (by looking at all episodes) that is greater or equal to the specified value. Type: Date: `MM/DD/YYYY`
`air_date.lte`	Filter and only include TV shows that have an air date (by looking at all episodes) that is less than or equal to the specified value. Type: Date: `MM/DD/YYYY`
`first_air_date.gte`	Filter and only include TV shows that have a original air date that is greater or equal to the specified value. Can be used in conjunction with the `include_null_first_air_dates` filter if you want to include items with no air date. Type: Date: `MM/DD/YYYY`
`first_air_date.lte`	Filter and only include TV shows that have a original air date that is less than or equal to the specified value. Can be used in conjunction with the `include_null_first_air_dates` filter if you want to include items with no air date. Type: Date: `MM/DD/YYYY`
`first_air_date_year`	Filter and only include TV shows that have an original air date year that equal to the specified value. Can be used in conjunction with the `include_null_first_air_dates` filter if you want to include items with no air date. Type: Year: `YYYY`
`include_adult`	A filter and include or exclude adult movies. Type: Boolean
`include_null_first_air_dates`	Use this filter to include TV shows that don't have an air date while using any of the `first_air_date` filters. Type: Boolean
`timezone`	Used in conjunction with the `air_date.gte/lte` filter to calculate the proper UTC offset. Type: String Default: `America/New_York`
`vote_count.gte`	Filter and only include TV that have a vote count that is greater or equal to the specified value. Type: Integer
`vote_count.lte`	Filter and only include TV that have a vote count that is less than or equal to the specified value. Type: Integer
`vote_average.gte`	Filter and only include TV that have a rating that is greater or equal to the specified value. Type: Number
`vote_average.lte`	Filter and only include TV that have a rating that is less than or equal to the specified value. Type: Number
`with_networks`	Comma-separated value of network ids that you want to include in the results. Type: String
`with_companies`	A comma-separated list of production company ID's. Only include movies that have one of the ID's added as a production company. Can be a comma (`,`) for an AND, or a pipe (`\|`) for an OR separated query Type: String
`without_companies`	Filter the results to exclude the specific production companies you specify here. AND / OR filters are supported. Type: String
`with_genres`	Comma-separated value of genre ids that you want to include in the results. Can be a comma (`,`) for an AND, or a pipe (`\|`) for an OR separated query Type: String
`without_genres`	Comma-separated value of genre ids that you want to exclude from the results. Type: String
`with_keywords`	A comma-separated list of keyword ID's. Only includes TV shows that have one of the ID's added as a keyword. Can be a comma (`,`) for an AND, or a pipe (`\|`) for an OR separated query Type: String
`without_keywords`	Exclude items with certain keywords. You can comma and pipe separate these values to create an 'AND' or 'OR' logic. Type: String
`with_runtime.gte`	Filter and only include TV shows with an episode runtime that is greater than or equal to a value. Type: Integer
`with_runtime.lte`	Filter and only include TV shows with an episode runtime that is less than or equal to a value. Type: Integer
`with_original_language`	Specify an ISO 639-1 string to filter results by their original language value. Type: String
`with_name_translation`	Specify a language/country string to filter the results by if the item has a type of name translation. Type: String Values: `ar-AE`, `ar-SA`, `bg-BG`, `bn-BD`, `ca-ES`, `ch-GU`, `cs-CZ`, `da-DK`, `de-DE`, `el-GR`, `en-US`, `eo-EO`, `es-ES`, `es-MX`, `eu-ES`, `fa-IR`, `fi-FI`, `fr-CA`, `fr-FR`, `he-IL`, `hi-IN`, `hu-HU`, `id-ID`, `it-IT`, `ja-JP`, `ka-GE`, `kn-IN`, `ko-KR`, `lt-LT`, `ml-IN`, `nb-NO`, `nl-NL`, `no-NO`, `pl-PL`, `pt-BR`, `pt-PT`, `ro-RO`, `ru-RU`, `sk-SK`, `sl-SI`, `sr-RS`, `sv-SE`, `ta-IN`, `te-IN`, `th-TH`, `tr-TR`, `uk-UA`, `vi-VN`, `zh-CN`, `zh-TW`
`screened_theatrically`	Filter results to include items that have been screened theatrically. Type: Boolean
`with_watch_providers`	A comma or pipe separated list of watch provider ID's. use in conjunction with watch_region, can be a comma (`,`) for an AND, or a pipe (`\|`) for an OR separated query Type: String
`without_watch_providers`	Filter the results to exclude certain watch providers. Type: String
`watch_region`	An ISO 3166-1 code. Combine this filter with `with_watch_providers` in order to filter your results by a specific watch provider in a specific region. Type: String
`with_watch_monetization_types`	In combination with `watch_region`, you can filter by monetization type. Can be a comma (`,`) for an AND, or a pipe (`\|`) for an OR separated query Type: String Values: `flatrate`, `free`, `ads`, `rent`, `buy`
`with_status`	Filter TV shows by their status. Type: String Can be a comma (`,`) for an AND, or a pipe (`\|`) for an OR separated query Values: `0`: Returning Series, `1`: Planned, `2`: In Production, `3`: Ended, `4`: Cancelled, `5`: Pilot
`with_type`	Filter TV shows by their type. Can be a comma (`,`) for an AND, or a pipe (`\|`) for an OR separated query Type: String Values: `0`: Documentary, `1`: News, `2`: Miniseries, `3`: Reality, `4`: Scripted, `5`: Show, `6`: Video

Sort Options¶

Sort Option	Movie Sort	Show Sort
`popularity.asc`
`popularity.desc`
`title.asc`
`title.desc`
`original_title.asc`
`original_title.desc`
`name.asc`
`name.desc`
`original_name.asc`
`original_name.desc`
`revenue.asc`
`revenue.desc`
`release_date.asc`
`release_date.desc`
`primary_release_date.asc`
`primary_release_date.desc`
`first_air_date.asc`
`first_air_date.desc`
`vote_average.asc`
`vote_average.desc`
`vote_count.asc`
`vote_count.desc`

Example TMDb Discover Builder(s)¶

collections:
  Shows Released in October 2020:
    tmdb_discover:
      first_air_date.gte: 10/01/2020
      first_air_date.lte: 10/31/2020

collections:
  100 Most Popular Shows:
    collection_order: custom
    sync_mode: sync
    tmdb_discover:
      sort_by: popularity.desc
      limit: 100

collections:
  Highest Rated TV-MA Shows:
    collection_order: custom
    sync_mode: sync
    tmdb_discover:
      certification_country: US
      certification: TV-MA
      sort_by: vote_average.desc

collections:
  Most Popular Kids Shows:
    collection_order: custom
    sync_mode: sync
    tmdb_discover:
      certification_country: US
      certification.lte: TV-G
      sort_by: popularity.desc

collections:
  Highest Rated Science Fiction Movies with Tom Cruise:
    collection_order: custom
    sync_mode: sync
    tmdb_discover:
      with_genres: 878
      with_cast: 500
      sort_by: vote_average.desc

collections:
  Streaming on Disney+ in UK:
    collection_order: custom
    sync_mode: sync
    tmdb_discover:
      with_watch_providers: 337
      region: GB

collections:
  Top Rated Dramas:
    collection_order: custom
    sync_mode: sync
    tmdb_discover:
      with_genres: 18
      sort_by: vote_average.desc
      vote_count.gte: 10

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_poster_update or mass_background_update was run, or if an Overlay has been applied.

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