Practical yt-dlp docs: install, commands, fixes, cookies, and workflows.
Practical yt-dlp help
Practical yt-dlp guides that stay current
Whether you type it yt-dlp or ytdlp: install it, find working commands, fix errors, handle cookies, and automate repeat downloads — without digging through stale forum posts.
Start here if you need to...
Common jobs
Start with the job you need to get done.
Most visitors are trying to solve one practical problem. Pick the closest match and go straight to the right hub or guide.
Install yt-dlp
Set up yt-dlp cleanly, fix PATH or ffmpeg issues, and get to a working install fast.
Fix common yt-dlp errors
Start here when yt-dlp suddenly breaks, formats disappear, or a command stops working.
Use cookies with yt-dlp
Handle login-required, age-gated, private, or browser-authenticated downloads.
Download playlists
Run playlist downloads cleanly instead of managing one-off commands item by item.
Extract audio as MP3
Convert downloads to MP3 cleanly and avoid the usual ffmpeg and audio extraction mistakes.
Automate or run on a server
Schedule recurring downloads, run yt-dlp headless, or call it from your own app or pipeline.
Browse by section
Browse the docs by topic.
Use the section that matches your problem, then follow the best starting point from there.
Install & Update
Get yt-dlp working locally, verify prerequisites, and keep it current.
Start here
How to install yt-dlp on Mac, Windows, and Linux
Commands & Usage
Run yt-dlp for practical tasks like playlists, subtitles, and audio extraction.
Start here
Best yt-dlp commands for video, audio, playlists, and subtitles
Troubleshooting & Errors
Solve failures quickly when yt-dlp breaks, formats disappear, or dependencies are missing.
Start here
How to fix common yt-dlp errors
Platforms
Handle platform-specific workflows across YouTube and future source-specific pages.
Start here
How to use yt-dlp for YouTube
Cookies & Access
Solve cookies, login state, private-video access, and permission-related blockers.
Start here
How to use cookies with yt-dlp
Workflows & Automation
Move from one-off commands to repeatable, organized download systems.
Start here
How to use output templates in yt-dlp
Reference & Concepts
Understand the flags, concepts, and reference material that support deeper yt-dlp usage.
Start here
yt-dlp format selection explained
Popular guides
The guides most people need first.
Start here if you want the highest-value install, command, troubleshooting, cookies, YouTube, and workflow pages.
How to install yt-dlp on Mac, Windows, and Linux
Clean install instructions, ffmpeg setup, path fixes, and the shortest path to a working yt-dlp install.
Best yt-dlp commands for video, audio, playlists, and subtitles
A practical command reference for the stuff people actually search for and use every day.
How to fix common yt-dlp errors
403s, signature issues, cookies, age restrictions, extractor failures, and format selection problems.
How to use cookies with yt-dlp
The fastest fixes for login-required downloads, browser cookies, cookies.txt, and auth-related access problems.
How to use yt-dlp for YouTube
A focused entry point for YouTube-specific commands, playlists, subtitles, cookies, and quality control.
How to use yt-dlp as an API
Embed yt-dlp in Python, wrap it in your own service, or use a managed media-import API — with honest trade-offs for each.
For builders
Running yt-dlp inside an app, script, or automation?
These docs cover the CLI. When media import needs to be infrastructure — reliable, scheduled, and not your problem when a site changes — Importly turns any public link into usable media with one API call.
Prefer to keep it manual? Browse the workflow guides.
Try it: paste any video link
See what a media-import API returns for it — no install, no signup.
What ytdlp.org covers
Less guesswork, better yt-dlp docs.
This site focuses on the practical parts of yt-dlp that people actually search for: installation, updates, commands, troubleshooting, cookies, format selection, playlists, subtitles, and repeatable download workflows.