thunder-subtitle-srt 1.0.0__tar.gz

thunder_subtitle_srt-1.0.0/PKG-INFO

@@ -0,0 +1,182 @@
+Metadata-Version: 2.4
+Name: thunder-subtitle-srt
+Version: 1.0.0
+Summary: CLI tool for searching and downloading Chinese subtitles via Xunlei API
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.31.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: types-requests>=2.31; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+
+# Thunder Subtitle
+
+迅雷字幕 CLI 工具 — 搜索、下载中文字幕，支持 Jellyfin 媒体库自动扫描。
+
+## 安装
+
+```bash
+pip install thunder-subtitle
+```
+
+或开发模式安装：
+
+```bash
+git clone <repo>
+cd thunder-subtitle-py
+pip install -e ".[dev]"
+```
+
+## 使用方法
+
+### 搜索字幕
+
+```bash
+# 基本搜索
+thunder-subtitle search "Movie Name"
+
+# 仅中文字幕
+thunder-subtitle search "Movie Name" --chinese-only
+
+# 按视频时长筛选 (过滤时长不匹配的字幕)
+thunder-subtitle search "Movie Name" --max-duration 1h30m
+
+# 下载全部结果
+thunder-subtitle search "Movie Name" --all -o ./subs/
+
+# 按序号下载
+thunder-subtitle search "Movie Name" --index 1,3,5
+```
+
+### 全量下载（dump）
+
+下载所有匹配的中文字幕，自动跳过之前已拒绝的字幕（基于 gcid 记录在 `.rejected` 文件中）。
+
+```bash
+# 直接搜索下载
+thunder-subtitle dump "Movie Name"
+
+# 从目录读取 movie.nfo 自动获取时长
+thunder-subtitle dump --dir /path/to/movie
+
+# 清空 .rejected 文件以重新下载所有字幕
+rm /path/to/movie/.rejected
+```
+
+> 注意：已拒绝的字幕（gcid 或 url hash 记录在 `.rejected`）在后续下载中自动跳过。手动删除 `.rejected` 文件可清空拒绝列表。scan 模式下的 `--reset-fail` 会自动清空 `.rejected` 和审查失败标记，实现完全暴力刷新。
+
+### Jellyfin 目录扫描
+
+扫描演员/电影目录结构，自动搜索并下载缺失的字幕。支持断点续扫、并行下载。
+
+```bash
+# 基础扫描
+thunder-subtitle scan /path/to/jellyfin/media
+
+# 预览模式（不实际下载）
+thunder-subtitle scan /path/to/jellyfin/media --dry-run
+
+# 并行处理（4线程）
+thunder-subtitle scan /path/to/jellyfin/media --parallel 4
+
+# 过滤特定电影
+thunder-subtitle scan /path/to/jellyfin/media --filter "电影名"
+
+# 断点续扫
+thunder-subtitle scan /path/to/jellyfin/media --resume
+
+# 仅处理 N 天前发布的电影
+thunder-subtitle scan /path/to/jellyfin/media --min-age 7
+
+# 全量下载模式（每部电影下载所有匹配字幕）
+thunder-subtitle scan /path/to/jellyfin/media --dump
+
+# 强制重试标记失败的电影（但跳过已拒绝的字幕）
+thunder-subtitle scan /path/to/jellyfin/media --dump --force
+
+# 暴力刷新：清除标记失败状态和所有拒绝记录，重新下载
+thunder-subtitle scan /path/to/jellyfin/media --dump --force --reset-fail
+```
+
+### 字幕审查
+
+审查已下载字幕质量，给出百分制评分。
+
+```bash
+# 审查目录
+thunder-subtitle review /path/to/jellyfin/media
+
+# 标记审查状态
+thunder-subtitle review --mark "电影名"            # 标记通过
+thunder-subtitle review --mark-fail "电影名"       # 标记失败（不再尝试下载）
+thunder-subtitle review --unmark "电影名"          # 取消标记
+thunder-subtitle review --mark-all                 # 全部标记
+```
+
+### 配置管理
+
+```bash
+# 查看配置
+thunder-subtitle config
+
+# 设置配置项
+thunder-subtitle config --set media_paths /path1,/path2
+thunder-subtitle config --set rate_limit 5
+thunder-subtitle config --set preferred_groups "KitaujiSub,DMG"
+
+# 重置为默认
+thunder-subtitle config --reset
+```
+
+配置项：
+
+| 键 | 类型 | 默认值 | 说明 |
+|---|---|---|---|
+| `output_dir` | str | `""` | 默认下载目录 |
+| `timeout` | int | `30` | API 超时（秒） |
+| `rate_limit` | int | `3` | 扫描模式查询间隔（秒） |
+| `retry_count` | int | `3` | 下载失败重试次数 |
+| `retry_delay` | int | `2` | 重试基础间隔（秒，指数退避） |
+| `preferred_groups` | str | `""` | 偏好字幕组（逗号分隔） |
+| `media_paths` | str | `""` | 默认媒体库路径（逗号分隔） |
+
+### 直接下载
+
+```bash
+thunder-subtitle download "https://..." "filename.srt"
+```
+
+## Jellyfin 目录结构
+
+```
+媒体库/
+├── 演员A/
+│   ├── 电影1/
+│   │   ├── movie.nfo
+│   │   └── 视频文件
+│   └── 电影2/
+│       └── movie.nfo
+└── 演员B/
+    └── 电影3/
+        └── movie.nfo
+```
+
+## 开发
+
+```bash
+pip install -e ".[dev]"    # 安装开发依赖
+pytest tests/ -v           # 运行测试（196 用例）
+ruff check .               # 代码检查
+```
+
+## CI/CD
+
+- **CI**：push/PR 时自动运行 ruff lint + 编译检查 + pytest
+- **发布**：推送 `v*` tag 自动构建 wheel 并发布到 PyPI
+
+## 要求
+
+- Python >= 3.10
+- `requests`

