Skip to content

Latest commit

 

History

History
971 lines (724 loc) · 93 KB

CHANGELOG.md

File metadata and controls

971 lines (724 loc) · 93 KB

Changelog

All notable changes to this project are documented here, in the Keep a Changelog format.

Versioning follows SemVer:

  • Major (X.0.0) - breaking changes to the CLI surface: a removed or renamed module, action or flag, or a changed output file name or JSON shape that scripts may depend on. Exception: a flag that was deprecated in an earlier release and had no effect may be removed in a minor release, listed under ### Removed.
  • Minor (1.X.0) - a module or action lands (new endpoints/commands), or other user-facing behavior changes in a compatible way.
  • Patch (1.15.X) - bug fixes, CI/tooling changes, docs-only changes, refactors with no behavior change.

The Go library (trakt, str, uri) follows the same version numbers:

  • While it is experimental (now) - breaking changes to its Go API (a removed or renamed exported identifier, a changed signature, or a behavior callers rely on) may land in a minor release. They are listed under ### Changed or ### Removed with a Library: prefix. New exported identifiers are minor, fixes are patch, as for the CLI.
  • Once it is declared stable (the maintainer's call; the README and the trakt package docs will say so) - a breaking change to its Go API needs a major version.
  • Any major version, CLI or library, also changes the module path to github.com/mfederowicz/trakt-sync/v2 (Go modules ignore v2+ tags without it).

A version is tagged once a module (or a meaningful fix) is done - there's no fixed release schedule.

Added

  • younify -a refresh -skip_sync sends skip_sync: Trakt only marks the service as synced now and ignores history from before this moment. Younify is open only to Trakt's own apps for now (403), so this is untested against the live API.
  • Library: YounifyService.RefreshServiceByBody for POST /younify/users/refresh (the service named in the body), with the new str.YounifyRefreshService.
  • users -a add_list_items and sync -a add_to_watchlist send the notes of each movie, show, season and episode in -items, so a list exported with its notes keeps them when it is added again. Trakt saves them only for VIP list owners, so this is tested against a mock server only.
  • Library: str.AttachedTo has WatchedAt, CollectedAt, RatedAt and Rating, and str.CommentMediaItem has Person, Comment and User, as described in Trakt's API since 2026-11-19.
  • Library: str.UserStats has ListComments, the number of comments on the user's lists.

Changed

  • movies -a hot and movies -a streaming are locked: Trakt removed both charts from its API on 2026-11-17, after the live API had answered 404 for months. The actions send no request and stop with movies -a hot is locked since 2026-11-17: Trakt removed this endpoint from its API, the live API no longer serves it; no request was sent; the action names stay.
  • Library: MoviesService.GetHotMovies and GetStreamingMovies are marked deprecated and return a *trakt.EndpointRemovedError without sending a request. They will be removed in a later release.
  • users -a plex_connect, plex_servers, plex_server and plex_sync are locked: Trakt removed these Plex routes from its API on 2026-11-18, and the live API already answered 404. The actions send no request and stop with users -a plex_servers is locked since 2026-11-18: Trakt removed this endpoint from its API, the live API no longer serves it; no request was sent; the action names stay. plex_settings, update_plex_settings and plex_disconnect are unchanged.
  • movies -a refresh, shows -a refresh, people -a refresh, search -a remove_recent and social_recommendations -a movies / -a shows are locked: Trakt dropped these endpoints from its API contract on 2026-10-13, and on 2026-11-20 the live API answered 404. The actions send no request and stop with movies -a refresh is locked since 2026-11-20: Trakt removed this endpoint from its API, the live API no longer serves it; no request was sent; the action names stay.
  • users -a add_saved_filters and delete_saved_filter are locked: Trakt dropped both endpoints from its API contract on 2026-10-13, and on 2026-11-20 the live API answered 410 saved_filters_retired. The actions send no request and stop with users -a add_saved_filters is locked since 2026-11-20: Trakt retired saved filters, the live API answers 410 saved_filters_retired; no request was sent. users -a saved_filters is unchanged.
  • Library: MoviesService.RefreshMovieMetadata, ShowsService.RefreshShowMetadata, PeopleService.RefreshPersonMetadata, SearchService.RemoveRecentSearch, SocialRecommendationsService.GetSocialMovieRecommendations and GetSocialShowRecommendations, and UsersService.AddSavedFilters and DeleteSavedFilter return a *trakt.EndpointRemovedError without sending a request. They were already marked deprecated and will be removed in a later release.
  • users -a list_comments, watchlist_comments and favorites_comments without -s no longer send likes: they send no sort and Trakt returns the comments newest first, its default since 2026-11-17. Add -s likes for the old order.
  • Library: UsersService.GetListComments, GetWatchlistComments and GetFavoritesComments leave the /{sort} segment out for an empty sort; before, they asked for .../comments/ with a trailing slash.
  • Library: YounifyService.RefreshService takes a fourth argument, refresh *str.YounifyRefresh (SkipSync); pass nil to send no body as before.
  • Library: UsersService.ConnectPlex, GetPlexServers, GetPlexServerAccounts and SyncPlex are marked deprecated and return a *trakt.EndpointRemovedError without sending a request. They will be removed in a later release.
  • users -a collection no longer sends the media and parental filters (-genres, -years, -watchnow, -languages, -parental_*, ...) and no longer checks their values. Trakt never applied them on this route and removed them from its API contract on 2026-11-17; the export is the same as before. When one is set, the action prints users -a collection: Trakt does not filter a collection, the media filters were not sent.
  • Library: str.MinimalCollection (and so str.MinimalShowCollection) maps to the new *str.MinimalCollected instead of *str.Timestamp; it holds CollectedAt and, when Trakt sent one, Source (plex, jellyfin or empty).
  • Library: Seasons and Episodes in str.ResultNotFound and str.CollectionResultNotFound are *[]str.Show instead of *[]str.Season and *[]str.Episodes: Trakt reports a season or episode it did not find under a show as that show, holding only the missing season or episode.

Fixed

  • sync -a get_minimal_collection -available_on other works, and so does -available_on digital for items with a source: Trakt sends each value as collected_at|source when -available_on is set, and the export keeps that form, such as "2002-07-19T21:00:00Z|plex" or "2002-07-19T21:00:00Z|". Before, the action stopped with invalid timestamp format.
  • The not_found part of the export from sync -a add_to_* and remove_from_* (history, collection, ratings, watchlist, favorites) and from users -a add_hidden_items, remove_hidden_items, add_list_items and remove_list_items keeps the show and the season or episode that was not found. Before, a missing season kept only the show's ids, without the season number, and a missing episode was written as {}.
  • sync -a get_up_next and get_up_next_nitro page until Trakt returns an empty page, capped by pages_limit. Trakt sends placeholder X-Pagination-Page-Count values on these routes (documented in its API on 2026-11-18), and the actions used to stop when that count said the last page was reached, which could leave shows out of the export.
  • users -a notes keeps watched_at, collected_at, rated_at and rating in attached_to, so a note on a history, collection or rating entry shows when the item was watched, collected or rated. Before, the export kept only type and id.
  • comments -a item keeps the person, comment or user a comment belongs to. Before, the export of such a comment held only its type.
  • users -a stats keeps list_comments, the number of comments on the user's lists. Before, the export left it out.
  • users -a stats prints users -a stats: Trakt has no stats for <user> (stats are computed for VIP users only), nothing was written and writes no file when Trakt answers 204 No Content, as its API documents for users without precomputed stats. Before, it printed Found <user> user stats and wrote {}. Stats are VIP only: for a non-VIP account the live API currently sends all counts as 0, which is exported as is; docs/users.md now says so.

1.31.0 - 2026-11-15

Added

  • users -a watchlist -ignore_watched true leaves out what you already watched, on both the -sort_by and the -sort route; ignore_watched = true in the config file applies to it too. -ignore_collected and -ignore_watchlisted stay off the watchlist, because the live API ignores them there.

Fixed

  • lists -a comments takes -s likes, replies, newest or oldest and stops on any other value before the request. It used to send every -s value as is, and Trakt answered all others with 400.
  • users -a watchlist_comments, favorites_comments and list_comments take -s likes, replies, newest or oldest, the sorts Trakt accepts. They used to allow likes_30, replies_30, plays, rating and added, which Trakt rejects with 400 invalid_sort, and refused newest and oldest.

1.30.0 - 2026-11-14

Changed

  • When Trakt answers with an empty list, the list actions of movies, shows, people (lists, updates, updated_ids), networks, lists and comments now write [] to the output file and exit with 0. Before, they stopped with an error such as empty shows (exit 1) and wrote no file, so a filter that matches nothing, like shows -a anticipated -parental_violence 0-0, looked like a failure.
  • The same now holds for calendars (every action), media (trending, popular, anticipated, anticipated_recommendations), movies and shows -a anticipated_recommendations, recommendations, social_recommendations, smart_lists (items, templates), team -a members, watchnow -a sources and younify -a connections: an empty list writes [] and exits with 0 instead of stopping with empty result.
  • users and sync follow too: users -a watchlist, favorites, history, ratings, collection, activities, comment_reactions, comments, likes, notes, lists (the overview, and the items of a list given with -i), list_items, list_likes, list_comments, collaborations, blocked_users, followers, following, friends, saved_filters, smart_lists, data_syncs, data_sync_paused, data_sync_skipped, and sync -a get_watchlist and get_favorites write [] for an empty list and exit with 0; users -a plex_servers writes {} when there are no servers. Before, they stopped with an error such as empty watchlist, empty result or no paused items in data sync 157.

Fixed

  • docs/users.md: users -a hidden_items -t user -section comments no longer says the export is always []; since 2026-11-14 Trakt lists the hidden users, and the export keeps each one as "type": "user" with a user object.
  • users -a data_syncs, data_sync, data_sync_paused, data_sync_skipped and undo_data_sync explain a 403 like a 401: Trakt answered 403 ...; this route is not open to API apps yet. Since 2026-11-14 Trakt answers GET /users/syncs/ with 403 instead of 401 for API apps, and the CLI showed only the raw error.
  • Library: str.Movie sends and reads Notes under the contract key notes; it used note, so Trakt ignored the notes of a movie added with SyncService.AddItemsToWatchlist, AddItemsToFavorites or UsersService.AddListItems. The CLI does not send item notes, so its output does not change.
  • sync -a update_favorites sends only the settings you give (-description, -sort_by, -sort_how). Before, a setting without its flag was sent with its default, so -description alone reset the sort to rank/asc and -sort_by alone cleared the description. With none of the three it now stops with a message instead of sending a request.
  • sync -a update_watchlist sends only the settings you give (-description, -sort_by, -sort_how), like update_favorites. Before, a setting without its flag was sent with its default, so -description alone reset the sort to rank/asc and -sort_by alone cleared the description. With none of the three it now stops with a message instead of sending a request.

1.29.0 - 2026-11-12

Added

  • movies, shows and media -a anticipated_recommendations: unreleased titles ranked for your taste (at most 100), each with a score and its released date. Needs your login. Library: MoviesService, ShowsService and MediaService have GetAnticipatedRecommendations, returning the new type str.AnticipatedRecommendation.

  • smart_lists -a items takes -awards (award slugs, like oscars-best-picture), -award_years (ceremony year range) and -award_won (only the winners); the last two need -awards. The users smart list actions (smart_lists, smart_list, add_smart_list, update_smart_list) keep awards, award_years and award_won in filters, for export and for sending. Library: str.SmartListFilters has the fields Awards, AwardYears and AwardWon, uri.SmartListItemsOptions has Awards, AwardYears and AwardWon, and str.Options has Awards, AwardYears and AwardWon.

  • people -a summary takes -language (like pt or pt-br) to pick the language of the person's Wikipedia page; a code Trakt rejects gets a readable error. With -ex full the export's social_ids now keeps tiktok, youtube, wikidata and wikipedia_language. Library: uri.ListOptions has the field Language, sent as language, and str.SocialIDs has TikTok, YouTube, Wikidata and WikipediaLanguage.

Fixed

  • users -a stats export keeps progress (started, finished and dropped shows), lists, total_minutes and total_plays; they were dropped from the JSON file before. Library: str.UserStats has the fields Progress (new type str.UserStatsProgress), Lists, TotalMinutes and TotalPlays.
  • users -a plex_servers explains the 405 Trakt has answered since 2026-10-31 (the API docs still list the route as GET) instead of printing a bare 405 error.
  • users -a add_saved_filters and users -a delete_saved_filter no longer print "VIP only": the live API accepted both from a non-VIP account (checked 2026-11-08).
  • docs/movies.md: the movies examples used the show slug the-sopranos; they now use the movie tron-legacy-2010.

1.28.0 - 2026-11-04

Added

  • Parental guide filters on every list that takes the media filters: -parental_nudity, -parental_violence, -parental_profanity, -parental_alcohol and -parental_frightening, each a severity range min-max from 0 (none) to 3 (severe) such as -parental_violence 0-1, and -parental_include_unrated to keep titles without a parental guide. They work on the movies and shows lists (trending, popular, anticipated, ...), calendars, lists, media, recommendations and users -a watchlist|history|collection|list_items|activities, as on smart_lists -a items before. A range outside 0-3 stops the run before any request. The live API applied all five on movies and shows -a popular (checked 2026-10-31).
  • Library: uri.MediaFilters and uri.SocialActivityOptions have the fields ParentalAlcohol, ParentalFrightening, ParentalIncludeUnrated, ParentalNudity, ParentalProfanity and ParentalViolence.
  • sync -a get_up_next_nitro takes the parental guide filters too (-parental_nudity, -parental_violence, -parental_profanity, -parental_alcohol, -parental_frightening, -parental_include_unrated). Library: uri.UpNextNitroOptions has the same six Parental* fields.
  • movies -a related and shows -a related take -personalized, which asks Trakt to re-order the related titles toward your taste. Trakt applies it only for VIP accounts and ignores it otherwise (mock-tested; the test account is not VIP). Library: uri.ListOptions has the field Personalized, sent as personalized=true, and str.Options has Personalized.

Changed

  • younify: a 403 from Trakt now ends with younify is not open to API apps yet, like a 401 did; on 2026-10-31 Trakt answered younify -a connections with 403 instead of 401.
  • users -a activities: a 403 from Trakt now ends with activities is limited access on Trakt and not available for this API app instead of a bare 403. Since 2026-10-31 Trakt answers the route with 403 (401 before), and the contract limits it to Trakt's own apps.

Fixed

  • younify -a refresh -all_data: the full re-sync was sent to .../refresh/<service_id>/all_data; the Trakt contract wants .../refresh/<service_id>/true, so the request now goes there.
  • shows -a reset_show_progress: a successful reset printed nothing, because Trakt answers it with 201 and only 200 was treated as success; it now prints result: success with the stored reset_at (mock-tested; the route is VIP only).
  • sync -a add_to_ratings -t shows or -t all with an export that also holds season or episode ratings: the show was sent with the rating of whichever of its items came first, such as an episode rated 7 instead of the show's own 9; with -t shows its season ratings were dropped and its episode ratings went inside the show, where Trakt rates those instead of the show. A show now gets only its own rating and rated_at; with -t all seasons and episodes still go in their own lists.
  • sync -a add_to_collection: the hdr value from an export made with -ex metadata was never sent, while Trakt clears collection metadata that a request leaves out (per its API contract since 2026-11-03), so re-adding an export could drop the HDR format of every item; hdr is now sent with the other metadata. An export of -t shows made without -ex metadata crashed add_to_collection -t shows with a nil pointer error; it now sends those episodes without metadata.
  • Library: the UpdateCollectedData methods of str.ExportlistItem, str.Movie, str.Show, str.Season and str.Episode copy Metadata.Hdr, and ExportlistItem.UpdateCollectedData no longer panics on a season episode without metadata or collected_at.

Deprecated

  • people -a lists: Trakt marked the endpoint deprecated in its API contract on 2026-10-20, because lists no longer hold people and it always returns no lists (checked again 2026-10-31). The action still sends its request but now prints people -a lists is deprecated since 2026-10-20: Trakt deprecated this endpoint: lists no longer hold people, so it always returns no lists first. In a later release it will stop sending the request; the action name stays.
  • Library: PeopleService.GetListsContainingThisPerson is marked deprecated. It still sends its request; in a later release it will return a *trakt.EndpointRemovedError instead, and then be removed.

1.27.0 - 2026-10-17

Added

  • Show exports (such as shows -a summary -ex full) keep the new ending field: concluded when a canceled or ended show was finished on purpose, open when it was cut off, absent while it is unknown or the show still airs. Library: str.Show.Ending.
  • Docs: -ex markdown on movies, shows, seasons and episodes -a people and on a person search (search -a text_query -t person) adds markdown links to the person biographies; the flag already reached the API before.
  • smart_lists -a templates: the official smart list templates (id, source, media type, filters, and the total plus up to 3 items for templates that do not depend on the viewer), written to export_smart_lists_templates.json. Library: SmartListsService.GetSmartListTemplates, str.SmartListTemplate.
  • sync -a get_collection -ex available_on keeps the available_on source list (such as plex or digital) on collected movies, episodes and the episodes of collected shows; the export dropped it before. The empty list Trakt sends on every item is left out. Library: str.AvailableOn, str.ExportlistItem.AvailableOn, str.Episode.AvailableOn.

Fixed

  • sync -a get_minimal_collection -available_on takes the values of the current Trakt contract, digital (items synced from a connected media server) and other; before it rejected both and accepted only plex. plex still works while the live API applies it. Trakt currently answers other with malformed dates, so it fails with invalid timestamp format until Trakt fixes it (see docs/sync.md).

1.26.0 - 2026-10-14

Added

  • users -a smart_list_drafts lists your personal lists that stopped updating and are ready to become smart lists; users -a smart_list_draft -i <list> returns the ready-made smart list setup for one of them; users -a convert_to_smart_list -i <list> turns the list into a smart list from the same JSON add_smart_list takes (-items file or stdin).
  • users -a year_in_review_persona -year <2026 or later> exports the watching persona of a year in review. Trakt marks it VIP only: a non-VIP account gets year_in_review_persona is VIP only (checked live), the export itself was tested against a mock server only.
  • Library: UsersService.GetSmartListDrafts, GetSmartListDraft, ConvertListToSmartList and GetYearInReviewPersona, with the types str.SmartListDraftsSummary, str.SmartListDraft, str.SmartListDraftList, str.SmartListDraftConverted, str.ReviewPersona, str.ReviewPersonaHighlight, str.ReviewPersonaStreak and str.ReviewPersonaMonth.
  • smart_lists -a items takes nine more filters: -studios, -people, -people_operator and|or, -people_role any|cast|directing|writing|producing, -released_within_days <1-3650>, -tmdb_ratings, -metascores, -votes and -imdb_votes. A value of a list filter that starts with - is left out of the result, such as -studios pixar,-dreamworks-animation.
  • users -a add_smart_list, update_smart_list and convert_to_smart_list accept the filters keys studios, people, people_operator, people_role, released_within_days, tmdb_ratings, metascores, votes and imdb_votes. Before, a body with one of them stopped with invalid smart list JSON, and users -a smart_list and smart_lists -a summary left them out of the export.
  • Library: str.SmartListFilters has the fields Studios, People, PeopleOperator, PeopleRole, ReleasedWithinDays, TmdbRatings, Metascores, Votes and ImdbVotes; uri.SmartListItemsOptions has the same nine as query parameters.
  • List exports (such as users -a lists and lists -a list) keep two new fields: stale_origin (name and url of the tool that stopped updating your list, shown to the owner only) and converted_to (ids of the smart list the list was turned into). watchnow -a sources keeps the type of a source (free, tv_everywhere, subscription, purchase or cinema).
  • Library: str.PersonalList has the fields StaleOrigin (new type str.ListStaleOrigin) and ConvertedTo; str.WatchNowSource has Type.
  • -theme <name> on movies, shows and media -a trending|popular|anticipated and on recommendations -a movies|shows: a seasonal theme such as halloween or christmas, which Trakt turns into filters for the list. A filter you set yourself wins over the theme, and an unknown theme is ignored.
  • Library: uri.ListOptions.Theme, the theme query parameter of those routes.
  • List exports keep images (the list posters) with -ex images: lists -a trending, lists -a popular, lists -a list, users -a list and users -a lists. Library: str.PersonalList.Images.
  • users -a lists and lists -a list send -ex; before, the flag had no effect on them.
  • people -a summary keeps the new summary field, a short summary of the person next to the longer biography (with markdown links under -ex full,markdown). Library: str.Person.Summary.
  • Library: trakt.EndpointRemovedError, returned without a request by a method whose Trakt endpoint is locked or removed; its Notice holds the endpoint and the dates it was deprecated, locked and removed. The notices live in the new package deprecation (Lookup, LookupRoute, Notices). No endpoint is locked yet.

Changed

  • Library: ListsService.GetList takes the query options as a third argument, GetList(ctx, id, opts); pass nil for none.
  • users -a lists pages through the lists overview: it sends page and limit and follows per_page and pages_limit from the config file, like the other paged actions. With the defaults (100 per page, 2 pages) it reads up to 200 lists; -i must name a list on those pages.
  • smart_lists -a items -watchnow takes a service name such as netflix and the - prefix that leaves a service out (-watchnow=-netflix), next to favorites, any, free and subscriptions. The value is no longer checked against a fixed list before the request.

Fixed

  • users -a lists without -i ended with exit status 1 and please set personal listid, although it had written the lists overview. It now ends with exit status 0 and prints how to export the items of one list (-i <list id>). An -i that is not one of your lists still stops with an error.
  • users -a update_list reset the settings you did not give: every run sent privacy as private, allow_comments as off, sort_by as rank and sort_how as asc, so changing only the description also changed those four. A setting is now sent only when its flag is given (-privacy, -allow_comments, -display_numbers, -sort_by, -sort_how); without the flag the list keeps the value it has.
  • users -a update_list -display_numbers had no effect: the setting was sent under the wrong name, display_strings. It is now sent as display_numbers (-display_numbers, or -display_numbers=false to turn it off). List exports (such as users -a lists and lists -a list) left display_numbers out and now keep it.
  • Library: str.PersonalList.DisplayNumbers has the JSON name display_numbers; it was display_strings, so the field was never read and was written under a name the API does not know.

Deprecated

  • Trakt dropped nine endpoints from its API contract on 2026-10-13. They still answer (checked that day), so their actions keep working, but each now prints a notice first, such as movies -a refresh is deprecated since 2026-10-13: Trakt dropped this endpoint from its API contract, it may stop working: movies -a refresh, shows -a refresh, people -a refresh, search -a remove_recent, users -a add_saved_filters, users -a delete_saved_filter, sync -a update_favorites, and social_recommendations -a movies and -a shows (the whole module). In a later release these actions will stop sending the request and only print their status; the action names stay. refresh_justwatch and younify -a refresh are not affected.
  • Library: the methods of those endpoints are marked deprecated: MoviesService.RefreshMovieMetadata, ShowsService.RefreshShowMetadata, PeopleService.RefreshPersonMetadata, SearchService.RemoveRecentSearch, UsersService.AddSavedFilters, UsersService.DeleteSavedFilter, SyncService.UpdateFavorites, SocialRecommendationsService.GetSocialMovieRecommendations and GetSocialShowRecommendations. They still send their request; in a later release they will return a *trakt.EndpointRemovedError instead, and then be removed.

Removed

  • The flags deprecated in 1.22.0 are gone: -query (use search -q), -studio_ids (the Trakt API has no such filter), notes -notes_id (use notes -i) and scrobble -delete (it never did anything). None of them had any effect; using one now stops the run with flag provided but not defined.
  • Library: the uri.ListOptions fields EpisodeTypes, Metascores, NetworkIDs, StudioIDs and TmdbRatings, deprecated in 1.22.0, are gone, together with the types uri.RatingRangeFloat and uri.TmdbRatingRange that only they used. The Trakt API has no such query parameters and the CLI never sent them.
  • Library: the variable uri.EpisodeTypes (the value list of the removed episode_types filter) is gone; nothing used it.

1.25.0 - 2026-10-08

Added

  • recommendations -a movies|shows and social_recommendations -a movies|shows read the favorited_by and recommended_by entries in both shapes: the nested one (user object plus notes) and the flat one of the Trakt API contract (profile fields plus notes). A flat entry kept only its notes before. The export writes user plus notes in both cases. Both shapes were tested against a mock server only: on 2026-10-04 the live API returned empty lists.
  • Library: str.UserNotes decodes a flat entry (profile fields plus notes) into User and Notes, next to the nested one.
  • Exports keep three newer groups of fields the API returns: email in users -a settings, height of a person with -ex full (for example people -a summary), and the VIP veteran fields of a user profile with -ex vip (vip_veteran_since, vip_veteran_years, vip_veteran_tier, vip_veteran_title, vip_grace_ends_at). These fields were dropped before. On 2026-10-04 the live API sent height (in centimetres) and the VIP veteran fields; email is in the Trakt API contract, but the live API did not send it yet.
  • Library: str.UserProfile has the new fields Email, VipVeteranSince, VipVeteranYears, VipVeteranTier, VipVeteranTitle and VipGraceEndsAt; str.Person has Height.
  • users -a lists takes -sort_how asc|desc and -sort_by, which the Trakt API contract added to the lists route. They are sent only when given, so the default order is unchanged. On 2026-10-04 the live API applied the direction (-sort_how desc reverses the overview) but kept the same order for every -sort_by value tried.
  • users -a watchlist takes -hide <value> to leave items out of the export: unwatched, collected, uncollected, rated, unrated, unreleased, noreleasedate, ended, airing, unwatchlisted, listed, notes or nonotes. An unknown value stops the run before any request. On 2026-10-04 the live API applied nine of them; unreleased, noreleasedate, unwatchlisted and nonotes returned the whole list.
  • Library: uri.ListOptions has the new field Hide.
  • Library: str.Timestamp has the new field DateOnly, set when the value was decoded from a date without a time. Such a value is encoded as a date again.
  • shows -a reset_show_progress -reset_at also takes a full date and time with an offset, for example -reset_at 2026-10-01T20:30:00+02:00, and sends that moment in UTC. A day (-reset_at 2026-10-01) works as before: it is sent with the current time of day. Tested against a mock server only: the route is for VIP accounts.
  • smart_lists -a items takes -t all|movies|shows, -sort_by <value> and -sort_how asc|desc, which use the new typed and sorted items route of the Trakt API contract: -t narrows a list holding both movies and shows, the sort flags reorder it (rank, random, title, released, runtime, percentage, votes, imdb_rating, imdb_votes, tmdb_rating, tmdb_votes, rt_tomatometer, rt_audience, metascore, and added on watchlist lists). One flag is enough; the others default to all, rank, and asc for rank and title, desc otherwise. Without these flags the export is unchanged. Tested against a mock server only.
  • smart_lists -a items takes -watchnow_country <xx> (region for -watchnow) and the parental guide filters -parental_nudity, -parental_violence, -parental_profanity, -parental_alcohol, -parental_frightening (severity range min-max, 0 to 3) and -parental_include_unrated. A value in the wrong format stops the run before any request. Tested against a mock server only.
  • users -a add_smart_list|update_smart_list accept watchnow_country and the parental_* keys in the filters object. Before, a file with one of these keys was rejected as invalid JSON.
  • Library: new SmartListsService.GetSmartListItemsByTypeAndSort; uri.SmartListItemsOptions has the new fields WatchNowCountry, ParentalNudity, ParentalViolence, ParentalProfanity, ParentalAlcohol, ParentalFrightening and ParentalIncludeUnrated; str.SmartListFilters has WatchNowCountry, the five Parental* ranges and ParentalIncludeUnrated; new type str.ParentalGuide, used by the new str.Options field Parental, next to the new WatchNowCountry.
  • Exports keep two more groups of fields the API returns: the gif of a comment (url and slug), for example in comments -a comment, movies -a comments, shows -a comments and users -a watchlist_comments, and share_code and display_ads of the account in users -a settings. Before, they were dropped. The gif is tested against a mock server only: on 2026-10-08 none of the 446 newest comments read from the live API had one.
  • Library: new type str.CommentGif, used by the new field Gif of str.Comment and str.ListComment; str.UserAccount has the new fields ShareCode and DisplayAds.
  • shows -a collection_progress takes -last_activity aired|collected and shows -a watched_progress takes -last_activity aired|watched. It chooses the episode that last_episode and next_episode are counted from: the last aired one you collected or watched (the default), or the one you collected or watched most recently. Another value stops the run before any request. On 2026-10-08 the live API accepted every value on both routes, but its effect could not be seen: the shows tried were watched in order and not collected, so all modes gave the same episodes.
  • Library: uri.ListOptions has the new field LastActivity.
  • movies -a trending|popular|anticipated|watched|played|collected|favorited|hot|streaming take -status <value> (released, in production, post production, planned, rumored, canceled; comma separated), sent as the statuses media filter. An unknown value stops the run before any request.

Changed

  • Library: trakt.NewClient(nil) creates its http.Client with the new trakt.DefaultTimeout (60 seconds) instead of no time limit. A client passed to NewClient keeps its own Timeout; pass one to choose another limit.
  • Library: UsersService.GetUsersPersonalLists takes a third argument, opts *uri.ListOptions (SortBy, SortHow); pass nil for the old behaviour.
  • Library: UsersService.GetWatchlistComments and UsersService.GetFavoritesComments return []*str.ListComment instead of []*str.ExportlistItem, which could not hold a comment.
  • A date flag with a value that is not a date (YYYY-MM-DD) now stops the run before any request, for example sync: invalid -start_at "2026-02-30", want YYYY-MM-DD, with exit status 1. This covers -start_date in movies, shows and people, -start_at and -end_at in sync and users, and -reset_at in shows. Before, such a value was silently replaced by the current date, so a typo in sync -a get_history -start_at exported the wrong window, and shows -a reset_show_progress -reset_at with a typo reset the progress at the current time.

Fixed

  • A request that Trakt never answers no longer hangs the run. Every request is now limited to 60 seconds and then ends with an error such as context deadline exceeded (Client.Timeout exceeded while awaiting headers) and exit status 1. Before, there was no time limit: on 2026-10-08 one smart_lists -a items run waited on a stalled response until it was stopped by hand.
  • shows -a trending|popular|anticipated|watched|played|collected|favorited -status <value> filters again. The flag was sent as status, which the live API ignores: the list came back unfiltered. It is now sent as statuses, the name in the Trakt API contract. Checked live on 2026-10-08 on all seven actions: status=ended changed nothing, statuses=ended returned ended shows only.
  • Library: uri.ListOptions.Status is sent as the query parameter statuses instead of status.
  • The config file keys ignore_collected, ignore_watched and ignore_watchlisted can be written without quotes (ignore_collected = true). Before, an unquoted value stopped every run with cannot parse the config file: toml: ... incompatible types: TOML value has type bool; destination has type string. The quoted form ("true") works as before.
  • users -a collection: the docs and the 1.24.0 notes said it takes the media filters (-genres, -years, -watchnow and so on). The flags are sent, as the Trakt API contract lists them for this route, but on 2026-10-04 the live API ignored -genres, -years, -languages and -watchnow and returned the whole collection. docs/users.md now says so.
  • users -a watchlist_comments and users -a favorites_comments exported only the id, updated_at and user of each comment. The export now holds the whole comment: its text, spoiler, review, replies, likes, created_at, parent_id and user_stats. Tested against a mock server only: on 2026-10-04 the live API returned no comments for the accounts tried.
  • -version shows the Built date in the system timezone (for example 2026-10-04 14:30 CEST). Before, it was always printed in UTC, as stored at build time; release builds printed it as 2026-10-04T12:30:45Z.
  • Library: str.Timestamp accepts a JSON null and leaves the value as it is. Before, decoding null into a Timestamp that is not a pointer, such as str.Rate.Reset, failed with invalid timestamp format: ul. The CLI was not affected: its Timestamp fields are pointers, and the rate limit is read from the response headers.
  • Exports write every date and time in full. Before, a time that was exactly midnight in the configured timezone lost its time and offset and was written as a date only: with timezone = "Europe/Warsaw", 2026-09-30T22:00:00Z became 2026-10-01 instead of 2026-10-01T00:00:00+02:00, and with the default UTC, 2026-10-01T00:00:00Z became 2026-10-01. Read back, such a value was midnight UTC, so the moment moved by the timezone offset. The same happened to times sent to the API, for example watched_at in sync -a add_to_history. A value that comes as a date without a time is still written as a date, and it now keeps its day in every timezone (west of UTC it was moved to the evening before).

1.24.0 - 2026-10-04

Added

  • movies -a trending|popular|anticipated|watched|played|collected|favorited|hot|streaming take the Trakt media filters: -genres, -subgenres, -years, -ratings, -runtimes, -countries, -certifications, -start_date, -end_date and -watchnow. The flags were accepted or missing before, but no filter was sent, so the lists were never filtered.
  • Library: new uri.MediaFilters and the uri.ListOptions.Filters field carry the media filters (watchnow, genres, subgenres, years, ratings, start_date, end_date, runtimes, countries, certifications) of the list routes.
  • shows -a trending|popular|anticipated|watched|played|collected|favorited take the Trakt media filters: -genres, -subgenres, -years, -ratings, -runtimes, -countries, -certifications, -start_date, -end_date and -watchnow, plus -status (for example -status ended). No filter was sent before, so the lists were never filtered. The live API does not always apply status: on 2026-10-03 it returned the unfiltered list.
  • media -a trending|popular|anticipated and recommendations -a movies|shows take the Trakt media filters: -genres, -subgenres, -years, -ratings, -runtimes, -countries, -certifications, -start_date, -end_date and -watchnow.
  • Every calendars action takes the Trakt media filters: -genres, -subgenres, -years, -ratings, -runtimes, -countries, -certifications and -watchnow. The dates of a calendar stay -start_date and -days.
  • lists -a trending|popular|items take the Trakt media filters: -genres, -subgenres, -years, -ratings, -runtimes, -countries, -certifications, -start_date, -end_date and -watchnow.
  • users -a watchlist|history|collection|list_items take the Trakt media filters: -genres, -subgenres, -years, -ratings, -runtimes, -countries, -certifications, -start_date, -end_date and -watchnow. In history, -start_at / -end_at still set the watched-at window; -start_date / -end_date are the separate media date filters.
  • users -a activities sends the rest of the Trakt media filters: -subgenres, -ratings, -certifications, -start_date, -end_date and -watchnow, next to -genres, -years, -runtimes and -countries. The six flags were accepted before, but not sent. An unknown -watchnow value stops the run before any request.
  • Library: uri.SocialActivityOptions has the new fields Certifications, EndDate, Ratings, StartDate, Subgenres and WatchNow.
  • The config file keys ignore_collected, ignore_watched, ignore_watchlisted (quoted "true" or "false") and watch_window now set the defaults of the flags of the same name in recommendations, social_recommendations, smart_lists -a items and users -a activities. The keys were read but never applied; only the flags worked. A flag still wins over the config file.
  • users -a activities takes -ignore_watched, -ignore_collected and -ignore_watchlisted (true or false), like recommendations. As of 2026-09-25 Trakt answers this route with 401 for API apps, so the flags were tested against a mock server only.
  • Library: uri.SocialActivityOptions has the new fields IgnoreCollected, IgnoreWatched and IgnoreWatchlisted.
  • movies -a trending|popular|anticipated|watched|played|collected|favorited|hot|streaming take three more filters: -imdb_ratings (for example 8.0-10.0), -rt_meters and -rt_user_meters (for example 90-100).
  • shows -a trending|popular|anticipated|watched|played|collected|favorited take the same three filters: -imdb_ratings, -rt_meters and -rt_user_meters.
  • -languages (for example -languages en,pl) filters the movies and shows list actions. Since 1.22.0 the flag only printed a note that the Trakt API no longer supports it; the live API does apply the filter, so the note is gone and the value is sent.
  • Exports of movies and shows keep more of what the API returns: images (with -ex images), colors (with -ex colors), and with -ex full also subgenres, original_title, social_ids, after_credits / during_credits (movies) and last_aired / total_runtime (shows). These fields were dropped before. This covers every export that holds a movie or a show, for example movies, shows, media, recommendations, calendars, users -a watchlist|history.
  • Library: str.Movie, str.Show, str.Recommendation and str.Media have the new fields Images, Colors and SocialIDs (new types str.MediaImages, str.MediaColors); str.Movie, str.Show and str.Recommendation also Subgenres and OriginalTitle, plus AfterCredits / DuringCredits (movie) and LastAired / TotalRuntime (show).
  • Library: str.Recommendation has the extended info fields of a movie or a show (Language, Genres, Overview, Runtime, Rating, Released, FirstAired, Airs, Network and so on).
  • Library: uri.MediaFilters has the new fields ImdbRatings, Languages, RtMeters and RtUserMeters. uri.ListOptions.Languages is no longer marked deprecated.
  • -languages also filters media -a trending|popular|anticipated, recommendations -a movies|shows, every calendars action, lists -a items and users -a watchlist|history|list_items. It is sent by lists -a trending|popular and users -a collection too, but on 2026-10-03 the live API ignored it there.

Changed

  • A word that is not a flag or a flag's value now stops the run with a message that names it, for example movies: unexpected argument "foo" (it was invalid flags). A stray word that happened to be a module or flag name, as in movies shows -a trending, was accepted before and the flags after it were silently ignored; it is rejected now. help <module> works as before.
  • Every calendars action and recommendations -a movies|shows now end with empty result and exit status 1 when the API returns no items, like the other list actions. Before, they wrote a file holding an empty list [] and ended with exit status 0. The output file is not written (an existing one is left as it is).
  • users -a watchlist|history|favorites|ratings do the same: an empty list, or a filter that matches nothing, ends with empty result and exit status 1 instead of a file holding [].

Fixed

  • A flag value that starts with a dash (for example a negative number) was read as a flag name and could stop the run with invalid flags.
  • Flags written as -flag=value after the module name (for example movies -a=trending or shows -status=ended) stopped the run with invalid flags; only -flag value worked. Both forms are accepted now. An empty value (-i "") no longer crashes the flag check.
  • users -allow_comments and users -display_numbers (used by users -a update_list) stopped the run with invalid flags. They are accepted now. The deprecated -query, -studio_ids and notes -notes_id also ended with invalid flags instead of their deprecation note.
  • Library: uri.StatusOptions listed the show status running series; the API value is returning series.
  • recommendations -a movies|shows -ex full and social_recommendations -a movies|shows -ex full exported only title, year, ids and the favorited_by / recommended_by lists; the extended fields the API returned were dropped. The export now keeps language, languages, genres, overview, runtime, rating, certification, country, status and the other full fields the movies and shows exports have.
  • users -a watchlist with a filter that matches less than the whole watchlist (for example -languages pl or -genres drama) kept asking for empty pages, up to pages_limit or the page count of the unfiltered watchlist. It now stops at the first empty page.
  • lists -a items and users -a list_items with a filter that matches nothing (for example -languages pl on a list without Polish titles) kept asking for the next page, up to pages_limit or the page count of the unfiltered list, because the page count the API sends ignores the filters. They now stop at the first empty page.

1.23.0 - 2026-10-02

Changed

  • sync -a add_to_history with -t movies, -t seasons, -t episodes or -t all now adds every play of the input back. An item watched several times came back with one play before (the first one in the input file), so its other plays were lost from the Trakt history. -t shows already kept every episode play. With -t all, an episode entry that also names its show was sent twice, with the show and as an episode; it is now sent once, with the show. To keep one play per item, leave only that entry in the input file.

Fixed

  • sync -a add_to_history with -t shows or -t all sent a show that has no episode in the input file (a whole show) with an empty seasons list and without its watched_at. Such a show is now sent without seasons, the form Trakt documents for adding all episodes of a show, and with its watched_at when the entry has one.
  • Library: str.Show has a new WatchedAt field, used when a whole show is added to the history.
  • Library: str.HiddenItem has a new User field for hidden users. The live API does not return them yet: GET /users/hidden/comments answers with an empty list even when a user is hidden (see the Findings in API_COVERAGE.md), so users -a hidden_items -section comments still exports [].
  • users -a add_hidden_items|remove_hidden_items -section comments wrote a result file without the users: the users counter under added / deleted and the users and people lists under not_found were dropped, so the file did not show whether a user was hidden. They are now written.
  • Library: str.ResultCounters has a new Users field and str.ResultNotFound new People and Users fields; they were dropped from add and remove results before.
  • A device login that failed (no code, code denied, expired, already used or unknown, or not approved in time) went on to run the module without a token. The run now stops with Error: device login failed: ... and exit status 1. A code that is not approved in time is reported as Error: device login failed: time out, the device code was not approved instead of Time out!.
  • The device login kept polling until the code's lifetime ran out after Trakt had already given a final answer: code denied, expired, already used or unknown. It now stops at once with Error: device login failed: device code denied, your device is not connected (or device code expired, device code already used, invalid device code). A device login that could not get a code at all is now reported as Error: ...; it ended without any message before.
  • The device login (first run, or an expired token that cannot be refreshed) crashed with panic: runtime error: invalid memory address or nil pointer dereference when a polling request got no response, for example on a network error. The failed attempt is now reported as Error: ... and polling goes on. Polling also ends with a time out when the code's lifetime is not a multiple of the polling interval; it never ended before.
  • sync -a get_collection -t seasons stopped with panic error:runtime error: invalid memory address or nil pointer dereference on every run. It now exports the collected seasons, each with its own IDs, and follows the pages of the collection.
  • Library: SyncService.GetCollectedSeasons returned a nil *str.Response on success and a list in which every item pointed at the last collected season. It now returns the response of the collection request and one item per season.
  • users -a add_hidden_items|remove_hidden_items -section comments sent an empty users list, so no user was hidden or unhidden although the command ended without an error. The user items of the input file are now sent (without -t, or with -t user).
  • history, watchlist and collection with -t episodes stopped with panic error:runtime error: invalid memory address or nil pointer dereference when an exported episode had no title, which Trakt allows. Such an episode is now exported with the title no episode title, as an episode with an empty title already was.
  • shows -a last_episode and shows -a next_episode stopped with panic error:runtime error: invalid memory address or nil pointer dereference when the episode had no title, which Trakt allows (typical for an upcoming episode). The episode is now exported and the message shows no episode title.
  • comments -a comments without -t, or with a -t other than movie, show, season, episode or list (for example the plural movies), stopped with panic error:runtime error: invalid memory address or nil pointer dereference. It now prints the possible types and stops with unknown type "movies".
  • checkin -a movie|episode|show_episode and comments -a comments stopped with panic error:runtime error: invalid memory address or nil pointer dereference when the user settings returned by Trakt had no connections object (the API allows it to be missing). The checkin or comment is now sent without sharing overrides, so Trakt applies the account's own sharing settings.
  • scrobble -a start|pause|stop -t movie, checkin -a movie, notes -a notes -t movie|show|person|rating|collection and comments -a comments -t movie ignored a failed lookup of the movie, show or person (for example an unknown ID) and sent the request to Trakt without the item. They now stop with the lookup error, such as fetch movie error:..., and send nothing. comments -a comments also stopped with panic error:runtime error: invalid memory address or nil pointer dereference when the user settings could not be read; it now reports user connections error:....
  • checkin -a show_episode and scrobble -a start|pause|stop -t show_episode without -episode_code and -episode_abs ended with exit status 0 although nothing was sent to Trakt. They now stop with set episode ie: -episode_code 1x5 or -episode_abs 6 and exit status 1.
  • sync -a reorder_watchlist|reorder_favorites and users -a reorder_list_items|reorder_lists stopped with panic error:runtime error: invalid memory address or nil pointer dereference when an input item had no id (for reorder_lists: a list without a Trakt ID). They now stop before any request with an error that names the item, such as item at index 1: has no id. A null item in the input of the collection, watchlist, favorites, list items and hidden items actions is reported the same way.
  • sync -a add_to_history|remove_from_history|add_to_ratings|remove_from_ratings silently dropped every input item that had neither watched_at nor rated_at, so the request went out with empty lists and nothing changed on Trakt, although the command ended without an error. Such items are now sent: the dates are optional in the Trakt API (a history item without watched_at is marked as watched now, and removing needs only the IDs).
  • Library: str.ItemsList.GetUniqueOldest dropped items without WatchedAt and RatedAt. It now keeps them, unless another item with the same Trakt ID has a date.
  • sync -a add_to_history|remove_from_history|add_to_ratings|remove_from_ratings stopped with panic error:runtime error: invalid memory address or nil pointer dereference when an item in the input had no Trakt ID (for example a movie with only an imdb ID), when a show's episode had no season number, or when the list held a null item. It now stops before any request with an error that names the item, such as item at index 1: movie has no trakt id. A show item without an episode that follows one with an episode no longer panics either.
  • Library: str.ItemsList.GetUniqueOldest kept the entry with the latest watched_at / rated_at per Trakt ID, although its name and docs say the oldest. It now keeps the oldest. It also no longer panics on a nil list, on an item without a Trakt ID (such items are skipped), or when a watched and a rated item share an ID, and Uniq / GetUniqIDs leave nil lists nil instead of panicking. Nothing changes for CLI users: sync builds these lists with one entry per ID already.

1.22.0 - 2026-10-01

Added

  • Library: examples on pkg.go.dev for the trakt package (client setup, OAuth token, pagination, typed errors, timezones) and for uri.AddQuery. go test compiles them, so they stay in step with the API.

Changed

  • The write data to: / write result to: line went to stderr without a line break, so it ran into the next output. It now goes to stdout on its own line, like the newer modules, and a JSON encoding error stops the command instead of writing an empty file. This covers every module.
  • calendars actions use underscores like the other modules: my_shows, all_new_shows, hot_releases and so on. The old hyphenated names (my-shows, all-new-shows, hot-releases, ...) still work, but print a deprecation note. Export file names are unchanged.
  • Library: a trakt client without WithUserAgent now sends User-Agent: trakt-sync-go (trakt.DefaultUserAgent), so apps built on the library no longer show up as the trakt-sync CLI. The CLI still sends trakt-sync/<version>. The package docs now tell apps to set their own User-Agent with WithUserAgent.
  • CI also builds and tests the trakt, str and uri packages and example/ with the Go version in go.mod (1.21), so the library keeps working for that minimum.
  • people -a lists has new -t (all, personal, official, watchlist, favorites) and -s (popular, likes, comments, items, added, updated) flags and asks for personal lists sorted by popular by default. Before, it sent the action name as the list type and rank as the sort, which are not valid values. The Trakt API currently returns no lists for any person on this route, so the command still ends with empty lists.
  • CI fails when the test coverage of a package drops below its floor in .github/coverage-floors.txt; make cover-check runs the same check locally.

Deprecated

  • Library: the uri.ListOptions fields EpisodeTypes, Languages, Metascores, NetworkIDs, StudioIDs and TmdbRatings are marked deprecated, because their query parameters are no longer part of the Trakt API. They still exist and will be removed in the next major version.
  • Flags that no longer do anything now print a note when used, and will be removed in the next major version: -studio_ids and -languages (no longer supported by the Trakt API), -query (use -q with search), notes -notes_id (use -i) and scrobble -delete (never had an effect). Commands still run as before.

Fixed

  • sync -a add_to_history|remove_from_history|add_to_ratings|remove_from_ratings with a -t other than all, movies, shows, seasons or episodes (for example -t movie) stopped with panic error:runtime error: invalid memory address or nil pointer dereference while reading the items. It now stops with an error that lists the valid types.
  • An unknown module in the config file made every command stop with type 'movies' is not valid for module 'history', right after the note Forcing module to history. The fallback to history now works, so commands run.
  • verbose = true in the config file had no effect: verbose output only appeared with -v. The config file value is now used, and -v=false before the module name turns it off for one run.
  • scrobble -progress was ignored, so scrobbles were sent without a progress value; a scrobble -a stop could therefore not mark an item as watched. The given progress is now sent.
  • comments -spoiler was ignored: comments and replies were always posted without the spoiler flag. -spoiler now marks them as spoilers.
  • If the new token (after login or a token refresh) or the refreshed user settings could not be encoded, token.json / user_settings.json was overwritten with an empty file. The encoding error is now reported and the stored file is kept.
  • An unknown or missing -a (and an unknown -t for certifications, countries, genres, languages, and for notes/scrobble actions, or -item for notes) printed the list of valid values but ended with exit status 0, so scripts could not notice a typo. It now prints the list followed by an error such as calendars: unknown action "typo" and exits with status 1. notes with an unknown action used to report a misleading privacy error; it now shows the actions list like the other modules.
  • README: the config file's type was described as applying to every module. It is ignored by episodes, lists, movies, people, scrobble, seasons, shows and users, which take -t only from the command line; the README now says so.

1.21.0 - 2026-10-01

Added

  • Library docs for the trakt package: a package overview for pkg.go.dev, a "Library usage" section in the README, and runnable programs in example/ (device login, trending movies, paginated history, error handling). Method docs link to the new API reference at docs.trakt.tv, and the versioning rules at the top of this file now cover the library.

Changed

  • The Trakt API client is now an importable Go package, github.com/mfederowicz/trakt-sync/trakt (it was internal/, which other modules cannot import). It is experimental: its API may still change in minor releases, as the library versioning rules at the top of this file describe. Nothing changes for CLI users.
  • Library: trakt API cleanup before its first release. Methods get consistent names: Oauth.PollForAccessToken, Checkin.CheckIn, Comments.AddComment, Users.GetSettings, Users.LikeList, Users.ReportList, Users.GetWatching and Users.GetListItemsByType. Every service method now returns the *str.Response as well (the Sync add/remove/update/reorder methods, Shows.GetShowCollectionProgress/GetShowWatchedProgress and Users.AddHiddenItems/RemoveHiddenItems did not), so callers can read rate limit and pagination headers. Path parameters are plain values instead of pointers (id string, days int), so a nil can no longer panic; an optional segment is left out when it is empty ("" or 0). In Users, an empty user means the authenticated user (me) in every method except Follow, Unfollow, Block, Unblock and Report, and type or section segments are always sent. str and uri get package docs for pkg.go.dev, and str.Format/str.Formatc are removed along with the github.com/wissance/stringFormatter dependency. Nothing changes for CLI users.
  • Debug lines such as fetch ... url: and create new checkin, and the bare request URLs that users actions such as likes, collection, followers and history printed, now print only with -v, which also shows each API request as METHOD <url> (with client_secret redacted). This covers calendars, checkin, comments, lists, movies, notes, people, recommendations, scrobble, search, shows, sync, users, countries, certifications, genres, languages and networks. Errors are still printed as before.

Fixed

  • Library: uri.AddQuery panicked when given nil options (for example a nil *uri.ListOptions passed to a trakt service method). Nil options now add no query.
  • After an expired access token was refreshed, user settings were fetched with the old token, so that settings refresh failed. They are now fetched with the new token.
  • Some API errors were only printed as General error occurred: or dropped: 412, 502, 503, 504 and other statuses without their own error type. The command then carried on as if the request had worked. These errors now stop the command with a readable message (GET <url>: 503 <message>) and exit status 1.
  • A 429 (rate limit) response without a Retry-After header, or a 426 (VIP required) response without an X-Upgrade-URL header, ended the command with a panic error (nil pointer). It now reports the API error instead.
  • lists -a items and sync -a add_to_watchlist now open the VIP upgrade page on a 426, as the other VIP actions already did.
  • users -a plex_*: Plex errors on 502/503/504 now show Plex's error_code, message and guidance, not just the status.

1.20.0 - 2026-09-30

Changed

  • token.json, user_settings.json and JSON exports (-o) are now written readable only by the owner (0600); an existing 0644 token or settings file is tightened the next time it is written.
  • Every request now sends User-Agent: trakt-sync/<version>, trakt-api-version: 2 and Content-Type: application/json, and no longer sends an empty Authorization header. -v prints the User-Agent that is sent.
  • README: new "Intended use" section - trakt-sync is for your own Trakt data only.

Fixed

  • -v printed the full access token and client ID; both are now masked to their last 4 characters.
  • The list of available actions printed for an unknown -a now shows only real actions: movies lists updates and related instead of updated and releated; shows lists related and reset_show_progress and no longer offers boxoffice, releases or releated; users no longer offers follow_request.

1.19.1 - 2026-09-26

Changed

  • CI: workflows run on ubuntu-26.04 and use Node 24-based actions/checkout@v7 / actions/setup-go@v7, which clears the Node.js 20 deprecation and ubuntu-latest migration warnings.

1.19.0 - 2026-09-25

Added

  • New younify module for streaming service connections: younify -a connections (services and your connection status), younify -a connect -service_id <id> [-return_url <url>] (prints the web auth URL to link a service), younify -a refresh -service_id <id> [-all_data] (queue an incremental or full re-sync) and younify -a disconnect -service_id <id>. Trakt does not open younify to API apps yet: connections answers 401 (the developer portal too), which the CLI reports as younify is not open to API apps yet.
  • users -a smart_lists|smart_list|add_smart_list|update_smart_list|delete_smart_list: list, get, create, update and delete your smart lists. Create and update read the smart list JSON from -items <file> or stdin, like add_list.
  • users -a comment_reactions (comments you reacted to), users -a activities -t friends|followers|following (what your social graph watched), users -a month_in_review -year <y> -month <m> and users -a year_in_review -year <y>. Trakt answers the last three with 401 for API apps for now; the CLI reports it as this route is not open to API apps yet.
  • users -a watchlist|favorites -sort <rank|added|title|released|runtime|popularity|percentage|votes> uses the contract's /{type}/{sort} routes (with -t all, movies or shows); without -sort nothing changes.
  • users -a update_settings (profile and browsing settings from -items <file> or stdin), users -a add_saved_filters and users -a delete_saved_filter -i <id> (both VIP only).
  • users -a data_syncs [-t younify|plex|import], users -a data_sync|data_sync_paused|data_sync_skipped -i <id> and users -a undo_data_sync -i <id>: the syncs your connected apps ran, their paused and skipped items (with the keys specific to the source kept), and undoing a sync. Trakt answers data_syncs with 401 for API apps for now; the CLI reports it as this route is not open to API apps yet.
  • Plex settings in users: plex_settings, update_plex_settings (JSON from -items <file> or stdin), plex_connect [-return_url <url>], plex_disconnect, plex_servers, plex_server -i <server id> and plex_sync [-i <server id>] [-all_data]. Plex's own errors (e.g. bad_auth) are shown with Trakt's guidance. Trakt answers the Plex routes with 401 for API apps for now; the CLI reports it as this route is not open to API apps yet.

Changed

  • docs/users.md documents the contract's singular list item types for users -a lists -i <id> -t: movie, show, movie,show, movie,show,season,episode (the action passes -t through unchanged).

Fixed

  • users -a add_smart_list|update_smart_list: an empty source, media_type or privacy in the JSON (e.g. "source": ""), or an empty name on update, passed the input check and was sent to Trakt; it is now rejected before the request.
  • trakt-sync help: the command list is sized to the longest command name; before, the summary of social_recommendations was shifted out of its column.

1.18.0 - 2026-09-25

Added

  • sync -a playback -t all, and -ex for sync -a playback, which was not sent before.
  • sync -a get_minimal_collection -t movies|shows|episodes [-available_on plex]: the collection as a compact map of Trakt IDs to collected dates (shows nested by season and episode), for syncing local state.
  • sync -a get_up_next [-include_stats] [-lifetime_stats]: shows you are watching, with their next episode and progress.
  • sync -a get_watched_progress [-hide_completed | -hide_not_completed] [-only_rewatching] [-lifetime_stats]: watched progress of your shows. Both actions take -sort_by / -sort_how (sent only when given) and -ex.
  • sync -a get_up_next_nitro [-intent all|continue|start|completed] [-watchnow <filter>]: up next with media filters (-genres, -subgenres, -years, -ratings, -runtimes, -countries, -certifications, -start_date, -end_date). The global -genres, -years, -countries and -runtimes flags were accepted before but not used.
  • New team module: team -a members [-ex full|images] exports the Trakt team members to export_team_members.json. User profiles in JSON exports now also include deleted and director when the API sends them.
  • New social_recommendations module: social_recommendations -a movies|shows exports recommendations based on the people you follow, with -ignore_watched, -ignore_collected, -ignore_watchlisted, -watch_window <days> and -ex.
  • New watchnow module: watchnow -a sources [-country us] exports the watch now sources (streaming providers) supported by Trakt, for all countries or one. Trakt marks it limited access; without access it fails with a "limited access" message.
  • recommendations -a movies|shows takes -ignore_watched true|false and -watch_window <days>, like social_recommendations.
  • New smart_lists module: smart_lists -a summary -i <slug> exports a smart list definition (name, media type, filters) and smart_lists -a items -i <slug> the movies or shows it resolves to, with media filters (-watchnow, -genres, -subgenres, -years, -ratings, -runtimes, -countries, -certifications), -ignore_watched, -ignore_watchlisted and -ex.

Changed

  • trakt-sync now exits with status 1 when a command fails (API error, unknown command or flag, invalid config); before it always exited with 0.
  • Go API: the str.UserProfile.Userame field is renamed to Username (JSON output unchanged). Also removed an unused sync:remove_watchlist config entry.
  • A flag the module does not know (e.g. a typo) now stops the command with <module>: flag provided but not defined: -x after the help. Before, the rest of the flags were skipped and the command ran anyway.
  • CHANGELOG.md now covers every release back to 1.0.0.
  • GitHub release notes now show the version's CHANGELOG.md section (Added / Changed / Fixed) instead of a list of commits.

Fixed

  • users -a add_list treated a created list (201) as an error and did not write its result file; sync -a remove_playback reported a successful removal (204) as an error.
  • -o was ignored by sync and users, which always wrote to their generated file name (e.g. export_sync_history_movies.json), including the actions that write a result file (add_*, remove_*, reorder_*, users -a update_list, users -a add_list, users -a watching, ...); -o now sets the output file. Without -o the file names are unchanged.
  • users -a lists -i <id> wrote the list items over the lists overview (export_users_lists.json); the items now go to -o (default export_users_lists_<type>.json) and the overview keeps its own file. Scripts that read the items from export_users_lists.json should read export_users_lists_<type>.json (or pass -o).
  • -h / -help after a module name printed the help and then ran the command; it now only prints the help.
  • users -a update_list -description "...": -description was not a users flag, so the description was never sent; users now accepts it.
  • A crash inside any command was caught but then reported nothing, as if the command had succeeded; it now prints panic error:<reason> (or fatal error).
  • checkin -a movie -trakt_id <id> and checkin -a show_episode -trakt_id <id> looked the item up without its ID (GET /movies/, GET /shows/) since 1.8.0, so the checkin could not work; they now use -trakt_id.
  • checkin -a show_episode: an active checkin (409) without an expiry time in the response now reports the existing checkin instead of crashing.
  • users -a history -start_at <date> -end_at <date> failed with flag provided but not defined: -start_at and silently used the default window; users now accepts both flags.
  • sync -a playback without -t returned only movies (the default type), although the docs describe it as all playback. It now returns movies and episodes; -t movies|episodes still narrows it.

1.17.0 - 2026-09-25

Added

  • movies -a watchnow -i <id> -country <code>: watch now sources (streaming, rent, purchase) for a movie in one country; -links tvos,direct,android,webos adds provider links and -ex streaming_ranks adds the JustWatch rank.
  • movies -a justwatch_links -i <id> -country <code>: the JustWatch link for a movie in one country.
  • shows -a report -i <id> -r <reason> [-message "..."]: report a show for moderator review.
  • shows -a sentiments -i <id>: good and bad sentiments from a show's comments and reactions.
  • shows -a watchnow -i <id> -country <code>: watch now sources for a show in one country, with the same -links and -ex streaming_ranks options as movies -a watchnow.
  • shows -a justwatch_links -i <id> -country <code>: the JustWatch link for a show in one country.
  • seasons -a report -i <show> -season <n> -r <reason> [-message "..."]: report a season for moderator review (-season 0 is specials).
  • episodes -a report -i <show> -season <n> -episode <n> -r <reason> [-message "..."]: report an episode for moderator review.
  • episodes -a watchnow -i <show> -season <n> -episode <n> -country <code>: watch now sources for an episode, with the same -links and -ex streaming_ranks options as shows -a watchnow.
  • seasons -a justwatch_links -i <show> -season <n> -country <code>: the JustWatch link for a season.
  • shows -a refresh_justwatch -i <id>: queue a refresh of the show's JustWatch links (VIP only).
  • people -a report -i <id> -r <reason> [-message "..."]: report a person for moderator review.
  • seasons -a report, episodes -a report and episodes -a watchnow accept the season's or episode's own Trakt ID in -i when -season (and for episodes -episode) is left out; with them, -i is still the show.
  • search -a text_query --field: accepts original_title for -t movie / -t show and show_title for -t episode, the remaining search fields from the Trakt API docs.
  • search -a exact_query -t movie|show -q <query>: exact title matches for movies or shows.
  • search -a trending -t movies|shows|people [-q <query>]: globally trending searches, the items people most often picked from search results; -q filters on the typed search text.
  • search -a add_recent|remove_recent -t movies|shows|people|lists -q <query> -i <trakt id>: add or remove a pick in the global search trends that search -a trending returns.

Changed

  • search -a text_query and search -a id_lookup replace text-query and id-lookup, to match the underscore action names of the other modules. The old names still work and print a deprecation note.
  • search with an unknown or missing -a prints the same "Available actions" list as the other modules.

Removed

  • search -t podcast and -t podcast_episode, and the podcast / podcast_episode fields in search results: the Trakt API contract has no podcast search types or podcast results.

Fixed

  • search -a text_query --field <name>: the field filter was sent as field instead of fields, so the API ignored it and searched its default fields. It is now sent as fields.
  • comments on a season or episode always failed with set traktId, even with -trakt_id/-i given: the check read a field the comments module never sets. It now checks the id that is actually passed.
  • checkin -a episode -trakt_id <id> crashed with a nil pointer: the episode was looked up by an empty id instead of -trakt_id. It now sends the -trakt_id directly.
  • notes -t season|episode, notes -t rating|collection -item season|episode, comments on seasons and episodes, and scrobble -t episode no longer look the item up with GET seasons/{id} / GET episodes/{id}, which are not in the Trakt API docs. The request carries only the numeric Trakt ID from -i; a non-numeric id now fails before anything is posted (notes used to post without the item).
  • movies -a sentiments and shows -a sentiments: an unknown id wrote an empty {} file, because the API answers it with an empty object instead of 404; it now fails with no sentiments for:<id> and writes nothing.
  • movies -a hot and movies -a streaming: the live Trakt API returns 404 for these routes; the error now says the route is documented but not served, instead of a bare 404.

1.16.0 - 2026-09-24

Added

  • calendars -a {my,all}-media: movies and shows releasing in the selected period.
  • calendars -a {my,all}-streaming: movies with a streaming release in the selected period.
  • calendars -a hot-releases|hot-premieres|hot-new-shows|hot-finales: hot releases, premieres, new shows and finales in the selected period.
  • New media module: media -a trending|popular|anticipated exports movies and shows together in one list.
  • comments -a reactions and comments -a reactions_summary: export the reactions on a comment, or their totals by type.
  • comments -a reaction -reaction <type>: add a reaction to a comment; add -remove to take it back.
  • comments -a report -r <reason> [-message "..."]: report a comment for moderator review.
  • lists -a trending|popular -t <type>: lists of one type. The value is sent to the API as-is; the API contract does not list the allowed types.
  • lists -a items -sort_by <field> -sort_how asc|desc: sort list items.
  • lists -a report -trakt_id <id> -r <reason> [-message "..."]: report a list for moderator review.
  • movies -a hot: hot movies based on current list activity.
  • movies -a streaming -period daily|weekly|monthly: the most streamed movies (default weekly).
  • movies -a report -i <id> -r <reason> [-message "..."]: report a movie for moderator review.
  • movies -a refresh_justwatch -i <id>: queue a refresh of the movie's JustWatch links (VIP only).
  • movies -a sentiments -i <id>: good and bad sentiments from a movie's comments and reactions.

Changed

  • users -a add_hidden_items|remove_hidden_items: -section is now checked before the request, like hidden_items (calendar is the default).
  • users -a hidden_items: -section progress_watched_reset is no longer accepted; it is not a section in the Trakt API contract.
  • sync -a get_collection: -t is now checked before the request (movies, shows, episodes, media, seasons); an unknown type fails with an error instead of calling the API. -t media returns movies, shows and episodes together.
  • All modules: a failed action now prints its error as <module>/<action>: <cause>, with a space after the colon.

Fixed

  • VIP account limits (420) for users -a add_list|add_list_items, sync -a add_to_watchlist and lists -a items: a non-VIP user now gets the Trakt VIP page opened (from X-Upgrade-URL), a VIP user gets account limit exceeded (limit: N). Before, the command showed a generic error.
  • VIP-only actions (426): when the response has no X-Upgrade-URL header, https://trakt.tv/vip is opened instead of an empty URL.
  • movies -a favorited|played|watched|collected -period <p>: -period was ignored and weekly was always used (the shows default overwrote it).
  • movies|shows|people -a updates|updated_ids -start_date <date>: -start_date was ignored and the last 60 days were always used. Without -start_date the last 60 days are still used.
  • calendars -start_date <date>: -start_date was ignored; the request used a date 60 days in the past in the wrong format. The default is today again, for -days days (7).
  • type from the config file was ignored: commands that use the global -t flag (for example sync, watchlist, collection, history, certifications, comments) always used -t's default movies when -t was not given. The config file value is now used, and -t still overrides it.
  • A global flag given before the module name could hide a config file value for an unrelated one-letter flag with the same first letter (for example -translations made type fall back to the -t default).
  • users -a history -item_id <id> without -t: the request URL had no type (history//<id>), which is not an API route; the command now asks for -t (for example -t movies).
  • lists -a trending: the output file name was empty, so the export was not written; it is now export_lists_trending.json.
  • lists -a items without -t: it used the global default type movies, which is not a list item type; it now requests all item types (movie,show,episode,season).
  • Nil pointer panics when a request fails before Trakt answers (no network, DNS, timeout) are fixed in the shared client, the API services and the command handlers; the command now prints the error.
  • Posting a comment or a note: an error other than a validation error (for example 401) now shows the HTTP error; before, the command crashed with a nil pointer panic.
  • lists -a list and users -a list: a 500 from Trakt now gives an error instead of a panic.
  • users -a report|list_report: a 400 or 409 response without a message no longer panics.
  • checkin -a movie|episode: if you are already checked in, the command now fails with the 409 error; before, it exited without printing anything.
  • users -a follow|block: an unknown user now gives "user not found"; before, the command crashed with a nil pointer panic.
  • certifications -t movies|shows: the "write data to:" message is printed to stdout on its own line; before, it went to stderr with no newline and ran into the next line of output.

1.15.3 - 2026-09-23

Added

  • API_COVERAGE.md: every Trakt API route from the official contract, whether trakt-sync implements it, and the Go method that calls it. Linked from the README.
  • Contributor and AI agent guidelines: AGENTS.md, CLAUDE.md and .agents/rules/.
  • CHANGELOG.md (this file). Every PR adds its entry under [Unreleased].

Changed

  • README: API credentials are now created in the Trakt developer portal (a verified GitHub account is required); new "API documentation" section; episodes added to the command list.
  • Releases are now built and published by GitHub Actions (GoReleaser) when a v* tag is pushed.

Fixed

  • users -a list_like now likes the list. It sent DELETE, which removed an existing like instead.
  • users -a follower_requests now returns the follow requests waiting for your approval. It returned your own pending requests to other users instead.
  • users -a follower_requests and users -a following_requests now send -ex (extended info) to the API; it was silently dropped.
  • -version now shows the real version and commit for release binaries and make build builds, instead of dev / none or a Go pseudo-version.

1.15.2 - 2026-06-16

Fixed

  • sync -a get_watched and users -a watched returned only the first page of results; they now fetch every page (up to pages_limit).

1.15.1 - 2026-06-16

Changed

  • Module docs moved from README.md into docs/<module>.md; the README links to them.

Fixed

  • collection returned only the first page of results; it now fetches every page (up to pages_limit).

1.15.0 - 2026-05-26

Added

  • users: many new actions for the user endpoints: profile, follower_requests, following_requests, follow_request, hidden_items, add_hidden_items, remove_hidden_items, likes, collection, comments, notes, history, ratings, watchlist, watchlist_comments, favorites, favorites_comments, watching, report.
  • users: manage personal lists with list, add_list, update_list, delete_list, reorder_lists, collaborations, list_likes, list_like, list_items, add_list_items, remove_list_items, reorder_list_items, update_list_item, list_comments and list_report.
  • users: social actions follow, unfollow, followers, following, friends, blocked_users, block and unblock.

Changed

  • README.md and sync action descriptions updated.

1.14.0 - 2026-05-11

Added

  • New sync module: last_activities, playback, remove_playback.
  • sync -a get_collection|add_to_collection|remove_from_collection.
  • sync -a get_watched|get_history|add_to_history|remove_from_history.
  • sync -a get_ratings|add_to_ratings|remove_from_ratings.
  • sync -a get_watchlist (with -sort_by / -sort_how), update_watchlist, add_to_watchlist, remove_from_watchlist, reorder_watchlist, update_watchlist_item.
  • sync -a get_favorites, update_favorites, add_to_favorites, remove_from_favorites, reorder_favorites, update_favorite_item.

1.13.0 - 2025-06-01

Added

  • New episodes module: summary, translations, comments, lists, people, ratings, stats, watching, videos.

1.12.0 - 2025-05-30

Added

  • New seasons module: summary, season, episodes, translations, comments, lists, people, ratings, stats, watching, videos.

1.11.0 - 2025-05-27

Changed

  • Dates are handled in the timezone from your Trakt account settings. The settings are downloaded after login and stored in the JSON file set by settings_path in the config file.
  • -start_date is rounded down to the full hour, and dates default to the RFC 3339 format.

Fixed

  • An invalid or missing settings or token file no longer stops the program; the file is created or refreshed.

1.10.0 - 2025-05-21

Added

  • New shows module: trending, popular, favorited, played, watched, collected, anticipated, updates, updated_ids, summary, aliases, certifications, translations, comments, lists, collection_progress, watched_progress, reset_show_progress, people, ratings, related, stats, studios, watching, next_episode, last_episode, videos, refresh.

1.9.1 - 2025-05-04

Changed

  • Internal: linter and gofmt cleanup, and a lint check in GitHub Actions.

1.9.0 - 2025-05-04

Added

  • New networks module: networks -a list.
  • New notes module: add notes to movies, shows, seasons, episodes, people, history, collection and rating items (notes -a notes -t <type> -i <id> -notes "..."), and get, update or delete one (notes -a note -i <id>), or get its item (notes -a item -i <id>).
  • New recommendations module: recommendations -a movies|shows, with -ignore_collected, -ignore_watchlisted, or -i <id> -hide to hide a recommendation.
  • New scrobble module: scrobble -a start|pause|stop -t movie|episode|show_episode -i <id> -progress <n>; for show_episode pick the episode with -episode_code 1x5 or -episode_abs 164.

Changed

  • README.md reorganized with a section per module.
  • Tests run in GitHub Actions.

1.8.0 - 2025-03-26

Added

  • New movies module: trending, popular, favorited, played, watched, collected (with -period), anticipated, boxoffice, updates, updated_ids, summary, aliases, releases, translations, comments, lists, people, ratings, related, stats, studios, watching, videos, refresh.

Changed

  • lists and comments accept a Trakt slug as well as a numeric Trakt ID.

1.7.0 - 2025-03-16

Added

  • New countries, genres and languages modules: -t movies|shows exports the list for movies or shows.

1.6.1 - 2025-03-15

Added

  • pages_limit in the config file limits how many pages paginated exports fetch.

1.6.0 - 2025-03-11

Added

  • New comments module: comment (get, update or -delete), comments (post on a movie, show, season, episode or list), replies, item, likes, like (-remove to unlike), trending, recent and updates.
  • New certifications module: -t movies|shows exports the certifications.

1.5.0 - 2025-02-26

Added

  • New checkin module: checkin -a movie|episode -trakt_id <id> -msg "...", checkin -a show_episode -trakt_id <id> -episode_code 1x5 (or -episode_abs 6), and checkin -a delete.
  • users -a settings: settings of the current user.
  • people -a refresh: queue a refresh of a person's data.

1.4.2 - 2025-02-21

Changed

  • help lists the commands in alphabetical order.
  • lists docs updated.

1.4.1 - 2025-02-20

Changed

  • Same code as 1.4.0; this is the GitHub release for it.

1.4.0 - 2025-02-20

Added

  • New lists module: trending, popular, list, likes, like (-remove to unlike), items (filter with -t movie,show) and comments, selected with -trakt_id <id>.

1.3.1 - 2024-12-07

Changed

  • Internal: error handling cleanup.

1.3.0 - 2024-11-12

Added

  • users -a watched -t movies|shows -u <user>: watched movies or shows of a user; -ex noseasons leaves out the seasons.

1.2.0 - 2024-11-07

Added

  • users -a stats -u <user>: stats of a user.

1.1.0 - 2024-10-29

Added

  • users -a saved_filters -u <user>: saved filters of a user (VIP); without VIP it opens the upgrade page in the browser.

Changed

  • Breaking: the lists command moved to users -a lists (users -a lists -u <user> [-i <list id> -t <type>]).

1.0.10 - 2024-10-14

Fixed

  • people -a updates and people -a updated_ids ignored -start_date and always used the current date.
  • lists -u <user> ignored the -u flag.

1.0.9 - 2024-10-14

Changed

  • Internal: linter cleanup and refactoring.

1.0.8 - 2024-10-13

Changed

  • Internal: linter cleanup and refactoring.

1.0.7 - 2024-10-06

Changed

  • Internal: linter cleanup and refactoring.

1.0.6 - 2024-10-04

Changed

  • Internal: linter cleanup and refactoring of the people command.

1.0.5 - 2024-10-03

Changed

  • Internal: linter cleanup, console output moved to one printer package, unhandled errors checked.

1.0.4 - 2024-09-30

Fixed

  • -version printed dev for binaries installed with go install instead of the module version.

1.0.3 - 2024-09-30

Changed

  • Internal: linter cleanup.

1.0.2 - 2024-09-29

Changed

  • Internal: linter cleanup.

1.0.1 - 2024-09-12

Added

  • Release binaries built and published with GoReleaser.

1.0.0 - 2024-09-12

Added

  • First release, with the calendars, collection, help, history, lists, people, search and watchlist commands exporting Trakt data to JSON.