71 KiB

Raw Blame History

TMDb Builders

You can find items using the features of TheMovieDb.org (TMDb).

Standard TMDb Builders

Attribute	Description	Works with Movies	Works with Shows	Works with Playlists and Custom Sort
`tmdb_collection`	Finds every item in the TMDb collection	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-xmark:{ .red }	:fontawesome-solid-circle-xmark:{ .red }
`tmdb_list`	Finds every item in the TMDb List	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-check:{ .green }
`tmdb_actor`	Finds every item in the TMDb Person's Actor Credits	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-xmark:{ .red }
`tmdb_crew`	Finds every item in the TMDb Person's Crew Credits	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-xmark:{ .red }
`tmdb_director`	Finds every item in the TMDb Person's Director Credits	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-xmark:{ .red }
`tmdb_producer`	Finds every item in the TMDb Person's Producer Credits	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-xmark:{ .red }
`tmdb_writer`	Finds every item in the TMDb Person's Writer Credits	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-xmark:{ .red }
`tmdb_movie`	Finds the movie specified	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-xmark:{ .red }	:fontawesome-solid-circle-xmark:{ .red }
`tmdb_show`	Finds the show specified	:fontawesome-solid-circle-xmark:{ .red }	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-xmark:{ .red }
`tmdb_company`	Finds every item from the TMDb company's movie/show list	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-xmark:{ .red }
`tmdb_network`	Finds every item from the TMDb network's show list	:fontawesome-solid-circle-xmark:{ .red }	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-xmark:{ .red }
`tmdb_keyword`	Finds every item from the TMDb keyword's movie/show list	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-xmark:{ .red }

Standard TMDb Details Builders

Attribute	Description	Works with Movies	Works with Shows	Works with Playlists and Custom Sort
`tmdb_collection_details`	Finds every item in the TMDb collection and updates the collection with the summary, poster, and background from the TMDb collection	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-xmark:{ .red }	:fontawesome-solid-circle-xmark:{ .red }
`tmdb_list_details`	Finds every item in the TMDb List and updates the collection with the description and poster of the TMDb list	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-xmark:{ .red }
`tmdb_actor_details`	Finds every item in the TMDb Person's Actor Credits with the biography and profile from the TMDb person	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-xmark:{ .red }
`tmdb_crew_details`	Finds every item in the TMDb Person's Crew Credits with the biography and profile from the TMDb person	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-xmark:{ .red }
`tmdb_director_details`	Finds every item in the TMDb Person's Actor Credits with the biography and profile from the TMDb person	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-xmark:{ .red }
`tmdb_producer_details`	Finds every item in the TMDb Person's Producer Credits with the biography and profile from the TMDb person	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-xmark:{ .red }
`tmdb_writer_details`	Finds every item in the TMDb Person's Writer Credits with the biography and profile from the TMDb person	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-xmark:{ .red }
`tmdb_movie_details`	Finds the movie specified and updates the collection with the summary, poster, and background from the TMDb movie	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-xmark:{ .red }	:fontawesome-solid-circle-xmark:{ .red }
`tmdb_show_details`	Finds the show specified and updates the collection with the summary, poster, and background from the TMDb show	:fontawesome-solid-circle-xmark:{ .red }	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-xmark:{ .red }

Other TMDb Builders

Attribute	Description	Works with Movies	Works with Shows	Works with Playlists and Custom Sort
`tmdb_popular`	Finds the movies/shows in TMDb's Popular Movies/Popular Shows list	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-check:{ .green }
`tmdb_now_playing`	Finds the movies in TMDb's Now Playing list	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-xmark:{ .red }	:fontawesome-solid-circle-check:{ .green }
`tmdb_top_rated`	Finds the movies/shows in TMDb's Top Rated Movies/Top Rated Shows list	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-check:{ .green }
`tmdb_upcoming`	Finds the movies in TMDb's Upcoming Movies list	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-xmark:{ .red }	:fontawesome-solid-circle-check:{ .green }
`tmdb_airing_today`	Finds the shows in TMDb's Airing Today Shows list	:fontawesome-solid-circle-xmark:{ .red }	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-check:{ .green }
`tmdb_on_the_air`	Finds the shows in TMDb's On TV Shows list	:fontawesome-solid-circle-xmark:{ .red }	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-check:{ .green }
`tmdb_trending_daily`	Finds the movies/shows in TMDb's Trending Daily list	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-check:{ .green }
`tmdb_trending_weekly`	Finds the movies/shows in TMDb's Trending Weekly list	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-check:{ .green }
`tmdb_discover`	Uses TMDb's Discover Search to find every movie/show based on the movie search parameters or show search parameters provided	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-check:{ .green }

