5 分钟装好 yt-dlp GUI:Windows / macOS / Linux 三平台安装与首次配置全图解

原创2026-11-07 21:25:291,913 阅读
文章标签:桌面应用视频插件系统国际化

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 按发行版选择对应格式

yt-dlp GUI 首页界面,粘贴视频链接即可开始下载

第二步:三平台安装步骤详解

Windows 安装:双击 .exe 一路"下一步"

  1. 双击下载好的 .exe 安装包(如遇到 SmartScreen 提示,选择"仍要运行")
  2. 按安装向导提示完成安装,默认路径即可
  3. 启动后桌面会出现 YDL GUI 图标,首次启动速度很快(安装包很小)

macOS 安装:拖拽 .dmg 到应用程序

  1. 双击 .dmg 文件,将应用图标拖入 Applications(应用程序) 文件夹
  2. 首次打开时,如果系统提示"无法验证开发者",可在 系统设置 → 隐私与安全性 中点击"仍要打开"
  3. 之后即可像普通 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 步:

  1. 打开应用,进入右上角 Settings(设置) 页面(src/pages/Settings.vue)
  2. 找到 yt-dlp 一栏,点击旁边的 下载 按钮 —— 程序会自动获取最新版本,无需手动配置
  3. (可选)安装 Deno 运行时:YouTube 需要 JavaScript 运行时来解析视频信息,装上后能拿到完整画质列表,包括更高画质的选项
  4. 设置 下载目录:指定视频保存到哪里(对应 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/ 下的首页组件;想给项目提建议,欢迎在仓库中参与讨论。🚀

登录后查看全文
yt-dlp-gui