mikenye/striparr

mikenye/striparr

从Sonarr和Radarr导入的项目中去除“干扰”元数据，通过Webhook触发。

此工具会从媒体容器文件中剥离特定元数据标签，允许媒体管理系统（如Plex）基于其媒体扫描器收集的元数据命名文件。例如，可防止电影文件被命名为Title.year.quality.releasegroup格式。

Striparr将移除的元数据字段：

• 文件的title字段
• 文件的comment字段

媒体文件内的流不会被修改。

免责声明

由于此工具通过ffmpeg处理媒体文件，可能存在导致文件损坏的风险。

对于因使用此容器或其中任何代码而发生的任何情况，作者不承担责任。

使用风险自负！

话虽如此，若使用Striparr遇到问题，请https://github.com/mikenye/docker-striparr/issues%EF%BC%8C%E4%BD%9C%E8%80%85%E5%B0%86%E5%B0%BD%E5%8A%9B%E6%8F%90%E4%BE%9B%E5%B8%AE%E5%8A%A9%E3%80%82%E8%AF%B7%E9%99%84%E4%B8%8A%E5%AE%B9%E5%99%A8%E6%97%A5%E5%BF%97%E5%8F%8A%E5%85%B6%E4%BB%96%E7%9B%B8%E5%85%B3%E6%8A%80%E6%9C%AF%E4%BF%A1%E6%81%AF%E3%80%82

工作原理

1. Sonarr/Radarr通过Webhook通知Striparr有新文件导入媒体库。
2. Striparr启动ffmpeg扫描文件，识别元数据标签。
3. 若文件不含干扰元数据字段，Striparr不做进一步处理；若存在上述干扰元数据字段：
   1. Striparr对所有音频、视频和字幕流执行ffmpeg流复制，生成新文件（Original_Filename.striparr.Original_Extension），并将干扰元数据字段设为空值。
   2. Striparr用新文件覆盖旧文件。

为减少磁盘IO，Striparr将所有请求（在内存中）排队，由单个工作进程按顺序处理。任何时候只会运行一个ffmpeg进程。

前提条件

Sonarr和/或Radarr需能够通过TCP端口40000连接到此容器。

快速启动

建议Sonarr和/或Radarr容器（及其他支持容器）与Striparr在同一Docker网络中运行，以便简化Webhook设置。以下示例中，Sonarr、Radarr和Striparr运行在arr网络中。

为去除元数据，媒体卷的挂载方式必须与Sonarr和Radarr容器完全一致。Striparr无需配置卷挂载，所有配置通过环境变量完成。

例如，若Sonarr和Radarr容器运行命令如下：

shell
docker run \
-d \
--name sonarr \
--restart=always \
--network=arr \
-e PUID=500 \
-e PGID=1000 \
-v /opt/Sonarr:/config \
-v /path/to/tv:/path/to/tv \
-v /path/to/downloads:/path/to/downloads \
-p 8989:8989 \
linuxserver/sonarr

docker run \
-d \
--name radarr \
--restart=always \
--network=arr \
-e PUID=500 \
-e PGID=1000 \
-v /opt/Radarr:/config \
-v /path/to/movies:/path/to/movies \
-v /path/to/downloads:/path/to/downloads \
-p 7878:7878 \
linuxserver/radarr

则Striparr容器运行命令如下：

shell
docker run \
-d \
--name striparr \
--network=arr \
--restart=always \
-e PUID=500 \
-e PGID=1000 \
-v /path/to/tv:/path/to/tv \
-v /path/to/movies:/path/to/movies \
mikenye/striparr

重要提示：

• 从Sonarr和Radarr容器挂载的媒体卷必须以完全相同的路径呈现给Striparr。
• Sonarr和Radarr容器设置的PUID和PGID环境变量必须与Striparr完全相同。

更优方案是使用docker-compose.yml文件，在其中定义Sonarr、Radarr、支持容器及Striparr。

Sonarr/Radarr配置

为使Sonarr和/或Radarr在文件下载时通知Striparr（以便Striparr处理），需添加Webhook。

两个应用的配置步骤如下：

1. 进入“设置” > “连接”。
2. 点击“+”按钮添加新通知。
3. 在弹出的“添加通知”对话框中，向下滚动并选择“Webhook”。
4. 按以下方式填写对话框：
   • “名称”设为Striparr。
   • Sonarr v2：确保启用“On Download”（其他事件可忽略，但建议全部启用，Striparr会忽略无法使用的事件）。
   • Sonarr v3：确保启用“On Upgrade”（其他事件可忽略，但建议全部启用，Striparr会忽略无法使用的事件）。
   • Radarr：确保启用“On Download”（其他事件可忽略，但建议全部启用，Striparr会忽略无法使用的事件）。
   • “URL”设为http://striparr:40000（根据环境需要修改URL）。
   • 若有“方法”下拉菜单，选择POST。
   • 点击“测试”。容器日志会记录收到测试Webhook（见下方示例）。Sonarr/Radarr应显示测试成功，然后点击“保存”。