Expected Input

The builders below are 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.

TMDb Collection and TMDb Collection Details
TMDb List and TMDb List Details
TMDb Actor and TMDb Actor Details
TMDb Crew and TMDb Crew Details
TMDb Director and TMDb Director Details
TMDb Producer and TMDb Producer Details
TMDb Writer and TMDb Writer Details
TMDb Movie and TMDb Movie Details
TMDb Show and TMDb Show Details
TMDb Company
TMDb Network

The builders below are expected to have a single integer value of how many movies/shows to query.

TMDb Popular
TMDb Now Playing
TMDb Top Rated
TMDb Trending Daily
TMDb Trending Weekly

TMDb Discover's attributes are detailed below.

TMDb Collection

Finds every item in the TMDb collection.

collections:
  The Lord of the Rings:
    tmdb_collection: https://www.themoviedb.org/collection/119
  The Hobbit:
    tmdb_collection: 121938
  Middle Earth:
    tmdb_collection:
      - 119
      - https://www.themoviedb.org/collection/121938

You can update the collection details with the TMDb collection's summary, poster, and background by using tmdb_collection_details.
You can specify multiple collections in tmdb_collection_details but it will only use the first one to update the collection details.
Posters and background in the library's asset directory will be used over the collection details unless tmdb_poster/tmdb_background is also specified.

collections:
  Harry Potter:
    tmdb_collection_details: 1241   #https://www.themoviedb.org/collection/1241 also accepted
  Fantastic Beasts:
    tmdb_collection_details: 435259 #https://www.themoviedb.org/collection/435259 also accepted
  Wizarding World:
    tmdb_collection_details:
      - 1241
      - https://www.themoviedb.org/collection/435259

TMDb List

Finds every item in the TMDb List.

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

collections:
  Top 50 Grossing Films of All Time (Worldwide):
    tmdb_list: 10     #https://www.themoviedb.org/list/10 also accepted
    collection_order: custom
    sync_mode: sync

You can update the collection details with the TMDb list's description and poster by using tmdb_list_details.
You can specify multiple lists in tmdb_list_details but it will only use the first one to update the collection details.

collections:
  Rotten Tomatoes Top 100 Movies of All Time:
    tmdb_list_details: 3697   #themoviedb.org/list/3697 also accepted

TMDb Actor

Finds every item in the TMDb Person's Actor Credits.

collections:
  Robin Williams:
    tmdb_actor: 2157  #https://www.themoviedb.org/person/2157-robin-williams also accepted

You can update the collection details with the TMDb Person's biography and profile by using tmdb_actor_details.
You can specify multiple people in tmdb_actor_details but it will only use the first one to update the collection details.

collections:
  Meryl Streep:
    tmdb_actor_details: 5064

TMDb Crew

Finds every item in the TMDb Person's Crew Credits.

collections:
  Quentin Tarantino:
    tmdb_crew: 138  #https://www.themoviedb.org/person/138-quentin-tarantino also accepted

You can update the collection details with the TMDb Person's biography and profile by using tmdb_crew_details.
You can specify multiple people in tmdb_crew_details but it will only use the first one to update the collection details.

collections:
  James Cameron:
    tmdb_crew_details: 2710

TMDb Director

Finds every item in the TMDb Person's Director Credits.

collections:
  Steven Spielberg:
    tmdb_director: 488  #https://www.themoviedb.org/person/488-steven-spielberg also accepted

You can update the collection details with the TMDb Person's biography and profile by using tmdb_director_details.
You can specify multiple people in tmdb_director_details but it will only use the first one to update the collection details.

collections:
  Sofia Coppola:
    tmdb_director_details: 1769

TMDb Producer

Finds every item in the TMDb Person's Producer Credits.

collections:
  Adam Sandler:
    tmdb_producer: 19292  #https://www.themoviedb.org/person/19292-adam-sandler also accepted

You can update the collection details with the TMDb Person's biography and profile by using tmdb_producer_details.
You can specify multiple people in tmdb_producer_details but it will only use the first one to update the collection details.

