Traktarr uses Trakt.tv to find shows and movies to add in to Sonarr and Radarr, respectively.

Go to file

desimaniac 3d6200a3e8 Movies: Revert to default min avail if invalid entry is given in config		6 years ago
.github	Github: Added support/issue templates.	6 years ago
assets	Readme: Updated formatting of lists.	6 years ago
docker	…
helpers	Logs: More details / cleaner look / wording	6 years ago
media	Logs: More details / cleaner look / wording	6 years ago
misc	New Feature: Minimum Availability	6 years ago
notifications	Notifications: Added Apprise support.	6 years ago
systemd	…
.dockerignore	…
.gitignore	Git: Updated .gitignore	6 years ago
CONTRIBUTING.md	…
LICENSE.md	…
README.md	Config: New option for genres: 'ignore'.	6 years ago
config.json.sample	New Feature: Minimum Availability	6 years ago
requirements.txt	Notifications: Added Apprise support.	6 years ago
traktarr.py	Movies: Revert to default min avail if invalid entry is given in config	6 years ago

README.md

Introduction
Demo
Requirements
Installation
Configuration
- Sample Configuration
- Core
- Automatic
  - Personal Watchlists
  - Custom Lists
    - Public Lists
    - Private Lists
- Filters
  - Movies
  - Shows
- Notifications
  - Apprise
  - Pushover
  - Slack
- Radarr
- Sonarr
  - Tags
- Trakt
Usage
Donate

Introduction

Traktarr uses Trakt.tv to find shows and movies to add in to Sonarr and Radarr, respectively.

Types of Trakt lists supported:

Official Trakt Lists
- Trending
- Popular
- Anticipated
- Box Office
- Most Watched
- Most Played
Public Lists
Private Lists*
- Watchlist
- Custom List(s)

* Support for multiple (authenticated) users.

Demo

Click to enlarge.

Requirements

Debian OS (can work in other operating systems as well).
Python 3.5+
Required Python modules.

Installation

1. Base Install

Installs Traktarr to the system so that it can be ran with the traktarr command.

Clone the Traktarr repo.

sudo git clone https://github.com/l3uddz/traktarr /opt/traktarr

Fix permissions of the traktarr folder (replace user/group with your info; run id to check).
```
sudo chown -R user:group /opt/traktarr
```
Go into the traktarr folder.
```
cd /opt/traktarr
```

Install Python and PIP.

sudo apt-get install python3 python3-pip

Install the required python modules.

sudo python3 -m pip install -r requirements.txt

Create a shortcut for traktarr.

sudo ln -s /opt/traktarr/traktarr.py /usr/local/bin/traktarr

Generate a basic config.json file.
```
traktarr run
```
Configure the config.json file.
```
nano config.json
```

2. Create a Trakt Application

Create a Trakt application by going here
Enter a name for your application; for example traktarr
Enter urn:ietf:wg:oauth:2.0:oob in the Redirect uri field.
Click "SAVE APP".
Open the Traktarr configuration file config.json and insert your Trakt Client ID in the client_id and your Trakt Client Secret in the client_secret, like this:
```
"trakt": {
    "client_id": "your_trakt_client_id",
    "client_secret": "your_trakt_client_secret"
}
```

3. Authenticate User(s) (optional)

For each user you want to access the private lists for (i.e. watchlist and/or custom lists), you will need to to authenticate that user.

Repeat the following steps for every user you want to authenticate:

Run the following command:
```
traktarr trakt_authentication
```

You wil get the following prompt:

- We're talking to Trakt to get your verification code. Please wait a moment...
- Go to: https://trakt.tv/activate on any device and enter A0XXXXXX. We'll be polling Trakt every 5 seconds for a reply

Go to https://trakt.tv/activate.
Enter the code you see in your terminal.
Click Continue.
If you are not logged in to Trakt.tv, login now.
Click Accept.
You will get the message: "Woohoo! Your device is now connected and will automatically refresh in a few seconds.".