thunder_subtitle_srt-1.0.0/README.md

@@ -0,0 +1,169 @@
+# Thunder Subtitle
+
+迅雷字幕 CLI 工具 — 搜索、下载中文字幕，支持 Jellyfin 媒体库自动扫描。
+
+## 安装
+
+```bash
+pip install thunder-subtitle
+```
+
+或开发模式安装：
+
+```bash
+git clone <repo>
+cd thunder-subtitle-py
+pip install -e ".[dev]"
+```
+
+## 使用方法
+
+### 搜索字幕
+
+```bash
+# 基本搜索
+thunder-subtitle search "Movie Name"
+
+# 仅中文字幕
+thunder-subtitle search "Movie Name" --chinese-only
+
+# 按视频时长筛选 (过滤时长不匹配的字幕)
+thunder-subtitle search "Movie Name" --max-duration 1h30m
+
+# 下载全部结果
+thunder-subtitle search "Movie Name" --all -o ./subs/
+
+# 按序号下载
+thunder-subtitle search "Movie Name" --index 1,3,5
+```
+
+### 全量下载（dump）
+
+下载所有匹配的中文字幕，自动跳过之前已拒绝的字幕（基于 gcid 记录在 `.rejected` 文件中）。
+
+```bash
+# 直接搜索下载
+thunder-subtitle dump "Movie Name"
+
+# 从目录读取 movie.nfo 自动获取时长
+thunder-subtitle dump --dir /path/to/movie
+
+# 清空 .rejected 文件以重新下载所有字幕
+rm /path/to/movie/.rejected
+```
+
+> 注意：已拒绝的字幕（gcid 或 url hash 记录在 `.rejected`）在后续下载中自动跳过。手动删除 `.rejected` 文件可清空拒绝列表。scan 模式下的 `--reset-fail` 会自动清空 `.rejected` 和审查失败标记，实现完全暴力刷新。
+
+### Jellyfin 目录扫描
+
+扫描演员/电影目录结构，自动搜索并下载缺失的字幕。支持断点续扫、并行下载。
+
+```bash
+# 基础扫描
+thunder-subtitle scan /path/to/jellyfin/media
+
+# 预览模式（不实际下载）
+thunder-subtitle scan /path/to/jellyfin/media --dry-run
+
+# 并行处理（4线程）
+thunder-subtitle scan /path/to/jellyfin/media --parallel 4
+
+# 过滤特定电影
+thunder-subtitle scan /path/to/jellyfin/media --filter "电影名"
+
+# 断点续扫
+thunder-subtitle scan /path/to/jellyfin/media --resume
+
+# 仅处理 N 天前发布的电影
+thunder-subtitle scan /path/to/jellyfin/media --min-age 7
+
+# 全量下载模式（每部电影下载所有匹配字幕）
+thunder-subtitle scan /path/to/jellyfin/media --dump
+
+# 强制重试标记失败的电影（但跳过已拒绝的字幕）
+thunder-subtitle scan /path/to/jellyfin/media --dump --force
+
+# 暴力刷新：清除标记失败状态和所有拒绝记录，重新下载
+thunder-subtitle scan /path/to/jellyfin/media --dump --force --reset-fail
+```
+
+### 字幕审查
+
+审查已下载字幕质量，给出百分制评分。
+
+```bash
+# 审查目录
+thunder-subtitle review /path/to/jellyfin/media
+
+# 标记审查状态
+thunder-subtitle review --mark "电影名"            # 标记通过
+thunder-subtitle review --mark-fail "电影名"       # 标记失败（不再尝试下载）
+thunder-subtitle review --unmark "电影名"          # 取消标记
+thunder-subtitle review --mark-all                 # 全部标记
+```
+
+### 配置管理
+
+```bash
+# 查看配置
+thunder-subtitle config
+
+# 设置配置项
+thunder-subtitle config --set media_paths /path1,/path2
+thunder-subtitle config --set rate_limit 5
+thunder-subtitle config --set preferred_groups "KitaujiSub,DMG"
+
+# 重置为默认
+thunder-subtitle config --reset
+```
+
+配置项：
+
+| 键 | 类型 | 默认值 | 说明 |
+|---|---|---|---|
+| `output_dir` | str | `""` | 默认下载目录 |
+| `timeout` | int | `30` | API 超时（秒） |
+| `rate_limit` | int | `3` | 扫描模式查询间隔（秒） |
+| `retry_count` | int | `3` | 下载失败重试次数 |
+| `retry_delay` | int | `2` | 重试基础间隔（秒，指数退避） |
+| `preferred_groups` | str | `""` | 偏好字幕组（逗号分隔） |
+| `media_paths` | str | `""` | 默认媒体库路径（逗号分隔） |
+
+### 直接下载
+
+```bash
+thunder-subtitle download "https://..." "filename.srt"
+```
+
+## Jellyfin 目录结构
+
+```
+媒体库/
+├── 演员A/
+│   ├── 电影1/
+│   │   ├── movie.nfo
+│   │   └── 视频文件
+│   └── 电影2/
+│       └── movie.nfo
+└── 演员B/
+    └── 电影3/
+        └── movie.nfo
+```
+
+## 开发
+
+```bash
+pip install -e ".[dev]"    # 安装开发依赖
+pytest tests/ -v           # 运行测试（196 用例）
+ruff check .               # 代码检查
+```
+
+## CI/CD
+
+- **CI**：push/PR 时自动运行 ruff lint + 编译检查 + pytest
+- **发布**：推送 `v*` tag 自动构建 wheel 并发布到 PyPI
+
+## 要求
+
+- Python >= 3.10
+- `requests`

