trakt-sync

command module
v1.15.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: May 26, 2026 License: MIT Imports: 9 Imported by: 0

README

Installation

go install github.com/mfederowicz/trakt-sync@latest

Configuration

After install, we should create API app and save credentials in config file ($HOME/trakt-sync.toml):

client_id = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
client_secret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxx"
token_path = "~/.config/trakt-sync/token.json"
errorCode = 0
warningCode = 0
per_page = 500
pages_limit = 10

Usage

trakt-sync supports a -config flag whose value should correspond to a TOML file. If not provided, trakt-sync will try to use a global config file (assumed to be located at $HOME/trakt-sync.toml). Otherwise, if no configuration TOML file is found then trakt-sync uses a built-in parameters depends on selected module.

Command Line Flags

trakt-sync accepts the following command line parameters:

  • -config [PATH] - path to config file in TOML format, defaults to $HOME/trakt-sync.toml if present.
  • -version - get trakt-sync version.

Command Line Commands

trakt-sync accepts the following command line commands/modules:

  • calendars - By default, the calendar will return all shows or movies for the specified time period and can be global or user specific.
  • certifications - Certifications list
  • checkin - Checkin movie,episode,show_episode,delete
  • comments - Comments comments,comment,replies,item,likes,like,trending,recent,updates.
  • collection - Get all collected items in a user's collection.
  • countries - Get a list of all countries, including names and codes.
  • genres - Get a list of all genres, including names and slugs.
  • help - Help on the trakt-sync command and subcommands.
  • history - Returns movies and episodes that a user has watched, sorted by most recent.
  • languages - Get a list of all laguages, including names and codes.
  • lists - Returns data about lists: trending, popular, list, likes, like, items, comments.
  • movies - Returns data about movies: trending, popular, list, likes, like, items, comments etc...
  • networks - Get a list of all TV networks
  • notes - Manage notes created by user
  • people - Returns all data for selected person.
  • recommendations - Recommendations manage movie and shows recommendations for user
  • scrobble - Scrobble for start/pause/stop movie,show,episode
  • search - Searches can use queries or ID lookups.
  • seasons - Returns data about seasons: summary, season, episodes, translations, comments etc...
  • shows - Returns data about movies: trending, popular, list, likes, like, items, comments etc...
  • sync - Sync data useful for mediacenters: activities, playbacks, collections, ratings, watchlists, favorites.
  • users - Returns all data for a user.
  • watchlist - Returns all items in a user's watchlist filtered by type.

Sample export usage

Calendars:
$ ./trakt-sync calendars -a all-shows -> export_calendars_shows_20240707_7.json

$ ./trakt-sync calendars -a all-new-shows -> export_calendars_new_shows_20240707_7.json

$ ./trakt-sync calendars -a all-season-premieres -> export_calendars_season_premieres_20240707_7.json

$ ./trakt-sync calendars -a all-finales -> export_calendars_finales_20240707_7.json

$ ./trakt-sync calendars -a all-movies -> export_calendars_movies_20240707_7.json

$ ./trakt-sync calendars -a all-dvd -> export_calendars_dvd_20240707_7.json
Certifications:
$ ./trakt-sync certifications -> export_certifications_movies.json

$ ./trakt-sync certifications -t movies -> export_certifications_movies.json

$ ./trakt-sync certifications -t shows -> export_certifications_shows.json
Checkin:
$ ./trakt-sync checkin -a movie -trakt_id 28 -msg "super movie"

$ ./trakt-sync checkin -a episode -trakt_id 3190486 -msg "super episode"

$ ./trakt-sync checkin -a show_episode -trakt_id 37696 -episode_abs 6 -msg "super episode"

$ ./trakt-sync checkin -a show_episode -trakt_id 136121 -episode_code 1x5 -msg "super episode"

$ ./trakt-sync checkin -a delete
Comments:
$ ./trakt-sync comments -a comment -comment_id 779883 -comment "minions,minions,minions movie ever ok"

$ ./trakt-sync comments -a comment -comment_id 779883 -delete

$ ./trakt-sync comments -a comments -t episode -trakt_id 172245 -comment "super episode, interesting plot ok"

$ ./trakt-sync comments -a replies -comment_id 779896 -reply "reply msg min 5 words" -spoiler

$ ./trakt-sync comments -a replies -comment_id 71340

$ ./trakt-sync comments -a item -comment_id 664237 -ex full

$ ./trakt-sync comments -a likes -comment_id 773108 -remove

$ ./trakt-sync comments -a like -comment_id 773108

$ ./trakt-sync comments -a like -comment_id 773108 -remove

$ ./trakt-sync comments -a trending -comment_type reviews

$ ./trakt-sync comments -a recent -include_replies false

$ ./trakt-sync comments -a recent -include_replies true

$ ./trakt-sync comments -a updates -include_replies false
Collection:
$ ./trakt-sync collection -t movies --ex metadata

$ ./trakt-sync collection -t shows --ex metadata
Countries:
$ ./trakt-sync countries -> export_countries_movies.json

$ ./trakt-sync countries -t movies -> export_countries_movies.json

$ ./trakt-sync countries -t shows -> export_countries_shows.json
Genres:
$ ./trakt-sync genres -> export_genres_movies.json

$ ./trakt-sync genres -t movies -> export_genres_movies.json

$ ./trakt-sync genres -t shows -> export_genres_shows.json
History:
$ ./trakt-sync history -t shows -> export_history_shows_imdb.json

$ ./trakt-sync history -t episodes -f tmdb -> export_history_episodes_tmdb.json

$ ./trakt-sync history -t episodes -f imdb -> export_history_episodes_imdb.json
Languages:
$ ./trakt-sync languages -> export_languages_movies.json

$ ./trakt-sync languages -t movies -> export_languages_movies.json

$ ./trakt-sync languages -t shows -> export_languages_shows.json
Lists:
$ ./trakt-sync lists -a trending

$ ./trakt-sync lists -a popular

$ ./trakt-sync lists -a list -trakt_id 2142753

$ ./trakt-sync lists -a likes -trakt_id 2142753

$ ./trakt-sync lists -a like -trakt_id 2142753

$ ./trakt-sync lists -a like -trakt_id 2142753 -remove

$ ./trakt-sync lists -a items -trakt_id 2142753

$ ./trakt-sync lists -a items -trakt_id 2142753 -t movie,show

-- (temp not working - problems with api endpoint)

$ ./trakt-sync lists -a comments -trakt_id 2142753
Movies:
$ ./trakt-sync movies -a trending

$ ./trakt-sync movies -a popular
Get the most favorited movies
$ ./trakt-sync movies -a favorited -period daily

$ ./trakt-sync movies -a favorited -period weekly

$ ./trakt-sync movies -a favorited -period monthly