collections:
  Kathleen Kennedy:
    tmdb_producer_details: 489

TMDb Writer

Finds every item in the TMDb Person's Writer Credits.

collections:
  Woody Allen:
    tmdb_writer: 1243 #https://www.themoviedb.org/person/1243-woody-allen also accepted

You can update the collection details with the TMDb Person's biography and profile by using tmdb_writer_details.
You can specify multiple people in tmdb_writer_details but it will only use the first one to update the collection details.

collections:
  Tina Fey:
    tmdb_writer_details: 56323

TMDb Movie

Finds the movie specified.

collections:
  Anaconda:
    tmdb_collection: 105995 #https://www.themoviedb.org/collection/105995 also accepted
    tmdb_movie: 336560      #https://www.themoviedb.org/movie/336560 also accepted

You can update the collection details with the TMDb movie's summary, poster, and background by using tmdb_movie_details.
You can specify multiple movies in tmdb_movie_details but it will only use the first one to update the collection details.
Posters and background in the library's asset directory will be used over the collection details unless tmdb_poster/tmdb_background is also specified.

collections:
  Deadpool Specials:
    tmdb_collection: 567604
    tmdb_movie_details: 558144

TMDb Show

Finds the show specified.

collections:
  Star Wars (Animated Shows):
    tmdb_show:
      - 4194  #https://www.themoviedb.org/tv/4194-star-wars-the-clone-wars also accepted
      - 60554 #https://www.themoviedb.org/tv/60554-star-wars-rebels also accepted

You can update the collection details with the TMDb show's summary, poster, and background by using tmdb_show_details.
You can specify multiple shows in tmdb_show_details but it will only use the first one to update the collection details.
Posters and background in the library's asset directory will be used over the collection details unless tmdb_poster/tmdb_background is also specified.

collections:
  Pokémon Evolutions & Chronicles:
    tmdb_show_details:
      - 132636
      - 13230

TMDb Company

Finds every movie from the TMDb company's movie list.

collections:
  Studio Ghibli:
    tmdb_company: 10342 #https://www.themoviedb.org/company/10342 also accepted

TMDb Network

Finds every item from the TMDb network's movie/show list.

collections:
  CBS:
    tmdb_network: 16  #https://www.themoviedb.org/network/16 also accepted

TMDb Keyword

Finds every item from the TMDb keyword's movie/show list.

collections:
  Marvel Cinematic Universe:
    tmdb_keyword: 180547  #https://www.themoviedb.org/keyword/180547 also accepted

TMDb Popular

Finds the movies/shows in TMDb's Popular Movies/Popular Shows list.

Use tmdb_region with this builder to set the region.

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

collections:
  TMDb Popular:
    tmdb_popular: 30
    collection_order: custom
    sync_mode: sync

TMDb Now Playing

Finds the movies in TMDb's Now Playing list.

Use tmdb_region with this builder to set the region.

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

collections:
  TMDb Now Playing:
    tmdb_now_playing: 30
    collection_order: custom
    sync_mode: sync

TMDb Top Rated

Finds the movies/shows in TMDb's Top Rated Movies/Top Rated Shows list.

Use tmdb_region with this builder to set the region.

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

collections:
  TMDb Top Rated:
    tmdb_top_rated: 30
    collection_order: custom
    sync_mode: sync

TMDb Upcoming

Finds the movies in TMDb's Upcoming Movies list.

Use tmdb_region with this builder to set the region.

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

collections:
  TMDb Upcoming:
    tmdb_upcoming: 30
    collection_order: custom
    sync_mode: sync

TMDb Airing Today

Finds the shows in TMDb's Airing Today Shows list.

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

collections:
  TMDb Airing Today:
    tmdb_airing_today: 30
    collection_order: custom
    sync_mode: sync

TMDb On the Air

Finds the shows in TMDb's On TV Shows list.

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

collections:
  TMDb On the Air:
    tmdb_on_the_air: 30
    collection_order: custom
    sync_mode: sync

Finds the movies/shows in TMDb's Trending Daily list.

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

collections:
  TMDb Daily Trending:
    tmdb_trending_daily: 30
    collection_order: custom
    sync_mode: sync

Finds the movies/shows in TMDb's Trending Weekly list.

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