You've now authenticated the user.

You can repeat this process for as many users as you like.

Configuration

Sample Configuration

{
  "core": {
    "debug": false
  },
  "automatic": {
    "movies": {
      "anticipated": 3,
      "boxoffice": 10,
      "interval": 24,
      "popular": 3,
      "trending": 2
    },
    "shows": {
      "anticipated": 10,
      "interval": 48,
      "popular": 1,
      "trending": 2
    }
  },
  "filters": {
    "movies": {
      "disabled_for": [],
      "allowed_countries": [
        "us",
        "gb",
        "ca"
      ],
      "allowed_languages": [],
      "blacklist_title_keywords": [
        "untitled",
        "barbie",
        "ufc"
      ],
      "blacklisted_genres": [
        "documentary",
        "music",
        "animation"
      ],
      "blacklisted_max_year": 2019,
      "blacklisted_min_runtime": 60,
      "blacklisted_min_year": 2000,
      "blacklisted_tmdb_ids": [],
      "rating_limit": ""
    },
    "shows": {
      "disabled_for": [],
      "allowed_countries": [
        "us",
        "gb",
        "ca"
      ],
      "allowed_languages": [],
      "blacklisted_genres": [
        "animation",
        "game-show",
        "talk-show",
        "home-and-garden",
        "children",
        "reality",
        "anime",
        "news",
        "documentary",
        "special-interest"
      ],
      "blacklisted_max_year": 2019,
      "blacklisted_min_runtime": 15,
      "blacklisted_min_year": 2000,
      "blacklisted_networks": [
        "twitch",
        "youtube",
        "nickelodeon",
        "hallmark",
        "reelzchannel",
        "disney",
        "cnn",
        "cbbc",
        "the movie network",
        "teletoon",
        "cartoon network",
        "espn",
        "yahoo!",
        "fox sports"
      ],
      "blacklisted_tvdb_ids": []
    }
  },
  "notifications": {
    "pushover": {
      "service": "pushover",
      "app_token": "",
      "user_token": "",
      "priority": 0
    },
    "slack": {
      "service": "slack",
      "webhook_url": ""
    },
    "verbose": true
  },
  "radarr": {
    "api_key": "",
    "minimum_availability": "released",
    "profile": "HD-1080p",
    "root_folder": "/movies/",
    "url": "http://localhost:7878/"
  },
  "sonarr": {
    "api_key": "",
    "profile": "HD-1080p",
    "root_folder": "/tv/",
    "tags": {},
    "url": "http://localhost:8989/"
  },
  "trakt": {
    "client_id": "",
    "client_secret": ""
  },
  "omdb": {
    "api_key": ""
  }
}

Core

"core": {
  "debug": false
},

debug - Toggle debug messages in the log. Default is false.

Set to true, if you are having issues and want to diagnose why.

Automatic

Used for automatic / scheduled Traktarr tasks.

Movies can be run on a separate schedule then from Shows.

Note: These settings are only needed if you plan to use Traktarr on a schedule (vs just using it as a CLI command only; see Usage).

"automatic": {
  "movies": {
    "anticipated": 3,
    "boxoffice": 10,
    "interval": 24,
    "popular": 3,
    "trending": 2,
    "watched": 2,
    "played_all": 2,
    "watchlist": {},
    "lists": {},
  },
  "shows": {
    "anticipated": 10,
    "interval": 48,
    "popular": 1,
    "trending": 2,
    "watched_monthly": 2,
    "played": 2,
    "watchlist": {},
    "lists": {}
  }
},

interval - Specify how often (in hours) to run Traktarr task.

anticipated, popular, trending, boxoffice (movies only) - Specify how many items from each Trakt list to find.

watched - Adds items that are the most watched by unique Trakt users (multiple viewings excluded).

watched / watched_weekly - Most watched in the week.
watched_monthly - Most watched in the month.
watched_yearly - Most watched in the year.
watched_all - Most watched of all time.

