Skip to content
/ YTSage Public

Modern YouTube downloader with a clean PySide6 interface. Download videos in any quality, extract audio, fetch subtitles, sponserBlock, and view video metadata. Built with yt-dlp for reliable performance.

License

Notifications You must be signed in to change notification settings

oop7/YTSage

Repository files navigation

🎥 YTSage

YTSage Interface

PyPI version License: MIT Python 3.7+ Downloads

A modern YouTube downloader with a clean PySide6 interface.
Download videos in any quality, extract audio, fetch subtitles, and more.

InstallationFeaturesUsageScreenshotsContributing


✨ Features

Core Features Advanced Features Extra Features
🎥 Smart Video Quality 🚫 SponsorBlock Integration 💾 Save Download Path
🎵 Audio Extraction 📝 Subtitle Support & Filtering 🔄 Auto-Updates
📊 Real-time Progress ⚙️ Custom Commands 🛠️ FFmpeg Tools
📋 Playlist Support 🖼️ Thumbnail Management ⚠️ Error Handling

🚀 Installation

Quick Install (Recommended)

pip install YTSage
# Run the application
ytsage
📦 Other Installation Methods

Pre-built Executables

  • 🪟 Windows: YTSage.exe
  • 🍎 macOS: YTSage.dmg
  • 🐧 Linux: YTSage.AppImage

Manual Installation

# Clone repository
git clone https://github.com/oop7/YTSage.git

# Navigate to directory
cd YTSage

# Install dependencies
pip install -r requirements.txt

# Run application
python main.py

📸 Screenshots

Main Interface Playlist Download
Main Interface Playlist Download
Audio Format Selection with Save Thumbnail Subtitle Options merged with Remove Sponsor Segments
Audio Format Selection with Save Thumbnail Subtitle Options merged with Remove Sponsor Segments

📖 Usage

🎯 Basic Usage
  1. Launch YTSage
  2. Paste YouTube URL (or use "Paste URL" button)
  3. Click "Analyze"
  4. Select Format:
    • Video for video downloads
    • Audio Only for audio extraction
  5. Choose Options:
    • Enable subtitles & select language
    • Enable subtitle embedding
    • Save thumbnail
    • Remove sponsor segments
  6. Select Output Directory
  7. Click "Download"
📋 Playlist Download
  1. Paste Playlist URL
  2. Click "Analyze"
  3. Select Best Quality
  4. Click "Download"

💡 The application automatically handles the download queue

⚙️ Advanced Options
  • Quality Selection: Choose the highest resolution for best quality
  • Subtitle Options: Filter languages and embed into video
  • SponsorBlock: Automatically skip promotional content
  • Custom Commands: Access advanced yt-dlp features
  • Output Directory: Ensure sufficient storage space

🛠️ Requirements

Python 3.7+
PySide6
yt-dlp
Pillow
requests
FFmpeg
packaging

👥 Contributing

We welcome contributions! Here's how you can help:

  1. 🍴 Fork the repository
  2. 🌿 Create your feature branch:
    git checkout -b feature/AmazingFeature
  3. 💾 Commit your changes:
    git commit -m 'Add some AmazingFeature'
  4. 📤 Push to the branch:
    git push origin feature/AmazingFeature
  5. 🔄 Open a Pull Request

📜 License

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

🙏 Acknowledgments

Technology Purpose
yt-dlp Download Engine
PySide6 GUI Framework
FFmpeg Media Processing
Pillow Image Processing

⚠️ Disclaimer

This tool is for personal use only. Please respect YouTube's terms of service and content creators' rights.


Made with ❤️ by oop7

About

Modern YouTube downloader with a clean PySide6 interface. Download videos in any quality, extract audio, fetch subtitles, sponserBlock, and view video metadata. Built with yt-dlp for reliable performance.

Topics

Resources

License

Stars

Watchers

Forks

Languages