Skip to content

Latest commit

 

History

History
292 lines (292 loc) · 10.3 KB

shows.md

File metadata and controls

292 lines (292 loc) · 10.3 KB

Shows:

$ ./trakt-sync shows -a trending
$ ./trakt-sync shows -a popular
Get the most favorited shows
$ ./trakt-sync shows -a favorited -period daily
$ ./trakt-sync shows -a favorited -period weekly
$ ./trakt-sync shows -a favorited -period monthly
$ ./trakt-sync shows -a favorited -period all
Get the most played shows
$ ./trakt-sync shows -a played -period daily
$ ./trakt-sync shows -a played -period weekly
$ ./trakt-sync shows -a played -period monthly
$ ./trakt-sync shows -a played -period all
Get the most watched shows
$ ./trakt-sync shows -a watched -period daily
$ ./trakt-sync shows -a watched -period weekly
$ ./trakt-sync shows -a watched -period monthly
$ ./trakt-sync shows -a watched -period all
Get the most collected shows
$ ./trakt-sync shows -a collected -period daily
$ ./trakt-sync shows -a collected -period weekly
$ ./trakt-sync shows -a collected -period monthly
$ ./trakt-sync shows -a collected -period all
Get the most anticipated shows
$ ./trakt-sync shows -a anticipated
Get anticipated show recommendations

Needs your login (OAuth). Returns unreleased shows ranked for your taste, at most 100 in total, each with a score and its released date (YYYY-MM-DD, left out when Trakt does not know it yet). Takes no filters or -ex; paging follows per_page and pages_limit.

$ ./trakt-sync shows -a anticipated_recommendations -> export_shows_anticipated_recommendations.json
Filter the show lists

trending, popular, anticipated, watched, played, collected and favorited take the Trakt media filters: -genres, -subgenres, -years, -ratings, -runtimes, -countries, -certifications (comma separated where a filter takes several values), -start_date, -end_date, -watchnow favorites|any|any_all|free|free_all|subscriptions|subscriptions_all and -status (returning series, continuing, in production, planned, upcoming, pilot, canceled, ended; comma separated). They also take -languages (language codes, comma separated), -imdb_ratings (range, for example 8.5-10.0), -rt_meters and -rt_user_meters (Rotten Tomatoes ranges, for example 90-100). -parental_nudity, -parental_violence, -parental_profanity, -parental_alcohol and -parental_frightening filter by parental guide: each takes a severity range min-max from 0 (none) to 3 (severe), ie: -parental_violence 0-1. Titles without a parental guide are left out, unless you add -parental_include_unrated. The live API applied all five on shows -a popular (checked 2026-10-31). trending, popular and anticipated also take -theme <name>, a seasonal theme such as halloween or christmas: Trakt turns it into filters for the list, a filter you set yourself wins over it, and an unknown theme is ignored.

$ ./trakt-sync shows -a trending -theme christmas

On these actions -start_date is a filter; on updates and updated_ids it stays the date to list changes from.

$ ./trakt-sync shows -a trending -genres drama -years 2020-2026 -ratings 75-100
$ ./trakt-sync shows -a popular -status ended -countries us
$ ./trakt-sync shows -a popular -languages pl
$ ./trakt-sync shows -a trending -imdb_ratings 8.5-10.0 -rt_meters 90-100
$ ./trakt-sync shows -a watched -period monthly -status "returning series,continuing" -watchnow subscriptions
Get recenty updated shows
$ ./trakt-sync shows -a updates -start_date YYYY-MM-DD
Get recenty updated show Trakt IDs
$ ./trakt-sync shows -a updated_ids -start_date YYYY-MM-DD
Get a show
$ ./trakt-sync shows -a summary -i the-sopranos
Get all show aliases
$ ./trakt-sync shows -a aliases -i the-sopranos
Get all show certifications
$ ./trakt-sync shows -a certifications -i the-sopranos
Get all show translations
$ ./trakt-sync shows -a translations -i the-sopranos -language es
Get all show comments
$ ./trakt-sync shows -a comments -i the-sopranos -s newest
$ ./trakt-sync shows -a comments -i the-sopranos -s oldest
$ ./trakt-sync shows -a comments -i the-sopranos -s likes
$ ./trakt-sync shows -a comments -i the-sopranos -s replies
$ ./trakt-sync shows -a comments -i the-sopranos -s highest
$ ./trakt-sync shows -a comments -i the-sopranos -s lowest
$ ./trakt-sync shows -a comments -i the-sopranos -s plays
Get lists containing the show
$ ./trakt-sync shows -a lists -i the-sopranos -t all -s popular
$ ./trakt-sync shows -a lists -i the-sopranos -t all -s likes
$ ./trakt-sync shows -a lists -i the-sopranos -t all -s comments
$ ./trakt-sync shows -a lists -i the-sopranos -t all -s items
$ ./trakt-sync shows -a lists -i the-sopranos -t all -s added
$ ./trakt-sync shows -a lists -i the-sopranos -t all -s updated
Get show collection progress
$ ./trakt-sync shows -a collection_progress -i the-sopranos
$ ./trakt-sync shows -a collection_progress -i the-sopranos -hidden false
$ ./trakt-sync shows -a collection_progress -i the-sopranos -specials false
$ ./trakt-sync shows -a collection_progress -i the-sopranos -count_specials true
$ ./trakt-sync shows -a collection_progress -i the-sopranos -hidden true -specials true -count_specials true

