AgentSkillsCN

yt-dlp

使用 yt-dlp 从 YouTube 及其他平台下载视频。适用于下载视频、提取元数据，或批量下载多个文件的场景。

SKILL.md
--- frontmatter
name: yt-dlp
description: Download videos from YouTube and other sites using yt-dlp. Use when downloading videos, extracting metadata, or batch downloading multiple files.

yt-dlp Cheatsheet

Command-line tool for downloading videos from YouTube and other sites.

Quick Start

bash
# Download video
yt-dlp https://url

# Download with specific format
yt-dlp -f best https://url

# Download with output filename
yt-dlp -o "filename.%(ext)s" https://url

Contents

Basic Download

bash
# Download video
yt-dlp https://url

# Download to current directory
yt-dlp https://url

# Download with specific format
yt-dlp -f best https://url

See Basic Download for details.

Format Selection

bash
# Best quality
yt-dlp -f best https://url

# Best audio
yt-dlp -f bestaudio https://url

# Best video
yt-dlp -f bestvideo https://url

# Specific format
yt-dlp -f 137 https://url

# Format list
yt-dlp --list-formats https://url

# Format with preference
yt-dlp -f "bestvideo[ext=mp4]+bestaudio/best" https://url

See Format Selection for details.

Output Options

bash
# Custom output filename
yt-dlp -o "Title.%(ext)s" https://url

# Output template
yt-dlp -o "%(title)s.%(ext)s" https://url

# Keep original filename
yt-dlp --keep-filename https://url

# Skip existing files
yt-dlp --continue https://url

# Limit download rate
yt-dlp --limit 1M https://url

# Retries
yt-dlp --retries 5 https://url

See Output Options for details.

Playlist Handling

bash
# Download single video
yt-dlp https://url

# Download entire playlist
yt-dlp --yes-playlist https://url

# Download only certain videos
yt-dlp --playlist-end 10 https://url

# Download with start number
yt-dlp --playlist-start 5 https://url

# Download all except certain videos
yt-dlp --ignore-errors https://url

See Playlist Handling for details.

Authentication

bash
# Username and password
yt-dlp -u user -p pass https://url

# API key
yt-dlp --cookies cookies.txt https://url

# Netflix username/password
yt-dlp --username user --password pass https://url

See Authentication for details.

Metadata Extraction

bash
# Extract info
yt-dlp --dump-json https://url

# Extract title
yt-dlp --get-title https://url

# Extract duration
yt-dlp --get-duration https://url

# Extract description
yt-dlp --get-description https://url

# Extract uploader
yt-dlp --get-uploader https://url

See Metadata Extraction for details.

Advanced Options

bash
# Download subtitles
yt-dlp --write-sub https://url

# Download all formats
yt-dlp --all-formats https://url

# Download best quality only
yt-dlp --no-playlist https://url

# Skip download, only extract info
yt-dlp --skip-download https://url

# Download to specific directory
yt-dlp -o "downloads/%(title)s.%(ext)s" https://url

# Concurrent downloads
yt-dlp --concurrent-connections 10 https://url

See Advanced Options for details.

Batch Processing

bash
# Download from file
yt-dlp --batch-file urls.txt

# Download all in directory
yt-dlp --download-archive archive.txt https://url

See Batch Processing for details.

Tips

  • •Use -f best for maximum quality
  • •Use -o "filename.%(ext)s" for custom naming
  • •Use --continue to skip already downloaded files
  • •Use --list-formats to see available formats
  • •Use --skip-download to extract metadata without downloading
  • •Use --download-archive to avoid re-downloading

Related Skills

  • •tmux: Run yt-dlp in background with watch mode