played - Adds items that are most the played items by Trakt users (multiple viewings included).

played / played_weekly - Most played in the week.
played_monthly - Most played in the month.
played_yearly - Most played in the year.
played_all Most played of all time.

watchlist - Specify which watchlists to fetch (see explanation below).

lists - Specify which custom lists to fetch (see explanation below).

Personal Watchlists

The watchlist task can be scheduled with a different item limit for every (authenticated) user.

So for every user, you will add: "username": limit to the watchlist key. For example:

"automatic": {
  "movies": {
    "watchlist": {
        "user1": 10,
        "user2": 5
    }
  },
  "shows": {
    "watchlist": {
        "user1": 2,
        "user3": 1
    }
  }
},

Of course you can combine this with running the other list types as well.

Custom Lists

You can also schedule any number of public or private custom lists.

For both public and private lists you'll need the url to that list. When viewing the list on Trakt, simply copy the url from the address bar of the your browser.

Note: These are for non-watchlist lists. If you want to add a watchlist list, use the section above.

Public Lists

Public lists can be added by specifying the url and the item limit like this:

"automatic": {
  "movies": {
    "lists": {
        "https://trakt.tv/users/rkerwin/lists/top-100-movies": 10
    }
  },
  "shows": {
    "lists": {
        "https://trakt.tv/users/claireaa/lists/top-100-tv-shows-of-all-time-ign": 10
    }
  }
},

Private Lists

Private lists can be added in two ways:

If there is only one authenticated user, you can add the private list just like any other public list:

"automatic": {
  "movies": {
    "lists": {
        "https://trakt.tv/users/user/lists/my-private-movies-list": 10
    }
  },
  "shows": {
    "lists": {
        "https://trakt.tv/users/user/lists/my-private-shows-list": 10
    }
  }
},

If there are multiple authenticated users you want to fetch the lists from, you'll need to specify the username under authenticate_as.

Note: The user should have access to the list (either own the list or a list that was shared to them by a friend).

"automatic": {
  "movies": {
    "lists": {
        "https://trakt.tv/users/user/lists/my-private-movies-list": {
            "authenticate_as": "user2",
            "limit": 10
        }
    }
  },
  "shows": {
    "lists": {
        "https://trakt.tv/users/user/lists/my-private-shows-list": {
            "authenticate_as": "user2",
            "limit": 10
        }
    }
  }
},

Filters

Use filters to specify the movie/shows's country of origin or blacklist (i.e. filter-out) certain keywords, genres, years, runtime, or specific movies/shows.

Movies

  "movies": {
    "disabled_for": [],
    "allowed_countries": [
      "us",
      "gb",
      "ca"
    ],
    "allowed_languages": [],
    "blacklist_title_keywords": [
      "untitled",
      "barbie"
    ],
    "blacklisted_genres": [
      "documentary",
      "music",
      "animation"
    ],
    "blacklisted_max_year": 2019,
    "blacklisted_min_runtime": 60,
    "blacklisted_min_year": 2000,
    "blacklisted_tmdb_ids": [],
    "rating_limit": ""
  },

disabled_for - Specify for which lists the blacklist is disabled for, when running in automatic mode.

This is similar to running --ignore-blacklist via the CLI command.

Example:

"disabled_for": [
    "anticipated",
    "watchlist:user1",
    "list:http://url-to-list"
],

allowed_countries - Only add movies from these countries. Listed as two-letter country codes.

List of available country codes.
Special keywords (used as the only list item):
- any - Add movies from any country.
- ignore (also empty list i.e. []) - Like any, but also add movies even if it is missing a country.

allowed_languages - Only add movies with these languages. Listed as two-letter language codes.

By default, Traktarr will only query movies in English. If you need to search for other languages (e.g. Japanese for anime), you must add those languages here.
Languages are in ISO 639-1 format (e.g. ja for Japanese.)
List of available language codes.

blacklist_title_keywords - blacklist certain words in titles.

blacklisted_genres - Blacklist certain genres.

