DownVid Save the videos you like, locally. Open source · Cross-platform · Simple

Website · Download · Report an issue · Sponsorship / business · Installation guide

简体中文 | English

Sponsorship, or business enquiries such as advertising placements — email xynrin@icloud.com:

Please use the issue tracker for bug reports and feature requests instead, so that other users can find the answers too.

The app itself contains no ads and never will. These enquiries are about the project — for example a placement in this README or on the website — not about anything shipped inside the installer.

• 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

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.

• 🌐 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-first: No bundled third-party junk, no background telemetry, no forced watermarks. 100% open-source under the MIT license.
• 📦 Zero-Config Sidecar: Automatically detects existing system tools, or downloads and manages standalone yt-dlp & FFmpeg binaries in isolated user storage.
• 🎨 Modern Design: Designed with Material 3 design tokens, clean typography, responsive layout, and full cross-platform dark mode compatibility.

The project is under active development. If you hit a problem or have a suggestion, please open an issue.

DownVid supports 1000+ video and audio sites through yt-dlp. A few common ones:

For everything else see the yt-dlp supported sites list. Availability can change as sites change.

Download the latest build from GitHub Releases and pick the package for your OS.

Step-by-step instructions and common issues are in the installation guide.

The container image runs a native WebUI (no X11, no VNC) — open a browser and you have the full app, on desktop, tablet or phone:

# pull the official multi-arch image (amd64 + arm64)
docker run -d --name downvid -p 6080:6080 \
  -v "$PWD/data/downloads:/data/downloads" \
  -v "$PWD/data/userdata:/data/userdata" \
  ghcr.io/Downvid/downvid:latest
# then open http://127.0.0.1:6080/

Or, with compose (recommended — upgrades become one command):

curl -O https://raw.githubusercontent.com/Downvid/downvid/main/docker-compose.yml
docker compose up -d
# upgrade later: docker compose pull && docker compose up -d

yt-dlp / FFmpeg / ffprobe are preinstalled with the same versions and hashes the desktop app downloads. Downloads land in ./data/downloads on the host. Full details — configuration, reverse proxy, upgrading, troubleshooting — are in the Docker guide.

• Node.js ≥ 22
• pnpm ≥ 8
• Go ≥ 1.24

yt-dlp and FFmpeg do not need to be installed beforehand. At runtime DownVid detects and reuses whatever is already on your machine, and can download them in-app when missing.

git clone https://github.com/Downvid/downvid.git
cd downvid
pnpm install
pnpm dev       # development
pnpm build     # package for the current platform

Per-platform build commands, dependency notes and troubleshooting are in the build from source guide.

The in-depth docs are currently written in Chinese. Contributions that translate them are very welcome.

flowchart LR
    UI["Renderer<br/>Vue 3"] <-->|"IPC"| Main["Main process<br/>Electron / Node.js"]
    Main <-->|"NDJSON"| Sidecar["Go dependency sidecar"]
    Main --> Engine["yt-dlp"]
    Main --> Media["FFmpeg"]

An interactive diagram with more detail is in the architecture doc.

See the project structure doc for the full tree.

More in the FAQ and troubleshooting guide.

Issues, documentation improvements and pull requests are all welcome.

Before submitting, please run:

pnpm vue-tsc --noEmit
pnpm test
pnpm lint:ipc

See the contributing guide and repository standards for the rest.

Thanks to everyone who has contributed to DownVid:

DownVid is released under the MIT License.

For the project name, logo, and third-party service attribution, see the Brand and Trademark Usage Policy.

DownVid is developed and maintained by the Downvid organization. Copyright and license notices for all code in this repository are recorded in LICENSE.

Thanks also to the community contributors and to the maintainers of the projects we depend on:

• yt-dlp — extraction engine
• FFmpeg — audio and video processing
• Electron · Vue.js · Tailwind CSS — app stack
• Claude Code — AI coding assistant

If DownVid is useful to you, you can buy the author a coffee. WeChat tip code:

Show tip code

For sponsorship and business enquiries, see Sponsorship and business above.