---

Sponsorship and business

If DownVid helps you, consider buying the author a coffee to support maintenance and continuous updates:

WeChat Pay Tip

Sponsor on Afdian

• ⚡ Afdian: https://afdian.com/a/xynrin
• ☕ WeChat Pay: Scan the QR code above to tip the author
• 💖 Other sponsorship options: [email protected]
• 💼 Business enquiries / Ads: [email protected]

The software is completely open source, contains no ads and never will. Please report issues or suggestions via GitHub Issues.

---

[!IMPORTANT] This project is a graphical front end for yt-dlp. It contains no code for cracking or circumventing technical protection measures. Please follow your local laws, platform terms and copyright requirements; you are responsible for how you use it.

Contents

• Sponsorship and business
• About
• Features
• Supported sites
• Install
• Build from source
• Documentation
• Tech stack and architecture
• Project layout
• FAQ
• Contributing
• Star history
• License and credits

About

DownVid is a modern, high-performance, open-source desktop video downloader for macOS, Windows, and Linux.

Built as a graphical frontend for yt-dlp and FFmpeg, it removes the complexity of command-line tools and provides a clean, native, and ad-free experience.

Why DownVid?

• 🌐 1000+ Platforms Supported: Seamlessly extracts high-quality video and audio across YouTube, Bilibili, Douyin, TikTok, Xiaohongshu, Kuaishou, Twitter/X, Instagram, and more.
• ⚡ Built-in Acceleration: Optimized multi-part chunk worker queues (up to 16 threads) and optional aria2 integration ensure lightning-fast downloads.
• 🔒 Zero Ads & Privacy-Focused: No popups, no bundled junkware, no telemetry, and no forced watermarks. Fully open source under the MIT license.
• 📦 Automated Dependency Management: Built-in Go sidecar detects and manages yt-dlp / FFmpeg, with one-click install into ~/.downvid/runtime/bin — no environment variables.
• 🎨 Modern Native UX: Clean Material 3 design crafted with Svelte 5 and Wails v2.

Features

Feature	Description
1000+ Sites	Powered by yt-dlp; dedicated parsers for Douyin and Kuaishou
Quality & Formats	360P to 4K, audio-only (MP3), subtitles-only (SRT), and YouTube multi-audio tracks
Download Manager	Queue management, pause, resume, retry, download progress, speed, ETA, and file size
Acceleration	Chunked worker queue (default 8, up to 16 connections), optional aria2
Authenticated Content	Import cookies from installed browsers or import cookies.txt
Runtime Dependencies	Detects manual paths and ~/.downvid/runtime/bin; one-click download when missing
History	Tracks your last 100 downloads with quick reveal in file manager
Auto Update	Built-in updater via GitHub Releases with silent in-place installation

Supported sites

DownVid supports 1000+ sites via yt-dlp, including:

• Domestic: Douyin, Kuaishou, Xiaohongshu, Bilibili, Xigua
• International: YouTube, TikTok, Instagram, Twitter/X, Facebook, and more

Download & Install

Download from GitHub Releases:

Platform	Recommended Installer	Portable / Update Archive	Description
macOS	DownVid-Wails-mac-universal-*.dmg	DownVid-Wails-mac-universal-*.zip	Universal binary for both Apple Silicon and Intel
Windows	DownVid-Wails-windows-x64-*-installer.exe	DownVid-Wails-windows-x64-*.zip	NSIS installer with shortcuts or portable zip
Linux	DownVid-Wails-linux-x64-*.deb	DownVid-Wails-linux-x64-*.tar.gz	Debian/Ubuntu package or portable archive

See the Installation Guide for detailed steps.

Build from source

Prerequisites

• Node.js ≥ 22
• pnpm ≥ 8
• Go ≥ 1.25
• Wails CLI v2.16

Steps

git clone https://github.com/Downvid/downvid.git
cd downvid
pnpm install
pnpm --dir app/frontend install

# Build standalone app with embedded sidecar
bash app/scripts/build.sh

# Live reload during development (without sidecar)
(cd app && wails dev)

Tech stack and architecture

• Framework: Wails v2
• Core Engine: Go (16 zero-coupled internal packages)
• Frontend: Svelte 5 + Vite + Tailwind CSS v4
• Engines: yt-dlp & FFmpeg
• Updater: wmlUpdate (source failover, resumable download, SHA-256 verification)
• Testing: Vitest

License

DownVid is open source under the MIT License.

---