List of available movie genres.
For an updated list, visit here.
Special Keywords:
- Blank list (i.e. []) - Add movies from any genre.
- ignore (used as the only list item) - Add movies from any genre, including ones with no genre specified.

blacklisted_max_year - Blacklist release dates after specified year.

blacklisted_min_runtime - Blacklist runtime duration lower than specified time (in minutes).

blacklisted_min_year - Blacklist release dates before specified year.

blacklisted_tmdb_ids - Blacklist certain movies with their TMDB IDs.

Example:

"blacklisted_tmdb_ids": [
  140607,
  181808
],

rating_limit - Only add movies above this Rotten Tomatoes score.

Shows

"shows": {
  "allowed_countries": [
    "us",
    "gb",
    "ca"
  ],
  "allowed_languages": [],
  "blacklisted_genres": [
    "animation",
    "game-show",
    "talk-show",
    "home-and-garden",
    "children",
    "reality",
    "anime",
    "news",
    "documentary",
    "special-interest"
  ],
  "blacklisted_max_year": 2019,
  "blacklisted_min_runtime": 15,
  "blacklisted_min_year": 2000,
  "blacklisted_networks": [
    "twitch",
    "youtube",
    "nickelodeon",
    "hallmark",
    "reelzchannel",
    "disney",
    "cnn",
    "cbbc",
    "the movie network",
    "teletoon",
    "cartoon network",
    "espn",
    "yahoo!",
    "fox sports"
  ],
  "blacklisted_tvdb_ids": []
}

disabled_for - Specify for which lists the blacklist is disabled for, when running in automatic mode.

This is similar to running --ignore-blacklist via the CLI command.

Example:

"disabled_for": [
    "anticipated",
    "watchlist:user1",
    "list:http://url-to-list"
],

allowed_countries - Only add shows from these countries. Listed as two-letter country codes.

List of available country codes.
Special keywords (used as the only list item):
- any - Add shows from any country.
- ignore (also empty list i.e. []) - Like any, but also add shows even if it is missing a country.

allowed_languages - Only add shows with these languages.

By default, Traktarr will only query shows in English. If you need to search for other languages (e.g. Japanese for anime), you must add those languages here.
Languages are in ISO 639-1 format (e.g. ja for Japanese.)
List of available language codes.

blacklisted_genres - Blacklist certain genres.

List of available TV show genres.
For an updated list, visit here.
Special Keywords:
- Blank list (i.e. []) - Add shows from any genre.
- ignore (used as the only list item) - Add shows from any genre, including ones with no genre specified.

blacklisted_max_year - Blacklist release dates after specified year.

blacklisted_min_runtime - Blacklist runtime duration lower than specified time (in minutes).

blacklisted_min_year - Blacklist release dates before specified year.

blacklisted_networks - Blacklist certain network.

blacklisted_tvdb_ids - Blacklist certain shows with their TVDB IDs.

Example:

"blacklisted_tvdb_ids": [
  79274,
  85287,
  71256,
  194751,
  76733,
  336238
],

Notifications

"notifications": {
  "apprise": {
    "service": "apprise",
    "url": "",
    "title": ""
  },
  "verbose": false
},

Notification alerts for Traktarr tasks.

For auto (i.e. scheduled) runs, notifications are enabled automatically when notification services are listed in this section.

For manual (i.e. CLI) commands, you need to add the --notifications flag.

Supported services:

apprise
pushover
slack

Note: The key name can be anything, but the service key must be must be the exact service name (e.g. pushover). See below for example.

"notifications": {
  "anyname": {
    "service": "pushover",
  }
},

General

verbose - Toggle detailed notifications.

Default is true.
Set to false if you want to reduce the amount of detailed notifications (e.g. just the total vs the names of the movies/shows added).

"notifications": {
  "verbose": true
},

Apprise

"notifications": {
  "apprise": {
    "service": "apprise",
    "url": "",
    "title": ""
  },
  "verbose": false
},

