jioyzen/qb-movie-manager repository overview

⁠QB 影视去重工具 (QB Movie Manager)

⁠用户痛点

⁠🤯 PT/BT 玩家的重复困境

⁠🎯 这个工具能做什么

一句话：识别同一电影的所有版本，帮你选出最好的，删掉多余的。

⁠产品功能

⁠6 步工作流

配置 → 获取种子 → TMDB 匹配 → 深度分析 → 去重筛选 → 清理删除

⁠核心功能

• 🎬 TMDB 智能匹配：多策略解析种子文件名，自动匹配 TMDB 电影信息，支持手动补录
• 🔍 MediaInfo 深度分析：通过 SMB 挂载或本地路径读取视频文件，提取真实音轨、字幕、HDR 信息
• ⚖️ 5 层优先级链：音轨 > 字幕 > 来源 > 分辨率 > HDR，逐层比较，第一层分出胜负即停止
• 🛡️ 合集智能处理：自动识别合集种子，支持"跳过保护"和"合集优先"两种策略
• 🌐 Web 界面：6 步工作流，实时进度反馈，暗色/浅色主题切换

⁠Docker 部署

⁠环境要求

• Docker 20.10+（推荐 Docker Compose V2）
• qBittorrent（已运行，启用 Web UI）
• TMDB API Key（免费申请⁠）

⁠快速启动

# 拉取镜像
docker pull jioyzen/qb-movie-manager:latest

# 创建配置目录
mkdir -p /path/to/config

# 运行容器
docker run -d \
  --name qb-movie-manager \
  --restart unless-stopped \
  -p 8090:8090 \
  -v /path/to/config:/config \
  -v /path/to/downloads:/data \
  jioyzen/qb-movie-manager:latest

⁠docker-compose（推荐）

version: "3.8"
services:
  qb-movie-manager:
    image: jioyzen/qb-movie-manager:latest
    container_name: qb-movie-manager
    restart: unless-stopped
    ports:
      - "8090:8090"
    volumes:
      - ./config:/config
      # 与 qBittorrent 同主机部署时，使用相同绑定挂载参数
      # - /path/to/downloads:/data
    environment:
      - TZ=Asia/Shanghai
    # SMB 挂载需要以下权限（不使用 SMB 可删除）
    # cap_add:
    #   - SYS_ADMIN
    # security_opt:
    #   - apparmor:unconfined

⁠首次使用

1. 浏览器访问 http://你的IP:8090
2. 进入 配置 页面，填写 qBittorrent 连接信息，点击"测试连接并获取分类"
3. 勾选需要处理的分类，配置文件路径（本地路径或 SMB 远程挂载）
4. 保存配置，依次完成 6 个步骤

⁠路径配置说明

支持两种文件访问模式：

模式一：本地路径（推荐，与 qBittorrent 同主机部署）

与 qBittorrent 容器使用相同的绑定挂载参数，WebUI 中配置本地路径即可。

volumes:
  - /path/to/downloads:/data    # 与 QB 容器相同的挂载

WebUI 配置：本地路径 → /data，QB 路径前缀 → /downloads

模式二：SMB 远程挂载

容器自动挂载远程 SMB 共享，需要 --cap-add SYS_ADMIN 权限。

⁠多目录映射

如果 qBittorrent 绑定了多个下载目录，在 WebUI 中通过「＋ 添加路径映射」按钮添加多条映射关系。

⁠环境变量

⁠技术栈

• 后端：Flask (Python 3)
• 前端：Vanilla JS SPA，暗色/浅色主题
• 外部 API：qBittorrent Web API v2、TMDB v3 API、mediainfo CLI
• 多架构：linux/amd64, linux/arm64, linux/arm/v7

⁠License

MIT