# YTSage

A modern YouTube downloader with a clean PySide6 interface. Download videos in any quality, extract audio, fetch subtitles (including auto-generated), and view video metadata. Built with yt-dlp for reliable performance.

## Screenshots

### Main Interface

![Main Interface](https://github.com/user-attachments/assets/08bdb68b-2fbc-47d2-a956-fc23723476e6)

*Main interface with video metadata and thumbnail preview*

### Playlist download support with auto-detection

![Playlist download](https://github.com/user-attachments/assets/537b8553-9657-42b2-a452-051c4cb2e32a)

*Playlist download with auto-detection*
### Audio Format Selection

![Audio Format](https://github.com/user-attachments/assets/51a6a613-6c97-4581-b728-38c91c0b2d24)

*Smart format selection with quality options*

### Subtitle Options

![Subtitle Options](https://github.com/user-attachments/assets/4e8c686f-98e2-435a-add8-758e317b56fe)

*Support for both manual and auto-generated subtitles*

## Features

- 🎥 Smart video quality selection with automatic audio merging
- 🎵 Audio-only extraction
- 📝 Manual and auto-generated subtitle support with language filtering
- ℹ️ Video metadata display (views, upload date, duration)
- 🖼️ Thumbnail preview
- 🎨 Clean, modern PySide6 interface
- 🚀 Built on yt-dlp for robust downloading
- ⏯️ Download control (pause, resume, and cancel)
- 📊 Real-time progress tracking (speed, ETA, percentage)
- 📝 Built-in yt-dlp log viewer
- ⚙️ Custom yt-dlp command support with real-time output
- 📋 Playlist download support with auto-detection
- 💾 Save download path memory
- 🔄 One-click yt-dlp updater
- ⚠️ User-friendly error messages
- 🛠️ FFmpeg installation checker and guide
- 📎 Quick URL paste button
- 🎯 Smart format filtering (Video/Audio)

## Download

You can download the latest executable from the [Releases](https://github.com/oop7/YTSage/releases) page.

### Pre-built Executables
- Windows: `YTSage.exe`
- macOS: `YTSage.app`
- Linux: `YTSage.AppImage`
- No installation required - just download and run!

### PyPI Package
You can also install YTSage directly from PyPI:
```bash
pip install YTSage
```


### Installation

1. Clone the repository:
```bash
git clone https://github.com/oop7/YTSage.git

cd YTSage
```
2. Install the required dependencies:
```bash
pip install -r requirements.txt
```
3. Run the application:
```bash
python YTSage.py
```

# Usage

1. **Run the application**  
2. **Paste a YouTube URL** into the input field  
3. **Click "Analyze"** to load video information  
4. **Select your desired format**:  
   - Choose **"Video"** for video downloads (will automatically merge with best audio)  
   - Choose **"Audio Only"** for audio extraction  
5. **Enable subtitle download** if needed  
6. **Select the output directory**  
7. **Click "Download"** to start  

---

### Additional Steps for Playlist Download:

1. **Paste the Playlist URL**: Instead of a single video URL, paste the URL of the entire YouTube playlist into the input field.  
2. **Analyze the Playlist**: Click "Analyze" to load information for all videos in the playlist.  
3. **Select Best Quality**: Ensure that the best quality option is selected for both video and audio.  
4. **Download the Playlist**: Click "Download" to start downloading all videos in the playlist. The application should automatically handle the download queue.  

---

### Note:  
- **Best Quality**: Always select the highest available resolution (e.g., 1080p, 4K) for video and the best audio format (e.g., 320kbps) for the best experience.  
- **Subtitle Download**: If you need subtitles, enable this option before starting the download.  
- **Output Directory**: Choose a directory with enough storage space, especially for large playlists.  

By following these steps, you can efficiently download entire playlists in the best quality without encountering issues.  

## Requirements

- Python 3.7+
- PySide6
- yt-dlp
- Pillow
- requests
- ffmpeg
- packaging

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the branch (`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

- [yt-dlp](https://github.com/yt-dlp/yt-dlp) for the powerful downloading engine
- [PySide6]([text](https://en.wikipedia.org/wiki/PySide)) for the GUI framework
- [FFmpeg](https://ffmpeg.org/) for the audio and video processing
- [Pillow](https://pypi.org/project/Pillow/) for the image processing
- [requests](https://pypi.org/project/requests/) for the HTTP requests
- [packaging](https://pypi.org/project/packaging/) for the package management
- [PyInstaller](https://pypi.org/project/PyInstaller/) for the executable creation

## Disclaimer

This tool is for personal use only. Please respect YouTube's terms of service and content creators' rights.