url - Apprise service URL (see here).

Required.

title - Notification Title.

Optional.
Default is Traktarr.

Pushover

"notifications": {
  "pushover": {
    "service": "pushover",
    "app_token": "",
    "user_token": "",
    "priority": 0
  },
  "verbose": false
},

app_token - App Token from Pushover.net.

Required.

user_token - User Token from Pushover.net.

Required.

priority - Priority of the notifications.

Optional.
Choices are: -2, -1, 0, 1, 2.
Values are not quoted.
Default is 0.

Slack

"notifications": {
  "slack": {
    "service": "slack",
    "webhook_url": "",
    "channel": "",
    "sender_name": "Traktarr",
    "sender_icon": ":movie_camera:"
  },
  "verbose": false
},

webhook_url - Webhook URL.

Required.

channel - Slack channel to send the notifications to.

Optional.
Default is blank.

sender_name - Sender's name for the notifications.

Optional.
Default is Traktarr.

sender_icon - Icon to use for the notifications.

Optional.
Default is :movie_camera:

Radarr

Radarr configuration.

"radarr": {
  "api_key": "",
  "minimum_availability": "released",
  "profile": "HD-1080p",
  "root_folder": "/movies/",
  "url": "http://localhost:7878"
},

api_key - Radarr's API Key.

profile - Profile that movies are assigned to.

minimum_availability - The minimum availability the movies are set to.

Choices are announced, in_cinemas, released (Physical/Web), or predb.
Default is released (Physical/Web).

root_folder - Root folder for movies.

url - Radarr's URL.

Sonarr

Sonarr configuration.

"sonarr": {
  "api_key": "",
  "profile": "HD-1080p",
  "root_folder": "/tv/",
  "tags": {},
  "url": "http://localhost:8989"
},

api_key - Sonarr's API Key.

profile - Profile that TV shows are assigned to.

root_folder - Root folder for TV shows.

tags - Assign tags to shows based the network it airs on. More details on this below.

url - Sonarr's URL.

Trakt

Trakt Authentication info:

"trakt": {
  "client_id": "",
  "client_secret": ""
}

client_id - Fill in your Trakt API key (Client ID).

client_secret - Fill in your Trakt Secret key (Client Secret)

OMDB

OMDB Authentication info:

"omdb": {
  "api_key":""
}

api_key - Fill in your OMDB API key (This is only needed if you wish to use rating filtering on adding movies from command line/automatic)

Usage

Automatic (Scheduled)

Setup

To have Traktarr get Movies and Shows for you automatically, on set interval, do the following:

sudo cp /opt/traktarr/systemd/traktarr.service /etc/systemd/system/
sudo nano /etc/systemd/system/traktarr.service and edit user/group to match yours' (run id to check).
sudo systemctl daemon-reload
sudo systemctl enable traktarr.service
sudo systemctl start traktarr.service

Customize

You can customize how the scheduled Traktarr is ran by editing the traktarr.service file and adding any of the following options:

* Remember, other configuration options need to go into the config.json file under the Automatic section.

traktarr run --help

Usage: traktarr run [OPTIONS]

  Run in automatic mode.

Options:
  -d, --add-delay FLOAT           Seconds between each add request to Sonarr /
                                  Radarr.  [default: 2.5]
  -s, --sort [votes|rating|release]
                                  Sort list to process.
  --no-search                     Disable search when adding to Sonarr /
                                  Radarr.
  --run-now                       Do a first run immediately without waiting.
  --no-notifications              Disable notifications.
  --ignore-blacklist              Ignores the blacklist when running the
                                  command.
  --help                          Show this message and exit.

-d, --add-delay - Add seconds delay between each add request to Sonarr / Radarr. Default is 2.5 seconds.

Example: -d 5

-s, --sort - Sort list by highest votes, highest rating, or the latest release dates. Default is highest votes.

Example: -s release

--no-search - Tells Sonarr / Radarr to not automatically search for added shows / movies.

