🎬 CyberDL

⚡ A Modern GUI with Cyberpunk Aesthetics ⚡

Video Downloader powered by yt-dlp

 ▄████████████▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀████████████
 ▓ ◁ CyberDL // Next-Gen Video Downloader // 009688 ▓ ◀
 ▀████████████▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄████████████

🇺🇸 English | 🇨🇳 简体中文

---

✨ Overview

CyberDL — Where cutting-edge technology meets sleek design.

CyberDL is a state-of-the-art desktop video downloader built on top of yt-dlp, engineered for stability, control, and privacy.

Designed to deliver:

• 🔒 Maximum Reliability — Local-first architecture, zero cloud dependencies
• ⚙️ Fine-Grained Control — Advanced download customization and batch processing
• 🎯 Professional UX — Desktop-native experience with cyberpunk aesthetics

Perfect for power users, content creators, and automation enthusiasts who demand more from their tools.

---

📸 Gallery

🚀 Batch Download Mode

💾 Single Download Mode

📜 History Records

---

🎯 Core Features

🌍 Universal Compatibility

• Multi-Platform Support — YouTube, TikTok, Bilibili, and 1000+ websites via yt-dlp
• Seamless integration with any yt-dlp compatible source

🔐 Smart Cookie Management

• Automatic Browser Extraction — Intelligent cookie detection from Chrome, Firefox, Edge
• Manual Import — Full control with custom cookie files
• Session Preservation — Access member-only and restricted content

🎬 Resolution Arsenal

┌─────────────────────────────────┐
│  ▸ Best Quality (Auto-Select)   │
│  ▸ Full HD (1080p)              │
│  ▸ HD (720p)                    │
│  ▸ High Definition (480p)       │
│  ▸ Standard (360p)              │
└─────────────────────────────────┘

⚡ Batch Power Processing

• Queue multiple URLs simultaneously
• Parallel download execution
• Real-time task management

📊 Real-Time Intelligence

• Live progress tracking dashboard
• Advanced status indicators
• Detailed logging and analytics

📚 Smart History

• Automatic download record keeping
• Quick re-download access
• Searchable history database

🌐 Multi-Language Support

• 🇺🇸 English / 🇨🇳 简体中文
• One-click language switching

---

📁 Project Architecture

CyberDL/
├── main.py                   ⚡ Main application kernel
├── downloadWorker.py         🔧 Download engine & task handler
├── historyManager.py         📚 History persistence layer
├── logSyntaxHighlighter.py   🎨 Advanced log formatting
├── translate_data.py         🌐 i18n translation module
├── style.qss                 🎭 Main UI stylesheet
├── history.qss               🎭 History panel stylesheet
├── icon.ico                  🖼️ Application icon
├── cookies/                  🔐 Cookie storage vault
├── requirements.txt          📦 Dependency manifest
└── README.md                 📖 Project documentation

---

🚀 Quick Start Guide

📋 System Requirements

• Python 3.11+ — Modern Python runtime
• Windows 10/11 — Optimized for Windows (Linux/macOS support available)
• Storage — Minimum 100MB free disk space
• RAM — 2GB+ recommended

💻 Installation Steps

# 1️⃣ Clone the repository
git clone https://github.com/cgrjfk/CyberDL.git
cd CyberDL

# 2️⃣ Create isolated Python environment (recommended)
conda create -n CyberDL python=3.11
conda activate CyberDL

# 3️⃣ Install dependencies
pip install -r requirements.txt

# 4️⃣ Launch the application
python main.py

📦 Build Standalone Executable

# Create a professional standalone .exe
pyinstaller --onefile --windowed --clean --icon=icon.ico --name CyberDL main.py
# Output: dist/CyberDL.exe

---

🍪 Cookie Configuration Guide

Method 1: Browser Extension ⭐ Recommended

1. Login to your target website in your preferred browser
2. Install a cookie export extension:
   • Chrome/Edge: Get cookies.txt
   • Firefox: cookies.txt
3. Export cookies as cookies.txt file
4. Import into CyberDL via the application interface

✅ Advantages: Maximum compatibility, highest success rate, most stable

Method 2: Automatic Extraction 🔄

• One-click automatic browser cookie detection
• Requires Administrator privileges
• Browser version dependent — may require fallback
• Automatic graceful degradation to cookie-less mode on failure

⚠️ Important Notes

• Manual cookie import is strongly recommended for reliable access
• Administrator mode enables automatic extraction but isn't required for manual import
• Cookies never leave your machine — 100% local processing

---

📖 Usage Examples

Download Single Video

1. Paste URL into input field
2. Select desired resolution
3. Click "Download"
4. Monitor real-time progress

Batch Processing

1. Load multiple URLs (one per line)
2. Configure resolution preferences
3. Enable parallel downloads
4. Let CyberDL handle the rest

Access Restricted Content

1. Export cookies using browser extension
2. Import cookies into CyberDL
3. Download member-only content
4. Enjoy seamless access

---

⚖️ Legal & Ethical Disclaimer

⚠️  IMPORTANT - PLEASE READ  ⚠️

This project is provided for EDUCATIONAL AND PERSONAL USE ONLY.

❌ The author does NOT endorse downloading copyrighted content without proper authorization.

✅ Users are SOLELY RESPONSIBLE for:
   • Compliance with local laws and regulations
   • Respecting platform terms of service
   • Legitimate and lawful use of this tool

⚖️  The author assumes NO LIABILITY for:
   • Misuse of this software
   • Data loss or corruption
   • Legal consequences
   • Unauthorized distribution of copyrighted material

By using CyberDL, you acknowledge and accept these terms.

---

🤝 Contributing

Contributions are welcome! Feel free to:

• 🐛 Report bugs and issues
• 💡 Suggest new features
• 🔧 Submit pull requests
• 📝 Improve documentation

---

📄 License

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

---

Made with ❤️ for the developer community

CyberDL — Download smarter, not harder.