$ ./trakt-sync movies -a favorited -period all
Get the most played movies
$ ./trakt-sync movies -a played -period daily

$ ./trakt-sync movies -a played -period weekly

$ ./trakt-sync movies -a played -period monthly

$ ./trakt-sync movies -a played -period all
Get the most watched movies
$ ./trakt-sync movies -a watched -period daily

$ ./trakt-sync movies -a watched -period weekly

$ ./trakt-sync movies -a watched -period monthly

$ ./trakt-sync movies -a watched -period all
Get the most collected movies
$ ./trakt-sync movies -a collected -period daily

$ ./trakt-sync movies -a collected -period weekly

$ ./trakt-sync movies -a collected -period monthly

$ ./trakt-sync movies -a collected -period all
Get the most anticipated movies
$ ./trakt-sync movies -a anticipated
Get the weekend box office
$ ./trakt-sync movies -a boxoffice
Get recenty updated movies
$ ./trakt-sync movies -a updates -start_date YYYY-MM-DD
Get recenty updated movie Trakt IDs
$ ./trakt-sync movies -a updated_ids -start_date YYYY-MM-DD
Get a movie
$ ./trakt-sync movies -a summary -i the-sopranos
Get all movie aliases
$ ./trakt-sync movies -a aliases -i the-sopranos
Get all movie releases
$ ./trakt-sync movies -a releases -i the-sopranos -country us
Get all movie translations
$ ./trakt-sync movies -a translations -i the-sopranos -language es
Get all movie comments
$ ./trakt-sync movies -a comments -i the-sopranos -s newest

$ ./trakt-sync movies -a comments -i the-sopranos -s oldest

$ ./trakt-sync movies -a comments -i the-sopranos -s likes

$ ./trakt-sync movies -a comments -i the-sopranos -s replies

$ ./trakt-sync movies -a comments -i the-sopranos -s highest

$ ./trakt-sync movies -a comments -i the-sopranos -s lowest

$ ./trakt-sync movies -a comments -i the-sopranos -s plays
Get lists containing the movie
$ ./trakt-sync movies -a lists -i the-sopranos -t all -s popular

$ ./trakt-sync movies -a lists -i the-sopranos -t all -s likes

$ ./trakt-sync movies -a lists -i the-sopranos -t all -s comments

$ ./trakt-sync movies -a lists -i the-sopranos -t all -s items

$ ./trakt-sync movies -a lists -i the-sopranos -t all -s added

$ ./trakt-sync movies -a lists -i the-sopranos -t all -s updated
Get all people for movie
$ ./trakt-sync movies -a people -i the-sopranos
Get movie ratings
$ ./trakt-sync movies -a ratings -i the-sopranos

$ ./trakt-sync movies -a related -i the-sopranos
Get movies stats
$ ./trakt-sync movies -a stats -i the-sopranos
Get movies studios
$ ./trakt-sync movies -a studios -i the-sopranos
Get users watching right now
$ ./trakt-sync movies -a watching -i the-sopranos
Get all videos
$ ./trakt-sync movies -a videos -i the-sopranos
Refresh movie metadata
$ ./trakt-sync movies -a refresh -i the-sopranos
Networks:
$ ./trakt-sync networks -a list
Notes:
Adding notes for media types:
$ ./trakt-sync notes -a notes -t movie -i the-sopranos -notes "xyz"

$ ./trakt-sync notes -a notes -t show -i breaking-bad -notes "greate show"

$ ./trakt-sync notes -a notes -t season -i 250341 -notes "greate season"

$ ./trakt-sync notes -a notes -t episode -i 250341 -notes "greate episode"

$ ./trakt-sync notes -a notes -t person -i john-wayne -notes "greate person"

$ ./trakt-sync notes -a notes -t history -i 1234567 -notes "history note"
Adding notes depends on activities:
$ ./trakt-sync notes -a notes -t collection -item episode -i 73629 -notes "great episode"

$ ./trakt-sync notes -a notes -t collection -item movie -i despicable-me-4-2024 -notes "great animation"

$ ./trakt-sync notes -a notes -t rating -item movie -i despicable-me-4-2024 -notes "great animation"

$ ./trakt-sync notes -a notes -t rating -item episode -i 73629 -notes "overall 10/10"

$ ./trakt-sync notes -a notes -t rating -item movie -i the-gorge-2025 -notes "overall 7/10"

$ ./trakt-sync notes -a notes -t rating -item season -i 3961 -notes "overall 9/10"

$ ./trakt-sync notes -a notes -t rating -item show -i the-sopranos -notes "overall 9/10"
Manage notes get/modify/delete:
$ ./trakt-sync notes -a note -i 97857

$ ./trakt-sync notes -a note -i 97857 -notes "super 10/10" -privacy public -spoiler

$ ./trakt-sync notes -a note -i 97857 -delete
Get items attachment to note:
$ ./trakt-sync notes -a item -i 97854
People:
$ ./trakt-sync people -a updates -start_date 2024-10-13

$ ./trakt-sync people -a updated_ids -start_date 2024-10-13

$ ./trakt-sync people -a summary -i john-wayne

$ ./trakt-sync people -a movies -i john-wayne

$ ./trakt-sync people -a shows -i john-wayne

$ ./trakt-sync people -a lists -i john-wayne
Recommendations:
Hide movie recommendations:
$ ./trakt-sync recommendations -a movies -i black-bag-2025 -hide
Movies recommendations:
$ ./trakt-sync recommendations -a movies

$ ./trakt-sync recommendations -a movies -ignore_collected true -ignore_watchlisted true
Hide show recommendations:
$ ./trakt-sync recommendations -a shows -i wellington-paranormal -hide
Shows recommendations:
$ ./trakt-sync recommendations -a shows

$ ./trakt-sync recommendations -a shows -ignore_collected false -ignore_watchlisted false
Scrobble:
Scrobble start/pause/stop movie:
$ ./trakt-sync scrobble -a start -t movie -progress 3.45 -i guardians-of-the-galaxy-2014

$ ./trakt-sync scrobble -a pause -t movie -progress 3.45 -i guardians-of-the-galaxy-2014

$ ./trakt-sync scrobble -a stop -t movie -progress 3.45 -i guardians-of-the-galaxy-2014
Scrobble start/pause/stop episode:
$ ./trakt-sync scrobble -a start -t episode -i 73629 -progress 10.25

$ ./trakt-sync scrobble -a pause -t episode -i 73629 -progress 10.25

$ ./trakt-sync scrobble -a stop -t episode -i 73629 -progress 50.25
Scrobble start/pause/stop show by episode code (format season x episode):
$ ./trakt-sync scrobble -a start -t show_episode -i 136121 -episode_code 1x5 -progress 3.45

$ ./trakt-sync scrobble -a pause -t show_episode -i 136121 -episode_code 1x5 -progress 3.45

