go install github.com/mfederowicz/trakt-sync@latestAfter 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 = 10trakt-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.
trakt-sync accepts the following command line parameters:
-config [PATH]- path to config file in TOML format, defaults to$HOME/trakt-sync.tomlif present.-version- get trakt-sync version.
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 listcheckin- Checkin movie,episode,show_episode,deletecollection- Get all collected items in a user's collection.comments- Comments comments,comment,replies,item,likes,like,trending,recent,updates.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 networksnotes- Manage notes created by userpeople- Returns all data for selected person.recommendations- Recommendations manage movie and shows recommendations for userscrobble- Scrobble for start/pause/stop movie,show,episodesearch- 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...users- Returns all data for a user.watchlist- Returns all items in a user's watchlist filtered by type.
$ ./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$ ./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$ ./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 $ ./trakt-sync collection -t movies --ex metadata$ ./trakt-sync collection -t shows --ex metadata$ ./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$ ./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$ ./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$ ./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$ ./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$ ./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 $ ./trakt-sync movies -a trending$ ./trakt-sync movies -a popular$ ./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$ ./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$ ./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$ ./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$ ./trakt-sync movies -a anticipated$ ./trakt-sync movies -a boxoffice$ ./trakt-sync movies -a updates -start_date YYYY-MM-DD$ ./trakt-sync movies -a updated_ids -start_date YYYY-MM-DD$ ./trakt-sync movies -a summary -i the-sopranos$ ./trakt-sync movies -a aliases -i the-sopranos$ ./trakt-sync movies -a releases -i the-sopranos -country us$ ./trakt-sync movies -a translations -i the-sopranos -language es$ ./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$ ./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$ ./trakt-sync movies -a people -i the-sopranos$ ./trakt-sync movies -a ratings -i the-sopranos$ ./trakt-sync movies -a related -i the-sopranos$ ./trakt-sync movies -a stats -i the-sopranos$ ./trakt-sync movies -a studios -i the-sopranos$ ./trakt-sync movies -a watching -i the-sopranos$ ./trakt-sync movies -a videos -i the-sopranos$ ./trakt-sync movies -a refresh -i the-sopranos$ ./trakt-sync networks -a list$ ./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"$ ./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"$ ./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$ ./trakt-sync notes -a item -i 97854$ ./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$ ./trakt-sync recommendations -a movies -i black-bag-2025 -hide $ ./trakt-sync recommendations -a movies $ ./trakt-sync recommendations -a movies -ignore_collected true -ignore_watchlisted true $ ./trakt-sync recommendations -a shows -i wellington-paranormal -hide$ ./trakt-sync recommendations -a shows $ ./trakt-sync recommendations -a shows -ignore_collected false -ignore_watchlisted false $ ./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$ ./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$ ./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$ ./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$ ./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$ ./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$ ./trakt-sync shows -a trending$ ./trakt-sync shows -a popular$ ./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$ ./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$ ./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$ ./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$ ./trakt-sync shows -a anticipated$ ./trakt-sync shows -a updates -start_date YYYY-MM-DD$ ./trakt-sync shows -a updated_ids -start_date YYYY-MM-DD$ ./trakt-sync shows -a summary -i the-sopranos$ ./trakt-sync shows -a aliases -i the-sopranos$ ./trakt-sync shows -a certifications -i the-sopranos$ ./trakt-sync shows -a translations -i the-sopranos -language es$ ./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$ ./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$ ./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$ ./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$ ./trakt-sync shows -a reset_show_progress -i the-sopranos$ ./trakt-sync shows -a reset_show_progress -i the-sopranos -undo$ ./trakt-sync shows -a people -i the-sopranos
$ ./trakt-sync shows -a people -i the-sopranos -ex guest_stars$ ./trakt-sync shows -a ratings -i the-sopranos$ ./trakt-sync shows -a related -i the-sopranos$ ./trakt-sync shows -a studios -i the-sopranos$ ./trakt-sync shows -a watching -i the-sopranos$ ./trakt-sync shows -a next_episode -i the-sopranos$ ./trakt-sync shows -a last_episode -i the-sopranos$ ./trakt-sync shows -a videos -i the-sopranos$ ./trakt-sync shows -a refresh -i the-sopranos$ ./trakt-sync seasons -a summary -i the-sopranos -ex full$ ./trakt-sync seasons -a season -i the-sopranos -season 1 -ex full$ ./trakt-sync seasons -a episodes -i the-sopranos -season 1 -translations es -ex full$ ./trakt-sync seasons -a translations -i the-sopranos -season 1 $ ./trakt-sync seasons -a translations -i the-sopranos -season 1 -language en$ ./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$ ./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$ ./trakt-sync seasons -a people -i the-sopranos -season 1$ ./trakt-sync seasons -a ratings -i the-sopranos -season 1$ ./trakt-sync seasons -a related -i the-sopranos -season 1$ ./trakt-sync seasons -a stats -i the-sopranos -season 1$ ./trakt-sync seasons -a watching -i the-sopranos -season 1$ ./trakt-sync seasons -a videos -i the-sopranos -season 1$ ./trakt-sync episodes -a summary -i the-sopranos -season 1 -episode 1 -ex full$ ./trakt-sync episodes -a translations -i the-sopranos -season 1 -episode 1 $ ./trakt-sync episodes -a translations -i the-sopranos -season 1 -episode 1 -language en$ ./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$ ./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$ ./trakt-sync episodes -a people -i the-sopranos -season 1 -episode 1$ ./trakt-sync episodes -a ratings -i the-sopranos -season 1 -episode 1$ ./trakt-sync episodes -a related -i the-sopranos -season 1 -episode 1$ ./trakt-sync episodes -a stats -i the-sopranos -season 1 -episode 1$ ./trakt-sync episodes -a watching -i the-sopranos -season 1 -episode 1$ ./trakt-sync episodes -a videos -i the-sopranos -season 1 -episode 1$ ./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$ ./trakt-sync users -a lists -u username $ ./trakt-sync users -a saved_filters -u username $ ./trakt-sync users -a stats -u sean $ ./trakt-sync users -a settings $ ./trakt-sync users -a watched -t movies -u sean $ ./trakt-sync users -a watched -t shows -u sean $ ./trakt-sync users -a watched -t shows -u sean --ex noseasons$ ./trakt-sync watchlist -t movies -f tmdb -> export_watchlist_movies_tmdb.json $ ./trakt-sync watchlist -t movies -f imdb -> export_watchlist_movies_imdb.json