
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 | 🖼️ Thumbnail Management |
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:
Video
for video downloadsAudio Only
for 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