$ ./trakt-sync scrobble -a stop -t show_episode -i 136121 -episode_code 1x5 -progress 3.45
Scrobble start/pause/stop show by episode abs number (useful for Anime and Donghua):
$ ./trakt-sync scrobble -a start -t show_episode -i 37696 -episode_abs 164 -progress 50

$ ./trakt-sync scrobble -a pause -t show_episode -i 37696 -episode_abs 164 -progress 50

$ ./trakt-sync scrobble -a stop -t show_episode -i 37696 -episode_abs 164 -progress 60
Export search result by Text Query:
$  ./trakt-sync search -a text-query -t movie -q freddy --field title

$  ./trakt-sync search -a text-query -t movie -t show -q freddy --field tagline

$  ./trakt-sync search -a text-query -t movie -t show -t list -q freddy --field name

$  ./trakt-sync search -a text-query -t movie -t show -t list -q freddy --field title

$  ./trakt-sync search -a text-query -t person -t list -q freddy --field name

$  ./trakt-sync search -a text-query -t movie -t show -t list -q freddy --field title
Export search result by Id lookup:
$ ./trakt-sync search -a id-lookup -i 12601 -t movie -t show

$ ./trakt-sync search -a id-lookup --id_type tvdb -i 12601 -t movie -t show

$ ./trakt-sync search -a id-lookup --id_type imdb -i 12601 -t movie

$ ./trakt-sync search -a id-lookup --id_type imdb -i 12601 -t podcast

$ ./trakt-sync search -a id-lookup --id_type imdb -i tt0266697

$ ./trakt-sync search -a id-lookup --id_type tvdb -i 75725

$ ./trakt-sync search -a id-lookup --id_type tvdb -i 75725 -t podcast

$ ./trakt-sync search -a id-lookup -i 75725

$ ./trakt-sync search -a id-lookup -i 75725 -t episode

$ ./trakt-sync search -a id-lookup --id_type tmdb -i 254265
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 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
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
Reset show progress
$ ./trakt-sync shows -a reset_show_progress -i the-sopranos
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
Get show ratings
$ ./trakt-sync shows -a ratings -i the-sopranos

$ ./trakt-sync shows -a related -i the-sopranos
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 all videos
$ ./trakt-sync shows -a videos -i the-sopranos
Refresh show metadata
$ ./trakt-sync shows -a refresh -i the-sopranos
Seasons:
Get all seasons for a show
$ ./trakt-sync seasons -a summary -i the-sopranos -ex full
Get single seasons for a show
$ ./trakt-sync seasons -a season -i the-sopranos -season 1 -ex full
Get all episodes for a single season
$ ./trakt-sync seasons -a episodes -i the-sopranos -season 1 -translations es -ex full
Get all season translations - all languages
$ ./trakt-sync seasons -a translations -i the-sopranos -season 1
Get all season translations - selected language
$ ./trakt-sync seasons -a translations -i the-sopranos -season 1 -language en
Get all season comments
$ ./trakt-sync seasons -a comments -i the-sopranos -season 1 -s newest

$ ./trakt-sync seasons -a comments -i the-sopranos -season 1 -s oldest

$ ./trakt-sync seasons -a comments -i the-sopranos -season 1 -s likes

$ ./trakt-sync seasons -a comments -i the-sopranos -season 1 -s replies

$ ./trakt-sync seasons -a comments -i the-sopranos -season 1 -s highest

$ ./trakt-sync seasons -a comments -i the-sopranos -season 1 -s lowest

$ ./trakt-sync seasons -a comments -i the-sopranos -season 1 -s plays
Get lists containing this season
$ ./trakt-sync seasons -a lists -i the-sopranos -season 1 -t all -s popular

$ ./trakt-sync seasons -a lists -i the-sopranos -season 1 -t all -s likes

$ ./trakt-sync seasons -a lists -i the-sopranos -season 1 -t all -s comments

$ ./trakt-sync seasons -a lists -i the-sopranos -season 1 -t all -s items

$ ./trakt-sync seasons -a lists -i the-sopranos -season 1 -t all -s added

$ ./trakt-sync seasons -a lists -i the-sopranos -season 1 -t all -s updated
Get all people for season
$ ./trakt-sync seasons -a people -i the-sopranos -season 1
Get season ratings
$ ./trakt-sync seasons -a ratings -i the-sopranos -season 1

$ ./trakt-sync seasons -a related -i the-sopranos -season 1
Get seasons stats
$ ./trakt-sync seasons -a stats -i the-sopranos -season 1
Get users watching right now
$ ./trakt-sync seasons -a watching -i the-sopranos -season 1
Get all videos
$ ./trakt-sync seasons -a videos -i the-sopranos -season 1
Episodes:
Get a single episode for a show
$ ./trakt-sync episodes -a summary -i the-sopranos -season 1 -episode 1 -ex full
Get all episode translations - all languages
$ ./trakt-sync episodes -a translations -i the-sopranos -season 1 -episode 1
Get all episode translations - selected language
$ ./trakt-sync episodes -a translations -i the-sopranos -season 1 -episode 1 -language en
Get all episode comments
$ ./trakt-sync episodes -a comments -i the-sopranos -season 1 -episode 1 -s newest

$ ./trakt-sync episodes -a comments -i the-sopranos -season 1 -episode 1 -s oldest

$ ./trakt-sync episodes -a comments -i the-sopranos -season 1 -episode 1 -s likes

$ ./trakt-sync episodes -a comments -i the-sopranos -season 1 -episode 1 -s replies

$ ./trakt-sync episodes -a comments -i the-sopranos -season 1 -episode 1 -s highest

$ ./trakt-sync episodes -a comments -i the-sopranos -season 1 -episode 1 -s lowest

$ ./trakt-sync episodes -a comments -i the-sopranos -season 1 -episode 1 -s plays
Get lists containing this episode
$ ./trakt-sync episodes -a lists -i the-sopranos -season 1 -episode 1 -t all -s popular

$ ./trakt-sync episodes -a lists -i the-sopranos -season 1 -episode 1 -t all -s likes

$ ./trakt-sync episodes -a lists -i the-sopranos -season 1 -episode 1 -t all -s comments

$ ./trakt-sync episodes -a lists -i the-sopranos -season 1 -episode 1 -t all -s items

$ ./trakt-sync episodes -a lists -i the-sopranos -season 1 -episode 1 -t all -s added

$ ./trakt-sync episodes -a lists -i the-sopranos -season 1 -episode 1 -t all -s updated
Get all people for episode
$ ./trakt-sync episodes -a people -i the-sopranos -season 1 -episode 1
Get episode ratings
$ ./trakt-sync episodes -a ratings -i the-sopranos -season 1 -episode 1

