YouTube-dl Web Interface

This guide explains yt-dlp --help parameters using practical, real-world use cases. Instead of listing options mechanically, each section focuses on why and when you should use specific parameters.

---

Scenario 1: Download a Video in One Command

Use case

You simply want to download a video from YouTube, TikTok, or any other supported website.

Command

yt-dlp https://example.com/video

What happens

• yt-dlp automatically selects the best available format
• Video and audio are merged if needed
• The file is saved to the current directory

Related parameters

No parameters are required. This is the default behavior of yt-dlp.

Tip

If this command works, you don’t need advanced options yet.

---

Scenario 2: Download the Best Video and Audio Quality

Use case

You want the highest quality available, even if video and audio are provided as separate streams.

Command

yt-dlp -f "bv*+ba/b" https://example.com/video

Parameters explained

• -f, --format: Controls which video/audio formats are downloaded
• bv*: Best available video-only format
• ba: Best available audio-only format
• b: Fallback to the best single file

Why this matters

Modern platforms often separate video and audio streams to support higher resolutions.

---

Scenario 3: Download Audio Only (MP3 or M4A)

Use case

You only need the audio track, for music, podcasts, or offline listening.

Command

yt-dlp -x --audio-format mp3 https://example.com/video

Parameters explained

• -x, --extract-audio: Extracts audio after downloading
• --audio-format mp3: Converts audio to MP3 using FFmpeg

Optional quality setting

--audio-quality 0

0 means best available quality.

---

Scenario 4: Choose Video Resolution and Format

Use case

You want to download a specific resolution (for example, 1080p instead of 4K).

Step 1: List available formats

yt-dlp -F https://example.com/video

Step 2: Download selected formats

yt-dlp -f 137+140 https://example.com/video

Parameters explained

• -F, --list-formats: Displays all available formats
• -f 137+140: Downloads video format 137 and audio format 140

---

Scenario 5: Download a Playlist

Use case

You want to download multiple videos from a playlist, but not all of them.

Command

yt-dlp --playlist-start 1 --playlist-end 10 https://example.com/playlist

Parameters explained

• --playlist-start: First video index to download
• --playlist-end: Last video index to download

---

Scenario 6: Control File Names and Output Paths

Use case

You want clean, organized file names and folders.

Command

yt-dlp -o "%(uploader)s/%(title)s.%(ext)s" https://example.com/video

Parameters explained

• -o, --output: Output filename template
• Common variables:
  • %(title)s
  • %(uploader)s
  • %(id)s
  • %(ext)s

---

Scenario 7: Download Subtitles

Use case

You need subtitles for learning, accessibility, or translation.

Command

yt-dlp --write-subs --sub-langs en https://example.com/video

Parameters explained

• --write-subs: Downloads subtitles
• --sub-langs en: Subtitle language code

Auto-generated subtitles

yt-dlp --write-auto-subs https://example.com/video

---

Scenario 8: Download Login-Required or Age-Restricted Videos

Use case

The video requires login, such as age-restricted or private content.

Command

yt-dlp --cookies-from-browser chrome https://example.com/video

Parameters explained

• --cookies-from-browser: Extracts cookies from your logged-in browser

---

Scenario 9: Improve Download Speed and Stability

Use case

Downloads are slow or frequently interrupted.

Command

yt-dlp -N 8 --retries infinite https://example.com/video

Parameters explained

• -N, --concurrent-fragments: Number of parallel connections
• --retries: Retry failed downloads automatically

---

Scenario 10: Debug Errors and Failures

Use case

A download fails and you need detailed logs to diagnose the problem.

Command

yt-dlp -v https://example.com/video

Parameters explained

• -v, --verbose: Enables detailed debug output

---

This scenario-based approach covers the most important parameters from yt-dlp --help and helps users quickly understand how to use them in real situations.