yt-dlp Command Generator for Pinterest

yt-dlp --merge-output-format mp4 --no-playlist https://www.pinterest.com/pin/123456789/

Basics

What do you want

Video Audio only

Audio-only extracts the soundtrack and drops the video stream.

Video and quality

Maximum quality -f Best available 4K (2160p) 2K (1440p) 1080p 720p 480p 360p

Caps the height. yt-dlp still picks the best stream at or below it.

Container --merge-output-format needs ffmpeg Keep original MP4 (most compatible) MKV (keeps everything) WebM MOV

The file type separate video and audio streams are merged into.

Advanced options (3)

Custom format selector -f

Overrides the quality dropdown. For people who already know the format syntax.

Remux into --remux-video needs ffmpeg None MP4 (most compatible) MKV (keeps everything) WebM MOV

Repackages the streams without re-encoding. Fast and lossless.

Re-encode into --recode-video needs ffmpeg None MP4 (most compatible) MKV (keeps everything) WebM

Re-encodes the video. Slow and lossy — only when remuxing will not do.

Audio

Audio format --audio-format needs ffmpeg MP3 M4A (AAC) Opus FLAC (lossless) WAV (lossless) Vorbis Best available (no conversion)

The file the audio is converted to.

Audio quality --audio-quality needs ffmpeg Best (VBR) 320 kbps 256 kbps 192 kbps 128 kbps

VBR gives the best size-to-quality ratio; fixed bitrates are more predictable.

Subtitles

Subtitles None Embed in the video Save as .srt file Embed and save

Embedding puts them inside the video; saving writes a separate .srt next to it.

Subtitle languages --sub-langs

Comma separated. Use all for every available language.

Auto-generated subtitles --write-auto-subs Include machine-generated captions when no human ones exist.

Playlists and channels

Playlist handling Let yt-dlp decide This video only The whole playlist

What to do when the URL belongs to both a video and a playlist.

Which items -I

Ranges and lists both work, for example 1-10,15 or -5::2 for every second item from the end.

Advanced options (1)

Archive file --download-archive

Records what has been downloaded so re-running skips it. The way to keep a channel in sync.

Sections and chapters

Advanced options (2)

Download only part of it --download-sections needs ffmpeg

A time range like *00:01:30-00:03:00, or a chapter name. The leading asterisk means it is a timestamp.

Split into chapters --split-chapters needs ffmpeg Writes one file per chapter instead of a single long one.

Metadata and artwork

Embed thumbnail --embed-thumbnail needs ffmpeg Uses the video thumbnail as cover art.

Embed metadata --embed-metadata needs ffmpeg Writes title, uploader and date into the file itself.

Embed chapters --embed-chapters needs ffmpeg Adds chapter markers your player can jump between.

Advanced options (3)

Save thumbnail file --write-thumbnail Writes the cover image next to the video.

Save description --write-description Writes the description to a .description file.

Save metadata JSON --write-info-json Writes everything yt-dlp knows about the video to a .info.json file.

SponsorBlock

Remove segments --sponsorblock-remove needs ffmpeg None Sponsors only Sponsors, intros and self-promotion Everything marked

Cuts community-marked segments out of the file using SponsorBlock data.

Advanced options (1)

Mark segments as chapters --sponsorblock-mark None Sponsors, intros and self-promotion Everything marked

Keeps the segments but marks them, so you can skip them yourself.

Files and folders

File name template -o

Title Title + ID Numbered playlist Uploader / date - title

Field names go in %(...)s. Slashes create folders.

Safe (ASCII) file names --restrict-filenames Strips accents, spaces and anything a stubborn filesystem might reject.

Overwrite existing files --force-overwrites Replaces files that are already there.

Resume partial downloads -c Picks up where an interrupted download stopped.

Advanced options (4)

Download folder -P

Where files are written. Combine with the template above for subfolders.

Windows-safe names --windows-filenames Removes characters Windows refuses even when running elsewhere.

Trim names to --trim-filenames

Maximum file name length in characters.

Never overwrite -w Skips anything already downloaded.

Filters

Advanced options (5)

Uploaded after --dateafter

YYYYMMDD, or a relative date like now-1month.

Uploaded before --datebefore

YYYYMMDD, or a relative date.

Minimum size --min-filesize

Skips anything smaller. Accepts 5M, 500K and similar.

Maximum size --max-filesize

Skips anything larger.

Stop after --max-downloads

Number of files to download before stopping.

Network

Speed limit -r

For example 2M or 500K. Useful when you need the rest of your bandwidth.

Advanced options (5)

Parallel fragments -N

Speeds up fragmented streams. Four is a sensible starting point.

Retries -R

How many times to retry a failed piece. infinite is allowed.

Proxy --proxy

HTTP, HTTPS or SOCKS proxy URL.

Bypass geo-restriction --geo-bypass Fakes the request origin. Works on some sites, not all.

Impersonate a browser --impersonate None Chrome Edge Safari Firefox

Makes requests look like a real browser. The usual fix for sudden 403 errors.

Login and cookies

Cookies from browser --cookies-from-browser None Chrome Firefox Edge Brave Safari Chromium Opera Vivaldi

Reads your logged-in session directly. Needed for private, age-restricted or members-only content.

Advanced options (1)

Cookies file --cookies

A Netscape-format cookies.txt exported from your browser.

Live streams

Advanced options (2)

Record from the start --live-from-start Starts a live stream from the beginning instead of the current moment.

Wait for the stream --wait-for-video

Polls until a scheduled stream begins. MIN-MAX seconds between checks.

Workarounds

Advanced options (3)

User agent --user-agent deprecated

Deprecated in favour of --add-headers. Kept because plenty of older guides still use it.

Referer --referer deprecated

Deprecated in favour of --add-headers.

Extractor arguments --extractor-args

Site-specific switches, for example youtube:player_client=web.

Output and debugging

List formats only -F Prints the available formats and exits without downloading.

Advanced options (2)

Keep going on errors -i Skips items that fail instead of stopping. Essential for large playlists.

Simulate -s Does everything except write the file.