$ ./trakt-sync episodes -a related -i the-sopranos -season 1 -episode 1
Get episodes stats
$ ./trakt-sync episodes -a stats -i the-sopranos -season 1 -episode 1
Get users watching right now
$ ./trakt-sync episodes -a watching -i the-sopranos -season 1 -episode 1
Get all episodes videos
$ ./trakt-sync episodes -a videos -i the-sopranos -season 1 -episode 1
Sync:
Last activities
$ ./trakt-sync sync -a last_activities
Playback progress from last 60 days
$ ./trakt-sync sync -a playback
Playback progress from last 60 days (movies or episodes)
$ ./trakt-sync sync -a playback -t movies
Playback progress from 7 days
$ ./trakt-sync sync -a playback -start_at 2025-06-01 -end_at 2025-06-07
Remove playback
$ ./trakt-sync sync -a remove_playback -playback_id 12345
Get collection - movies
$ ./trakt-sync sync -a get_collection -t movies -ex metadata
Get collection - shows
$ ./trakt-sync sync -a get_collection -t shows -ex metadata
Get collection - episodes
$ ./trakt-sync sync -a get_collection -t episodes -ex metadata
Get collection - seasons
$ ./trakt-sync sync -a get_collection -t seasons -ex metadata
Add to collection - via -items flag
$ ./trakt-sync sync -t movies -a add_to_collection -items export_sync_collection_movies.json

$ ./trakt-sync sync -t shows -a add_to_collection -items export_sync_collection_shows.json

$ ./trakt-sync sync -t episodes -a add_to_collection -items export_sync_collection_episodes.json

$ ./trakt-sync sync -t seasons -a add_to_collection -items export_sync_collection_seasons.json
Add to collection - via stdin
$ cat export_sync_collection_movies.json | ./trakt-sync sync -t movies -a add_to_collection

$ cat export_sync_collection_shows.json | ./trakt-sync sync -t shows -a add_to_collection

$ cat export_sync_collection_episodes.json | ./trakt-sync sync -t episodes -a add_to_collection

$ cat export_sync_collection_seasons.json | ./trakt-sync sync -t seasons -a add_to_collection
Remove from collection - via -items flag
$ ./trakt-sync sync -t movies -a remove_from_collection -items export_sync_collection_movies.json

$ ./trakt-sync sync -t shows -a remove_from_collection -items export_sync_collection_shows.json

$ ./trakt-sync sync -t episodes -a remove_from_collection -items export_sync_collection_episode.json

$ ./trakt-sync sync -t seasons -a remove_from_collection -items export_sync_collection_seasons.json
Remove from collection - via stdin
$ cat export_sync_collection_movies.json | ./trakt-sync sync -t movies -a remove_from_collection

$ cat export_sync_collection_shows.json | ./trakt-sync sync -t shows -a remove_from_collection

$ cat export_sync_collection_episodes.json | ./trakt-sync sync -t episodes -a remove_from_collection

$ cat export_sync_collection_seasons.json | ./trakt-sync sync -t seasons -a remove_from_collection
Get watched - movies
$ ./trakt-sync sync -a get_watched -t movies
Get watched - shows
$ ./trakt-sync sync -a get_watched -t shows
Get watched - shows - noseasons
$ ./trakt-sync sync -a get_watched -t shows -ex noseasons
Get watched - episodes
$ ./trakt-sync sync -a get_watched -t episodes
Get history - movies
$ ./trakt-sync sync -a get_history -t movies -start_at 2025-07-01 -end_at 2025-07-06
Get history - shows - with trakt_id
$ ./trakt-sync sync -a get_history -t shows -i 1388
Get history - shows
$ ./trakt-sync sync -a get_history -t shows
Get history - episodes
$ ./trakt-sync sync -a get_history -t episodes
Remove and Add to history - via -items flag
$ ./trakt-sync sync -t movies -a add_to_history -items export_sync_history_movies.json

$ ./trakt-sync sync -t shows -a add_to_history -items export_sync_history_shows.json

$ ./trakt-sync sync -t episodes -a add_to_history -items export_sync_history_episode.json

$ ./trakt-sync sync -t seasons -a add_to_history -items export_sync_history_seasons.json
Remove and Add to history - via stdin
$ cat export_sync_history_movies.json | ./trakt-sync sync -t movies -a add_to_history

$ cat export_sync_history_shows.json | ./trakt-sync sync -t shows -a add_to_history

$ cat export_sync_history_episodes.json | ./trakt-sync sync -t episodes -a add_to_history

$ cat export_sync_history_seasons.json | ./trakt-sync sync -t seasons -a add_to_history
Remove from history - via -items flag
$ ./trakt-sync sync -t movies -a remove_from_history -items export_sync_history_movies.json

$ ./trakt-sync sync -t shows -a remove_from_history -items export_sync_history_shows.json

$ ./trakt-sync sync -t episodes -a remove_from_history -items export_sync_history_episode.json

$ ./trakt-sync sync -t seasons -a remove_from_history -items export_sync_history_seasons.json
Remove from history - via stdin
$ cat export_sync_history_movies.json | ./trakt-sync sync -t movies -a remove_from_history

$ cat export_sync_history_shows.json | ./trakt-sync sync -t shows -a remove_from_history

$ cat export_sync_history_episodes.json | ./trakt-sync sync -t episodes -a remove_from_history

$ cat export_sync_history_seasons.json | ./trakt-sync sync -t seasons -a remove_from_history
Get ratings - movies - all ratings
$ ./trakt-sync sync -a get_ratings -t movies
Get ratings - shows - filter for specific rating from 1 to 10
$ ./trakt-sync sync -a get_ratings -t shows -rating 1,2,3
Get ratings - seasons
$ ./trakt-sync sync -a get_ratings -t seasons
Get ratings - episodes
$ ./trakt-sync sync -a get_ratings -t episodes
Get ratings - all ratings
$ ./trakt-sync sync -a get_ratings -t all
Add ratings - via -items flag
$ ./trakt-sync sync -t movies -a add_to_ratings -items export_sync_ratings_movies.json

$ ./trakt-sync sync -t shows -a add_to_ratings -items export_sync_ratings_shows.json

$ ./trakt-sync sync -t episodes -a add_to_ratings -items export_sync_ratings_episodes.json

$ ./trakt-sync sync -t seasons -a add_to_ratings -items export_sync_ratings_seasons.json
Add ratings - via stdin
$ cat export_sync_ratings_movies.json |

$ cat export_sync_ratings_shows.json | ./trakt-sync sync -t shows -a add_to_ratings

$ cat export_sync_ratings_episodes.json | ./trakt-sync sync -t episodes -a add_to_ratings

$ cat export_sync_ratings_seasons.json | ./trakt-sync sync -t seasons -a add_to_ratings

$ cat export_sync_ratings_all.json | ./trakt-sync sync -t seasons -a add_to_ratings
Remove from ratings - via -items flag
$ ./trakt-sync sync -t movies -a remove_from_ratings -items export_sync_ratings_movies.json

