tommythebeast/arrstalledhandler

ArrStalledHandler

ArrStalledHandler是一个基于Python的脚本，旨在处理Radarr、Sonarr、Lidarr和Readarr中的停滞下载，通过执行移除、阻止列表或阻止列表并重新搜索受影响项目等操作。它支持通过.env文件进行配置，提供日志功能以确保可见性，并可通过Docker部署以方便使用。

本仓库采用https://github.com/tommyvange/ArrStalledHandler/blob/main/LICENSE 授权。

由https://github.com/tommyvange 创建。完整的贡献者列表请参见https://github.com/tommyvange/ArrStalledHandler/blob/main/README.md#credits%E3%80%82

该项目可在https://github.com/tommyvange/ArrStalledHandler%E3%80%81https://hub.docker.com/r/tommythebeast/arrstalledhandler%E5%92%8Chttps://github.com/tommyvange/ArrStalledHandler/blob/main/README.md#unraid-deployment%E8%8E%B7%E5%8F%96%E3%80%82

https://github.com/tommyvange/ArrStalledHandler/actions/workflows/publish-docker-image.yml/badge.svg](https://github.com/tommyvange/ArrStalledHandler/actions/workflows/publish-docker-image.yml) https://github.com/tommyvange/ArrStalledHandler/actions/workflows/check-docker-image.yml/badge.svg?branch=main](https://github.com/tommyvange/ArrStalledHandler/actions/workflows/check-docker-image.yml)

---

核心功能和特性

• 自动处理停滞下载：
  • 根据Radarr/Sonarr/Lidarr/Readarr队列中的错误消息检测停滞下载。
  • 检测qBittorrent中状态为“Downloading Metadata”（正在下载元数据）的下载并将其视为停滞。
  • 执行可配置的操作，例如：
    • 移除停滞下载。
    • 阻止列表停滞下载。
    • 阻止列表并重新触发电影或剧集的搜索。
• 数据库跟踪：
  • 将停滞下载记录在SQLite数据库中，确保仅在指定超时时间后执行操作。
• 日志功能：
  • 通过配置控制详细且信息丰富的日志。
• Docker支持：
  • 可通过Docker轻松部署，并支持自定义运行间隔。

---

配置说明

脚本通过.env文件中指定的环境变量进行完全配置。以下是各配置选项的说明：

.env变量

若要禁用Radarr或Sonarr等服务，可将对应的URL留空。如果服务没有URL，则会被跳过。支持通过逗号分隔值配置多个服务实例。

---

工作原理

脚本工作流程

1. 初始化：

   • 脚本初始化SQLite数据库（stalled_downloads.db）以跟踪停滞下载。
   • 从Radarr、Sonarr、Lidarr和Readarr的API获取当前队列。

2. 检测停滞下载：

   • 根据错误消息"The download is stalled with no connections"（下载停滞且无连接）识别停滞下载。
   • 【可选】根据错误消息"qBittorrent is downloading metadata"（qBittorrent正在下载元数据）将下载视为停滞（需启用COUNT_DOWNLOADING_METADATA_AS_STALLED）。

3. 超时检查：

   • 仅当下载停滞时间超过配置的STALLED_TIMEOUT时，才会处理该下载。

4. 执行配置的操作：

   • 根据STALLED_ACTION设置执行操作：
     • REMOVE：移除停滞下载。
     • BLOCKLIST：移除并阻止列表停滞下载。
     • BLOCKLIST_AND_SEARCH：移除、阻止列表并重新触发电影或剧集的搜索。

5. 日志记录：

   • 记录每个操作的详细信息，确保可见性。

6. 重复执行：

   • 在Docker中运行时，脚本等待RUN_INTERVAL后重复上述过程。

---

部署方法

Unraid部署

!Unraid社区应用商店中的应用截图

1. 按照此指南安装Community Apps扩展。
2. 在Unraid Web界面中进入应用部分。
3. 搜索ArrStalledHandler。
4. 点击应用的安装按钮。
5. 根据配置说明填写变量。
6. 点击应用。

容器将自动启动并开始处理停滞下载。

Docker部署（https://hub.docker.com/r/tommythebeast/arrstalledhandler%EF%BC%89

Docker Compose

更多信息参见Docker文档。

yaml
services:
  arr-stalled-handler:
    image: tommythebeast/arrstalledhandler:latest
    container_name: ArrStalledHandler
    restart: unless-stopped
    environment:
      RADARR_URL: "http://localhost:7878,http://otherhost:7878"
      RADARR_API_KEY: "your_radarr_api_key,your_2nd_radarr_api_key"
      SONARR_URL: "http://localhost:8989,http://otherhost:8989"
      SONARR_API_KEY: "your_sonarr_api_key,your_2nd_sonarr_api_key"
      LIDARR_URL: "http://localhost:8686,http://otherhost:8686"
      LIDARR_API_KEY: "your_lidarr_api_key,your_2nd_lidarr_api_key"
      READARR_URL: "http://localhost:8787,http://otherhost:8787"
      READARR_API_KEY: "your_readarr_api_key,our_2nd_readarr_api_key"
      STALLED_TIMEOUT: "3600"
      STALLED_ACTION: "BLOCKLIST_AND_SEARCH"
      VERBOSE: "false"
      RUN_INTERVAL: "300"
      COUNT_DOWNLOADING_METADATA_AS_STALLED: "false"

Docker CLI

更多信息参见Docker文档。

多行命令：

