Your Name
243 lines
7.6 KiB
Markdown
243 lines
7.6 KiB
Markdown
<div align="center">
|
|
|
|
# 🎥 YTSage
|
|
|
|
<img src="https://github.com/user-attachments/assets/f95f7bfb-8591-4d32-b795-68e61efd670c" width="800" alt="YTSage Interface"/>
|
|
|
|
[](https://badge.fury.io/py/ytsage)
|
|
[](https://opensource.org/licenses/MIT)
|
|
[](https://www.python.org/downloads/)
|
|
[](https://pepy.tech/project/ytsage)
|
|
[](https://pepy.tech/project/ytsage)
|
|
|
|
**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)
|
|
|
|
</div>
|
|
|
|
---
|
|
|
|
## ✨ Features
|
|
|
|
<div align="center">
|
|
|
|
| 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 | |
|
|
|
|
</div>
|
|
|
|
## 🚀 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`
|
|
|
|
<details>
|
|
<summary>🛠️ Manual Installation from Source</summary>
|
|
|
|
```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
|
|
```
|
|
|
|
</details>
|
|
</details>
|
|
|
|
## 📸 Screenshots
|
|
|
|
<div align="center">
|
|
<table>
|
|
<tr>
|
|
<td><img src="https://github.com/user-attachments/assets/f95f7bfb-8591-4d32-b795-68e61efd670c" alt="Main Interface" width="400"/></td>
|
|
<td><img src="https://github.com/user-attachments/assets/f7b3ebab-3054-4c77-8109-c899a8b10047" alt="Playlist Download" width="400"/></td>
|
|
</tr>
|
|
<tr>
|
|
<td align="center"><em>Main Interface</em></td>
|
|
<td align="center"><em>Playlist Download</em></td>
|
|
</tr>
|
|
<tr>
|
|
<td><img src="https://github.com/user-attachments/assets/a80d2ae2-0031-4ed0-bee4-93293634c62a" alt="Audio Format Selection with Save Thumbnail" width="400"/></td>
|
|
<td><img src="https://github.com/user-attachments/assets/5236e3cc-8a8d-4d85-a660-782a740ef9af" alt="Subtitle Options merged with Remove Sponsor Segments" width="400"/></td>
|
|
</tr>
|
|
<tr>
|
|
<td align="center"><em>Audio Format</em></td>
|
|
<td align="center"><em>Subtitle Options</em></td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
|
|
## 📖 Usage
|
|
|
|
<details>
|
|
<summary>🎯 Basic Usage</summary>
|
|
|
|
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"**
|
|
|
|
</details>
|
|
|
|
<details>
|
|
<summary>📋 Playlist Download</summary>
|
|
|
|
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
|
|
|
|
</details>
|
|
|
|
<details>
|
|
<summary>🧰 Advanced Options</summary>
|
|
|
|
- **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)
|
|
|
|
|
|
</details>
|
|
|
|
<details>
|
|
<summary>🛠️ Troubleshooting</summary>
|
|
|
|
- **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
|
|
|
|
</details>
|
|
|
|
## 🧩 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
|
|
|
|
<div align="center">
|
|
|
|
[](https://star-history.com/#oop7/YTSage&Date)
|
|
|
|
</div>
|
|
|
|
## 📜 License
|
|
|
|
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
|
|
|
|
## 🙏 Acknowledgments
|
|
|
|
<div align="center">
|
|
|
|
| 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 |
|
|
|
|
|
|
</div>
|
|
|
|
## ⚠️ Disclaimer
|
|
|
|
This tool is for personal use only. Please respect YouTube's terms of service and content creators' rights.
|
|
|
|
---
|
|
|
|
<div align="center">
|
|
|
|
Made with ❤️ by [oop7](https://github.com/oop7)
|
|
|
|
</div>
|