Commands & usage
yt-dlp command generator
Pick what you want and this builds the yt-dlp command for you - quality, audio-only, subtitles, playlists, cookies and output naming. Copy the result and run it in your own terminal. Nothing is downloaded on this page.
New to yt-dlp? Start with the install guide(you'll want ffmpeg too), then come back here. For a hand-written reference of the most common patterns, see yt-dlp commands.
Optional — leave blank and the command uses VIDEO_URL as a placeholder.
Your command
yt-dlp --no-playlist VIDEO_URLWhat each flag does
- --no-playlist
- — Download only this one video, even if the URL points into a playlist.
How to use the command
- Make sure yt-dlp is installed and current (how to update). A stale build is the most common reason a correct command still fails.
- Install ffmpeg if your command extracts audio, converts to MP3, embeds a thumbnail, or merges separate video and audio streams.
- Paste the command into your terminal, replace VIDEO_URL if you left it blank, and run it.
The building blocks
Every yt-dlp command is the same shape: yt-dlp [options] URL. The two options that change the most are the format selector (-f), which decides quality and whether you get video or just audio, and the output template (-o), which decides where files land and how they are named. If you want to understand format selection properly, read yt-dlp format selection explained.
Frequently asked questions
What does this yt-dlp command generator do?
It builds a yt-dlp command from the options you pick - quality, audio-only, subtitles, playlist, cookies and output naming - so you can copy a correct command instead of memorizing flags. Nothing runs here; you copy the command and run it in your own terminal.
What is the basic yt-dlp command to download a video?
yt-dlp VIDEO_URL. With no other flags, yt-dlp picks the best available video and audio and merges them into one file (merging needs ffmpeg). Everything else - resolution caps, audio extraction, subtitles - is an extra flag on top of that.
How do I download only the audio as MP3?
yt-dlp -x --audio-format mp3 VIDEO_URL. The -x flag extracts the audio and --audio-format mp3 converts it, both of which need ffmpeg installed. If you don't need MP3 specifically, -f bestaudio downloads the best audio stream without converting.
How do I pick a specific resolution like 1080p?
Use a format selector: yt-dlp -f "bestvideo[height<=1080]+bestaudio/best[height<=1080]" VIDEO_URL. This grabs the best video up to 1080p plus the best audio, and falls back to the best single file capped at 1080p if a separate stream isn't available.
The command works on my laptop but fails on a server. Why?
YouTube and many sites block the datacenter IP ranges that servers, CI runners and agent sandboxes use, so the same command returns a bot check or HTTP 403 there. See the guide on yt-dlp blocked on a server for the fixes, and the server/agent options below.
For builders
Using yt-dlp inside an app or script?
Paste a link to see what a managed media-import API returns — no install, no signup.
Building this into an app? See the API your backend calls instead