mirror of
https://github.com/EstrellaXD/Auto_Bangumi.git
synced 2026-04-13 13:29:44 +08:00
Merge remote-tracking branch 'origin/main'
This commit is contained in:
EstrellaXD
@@ -2,7 +2,7 @@
|
||||
|
||||
- 需要依赖
|
||||
```bash
|
||||
pip install qbittorrent_api
|
||||
pip install qbittorrent-api
|
||||
```
|
||||
# 使用说明
|
||||
## rename_qb
|
||||
@@ -27,4 +27,4 @@ hash = $1
|
||||
QB 中调用该脚本并且引入 **%I** 属性
|
||||
|
||||
# 声明
|
||||
本项目的自动改名规则根据 [miracleyoo/anime_renamer](https://github.com/miracleyoo/anime_renamer) 项目
|
||||
本项目的自动改名规则根据 [miracleyoo/anime_renamer](https://github.com/miracleyoo/anime_renamer) 项目
|
||||
|
||||
301
自动追番机.md
Normal file
301
自动追番机.md
Normal file
@@ -0,0 +1,301 @@
|
||||
# 后版权时代，打造属于自己的全平台自动追番机
|
||||
|
||||
# 前言
|
||||
|
||||
好的时代总是转瞬即逝，作为一个看番接近十年的「老二次元」，观看动画的渠道不断更迭，从最开始的各种论坛找资源，再到看早期 bilibili 字幕组版本，随后迎接大版权时代之后，在各个版权平台反复横跳，最后倒最近这段可谓版权番剧的黑暗时代。索性初心还在，不断更迭自己的追番方式之余，我也在思考是否有一种让自己解放双手，节约时间的追番方式。因此在研习了其他大佬们的追番下载器之后，我做出了这套全流程简化的终极版自动追番机器。
|
||||
|
||||
本文由 Markdown 撰写，如果要活的较好的体验可以去我的仓库阅读
|
||||
|
||||
# 搭建思路
|
||||
|
||||
追番机器的思路非常简单，我在之前的文章中也提到过：
|
||||
|
||||
|
||||
|
||||
番剧的信息和下载地址由种子站/资源站提供，通过订阅 RSS 源到 qBittorrent 中，BT 软件可以订阅到所有当季新番的 RSS 种子推送，再手动设定/通过快捷指令调用 WebAPI 在 BT 软件中建立自动下载规则，设定好保存文件的路径，自动下载并且归类在本地硬盘中。再经由 Plex 等本地媒体服务器搜刮元数据，通过网页端的 Plex 或者推送 infuse 等终端播放器上，实现基本全自动的本地追番功能。
|
||||
|
||||
# 搭建过程
|
||||
|
||||
了解了思路之后就可以跟着笔者一起来搭建这套追番系统了，你可以用任何平台来搭建他：Windows/macOS/Linux，当然用一台能够 7x24 小时开机的 NAS 系统或者 Linux 系统的主机来搭建可以获得更好的追番体验。那么接下来，让我们 Drive in 吧。
|
||||
|
||||
## qBittorrent 安装
|
||||
|
||||
笔者使用 qBittorrent 作为 BT 下载工具，如果你熟悉使用 Aria2 或者其他下载工具可以跳过这一步骤。
|
||||
|
||||
**Windows/ macOS**
|
||||
|
||||
在 Win 或者 Mac 下，只需要在[官网](https://www.qbittorrent.org/download.php)下载其安装包，一路确定安装到底即可，不过为了之后的操作，你还需要在其 GUI 中打开 WebUI 以及 RSS 下载等几个选项。
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
打开 WebUI 以及 RSS 订阅的开关
|
||||
|
||||
之后你就可以在 `http://localhost:8181` 或者 `http://<HOST IP>:8181` 访问 qBittorrent 的 Web 端，并且可以对其发送 WebAPI 的指令了。
|
||||
|
||||
**Linux**
|
||||
|
||||
Linux 下我更推荐使用 Docker 进行安装，有关于 Docker 的安装本文不多赘述，可以通过以下指令一件安装：
|
||||
|
||||
```Bash
|
||||
docker run -d \
|
||||
--name=qbittorrent \
|
||||
-e PUID=1000 \
|
||||
-e PGID=1000 \
|
||||
-e TZ=Europe/London \
|
||||
-e WEBUI_PORT=8181 \
|
||||
-p 8080:8080 \
|
||||
-p 6881:6881 \
|
||||
-p 6881:6881/udp \
|
||||
-v /path/to/appdata/config:/config \
|
||||
-v /path/to/downloads:/downloads \
|
||||
--restart unless-stopped \
|
||||
lscr.io/linuxserver/qbittorrent:latest
|
||||
```
|
||||
|
||||
安装完成之后，一样可以通过 WebUI 访问 qB，同样打开 RSS 订阅以及自动下载的开关。
|
||||
|
||||
## RSS 源选择
|
||||
|
||||
关于 RSS 订阅，其实有很多选择，笔者使用的 蜜柑计划 就是其中之一，其他也可以选择诸如 动漫花园资源网 一样的资源网站，这里分别讲一下两者的用法区别：
|
||||
|
||||
**蜜柑计划：**
|
||||
|
||||
蜜柑计划是一个更偏向追番的资源网站，用户可以在首页看到各个番剧的更新状态，点开番剧之后可以看到不同的字幕组或者资源组更新的种子。你只需要订阅你所想看的番剧和其所属的资源组条目，订阅结果就会呈现在你的总 RSS 订阅中，每个季度你只要等待番剧更新，然后点击订阅，就可以等待 BT 软件读取 RSS 条目并且下载。
|
||||
|
||||
|
||||
|
||||
**动漫花园：**
|
||||
|
||||
与蜜柑计划不同的是，动漫花园更偏向于传统的 BT 站，不过其 RSS 订阅是根据搜索结果呈现的，你可以选择一个字幕组的 TAG 或者一个番剧的 TAG 或者两者一起进行搜索订阅，笔者更推荐订阅经常看的字幕组，再结合自动下载规则进行下载。
|
||||
|
||||
|
||||
|
||||
两者对比：
|
||||
|
||||
- 蜜柑计划：
|
||||
- 优点：UI 更加易用，订阅之后下载比较清爽，不会出现多个下载到同一个番剧多个字幕组的尴尬情况，而且不需要经常更新订阅的 RSS 源。
|
||||
- 缺点：每个季度都要上网站进行手动订阅，并且需要等待字幕组更新管理员添加进条目之后才可以订阅，季度开始的时候操作较为繁琐。
|
||||
- 动漫花园：
|
||||
- 优点：不仅可以追新番，也可以追日剧等其他资源。订阅字幕组之后不需要只需要添加规则就可以等待下载，季度初期操作会比较清爽。
|
||||
- 缺点：会有多个 RSS 订阅源，需要经常更新后续调用建立自动下载规则的脚本。
|
||||
|
||||
## 自动下载规则添加
|
||||
|
||||
订阅好 RSS 之后，我们还需要建立一些自动下载规则。BT 软件会定时更新 RSS 订阅源，但是更新的条目并不会自动下载。自动下载规则就是让 BT 软件匹配RSS 中的条目并且下载。
|
||||
|
||||
|
||||
|
||||
除了自动下载之外，自动下载规则还可以指定其保存的目录，在 BT 软件中种子的分类，以及选择需要匹配的 RSS 订阅源。这个功能极大的简化了我们整理下载文件的工作量，甚至可以说通过规范的设定下载规则，可以免除我们后期手动整理的步骤。
|
||||
|
||||
### 手动添加
|
||||
|
||||
自动下载规则可以被我们在 WebUI 或者 GUI 中手动添加，点击 `RSS 下载器` 之后点击左上角的添加按钮，就可以添加一个新的规则，并对其命名
|
||||
|
||||
|
||||
|
||||
添加完成之后，我们可以输入一些关键词让 BT 软件筛选：
|
||||
|
||||
|
||||
|
||||
当然这里我们也可以勾选使用正则表达式进行更细致的筛选，笔者先以简单的规则的为例子：我们选择标题内含有「夏日重现」的条目进行下载，过滤掉 720P 分辨率的视频。
|
||||
|
||||
|
||||
|
||||
然后在 UI 中断，可以选择保存的指定分类，以及存储的路径。设定完成之后，把想要下载的 RSS 订阅源打勾即可完成设置。此时如果 RSS 订阅源中出现了匹配的条目，将会出现在右侧，并且当你点按下 `保存` 之后就会自动开始下载。
|
||||
|
||||
### 脚本
|
||||
|
||||
细心的读者已经发现了，手动建立下载规则过于繁琐，那么有没有可以更加简化建立规则的方式呢。笔者在查看[ qBittorrent Github 项目](https://github.com/qbittorrent/qBittorrent)的时候，发现官方给出了非常丰富的 [WebAPI](https://github.com/qbittorrent/qBittorrent/wiki/WebUI-API-(qBittorrent-4.1)) 接口，简单的来说我们不需要打开软件或者网页端，只需要在局域网内，对着 qBittorrent 的端口发送一条符合规范的指令，qBittorrent 就会建立好我们需要的所有自动下载规则。笔者这里挑选两种实现方法进行讲解：
|
||||
|
||||
**快捷指令**
|
||||
|
||||
熟悉快捷指令的朋友一定知道，快捷指令具有发送 URL 请求的功能，通过这个功能，我们就能调用 qBittorrent 的 WebAPI。
|
||||
|
||||
首先我们来分析一下如何使用 WebAPI，在官方文档中，再调用其他接口之前，我们要先进行认证：
|
||||
|
||||
官方给出了如下的代码：
|
||||
|
||||
```Bash
|
||||
$ curl -i --header 'Referer: http://localhost:8080' --data 'username=admin&password=adminadmin' http://localhost:8080/api/auth/login
|
||||
```
|
||||
|
||||
换成快捷指令之后：
|
||||
|
||||
|
||||
|
||||
而添加 RSS 自动下载规则需要给 qBittorrent 发送一张表单：
|
||||
|
||||
| **Field** | **Type** | **Description** |
|
||||
| --------------------------- | -------- | --------------- |
|
||||
| `enabled` | bool | 是否启用规则 |
|
||||
| `mustContain` | string | 包含的字符 |
|
||||
| `mustNotContain` | string | 不包含的字符 |
|
||||
| `useRegex` | bool | 启用正则表达式 |
|
||||
| `episodeFilter` | string | 剧集过滤 |
|
||||
| `smartFilter` | bool | 是否启用剧集过滤 |
|
||||
| `previouslyMatchedEpisodes` | list | 与剧集过滤列表匹配的ID |
|
||||
| `affectedFeeds` | list | 需要匹配的 RSS 订阅地址 |
|
||||
| `ignoreDays` | number | 忽略一定时间之后的匹配项 |
|
||||
| `lastMatch` | string | 最后匹配时间 |
|
||||
| `addPaused` | bool | 添加到下载之后暂停 |
|
||||
| `assignedCategory` | string | 所属分类 |
|
||||
| `savePath` | string | 保存路径 |
|
||||
|
||||
发送的表单就是我们之前在 WebUI 中设定的各类条目，转化为快捷指令之后：
|
||||
|
||||
|
||||
|
||||
然后再通过 URL 发送给 qBittorrent：
|
||||
|
||||
|
||||
|
||||
完成了整体快捷指令框架之后，我们就可以做一些优化的设置：在运行快捷指令的时候，要求用户输入「番剧的名称」，用此名称作为番剧的匹配词条，并且建立以此名称为名的自动下载规则，存储路径也已番剧名称设定。在添加一个季度选项：
|
||||
|
||||
|
||||
|
||||
我们运行快捷指令的时候，就可以只输入一次番剧名称，并选择季度。就可以完成番剧自动下载，保存归类一系列操作。
|
||||
|
||||
笔者也将写好的快捷指令分享在这里：
|
||||
|
||||
[自动追番机-追番规则建立器](https://www.icloud.com/shortcuts/2c99841626244550ae595abd2429b802)
|
||||
|
||||
**Shell 脚本**
|
||||
|
||||
不过不一定所有的读者都有条件使用快捷指令，我们也可以使用 `curl` 命令发送，同样我们可以撰写一个 `bash` 脚本，windows 则为 `cmd` 脚本
|
||||
|
||||
```shell
|
||||
# ————————————————————————————以下为 Shell 脚本——————————————————————————————
|
||||
#!/bin/bash
|
||||
|
||||
BangumiName=$1
|
||||
ruleset={
|
||||
'enable':True,
|
||||
'mustContain':'$BangumiName',
|
||||
'mustNotContain':'720',
|
||||
'useRegx':True,
|
||||
'episodeFilter':'',
|
||||
'smartFilter':False,
|
||||
'previouslyMatchedEpisodes':[],
|
||||
'affectedFeeds':[],
|
||||
'ignoreDays':0,
|
||||
'lastMatch':'',
|
||||
'addPaused':False,
|
||||
'assignedCategory':'Bangumi',
|
||||
'savePath':'/path/$BangumiName'
|
||||
}
|
||||
|
||||
curl -i --header 'Referer: http://localhost:8080' --data 'username=admin&password=adminadmin' http://localhost:8080/api/v2/auth/login
|
||||
curl -i --data 'ruleName=$BangumiName&ruleDef=$ruleset' http://localhost:8080/api/v2/rss/setRule
|
||||
|
||||
# ——————————————————————————————以下为 CMD 脚本——————————————————————————————————
|
||||
set BangumiName=$1%
|
||||
set ruleset={
|
||||
'enable':True,
|
||||
'mustContain':'$BangumiName',
|
||||
'mustNotContain':'720',
|
||||
'useRegx':True,
|
||||
'episodeFilter':'',
|
||||
'smartFilter':False,
|
||||
'previouslyMatchedEpisodes':[],
|
||||
'affectedFeeds':[],
|
||||
'ignoreDays':0,
|
||||
'lastMatch':'',
|
||||
'addPaused':False,
|
||||
'assignedCategory':'Bangumi',
|
||||
'savePath':'/path/$BangumiName'
|
||||
}
|
||||
|
||||
curl -i --header 'Referer: http://localhost:8080' --data 'username=admin&password=adminadmin' http://localhost:8080/api/v2/auth/login
|
||||
curl -i --data 'ruleName=$BangumiName%&ruleDef=$ruleset%' http://localhost:8080/api/v2/rss/setRule
|
||||
```
|
||||
|
||||
运行：
|
||||
|
||||
```Bash
|
||||
/path/shell.sh <番剧名称> # UNIX
|
||||
/path/shell.cmd <番剧名称> # Windows
|
||||
```
|
||||
|
||||
即可完成和快捷指令一样的操作添加自动下载规则并且规划下载路径。
|
||||
|
||||
## 媒体搜刮 - Plex 安装与使用
|
||||
|
||||
完成下载之后我们还需要一个服务端对于下载好的文件进行收集以及元数据搜刮，笔者使用的 Plex 对于日本番剧的支持较好。
|
||||
|
||||
通向的 Win/Mac 可以在[官网下载](https://www.plex.tv/media-server-downloads/#plex-media-server)到 Plex Server（注意是 Server 不是 Client）
|
||||
|
||||
Linux 下同样推荐使用 Docker 进行安装，安装命令如下：
|
||||
|
||||
```Bash
|
||||
docker run -d \
|
||||
--name=plex \
|
||||
--net=host \
|
||||
-e PUID=1000 \
|
||||
-e PGID=1000 \
|
||||
-e VERSION=docker \
|
||||
-e PLEX_CLAIM= `#optional` \
|
||||
-v /path/to/library:/config \
|
||||
-v /path/to/tvseries:/tv \
|
||||
-v /path/to/movies:/movies \
|
||||
--restart unless-stopped \
|
||||
lscr.io/linuxserver/plex:latest
|
||||
```
|
||||
|
||||
需要注意的是，在 Plex 路径里面设定刚刚 qBittorrent 的下载路径为媒体文件夹路径。
|
||||
|
||||
完成安装之后，Plex会引导你进入 `https://127.0.0.1:32400` 也就是 Plex Server 的 WebUI，我们需要注册并登陆 Plex 账号：
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
设定媒体服务器，并且吧下载番剧的文件夹指定为「电视节目」即可。
|
||||
|
||||
进入 Plex 主界面之后，我们点击右上角的扳手图标，对资料库进行进一步设置：
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
完成这一系列设置之后，等待 Plex Server 对资料库进行扫描之后，我们应该就可以看到整整齐齐的番剧信息了。
|
||||
|
||||
|
||||
|
||||
当然，如果有元数据不匹配的情况，我们也可以点击封面右下角的选项进行修正匹配：
|
||||
|
||||
|
||||
|
||||
### 免费的联动 - infuse
|
||||
|
||||
Plex 虽然是一款免费的媒体服务器，但是如果要使用客户端的话还是要支出一笔不菲的订阅费用。这时候我们可以请出大家熟悉的 infuse 了，在 infuse 中添加媒体库的最下方，提供了联动 Plex 媒体库的选项，我们只需要点击添加 Plex 媒体库，并且登陆，就可以把我们的番剧资料库同时添加进 infuse 中。
|
||||
|
||||
|
||||
|
||||
而 infuse 只有在观看 4K 影片的时候才需要付费解锁，而大部分的动漫番剧均为 1080P，这样在客户端上我们也可以无限制的观看自己媒体库的番剧了。
|
||||
|
||||
|
||||
|
||||
## 意外情况处理
|
||||
|
||||
不过到这里，我们还有一点小问题需要处理，那就是 Plex 在检索元数据的时候，所使用的检索规则和大部分国内字幕组对番剧的命名规则不匹配，国内的番剧字幕组通常以以下这种形式对番剧进行命名：
|
||||
|
||||
而 Plex 对于中括号的识别非常糟糕，因此我们除了在选择订阅资源组的时候选择命名符合 Plex 识别规范的文件之外，也可以使用 Python 对不符合要求的番剧文件重命名。
|
||||
|
||||
先前也 [dalao ](https://github.com/miracleyoo/anime_renamer)写过自动重命名的脚本，不过他使用直接重命名的方式，会使得 qBittorrent 中丢失种子和文件的连接。我在 dalao 的其基础上稍加改进，由于 qBittorrent 中提供了更改文件名称的 API，我们只需要在程序中调用即可即更改名称，有不断开种子和文件的关联，并且通过 API 的方式也不需要让 Python 脚本运行在服务器上，在局域网内的任何一个设备上运行即可。
|
||||
|
||||
相关的程序可以去我的[ Github 仓库](https://github.com/EstrellaXD/Bangumi_Auto_Rename_qbittorrnet)下载。不过由于 Docker 运行的 qBittorrent 存在一些 bug，尝试需求也没成功调用在种子「下载完成之后运行程序」这一功能，因此我才用了 `crontab` 定时运行的方式，让脚本每半小时运行一次，即可完成番剧改名。
|
||||
|
||||
```shell
|
||||
crontab -e # 创建 crontab 脚本
|
||||
```
|
||||
|
||||
```shell
|
||||
0,30 * * * * python3 /path/rename_qb.py
|
||||
```
|
||||
|
||||
# 总结
|
||||
|
||||
至此，自动追番机器的搭建就已经全部完成。我们所需要做的仅仅是每季度番剧更新的时间进行 RSS 订阅，并且通过「快捷指令」或者 Shell 设定想要追的番剧，就可以在 Plex 或者 infuse 上享受一站式的追番体验了。
|
||||
|
||||
Reference in New Issue
Block a user