AJAYMYTH/dracula-dl

🧛 The Dracula — YouTube Downloader CLI

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

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

---

✨ Features

| Feature | Description | |---|---| | 🎬 Video Download | Download any YouTube video with quality selector (360p to 4K), subtitles, and thumbnails | | 🎵 Audio Only | Extract audio as MP3, M4A, WAV, FLAC, OPUS with configurable bitrates (128-320kbps) | | 📋 Playlist | Download entire playlists with item range selection and failed item retry (--retry-failed) | | 📦 Batch Downloads | Sequential download from text files (urls.txt) or multiple -u flags | | ⚙️ Persistent Config | Custom default directory, quality, and bitrates saved in ~/.config/dracula/config.toml | | 📜 History Logging | Append-only download history log in ~/.config/dracula/history.jsonl | | 📊 Format Lister | View all available formats, resolutions, codecs, and file sizes for a URL | | 🎨 Rich TUI & CLI | Menu-driven TUI, live progress bars, summary tables, red error panels, and shell completion |

---

📦 Installation & Update

1. Install via PyPI (Recommended)

To install the latest version of The Dracula globally from PyPI, run:

pip install dracula-dl

2. Upgrade to the Latest Version

To upgrade an existing installation to the latest version:

pip install --upgrade dracula-dl

3. Install from Source (Local Development)

If you are running or developing from the source repository:

git clone https://github.com/AJAYMYTH/dracula-dl.git
cd dracula-dl
pip install -r requirements.txt

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