CLI Documentation

CLI Usage.

The Dracula CLI provides direct commands for automated scripts and terminal power-users.

Interactive Mode

Launch without arguments to enter the menu-driven prompt interface:

dracula

Download Videos

Download single videos with resolution, subtitle, thumbnail, and speed limit controls:

# Default 720p download
dracula video -u "https://youtube.com/watch?v=..."

# Specific quality with subtitle embedding & cover art
dracula video -u "URL" -q 1080p --subs en --embed-subs --embed-thumbnail

# 4K download with speed limit & dry-run simulation
dracula video -u "URL" -q 4k --limit-rate 2M --dry-run

Available Video Qualities

best4k1440p1080p720p480p360pworst

Download Audio Only

Extract audio tracks in high quality formats with embedded cover art:

# Default MP3 at 192kbps
dracula audio -u "URL"

# High quality 320kbps MP3 with album art
dracula audio -u "URL" -f mp3 -b 320 --embed-thumbnail

# Lossless FLAC extraction
dracula audio -u "URL" -f flac

Batch Download URLs

Process dozens of URLs sequentially from text files or multiple URL flags:

# Batch video download from text file (urls.txt)
dracula batch -i urls.txt -q 1080p

# Batch download multiple URLs directly via flags
dracula batch -u "https://..." -u "https://..." -q 720p

# Batch audio extraction from file
dracula batch -i urls.txt --audio-only -f mp3 -b 320

History & Shell Completion

Access download history logs and configure shell auto-completion:

# Show 50 recent download records
dracula history -n 50

# Display shell auto-completion setup guide
dracula completion

# Re-attempt failed items from previous playlist run
dracula playlist -u "URL" --retry-failed