$ ./trakt-sync sync -t shows -a remove_from_ratings -items export_sync_ratings_shows.json

$ ./trakt-sync sync -t episodes -a remove_from_ratings -items export_sync_ratings_episodes.json

$ ./trakt-sync sync -t seasons -a remove_from_ratings -items export_sync_ratings_seasons.json

$ ./trakt-sync sync -t seasons -a remove_from_ratings -items export_sync_ratings_all.json
Remove from ratings - via stdin
$ cat export_sync_ratings_movies.json | ./trakt-sync sync -t movies -a remove_from_ratings

$ cat export_sync_ratings_shows.json | ./trakt-sync sync -t shows -a remove_from_ratings

$ cat export_sync_ratings_episodes.json | ./trakt-sync sync -t episodes -a remove_from_ratings

$ cat export_sync_ratings_seasons.json | ./trakt-sync sync -t seasons -a remove_from_ratings

$ cat export_sync_ratings_all.json | ./trakt-sync sync -t seasons -a remove_from_ratings
Get Watchlist
$ ./trakt-sync sync -a get_watchlist -t movies -sort_how asc

$ ./trakt-sync sync -a get_watchlist -t movies -sort_how des

$ ./trakt-sync sync -a get_watchlist -t movies -sort_by rank

$ ./trakt-sync sync -a get_watchlist -t movies -sort_by added

$ ./trakt-sync sync -a get_watchlist -t movies -sort_by title

$ ./trakt-sync sync -a get_watchlist -t movies -sort_by released

$ ./trakt-sync sync -a get_watchlist -t movies -sort_by runtime

$ ./trakt-sync sync -a get_watchlist -t movies -sort_by popularity

$ ./trakt-sync sync -a get_watchlist -t movies -sort_by random

$ ./trakt-sync sync -a get_watchlist -t movies -sort_by percentage

🔥VIP Only including imdb_rating, tmdb_rating, rt_tomatometer, rt_audience, metascore, votes,
imdb_votes, and tmdb_votes. If sent for a non VIP, the items will fall back to rank.
Update Watchlist
$ ./trakt-sync sync -a update_watchlist -description "short watchlist description" -sort_how asc

$ ./trakt-sync sync -a update_watchlist -description "short watchlist description" -sort_by added

$ ./trakt-sync sync -a update_watchlist -sort_by added -sort_how desc
Add items to Watchlist - via -items flag
$ ./trakt-sync sync -t movies -a add_to_watchlist -items export_sync_watchlist_movies.json

$ ./trakt-sync sync -t shows -a add_to_watchlist -items export_sync_watchlist_shows.json

$ ./trakt-sync sync -t episodes -a add_to_watchlist -items export_sync_watchlist_episodes.json

$ ./trakt-sync sync -t seasons -a add_to_watchlist -items export_sync_watchlist_seasons.json
Add items to Watchlist - via stdin
$ cat export_sync_watchlist_movies.json | ./trakt-sync sync -t movies -a add_to_watchlist

$ cat export_sync_watchlist_shows.json | ./trakt-sync sync -t shows -a add_to_watchlist

$ cat export_sync_watchlist_episodes.json | ./trakt-sync sync -t episodes -a add_to_watchlist

$ cat export_sync_watchlist_seasons.json | ./trakt-sync sync -t seasons -a add_to_watchlist

$ cat export_sync_watchlist_all.json | ./trakt-sync sync -t seasons -a add_to_watchlist
Remove from Watchlist - via -items flag
$ ./trakt-sync sync -t movies -a remove_from_watchlist -items export_sync_watchlist_movies.json

$ ./trakt-sync sync -t shows -a remove_from_watchlist -items export_sync_watchlist_shows.json

$ ./trakt-sync sync -t episodes -a remove_from_watchlist -items export_sync_watchlist_episodes.json

$ ./trakt-sync sync -t seasons -a remove_from_watchlist -items export_sync_watchlist_seasons.json
Remove from Watchlist - via stdin
$ cat export_sync_watchlist_movies.json | ./trakt-sync sync -t movies -a remove_from_watchlist

$ cat export_sync_watchlist_shows.json | ./trakt-sync sync -t shows -a remove_from_watchlist

$ cat export_sync_watchlist_episodes.json | ./trakt-sync sync -t episodes -a remove_from_watchlist

$ cat export_sync_watchlist_seasons.json | ./trakt-sync sync -t seasons -a remove_from_watchlist

$ cat export_sync_watchlist_all.json | ./trakt-sync sync -t seasons -a remove_from_watchlist
Reorder Watchlist - via -items flag
$ ./trakt-sync sync -a reorder_watchlist -items export_sync_watchlist_movies.json
Reorder Watchlist - via stdin
$ cat export_sync_watchlist_movies.json | ./trakt-sync sync -a reorder_watchlist
Update Watchlist item
$ ./trakt-sync sync -a update_watchlist_item -list_item_id 97857 -notes "super 10/10"
Get Favorites
$ ./trakt-sync sync -a get_favorites -t movies -sort_how asc

$ ./trakt-sync sync -a get_favorites -t movies -sort_how des

$ ./trakt-sync sync -a get_favorites -t movies -sort_by rank

$ ./trakt-sync sync -a get_favorites -t movies -sort_by added

$ ./trakt-sync sync -a get_favorites -t movies -sort_by title

$ ./trakt-sync sync -a get_favorites -t movies -sort_by released

$ ./trakt-sync sync -a get_favorites -t movies -sort_by runtime

$ ./trakt-sync sync -a get_favorites -t movies -sort_by popularity

$ ./trakt-sync sync -a get_favorites -t movies -sort_by random

$ ./trakt-sync sync -a get_favorites -t movies -sort_by percentage


🔥VIP Only including imdb_rating, tmdb_rating, rt_tomatometer, rt_audience, metascore, votes,
imdb_votes, and tmdb_votes. If sent for a non VIP, the items will fall back to rank.
Update Favorites
$ ./trakt-sync sync -a update_favorites -description "short favorites description" -sort_how asc

$ ./trakt-sync sync -a update_favorites -description "short favorites description" -sort_by added

$ ./trakt-sync sync -a update_favorites -sort_by added -sort_how desc
Add items to Favorites - via -items flag
$ ./trakt-sync sync -t movies -a add_to_favorites -items export_sync_favorites_movies.json

$ ./trakt-sync sync -t shows -a add_to_favorites -items export_sync_favorites_shows.json

$ ./trakt-sync sync -t episodes -a add_to_favorites -items export_sync_favorites_episodes.json

$ ./trakt-sync sync -t seasons -a add_to_favorites -items export_sync_favorites_seasons.json
Add items to Favorites - via stdin
$ cat export_sync_favorites_movies.json | ./trakt-sync sync -t movies -a add_to_favorites

