Install traktarr to be run with `traktarr` command.
@ -123,7 +124,7 @@ Install traktarr to be run with `traktarr` command.
8. `nano config.json` - edit preferences.
### 2. Create a Trakt Application
## 2. Create a Trakt Application
1. Create a Trakt application by going [here](https://trakt.tv/oauth/applications/new)
@ -144,7 +145,7 @@ Install traktarr to be run with `traktarr` command.
}
```
### 3. Authenticate User(s) (optional)
## 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.
@ -175,9 +176,9 @@ You've now authenticated the user.
You can repeat this process for as many users as you like.
## Configuration
# Configuration
### Sample Configuration
## Sample Configuration
```json
{
@ -303,7 +304,7 @@ You can repeat this process for as many users as you like.
```
### Core
## Core
```json
"core": {
@ -316,7 +317,7 @@ You can repeat this process for as many users as you like.
- Set to `true`, if you are having issues and want to diagnose why.
### Automatic
## Automatic
Used for automatic / scheduled traktarr tasks.
Movies can be run on a separate schedule then from Shows.
@ -377,7 +378,7 @@ _Note: These settings are only needed if you plan to use traktarr on a schedule
`lists` - Specify which custom lists to fetch (see explanation below).
#### Personal Watchlists
### Personal Watchlists
The watchlist task can be scheduled with a differtent item limit for every (authenticated) user.
@ -403,13 +404,13 @@ So for every user, you will add: `"username": limit` to the watchlist key. For e
Of course you can combine this with running the other list types as well.
#### Custom Lists
### 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.
##### Public Lists
#### Public Lists
Public lists can be added by specifying the url and the item limit like this:
@ -429,7 +430,7 @@ Public lists can be added by specifying the url and the item limit like this:
```
##### Private Lists
#### Private Lists
Private lists can be added in two ways:
@ -476,11 +477,11 @@ Private lists can be added in two ways:
```
### Filters
## 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
```json
"movies": {
@ -561,7 +562,7 @@ Use filters to specify the movie/shows's country of origin or blacklist (i.e. fi
`rating_limit` - Only add movies above this Rotten Tomatoes score.
#### Shows
### Shows
```json
"shows": {
@ -662,7 +663,7 @@ Use filters to specify the movie/shows's country of origin or blacklist (i.e. fi
```
### Notifications
## Notifications
Notification alerts for traktarr tasks.
@ -692,7 +693,7 @@ Currently, only Pushover and Slack are supported. More will be added later.
- Set to `false`, if you want to reduce the amount of detailed notifications (e.g. the names of the movies/shows added vs just the total).
#### Pushover
### Pushover
`app_token` and `user_token` - Retrieve from Pushover.net.
@ -701,14 +702,14 @@ You can specify a priority for the messages send via Pushover using the `priorit
_Note: The key name (i.e the name right under notifications) can be anything, but the `"service":` must be exactly `"pushover"`._
#### Slack
### Slack
`webhook_url` - Webhook URL you get after creating an "Incoming Webhook" under "Custom Integrations".
_Note: The key name (i.e the name right under notifications) can be anything, but the `"service":` must be exactly `"slack"`._
### Radarr
## Radarr
Radarr configuration.
@ -729,7 +730,7 @@ Radarr configuration.
`url` - Radarr's URL.
### Sonarr
## Sonarr
Sonarr configuration.
@ -755,7 +756,7 @@ Sonarr configuration.
`url` - Sonarr's URL.
#### Tags
### Tags
The `tags` option allows Sonarr to assign tags to shows from specific television networks, so that Sonarr can filter in/out certain keywords from releases.
@ -798,7 +799,7 @@ To show how tags work, we will create a tag `AMZN` and assign it to certain tele
}
```
### Trakt
## Trakt
Trakt Authentication info:
@ -813,7 +814,7 @@ Trakt Authentication info:
`client_secret` - Fill in your Trakt Secret key (_Client Secret_)
### OMDB
## OMDB
OMDB Authentication info:
@ -823,11 +824,12 @@ OMDB Authentication info:
}
```
`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)
# Usage
#### Setup
## Automatic (Scheduled)
### Setup
To have traktarr get Movies and Shows for you automatically, on set interval, do the following:
@ -841,7 +843,7 @@ To have traktarr get Movies and Shows for you automatically, on set interval, do
5. `sudo systemctl start traktarr.service`
#### Customize
### Customize
You can customize how the scheduled traktarr is ran by editing the `traktarr.service` file and adding any of the following options:
@ -894,11 +896,9 @@ Example of a modified line from the traktarr.service file that will always add f
ExecStart=/usr/bin/python3 /opt/traktarr/traktarr.py run -s release
```
## Manual (CLI)
### Manual (CLI)
#### General
### General
```
traktarr
@ -924,7 +924,7 @@ Commands:
trakt_authentication Authenticate traktarr.
```
#### Movie (Single Movie)
### Movie (Single Movie)
```
traktarr movie --help
@ -944,7 +944,7 @@ Options:
_Note: This command only works with `-id` or `--show_id` specified (i.e. not with lists), and supports both Trakt IDs and IMDB IDs._
#### Movies (Multiple Movies)
### Movies (Multiple Movies)
```
traktarr movies --help
@ -1032,7 +1032,7 @@ Options:
`--ignore-blacklist` - Ignores blacklist filtering. Equivalent of `disabled_for` in config.json.
#### Show (Single Show)
### Show (Single Show)
```
traktarr show --help
@ -1054,7 +1054,7 @@ Options:
_Note: This command only works with `-id` or `--show_id` specified (i.e. not with lists), and supports both Trakt IDs and IMDB IDs._
#### Shows (Multiple Shows)
### Shows (Multiple Shows)
```
traktarr shows --help
@ -1137,9 +1137,9 @@ Options:
`--ignore-blacklist` - Ignores blacklist filtering. Equivalent of `disabled_for` in config.json.
desimaniac
6 years ago