last_episode and next_episode are counted from the last aired episode you collected. -last_activity collected counts them from the episode you collected most recently:

$ ./trakt-sync shows -a collection_progress -i the-sopranos -last_activity collected
Get show watched progress
$ ./trakt-sync shows -a watched_progress -i the-sopranos
$ ./trakt-sync shows -a watched_progress -i the-sopranos -hidden false
$ ./trakt-sync shows -a watched_progress -i the-sopranos -specials false
$ ./trakt-sync shows -a watched_progress -i the-sopranos -count_specials true
$ ./trakt-sync shows -a watched_progress -i the-sopranos -hidden true -specials true -count_specials true

-last_activity watched counts last_episode and next_episode from the episode you watched most recently, instead of the last aired one you watched:

$ ./trakt-sync shows -a watched_progress -i the-sopranos -last_activity watched
Reset show progress
$ ./trakt-sync shows -a reset_show_progress -i the-sopranos

-reset_at sets the time of the reset: a day (YYYY-MM-DD, with the current time of day in UTC) or a full date and time with an offset. Without it Trakt uses the current time.

$ ./trakt-sync shows -a reset_show_progress -i the-sopranos -reset_at 2026-10-01
$ ./trakt-sync shows -a reset_show_progress -i the-sopranos -reset_at 2026-10-01T20:30:00+02:00

Trakt marks reset and undo VIP only; when Trakt answers with 426 the upgrade page opens in the browser.

Undo Reset show progress
$ ./trakt-sync shows -a reset_show_progress -i the-sopranos -undo
Get all people for a show
$ ./trakt-sync shows -a people -i the-sopranos
$ ./trakt-sync shows -a people -i the-sopranos -ex guest_stars

-ex markdown adds markdown links to the movies and shows mentioned in the person biographies.

$ ./trakt-sync shows -a people -i the-sopranos -ex full,markdown
Get show ratings
$ ./trakt-sync shows -a ratings -i the-sopranos
Get related shows
$ ./trakt-sync shows -a related -i the-sopranos

-personalized asks Trakt to re-order the related shows toward your taste. Trakt applies it only for VIP accounts and ignores it for everyone else.

$ ./trakt-sync shows -a related -i the-sopranos -personalized
Get show sentiments
$ ./trakt-sync shows -a sentiments -i the-sopranos -> export_shows_sentiments_the-sopranos.json
Get show studios
$ ./trakt-sync shows -a studios -i the-sopranos
Get users watching right now
$ ./trakt-sync shows -a watching -i the-sopranos
Get next episode
$ ./trakt-sync shows -a next_episode -i the-sopranos
Get last episode
$ ./trakt-sync shows -a last_episode -i the-sopranos
Get where to watch
$ ./trakt-sync shows -a watchnow -i the-sopranos -country us -> export_shows_watchnow_the-sopranos.json
$ ./trakt-sync -ex streaming_ranks shows -a watchnow -i the-sopranos -country us -links tvos,direct,android,webos

-links adds provider links (any of tvos, direct, android, webos); -ex streaming_ranks adds the JustWatch rank.

$ ./trakt-sync shows -a justwatch_links -i the-sopranos -country pl -> export_shows_justwatch_links_the-sopranos.json

watchnow and justwatch_links need -country (2 character code) and are marked Limited Access by Trakt; an API app without access gets a limited access error.

Get all videos
$ ./trakt-sync shows -a videos -i the-sopranos
Refresh show metadata (deprecated)

Deprecated since 2026-10-13: Trakt dropped this endpoint from its API contract. shows -a refresh still works (checked 2026-10-13 and 2026-11-08) and prints a deprecation notice; it may stop working.

$ ./trakt-sync shows -a refresh -i the-sopranos
Refresh show JustWatch links
$ ./trakt-sync shows -a refresh_justwatch -i the-sopranos

refresh_justwatch is marked VIP only by Trakt; when Trakt answers with 426 the upgrade page opens in the browser. The live API accepted it from a non-VIP account (checked 2026-09-24), unlike movies -a refresh_justwatch.

Report a show
$ ./trakt-sync shows -a report -i the-sopranos -r metadata -message "overview is wrong"

-r is one of: duplicate, remove, data_refresh, metadata, adult, runtime, language, spam, tmdb, other.