YTSage 快速上手：三步完成 YouTube 视频下载、音频提取与批量处理
【免费下载链接】YTSageModern YouTube downloader with a clean PySide6 interface. Download videos in any quality, extract audio, fetch subtitles, sponsorBlock, and view video metadata. Built with yt-dlp for reliable performance.项目地址: https://gitcode.com/GitHub_Trending/yt/YTSage
YTSage 是一款基于 PySide6 构建的图形化 YouTube 下载工具，底层使用 yt-dlp，能下载任意分辨率视频、提取纯音频、抓取字幕并批量处理播放列表。下面按使用阶段拆解：从装好后的第一条命令，到出问题时的自查顺序。
一条命令装好并确认环境
pip install ytsage ytsage第一条命令装完会多出ytsage启动命令，运行第二条后主界面应当弹出；Windows 上程序会顺带检测 FFmpeg 并引导安装。默认下载目录是系统"下载"文件夹，可随时改。
第一个下载任务：URL 进来，文件出去
- 把视频链接粘贴到顶部输入框（或点 Paste URL 自动粘贴）
- 点Analyze，等待元数据与格式表加载
- 在格式表中挑好清晰度
- 点Download，进度跑完即完成
核心下载引擎位于 ytsage/core/，格式解析、队列调度都从这里发出。
提取音频：选你需要的编码
只需在格式表切到 Audio 模式：MP3、FLAC、AAC、Opus 等编码任选，还可以开启 EBU R128 响度归一化，让不同音轨的音量保持一致。
播放列表批量处理：勾选、排队
- 粘贴播放列表链接，点Analyze
- 在选择界面勾选要保留的条目，默认全选
- 选好格式后点Download
想一次跑多个任务，就把Download换成Add to queue。加完几项后打开Queue，点 Start queue 顺序执行；失败或取消的任务会保留在队列里，可直接重试。
出问题时从哪查起
⚠️ 下载完是音视频两个文件：通常是 FFmpeg 没被检测到，换用捆绑 FFmpeg 的安装包，或把 ffmpeg 加入 PATH 后重启程序。
- 格式表出不来：多半是 yt-dlp 版本过旧，到内置 Updater 选项卡更新，或切 Nightly 频道
- 私密/年龄限制视频失败：在 Custom Options → Cookies 里提取浏览器 cookie，或加载 Netscape 格式的 cookies.txt
- 想下非 YouTube 站点：在下载设置中打开 Generic Mode，前提是该站点被 yt-dlp 支持
更省时间的进阶项
- 文件名模板：支持 yt-dlp 变量，如
%(title)s_%(resolution)s_[%(id)s].%(ext)s - Trim Video：按 HH:MM:SS 指定时间段，只取视频的一部分
- SponsorBlock：自动剪掉赞助片段
- History：回看历史下载，附缩略图与原链接
界面组件实现在 ytsage/gui/，设置项的增删基本都对应这里的对话框。
直接看源码
熟悉基本操作后，可以顺着这几个目录继续深入：
- 核心下载引擎：ytsage/core/
- 图形界面组件：ytsage/gui/
- 完整功能清单与故障排查：README.md
想跑最新未发布的功能，从源码启动即可：
git clone https://gitcode.com/GitHub_Trending/yt/YTSage cd YTSage pip install . python -m ytsage.main运行完成后主窗口同样弹出，后续改动源码重跑最后一条命令就能看到效果。
【免费下载链接】YTSageModern YouTube downloader with a clean PySide6 interface. Download videos in any quality, extract audio, fetch subtitles, sponsorBlock, and view video metadata. Built with yt-dlp for reliable performance.项目地址: https://gitcode.com/GitHub_Trending/yt/YTSage
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
