Metadata-Version: 2.4
Name: shivaaytube
Version: 1.0.4
Summary: A powerful YouTube search and high-quality download library with GUI and CLI
Home-page: https://github.com/Shivaay20005/Shivaay_Extract_Tube
Author: Shivaay20005
Author-email: shivaay20005@gmail.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.31.0
Requires-Dist: typing_extensions>=4.0.0
Requires-Dist: yt-dlp>=2025.1.15
Requires-Dist: mutagen>=1.47.0
Requires-Dist: colorama>=0.4.6
Requires-Dist: pyfiglet>=1.0.2
Requires-Dist: static-ffmpeg>=2.5.0
Requires-Dist: customtkinter>=5.2.2
Requires-Dist: Pillow>=10.2.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# 🏹 ShivaayTube - Ultimate YouTube Suite

<div align="center">

![Python](https://img.shields.io/badge/Python-3.7+-3776AB?style=for-the-badge&logo=python&logoColor=white)
![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge)
![UI](https://img.shields.io/badge/UI-CLI%20%26%20GUI-red?style=for-the-badge)
![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20Linux%20%7C%20Mac-blue?style=for-the-badge)

**Powerful YouTube Scraper & High-Quality Downloader (Up to 4K)**
*Fast, Secure, and Professional.*

</div>

---

## ✨ Features

*   **⚡ Two Modes**: Use the lightning-fast **CLI** or the premium **Desktop GUI**.
*   **🔍 Smart Search**: Search videos, channels, and playlists by name (no IDs required!).
*   **🔗 Direct Links**: Paste any YouTube Video, Shorts, or Playlist link for instant download.
*   **🎬 High Quality**: Force download up to **4K (60fps)** with automatic high-res audio merging.
*   **🎵 Crystal Clear Audio**: Extract high-bitrate MP3s with original metadata.
*   **📑 Batch Mode**: Download entire search results or playlists in one click.
*   **🌍 Cross-Platform**: Works perfectly on Windows, Ubuntu (Linux), and macOS.

---

## 📥 Installation

Choose your platform behavior below:

### 🪟 Windows
```bash
pip install shivaaytube
```

### 🐧 Ubuntu / Linux
First, install the GUI support library, then install ShivaayTube:
```bash
sudo apt-get update
sudo apt-get install python3-tk
pip install shivaaytube
```

### 🍎 macOS
```bash
pip install shivaaytube
```

---

## 🚀 Getting Started

Once installed, you can launch ShivaayTube directly from your terminal/command prompt:

### 📟 Launch Terminal CLI
```bash
shivaaytube
```
*Best for speed and lightweight usage.*

### 🖥️ Launch Desktop GUI
```bash
shivaaytube-gui
```
*Best for a visual experience with thumbnails, download history, and progress bars.*

---

## 🛠️ Library Usage (For Developers)

You can also use ShivaayTube as a library in your own Python projects:

```python
import shivaay_extract_tube as st

# Search for videos
videos = st.get_search("Best Hindi Songs", limit=5)
for v in videos:
    print(v['title']['runs'][0]['text'])

# Download high quality
st.download("VIDEO_ID_HERE", is_audio=False, quality="1080p")
```

---

## 🎨 Screenshots
*(Coming Soon / Add your GUI screenshots here)*

---

## ⚖️ Disclaimer
This tool is for **educational use only**. Please respect YouTube's Terms of Service and only download content if you have permission from the creator.

---

<div align="center">
Made with ❤️ by <b>Shivaay</b>
<br>
<a href="https://github.com/Shivaay20005/Shivaay_Extract_Tube">GitHub Repository</a> | <a href="https://pypi.org/project/shivaaytube/">PyPI Project</a>
</div>
