如何使用 YTSageYouTube 视频下载、音频提取与批量下载操作指南【免费下载链接】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/YTSageYTSage 是一款免费的开源 YouTube 视频下载工具基于 yt-dlp 引擎配有 PySide6 图形界面。它可以按画质下载视频、提取 MP3 音频、下载并合并字幕、批量处理播放列表还能通过 Cookie 访问私有内容。适合想离线保存视频、提取音乐或需要批量备份系列内容的用户全程以鼠标点击为主无需编写代码。 快速上手安装 YTSage 并完成第一次视频下载安装 YTSage在终端执行pip install ytsage需要 Python 3.11。如果不熟悉 Python可以改为从项目发布页下载对应系统的安装包Windows 选.exemacOS 选.dmgLinux 选.AppImage。启动程序执行ytsage命令或双击安装好的应用。Windows 下 pip 安装会自动检测并提示配置 FFmpeg按提示完成即可。粘贴视频链接复制 YouTube 地址后点击Paste URL按钮粘入输入框。分析视频点击Analyze等待界面显示视频信息和格式列表。选择画质并下载勾选表格中的目标行如 1080p点击Download文件默认保存到系统的下载文件夹。主界面粘贴链接并点击 Analyze 后格式表格列出各画质的分辨率、编码、体积等参数选中一行即可点击 Download。 场景一下载单个视频连同字幕和封面一起保存适用情况保存一个视频并且需要字幕、封面图或章节信息。粘贴链接并点击Analyze完成分析。点击Select Subtitles...选择需要的字幕语言勾选Merge Subtitles可把字幕直接烧录进画面。勾选Save Thumbnail保存封面图勾选Embed Chapters把章节与元数据嵌入视频文件。如需去掉赞助片段点击SponsorBlock Categories...勾选对应类别。在格式表中勾选目标行点击Download。相关设置默认分辨率与字幕语言在Download Settings的Default Selection Settings中预设每次自动选中的分辨率如 1080和字幕语言省去重复选择。Force output format开启后合并视频会强制转为你指定的容器选MP4Most compatible兼容性最好。 场景二如何从视频提取 MP3 / M4A 音频适用情况只想要音乐或播客内容不需要画面。点击Audio Only切换到音频模式格式表会按音质档位如 Medium Audio、Low Audio列出可选音频流。打开Download Settings在Audio Format Settings中勾选Force audio format for audio-only downloads并把Preferred audio format设为MP3或M4A。在表格中勾选目标音质行点击Download得到的就是独立的音频文件。Audio Only 模式下表格按音质档位列出各音频流的封装格式与体积选中后点击 Download 即可提取。 场景三批量下载整个播放列表适用情况一个课程系列或合集需要整批保存。粘贴播放列表链接点击Analyze界面会显示播放列表名称和视频总数。点击Select Videos...只勾选需要的视频不操作则默认下载全部。在格式表中勾选统一画质点击Download开始批量下载。如需留档清单点击Save Playlist As将列表导出为.txt、.csv、.m3u或.json文件。播放列表分析后Select Videos... 可筛选要下载的视频下方格式表按画质列出供统一选择。 场景四使用 Cookie 登录下载私有视频适用情况需要访问自己的私有视频、会员内容或年龄限制内容。点击Custom Options选择Login with Cookies页签。选择Extract from browser推荐直接从本机已登录的浏览器提取选择浏览器和 Profile也可以改选Use cookie file加载 Netscape 格式的cookies.txt文件。点击Apply应用然后重新点击Analyze分析链接。Custom Options 弹窗提供 Cookie 登录、自定义命令、代理、更新器与语言切换等高级选项。相关设置视频受地区限制时可在同一弹窗的Proxy页签配置 SOCKS 或 HTTP 代理服务器。⚙️ 关键设置详解Download Settings 中真正常用的几项点击Download Settings打开设置窗口以下选项对日常使用影响最大Download Settings 窗口上半部分设置下载路径与下载限速下半部分设置视频与音频的输出格式。Download Path下载路径设置默认保存位置跨会话自动记住。建议指定一个空间充足、目录清晰的磁盘避免文件混在系统默认下载文件夹里。Speed Limit下载限速限制下载速度单位 KB/s如500即 500 KB/s。共享带宽或不想影响其他设备网络时启用平时留空不限制。Concurrent Connections并发连接数取值 1–20用多条连接加速大文件。网络稳定时可适当调大出现下载报错时调小。Audio Normalization音频归一化按 EBU R128 标准统一音频响度。批量提取不同来源的音频、希望音量听感一致时开启。Export/Import配置导入导出把所有设置导出为 JSON 文件备份或迁移新机器时一次性导入不用逐项重配。 实用技巧与避坑分析后格式表出不来 → 先在Custom Options的Updater页签更新 yt-dlp 到最新版仍不行可切换到 Nightly 渠道再试。下载完视频没声音、画面和音频分成两个文件 → FFmpeg 缺失或未生效Windows 建议直接选用自带 FFmpeg 的安装包或确认 FFmpeg 在系统 PATH 中。想在夜里排队跑多个任务 → 每次配置完点Add to queue而不是Download全部加完后打开Queue窗口点Start queue队列跨启动保存失败或取消的任务可以重试。要下载 YouTube 以外的站点yt-dlp 支持的其他平台→ 在Download Settings中打开Generic Mode再粘贴对应链接分析。macOS 打开提示应用已损坏 → 打开终端输入xattr -d com.apple.quarantine末尾带空格先不回车把YTSage.app拖进终端窗口自动填入路径再回车执行。❓ 常见问题Q1下载的视频没有声音或生成了两个分离的文件缺少 FFmpeg 导致音轨无法合并。安装或正确配置 FFmpeg 后重新下载即可Windows 用户可直接选择自带 FFmpeg 的安装包。Q2私有视频或会员视频为什么分析失败这类内容需要登录态。按场景四配置好 Cookie 后重新点击Analyze即可正常分析。Q3之前下载过的文件在哪里能重新下载吗点击主工具栏的History查看下载历史支持按标题、日期搜索可以直接打开本地文件或重新发起下载。Q4画质到底怎么选日常观看选 1080p MP4 就够长期存档选列表中最高画质存到手机等移动设备选 720p 或更低以节省空间。 项目资源源码仓库克隆运行git clone https://gitcode.com/GitHub_Trending/yt/YTSage cd YTSage依赖与版本信息见 pyproject.toml核心下载逻辑位于 ytsage/core/。中文文档readme-translations/README.zh.mdDocker 自托管部署指南docker/README.md问题追踪在项目仓库的 Issues 页面提交或查看问题社区官方 Telegram 频道频道信息见项目仓库首页徽章YTSage 把 yt-dlp 的能力包进了简洁的图形界面覆盖单视频、音频提取和播放列表三类常见需求上手成本很低。使用时请遵守 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考