YoutubeGO 5.0

<div align="center"> <img src="assets/banner.png" alt="YoutubeGO Logo" width="650"/>

Modern Downloader with Advanced Features

</div>

📋 Table of Contents

• Features
• Installation
• Usage
• Screenshots
• Contributing
• License

🛠️ Tech Stack

📊 Project Stats

📜 Legal

📜 Qt/PySide6 License

Please see QtLicense.md for full LGPL-3.0 compliance information regarding PySide6 (Qt).

🌐 Links

🌐 Languages

| 🇷🇺 Русский

🌟 Key Features

🛠️ Core Features

• Download Support
  Download videos and audio from platforms supporting HTTP streams, including YouTube, Vimeo, and more.

• Smart Playlist Organization
  Automatically organizes playlist downloads into dedicated folders named after the playlist.

• Playlist Downloads
  Save entire playlists with sequential processing in just a few clicks.

• Multiple Formats
  Download in MP4 (video) and multiple audio formats (MP3, M4A, WAV, AAC, FLAC, OPUS, VORBIS) with advanced quality control.

• Advanced Audio Quality Control 🎵
  Revolutionary audio processing system with lossless extraction capabilities:

  • Smart Copy Mode: Zero quality loss for M4A/AAC/OPUS formats
  • User-Controlled Bitrates: 128k, 192k, 256k, 320k, or "best" quality
  • Preserve Original Quality: Avoids unnecessary re-encoding
  • High-Fidelity Fallback: 320k bitrate + 48kHz sampling (vs old 192k + 44.1kHz)
  • Format-Specific Optimization: Automatic best quality selection per format

• High-Resolution Support
  Supports downloads up to 8K, 4K, 2K, 1080p, 720p, 360p. Select your preferred resolution in Settings.

• Modular Codebase
  Code has been fully refactored into core/, ui/, and tests/ directories for easier maintenance and contribution.

🛠️ Advanced Features

• Batch Processing
  Queue multiple downloads and manage them simultaneously. Pause, resume, or cancel downloads easily.

• Audio Quality Revolution 🎵
  Breakthrough audio processing with 67% bitrate improvement and zero-loss extraction:

  • Configure audio bitrate (128k to 320k) and quality preservation
  • Smart copy mode prevents re-encoding when possible
  • Fixes spectogram frequency loss reported in earlier versions
  • Comprehensive settings with helpful tooltips for all audio options

• Profile Management
  Save your preferred settings including username, profile picture, download paths, video resolutions and audio formats.

• Profile Import/Export
  Easily export your profile, settings, history, and profile picture as a single ZIP file, and import them back into the app on any device. Great for backup, migration, or restoring your preferences.

• Drag & Drop Interface
  Add download URLs by dragging them into the app.

• System Tray Integration
  Application runs in the system tray when minimized with quick access menu to restore or quit the app.

• Enhanced Download System
  Improved stability and efficiency with better support for large file downloads and multiple simultaneous downloads.

• Queue System Optimization
  Concurrency management with pause & resume all functionality and bandwidth limiting support via proxy settings.

• Geographic Bypass 🌍
  Advanced geo-restriction bypass with 10 country options:

  • United States (US) - Default, maximum content access
  • Russia (RU) - Bypass EU restrictions and access regional content
  • Germany (DE) - European region access
  • United Kingdom (GB) - UK-specific content
  • Japan (JP) - Asian content and region-locked videos
  • France (FR), Canada (CA), Australia (AU), Netherlands (NL), Sweden (SE)
  • User-selectable country preference saved in profile settings
  • Automatic IP simulation for bypassing geographic content blocks

• Auto-Updater
  Automatically checks for updates and installs them.

🎨 User Experience

• Dark & Light Mode
  Switch between Dark and Light themes for better usability.

• Error Handling
  Displays detailed error logs to debug issues.

• Scheduler
  Schedule downloads to start at a specific date and time.

• Download History
  View, search, and manage previous downloads directly in the app.

• Improved Notification System
  Download Complete notifications, Download Failed alerts, and Download Canceled warnings.

• Enhanced UI
  Better UI animations and responsiveness with color-coded log messages and search & filter options in history and queue.

🔧 Technical Features

• FFmpeg Detection
  Automatically detects FFmpeg installation and prompts for setup if missing.

⚙️ Installation

Windows

• Download the latest .exe installer or .zip archive from Releases
• Both packages include all dependencies including FFmpeg
• Run the installer or extract the .zip and run YoutubeGO.exe

macOS

• Download the latest .dmg package from Releases
• Install FFmpeg using Homebrew:

  brew install ffmpeg
  

• Mount the .dmg file and drag YoutubeGO to Applications folder

Linux

• Download the latest .AppImage from Releases
• Install FFmpeg using your package manager:

  # Ubuntu/Debian
  sudo apt install ffmpeg
  
  # Fedora
  sudo dnf install ffmpeg
  
  # Arch Linux
  sudo pacman -S ffmpeg
  

• Make the AppImage executable:

  chmod +x YoutubeGO.AppImage
  

• Run the AppImage

From Source

• Clone the repository
• Ensure Python 3.13+ is installed
• Install dependencies
• Install FFmpeg for audio/video processing

🔧 Usage

Basic Usage

# Launch the app
python main.py

Key Features Usage

• Configure your profile in the Settings or Profile page
• Use the MP4 or MP3 pages to download videos or extract audio
• Add multiple downloads to the queue and manage them from the Queue page
• Schedule downloads in advance using the Scheduler
• Geographic Bypass: Go to Settings → Geo-Bypass Settings to select your preferred country for bypassing regional content restrictions

Tips & Tricks

• Use drag & drop for quick URL addition
• Enable system tray for background operation
• Use the scheduler for off-peak downloads
• Audio Quality: Set "Preserve Original: Yes" and 320k bitrate for best quality
• Lossless Audio: Use M4A/FLAC formats with copy mode for zero quality loss
• Export your profile for easy migration

⚠️ Notes

Requirements

# FFmpeg Required
# Some features, like audio extraction and video merging, depend on FFmpeg.
# Ensure it's installed and available in your system PATH.

# Third-Party Libraries
# The app uses yt_dlp for downloading and metadata extraction.
# Refer to their GitHub page for details.
https://github.com/yt-dlp/yt-dlp

🙏 Contributions

How to Contribute

# We welcome contributions to improve YoutubeGO 5.0.
# Please submit issues or pull requests via GitHub.

# Enjoy using YoutubeGO 5.0!
🚀

Development Setup

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

⚠️ Legal Notice

YoutubeGO is an independent open-source project. It operates independently from YouTube and Google, performing downloads and other operations without using their APIs. This project is not bound by YouTube's terms of service or rules.

---

<div align="center"> _{Built with ❤️ by <a href="https://github.com/Efeckc17">Efeckc17</a>} </div>