YouTube Video Downloader (Local)

A simple local tool to download YouTube videos using yt-dlp.

Setup

# Create a virtual environment
python3 -m venv venv
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

Note: ffmpeg is required for merging video+audio streams and audio extraction. Install it via brew install ffmpeg on macOS.

Usage

# Download best quality video
python download.py "https://www.youtube.com/watch?v=VIDEO_ID"

# Download at a specific resolution (e.g. 720p)
python download.py "https://www.youtube.com/watch?v=VIDEO_ID" --resolution 720

# Download audio only (MP3)
python download.py "https://www.youtube.com/watch?v=VIDEO_ID" --audio-only

# Save to a custom directory
python download.py "https://www.youtube.com/watch?v=VIDEO_ID" --output ~/Movies

# Just show video info (no download)
python download.py "https://www.youtube.com/watch?v=VIDEO_ID" --info

Downloaded files are saved to the ./downloads/ folder by default.