thunder_subtitle_srt-1.0.0/cli.py

@@ -0,0 +1,156 @@
+#!/usr/bin/env python3
+"""
+Thunder Subtitle Python CLI - Entry Point
+
+字幕搜索下载工具，纯命令行参数方式
+"""
+
+import argparse
+from typing import Callable
+
+from commands.search import cmd_search
+from commands.download import cmd_download
+from commands.config import cmd_config
+from commands.dump import cmd_dump
+from commands.review import cmd_review
+from commands.scan import cmd_scan
+
+
+# 命令注册表：dispatch 时直接查表，无需 if/elif 链
+_COMMANDS: dict[str, Callable] = {
+    "search": cmd_search,
+    "download": cmd_download,
+    "scan": cmd_scan,
+    "review": cmd_review,
+    "dump": cmd_dump,
+    "config": cmd_config,
+}
+
+
+def _get_version() -> str:
+    """从已安装包的 metadata 读取版本号"""
+    from importlib.metadata import PackageNotFoundError, version
+    try:
+        return version("thunder-subtitle")
+    except PackageNotFoundError:
+        return "dev"
+
+
+def _build_parser() -> argparse.ArgumentParser:
+    """构建命令行参数解析器"""
+    parser = argparse.ArgumentParser(
+        prog="thunder-subtitle",
+        description="CLI tool for searching and downloading Chinese subtitles via Xunlei API",
+    )
+    parser.add_argument("--version", action="version", version=f"thunder-subtitle {_get_version()}")
+    subparsers = parser.add_subparsers(dest="command", help="Available commands")
+
+    # ===== search 命令 =====
+    p = subparsers.add_parser("search", help="Search for subtitles by name")
+    p.add_argument("name", help="Search keyword for subtitles")
+    p.add_argument("-c", "--chinese-only", action="store_true", default=False,
+                   help="Filter to Chinese subtitles only")
+    p.add_argument("-d", "--max-duration", type=str, default=None,
+                   help="Filter by max video duration (e.g., 1h30m, 90m, 45s)")
+    p.add_argument("-f", "--chinese-first", action="store_true", default=False,
+                   help="Prioritize Chinese subtitles, fallback to others if none found")
+    p.add_argument("-o", "--output", type=str, default=None,
+                   help="Output directory for downloads")
+    p.add_argument("-i", "--index", type=str, default=None,
+                   help="Download specific subtitle(s) by index (e.g., 1 or 1,3,5 or 1-3)")
+    p.add_argument("-a", "--all", action="store_true", default=False,
+                   help="Download all search results")
+    p.add_argument("--limit", type=int, default=None,
+                   help="Limit the number of results shown")
+
+    # ===== download 命令 =====
+    p = subparsers.add_parser("download", help="Download subtitle by URL")
+    p.add_argument("url", help="Subtitle download URL")
+    p.add_argument("filename", nargs="?", default=None, help="Output filename")
+    p.add_argument("-o", "--output", type=str, default=None,
+                   help="Output directory for downloads")
+
+    # ===== config 命令 =====
+    p = subparsers.add_parser("config", help="View or update configuration")
+    p.add_argument("--set", nargs=2, metavar=("KEY", "VALUE"), dest="set_pair",
+                   help="Set a config value (e.g., --set rate_limit 5)")
+    p.add_argument("--reset", action="store_true", default=False,
+                   help="Reset config to defaults")
+
+    # ===== dump 命令 =====
+    p = subparsers.add_parser("dump", help="Download ALL subtitles for a movie, numbered 1.srt, 2.srt, ...")
+    p.add_argument("name", nargs="?", default=None, help="Movie name to search")
+    p.add_argument("--dir", type=str, default=None,
+                   help="Movie directory (auto-reads name from basename, duration from movie.nfo)")
+    p.add_argument("-o", "--output", type=str, default=None,
+                   help="Output directory (default: current dir, or movie dir if --dir)")
+    p.add_argument("-d", "--max-duration", type=str, default=None,
+                   help="Filter by max video duration (e.g., 1h30m)")
+    p.add_argument("-c", "--chinese-only", action="store_true", default=False,
+                   help="Only Chinese subtitles")
+    p.add_argument("-f", "--chinese-first", action="store_true", default=False,
+                   help="Prioritize Chinese subtitles first")
+
+    # ===== review 命令 =====
+    p = subparsers.add_parser("review", help="Review downloaded subtitle files for quality issues")
+    p.add_argument("directory", nargs="?", default=None,
+                   help="Base directory to review (uses media_paths if omitted)")
+    p.add_argument("--filter", type=str, action="append", default=None, dest="filters",
+                   help="Only review movies matching this keyword (can repeat)")
+    p.add_argument("--log", action="store_true", default=False,
+                   help="Save review report to the scan directory")
+    p.add_argument("--mark", type=str, default=None,
+                   help="Mark matching movies as reviewed")
+    p.add_argument("--unmark", type=str, default=None,
+                   help="Remove review mark from matching movies")
+    p.add_argument("--mark-all", action="store_true", default=False,
+                   help="Mark all movies as reviewed")
+    p.add_argument("--mark-path", type=str, default=None,
+                   help="Mark a specific movie directory as reviewed")
+    p.add_argument("--unmark-path", type=str, default=None,
+                   help="Remove review mark from a specific movie directory")
+    p.add_argument("--mark-fail", type=str, default=None,
+                   help="Mark matching movies as review FAILED (all subs unusable)")
+    p.add_argument("--mark-fail-path", type=str, default=None,
+                   help="Mark specific movie dir as review FAILED (relative/absolute)")
+
+    # ===== scan 命令 =====
+    p = subparsers.add_parser("scan", help="Scan Jellyfin movie directories and auto-download subtitles")
+    p.add_argument("directory", nargs="?", default=None,
+                   help="Base directory to scan (演员/电影 structure, uses media_paths if omitted)")
+    p.add_argument("--dry-run", action="store_true", default=False,
+                   help="Show what would be done without downloading")
+    p.add_argument("--filter", type=str, action="append", default=None, dest="filters",
+                   help="Only process movies matching this keyword (can repeat)")
+    p.add_argument("--resume", action="store_true", default=False,
+                   help="Resume from last interruption, skip already-processed movies")
+    p.add_argument("--log", action="store_true", default=False,
+                   help="Save scan log to the scan directory")
+    p.add_argument("--min-age", type=int, default=0,
+                   help="Only process movies released N+ days ago (default 0 = immediate)")
+    p.add_argument("--dump", action="store_true", default=False, dest="dump",
+                   help="Brute-force: download ALL subtitles per movie (1.srt, 2.srt...)")
+    p.add_argument("--force", action="store_true", default=False,
+                   help="Force re-download even for mark-fail movies (keeps fail state)")
+    p.add_argument("--reset-fail", action="store_true", default=False,
+                   help="Clear mark-fail status, reset to need-review")
+    p.add_argument("-p", "--parallel", type=int, default=1,
+                   help="Number of parallel workers (default 1 = serial)")
+
+    return parser
+
+
+def main() -> None:
+    """CLI 入口：构建 parser → 解析参数 → 分发命令"""
+    parser = _build_parser()
+    args = parser.parse_args()
+
+    handler = _COMMANDS.get(args.command)
+    if handler:
+        handler(args)
+    else:
+        parser.print_help()
+
+
+if __name__ == "__main__":
+    main()