--run-now - Traktarr will run first automated search on start, without waiting for next interval.

--no-notifications - Disable notifications. Default is enabled.

--ignore-blacklist - Ignores blacklist filtering. Equivalent of disabled_for in config.json.

Example of a modified line from the traktarr.service file that will always add from the most recent releases matched:

ExecStart=/usr/bin/python3 /opt/traktarr/traktarr.py run -s release

Manual (CLI)

General

traktarr

Usage: traktarr [OPTIONS] COMMAND [ARGS]...

  Add new shows & movies to Sonarr/Radarr from Trakt.

Options:
  --version       Show the version and exit.
  --config PATH   Configuration file  [default: /opt/traktarr/config.json]
  --logfile PATH  Log file  [default: /opt/traktarr/activity.log]
  --help          Show this message and exit.

Commands:
  movie                 Add a single movie to Radarr.
  movies                Add multiple movies to Radarr.
  run                   Run Traktarr in automatic mode.
  show                  Add a single show to Sonarr.
  shows                 Add multiple shows to Sonarr.
  trakt_authentication  Authenticate Traktarr.

Movie (Single Movie)

traktarr movie --help

Usage: traktarr movie [OPTIONS]

  Add a single movie to Radarr.

Options:
  -id, --movie-id TEXT  Trakt Movie ID.  [required]
  -f, --folder TEXT     Add movie with this root folder to Radarr.
  -ma, --minimum-availability [announced|in_cinemas|released|predb]
                        Add movies with this minimum availability to Radarr.
  --no-search           Disable search when adding movie to Radarr.
  --help                Show this message and exit.

-id, --movie-id - ID/slug of the movie to add to Radarr. Supports both Trakt and IMDB IDs. This arguent is required.

-f, --folder - Add movie to a specific root folder in Radarr.

Example: -f /mnt/unionfs/Media/Movies/Movies-Kids/

minimum_availability - The minimum availability the movies are set to.

Choices are announced, in_cinemas, released (Physical/Web), or predb.
Default is released (Physical/Web).

--no-search - Tells Radarr to not automatically search for added movies.

Movies (Multiple Movies)

traktarr movies --help

Usage: traktarr movies [OPTIONS]

  Add multiple movies to Radarr.

Options:
  -t, --list-type TEXT            Trakt list to process. For example, anticipated, trending,
                                  popular, boxoffice, person, watched, recommended, played,
                                  watchlist or any URL to a list  [required]
  -l, --add-limit INTEGER         Limit number of movies added to Radarr.  [default: 0]
  -d, --add-delay FLOAT           Seconds between each add request to Radarr.  [default: 2.5]
  -s, --sort [rating|release|votes]
                                  Sort list to process.  [default: votes]
  -r, --rating INTEGER            Set a minimum rating threshold (according to Rotten Tomatoes)
  -g, --genre TEXT                Only add movies from this genre to Radarr.
  -f, --folder TEXT               Add movies with this root folder to Radarr.
  -ma, --minimum-availability [announced|in_cinemas|released|predb]
                                  Add movies with this minimum availability to Radarr.
  -a, --actor TEXT                Only add movies from this actor to Radarr.
  --no-search                     Disable search when adding movies to Radarr.
  --notifications                 Send notifications.
  --authenticate-user TEXT        Specify which user to authenticate with to retrieve Trakt lists.
                                  Default: first user in the config.
  --ignore-blacklist              Ignores the blacklist when running the command.
  --remove-rejected-from-recommended
                                  Removes rejected/existing movies from recommended.
  --help                          Show this message and exit.

-t, --list-type - Trakt list to process. Choices are: anticipated, trending, popular, boxoffice, watched, played, URL (Trakt list).

Watched Lists: Movies that are the most watched by unique Trakt users (multiple viewings excluded).
- watched / watched_weekly - Most watched in the week.
- watched_monthly - Most watched in the month.
- watched_yearly - Most watched in the year.
- watched_all - Most watched of all time.
Played Lists: Movies that are the most played by Trakt users (multiple viewings included).
- played / played_weekly - Most played in the week.
- played_monthly - Most played in the month.
- played_yearly - Most played in the year.
- played_all Most played of all time.

