yt-dlp video downloader Full review

yt-dlp is an open-source fork of youtube-dl, written in Python and shipped as a command-line tool. It is not trying to be a download button, it is a programmable media extraction engine: you hand it a URL and the spec you want, and it handles the parsing, the picking, the downloading and the merging.

The real difference from every other downloader is the maintenance model. The site parsing rules are community-maintained, one standalone extractor module per site, so when a platform changes its API only that one module gets patched. Two things follow from that: it covers far more sites than any commercial product (1,800+ right now), and it recovers from breakage faster than anything else, usually with a new release within days.

The trade-off is there is no GUI. Everything happens as a command in a terminal, and your first run costs maybe fifteen minutes of getting your head around a handful of core flags. If you would rather not touch a terminal, use its GUI front end Stacher, which does almost everything yt-dlp does.

Step 1: identify the site, call the right extractor

yt-dlp ships an extractor for every site it supports. Give it a URL and it matches the domain to a module, and that module's job is pulling the media address out of that site's page or API. This is exactly why a redesign on one platform only affects that one site instead of breaking the whole tool.

Step 2: list every available video and audio stream

Modern platforms usually keep the video track and the audio track stored separately (DASH), and above 1080p they are almost always split. The extractor hands back a manifest with the resolution, bitrate, codec and file size of every stream. You can print that list with -F.

Step 3: pick the stream on your own terms

-f is a small selection language. For example, bestvideo[height<=1080]+bestaudio<> means the best video track no higher than 1080p plus the best audio track. This is yt-dlp's biggest edge over any online tool: you are picking the stream, not choosing between two buttons somebody else gave you.

Step 4: download, then merge with FFmpeg

Once the video and audio tracks finish downloading separately, it calls FFmpeg to wrap them into a single file. So when you install yt-dlp, install FFmpeg alongside it. Skip that and high-resolution downloads fall back to a pre-muxed low-res version, because nothing is there to merge them. This is the single most common beginner trap: why am I only getting 360p?

When it breaks, and why

When a platform changes the signing algorithm on its playback URLs, swaps out encrypted parameters, or adds a bot check, that one extractor stops working for a while. There is exactly one fix: update to the latest build (yt-dlp -U). If the newest build still fails, check the project's issue list to see whether somebody already reported it.