5 分钟装好 yt-dlp GUI:Windows / macOS / Linux 三平台安装与首次配置全图解
5 分钟装好 yt-dlp GUI:Windows / macOS / Linux 三平台安装与首次配置全图解
yt-dlp GUI 是一款免费的开源桌面视频下载工具,基于 yt-dlp 打造,支持从 YouTube、Bilibili、TikTok 等 1000+ 网站下载视频。本文是一份面向新手的完整安装指南:涵盖 Windows / macOS / Linux 三平台安装步骤、首次启动后的核心配置(自动下载 yt-dlp、设置下载目录),以及第一次下载操作,全程无需命令行基础,5 分钟即可跑通。
为什么需要 yt-dlp GUI 视频下载工具?
yt-dlp 功能强大,但它的命令行界面(CLI)对新手并不友好:参数多、拼写要求严格。yt-dlp GUI 把它封装成了一个简洁的原生桌面应用,核心体验就是"粘贴链接 → 选画质 → 点下载":
- 零配置上手:粘贴视频链接即可预览标题、封面、时长和可用画质
- 原生轻量:基于 Tauri 2 + Rust 构建,安装包仅约 10 MB
- 跨平台:Windows、macOS、Linux 全支持
- 多语言:支持 7 种语言,自动匹配系统语言
💡 如果你只想"像下载软件一样下载视频",它就是最省心的选择。
第一步:获取对应平台的安装包
前往项目的 Releases 发布页,按你所在的系统下载对应安装包(详细下载说明见 README.zh-CN.md 的"快速开始"章节):
| 平台 | 安装包格式 | 说明 |
|---|---|---|
| Windows | .exe 安装包 |
双击运行,图形化安装 |
| macOS | .dmg 磁盘映像 |
拖入"应用程序"文件夹 |
| Linux | .AppImage / .deb / .rpm |
按发行版选择对应格式 |
第二步:三平台安装步骤详解
Windows 安装:双击 .exe 一路"下一步"
- 双击下载好的
.exe安装包(如遇到 SmartScreen 提示,选择"仍要运行") - 按安装向导提示完成安装,默认路径即可
- 启动后桌面会出现 YDL GUI 图标,首次启动速度很快(安装包很小)
macOS 安装:拖拽 .dmg 到应用程序
- 双击
.dmg文件,将应用图标拖入 Applications(应用程序) 文件夹 - 首次打开时,如果系统提示"无法验证开发者",可在 系统设置 → 隐私与安全性 中点击"仍要打开"
- 之后即可像普通 Mac 应用一样使用
Linux 安装:AppImage / deb / rpm 三种方式
方式一:AppImage(通用、便携,推荐)
任意发行版都适用,只需赋予执行权限后直接运行:
chmod +x YDL.GUI_*.AppImage
./YDL.GUI_*.AppImage
⚠️ Arch Linux 的 AppImage 需要 FUSE 2 兼容包,首次使用请先执行
sudo pacman -S fuse2。如果环境无法启用 FUSE,可改用./YDL.GUI_*.AppImage --appimage-extract-and-run运行。
方式二:deb / rpm(正式安装)
- Debian / Ubuntu:双击
.deb或用sudo dpkg -i 文件名.deb安装 - Fedora / openSUSE:使用
.rpm包或sudo rpm -i 文件名.rpm安装
第三步:首次配置(关键,别跳过)
首次打开应用时,它会提示你先安装核心下载引擎 yt-dlp(相关逻辑见 src/components/SetupModal.vue)。完整流程只需 4 步:
- 打开应用,进入右上角 Settings(设置) 页面(src/pages/Settings.vue)
- 找到 yt-dlp 一栏,点击旁边的 下载 按钮 —— 程序会自动获取最新版本,无需手动配置
- (可选)安装 Deno 运行时:YouTube 需要 JavaScript 运行时来解析视频信息,装上后能拿到完整画质列表,包括更高画质的选项
- 设置 下载目录:指定视频保存到哪里(对应 src/components/DownloadDirCard.vue 中的目录卡片)
另外,如果下载时提示"无法合并音视频",说明还缺 FFmpeg(合并高清视频流与音频流必需),在设置页安装应用管理的 FFmpeg 或使用系统已安装的版本即可。
第一次下载:粘贴链接、选择画质
回到首页,把视频链接粘贴进输入框,点击 Parse(解析):
界面会立刻显示视频标题、UP 主、时长和可用格式。接着在 Download Method(下载方式) 中选择:
- Default(默认):自动挑选最佳画质
- Video Only(仅视频):只下载视频流
- Audio Only(仅音频):只提取音频,适合当背景音乐
确认无误后点击右下角 Download Now 按钮,任务就会加入下载队列。
下载中:实时查看进度、速度与剩余时间
在顶部导航切换到 Downloads(下载) 页签,可以看到每个任务的实时状态:
进度条旁会显示下载速度(如 6.84MiB/s)、已下载 / 总大小、完成百分比和 ETA(预计剩余时间)。任务支持一键暂停、继续和取消,下载完成后会归入 "Completed(已完成)" 分组,可直达文件所在文件夹。
进阶:试试工具箱(Toolbox)
安装配置完成后,顶部导航的 Tools(工具箱) 是隐藏彩蛋,包含多个实用工具:
- Download Thumbnail:提取并保存所有分辨率的视频封面图
- Download Subtitles:下载多语言字幕文件(SRT / VTT / ASS / LRC)
- Get Live Chat:抓取 YouTube 直播回放的弹幕数据
更多工具(插件管理、浏览器扩展等)源码位于 src/pages/toolbox/ 目录。
常见问题速查(FAQ)
Q:下载需要登录的视频怎么办? 在设置中配置 Cookie(支持 Netscape 格式文本或 Cookie 文件),配置入口见 src/components/CookieCard.vue。
Q:为什么 YouTube 的画质列表不全? 没有安装 Deno 运行时。回到设置页安装 Deno 后重新解析即可获得完整格式列表(提示文案见 src/locales/zh-CN/setup.json)。
Q:如何把网页视频直接"丢进"应用? 使用配套的 YDL GUI Helper 浏览器扩展:在应用内打开 工具箱 → Browser Extension 加载扩展后,一键发送当前页面链接和 Cookie,免复制粘贴。扩展源码见 browser-extension/ 目录。
Q:支持哪些下载参数自定义? 支持自定义文件名模板(标题、作者、日期、分辨率等变量)、时间裁剪、格式转码(MP4 / MKV / WebM / MP3 等)、限速与代理(HTTP / SOCKS),详见 README.zh-CN.md 的"进阶功能"。
写在最后
到这里,你已经完成了 yt-dlp GUI 的三平台安装与首次配置:下载安装包 → 自动获取 yt-dlp 核心 → 设置下载目录 → 粘贴链接开始下载。整个流程 5 分钟内即可完成。后续如果你想深入了解界面实现,可以看看 src/components/home/ 下的首页组件;想给项目提建议,欢迎在仓库中参与讨论。🚀



