Repolode
提交项目
EgalitarianMonkey

EgalitarianMonkey/hometube

基于 yt-dlp 的 Web 界面工具，可下载单个视频或播放列表，并自动整理到 Plex、Jellyfin 等媒体服务器可识别的目录中。

可替代:4K Video Downloader

在 GitHub 查看官网
Star
1,526
Fork
100
未关闭 Issue
6
最近提交
昨天

这是什么？

HomeTube 是一个可自托管的 Web 应用，基于 yt-dlp 从 YouTube 及其他受支持的网站下载视频，并把完成的文件移动到 Plex、Jellyfin 或 Emby 等媒体服务器监控的目录中。用户粘贴链接、选择目标文件夹即可，格式选择、命名和归档都由程序自动完成，界面中也可以直接新建目标文件夹。

下载时会优先选择可用的最佳视频和音频格式，也可以切换到备选方案或手动指定格式。对于 YouTube 视频，可集成 SponsorBlock 标记或跳过赞助片段。播放列表按视频 ID 追踪，因此排序变化、标题修改和已移除的条目都能同步到本地目录，被移除的视频也可以选择移入归档文件夹而非直接删除。

项目可以通过 Docker 容器或本地 Python 环境运行，全部通过环境变量配置。它还支持浏览器或 cookies 文件认证以访问受限内容、自定义 yt-dlp 参数、片段剪切、字幕嵌入和格式转换，并可在每次下载后通知 Jellyfin 刷新媒体库。

核心功能

  • 01基于 yt-dlp 下载单个视频和播放列表，自动选择最佳画质格式
  • 02下载完成后自动命名并移入 Plex、Jellyfin 或 Emby 可扫描的目录
  • 03集成 SponsorBlock，可在 YouTube 视频中标记或跳过赞助片段
  • 04按视频 ID 同步播放列表，支持重命名识别和移除条目归档
  • 05支持浏览器或 cookies 文件认证，并可添加自定义 yt-dlp 参数
  • 06提供片段剪切、字幕嵌入和格式转换功能

适用场景

  • 在家庭媒体服务器上建立无广告的离线视频库
  • 让本地保存的 YouTube 播放列表与源列表保持同步
  • 把教学或教程视频下载到分类清晰的目录中，供家人观看
  • 在 homelab 中用 Docker 部署一个共享的自托管视频下载工具

快速上手

  1. 1

    阅读部署指南并使用 Docker Compose 部署

使用前须知

  • 采用 AGPL-3.0 许可证，这是一种 copyleft 许可证，衍生作品须以相同条款共享。
  • 要获得可靠的下载效果，需要设置 Cookies 认证，README 称其为强烈推荐。
  • README 以自托管为主，你需要自行运行服务器，通常使用 Docker。

标签

#yt-dlp#self-hosted#homelab#media-server#jellyfin#plex#docker#sponsorblock#open-source#selfhosted

常见问题

hometube 是什么？
基于 yt-dlp 的 Web 界面工具，可下载单个视频或播放列表，并自动整理到 Plex、Jellyfin 等媒体服务器可识别的目录中。 HomeTube 是一个可自托管的 Web 应用，基于 yt-dlp 从 YouTube 及其他受支持的网站下载视频，并把完成的文件移动到 Plex、Jellyfin 或 Emby 等媒体服务器监控的目录中。用户粘贴链接、选择目标文件夹即可，格式选择、命名和归档都由程序自动完成，界面中也可以直接新建目标文件夹。
hometube 可以免费使用吗？用的什么许可证？
hometube 以 AGPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。
hometube 还在维护吗？
活跃维护中。hometube 最近一次提交是在 2026年10月19日。
hometube 适合用来做什么？
在家庭媒体服务器上建立无广告的离线视频库 让本地保存的 YouTube 播放列表与源列表保持同步 把教学或教程视频下载到分类清晰的目录中，供家人观看 在 homelab 中用 Docker 部署一个共享的自托管视频下载工具
hometube 怎么安装和运行？
阅读部署指南并使用 Docker Compose 部署
在哪里获取 hometube？
源代码和安装说明在 GitHub 上：https://github.com/EgalitarianMonkey/hometube

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目