TubeSync
一个 YouTube 的个人录像机（PVR），自动下载频道/播放列表视频到本地，并更新媒体服务器（类似 Sonarr 但针对 YouTube）。
智能下载
前往项目主页
该项目暂未提供安装包，请直接访问源代码仓库
自动追更 YouTube 频道，像录电视节目一样下载视频到本地。
核心功能
- 自动同步 YouTube 频道和播放列表
- 支持自定义画质、格式（如 mp4、mkv）
- 内置 yt-dlp + ffmpeg，任务调度自动下载
- 失败自动重试，逐步延长等待时间，非常可靠
- 下载完成后自动更新 Jellyfin / Plex 媒体库
避坑指南
- •必须使用 Docker 运行，不支持直接安装；2. 下载目录需有足够空间（高清视频很大）；3. 如果使用 Samba 卷，务必在挂载参数中指定 uid/gid 与 PUID/PGID 一致，否则可能因权限问题导致元数据写入失败；4. 默认监听 4848 端口，注意防火墙；5. 首次添加源后需要等待一段时间才能开始下载（后台任务定时执行）。
适用场景
- 想把自己喜欢的 YouTube 频道视频全部下载到本地，离线观看
- 搭建家庭媒体服务器（Jellyfin/Plex），自动追更 YouTube 节目
- 备份某个 YouTube 播放列表或频道，防止视频被删除
TubeSync 是一个专为 YouTube 设计的个人视频录像机（PVR）。它能自动同步你订阅的频道和播放列表，按你指定的画质下载视频，并整理到本地文件夹。底层基于 yt-dlp 和 ffmpeg，提供 Web 界面和任务调度器，自动完成索引、下载、重试（失败后逐步增加等待时间）。下载完成后，可选地更新 Jellyfin 或 Plex 等媒体服务器，让你像追剧一样追 YouTube 内容。以 Docker 容器运行，支持 amd64 和 arm64 架构，配置和下载目录通过挂载卷管理。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
步骤1：在 Docker 环境中运行：`docker pull ghcr.io/meeb/tubesync:latest`
步骤2：创建配置和下载目录，并启动容器（参考 README 中的 docker run 命令，注意设置 PUID/PGID 和 TZ）
步骤3：打开 http://localhost:4848，进入 Web 界面，添加 YouTube 频道或播放列表 URL
- 步骤1：在 Docker 环境中运行：`docker pull ghcr.io/meeb/tubesync:latest`
- 步骤2：创建配置和下载目录，并启动容器（参考 README 中的 docker run 命令，注意设置 PUID/PGID 和 TZ）
- 步骤3：打开 http://localhost:4848，进入 Web 界面，添加 YouTube 频道或播放列表 URL
暂未获取到校验码
该项目暂未在 GitHub Release 页面提供 SHA-256 校验码
SHA256 校验码
暂无校验码
建议从 GitHub Releases 页面直接下载，并自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
停止并删除容器：`docker stop tubesync && docker rm tubesync`，然后删除挂载的 config 和 downloads 目录即可。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
3 FAQs