thunder_subtitle_srt-1.0.0/commands/__init__.py

@@ -0,0 +1 @@
+"""commands/__init__.py"""

thunder_subtitle_srt-1.0.0/commands/config.py

@@ -0,0 +1,33 @@
+"""config 命令：配置管理"""
+
+from src.config import Config
+from src.ui import DIM, GREEN, RED, RESET
+
+
+def cmd_config(args) -> None:
+    """配置管理"""
+    config = Config.load()
+
+    if args.reset:
+        config = Config()
+        config.save()
+        print(f"{GREEN}\n  ✓ Config reset to defaults{RESET}\n")
+        return
+
+    if args.set_pair:
+        key, value = args.set_pair[0], args.set_pair[1]
+        if not hasattr(config, key):
+            valid = ", ".join(Config.__dataclass_fields__.keys())
+            print(f"{RED}\n  ✗ Unknown key: {key}{RESET}")
+            print(f"{DIM}  Valid keys: {valid}{RESET}\n")
+            return
+        current = getattr(config, key)
+        if isinstance(current, int):
+            setattr(config, key, int(value))
+        else:
+            setattr(config, key, value)
+        config.save()
+        print(f"{GREEN}\n  ✓ {key} = {getattr(config, key)}{RESET}\n")
+        return
+
+    config.show()

