在数字时代,在线视频内容越来越丰富,有时我们希望能离线保存或提取音频、字幕,进行个人备份或教学用途。与此同时,也希望工具易用、功能强大且界面友好。基于此需求,来自 GitHub 的开源项目 YTSage 应运而生。本文将从功能亮点、安装过程、使用技巧与注意事项四大方面,详细介绍这款现代化 YouTube 下载工具。
YTSage GitHub地址:https://github.com/oop7/YTSage

功能亮点
YTSage 定位为一款现代化的 YouTube 下载器,拥有清爽的 PySide6 界面。其核心功能包括:
-
支持任意分辨率视频下载,亦可仅提取音频。
-
支持字幕抓取、语言多选、并可合并字幕至视频。
-
支持 SponsorBlock 去赞助段落(即跳过视频中赞助、广告部分)功能。
-
支持查看视频元数据(如标题、描述、发布时间等)。
-
支持播放列表下载并可选择其中的单个视频或批量处理。
-
支持代理服务、速度限制、自定义 yt-dlp 参数、Cookie 登录以访问受限内容。
-
跨平台支持 Windows、macOS、Linux。
安装方式
安装 YTSage 的方法十分多样:
-
最简单的方式:在命令行输入
pip install ytsage安装。 -
对于打包好的可执行版本:Windows、macOS、Linux 均提供预构建包,例如 Windows 可选带 FFmpeg 或不带、Linux 提供 AppImage、DEB、RPM 等。
-
若想从源码安装:
git clone该仓库 → 安装 requirements.txt 依赖 →python main.py启动。
使用指南
-
启动程序后,将 YouTube 视频或播放列表的 URL 粘贴到「分析/Analyze」按钮。
-
程序读取后,可选择视频下载或仅音频。
-
在选项中可勾选是否抓取字幕、是否合并字幕、是否保存缩略图、是否去除赞助片段、是否嵌入章节点、是否使用代理、是否限制下载速度等。
-
选择目标输出目录后,点击“下载”即可。队列管理已内建,视频将自动排队执行。
-
对于播放列表,可选择只下载其中部分视频,也可一次性全部下载。
-
若遇年龄限制、地区限制或私密视频,则可使用浏览器 Cookie 登录或配合 外网加速器梯子 使用。
优势解析
-
界面友好:相比命令行工具,YTSage 提供图形界面,降低使用门槛。
-
功能全面:除了基本下载之外,还整合了字幕、SponsorBlock、播放列表选择、元数据查看等增值功能。
-
跨平台:支持主流操作系统,适用范围广。
-
开源且免费:遵循 MIT 协议,用户可自由使用、修改。
-
稳定基础:底层使用流行的 yt-dlp 作为下载引擎,可靠性高。
注意事项与合规提醒
虽然 YTSage 功能强大,但在使用时也应注意:
-
下载受版权保护或仅限在线播放的视频可能违背平台服务条款,请务必尊重 YouTube 等平台的使用协议与创作者权益。
-
某些私密、年龄限制、地区限制视频可能无法正常下载,需要合法登录或合法权限方可访问。
-
若下载后出现音视频分离、字幕缺失或章节标签异常,通常是因为 FFmpeg 未安装或未被检测,建议安装并配置好 FFmpeg 环境。
-
使用预编译版本时,某些杀毒软件可能误报为可疑,此时可选择通过 pip 方式安装或从源码构建。
-
出于合规原因,建议仅用于个人合法用途,避免用于未授权的商业传播。
总结
总的来说,YTSage 是一款兼具易用性与功能性的 YouTube 下载工具。无论你是普通用户希望保存教学视频,还是内容创作者需要提取音频或字幕,YTSage 都是值得尝试的方案。不过,在享用其便捷功能的同时,也请守法合规,尊重内容版权。