-l, --add-limit - Limit number of movies added to Radarr.

-d, --add-delay - Add seconds delay between each add request to Radarr. Default is 2.5 seconds.

Example: -d 5

-s, --sort - Sort list by highest votes, highest rating, or the latest release dates. Default is highest votes.

Example: -s release

-r, --rating - Only add movies above this Rotten Tomatoes score.

Example: -r 75

-g, --genre - Only add movies from this genre to Radarr.

Can find a list here.

-f, --folder - Add movies to a specific root folder in Radarr.

Example: -f /mnt/unionfs/Media/Movies/Movies-Kids/

minimum_availability - The minimum availability the movies are set to.

Choices are announced, in_cinemas, released (Physical/Web), or predb.
Default is released (Physical/Web).

-a, --actor - Only add movies with a specific actor to Radarr.

--no-search - Tells Radarr to not automatically search for added movies.

--notifications - To enable notifications. Default is disabled.

--authenticate-user - Specify which authenticated user to retrieve Trakt lists as. Default is the first user in the config.

--ignore-blacklist - Ignores blacklist filtering.

Equivalent of disabled_for in config.json.

--remove-rejected-from-recommended - Removes rejected/existing shows from the recommended list, so that it will be removed from further recommendations.

Show (Single Show)

traktarr show --help

Usage: traktarr show [OPTIONS]

  Add a single show to Sonarr.

Options:
  -id, --show-id TEXT  Trakt Show ID.  [required]
  -f, --folder TEXT    Add show with this root folder to Sonarr.
  --no-search          Disable search when adding show to Sonarr.
  --help               Show this message and exit.

-id, --show-id - ID/slug of the show to add to Sonarr. Supports both Trakt and IMDB IDs. This argument is required.

Shows (Multiple Shows)

traktarr shows --help

Usage: traktarr shows [OPTIONS]

  Add multiple shows to Sonarr.

Options:
  -t, --list-type TEXT            Trakt list to process. For example, anticipated, trending,
                                  popular, person, watched, played, recommended, watchlist or any
                                  URL to a list  [required]
  -l, --add-limit INTEGER         Limit number of shows added to Sonarr.  [default: 0]
  -d, --add-delay FLOAT           Seconds between each add request to Sonarr.  [default: 2.5]
  -s, --sort [rating|release|votes]
                                  Sort list to process.  [default: votes]
  -g, --genre TEXT                Only add shows from this genre to Sonarr.
  -f, --folder TEXT               Add shows with this root folder to Sonarr.
  -a, --actor TEXT                Only add movies from this actor to Radarr.
  --no-search                     Disable search when adding shows to Sonarr.
  --notifications                 Send notifications.
  --authenticate-user TEXT        Specify which user to authenticate with to retrieve Trakt lists.
                                  Default: first user in the config
  --ignore-blacklist              Ignores the blacklist when running the command.
  --remove-rejected-from-recommended
                                  Removes rejected/existing shows from recommended.
  --help                          Show this message and exit.

-t, --list-type - Trakt list to process. Choices are: anticipated, trending, popular, watched, played, URL (Trakt list).

Watched Lists: Shows that are the most watched by unique Trakt users (multiple viewings excluded).
- watched / watched_weekly - Most watched in the week.
- watched_monthly - Most watched in the month.
- watched_yearly - Most watched in the year.
- watched_all - Most watched of all time.
Played Lists: Shows that are the most played by Trakt users (multiple viewings included).
- played / played_weekly - Most played in the week.
- played_monthly - Most played in the month.
- played_yearly - Most played in the year.
- played_all Most played of all time.

-l, --add-limit - Limit number of shows added to Sonarr.

-d, --add-delay - Add seconds delay between each add request to Sonarr. Default is 2.5 seconds.

