tubesync

TubeSync 是一款面向 YouTube 的自托管 PVR（个人录像机）工具，被描述为类似于 Sonarr 但针对 YouTube，并内置下载客户端。它可将 YouTube 频道和播放列表同步到本地目录，并在媒体下载完成后更新媒体服务器。 在内部，它是 yt-dlp 和 ffmpeg 的 Web 界面封装，并带有任务调度器。其宣称的差异化优势在于提供完整的 PVR 体验以更新媒体服务器，以及更好地选择媒体格式。它还实现了带退避计时器的渐进式失败重试机制，使失败的下载能在较长时间内持续重试。 部署以容器优先：容器镜像发布在 ghcr.io/meeb/tubesync:latest，支持 amd64 和 arm64 架构，并提供了 Docker 或 Podman 及 Docker Compose 的示例文档。配置和下载目录通过卷挂载（/config 和 /downloads），支持 PUID、PGID 和 TZ 环境变量。可通过 HTTP_USER 和 HTTP_PASS 启用可选的 HTTP 基本认证。 下载的媒体按视频和音频子目录组织在下载目录下，纯音频媒体归入音频目录。管理通过端口 4848 的 Web 界面完成。通过 URL 添加源并进行验证，每个源的选项包括索引频率和下载质量。索引和下载按计划任务自动运行，可在任务标签页查看，媒体出现在媒体标签页中。支持 Plex 和 Jellyfin 作为媒体服务器。 README 警告了索引频率和索引超大频道的问题，建议使用较长的间隔以及礼貌、最小化的索引和并发下载，以避免限流或封禁。高级环境变量涵盖 Django 设置、URL 前缀、调试模式、允许的主机、视频高度阈值、源重命名、目录前缀、元数据缩减、gunicorn 工作进程数、监听主机/端口以及可选的外部数据库连接。文档还提供了手动非容器化 Django 安装路径，以及可通过 manage.py test 运行的测试套件。