$ cat export_sync_favorites_shows.json | ./trakt-sync sync -t shows -a add_to_favorites

$ cat export_sync_favorites_episodes.json | ./trakt-sync sync -t episodes -a add_to_favorites

$ cat export_sync_favorites_seasons.json | ./trakt-sync sync -t seasons -a add_to_favorites

$ cat export_sync_favorites_all.json | ./trakt-sync sync -t seasons -a add_to_favorites
Remove from Favorites - via -items flag
$ ./trakt-sync sync -t movies -a remove_from_favorites -items export_sync_favorites_movies.json

$ ./trakt-sync sync -t shows -a remove_from_favorites -items export_sync_favorites_shows.json

$ ./trakt-sync sync -t episodes -a remove_from_favorites -items export_sync_favorites_episodes.json

$ ./trakt-sync sync -t seasons -a remove_from_favorites -items export_sync_favorites_seasons.json
Remove from Favorites - via stdin
$ cat export_sync_favorites_movies.json | ./trakt-sync sync -t movies -a remove_from_favorites

$ cat export_sync_favorites_shows.json | ./trakt-sync sync -t shows -a remove_from_favorites

$ cat export_sync_favorites_episodes.json | ./trakt-sync sync -t episodes -a remove_from_favorites

$ cat export_sync_favorites_seasons.json | ./trakt-sync sync -t seasons -a remove_from_favorites

$ cat export_sync_favorites_all.json | ./trakt-sync sync -t seasons -a remove_from_favorites
Reorder Favorites - via -items flag
$ ./trakt-sync sync -a reorder_favorites -items export_sync_favorites_movies.json
Reorder Favorites - via stdin
$ cat export_sync_favorites_movies.json | ./trakt-sync sync -a reorder_favorites
Update Favorite item
$ ./trakt-sync sync -a update_favorite_item -list_item_id 97857 -notes "super 10/10"
Users:
Fetch settings for current user:
$ ./trakt-sync users -a settings
Following requests:
$ ./trakt-sync users -a following_requests
Follower requests:
$ ./trakt-sync users -a follower_requests
Approve Follower requests (with request id):
$ ./trakt-sync users -a follower_requests -follower_request 123
Deny Follower requests (with request id):
$ ./trakt-sync users -a follower_requests -follower_request 123 -deny
Fetch saved filters for selected user:
$ ./trakt-sync users -a saved_filters -u username
Export hidden items for a section (movie,show,season,user):
$ ./trakt-sync users -a hidden_items -t show -section calendar

$ ./trakt-sync users -a hidden_items -t show -section progress_watched

$ ./trakt-sync users -a hidden_items -t show -section progress_watched_reset

$ ./trakt-sync users -a hidden_items -t show -section progress_collected

$ ./trakt-sync users -a hidden_items -t show -section recommendations

$ ./trakt-sync users -a hidden_items -t show -section comments

$ ./trakt-sync users -a hidden_items -t show -section dropped
Add hidden items - via -items flag
$ ./trakt-sync users -a add_hidden_items -items export_users_all.json

$ ./trakt-sync users -a add_hidden_items -t movie -items export_users_all.json

$ ./trakt-sync users -a add_hidden_items -t show -items export_users_all.json

$ ./trakt-sync users -a add_hidden_items -t season -items export_users_all.json

$ ./trakt-sync users -a add_hidden_items -t user -items export_users_all.json
Add hidden items - via stdin
$ cat export_users_all.json | ./trakt-sync users -a add_hidden_items

$ cat export_users_all.json | ./trakt-sync users -a add_hidden_items -t movie

$ cat export_users_all.json | ./trakt-sync users -a add_hidden_items -t show

$ cat export_users_all.json | ./trakt-sync users -a add_hidden_items -t season

$ cat export_users_all.json | ./trakt-sync users -a add_hidden_items -t user
Remove hidden items - via -items flag
$ ./trakt-sync users -a remove_hidden_items -items export_users_all.json

$ ./trakt-sync users -a remove_hidden_items -t movie -items export_users_all.json

$ ./trakt-sync users -a remove_hidden_items -t show -items export_users_all.json

$ ./trakt-sync users -a remove_hidden_items -t season -items export_users_all.json

$ ./trakt-sync users -a remove_hidden_items -t user -items export_users_all.json
Remove hidden items - via stdin
$ cat export_users_all.json | ./trakt-sync users -a remove_hidden_items

$ cat export_users_all.json | ./trakt-sync users -a remove_hidden_items -t movie

$ cat export_users_all.json | ./trakt-sync users -a remove_hidden_items -t show

$ cat export_users_all.json | ./trakt-sync users -a remove_hidden_items -t season

$ cat export_users_all.json | ./trakt-sync users -a remove_hidden_items -t user
Fetch user profile:
$ ./trakt-sync users -a profile -u username
Fetch user likes:
$ ./trakt-sync users -a likes -u username

$ ./trakt-sync users -a likes -u username -ex comments
Fetch user collection:
$ ./trakt-sync users -a collection -u username

$ ./trakt-sync users -a collection -u username -ex comments

$ ./trakt-sync users -a collection -u username -t movies

$ ./trakt-sync users -a collection -u username -t shows
Fetch user comments:
$ ./trakt-sync users -a comments

$ ./trakt-sync users -a comments -comment_type all

$ ./trakt-sync users -a comments -comment_type reviews

$ ./trakt-sync users -a comments -comment_type shouts

$ ./trakt-sync users -a comments -t all -include_replies true

$ ./trakt-sync users -a comments -t movies -include_replies true

$ ./trakt-sync users -a comments -t shows -include_replies true

$ ./trakt-sync users -a comments -t seasons -include_replies true

$ ./trakt-sync users -a comments -t episodes -include_replies true

$ ./trakt-sync users -a comments -t lists -comment_type reviews  -include_replies true

$ ./trakt-sync users -a comments -t lists -comment_type reviews  -include_replies false

$ ./trakt-sync users -a comments -t lists -comment_type reviews  -include_replies only
Fetch user notes:
$ ./trakt-sync users -a notes

$ ./trakt-sync users -a notes -t all

$ ./trakt-sync users -a notes -t movies

$ ./trakt-sync users -a notes -t shows

$ ./trakt-sync users -a notes -t seasons

$ ./trakt-sync users -a notes -t episodes

$ ./trakt-sync users -a notes -t people

$ ./trakt-sync users -a notes -t history

$ ./trakt-sync users -a notes -t collection

$ ./trakt-sync users -a notes -t ratings
Export movies or shows or episodes from user lists:
$ ./trakt-sync users -a lists -u username -i 123456 -t episodes

$ ./trakt-sync users -a lists -u username -i 123456 -t shows

