dracula-dl 1.0.0

🧛 The Dracula — A powerful YouTube downloader CLI + TUI powered by yt-dlp

🧛 The Dracula — YouTube Downloader CLI

  ██████╗ ██████╗  █████╗  ██████╗██╗   ██╗██╗      █████╗ 
  ██╔══██╗██╔══██╗██╔══██╗██╔════╝██║   ██║██║     ██╔══██╗
  ██║  ██║██████╔╝███████║██║     ██║   ██║██║     ███████║
  ██║  ██║██╔══██╗██╔══██║██║     ██║   ██║██║     ██╔══██║
  ██████╔╝██║  ██║██║  ██║╚██████╗╚██████╔╝███████╗██║  ██║
  ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝ ╚═════╝ ╚══════╝╚═╝  ╚═╝
  ╔══════════════════════════════════════════════════════════╗
  ║   🧛 The Dracula  ·  YouTube Downloader CLI  v1.0.0    ║
  ║      Powered by yt-dlp  ·  Rising from the dark...     ║
  ╚══════════════════════════════════════════════════════════╝

A powerful, dark-themed YouTube Downloader CLI built with Python and yt-dlp.
Download videos, audio, and full playlists — all from the terminal.

---

✨ Features

Feature	Description
🎬 Video Download	Download any YouTube video with quality selector
🎵 Audio Only	Extract audio as MP3, M4A, WAV, FLAC, OPUS
📋 Playlist	Download entire playlists (video or audio)
📊 Format Lister	View all available formats/qualities for a URL
🎨 Rich TUI	Coloured progress bars, ASCII art header
🖥️ Interactive	Menu-driven interactive mode (no args needed)

---

📦 Installation

1. Install Python dependencies

pip install -r requirements.txt

2. Install FFmpeg (required for merging video+audio and audio extraction)

Windows (via winget):

winget install --id=Gyan.FFmpeg -e

Windows (via Chocolatey):

choco install ffmpeg

macOS:

brew install ffmpeg

Linux (Ubuntu/Debian):

sudo apt install ffmpeg

---

🚀 Usage

Interactive Mode (recommended for beginners)

Just run without any arguments:

python dracula.py

You'll get a full menu to choose from.

---

Command Line Mode

Download a Video

# Best quality (default)
python dracula.py video -u "https://youtube.com/watch?v=..."

# Specific quality
python dracula.py video -u "https://youtube.com/watch?v=..." -q 1080p
python dracula.py video -u "https://youtube.com/watch?v=..." -q 720p
python dracula.py video -u "https://youtube.com/watch?v=..." -q 4k

# Specific format ID (from formats command)
python dracula.py video -u "https://youtube.com/watch?v=..." -f 137

# Custom output directory
python dracula.py video -u "https://youtube.com/watch?v=..." -q 1080p -o "C:\Videos"

Quality Options: best | 4k | 1440p | 1080p | 720p | 480p | 360p | worst

---

Download Audio Only

# Default: MP3 at 192kbps
python dracula.py audio -u "https://youtube.com/watch?v=..."

# High quality MP3
python dracula.py audio -u "https://youtube.com/watch?v=..." -f mp3 -b 320

# FLAC lossless
python dracula.py audio -u "https://youtube.com/watch?v=..." -f flac

# M4A format
python dracula.py audio -u "https://youtube.com/watch?v=..." -f m4a -b 256

Format Options: mp3 | m4a | wav | flac | opus | aac
Bitrate Options: 128 | 192 | 256 | 320

---

Download a Playlist

# Full playlist at 720p
python dracula.py playlist -u "https://youtube.com/playlist?list=..."

# Full playlist at 1080p
python dracula.py playlist -u "https://youtube.com/playlist?list=..." -q 1080p

# Playlist as audio only (MP3)
python dracula.py playlist -u "https://youtube.com/playlist?list=..." --audio-only

# Playlist as FLAC audio
python dracula.py playlist -u "https://youtube.com/playlist?list=..." --audio-only -f flac

# Download items 5 through 10 only
python dracula.py playlist -u "https://youtube.com/playlist?list=..." --start 5 --end 10

---

List Available Formats

python dracula.py formats -u "https://youtube.com/watch?v=..."

This shows a full table of all format IDs, resolutions, codecs, and file sizes.

---

📁 Output Location

By default, files are saved to:

~/Downloads/Dracula/

Playlists are saved in a subfolder named after the playlist:

~/Downloads/Dracula/<Playlist Title>/01 - Video Title.mp4
~/Downloads/Dracula/<Playlist Title>/02 - Video Title.mp4

Use -o <path> to change the output directory for any command.

---

🧛 The Dracula Commands Summary

python dracula.py                        → Interactive menu
python dracula.py video   -u URL         → Download video
python dracula.py audio   -u URL         → Download audio only
python dracula.py playlist -u URL        → Download playlist
python dracula.py formats  -u URL        → List formats

---

⚙️ Full Option Reference

video command

Flag	Short	Default	Description
--url	-u	required	YouTube video URL
--quality	-q	best	Quality: best/4k/1440p/1080p/720p/480p/360p/worst
--format-id	-f	—	Specific yt-dlp format ID
--output	-o	~/Downloads/Dracula	Output directory

audio command

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
--output	-o	~/Downloads/Dracula	Output directory

playlist command

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)
--start	—	—	Start at item number
--end	—	—	End at item number
--output	-o	~/Downloads/Dracula	Output directory

---

🔧 Requirements

• Python 3.10+
• yt-dlp
• colorama
• FFmpeg (required for audio extraction and video merging)

---

📜 License

MIT — Free to use, modify, and distribute.

---

🧛 The Dracula rises on PyPI — and the world shall download in darkness.

---

Made with ❤️ by Ajaymyth
📧 [e-mail]