shivaaytube 1.0.2

A powerful YouTube search and high-quality download library

ShivaayTube - Ultimate YouTube Downloader

Developed by: Shivaay
Repository: Shivaay_Extract_Tube
PyPI: shivaaytube

---

🚀 Quick Install (Recommended)

Install directly from the internet — no setup required:

pip install shivaaytube

Then simply run:

shivaaytube

That's it! The interactive CLI will start automatically. ✅

---

🎯 Features

🖥️ Interactive CLI

• 🔍 Search YouTube videos by keyword
• 📺 Channel — fetch videos from any channel
• 📑 Playlist — fetch videos from any playlist
• 🎬 Video (MP4) or 🎵 Audio (MP3/WEBM) download
• Batch download — pick multiple videos or download all
• Clean banner UI with colors

🔍 Scraping Library (shivaay_extract_tube)

• No API keys needed — works out of the box
• Get channel videos, playlist videos, search results
• Supports Shorts & Live Streams

---

⚡ CLI Usage

After installing with pip:

shivaaytube

You will see:

  [1] 🔍 Search and Download
  [2] 📺 Channel Videos
  [3] 📑 Playlist Videos
  [0] 🚪 Exit

• Pick 1, 2, or 3 to search
• Select video number(s) (e.g. 1, 3, 1,2,5, or all)
• Choose [1] Video or [2] Audio
• Download starts automatically into downloads/ folder

---

🛠️ Local Development Setup

git clone https://github.com/Shivaay20005/Shivaay_Extract_Tube.git
cd Shivaay_Extract_Tube
pip install -r requirements.txt

Run CLI locally:

py -m shivaay_extract_tube.cli

Run GUI App:

py gui_app.py

---

📚 Use as a Python Library

import shivaay_extract_tube

# Search for videos
results = shivaay_extract_tube.get_search("Haryanvi Songs", limit=5)
for v in results:
    print(v['title']['runs'][0]['text'], v['videoId'])

# Get channel videos
videos = shivaay_extract_tube.get_channel(channel_username="ShivaayDeveloper", limit=10)

# Download a video
shivaay_extract_tube.download("VIDEO_ID_HERE", is_audio=False)

# Download audio only
shivaay_extract_tube.download("VIDEO_ID_HERE", is_audio=True)

---

📂 Project Structure

Shivaay_Extract_Tube/
├── shivaay_extract_tube/      ← Core Python package
│   ├── __init__.py
│   ├── cli.py                 ← Interactive CLI
│   ├── downloader.py          ← Download engine (yt-dlp)
│   └── shivaay_extract_tube.py← Scraping logic
├── gui_app.py                 ← GUI Desktop App
├── downloader.py              ← Standalone CLI script
├── BUILD_EXE.bat              ← Build .exe for Windows
├── requirements.txt
└── README.md

---

📦 Build Standalone .exe

No Python required on the other PC:

1. Double-click BUILD_EXE.bat
2. Wait for it to finish
3. Share dist/ShivaayTube_Ultimate.exe with anyone!

---

⚠️ Disclaimer

This tool is for educational purposes only. Please respect YouTube's Terms of Service and copyright laws when downloading content.