$ ./trakt-sync users -a lists -u username -i 123456 -t movies
Fetch lists for selected user:
$ ./trakt-sync users -a lists -u username
Create personal list for selected user - via -item flag:
$ ./trakt-sync users -a add_list -item personal_list.json
Create personal list for selected user - via stdin:
$ cat personal_list.json | ./trakt-sync users -a add_list
Reorder lists - via -items flag:
$ ./trakt-sync users -a reorder_lists -items personal_lists.json
Reorder lists - via stdin
$ cat personal_lists.json | ./trakt-sync users -a reorder_lists
Fetch lists a user can collaborate on:
$ ./trakt-sync users -a collaborations -u username
Fetch single personal list (Trakt ID or Trakt slug):
$ ./trakt-sync users -a list -u username -i 123456
Update single personal list (Trakt ID or Trakt slug):
$ ./trakt-sync users -a update_list -u username -i 123456 -description "short watchlist description" -sort_how asc

$ ./trakt-sync users -a update_list -u username -i 123456 -description "short watchlist description" -sort_by added

$ ./trakt-sync users -a update_list -u username -i 123456 -sort_by added -sort_how desc
Delete single personal list (Trakt ID or Trakt slug):
$ ./trakt-sync users -a delete_list -u username -i 123456
Fetch all users who liked a list (Trakt ID or Trakt slug):
$ ./trakt-sync users -a list_likes -u username -i 123456
Like a list (Trakt ID or Trakt slug):
$ ./trakt-sync users -a list_like -u username -i 123456
Remove like on a list (Trakt ID or Trakt slug):
$ ./trakt-sync users -a list_like -u username -i 123456 -delete
Get single personal list items (Trakt ID or Trakt slug):
$ ./trakt-sync sync -a list_items -u username -i 123456 -t movies -sort_how asc

$ ./trakt-sync sync -a list_items -u username -i 123456 -t movies -sort_how des

$ ./trakt-sync sync -a list_items -u username -i 123456 -t movies -sort_by rank

$ ./trakt-sync sync -a list_items -u username -i 123456 -t movies -sort_by added

$ ./trakt-sync sync -a list_items -u username -i 123456 -t movies -sort_by title

$ ./trakt-sync sync -a list_items -u username -i 123456 -t movies -sort_by released

$ ./trakt-sync sync -a list_items -u username -i 123456 -t movies -sort_by runtime

$ ./trakt-sync sync -a list_items -u username -i 123456 -t movies -sort_by popularity

$ ./trakt-sync sync -a list_items -u username -i 123456 -t movies -sort_by random

$ ./trakt-sync sync -a list_items -u username -i 123456 -t movies -sort_by percentage

🔥VIP Only including imdb_rating, tmdb_rating, rt_tomatometer, rt_audience, metascore, votes,
imdb_votes, and tmdb_votes. If sent for a non VIP, the items will fall back to rank.
Add items to personal list - via -items flag
$ ./trakt-sync users -u username -i 123456 -t movies -a add_list_items -items export_users_list_movies.json

$ ./trakt-sync users -u username -i 123456 -t shows -a add_list_items -items export_users_list_shows.json

$ ./trakt-sync users -u username -i 123456 -t episodes -a add_list_items -items export_users_list_episodes.json

$ ./trakt-sync users -u username -i 123456 -t seasons -a add_list_items -items export_users_list_seasons.json
Add items to personal list - via stdin
$ cat export_users_list_movies.json | ./trakt-sync users -u username -i 123456 -t movies -a add_list_items

$ cat export_users_list_shows.json | ./trakt-sync users -u username -i 123456 -t shows -a add_list_items

$ cat export_users_list_episodes.json | ./trakt-sync users -u username -i 123456 -t episodes -a add_list_items

$ cat export_users_list_seasons.json | ./trakt-sync users -u username -i 123456 -t seasons -a add_list_items

$ cat export_users_list_all.json | ./trakt-sync users -u username -i 123456 -t seasons -a add_list_items
Remove items from personal list - via -items flag
$ ./trakt-sync users -u username -i 123456 -t movies -a remove_list_items -items export_users_list_movies.json

$ ./trakt-sync users -u username -i 123456 -t shows -a remove_list_items -items export_users_list_shows.json

$ ./trakt-sync users -u username -i 123456 -t episodes -a remove_list_items -items export_users_list_episodes.json

$ ./trakt-sync users -u username -i 123456 -t seasons -a remove_list_items -items export_users_list_seasons.json
Remove items from personal list - via stdin
$ cat export_users_list_movies.json | ./trakt-sync users -u username -i 123456 -t movies -a remove_list_items

$ cat export_users_list_shows.json | ./trakt-sync users -u username -i 123456 -t shows -a remove_list_items

$ cat export_users_list_episodes.json | ./trakt-sync users -u username -i 123456 -t episodes -a remove_list_items

$ cat export_users_list_seasons.json | ./trakt-sync users -u username -i 123456 -t seasons -a remove_list_items

$ cat export_users_list_all.json | ./trakt-sync users -u username -i 123456 -t seasons -a remove_list_items
Reorder items from personal list - via -items flag
$ ./trakt-sync users -a reorder_list_items -items export_users_list_movies.json
Reorder items from personal list - via stdin
$ cat export_users_list_movies.json | ./trakt-sync users -a reorder_list_items
Update list item (notes):
$ ./trakt-sync users -a update_list_item -u username -i 27316587 -list_item_id 996953153 -notes "best romcom"
Get all list comments
$ ./trakt-sync users -a list_comments -i star-wars-in-machete-order -s likes

$ ./trakt-sync users -a list_comments -i star-wars-in-machete-order -s likes_30

$ ./trakt-sync users -a list_comments -i star-wars-in-machete-order -s replies

$ ./trakt-sync users -a list_comments -i star-wars-in-machete-order -s replies_30

$ ./trakt-sync users -a list_comments -i star-wars-in-machete-order -s plays

$ ./trakt-sync users -a list_comments -i star-wars-in-machete-order -s rating

$ ./trakt-sync users -a list_comments -i star-wars-in-machete-order -s added
List report
$ ./trakt-sync users -a list_report -u username -i star-wars-in-machete-order -r duplicate -message "Duplicate of another list"

$ ./trakt-sync users -a list_report -u username -i star-wars-in-machete-order -r remove -message "Should be removed from Trakt"

$ ./trakt-sync users -a list_report -u username -i star-wars-in-machete-order -r metadata -message "Metadata is wrong (name, description, etc)"

$ ./trakt-sync users -a list_report -u username -i star-wars-in-machete-order -r adult -message "Contains adult content"

$ ./trakt-sync users -a list_report -u username -i star-wars-in-machete-order -r language -message "Not in English"

$ ./trakt-sync users -a list_report -u username -i star-wars-in-machete-order -r spam -message "Spam or self-promotion"