thunder_subtitle_srt-1.0.0/commands/download.py

@@ -0,0 +1,34 @@
+"""download 命令：通过 URL 下载字幕"""
+
+from src.exceptions import CLIExit
+from src.models import Subtitle
+from src.ui import display_error, display_success
+from src.download import download_subtitle, get_default_download_dir
+
+
+def cmd_download(args) -> None:
+    """执行下载命令"""
+    output_dir = args.output or get_default_download_dir()
+
+    # 构造一个简单的 Subtitle 对象
+    subtitle = Subtitle(
+        gcid="",
+        cid="",
+        url=args.url,
+        ext=args.filename.split(".")[-1] if args.filename and "." in args.filename else "srt",
+        name=args.filename or "subtitle",
+        duration=0,
+        languages=[],
+        source=0,
+        score=0.0,
+        fingerprintf_score=0.0,
+        extra_name="",
+        mt=0,
+    )
+
+    result = download_subtitle(subtitle, output_dir, custom_filename=args.filename)
+    if result.success:
+        display_success(f"Downloaded: {result.filename}")
+    else:
+        display_error(f"Download failed: {result.error}")
+        raise CLIExit()

thunder_subtitle_srt-1.0.0/commands/dump.py

@@ -0,0 +1,102 @@
+"""dump 命令：全量下载字幕"""
+
+import logging
+import os
+import xml.etree.ElementTree as ET
+
+from src.api import SubtitleApiClient
+from src.config import Config
+from src.exceptions import CLIExit, ThunderSubtitleError
+from src.ui import BOLD, DIM, GREEN, RED, RESET, display_error
+from src.download import dump_subtitles, get_default_download_dir
+from src.utils import parse_duration, parse_nfo, seconds_to_duration_str, filter_by_duration, load_gcid_file, clear_file
+
+logger = logging.getLogger(__name__)
+
+
+def cmd_dump(args) -> None:
+    """全量下载字幕：搜索后下载全部匹配结果，按 1.{ext}, 2.{ext} 命名"""
+    client = SubtitleApiClient()
+
+    # --dir 模式：从目录读取电影名和时长
+    if args.dir:
+        if not os.path.isdir(args.dir):
+            display_error(f"Directory not found: {args.dir}")
+            raise CLIExit()
+        movie_name = os.path.basename(args.dir.rstrip("/"))
+        output_dir = args.output if args.output is not None else args.dir
+        # 读取 movie.nfo 获取时长
+        nfo_path = os.path.join(args.dir, "movie.nfo")
+        try:
+            nfo = parse_nfo(nfo_path)
+            max_duration_ms = nfo.duration_seconds * 1000 if nfo.duration_seconds > 0 else None
+            duration_str = seconds_to_duration_str(nfo.duration_seconds)
+        except (ET.ParseError, OSError):
+            max_duration_ms = None
+            duration_str = "unknown"
+    else:
+        if not args.name:
+            display_error("Either movie name or --dir is required")
+            raise CLIExit()
+        movie_name = args.name
+        output_dir = args.output if args.output is not None else "."
+        duration_str = args.max_duration or ""
+        max_duration_ms = None
+        if args.max_duration:
+            try:
+                max_duration_ms = parse_duration(args.max_duration)
+            except ValueError as e:
+                display_error(str(e))
+                raise CLIExit()
+
+    print(f"{BOLD}\n  Dumping all subtitles for: \"{movie_name}\"{RESET}")
+    if max_duration_ms:
+        print(f"{DIM}  Max video duration: {duration_str} (from NFO){RESET}")
+    if max_duration_ms and duration_str:
+        print(f"{DIM}  Filtering: Max video duration {duration_str}{RESET}")
+    print(f"{DIM}  Output: {os.path.abspath(output_dir)}{RESET}\n")
+
+    try:
+        result = client.search_subtitles(movie_name)
+        if result.total == 0:
+            display_error("No subtitles found.")
+            raise CLIExit()
+
+        subtitles = result.subtitles
+
+        # 中文筛选
+        if args.chinese_only:
+            subtitles = client.filter_chinese_subtitles(subtitles)
+        elif args.chinese_first:
+            subtitles.sort(key=lambda s: 0 if client.is_chinese_subtitle(s) else 1)
+
+        # 时长筛选
+        if max_duration_ms is not None:
+            subtitles = filter_by_duration(subtitles, max_duration_ms, client.filter_by_max_duration)
+
+        if not subtitles:
+            display_error("No subtitles match the filters.")
+            raise CLIExit()
+
+        print(f"{GREEN}  Found {len(subtitles)} subtitle(s){RESET}\n")
+
+        # 加载已拒绝 gcid
+        rejected = load_gcid_file(os.path.join(output_dir, ".rejected"))
+
+        os.makedirs(output_dir, exist_ok=True)
+        dumped_path = os.path.join(output_dir, ".dumped")
+        clear_file(dumped_path)  # 清空旧 .dumped
+        r = dump_subtitles(subtitles, output_dir, rejected, dumped_path=dumped_path)
+
+        total = len(subtitles)
+        parts = []
+        if r.dupes > 0:
+            parts.append(f"{r.dupes} dupes")
+        if r.skipped > 0:
+            parts.append(f"{r.skipped} rejected")
+        dup_msg = f" ({', '.join(parts)})" if parts else ""
+        print(f"\n{GREEN}  ✓ Downloaded {r.downloaded}/{total}{dup_msg}{RESET}\n")
+
+    except ThunderSubtitleError as e:
+        display_error(str(e))
+        raise CLIExit()