Trakt-Builders.md

You can find items using the features of Trakt.tv (Trakt).

Configuring Trakt in the config is required for any of these builders.

Name	Attribute	Description	Works with Movies	Works with Shows	Works with Playlists and Custom Sort
Trakt List	trakt_list	Finds every item in the Trakt List	✔️	✔️	✔️
Trakt List Details	trakt_list_details	Finds every item in the Trakt List and updates the collection summary with the list description	✔️	✔️	✔️
Trakt User Watchlist	trakt_watchlist	Finds every item in a Users Watchlist	✔️	✔️	✔️
Trakt User Collection	trakt_collection	Finds every item in a Users Collection	✔️	✔️	✔️
Trakt Trending	trakt_trending	Finds the movies/shows in Trakt's Trending Movies/Shows list	✔️	✔️	✔️
Trakt Popular	trakt_popular	Finds the movies/shows in Trakt's Popular Movies/Shows list	✔️	✔️	✔️
Trakt Recommended Daily	trakt_recommended_daily	Finds the movies/shows in Trakt's Daily Recommended Movies/Shows list	✔️	✔️	✔️
Trakt Recommended Weekly	trakt_recommended_weekly	Finds the movies/shows in Trakt's Weekly Recommended Movies/Shows list	✔️	✔️	✔️
Trakt Recommended Monthly	trakt_recommended_monthly	Finds the movies/shows in Trakt's Monthly Recommended Movies/Shows list	✔️	✔️	✔️
Trakt Recommended Yearly	trakt_recommended_yearly	Finds the movies/shows in Trakt's Yearly Recommended Movies/Shows list	✔️	✔️	✔️
Trakt Recommended All-Time	trakt_recommended_all	Finds the movies/shows in Trakt's All-Time Recommended Movies/Shows list	✔️	✔️	✔️
Trakt Watched Daily	trakt_watched_daily	Finds the movies/shows in Trakt's Daily Watched Movies/Shows list	✔️	✔️	✔️
Trakt Watched Weekly	trakt_watched_weekly	Finds the movies/shows in Trakt's Weekly Watched Movies/Shows list	✔️	✔️	✔️
Trakt Watched Monthly	trakt_watched_monthly	Finds the movies/shows in Trakt's Monthly Watched Movies/Shows list	✔️	✔️	✔️
Trakt Watched Yearly	trakt_watched_yearly	Finds the movies/shows in Trakt's Yearly Watched Movies/Shows list	✔️	✔️	✔️
Trakt Watched All-Time	trakt_watched_all	Finds the movies/shows in Trakt's All-Time Watched Movies/Shows list	✔️	✔️	✔️
Trakt Collected Daily	trakt_collected_daily	Finds the movies/shows in Trakt's Daily Collected Movies/Shows list	✔️	✔️	✔️
Trakt Collected Weekly	trakt_collected_weekly	Finds the movies/shows in Trakt's Weekly Collected Movies/Shows list	✔️	✔️	✔️
Trakt Collected Monthly	trakt_collected_monthly	Finds the movies/shows in Trakt's Monthly Collected Movies/Shows list	✔️	✔️	✔️
Trakt Collected Yearly	trakt_collected_yearly	Finds the movies/shows in Trakt's Yearly Collected Movies/Shows list	✔️	✔️	✔️
Trakt Collected All-Time	trakt_collected_all	Finds the movies/shows in Trakt's All-Time Collected Movies/Shows list	✔️	✔️	✔️
Trakt Box Office	trakt_boxoffice	Finds the 10 movies in Trakt's Top Box Office Movies list	✔️	❌	✔️

Trakt List

Finds every item in the Trakt List.

The expected input is a Trakt List 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.

collections:
  Christmas:
    trakt_list:
      - https://trakt.tv/users/movistapp/lists/christmas-movies
      - https://trakt.tv/users/2borno2b/lists/christmas-movies-extravanganza
    sync_mode: sync

collections:
  Reddit Top 250:
    trakt_list: https://trakt.tv/users/jay-greene/lists/reddit-top-250-2019-edition
    collection_order: custom
    sync_mode: sync

• You can update the collection details with the Trakt List's description by using trakt_list_details.
• You can specify multiple collections in trakt_list_details but it will only use the first one to update the collection summary.

collections:
  Reddit Top 250:
    trakt_list_details: https://trakt.tv/users/jay-greene/lists/reddit-top-250-2019-edition
    collection_order: custom
    sync_mode: sync

Trakt User Watchlist

Finds every item in a Users Watchlist.

The expected input is a user's Trakt Username or me. 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.

collections:
  Trakt Watchlist:
    trakt_watchlist: me
    collection_order: custom
    sync_mode: sync

Trakt User Collection

Finds every item in a Users Collection.

The expected input is a user's Trakt Username or me. 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.

collections:
  Trakt Collection:
    trakt_collection:
      - me
      - traktbuddy
    sync_mode: sync

Trakt Trending

Finds the movies/shows in Trakt's Trending Movies/Shows list.

The expected input is a single integer value of how many movies/shows to query.

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

collections:
  Trakt Trending:
    trakt_trending: 30
    collection_order: custom
    sync_mode: sync

Trakt Popular

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

The expected input is a single integer value of how many movies/shows to query.

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

collections:
  Trakt Popular:
    trakt_popular: 30
    collection_order: custom
    sync_mode: sync

Trakt Recommended

Finds the movies/shows in Trakt's Recommended lists.

Builder	Period	Movie List	Show List
trakt_recommended_daily	Daily	Daily Movies	Daily Shows
trakt_recommended_weekly	Weekly	Weekly Movies	Weekly Shows
trakt_recommended_monthly	Monthly	Monthly Movies	Monthly Shows
trakt_recommended_yearly	Yearly	Yearly Movies	Yearly Shows
trakt_recommended_all	All-Time	All-Time Movies	All-Time Shows

The expected input is a single integer value of how many movies/shows to query.

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

collections:
  Trakt Recommended:
    trakt_recommended_weekly: 30
    collection_order: custom
    sync_mode: sync

Trakt Watched

Finds the movies/shows in Trakt's Watched lists.

Builder	Period	Movie List	Show List
trakt_watched_daily	Daily	Daily Movies	Daily Shows
trakt_watched_weekly	Weekly	Weekly Movies	Weekly Shows
trakt_watched_monthly	Monthly	Monthly Movies	Monthly Shows
trakt_watched_yearly	Yearly	Yearly Movies	Yearly Shows
trakt_watched_all	All-Time	All-Time Movies	All-Time Shows

The expected input is a single integer value of how many movies/shows to query.

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

collections:
  Trakt Watched:
    trakt_watched_weekly: 30
    collection_order: custom
    sync_mode: sync

Trakt Collected

Finds the movies/shows in Trakt's Collected Movies/Shows list.

Builder	Period	Movie List	Show List
trakt_collected_daily	Daily	Daily Movies	Daily Shows
trakt_collected_weekly	Weekly	Weekly Movies	Weekly Shows
trakt_collected_monthly	Monthly	Monthly Movies	Monthly Shows
trakt_collected_yearly	Yearly	Yearly Movies	Yearly Shows
trakt_collected_all	All-Time	All-Time Movies	All-Time Shows

The expected input is a single integer value of how many movies/shows to query.

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

collections:
  Trakt Collected:
    trakt_collected_weekly: 30
    collection_order: custom
    sync_mode: sync

Trakt Box Office

Finds the 10 movies in Trakt's Top Box Office Movies list.

The expected input is true.

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

collections:
  Trakt Collected:
    trakt_boxoffice: true
    collection_order: custom
    sync_mode: sync