$ ./trakt-sync users -a list_report -u username -i star-wars-in-machete-order -r other -message "Anything else"
Follow user:
$ ./trakt-sync users -a follow -u username
Unfollow user:
$ ./trakt-sync users -a unfollow -u username
Get blocked users
$ ./trakt-sync users -a blocked_users
Block user
$ ./trakt-sync users -a block -u username
Unblock user
$ ./trakt-sync users -a unblock -u username
Get followers
$ ./trakt-sync users -a followers -u username
Get following
$ ./trakt-sync users -a following -u username
Get friends
$ ./trakt-sync users -a friends -u username
Get history last 7 days
$ ./trakt-sync users -a history -u username -start_at 2025-06-01 -end_at 2025-06-07
Get history filter by type
$ ./trakt-sync users -a history -u username -t movies

$ ./trakt-sync users -a history -u username -t shows

$ ./trakt-sync users -a history -u username -t seasons

$ ./trakt-sync users -a history -u username -t episodes
Get history filter for specific item
$ ./trakt-sync users -a history -u username -item_id 123456
Get user ratings - movies - all ratings
$ ./trakt-sync users -a ratings -t movies
Get user ratings - shows - filter for specific rating from 1 to 10
$ ./trakt-sync users -a ratings -t shows -rating 1,2,3
Get user ratings - seasons
$ ./trakt-sync users -a ratings -t seasons
Get user ratings - episodes
$ ./trakt-sync users -a ratings -t episodes
Get user ratings - all ratings
$ ./trakt-sync users -a ratings -t all
Get user watchlist
$ ./trakt-sync users -a watchlist -u username -t movies -sort_how asc

$ ./trakt-sync users -a watchlist -u username -t movies -sort_how des

$ ./trakt-sync users -a watchlist -u username -t movies -sort_by rank

$ ./trakt-sync users -a watchlist -u username -t movies -sort_by added

$ ./trakt-sync users -a watchlist -u username -t movies -sort_by title

$ ./trakt-sync users -a watchlist -u username -t movies -sort_by released

$ ./trakt-sync users -a watchlist -u username -t movies -sort_by runtime

$ ./trakt-sync users -a watchlist -u username -t movies -sort_by popularity

$ ./trakt-sync users -a watchlist -u username -t movies -sort_by random

$ ./trakt-sync users -a watchlist -u username -t movies -sort_by percentage

🔥VIP Only sort_by including imdb_rating, tmdb_rating, rt_tomatometer, rt_audience, metascore, votes,
imdb_votes, and tmdb_votes. If sent for a non VIP, the items will fall back to rank.
Get user watchlist comments
$ ./trakt-sync users -a watchlist_comments -u username -s likes

$ ./trakt-sync users -a watchlist_comments -u username -s likes_30

$ ./trakt-sync users -a watchlist_comments -u username -s replies

$ ./trakt-sync users -a watchlist_comments -u username -s replies_30

$ ./trakt-sync users -a watchlist_comments -u username -s plays

$ ./trakt-sync users -a watchlist_comments -u username -s rating

$ ./trakt-sync users -a watchlist_comments -u username -s added
Get user favorites
$ ./trakt-sync users -a favorites -t movies -sort_how asc

$ ./trakt-sync users -a favorites -t movies -sort_how des

$ ./trakt-sync users -a favorites -t movies -sort_by rank

$ ./trakt-sync users -a favorites -t movies -sort_by added

$ ./trakt-sync users -a favorites -t movies -sort_by title

$ ./trakt-sync users -a favorites -t movies -sort_by released

$ ./trakt-sync users -a favorites -t movies -sort_by runtime

$ ./trakt-sync users -a favorites -t movies -sort_by popularity

$ ./trakt-sync users -a favorites -t movies -sort_by random

$ ./trakt-sync users -a favorites -t movies -sort_by percentage


🔥VIP Only sort_by including imdb_rating, tmdb_rating, rt_tomatometer, rt_audience, metascore, votes,
imdb_votes, and tmdb_votes. If sent for a non VIP, the items will fall back to rank.
Get user favorites comments
$ ./trakt-sync users -a favorites_comments -u username -s likes

$ ./trakt-sync users -a favorites_comments -u username -s likes_30

$ ./trakt-sync users -a favorites_comments -u username -s replies

$ ./trakt-sync users -a favorites_comments -u username -s replies_30

$ ./trakt-sync users -a favorites_comments -u username -s plays

$ ./trakt-sync users -a favorites_comments -u username -s rating

$ ./trakt-sync users -a favorites_comments -u username -s added
Get user watching
$ ./trakt-sync users -a watching -u username
Fetch watched movies for selected user:
$ ./trakt-sync users -a watched -t movies -u sean
Fetch watched shows for selected user:
$ ./trakt-sync users -a watched -t shows -u sean
Fetch watched shows for selected user without seasons:
$ ./trakt-sync users -a watched -t shows -u sean --ex noseasons
Fetch stats for selected user:
$ ./trakt-sync users -a stats -u sean
Report user:
$ ./trakt-sync users -a report -u username -r duplicate -message "Duplicate of another list"

$ ./trakt-sync users -a report -u username -r remove -message "Should be removed from Trakt"

$ ./trakt-sync users -a report -u username -r metadata -message "Metadata is wrong (name, description, etc)"

$ ./trakt-sync users -a report -u username -r adult -message "Contains adult content"

$ ./trakt-sync users -a report -u username -r language -message "Not in English"

$ ./trakt-sync users -a report -u username -r spam -message "Spam or self-promotion"

$ ./trakt-sync users -a report -u username -r other -message "Anything else"
Watchlist
Export all movies from watchlist:
$ ./trakt-sync watchlist -t movies -f tmdb -> export_watchlist_movies_tmdb.json

$ ./trakt-sync watchlist -t movies -f imdb -> export_watchlist_movies_imdb.json

License

MIT

Documentation

Overview

Package main github.com/mfederowicz/trakt-sync.

Source Files

View all Source files

Directories

Path Synopsis
Package buffer used to write buffer bytes and printout logs if exists
 Package buffer used to write buffer bytes and printout logs if exists
Package cfg used for process configuration
 Package cfg used for process configuration
Package cli for basic cli functions
 Package cli for basic cli functions
Package cmds used for commands modules
 Package cmds used for commands modules
Package consts used to store const for application
 Package consts used to store const for application
Package handlers used to handle module actions
 Package handlers used to handle module actions
Package internal used for client and services
 Package internal used for client and services
Package printer is replacement for fmt.* functions
 Package printer is replacement for fmt.* functions
Package str used for structs
 Package str used for structs
Package test used for process tests
 Package test used for process tests
Package uri used for url operations
 Package uri used for url operations
Package writer used for write operations
 Package writer used for write operations

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.