██████╗ ██╗  ██╗ █████╗ ███╗   ██╗████████╗ ██████╗ ███╗   ███╗
██╔══██╗██║  ██║██╔══██╗████╗  ██║╚══██╔══╝██╔═══██╗████╗ ████║
██████╔╝███████║███████║██╔██╗ ██║   ██║   ██║   ██║██╔████╔██║
██╔═══╝ ██╔══██║██╔══██║██║╚██╗██║   ██║   ██║   ██║██║╚██╔╝██║
██║     ██║  ██║██║  ██║██║ ╚████║   ██║   ╚██████╔╝██║ ╚═╝ ██║
╚═╝     ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═══╝   ╚═╝    ╚═════╝ ╚═╝     ╚═╝

Phantom-DLP is a comprehensive, user-friendly wrapper for yt-dlp that transforms the command-line experience into an intuitive, menu-driven interface. Perfect for both beginners and power users who want maximum control over their media downloads.

• 🎮 Interactive Interface - No more memorizing complex command-line arguments
• 🛡️ Built-in Safety - Robust error handling and automatic quality fallbacks
• ⚡ Optimized Downloads - Smart quality selection and resume capabilities
• 🎨 Beautiful Output - Colorized interface with clear progress indicators
• 🔧 Highly Configurable - Persistent settings and customizable workflows
• 📱 Universal Support - Works with 1000+ video platforms

• Quick Download - One-click optimal quality video + audio
• Audio Extraction - High-quality audio-only downloads (MP3, AAC, OPUS)
• Video Downloads - Quality-specific downloads (4K, 1080p, 720p, 480p)
• Smart Playlists - Full or selective range playlist downloads
• Live Streaming - Real-time stream capture with duration controls

• Built-in Search - Find and download directly from YouTube search
• Batch Processing - Download multiple URLs from file input
• Subtitle Support - Multi-language subtitle download and embedding
• Format Analysis - Preview available qualities before download
• Custom Templates - Flexible file naming and organization
• Proxy Support - Download through proxy servers
• Rate Limiting - Bandwidth control for network management

• Auto-Fallbacks - Retry with alternative qualities on failure
• Path Validation - Intelligent directory handling
• URL Verification - Pre-download accessibility checks
• Download History - Complete logging with timestamps
• Resume Downloads - Continue interrupted transfers
• Configuration Persistence - Save and restore preferences

# Arch Linux
sudo pacman -S yt-dlp ffmpeg bash

# Ubuntu/Debian
sudo apt install yt-dlp ffmpeg bash

# CentOS/RHEL/Fedora
sudo dnf install yt-dlp ffmpeg bash

yt-dlp --version    # Should show version info
ffmpeg -version     # Should show version info
bash --version      # Should be 4.0+

curl -O https://raw.githubusercontent.com/Ishan0121/phantom-dlp/main/phantom-dlp.sh
curl -O https://raw.githubusercontent.com/Ishan0121/phantom-dlp/main/install.sh
chmod +x phantom-dlp.sh install.sh
./install.sh

# Download the script
curl -O https://raw.githubusercontent.com/Ishan0121/phantom-dlp/main/phantom-dlp.sh

# Install system-wide
sudo cp phantom-dlp.sh /usr/local/bin/phantom-dlp
sudo chmod +x /usr/local/bin/phantom-dlp

# Verify
phantom-dlp

# Create user bin directory
mkdir -p ~/.local/bin

# Download and install
curl -o ~/.local/bin/phantom-dlp https://raw.githubusercontent.com/Ishan0121/phantom-dlp/main/phantom-dlp.sh
chmod +x ~/.local/bin/phantom-dlp

# Add to PATH
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

git clone https://github.com/Ishan0121/phantom-dlp.git
cd phantom-dlp
chmod +x phantom-dlp.sh

# Optional: Create system link
sudo ln -sf "$(pwd)/phantom-dlp.sh" /usr/local/bin/phantom-dlp

phantom-dlp

