cloudb0x/traktarr

Traktarr

概述

Traktarr使用Trakt.tv查找电视剧和电影，并分别添加到Sonarr和Radarr中。支持多种Trakt列表类型，包括官方列表、公共列表和私人列表，并支持多用户认证。

核心功能和特性

• 多列表支持：
  • 官方Trakt列表（趋势、热门、期待、票房、最多观看、最多播放）
  • 公共列表
  • 私人列表（监视列表、自定义列表）
• 多用户支持：可对多个用户进行认证以访问其私人列表
• 灵活的过滤系统：可按国家、语言、类型、年份、运行时间等过滤内容
• 自动化和手动操作：支持定时自动运行和手动CLI操作
• 通知集成：支持Apprise、Pushover和Slack通知
• 质量控制：可配置质量配置文件、根文件夹和最低可用性

要求

1. Debian操作系统（也可在其他操作系统上运行）
2. Python 3.5+
3. 所需的Python模块

安装

基础安装

将Traktarr安装到系统，以便可以使用traktarr命令运行。

1. 克隆Traktarr仓库：

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

2. 修复traktarr文件夹的权限（将user/group替换为你的信息；运行id命令查看）：

   bash
   sudo chown -R user:group /opt/traktarr
   

3. 进入traktarr文件夹：

   bash
   cd /opt/traktarr
   

4. 安装Python和PIP：

   bash
   sudo apt-get install python3 python3-pip
   

5. 安装所需的Python模块：

   bash
   sudo python3 -m pip install -r requirements.txt
   

6. 为traktarr创建快捷方式：

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

7. 生成基本的config.json文件：

   bash
   traktarr run
   

8. 配置config.json文件：

   bash
   nano config.json
   

创建Trakt应用

1. 通过访问此处创建Trakt应用

2. 输入应用名称，例如traktarr

3. 在Redirect uri字段中输入urn:ietf:wg:oauth:2.0:oob

4. 点击"SAVE APP"

5. 打开Traktarr配置文件config.json，将Trakt客户端ID插入client_id，将Trakt客户端密钥插入client_secret，如下所示：

   json
   "trakt": {
       "client_id": "your_trakt_client_id",
       "client_secret": "your_trakt_client_secret"
   }
   

认证用户（可选）

对于每个要访问其私人列表（即监视列表和/或自定义列表）的用户，你需要对该用户进行认证。

对每个要认证的用户重复以下步骤：

1. 运行以下命令：

   bash
   traktarr trakt_authentication
   

2. 你将看到以下提示：

   - 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
   

3. 访问[***]

4. 输入终端中显示的代码

5. 点击Continue

6. 如果你未登录Trakt.tv，请现在登录

7. 点击Accept

8. 你将收到消息："Woohoo! Your device is now connected and will automatically refresh in a few seconds."

现在你已认证该用户。你可以为任意数量的用户重复此过程。

配置

示例配置

json
{
  "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": [
        "en"
      ],
      "blacklisted_genres": [
        "documentary",
        "music",
        "animation"
      ],
      "blacklisted_max_runtime": 0,
      "blacklisted_min_runtime": 60,
      "blacklisted_min_year": 2000,
      "blacklisted_max_year": 2019,
      "blacklisted_title_keywords": [
        "untitled",
        "barbie",
        "ufc"
      ],
      "blacklisted_tmdb_ids": [],
      "rotten_tomatoes": ""
    },
    "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_networks": [
        "twitch",
        "youtube",
        "nickelodeon",
        "hallmark",
        "reelzchannel",
        "disney",
        "cnn",
        "cbbc",
        "the movie network",
        "teletoon",
        "cartoon network",
        "espn",
        "yahoo!",
        "fox sports"
      ],
      "blacklisted_max_runtime": 0,
      "blacklisted_min_runtime": 15,
      "blacklisted_min_year": 2000,
      "blacklisted_max_year": 2019,
      "blacklisted_title_keywords": [],
      "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",
    "quality": "HD-1080p",
    "root_folder": "/movies/",
    "url": "http://localhost:7878/"
  },
  "sonarr": {
    "api_key": "",
    "language": "English",
    "quality": "HD-1080p",
    "root_folder": "/tv/",
    "tags": [],
    "url": "http://localhost:8989/"
  },
  "trakt": {
    "client_id": "",
    "client_secret": ""
  },
  "omdb": {
    "api_key": ""
  }
}

核心配置

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

debug - 切换日志中的调试消息。默认为false。

• 如果遇到问题并想要诊断原因，请设置为true。

自动配置

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

用于自动/计划Traktarr任务。电影可以与电视剧分开安排。

注意：仅当你计划按计划使用Traktarr时才需要这些设置（而不是仅将其用作CLI命令；请参见用法）。

格式：

• "列表名称": 要添加到Radarr/Sonarr的项目数量。

注意：指定的数字是将添加到Radarr/Sonarr的项目数量。它不是Trakt列表限制，即不会查找前X个项目。

