ytdlp.org

Practical yt-dlp docs: install, commands, fixes, cookies, and workflows.

Current section

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.

What do you want?
Options

Cookies help with private, members-only or age-gated videos. Close the browser first if the cookie database is locked.

Your command

yt-dlp --no-playlist VIDEO_URL

What each flag does

--no-playlist
— Download only this one video, even if the URL points into a playlist.

How to use the command

  1. Make sure yt-dlp is installed and current (how to update). A stale build is the most common reason a correct command still fails.
  2. Install ffmpeg if your command extracts audio, converts to MP3, embeds a thumbnail, or merges separate video and audio streams.
  3. 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

Related guides

Straightforward yt-dlp help for installs, commands, fixes, cookies, and repeatable workflows.

ytdlp.org is an independent, community-maintained documentation site. It is not affiliated with the yt-dlp project — the official source code lives at github.com/yt-dlp/yt-dlp.