🎥 YTSage

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

Installation • Features • Usage • Screenshots • Contributing

---

✨ 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
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