YouTube Video Downloader

Quick Start

python scripts/download_video.py "https://www.youtube.com/watch?v=VIDEO_ID"

/mnt/user-data/outputs/

Options

Quality Settings

-q

--quality

• best

  (default): Highest quality available

• 1080p

  : Full HD

• 720p

  : HD

• 480p

  : Standard definition

• 360p

  : Lower quality

• worst

  : Lowest quality available

python scripts/download_video.py "URL" -q 720p

Format Options

-f

--format

• mp4

  (default): Most compatible

• webm

  : Modern format

• mkv

  : Matroska container

python scripts/download_video.py "URL" -f webm

Audio Only

-a

--audio-only

python scripts/download_video.py "URL" -a

Custom Output Directory

-o

--output

python scripts/download_video.py "URL" -o /path/to/directory

Complete Examples

1. Download video in 1080p as MP4:

python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -q 1080p

1. Download audio only as MP3:

python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -a

1. Download in 720p as WebM to custom directory:

python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -q 720p -f webm -o /custom/path

How It Works

yt-dlp

• Automatically installs itself if not present
• Fetches video information before downloading
• Selects the best available streams matching your criteria
• Merges video and audio streams when needed
• Supports a wide range of YouTube video formats

Important Notes

• Downloads are saved to

  /mnt/user-data/outputs/

  by default
• Video filename is automatically generated from the video title
• The script handles installation of yt-dlp automatically
• Only single videos are downloaded (playlists are skipped by default)
• Higher quality videos may take longer to download and use more disk space