bash
docker run -d \
  --name=ArrStalledHandler \
  -e RADARR_URL=http://localhost:7878,http://otherhost:7878 \
  -e RADARR_API_KEY=your_radarr_api_key,your_2nd_radarr_api_key \
  -e SONARR_URL=http://localhost:8989,http://otherhost:8989 \
  -e SONARR_API_KEY=your_sonarr_api_key,your_2nd_sonarr_api_key \
  -e LIDARR_URL=http://localhost:8686,http://otherhost:8686 \
  -e LIDARR_API_KEY=your_lidarr_api_key,your_2nd_lidarr_api_key \
  -e READARR_URL=http://localhost:8787,http://otherhost:8787 \
  -e READARR_API_KEY=your_readarr_api_key,our_2nd_readarr_api_key \
  -e STALLED_TIMEOUT=3600 \
  -e STALLED_ACTION=BLOCKLIST_AND_SEARCH \
  -e VERBOSE=false \
  -e RUN_INTERVAL=300 \
  -e COUNT_DOWNLOADING_METADATA_AS_STALLED=false \
  --restart unless-stopped \
  tommythebeast/arrstalledhandler:latest

单行命令：

bash
docker run -d --name=ArrStalledHandler -e RADARR_URL=http://localhost:7878,http://otherhost:7878 -e RADARR_API_KEY=your_radarr_api_key,your_2nd_radarr_api_key -e SONARR_URL=http://localhost:8989,http://otherhost:8989 -e SONARR_API_KEY=your_sonarr_api_key,your_2nd_sonarr_api_key -e LIDARR_URL=http://localhost:8686,http://otherhost:8686  -e LIDARR_API_KEY=your_lidarr_api_key,your_2nd_lidarr_api_key -e READARR_URL=http://localhost:8787,http://otherhost:8787 -e READARR_API_KEY=your_readarr_api_key,our_2nd_readarr_api_key -e STALLED_TIMEOUT=3600 -e STALLED_ACTION=BLOCKLIST_AND_SEARCH -e VERBOSE=false -e RUN_INTERVAL=300 -e COUNT_DOWNLOADING_METADATA_AS_STALLED=false --restart unless-stopped tommythebeast/arrstalledhandler:latest

Docker手动部署

1. 克隆仓库：

   bash
   git clone https://github.com/your-username/ArrStalledHandler.git
   cd ArrStalledHandler
   

2. 配置环境： 创建.env文件并填充所需变量：

   env
   RADARR_URL=http://localhost:7878,http://otherhost:7878
   RADARR_API_KEY=aaaabbbbcccc111122223333,xxxxyyyyzzzz777788889999
   SONARR_URL=http://localhost:8989,http://otherhost:8989
   SONARR_API_KEY=aaaabbbbcccc111122223333,xxxxyyyyzzzz777788889999
   LIDARR_URL=http://localhost:8686,http://otherhost:8686
   LIDARR_API_KEY=aaaabbbbcccc111122223333,xxxxyyyyzzzz777788889999
   READARR_URL=http://localhost:8787,http://otherhost:8787
   READARR_API_KEY=aaaabbbbcccc111122223333,xxxxyyyyzzzz777788889999
   STALLED_TIMEOUT=3600
   STALLED_ACTION=BLOCKLIST_AND_SEARCH
   VERBOSE=false
   RUN_INTERVAL=300
   COUNT_DOWNLOADING_METADATA_AS_STALLED=false
   

3. 构建Docker镜像：

   bash
   docker-compose build .
   

4. 运行Docker容器：

   bash
   docker-compose up -d
   

本地安装

需要Python 3.13

1. 克隆仓库：

   bash
   git clone https://github.com/your-username/ArrStalledHandler.git
   cd ArrStalledHandler
   

2. 安装依赖：

   bash
   pip install -r requirements.txt
   

3. 配置环境： 创建.env文件并填充所需变量（内容同上）。

4. 运行脚本：

   bash
   python main.py
   

---

日志

• 日志输出到控制台，由VERBOSE环境变量控制。
• 若VERBOSE设为true，则启用调试级日志。

示例日志输出：

text
INFO: 正在检查Radarr中的停滞下载...
INFO: 处理Radarr中的下载ID 1462067687（已停滞时间：400秒）。
INFO: 通过命令API触发Radarr中电影ID 770的搜索...
INFO: 脚本执行完成。休眠300秒...

---

故障排除

1. 脚本未执行操作：
   • 检查STALLED_TIMEOUT是否设置过高。
   • 验证Radarr/Sonarr/Lidarr/Readarr队列中是否正确检测到停滞下载。

---

贡献者

作者

可在我的https://github.com/tommyvange%E6%9F%A5%E7%9C%8B%E6%9B%B4%E5%A4%9A%E4%BD%9C%E5%93%81%EF%BC%8C%E6%88%96%E9%80%9A%E8%BF%87LinkedIn%E8%81%94%E7%B3%BB%E6%88%91%E3%80%82

贡献者

非常感谢所有为改进、完善和支持此项目付出宝贵时间的人！

---

GNU通用公共许可证v3.0 (GPLv3)

GNU通用公共许可证v3.0 (GPLv3) 是适用于软件和其他创意作品的免费、 copyleft 许可证。它确保您分享、修改和分发程序所有版本的自由，使软件对所有人保持自由。

完整许可证可参见https://github.com/tommyvange/ArrStalledHandler/blob/main/LICENSE%E6%88%96gnu.org%E3%80%82

要点：

1. 分享和修改的自由：
   • 您可以分发GPLv3授权的软件副本。
   • 获取源代码。
   • 修改