# 🎥 YTSage YTSage Interface

[![PyPI version](https://img.shields.io/pypi/v/ytsage?color=dc2626&style=for-the-badge&logo=pypi&logoColor=white)](https://badge.fury.io/py/ytsage) [![License: MIT](https://img.shields.io/badge/License-MIT-374151?style=for-the-badge&logo=opensource&logoColor=white)](https://opensource.org/licenses/MIT) [![Python 3.7+](https://img.shields.io/badge/python-3.7+-1f2937?style=for-the-badge&logo=python&logoColor=white)](https://www.python.org/downloads/) [![Downloads](https://img.shields.io/pypi/dm/ytsage?color=4b5563&style=for-the-badge&logo=download&logoColor=white)](https://pepy.tech/project/ytsage) [![GitHub Stars](https://img.shields.io/github/stars/oop7/YTSage?color=dc2626&style=for-the-badge&logo=github&logoColor=white)](https://github.com/oop7/YTSage/stargazers) **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 | |-----------------------------------|-----------------------------------------|------------------------------------| | 🎥 Format Table | 🚫 SponsorBlock Integration | 💾 Save Download Path | | 🎵 Audio Extraction | 📝 Multi-Subtitle Select & Merge | 🔄 Auto-Update yt-dlp | | ✨ Simple UI | 💾 Save Description | 🛠️ FFmpeg/yt-dlp Detection | | 📋 Playlist Support | 🖼️ Save thumbnail | ⚙️ Custom Commands | | 🖼️ Playlist Selector | 🚀 Speed Limiter | 🍪 Login with Cookies | | | ✂️ Trim Video Sections | |

## 🚀 Installation ### Quick Install (Recommended) ```bash pip install ytsage ``` ```bash # Run the application ytsage ``` ### 📦 Other Installation Methods ### Pre-built Executables - 🪟 Windows: `YTSage.exe` - 🪟 Windows: `YTSage-ffmpeg.exe` (Includes FFmpeg) - 🐧 Linux: `YTSage_{version}_amd64.deb` - 🐧 Linux: `YTSage-x86_64.AppImage` - 🍎 macOS: `YTSage-macOS-app.zip` - 🍎 macOS: `YTSage-{version}.dmg`

🛠️ Manual Installation from Source

```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	Subtitle Options

## 📖 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 merge - Save thumbnail - Remove sponsor segments - Save description 6. **Select Output Directory** 7. **Click "Download"**

📋 Playlist Download

1. **Paste Playlist URL** 2. **Click "Analyze"** 3. **Select videos from the playlist selector (optional, defaults to all)** 4. **Choose desired format/quality** 5. **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 - **Custom Commands:** Access advanced yt-dlp features - **Save Description:** Save the description of the video - **Save Thumbnail:** Save the thumbnail of the video - **Remove Sponsor Segments:** Remove sponsor segments from the video - **Speed Limiter:** Limit the download speed - **Login with Cookies:** Login to YouTube using cookies to access private content How to use it: 1. Extract cookies from your browser using an extension like [cookie-editor](https://github.com/moustachauve/cookie-editor?tab=readme-ov-file) 2. Copy the cookies in Netscape format 3. Create a file named `cookies.txt` and paste the cookies into it 4. Select the `cookies.txt` file in the app - **Save Download Path:** Save the download path - **Update yt-dlp:** Update yt-dlp - **FFmpeg/yt-dlp Detection:** Automatically detect FFmpeg/yt-dlp - **Custom Commands:** Access advanced yt-dlp features - **Trim Video:** Download only specific parts of a video by specifying time ranges (HH:MM:SS format)

🛠️ Troubleshooting

- **Format table not displaying:** Update yt-dlp to the latest version - **Download fails:** Check your internet connection and ensure the video is available - **Audio extraction issues:** Verify FFmpeg is properly installed

## 🧩 Requirements - **Python:** 3.7 or higher - **GUI Framework:** PySide6 - **Download Engine:** yt-dlp - **Media Processing:** FFmpeg - **Additional Libraries:** Pillow, requests, packaging, markdown, pygame ## 👥 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 ## 📊 Star History

[![Star History Chart](https://api.star-history.com/svg?repos=oop7/YTSage&type=Date)](https://star-history.com/#oop7/YTSage&Date)

## 📜 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 | | [requests](https://requests.readthedocs.io/) | HTTP Requests | | [packaging](https://packaging.python.org/) | Packaging | | [markdown](https://python-markdown.github.io/) | Markdown Processing | | [pygame](https://www.pygame.org/) | Audio Playback | | [New Notification 09 by Universfield](https://pixabay.com/sound-effects/new-notification-09-352705/) | Notification Sound |

## ⚠️ 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)