Example: -d 5

-s, --sort - Sort list by highest votes, highest rating, or the latest release dates. Default is highest votes.

Example: -s release

-g, --genre - Only add shows from this genre to Sonarr.

Can find a list here.

-f, --folder - Add shows to a specific root folder in Sonarr.

Example: -f /mnt/unionfs/Media/Shows/Shows-Kids/

-a, --actor - Only add shows with a specific actor to Sonarr.

--no-search - Tells Sonarr to not automatically search for added shows.

--notifications - To enable notifications. Default is disabled.

--authenticate-user - Specify which authenticated user to retrieve Trakt lists as. Default is the first user in the config.

--ignore-blacklist - Ignores blacklist filtering. Equivalent of disabled_for in config.json.

--remove-rejected-from-recommended - Removes rejected/existing shows from the recommended list, so that it will be removed from further recommendations.

Examples (CLI)

Movies

Add the movie "Black Panther (2018)":
```
traktarr movie -id black-panther-2018
```
Add movies, from the popular list, labeled with the thriller genre, limited to 5 items, and sorted by latest release date.
```
traktarr movies -t popular -g thriller -l 5 -s release
```
Add movies, from the Box Office list, labeled with the comedy genre, limited to 10 items, and send notifications:
```
traktarr movies -t boxoffice -g comedy -l 10 --notifications
```
Add movies, from a list of most watched played this week, and limited to 5 items.
```
traktarr movies -t watched -l 5
```
Add movies, from a list of most played movies this month, and limited to 5 items.
```
traktarr movies -t played_monthly -l 5
```
Add (all) movies from the public list https://trakt.tv/users/rkerwin/lists/top-100-movies:
```
traktarr movies -t https://trakt.tv/users/rkerwin/lists/top-100-movies
```

Add (all) movies from the private list https://trakt.tv/users/user1/lists/private-movies-list of user1:

traktarr movies -t https://trakt.tv/users/user1/lists/private-movies-list --authenticate-user=user1

Add movies, from the trending list, with a minimum rating of 80% on Rotten Tomatoes.
```
traktarr movies -t trending -r 80
```

Shows

Add the show "The 100":
```
traktarr show -id the-100
```
Add shows, from the popular list, limited to 5 items, and sorted by highest ratings.
```
traktarr shows -t popular -l 5 -s rating
```
Add shows, from the popular list, limited to 2 items, and add them but don't search for episodes in Sonarr:
```
traktarr shows -t popular -l 2 --no-search
```
Add shows, from a list of most watched shows this year, and limited to 5 items.
```
traktarr shows -t watched_yearly -l 5
```
Add shows, from a list of most played shows this week, and limited to 5 items.
```
traktarr shows -t played -l 5
```
Add shows, from a list of most played shows of all time, and limited to 5 items.
```
traktarr shows -t played_all -l 5
```

Add (all) shows from the watchlist of user1:

traktarr shows -t watchlist --authenticate-user user1

Donate

If you find this project helpful, feel free to make a small donation to the developer:

Monzo: Credit Cards, Apple Pay, Google Pay
Beerpay: Credit Cards
Paypal: l3uddz@gmail.com
BTC: 3CiHME1HZQsNNcDL6BArG7PbZLa8zUUgjL

README.md

Introduction

Demo

Requirements

Installation

1. Base Install

2. Create a Trakt Application

3. Authenticate User(s) (optional)

Configuration

Sample Configuration

Core

Automatic

Personal Watchlists

Custom Lists

Public Lists

Private Lists

Filters

Movies

Shows

Notifications

General

Apprise

Pushover

Slack

Radarr

Sonarr

Tags

Trakt

OMDB

Usage

Automatic (Scheduled)

Setup

Customize

Manual (CLI)

General

Movie (Single Movie)

Movies (Multiple Movies)

Show (Single Show)

Shows (Multiple Shows)

Examples (CLI)

Movies

Shows

Donate