API & CLI Reference

Commands.

Complete specifications for all subcommands, options, and flags in Dracula CLI v1.1.2.

Quick Referencev1.1.2

dracula                                 # Launch interactive TUI
dracula video    -u URL                 # Download single video
dracula audio    -u URL                 # Extract audio track
dracula playlist -u URL                 # Download playlist
dracula batch    -i urls.txt            # Batch download URLs
dracula formats  -u URL                 # List available formats
dracula history  -n 50                  # View download history
dracula completion                      # Shell completion setup

video

Download a YouTube video with quality, subtitle, and thumbnail controls.

$ dracula video -u URL [options]

Flag	Short	Default	Description
--url	-u	required*	YouTube video URL
--quality	-q	720p	Quality: best/4k/1440p/1080p/720p/480p/360p/worst
--format-id	-f	—	Specific yt-dlp format ID
--subs	—	—	Comma-separated subtitle language codes (e.g. en,es)
--auto-subs	—	off	Download auto-generated subtitles
--embed-subs	—	off	Embed subtitles into video container
--embed-thumbnail	—	off	Embed thumbnail image into video file
--output	-o	~/Downloads/Dracula	Output directory
--limit-rate	—	—	Maximum download speed limit (e.g. 500k, 2m)
--dry-run	—	off	Simulate download without saving files

audio

Extract audio tracks in MP3, M4A, FLAC, WAV, OPUS, or AAC formats.

$ dracula audio -u URL [options]

Flag	Short	Default	Description
--url	-u	required*	YouTube video URL
--format	-f	mp3	Audio format: mp3/m4a/wav/flac/opus/aac
--bitrate	-b	192	Bitrate in kbps: 128/192/256/320
--embed-thumbnail	—	off	Embed cover art into audio metadata
--output	-o	~/Downloads/Dracula	Output directory
--limit-rate	—	—	Maximum download speed limit (e.g. 500k, 2m)
--dry-run	—	off	Simulate download without saving files

playlist

Download full YouTube playlists with item range filtering and failed item retries.

$ dracula playlist -u URL [options]

Flag	Short	Default	Description
--url	-u	required*	Playlist URL
--quality	-q	720p	Video quality
--audio-only	—	off	Download audio only
--format	-f	mp3	Audio format (with --audio-only)
--bitrate	-b	192	Audio bitrate kbps (with --audio-only)
--start	—	—	Start at playlist item index number
--end	—	—	End at playlist item index number
--subs	—	—	Comma-separated subtitle language codes
--auto-subs	—	off	Download auto-generated subtitles
--embed-subs	—	off	Embed subtitles into output
--embed-thumbnail	—	off	Embed thumbnail into output files
--retry-failed	—	off	Re-attempt only items that failed previously
--output	-o	~/Downloads/Dracula	Output directory

batch

Download multiple URLs sequentially from a text file or command line arguments.

$ dracula batch -i urls.txt [options] OR dracula batch -u URL1 -u URL2

Flag	Short	Default	Description
--input-file	-i	—	Path to text file containing URLs
--url	-u	—	Target URL (repeat flag for multiple URLs)
--quality	-q	720p	Video quality
--audio-only	—	off	Download audio only
--format	-f	mp3	Audio format
--bitrate	-b	192	Audio bitrate kbps
--subs	—	—	Subtitle language codes
--auto-subs	—	off	Download auto-generated subtitles
--embed-subs	—	off	Embed subtitles
--embed-thumbnail	—	off	Embed thumbnail
--output	-o	~/Downloads/Dracula	Output directory

formats

List all raw video and audio format streams available for a URL.

$ dracula formats -u URL

Flag	Short	Default	Description
--url	-u	required*	YouTube video URL

history

Display recent download history records logged in ~/.config/dracula/history.jsonl.

$ dracula history [-n LIMIT]

Flag	Short	Default	Description
--limit	-n	50	Number of recent history records to display

completion

Output setup instructions for bash/zsh shell auto-completion.

$ dracula completion

No additional options required for this subcommand.