downvid

赞助与商务合作

如果 DownVid 对你有帮助，欢迎赞助支持项目的持续维护与迭代，请作者喝杯咖啡 ☕：

• ⚡ 爱发电：https://afdian.com/a/xynrin
• ☕ 微信赞赏：微信扫码赞赏
• 💖 其他赞助方式：xynrin@icloud.com
• 💼 商务合作 / 广告位：请发邮件至 xynrin@icloud.com

软件本身完全开源，不含任何商业广告，将来也不会有。 缺陷反馈与需求建议请前往 Issues 提交。

[!IMPORTANT] 本项目是 yt-dlp 的图形界面封装，不包含破解或绕过技术保护措施的代码。请遵守当地法律法规、平台规则及内容版权要求，使用者需自行承担使用责任。

目录

• 赞助与商务合作
• 项目简介
• 核心亮点
• 功能特性
• 支持的网站
• 下载安装
• 从源码构建
• 技术栈与架构
• 项目结构
• 常见问题
• 参与贡献
• Star History
• 开源协议与致谢

项目简介

DownVid 是一款现代化、高性能、完全开源的跨平台桌面视频下载工具，原生支持 macOS、Windows 和 Linux。

本项目作为 yt-dlp 与 FFmpeg 的图形界面前端，抹平了复杂的命令行参数门槛，带来开箱即用、简洁无干扰的下载体验。

核心亮点

• 🌐 全网 1000+ 站点支持：深度覆盖主流短视频与长视频平台（抖音、快手、小红书、哔哩哔哩、YouTube、TikTok、X/Twitter、Instagram 等），支持无水印原画质提取。
• ⚡ 多路并发与下载加速：直链采用智能分块并发队列调度（最高 16 路），支持断点续传；可选集成 aria2 多连接加速引擎。
• 🔒 纯粹开源与注重隐私：无任何弹窗广告、无捆绑插件、不添加平台强制水印、不收集用户隐私。基于 MIT 协议完全开源。
• 📦 开箱即用依赖管理：内置 Go 依赖边车，统一检测并管理 yt-dlp / FFmpeg；缺失时一键下载到 ~/.downvid/runtime/bin，无需配置环境变量。
• 🎨 精致现代视觉交互：基于 Material 3 设计语言，界面纯粹干练，全平台提供流畅统一的视觉与操作体验。

项目仍在积极持续演进中。遇到问题或有功能建议，欢迎提交 Issue。

功能特性

支持的网站

DownVid 通过 yt-dlp 支持 1000+ 个视频和音频网站。以下是常见平台示例：

其他网站请参考 yt-dlp 支持的网站列表。平台可用性可能随网站规则变化而变化。

下载安装

前往 GitHub Releases 下载最新版本，并按操作系统选择对应安装包：

安装步骤与常见问题见 安装指南。

从源码构建

环境要求

• 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)

更多平台构建命令、依赖说明及排错步骤请查看 从源码构建指南。

技术栈与架构

技术栈

架构概览

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

详细说明见 项目结构文档。

项目结构

常见问题

安装包不会预置这两个工具。应用启动时会先探测系统中的可用版本；若未找到，可在提示窗口中一键下载安装至 ~/.downvid，或前往「设置 → 运行依赖」管理。

因应用未购买商业签名，首次打开时，请前往「系统设置 → 隐私与安全性」中点击「仍要打开」。若仍遇到问题，请参考 故障排除指南。

部分网站要求用户登录。请确认你有权访问该内容，并尝试在设置中读取浏览器登录状态或导入 cookies.txt。

更多问题见 FAQ 与 故障排除指南。

参与贡献

欢迎提交 Issue、改进文档或发起 Pull Request。

提交前建议运行：

pnpm --dir app/frontend check
pnpm lint:boundaries
pnpm lint:icons
pnpm lint:website
pnpm test

更多流程请查看 贡献指南 和 仓库规范。

贡献者

感谢所有为 DownVid 做出贡献的人：

Star History

开源协议与致谢

DownVid 基于 MIT License 开源。

关于项目名称、Logo 及第三方托管服务的品牌使用规则，请参阅品牌与商标使用政策。

DownVid 由 Downvid 组织开发与维护。本仓库全部代码的版权与许可声明记录在 LICENSE 中。

DownVid · Made with care by Xynrin