@ -1,4 +1,4 @@
# T raktarr
# t raktarr
Script to add new shows & movies to Sonarr/Radarr based on Trakt lists.
Script to add new shows & movies to Sonarr/Radarr based on Trakt lists.
Types of Trakt lists supported:
Types of Trakt lists supported:
@ -32,7 +32,7 @@ Types of Trakt lists supported:
## 1. Base Install
## 1. Base Install
Install T raktarr to be run with `traktarr` command.
Install t raktarr to be run with `traktarr` command.
1. `cd /opt`
1. `cd /opt`
2. `sudo git clone https://github.com/l3uddz/traktarr`
2. `sudo git clone https://github.com/l3uddz/traktarr`
@ -46,10 +46,10 @@ Install Traktarr to be run with `traktarr` command.
## 2. Create app authentication
## 2. Create app authentication
1. Create a Trakt application by going [here ](https://trakt.tv/oauth/applications/new )
1. Create a Trakt application by going [here ](https://trakt.tv/oauth/applications/new )
2. Enter a name for your application; for example ` T raktarr`
2. Enter a name for your application; for example ` t raktarr`
3. Enter `urn:ietf:wg:oauth:2.0:oob` in the `Redirect uri` field.
3. Enter `urn:ietf:wg:oauth:2.0:oob` in the `Redirect uri` field.
4. Click "SAVE APP".
4. Click "SAVE APP".
5. Open the T raktarr configuration file `config.json` and insert the Client ID in the `client_id` and the Client Secret in the `client_secret` , like this:
5. Open the t raktarr configuration file `config.json` and insert the Client ID in the `client_id` and the Client Secret in the `client_secret` , like this:
```
```
{
{
@ -83,16 +83,6 @@ Repeat the following steps for every user you want to authenticate:
You've now authenticated the user.
You've now authenticated the user.
You can repeat this process for as many users as you like.
You can repeat this process for as many users as you like.
## 4. Setup Schedule
To have Traktarr get Movies and Shows for you automatically, on set interval.
1. `sudo cp /opt/traktarr/systemd/traktarr.service /etc/systemd/system/`
2. `sudo systemctl daemon-reload`
3. `sudo systemctl enable traktarr.service`
4. `sudo systemctl start traktarr.service`
# Configuration
# Configuration
@ -226,9 +216,11 @@ To have Traktarr get Movies and Shows for you automatically, on set interval.
## Automatic
## Automatic
Used for automatic / scheduled T raktarr tasks.
Used for automatic / scheduled t raktarr tasks.
Movies can be run on a separate schedule from Shows.
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 (i.e. manually (via CLI) only) - see [Usage ](#usage ) section.._
```json
```json
"automatic": {
"automatic": {
@ -252,7 +244,7 @@ Movies can be run on a separate schedule from Shows.
},
},
```
```
`interval` - specify how often (in hours) to run T raktarr task.
`interval` - specify how often (in hours) to run t raktarr task.
`anticipated` , `popular` , `trending` , `boxoffice` (movies only) - specify how many items from each Trakt list to find.
`anticipated` , `popular` , `trending` , `boxoffice` (movies only) - specify how many items from each Trakt list to find.
@ -262,7 +254,8 @@ Movies can be run on a separate schedule from Shows.
### Personal Watchlists
### Personal Watchlists
The watchlist task can be scheduled with a differtent item limit for every (authenticated) user.*
The watchlist task can be scheduled with a differtent item limit for every (authenticated) user.
So for every user, you will add: `"username": limit` to the watchlist key. For example:
So for every user, you will add: `"username": limit` to the watchlist key. For example:
@ -563,9 +556,9 @@ Must not contain:
Tags: AMZN
Tags: AMZN
```
```
### T raktarr
### t raktarr
Finally, we will edit the T raktarr config and assign the `AMZN` tag to certain networks.
Finally, we will edit the t raktarr config and assign the `AMZN` tag to certain networks.
```json
```json
"tags": {
"tags": {
@ -611,8 +604,19 @@ Trakt Authentication info:
# Usage
# Usage
## Automatic (Scheduled)
## General
To have traktarr get Movies and Shows for you automatically, on set interval.
1. `sudo cp /opt/traktarr/systemd/traktarr.service /etc/systemd/system/`
2. `sudo nano /etc/systemd/system/traktarr.service` and edit user/group to match yours.
2. `sudo systemctl daemon-reload`
3. `sudo systemctl enable traktarr.service`
4. `sudo systemctl start traktarr.service`
## Manual
### General
```
```
traktarr
traktarr
@ -633,11 +637,11 @@ Commands:
movies Add new movies to Radarr.
movies Add new movies to Radarr.
run Run in automatic mode.
run Run in automatic mode.
shows Add new shows to Sonarr.
shows Add new shows to Sonarr.
trakt_authentication Authenticate Traktrarr to index your personal.. .
trakt_authentication Authenticate traktarr .
```
```
## Movies
### Movies
```
```
traktarr movies --help
traktarr movies --help
@ -663,11 +667,11 @@ Options:
--notifications Send notifications.
--notifications Send notifications.
--authencate-user TEXT Specify which user to authenticate with to
--authencate-user TEXT Specify which user to authenticate with to
retrieve Trakt lists. Default: first user in the
retrieve Trakt lists. Default: first user in the
config
config.
```
```
## Shows
### Shows
```
```
Usage: traktarr shows [OPTIONS]
Usage: traktarr shows [OPTIONS]
@ -688,7 +692,7 @@ Options:
--notifications Send notifications.
--notifications Send notifications.
--authencate-user TEXT Specify which user to authenticate with to
--authencate-user TEXT Specify which user to authenticate with to
retrieve Trakt lists. Default: first user in the
retrieve Trakt lists. Default: first user in the
config
config.
--help Show this message and exit.
--help Show this message and exit.
```
```