Metadata-Version: 2.4
Name: vid-download
Version: 0.1.0
Summary: ViDownload is a fast and flexible command-line video downloader built with Python and powered by yt-dlp. It allows users to download videos or extract audio (MP3) from URLs with support for multiple resolutions, audio bitrates, batch downloads, and parallel processing. The tool also provides automatic ZIP packaging for multiple downloads and an interactive terminal interface for ease of use.
Author-email: Pramit Acharjya <acharjyapramit@gmail.com>
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: yt-dlp

# 🎬 VidDownload

**VidDownload** is a powerful and user-friendly command-line tool for downloading videos and audio from the internet using Python and `yt-dlp`.

It supports batch downloads, multiple resolutions, MP3 extraction, and parallel processing — all from a simple terminal interface.

---

## 🚀 Features

* 📥 Download videos in multiple resolutions (Best, 480p, 720p, 1080p)
* 🎵 Extract audio as MP3 with selectable bitrate
* ⚡ Parallel downloads for faster performance
* 📦 Automatic ZIP packaging for multiple downloads
* 📁 Choose custom save locations
* 🧠 Smart progress tracking with ETA and speed
* 🖥️ Simple interactive CLI experience

---

## 📦 Installation

```bash
pip install vid-downlod
```

> Make sure you also have **ffmpeg** installed on your system.

---

## ▶️ Usage

Run directly from terminal:

```bash
vid-downlod
```

---

## 🧭 How It Works

1. Enter number of files to download
2. Paste video URLs
3. Choose format:

   * MP4 (video)
   * MP3 (audio)
4. Select:

   * Resolution (for video)
   * Bitrate (for audio)
5. Choose save location
6. Sit back while downloads run in parallel 🚀

---

## ⚙️ Supported Options

### 🎥 Video Resolutions

* Best
* 480P
* 720P
* 1080P

### 🎵 Audio Bitrates

* 128 kbps
* 192 kbps
* 256 kbps
* 320 kbps

---

## 📁 Output Behavior

* Single file → saved directly to chosen directory
* Multiple files → downloaded into a temp folder and zipped automatically

---

## 🧱 Project Structure

* `download.py` → Core download logic using yt-dlp 
* `main.py` → CLI interface and orchestration 
* `zip_files.py` → Handles ZIP creation 

---

## ⚡ Performance

ViDownload uses:

* `ThreadPoolExecutor` for parallel downloads
* Smart progress hooks to reduce UI spam
* Efficient file handling and cleanup

---

## ⚠️ Requirements

* Python 3.8+
* `yt-dlp`
* `ffmpeg` (required for audio/video processing)

---

## 🛠️ Example Workflow

```text
How many files do you want to download?: 2

Enter URL #1: https://...
Enter URL #2: https://...

Download as:
1. MP4
2. MP3

Select resolution / bitrate...

✅ Downloads complete
📦 Zip complete
```

---

## ❗ Disclaimer

This tool is intended for educational and personal use only.
Please ensure you comply with the terms of service of the content providers you use.

---

## ❤️ Contributing

Pull requests and suggestions are welcome!

---

## 📄 License

GNU License
