Tdarr

项目概述

Tdarr 是一个跨平台的媒体库转码自动化系统，支持 Windows、macOS、Linux 与 Docker。它采用 Server 加 Node 的分布式架构：中央服务器统一调度任务，各设备上的节点负责执行转码，可以把闲置硬件组织起来并行处理。典型用法是把 H.264 视频批量转为 H.265（HEVC），在不损失画质的情况下节省 40%~50% 的存储空间。应用以网页形式操作，可与 Sonarr、Radarr 等媒体管理工具配合使用。

项目	内容
平台	Windows、macOS、Linux、Docker
核心引擎	FFmpeg、HandBrake
架构	Server + 分布式 Node
操作方式	Web 界面

把闲置设备变成转码集群，批量把视频库转成更省空间的标准格式。

主要功能

• 分布式转码：Server 与 Node 分离设计，多设备并行处理同一媒体库
• CPU/GPU 工人：转码与健康检查各分 CPU、GPU 两类 worker，可按需启停
• 插件栈：以 JavaScript 编写条件式插件，按顺序组合实现清理与标准化
• 健康检查：检测损坏的视频文件并自动修复或重新封装
• 流清理：批量移除多余音轨、字幕轨与元数据，改善直连播放兼容性
• 媒体库分析：按数百种属性搜索文件，统计容量、编码分布与处理历史
• 全天候调度：7×24 小时排程，按库设置转码规则、过滤条件与执行时段
• 文件夹监视：监控指定目录，新文件自动进入处理流程

适用人群

• 拥有大规模本地影视库的用户
• 使用 NAS 与家用服务器的媒体爱好者
• 配合 Plex、Jellyfin、Emby 建库的用户
• 希望统一视频编码与封装的技术玩家
• 手头有多台闲置电脑或 GPU 的用户

快速上手

1. 按平台下载服务端与节点程序，或使用 Docker 镜像
2. 启动 Tdarr Server，浏览器打开 Web 界面
3. 在节点页添加本机或远程节点，分配 CPU/GPU worker 数量
4. 添加媒体库，设置转码规则、插件栈与执行计划
5. 确认扫描结果后开始处理，在报表页跟踪任务进度

核心优势

• 空间节省：H.264 转 H.265 通常可减少 40%~50% 体积
• 横向扩展：旧电脑、NAS 都能挂为节点，算力随加随用
• 流程可编程：插件栈加条件判断，几乎能定义任何处理逻辑
• 久经验证：官方在百万文件规模的模拟库上完成过测试

系统要求

项目	要求
服务端	Windows、macOS、Linux 或 Docker
节点	Windows、Linux（含 arm/arm64）、macOS
GPU 转码	支持 Intel QSV、NVIDIA NVENC 等硬件编码器
配套环境	可选与 Sonarr、Radarr 等配合使用

注意事项

• 转码耗时：大库首轮全量转码可能持续数天，建议先小范围试运行规则
• GPU 环境：硬件转码需要对应驱动，unRAID 或 Ubuntu 下需启用 Nvidia 运行时
• 备份原始文件：移除多余音轨字幕前先确认原始文件另有留存