Skip to content

Latest commit

 

History

History
69 lines (68 loc) · 4.88 KB

smart_lists.md

File metadata and controls

69 lines (68 loc) · 4.88 KB

Smart lists:

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:".

Smart list definition (name, media type, filters):
$ ./trakt-sync smart_lists -a summary -i <slug> -> export_smart_lists_summary_<slug>.json
Smart list items:

Paging 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>.json

Refine 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 true

Send 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 pl

Filter 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 cast

A 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
Smart list items by type and sort:

-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 asc
Smart list templates:

The 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