Practical yt-dlp docs: install, commands, fixes, cookies, and workflows.
Install & Update hub
Get yt-dlp installed cleanly, keep it current, and fix setup problems before they waste your time.
Most early yt-dlp pain is not really about commands. It is about setup: the wrong install path, a stale version, missing ffmpeg, or a terminal that cannot see the binary you thought you installed. This pillar exists to solve that layer first.
Install yt-dlp
Get yt-dlp and ffmpeg working properly on macOS, Windows, or Linux before you touch anything else.
Update yt-dlp
Use the right update path for the copy of yt-dlp you are actually running, not the one you think you installed.
Fix "ffmpeg not found"
Solve the most common setup blocker when audio extraction, merges, or post-processing fail.
Start here if
- • yt-dlp is not installed yet
- • the command is not recognized in your terminal
- • you are not sure whether ffmpeg is installed or on PATH
Use the update page if
- • yt-dlp used to work but suddenly broke
- • a site changed and you need a newer extractor
- • you need to confirm you updated the right install
Use the ffmpeg fix page if
- • downloads work but audio extraction fails
- • best-video plus best-audio merging is broken
- • yt-dlp says ffmpeg is missing even though you installed it
What this pillar covers
Installation basics
- • macOS, Windows, and Linux install paths
- • ffmpeg setup
- • version checks
- • fast install sanity tests
Maintenance and fixes
- • updating the right yt-dlp copy
- • PATH and shell mismatch issues
- • missing ffmpeg troubleshooting
- • deciding whether the problem is setup or usage
The common failure pattern
People often jump from “yt-dlp is broken” straight into platform-specific debugging. That is backward. If the install is wrong, the version is stale, or ffmpeg is invisible to the shell, you can waste a lot of time solving the wrong problem.
The right order is: install → verify → update → only then troubleshoot higher-level usage problems.
Later
Need a cleaner workflow after the fix?
Solve the issue first. If yt-dlp becomes part of a repeated process afterward, Importly is worth a look when you want the workflow to be more organized and less manual.
Next places to go
Commands & Usage
Once setup is stable, move into actual command patterns.
Troubleshooting & Errors
Use this when the issue goes beyond basic installation.
Authentication & Access
For login-required downloads, cookies, and private content.
Workflows & Automation
When you move from one-off commands to repeatable systems.