Video Downloader - Download Videos with yt-dlp

When to Use

• User asks to download a video
• User asks to download or extract audio
• User asks to download subtitles
• User provides a video URL (YouTube, Bilibili, Twitter, etc.)
• User wants to specify video quality (720p, 1080p, etc.)

Prerequisites - Auto Install

Step 0: Check and Install Dependencies

# Check if yt-dlp is installed, install if missing
if ! command -v yt-dlp &>/dev/null; then
  echo "Installing yt-dlp..."
  brew install yt-dlp
fi

# Check if ffmpeg is installed, install if missing
if ! command -v ffmpeg &>/dev/null; then
  echo "Installing ffmpeg..."
  brew install ffmpeg
fi

# Verify installation
yt-dlp --version && echo "yt-dlp: ready"
ffmpeg -version 2>&1 | head -1 && echo "ffmpeg: ready"

Instructions for Agent

Step 1: Ensure Dependencies Installed

brew install yt-dlp ffmpeg

Step 2: Parse User Intent

Step 3: Build Command

yt-dlp [OPTIONS] "URL"

1. Basic video download (best quality):

yt-dlp -o "%(title)s.%(ext)s" "URL"

1. Audio only (MP3):

yt-dlp -x --audio-format mp3 -o "%(title)s.%(ext)s" "URL"

1. Specific quality (e.g., 720p):

yt-dlp -f "bestvideo[height<=720]+bestaudio/best[height<=720]" -o "%(title)s.%(ext)s" "URL"

1. Video with embedded subtitles:

yt-dlp --write-subs --sub-lang en,zh-Hans,zh-Hant --embed-subs -o "%(title)s.%(ext)s" "URL"

1. Subtitles only (no video):

yt-dlp --write-subs --write-auto-subs --sub-lang en,zh-Hans,zh-Hant --skip-download -o "%(title)s" "URL"

Step 4: Execute and Report

• File name and location
• File size (if available)
• Any warnings or errors

Command Reference

yt-dlp "URL"

yt-dlp -x --audio-format mp3 "URL"

yt-dlp -x --audio-format m4a "URL"

yt-dlp -f "bv[height<=720]+ba/b[height<=720]" "URL"

yt-dlp -f "bv[height<=1080]+ba/b[height<=1080]" "URL"

yt-dlp -f "bv[height<=2160]+ba/b[height<=2160]" "URL"

yt-dlp --write-subs --embed-subs "URL"

yt-dlp --write-subs --write-auto-subs --skip-download "URL"

yt-dlp -F "URL"

yt-dlp -o "%(playlist_index)s-%(title)s.%(ext)s" "PLAYLIST_URL"

Response Guidelines

• Always confirm what will be downloaded before starting
• Show download progress or final result
• Report the output file name and location
• If download fails, explain the error and suggest solutions

Error Handling

yt-dlp: command not found

brew install yt-dlp

ffmpeg not found

brew install ffmpeg

Video unavailable

Private video

Format not available

yt-dlp -F URL

No subtitles found

--write-auto-subs

brew: command not found

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"