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
| 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 | 🖼️ Save thumbnail |
pip install YTSage# Run the application
ytsage📦 Other Installation Methods
- 🪟 Windows:
YTSage.exe - 🍎 macOS:
YTSage.dmg - 🐧 Linux:
YTSage.AppImage
# 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| Main Interface | Playlist Download |
| Audio Format Selection with Save Thumbnail | Subtitle Options merged with Remove Sponsor Segments |
🎯 Basic Usage
- Launch YTSage
- Paste YouTube URL (or use "Paste URL" button)
- Click "Analyze"
- Select Format:
Videofor video downloadsAudio Onlyfor audio extraction
- Choose Options:
- Enable subtitles & select language
- Enable subtitle embedding
- Save thumbnail
- Remove sponsor segments
- Select Output Directory
- Click "Download"
📋 Playlist Download
- Paste Playlist URL
- Click "Analyze"
- Select Best Quality
- 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
Python 3.7+
PySide6
yt-dlp
Pillow
requests
FFmpeg
packaging
We welcome contributions! Here's how you can help:
- 🍴 Fork the repository
- 🌿 Create your feature branch:
git checkout -b feature/AmazingFeature
- 💾 Commit your changes:
git commit -m 'Add some AmazingFeature' - 📤 Push to the branch:
git push origin feature/AmazingFeature
- 🔄 Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
| Technology | Purpose |
|---|---|
| yt-dlp | Download Engine |
| PySide6 | GUI Framework |
| FFmpeg | Media Processing |
| Pillow | Image Processing |
This tool is for personal use only. Please respect YouTube's terms of service and content creators' rights.
Made with ❤️ by oop7