Striparr收到测试Webhook的容器日志如下：

text
[listener] [2020-11-24 03:58:33,491: INFO] [172.16.29.3] [Sonarr/3.0.4.1021 (ubuntu 18.04)] Received a Sonarr style webhook test
[listener] [2020-11-24 03:59:46,743: INFO] [172.16.29.4] [Radarr/3.0.0.4107 (ubuntu 20.04)] Received a Radarr style webhook test

此后，当Sonarr和/或Radarr下载并导入项目到媒体库时，Striparr会自动去除该项目的干扰元数据。

运行时配置选项

启动容器时应设置以下环境变量：

• TZ - 本地时区（可选，默认：UTC）。
• PUID - Striparr运行的用户ID（默认：1000）。
• PGID - Striparr运行的组ID（默认：1000）。

必须确保PUID和PGID与Sonarr和Radarr的设置一致。

邮件告警

启动容器时可设置以下环境变量启用邮件告警：

• ALERT_EMAIL_ENABLE - 设置任意值以启用邮件告警（可选，默认禁用）。

若启用ALERT_EMAIL_ENABLE，还需设置以下值：

• ALERT_EMAIL_TO - 告警目标***地址。
• ALERT_EMAIL_FROM - 告警邮件发件人地址。
• ALERT_EMAIL_SMTP_HOST - SMTP服务器主机名/IP。
• ALERT_EMAIL_SMTP_PORT - SMTP服务器TCP端口（默认：25）。

端口

Striparr在TCP端口40000上监听Webhook。

若Striparr容器与Sonarr/Radarr在同一Docker网络中，无需映射此端口（即无需在docker run命令中添加-p 40000:40000）。

日志

Striparr日志输出到容器的stdout，可通过docker logs [-f] container查看。

建议为容器日志设置轮转，详见：https://success.docker.com/article/how-to-setup-log-rotation-post-installation

手动处理文件

若需处理现有文件，可使用容器内的manually_process.py脚本。运行脚本的语法如下：

text
docker exec -it striparr /manually_process.py /path/to/media/file

该脚本向Striparr发送Webhook（与Sonarr/Radarr方式相同），因此需指定容器文件系统中的完整路径，相对路径无效。

最简单的方法是进入容器 shell（如：docker exec -it striparr sh），然后使用Tab补全路径。

示例：

text
docker-host$ docker exec -it striparr sh

<进入容器shell后>

/ # /manually_process.py /path/to/movie/file.mkv
Request sent to striparr - see striparr log for details

/ # exit

<返回主机>

docker-host$ docker logs striparr | tail -5

[listener] [2019-10-15 03:25:02,607: INFO] [127.0.0.1] [python-requests/2.22.0] Enqueuing processing of file: "/path/to/movie/file.mkv"
[worker] [2019-10-15 03:25:02,660: INFO/ForkPoolWorker-1] striparr.worker[2d5f7af2-ef03-11e9-81b4-2a2ae2dbcce4]: Checking: "/path/to/movie/file.mkv"
[worker] [2019-10-15 03:25:02,778: INFO/ForkPoolWorker-1] striparr.worker[2d5f7af2-ef03-11e9-81b4-2a2ae2dbcce4]: Creating clean version of: "/path/to/movie/file.mkv" in file "/path/to/movie/file.striparr.mkv"
[worker] [2019-10-15 03:25:26,277: INFO/ForkPoolWorker-1] striparr.worker[2d5f7af2-ef03-11e9-81b4-2a2ae2dbcce4]: Overwriting: "/path/to/movie/file.mkv" with clean file: "/path/to/movie/file.striparr.mkv"
[worker] [2019-10-15 03:25:29,379: INFO/ForkPoolWorker-1] striparr.worker[2d5f7af2-ef03-11e9-81b4-2a2ae2dbcce4]: File is now clean: "/path/to/movie/file.mkv"!

此外，用户https://github.com/angrycuban13%E5%9C%A8https://github.com/tronyx%E7%9A%84%E5%B8%AE%E5%8A%A9%E4%B8%8B%EF%BC%8C%E4%B8%BAWindows%E7%94%A8%E6%88%B7%E7%BC%96%E5%86%99%E4%BA%86%E2%80%9C%E6%89%B9%E9%87%8F%E5%A4%84%E7%90%86%E2%80%9D%E7%8E%B0%E6%9C%89%E6%96%87%E4%BB%B6%E7%9A%84%E6%96%B9%E6%B3%95%EF%BC%8C%E8%AF%A6%E8%A7%81https://github.com/mikenye/docker-striparr/issues/15#issue-777675331%E3%80%82

获取帮助

欢迎https://github.com/mikenye/docker-striparr/issues%E3%80%82

作者还设有***频道，欢迎加入交流。