ytsage 4.0.0__tar.gz

ytsage-4.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 oop7
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ytsage-4.0.0/PKG-INFO

@@ -0,0 +1,236 @@
+Metadata-Version: 2.2
+Name: ytsage
+Version: 4.0.0
+Summary: Modern YouTube downloader with a clean PySide6 interface.
+Home-page: https://github.com/oop7/YTSage
+Author: oop7
+Author-email: oop7 <oop7_support@proton.me>
+License: MIT License
+Project-URL: Homepage, https://github.com/oop7/YTSage
+Project-URL: Bug-Tracker, https://github.com/oop7/YTSage/issues
+Project-URL: Reddit, https://www.reddit.com/r/NO-N_A_M_E/
+Keywords: youtube,downloader,video,audio,PySide6,yt-dlp,GUI
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Multimedia :: Video
+Classifier: Topic :: Multimedia :: Sound/Audio
+Classifier: Topic :: Utilities
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Environment :: X11 Applications :: Qt
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: yt-dlp
+Requires-Dist: PySide6
+Requires-Dist: requests
+Requires-Dist: Pillow
+Requires-Dist: packaging
+Dynamic: author
+Dynamic: home-page
+Dynamic: requires-python
+
+<div align="center">
+
+# 🎥 YTSage
+
+<img src="https://github.com/user-attachments/assets/9566f446-458a-4932-8c5a-7aec0e253a3d" width="800" alt="YTSage Interface"/>
+
+[![PyPI version](https://badge.fury.io/py/YTSage.svg)](https://badge.fury.io/py/YTSage)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.7+](https://img.shields.io/badge/python-3.7+-blue.svg)](https://www.python.org/downloads/)
+[![Downloads](https://pepy.tech/badge/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 |
+|--------------|-------------------|----------------|
+| 🎥 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 | ⚠️ Error Handling |
+
+</div>
+
+## 🚀 Installation
+
+### Quick Install (Recommended)
+```bash
+pip install YTSage
+```
+```bash
+# Run the application
+ytsage
+```
+
+<details>
+<summary>📦 Other Installation Methods</summary>
+
+### Pre-built Executables
+- 🪟 Windows: `YTSage.exe`
+- 🍎 macOS: `YTSage.dmg`
+- 🐧 Linux: `YTSage.AppImage`
+
+### Manual Installation
+```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>
+
+## 📸 Screenshots
+
+<div align="center">
+<table>
+  <tr>
+    <td><img src="https://github.com/user-attachments/assets/9566f446-458a-4932-8c5a-7aec0e253a3d" alt="Main Interface" width="400"/></td>
+    <td><img src="https://github.com/user-attachments/assets/99330ae2-f027-4a13-a08e-16c715d7f481" 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/2023c9d6-1b3a-4d75-85a3-f88cc17e8194" alt="Audio Format Selection with Save Thumbnail" width="400"/></td>
+    <td><img src="https://github.com/user-attachments/assets/17bc85bf-20b4-4260-88f7-ee6cb21ab7f3" alt="Subtitle Options merged with Remove Sponsor Segments" width="400"/></td>
+  </tr>
+  <tr>
+    <td align="center"><em>Audio Format Selection with Save Thumbnail</em></td>
+    <td align="center"><em>Subtitle Options merged with Remove Sponsor Segments</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 embedding
+   - Save thumbnail
+   - Remove sponsor segments
+6. **Select Output Directory**
+7. **Click "Download"**
+
+</details>
+
+<details>
+<summary>📋 Playlist Download</summary>
+
+1. **Paste Playlist URL**
+2. **Click "Analyze"**
+3. **Select Best Quality**
+4. **Click "Download"**
+
+> 💡 The application automatically handles the download queue
+
+</details>
+
+<details>
+<summary>⚙️ Advanced Options</summary>
+
+- **Quality Selection:** Choose 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
+
+</details>
+
+## 🛠️ Requirements
+
+```plaintext
+Python 3.7+
+PySide6
+yt-dlp
+Pillow
+requests
+FFmpeg
+packaging
+```
+
+## 👥 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
+
+## 📜 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 |
+
+</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>

ytsage-4.0.0/README.md

@@ -0,0 +1,198 @@
+<div align="center">
+
+# 🎥 YTSage
+
+<img src="https://github.com/user-attachments/assets/9566f446-458a-4932-8c5a-7aec0e253a3d" width="800" alt="YTSage Interface"/>
+
+[![PyPI version](https://badge.fury.io/py/YTSage.svg)](https://badge.fury.io/py/YTSage)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.7+](https://img.shields.io/badge/python-3.7+-blue.svg)](https://www.python.org/downloads/)
+[![Downloads](https://pepy.tech/badge/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 |
+|--------------|-------------------|----------------|
+| 🎥 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 | ⚠️ Error Handling |
+
+</div>
+
+## 🚀 Installation
+
+### Quick Install (Recommended)
+```bash
+pip install YTSage
+```
+```bash
+# Run the application
+ytsage
+```
+
+<details>
+<summary>📦 Other Installation Methods</summary>
+
+### Pre-built Executables
+- 🪟 Windows: `YTSage.exe`
+- 🍎 macOS: `YTSage.dmg`
+- 🐧 Linux: `YTSage.AppImage`
+
+### Manual Installation
+```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>
+
+## 📸 Screenshots
+
+<div align="center">
+<table>
+  <tr>
+    <td><img src="https://github.com/user-attachments/assets/9566f446-458a-4932-8c5a-7aec0e253a3d" alt="Main Interface" width="400"/></td>
+    <td><img src="https://github.com/user-attachments/assets/99330ae2-f027-4a13-a08e-16c715d7f481" 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/2023c9d6-1b3a-4d75-85a3-f88cc17e8194" alt="Audio Format Selection with Save Thumbnail" width="400"/></td>
+    <td><img src="https://github.com/user-attachments/assets/17bc85bf-20b4-4260-88f7-ee6cb21ab7f3" alt="Subtitle Options merged with Remove Sponsor Segments" width="400"/></td>
+  </tr>
+  <tr>
+    <td align="center"><em>Audio Format Selection with Save Thumbnail</em></td>
+    <td align="center"><em>Subtitle Options merged with Remove Sponsor Segments</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 embedding
+   - Save thumbnail
+   - Remove sponsor segments
+6. **Select Output Directory**
+7. **Click "Download"**
+
+</details>
+
+<details>
+<summary>📋 Playlist Download</summary>
+
+1. **Paste Playlist URL**
+2. **Click "Analyze"**
+3. **Select Best Quality**
+4. **Click "Download"**
+
+> 💡 The application automatically handles the download queue
+
+</details>
+
+<details>
+<summary>⚙️ Advanced Options</summary>
+
+- **Quality Selection:** Choose 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
+
+</details>
+
+## 🛠️ Requirements
+
+```plaintext
+Python 3.7+
+PySide6
+yt-dlp
+Pillow
+requests
+FFmpeg
+packaging
+```
+
+## 👥 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
+
+## 📜 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 |
+
+</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>

ytsage-4.0.0/pyproject.toml

@@ -0,0 +1,48 @@
+[build-system]
+requires = ["setuptools>=75.8.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ytsage"
+version = "4.0.0"
+description = "Modern YouTube downloader with a clean PySide6 interface."
+authors = [
+    { name = "oop7", email = "oop7_support@proton.me" },
+]
+dependencies = [
+    "yt-dlp",
+    "PySide6",
+    "requests",
+    "Pillow",
+    "packaging",
+]
+requires-python = ">=3.7"
+readme = "README.md"
+license = { text = "MIT License" }
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.7",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Topic :: Multimedia :: Video",
+    "Topic :: Multimedia :: Sound/Audio",
+    "Topic :: Utilities",
+    "Intended Audience :: End Users/Desktop",
+    "Environment :: X11 Applications :: Qt"
+]
+
+keywords = ["youtube", "downloader", "video", "audio", "PySide6", "yt-dlp", "GUI"]
+
+
+[project.urls]
+Homepage = "https://github.com/oop7/YTSage"
+Bug-Tracker = "https://github.com/oop7/YTSage/issues"
+Reddit = "https://www.reddit.com/r/NO-N_A_M_E/"
+
+[project.scripts]
+ytsage = "ytsage.main:main"

ytsage-4.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

ytsage-4.0.0/setup.py

@@ -0,0 +1,47 @@
+from setuptools import setup, find_packages
+from pathlib import Path
+
+setup(
+    name='ytsage', 
+    version='4.0.0',
+    author='oop7',
+    author_email='oop7_support@proton.me', 
+    description='Modern YouTube downloader with a clean PySide6 interface.', 
+    long_description=Path('README.md').read_text(encoding='utf-8'),
+    long_description_content_type='text/markdown',
+    url='https://github.com/oop7/YTSage',
+    packages=find_packages(),
+    install_requires=[
+        'yt-dlp',
+        'PySide6',
+        'requests',
+        'Pillow',
+        'packaging'
+    ],
+    classifiers=[
+        'Development Status :: 4 - Beta',
+        'Programming Language :: Python :: 3',
+        'Programming Language :: Python :: 3.7',
+        'Programming Language :: Python :: 3.8',
+        'Programming Language :: Python :: 3.9',
+        'Programming Language :: Python :: 3.10',
+        'Programming Language :: Python :: 3.11',
+        'License :: OSI Approved :: MIT License',
+        'Operating System :: OS Independent',
+        'Topic :: Internet :: WWW/HTTP :: Downloading',
+        'Topic :: Multimedia :: Video',
+        'Topic :: Multimedia :: Sound/Audio',
+        'Topic :: Utilities',
+    ],
+    python_requires='>=3.7',
+    entry_points={
+        'console_scripts': [
+            'ytsage=main:main',
+        ],
+    },
+    project_urls={
+        'Homepage': 'https://github.com/oop7/YTSage',
+        'Bug Tracker': 'https://github.com/oop7/YTSage/issues',
+        'Reddit': 'https://www.reddit.com/r/NO-N_A_M_E/',
+    },
+)

ytsage-4.0.0/ytsage/__init__.py

@@ -0,0 +1,4 @@
+# Required for Python package recognition
+from .main import YTSageApp, main
+
+__version__ = "4.0.0" 

ytsage-4.0.0/ytsage/main.py

@@ -0,0 +1,12 @@
+import sys
+from PySide6.QtWidgets import QApplication
+from .ytsage_gui import YTSageApp
+
+def main():
+    app = QApplication(sys.argv)
+    window = YTSageApp() # Instantiate the main application class
+    window.show()
+    sys.exit(app.exec())
+
+if __name__ == '__main__':
+    main()