collections:
  TMDb Weekly Trending:
    tmdb_trending_weekly: 30
    collection_order: custom
    sync_mode: sync

TMDb Discover

Uses TMDb's Discover Search to find every movie/show based on the movie search parameters or show search parameters provided.

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

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 Movies Parameters

!!!important

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

!!!bug

We have noticed inconsistent responses from TMDb when using `popularity.asc` and `popularity.desc` as the sort order. This can result in movies/shows disappearing from and reapparing in collections/overlays sporadically. **We suggest users do not use the popularity sort options with `tmdb_discover`**.

This bug is on TMDb's side and we are awaiting a fix from them.

Movie Parameters	Description
`limit`	Specify how many movies you want returned by the query. Type: Integer Default: 100
`region`	Specify a ISO 3166-1 code to filter release dates. Must be uppercase. Will use the `region` specified in the TMDb Config by default. Type: `^[A-Z]{2}$`
`sort_by`	Choose from one of the many available sort options. Type: Any sort options below Default: `popularity.desc`
`certification_country`	Used in conjunction with the certification parameter, use this to specify a country with a valid certification. Type: String
`certification`	Filter results with a valid certification from the `certification_country` parameter. Type: String
`certification.lte`	Filter and only include movies that have a certification that is less than or equal to the specified value. Type: String
`certification.gte`	Filter and only include movies that have a certification that is greater than or equal to the specified value. Type: String
`include_adult`	A filter and include or exclude adult movies. Type: Boolean
`include_video`	A filter and include or exclude videos. Type: Boolean
`primary_release_year`	A filter to limit the results to a specific primary release year. Type: Year: YYYY
`primary_release_date.gte`	Filter and only include movies that have a primary release date that is greater or equal to the specified value. Type: Date: `MM/DD/YYYY`
`primary_release_date.lte`	Filter and only include movies that have a primary release date that is less than or equal to the specified value. Type: Date: `MM/DD/YYYY`
`release_date.gte`	Filter and only include movies that have a release date (looking at all release dates) that is greater or equal to the specified value. Type: Date: `MM/DD/YYYY`
`release_date.lte`	Filter and only include movies that have a release date (looking at all release dates) that is less than or equal to the specified value. Type: Date: `MM/DD/YYYY`
`with_release_type`	Specify a comma (AND) or pipe (OR) separated value to filter release types by. Type: String Values: `1`: Premiere, `2`: Theatrical (limited), `3`: Theatrical, `4`: Digital, `5`: Physical, `6`: TV
`year`	A filter to limit the results to a specific year (looking at all release dates). Type: Year: `YYYY`
`vote_count.gte`	Filter and only include movies that have a vote count that is greater or equal to the specified value. Type: Integer
`vote_count.lte`	Filter and only include movies that have a vote count that is less than or equal to the specified value. Type: Integer
`vote_average.gte`	Filter and only include movies that have a rating that is greater or equal to the specified value. Type: Number
`vote_average.lte`	Filter and only include movies that have a rating that is less than or equal to the specified value. Type: Number
`with_cast`	A comma-separated list of person ID's. Only include movies that have one of the ID's added as an actor. Can be a comma (`,`) for an AND, or a pipe (`
`with_crew`	A comma-separated list of person ID's. Only include movies that have one of the ID's added as a crew member. Can be a comma (`,`) for an AND, or a pipe (`
`with_people`	A comma-separated list of person ID's. Only include movies that have one of the ID's added as either an actor or a crew member. Can be a comma (`,`) for an AND, or a pipe (`
`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 (`
`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 (`
`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 movies that have one of the ID's added as a keyword. Can be a comma (`,`) for an AND, or a pipe (`
`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 movies that have a runtime that is greater or equal to a value. Type: Integer
`with_runtime.lte`	Filter and only include movies that have a 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_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 (`
`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 Values: ISO 3166-1 code
`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 (`

Discover Shows Parameters

!!!important

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

!!!bug

We have noticed inconsistent responses from TMDb when using `popularity.asc` and `popularity.desc` as the sort order. This can result in movies/shows disappearing from and reapparing in collections/overlays sporadically. **We suggest users do not use the popularity sort options with `tmdb_discover`**.

This bug is on TMDb's side and we are awaiting a fix from them.

Show Parameters	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 options 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_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 (`
`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 (`
`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 (`
`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 (`
`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 (`
`with_status`	Filter TV shows by their status. Type: String Can be a comma (`,`) for an AND, or a pipe (`
`with_type`	Filter TV shows by their type. Can be a comma (`,`) for an AND, or a pipe (`

Sort Options

!!!bug

We have noticed inconsistent responses from TMDb when using `popularity.asc` and `popularity.desc` as the sort order. This can result in movies/shows disappearing from and reapparing in collections/overlays sporadically. 

**Due to the nature of this bug, we suggest you do not use the popularity sort options with `tmdb_discover` unless you also set a `limit` of 20 or less**. If you do not set a limit, the data that TMDb returns may be inconsistent.**

This bug is on TMDb's side that we have made them aware of and are currently awaiting a fix.

Sort Option	Movie Sort	Show Sort
`popularity.asc`	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-check:{ .green }
`popularity.desc`	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-check:{ .green }
`original_title.asc`	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-xmark:{ .red }
`original_title.desc`	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-xmark:{ .red }
`revenue.asc`	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-xmark:{ .red }
`revenue.desc`	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-xmark:{ .red }
`release_date.asc`	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-xmark:{ .red }
`release_date.desc`	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-xmark:{ .red }
`primary_release_date.asc`	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-xmark:{ .red }
`primary_release_date.desc`	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-xmark:{ .red }
`first_air_date.asc`	:fontawesome-solid-circle-xmark:{ .red }	:fontawesome-solid-circle-check:{ .green }
`first_air_date.desc`	:fontawesome-solid-circle-xmark:{ .red }	:fontawesome-solid-circle-check:{ .green }
`vote_average.asc`	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-check:{ .green }
`vote_average.desc`	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-check:{ .green }
`vote_count.asc`	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-xmark:{ .red }
`vote_count.desc`	:fontawesome-solid-circle-check:{ .green }	:fontawesome-solid-circle-xmark:{ .red }

collections:
  Movies Released in October 2020:
    tmdb_discover:
      primary_release_date.gte: 10/01/2020
      primary_release_date.lte: 10/31/2020

collections:
  Popular Movies:
    collection_order: custom
    sync_mode: sync
    tmdb_discover:
      sort_by: popularity.desc

collections:
  Highest Rated R Movies:
    collection_order: custom
    sync_mode: sync
    tmdb_discover:
      certification_country: US
      certification: R
      sort_by: vote_average.desc

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

collections:
  Highest Rated Movies From 2010:
    collection_order: custom
    sync_mode: sync
    tmdb_discover:
      primary_release_year: 2010
      sort_by: vote_average.desc

collections:
  Best Dramas From 2014:
    collection_order: custom
    sync_mode: sync
    tmdb_discover:
      with_genres: 18
      primary_release_year: 2014
      sort_by: vote_average.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:
  Highest Grossing Comedy Movies with Will Ferrell:
    collection_order: custom
    sync_mode: sync
    tmdb_discover:
      with_genres: 35
      with_cast: 23659
      sort_by: revenue.desc

collections:
  Top Rated Movies with Brad Pitt and Edward Norton:
    collection_order: custom
    sync_mode: sync
    tmdb_discover:
      with_people: 287,819
      sort_by: vote_average.desc

collections:
  Popular Movies with David Fincher and Rooney Mara:
    collection_order: custom
    sync_mode: sync
    tmdb_discover:
      with_people: 108916,7467
      sort_by: popularity.desc

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

collections:
  Highest Grossing R Movies with Liam Neeson:
    collection_order: custom
    sync_mode: sync
    tmdb_discover:
      certification_country: US
      certification: R
      sort_by: revenue.desc
      with_cast: 3896

71 KiB Raw Blame History

TMDb Builders

Standard TMDb Builders

Standard TMDb Details Builders

Other TMDb Builders

Expected Input

TMDb Collection

TMDb List

TMDb Actor

TMDb Crew

TMDb Director

TMDb Producer

TMDb Writer

TMDb Movie

TMDb Show

TMDb Company

TMDb Network

TMDb Keyword

TMDb Popular

TMDb Now Playing

TMDb Top Rated

TMDb Upcoming

TMDb Airing Today

TMDb On the Air

TMDb Trending Daily

TMDb Trending Weekly

TMDb Discover

Discover Movies Parameters

Discover Shows Parameters

Sort Options

71 KiB

Raw Blame History