yt-dlp Complete Guide: I Download Video from 1000+ Sites With This One Tool
yt-dlp Complete Guide: I Download Video from 1000+ Sites With This One Tool
Updated 2026-08-05. Star count verified against the live GitHub repo (180,000+).
TL;DR: If you need a video off the internet, stop clicking "download" buttons on sketchy sites. yt-dlp (180k★, Unlicense) is a single command-line tool that pulls from YouTube, Bilibili, TikTok, and over a thousand other sites. It's free, it's open source, and it's been the standard for years.
Why I stopped using download websites
Every "free YouTube downloader" site has the same pattern: three ads, one fake button, and a watermark on the output. I got tired of it and switched to yt-dlp about two years ago. The first time I ran it, a 40-minute video was on my disk in under a minute, with the actual quality I picked, no watermark, no "please install our toolbar."
The catch: it's a command-line tool. If you've never touched a terminal, that sounds scary. It's not. There are maybe five commands you'll ever need, and I'll show you all of them.
Install
Windows: download the .exe from the releases page, drop it somewhere on your PATH, done. Mac: brew install yt-dlp. Linux: your package manager probably has it, or use the one-liner from the repo.
If you already have Python, pip install yt-dlp works too. That's it. No accounts, no keys, nothing.
The commands you'll actually use
Download a video (best quality):
```
yt-dlp "URL"
```
That's the whole thing. It picks the best quality automatically, names the file sanely, and saves it where you're standing.
Download just the audio (for podcasts, samples, voice lines):
```
yt-dlp -x --audio-format mp3 "URL"
```
I use this one constantly for ripping audio from YouTube videos to feed into transcription tools. It's how I tested Whisper and faster-whisper for the catalog — grab an episode, transcribe it, done.
Download a whole playlist or channel:
```
yt-dlp -o "%(playlist_title)s/%(title)s.%(ext)s" "PLAYLIST_URL"
```
The -o flag controls the file naming. Without it, everything dumps into one folder and it gets messy fast. Learn -o, thank me later.
Only grab the subtitles:
```
yt-dlp --write-subs --sub-langs "en,zh" --skip-download "URL"
```
Useful if you want the transcript of something without the video file. Or pair it with a subtitle generator if the site's subs are bad.
Limit the format (old videos, weird codecs):
```
yt-dlp -f "bestvideo[height<=720]+bestaudio/best" "URL"
```
Sometimes "best quality" means a codec your player chokes on. This pins it to 720p with a safe audio track. My rule: if the file won't play, add -f and try again.
What to do when it breaks
It will break, because sites change their internals all the time. The good news: yt-dlp updates constantly for exactly this reason. So the fix is usually:
```
yt-dlp -U
```
That updates it to the newest version. I'd say 80% of "it stopped working" posts are solved by updating. The other 20% are rate limits — YouTube throttling you for too many downloads in a row. Wait a few minutes, don't hammer it.
If you get a specific error code, paste it into a search with "yt-dlp" and you'll find the issue thread. Someone has hit it before, I promise.
Is it legal?
Depends what you do with it. The tool itself is legal and famously used by archivists, journalists, and educators. Downloading copyrighted content for redistribution is not. Downloading things you have the right to access — public talks, your own videos, free content, Creative Commons stuff — is fine. Use judgment, like everything else.
Why this matters for AI work
Here's the part nobody tells you: yt-dlp is a quietly essential piece of the AI content pipeline. Want to build a dataset? Pull videos, transcribe with Whisper. Want to make faceless videos? Grab clips, feed them to MoneyPrinterTurbo (99k★). Want to study what's trending? Download the top videos in your niche and analyze the first 30 seconds.
It's the plumbing under a lot of AI workflows, and it costs nothing.
Bottom line
Five commands, one tool, no accounts. Install it, update it when it complains, and you'll never use a sketchy download site again. That's the whole guide — I'm not going to pad it out with fluff. If I missed your use case, the repo docs are actually readable, which is rare.
All tools mentioned are available as ready-to-run packages on AI Tool Mart with setup guides and troubleshooting.