---

name: video-downloader description: Use when "downloading videos", "saving YouTube videos", "converting to MP3", "video quality", or asking about "yt-dlp", "video formats", "audio extraction" version: 1.0.0

Video Downloader Guide

Download videos with customizable quality and format options using yt-dlp.

When to Use

• Downloading videos from YouTube and other sites
• Saving videos for offline viewing
• Extracting audio as MP3
• Choosing specific quality settings
• Converting between video formats

Quick Start

Copy# Basic download (best quality)
yt-dlp "https://www.youtube.com/watch?v=VIDEO_ID"

# Specify quality
yt-dlp -f "bestvideo[height<=1080]+bestaudio" "URL"

# Audio only as MP3
yt-dlp -x --audio-format mp3 "URL"

Quality Options

Format Options

Audio Extraction

Copy# Extract as MP3
yt-dlp -x --audio-format mp3 "URL"

# Extract as M4A (better quality)
yt-dlp -x --audio-format m4a "URL"

# Best audio quality
yt-dlp -x --audio-quality 0 "URL"

Custom Output

Copy# Custom output directory
yt-dlp -o "/path/to/dir/%(title)s.%(ext)s" "URL"

# Custom filename template
yt-dlp -o "%(upload_date)s-%(title)s.%(ext)s" "URL"

Playlist Handling

Copy# Download entire playlist
yt-dlp "PLAYLIST_URL"

# Skip playlists (single video only)
yt-dlp --no-playlist "URL"

# Download specific items from playlist
yt-dlp --playlist-items 1-5 "PLAYLIST_URL"

Installation

Copy# macOS
brew install yt-dlp

# pip
pip install yt-dlp

# Update
yt-dlp -U

Common Examples

Copy# 1080p MP4 to specific folder
yt-dlp -f "bestvideo[height<=1080]+bestaudio" \
       --merge-output-format mp4 \
       -o "~/Videos/%(title)s.%(ext)s" "URL"

# Audio only as high-quality MP3
yt-dlp -x --audio-format mp3 --audio-quality 0 "URL"

# Download with subtitles
yt-dlp --write-subs --sub-lang en "URL"

# List available formats
yt-dlp -F "URL"

Important Notes

• Video filename generated from video title
• Higher quality = larger file size
• Some sites may have restrictions
• Keep yt-dlp updated for best compatibility