Smart lists are saved filters that resolve to movies or shows. -i takes the smart list slug (ids.slug in the summary). Only public smart lists return data, unless you own the list; an unknown or private slug ends with "not found smart list for:".
$ ./trakt-sync smart_lists -a summary -i <slug> -> export_smart_lists_summary_<slug>.jsonPaging follows per_page and pages_limit from the config file; -ex sets extended info (full, images, colors, streaming_ids).
$ ./trakt-sync smart_lists -a items -i <slug> -> export_smart_lists_items_<slug>.jsonRefine the items with media filters (-watchnow favorites|any|free|subscriptions or a service name such as netflix,
-genres, -subgenres, -years, -ratings, -runtimes, -countries, -certifications) and skip what you already watched or watchlisted:
$ ./trakt-sync smart_lists -a items -i <slug> -genres action -years 2020-2026 -ratings 75-100 -ignore_watched true$ ./trakt-sync smart_lists -a items -i <slug> -watchnow subscriptions -ignore_watchlisted trueSend the -watchnow filter for another region with -watchnow_country <xx> (two lowercase letters). Without it the API uses the list region, then the owner's region, then us:
$ ./trakt-sync smart_lists -a items -i <slug> -watchnow free -watchnow_country plFilter by production company with -studios (slugs or names) and by person with -people (person slugs), both comma separated.
-people_operator and|or asks for every listed person or any of them (or is the default), -people_role any|cast|directing|writing|producing limits where a person counts (any is the default):
$ ./trakt-sync smart_lists -a items -i <slug> -studios pixar -people steven-spielberg,tom-hanks -people_operator and -people_role castA value of a list filter (-genres, -studios, -people, -watchnow and similar) that starts with - is left out of the result. Write a flag whose first value starts with - in the -flag=value form:
$ ./trakt-sync smart_lists -a items -i <slug> -studios pixar,-dreamworks-animation -watchnow=-netflix-awards (award slugs, comma separated) keeps titles nominated for or winning any of the listed awards. -award_years (ceremony year range min-max, either side optional) and -award_won (only the winners) need -awards.
Trakt lists the award slugs only through a route limited to its own apps; oscars-best-picture is the example its API docs give:
$ ./trakt-sync smart_lists -a items -i <slug> -awards oscars-best-picture -award_years 2020-2026 -award_won-released_within_days <1-3650> keeps titles released in the last N days (movies by release date, shows by first aired date). -tmdb_ratings (0 to 10), -metascores (0 to 100),
-votes (Trakt votes) and -imdb_votes take a range min-max; either side can be left out:
$ ./trakt-sync smart_lists -a items -i <slug> -released_within_days 365 -tmdb_ratings 7.5-10 -metascores 70-100 -votes 1000- -imdb_votes 5000-Filter by parental guide with -parental_nudity, -parental_violence, -parental_profanity, -parental_alcohol and -parental_frightening.
Each takes a severity range min-max from 0 (none) to 3 (severe). Titles without a parental guide are left out, unless you add -parental_include_unrated:
$ ./trakt-sync smart_lists -a items -i <slug> -parental_violence 0-1 -parental_frightening 0-2 -parental_include_unrated-t all|movies|shows narrows a list that holds both movies and shows, -sort_by and -sort_how asc|desc reorder it. Sort values: rank (the list's own order),
random, title, released, runtime, percentage, votes, imdb_rating, imdb_votes, tmdb_rating, tmdb_votes, rt_tomatometer, rt_audience, metascore,
and added on watchlist lists. Give at least one of the three flags after the module name; the others default to -t all, -sort_by rank, and -sort_how asc for rank and title, desc otherwise.
The filters above work here too, and the output file is the same.
$ ./trakt-sync smart_lists -a items -i <slug> -t movies -sort_by imdb_rating$ ./trakt-sync smart_lists -a items -i <slug> -sort_by released -sort_how ascThe official smart list templates in display order, no -i needed. Each template has an id, a source, a media_type and the same
filters a saved smart list returns. Templates that depend on the viewer have personal: true and no total or items; the others
return their total and up to 3 items. -ex images adds posters to the items.
$ ./trakt-sync smart_lists -a templates -> export_smart_lists_templates.json$ ./trakt-sync -ex images smart_lists -a templates