=== PHANTOM-DLP MAIN MENU ===
 1) Quick Download (Video + Audio)
 2) Audio Only Download  
 3) Video Only Download
 4) Playlist Download
 5) Quality Selection
 6) Format Conversion
 7) Subtitle Download
 8) Live Stream Recording
 9) Batch Download (URLs from file)
10) Search and Download
11) Update yt-dlp
12) View Available Formats
13) Configuration Settings
14) Download History
15) Advanced Options
 0) Exit

1. Run phantom-dlp
2. Select 1 (Quick Download)
3. Paste video URL
4. Press Enter and wait

1. Select 2 (Audio Only Download)
2. Choose quality (Best/320k/256k/128k)
3. Enter URL

1. Select 4 (Playlist Download)
2. Choose 1 (Download entire playlist)
3. Enter playlist URL

1. Select 10 (Search and Download)
2. Enter search terms
3. Select from results
4. Download automatically

• Download Path: ~/Downloads
• Video Quality: best
• Video Format: mp4
• Audio Format: mp3

• Settings: ~/.config/phantom-dlp/config
• History: ~/.config/phantom-dlp/history

Access settings via menu option 13:

1. Download Path - Change default location
2. Quality Preferences - Set default quality
3. Format Preferences - Set output formats
4. Reset Defaults - Restore original settings

Create a text file with URLs (one per line):

https://www.youtube.com/watch?v=VIDEO1
https://www.youtube.com/watch?v=VIDEO2
https://www.youtube.com/playlist?list=PLAYLIST

Use menu option 9 and select your file.

Advanced users can specify custom yt-dlp format strings:

# Best MP4 under 1080p
'best[height<=1080][ext=mp4]'

# Best audio under 128kbps
'bestaudio[abr<=128]'

For restricted networks:

# HTTP proxy
http://proxy.example.com:8080

# SOCKS5 proxy  
socks5://proxy.example.com:1080

Phantom-DLP supports all yt-dlp compatible sites (1000+):

Popular Platforms:

• YouTube (videos, playlists, live streams)
• Twitch (videos, clips, live streams)
• Twitter/X (videos, spaces)
• Facebook (videos, live streams)
• Instagram (videos, reels, stories)
• TikTok (videos)
• Vimeo (videos)
• Reddit (videos)
• And many more...

Check Platform Support:

yt-dlp --list-extractors | grep -i "platform_name"

# Check if PATH includes installation directory
echo $PATH

# Reinstall to system location
sudo cp phantom-dlp.sh /usr/local/bin/phantom-dlp
sudo chmod +x /usr/local/bin/phantom-dlp

# Fix download directory permissions
chmod 755 ~/Downloads

# Create directory if missing
mkdir -p ~/Downloads

# Update yt-dlp to latest version
pip install --upgrade yt-dlp
# or
sudo pacman -Syu yt-dlp

# Try different user agent
--user-agent "Mozilla/5.0 (compatible)"

# Use proxy for region restrictions
--proxy "socks5://proxy:1080"

Enable debug output by editing the script:

#!/bin/bash -x  # Add -x for debug mode

• Check the Issues page
• Review yt-dlp documentation
• Join our community discussions

We welcome contributions! Here's how to get started:

# Fork the repository on GitHub
git clone https://github.com/Ishan0121/phantom-dlp.git
cd phantom-dlp

# Create feature branch
git checkout -b feature/awesome-feature

# Make your changes
# Test thoroughly
# Commit and push
git commit -m "Add awesome feature"
git push origin feature/awesome-feature

# Create Pull Request

• Follow existing code style and structure
• Add comments for complex logic
• Test with multiple platforms and URLs
• Ensure error handling for new features
• Update documentation as needed

Include the following in bug reports:

• Operating system and version
• yt-dlp version (yt-dlp --version)
• Complete error message/log
• Steps to reproduce
• Example URLs (if not sensitive)

This project is licensed under the MIT License - see the LICENSE file for details.

• yt-dlp - The powerful download engine
• FFmpeg - Media processing framework
• Community contributors and testers
• Arch Linux community for inspiration