如果 DownVid 对你有帮助，欢迎赞助支持项目的持续维护与迭代，请作者喝杯咖啡 ☕：
 微信扫码赞赏 |
在爱发电上赞助作者 |
- ⚡ 爱发电：https://afdian.com/a/xynrin
- ☕ 微信赞赏：微信扫码赞赏
- 💖 其他赞助方式：xynrin@icloud.com
- 💼 商务合作 / 广告位：请发邮件至 xynrin@icloud.com
软件本身完全开源，不含任何商业广告，将来也不会有。 缺陷反馈与需求建议请前往 Issues 提交。
Important
本项目是 yt-dlp 的图形界面封装，不包含破解或绕过技术保护措施的代码。请遵守当地法律法规、平台规则及内容版权要求，使用者需自行承担使用责任。
DownVid 是一款现代化、高性能、完全开源的跨平台桌面视频下载工具，原生支持 macOS、Windows 和 Linux。
本项目作为 yt-dlp 与 FFmpeg 的图形界面前端，抹平了复杂的命令行参数门槛，带来开箱即用、简洁无干扰的下载体验。
- 🌐 全网 1000+ 站点支持：深度覆盖主流短视频与长视频平台（抖音、快手、小红书、哔哩哔哩、YouTube、TikTok、X/Twitter、Instagram 等），支持无水印原画质提取。
- ⚡ 多路并发与下载加速：直链采用智能分块并发队列调度（最高 16 路），支持断点续传；可选集成 aria2 多连接加速引擎。
- 🔒 纯粹开源与注重隐私：无任何弹窗广告、无捆绑插件、不添加平台强制水印、不收集用户隐私。基于 MIT 协议完全开源。
- 📦 开箱即用依赖管理：内置 Go 依赖边车，自动探测并使用系统已有工具；缺失时支持一键自动下载配置，无需折腾环境变量。
- 🎨 精致现代视觉交互：基于 Material 3 设计语言，界面纯粹干练，全平台提供流畅统一的视觉与操作体验。
项目仍在积极持续演进中。遇到问题或有功能建议，欢迎提交 Issue。
| 功能 | 说明 |
|---|---|
| 多平台解析 | 基于 yt-dlp 支持 1000+ 个视频和音频网站；抖音、快手另有专属直链解析器 |
| 清晰度与格式 | 支持 360P 至 4K、仅音频（MP3）、仅字幕（SRT）及 YouTube 多音轨选择 |
| 下载管理 | 队列管理、暂停、恢复、重试、下载进度、速度、剩余时间与文件大小展示 |
| 下载加速 | 直链使用小块工作队列（默认 8 路、上限 16 路），可选 aria2 多连接；HLS/DASH 分片并发 |
| 登录内容 | 支持读取已安装浏览器的登录状态，也可以手动导入 cookies.txt |
| 运行依赖管理 | 自动识别系统中的 yt-dlp / FFmpeg；缺失时可在应用内一键下载至 ~/.downvid |
| 下载历史 | 自动保存最近 100 条下载记录，支持重命名与一键定位文件 |
| 自动更新 | 内置自更新机制，支持检查更新与一键静默应用 |
DownVid 通过 yt-dlp 支持 1000+ 个视频和音频网站。以下是常见平台示例：
| 国内平台 | 国际平台 |
|---|---|
| 抖音、小红书、快手、西瓜视频、哔哩哔哩（B 站） | YouTube、TikTok、Instagram、X（Twitter）、Facebook |
其他网站请参考 yt-dlp 支持的网站列表。平台可用性可能随网站规则变化而变化。
前往 GitHub Releases 下载最新版本，并按操作系统选择对应安装包：
| 平台 | 推荐安装器 | 便携版 / 更新包 | 架构说明 |
|---|---|---|---|
| macOS | DownVid-Wails-mac-universal-*.dmg |
DownVid-Wails-mac-universal-*.zip |
通用版本，同时支持 Apple 芯片与 Intel；拖拽安装 |
| Windows | DownVid-Wails-windows-x64-*-installer.exe |
DownVid-Wails-windows-x64-*.zip |
x64 原生安装向导（自动生成快捷方式）或绿色免安装包 |
| Linux | DownVid-Wails-linux-x64-*.deb |
DownVid-Wails-linux-x64-*.tar.gz |
Debian / Ubuntu 安装包或通用便携归档 |
安装步骤与常见问题见 安装指南。
- Node.js ≥ 22
- pnpm ≥ 8
- Go ≥ 1.25
- Wails CLI v2.16
yt-dlp 和 FFmpeg 无需预先安装。运行时会优先探测并复用系统已有版本；缺失时可在应用内下载安装。
git clone https://github.com/Downvid/downvid.git
cd downvid
pnpm install
pnpm --dir app/frontend install
# 端到端编译单文件产物（带依赖边车）
bash app/scripts/build.sh
# 界面快速开发热重载（不带依赖边车）
(cd app && wails dev)更多平台构建命令、依赖说明及排错步骤请查看 从源码构建指南。
| 技术 | 用途 |
|---|---|
| Wails v2 | 轻量桌面应用框架，调用原生系统 Webview |
| Go | 核心后端（16 个零耦合 internal 包）与依赖管理边车 |
| Svelte 5 | 前端框架（Runes 响应式系统） |
| yt-dlp | 视频与音频解析引擎 |
| FFmpeg | 音视频合并与转码 |
| Vitest | 纯逻辑单元测试 |
flowchart LR
subgraph WailsApp["DownVid 桌面应用"]
SvelteUI["前端界面<br/>Svelte 5 + Vite"] <-->|"Go Bindings"| GoCore["Go 核心引擎<br/>16 个 Internal 包"]
GoCore <-->|"嵌入调用"| Sidecar["依赖边车<br/>yt-dlp / FFmpeg / aria2"]
end
详细说明见 项目结构文档。
| 目录 | 作用 |
|---|---|
app/internal/ |
Go 核心，16 个包互相零依赖（解析、下载、历史、设置、自更新等） |
app/frontend/ |
Svelte 5 前端工程，编译后经 go:embed 内嵌进二进制 |
app/scripts/ |
桌面端构建入口脚本（build.sh 等） |
backend/ |
Go 依赖边车，探测并安装运行依赖至 ~/.downvid/runtime/bin |
shared/ |
前端与脚本共用的坐标与常量契约 |
scripts/ |
自动化生成、发布与静态校验脚本 |
website/ |
官方多平台直链分发落地页 |
docs/ |
安装、构建、维护与发布文档 |
提示缺少 yt-dlp 或 FFmpeg，怎么办？
安装包不会预置这两个工具。应用启动时会先探测系统中的可用版本；若未找到，可在提示窗口中一键下载安装至 ~/.downvid，或前往「设置 → 运行依赖」管理。
macOS 提示无法验证开发者，怎么办？
因应用未购买商业签名，首次打开时，请前往「系统设置 → 隐私与安全性」中点击「仍要打开」。若仍遇到问题，请参考 故障排除指南。
某些视频下载失败，怎么办？
部分网站要求用户登录。请确认你有权访问该内容，并尝试在设置中读取浏览器登录状态或导入 cookies.txt。
欢迎提交 Issue、改进文档或发起 Pull Request。
提交前建议运行：
pnpm --dir app/frontend check
pnpm lint:boundaries
pnpm lint:icons
pnpm lint:website
pnpm test感谢所有为 DownVid 做出贡献的人：
DownVid 基于 MIT License 开源。
关于项目名称、Logo 及第三方托管服务的品牌使用规则，请参阅品牌与商标使用政策。
DownVid 由 Downvid 组织开发与维护。本仓库全部代码的版权与许可声明记录在 LICENSE 中。
DownVid · Made with care by Xynrin