时间间隔

interval - 指定运行Traktarr任务的频率（以小时为单位）。

• 将interval设置为0将跳过该任务的计划。
• 例如，如果你只想添加电影而不是电视剧，可以将电视剧的interval设置为0。

官方Trakt列表

anticipated - Trakt期待列表。

• 基于电影/电视剧出现在列表中的数量，最受期待的电影/电视剧。

popular - Trakt热门列表。

• 最热门的电影/电视剧。受欢迎程度使用评分百分比和评分数量计算。

trending - Trakt趋势列表。

• 现在正在观看的所有电影/电视剧。用户最多的电影将首先返回。

boxoffice - Trakt票房列表。仅限电影。

• 上周末美国票房收入最高的10部电影。每周一早上更新。

watched - 在指定时间段内观看次数最多（唯一用户）的电影。

• watched / watched_weekly - 一周内观看次数最多。
• watched_monthly - 一个月内观看次数最多。
• watched_yearly - 一年内观看次数最多。
• watched_all - 有史以来观看次数最多。

played - 在指定时间段内播放次数最多（单个用户可以多次观看）的项目。

• played / played_weekly - 一周内播放次数最多。
• played_monthly - 一个月内播放次数最多。
• played_yearly - 一年内播放次数最多。
• played_all - 有史以来播放次数最多。

watchlist - 指定要获取的监视列表（见下文说明）。

自定义列表

lists - 指定要获取的自定义列表（见下文说明）。

你还可以安排任意数量的公共或私人自定义列表。

对于公共和私人列表，你都需要该列表的URL。在Trakt上查看列表时，只需从浏览器的地址栏复制URL。

注意：这些用于非监视列表。如果你想添加监视列表，请使用下面的部分。

公共列表

可以通过指定URL和项目限制来添加公共列表，如下所示：

json
"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
    }
  }
},

私人列表

私人列表可以通过两种方式添加：

1. 如果只有一个已认证用户，你可以像添加任何其他公共列表一样添加私人列表：

   json
   "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
       }
     }
   },
   

2. 如果你想从多个已认证用户获取列表，你需要在authenticate_as下指定用户名。

   注意：用户应具有列表的访问权限（要么拥有列表，要么是朋友共享的列表）。

   json
   "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
           }
       }
     }
   },
   

个人Trakt监视列表

可以为每个（已认证）用户设置不同的项目限制来安排监视列表任务。

因此，对于每个用户，你将添加："username": limit到watchlist键。例如：

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

过滤器

使用过滤器指定电影/电视剧的原产国或黑名单（即过滤掉）某些关键词、类型、年份、运行时间或特定电影/电视剧。

电影过滤器

json
"movies": {
  "disabled_for": [],
  "allowed_countries": [
    "us",
    "gb",
    "ca"
  ],
  "allowed_languages": [],
  "blacklisted_genres": [
    "documentary",
    "music",
    "animation"
  ],
  "blacklisted_max_runtime": 0,
  "blacklisted_min_runtime": 60,
  "blacklisted_min_year": 2000,
  "blacklisted_max_year": 2019,
  "blacklisted_title_keywords": [
    "untitled",
    "barbie"
  ],
  "blacklisted_tmdb_ids": [],
  "rotten_tomatoes": ""
},

disabled_for - 指定在自动模式下禁用黑名单的列表。

• 类似于通过CLI命令运行--ignore-blacklist。
• 示例：

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

allowed_countries - 仅添加来自这些国家的电影。以两个字母的国家代码列出。

• 可用国家代码列表。
• 特殊关键字：
  • 空列表（即[]）- 添加来自任何国家的电影。
  • ignore（即["ignore"]）- 添加来自任何国家的电影，包括未指定国家的电影。

allowed_languages - 仅添加具有这些语言的电影。以两个字母的语言代码列出。

• 语言采用ISO 639-1格式（例如ja表示日语）。
• 可用语言代码列表。
• 特殊关键字：
  • 空列表（即[]）- 添加具有任何语言的电影。
  • ignore（即["ignore"]）- 添加具有任何语言的电影，包括未指定语言的电影。

blacklisted_genres - 黑名单特定类型。

• 可用电影类型列表。
• 有关更新的列表，请访问此处。
• 特殊关键字：
  • 空列表（即[]）- 添加任何类型的电影。
  • ignore（即["ignore"]）- 添加任何类型的电影，包括未指定类型的电影。

blacklisted_min_runtime - 黑名单短于指定时间（以分钟为单位）的运行时间。

blacklisted_max_runtime - 黑名单长于指定时间（以分钟为单位）的运行时间。

• 必须长于blacklisted_min_runtime，否则将被忽略。

blacklisted_min_year - 黑名单指定年份之前的发布日期。可以是4位数字年份、0或-<回溯年数>格式。

• 如果为0，则黑名单当前年份之前发布的电影。
• 如果为`-10