DEV Community

yudong
yudong

Posted on • Originally published at ylyvip.net

yt-dlp Complete Guide: I Download Video from 1000+ Sites With This One Tool

\n

Direct answer: yt-dlp (182,957 ★, Unlicense, GitHub-verified 2026-08-07) is a command-line tool that downloads video from YouTube, Bilibili, TikTok, and over a thousand other sites — free, open source, no watermark, original quality. Five commands cover 95% of usage: download, extract audio, download playlists, grab subtitles, and pin format. This guide covers all five.

\n

Why yt-dlp instead of download websites

\n

Download-website pattern: three ads, one fake button, watermark on output, and a toolbar installer. yt-dlp: one command, real quality, nothing else. It's the standard tool for archival, research, and AI content pipelines — Unlicense means no license restrictions at all.

\n

Install

\n
  • Windows: download the .exe from the official releases page, add to PATH.
  • macOS: brew install yt-dlp.
  • Linux: package manager, or the one-liner from the repo.
  • Python users: pip install yt-dlp.
\n

No accounts, no API keys.

\n

The five commands you'll actually use

\n\n\n\n\n\n\n\n\n
Task Command
Download video (best quality) yt-dlp \"URL\"
Audio only (mp3) yt-dlp -x --audio-format mp3 \"URL\"
Whole playlist, organized yt-dlp -o \"%(playlist_title)s/%(title)s.%(ext)s\" \"URL\"
Subtitles only yt-dlp --write-subs --sub-langs \"en,zh\" --skip-download \"URL\"
Pin a format (720p safe) yt-dlp -f \"bestvideo[height<=720]+bestaudio/best\" \"URL\"
\n

When it breaks

\n

Sites change internals constantly; yt-dlp updates constantly to match. The fix is usually:

\n



yt-dlp -U

\n

That updates to the newest version — 80% of \"it stopped working\" is solved by this. The other 20% is rate-limiting: too many downloads too fast. Wait a few minutes, don't hammer.

\n

Legal note

\n

The tool is legal and used by archivists, journalists, and educators. Downloading copyrighted content for redistribution is not. Downloading what you have the right to access — public talks, your own videos, Creative Commons content — is fine. Use judgment.

\n

Why it matters for AI work

\n

yt-dlp is quietly essential to AI content pipelines: pull videos → transcribe with Whisper (106,802 ★, MIT) → build datasets. Grab footage → feed MoneyPrinterTurbo (101,968 ★, MIT) for faceless videos. It's the plumbing under a lot of AI workflows, and it costs nothing.

\n

FAQ

\n

Does it work with Bilibili, Douyin, TikTok? Yes — 1000+ sites supported, including the major Chinese platforms. Some login-walled content needs a cookies parameter (see official docs).

\n

Is it safe? It's open source with a massive community; the Windows .exe is the official build. Download only from the official releases page.

\n

What if a site needs login? Use --cookies-from-browser chrome or export cookies — documented per-site in the repo wiki.

\n

How was the star count verified? GitHub API, 2026-08-07: yt-dlp 182,957 ★, Unlicense.

\n

Summary

\n

yt-dlp (182,957 ★, Unlicense, verified 2026-08-07): five commands, one tool, no accounts. Install it, update when it complains, and never use a sketchy download site again. It's also the quiet foundation of AI video pipelines. Browse the full 461-tool catalog at ylyvip.net/tools.

Top comments (0)