# 🎥 YTSage YTSage Interface

[![PyPI version](https://badge.fury.io/py/YTSage.svg)](https://badge.fury.io/py/YTSage) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Python 3.7+](https://img.shields.io/badge/python-3.7+-blue.svg)](https://www.python.org/downloads/) [![Downloads](https://pepy.tech/badge/ytsage)](https://pepy.tech/project/ytsage) **A modern YouTube downloader with a clean PySide6 interface.** Download videos in any quality, extract audio, fetch subtitles, and more. [Installation](#installation) • [Features](#features) • [Usage](#usage) • [Screenshots](#screenshots) • [Contributing](#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) ```bash pip install YTSage ``` ```bash # Run the application ytsage ```

📦 Other Installation Methods

### Pre-built Executables - 🪟 Windows: `YTSage.exe` - 🍎 macOS: `YTSage.dmg` - 🐧 Linux: `YTSage.AppImage` ### Manual Installation ```bash # 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 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 ```plaintext 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: ```bash git checkout -b feature/AmazingFeature ``` 3. 💾 Commit your changes: ```bash git commit -m 'Add some AmazingFeature' ``` 4. 📤 Push to the branch: ```bash git push origin feature/AmazingFeature ``` 5. 🔄 Open a Pull Request ## 📜 License This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details. ## 🙏 Acknowledgments

| Technology | Purpose | |------------|---------| | [yt-dlp](https://github.com/yt-dlp/yt-dlp) | Download Engine | | [PySide6](https://wiki.qt.io/Qt_for_Python) | GUI Framework | | [FFmpeg](https://ffmpeg.org/) | Media Processing | | [Pillow](https://python-pillow.org/) | 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](https://github.com/oop7)