oop7 / YTSage

**Modern YouTube downloader with a clean PySide6 interface.** 
Download videos in any quality, extract audio, fetch subtitles, and more.
### 🌍 README Languages
English: EN
| Arabic: AR
| German: DE
| Spanish: ES
| French: FR
| Hindi: HI
| Indonesian: ID
| Italian: IT
| Japanese: JA
| Korean: KO
| Polish: PL
| Portuguese: PT
| Russian: RU
| Turkish: TR
| Chinese: ZH
| Persian: FA
 Installation •
 Features •
 Usage •
 Screenshots •
 Troubleshooting •
 Telegram •
 Sponsor •
 Contributing 
---
## ❓ Why YTSage?
YTSage is designed for users who want a **simple yet powerful YouTube downloader**. Unlike other tools, it offers:
- A modern and clean PySide6 interface
- One-click downloads for video, audio, and subtitles
- Advanced features like SponsorBlock, subtitle merging, and playlist selection
- Optional Generic Mode for sites supported by yt-dlp beyond YouTube
- Cross-platform support and easy installation
## ✨ Features
| Core Features | Advanced Features | Extra Features |
|-----------------------------------|-----------------------------------------|------------------------------------|
| 🎥 Format Table | 🚫 SponsorBlock Integration | 🎞️ FPS/HDR Display |
| 🎵 Audio Extraction | 📝 Subtitle Selection & Merging | 🔄 Auto Update yt-dlp |
| ✨ Simple UI | 💾 Save Description & Thumbnail | 🛠️ FFmpeg/yt-dlp/Deno Detection |
| 📋 Playlist Support & Selector | 🚀 Speed Limiter | ⚙️ Custom Commands |
| 📑 Chapter Integration | ✂️ Video Section Trimming | 🍪 Login with Cookies |
| 📜 Download History | 🔄 Version Channel Selection | 🌐 Proxy Support |
| 🎚️ Audio Format Conversion | 🎬 Video Format Settings | 🆙 Built-in Updater Tab |
| 🌍 Generic Mode | 🔊 Audio Normalization (EBU R128) | 🌍 Localized in 16 Languages |
| 💾 Playlist Export | ⚙️ Default Quality & Subtitles | |
## 🚀 Installation
### 📦 Download the App (Easiest Method)
*If you just want to use YTSage and don't know what Python is, start here*
Simply download the pre-built installer for your operating system:
#### 🪟 Windows
| Format | Description |
|--------|-------------|
| | **Standard Installer (Recommended)** - Just double-click to install. |
| | With FFmpeg Included (Use this if you don't already have FFmpeg). |
| | Portable version, no installation needed. |
| | Portable with FFmpeg, zipped. |
 🛠️ Installation Steps 
1. **EXE Installer (`.exe`)**: Double-click the file and follow the setup wizard.
2. **Portable Version (`.zip`)**: Extract the archive to your desired location and launch `ytsage.exe`.
3. **FFmpeg Included**: Choose versions with FFmpeg included if you don't have FFmpeg installed on your system.
#### 🍎 macOS
> ⚠️ **Note:** These installers are natively built for **Apple Silicon (M1/M2/M3/M4)**. If you are using an older Intel Mac, please use the Python installation method below.
| Format | Description |
|--------|-------------|
| | **Disk Image Installer (Recommended)** - Open and drag to Applications. |
| | Zipped Application for Apple Silicon. |
 🛠️ Installation Steps 
- **DMG Installer (`.d