💚 YoutubeGO 5.0 🎥

Modern Downloader with Advanced Features

📋 Table of Contents

• Features
• Installation
• Usage
• ScreenShots
• Contributing
• License
• Project Structure

🛠️ 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).

• 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.

• 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.

• 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.7+ 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

Tips & Tricks

• Use drag & drop for quick URL addition
• Enable system tray for background operation
• Use the scheduler for off-peak downloads
• 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.

---

_{Built with ❤️ by Efeckc17}