vid-download 0.1.0

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.

🎬 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

pip install vid-downlod

Make sure you also have ffmpeg installed on your system.

---

▶️ Usage

Run directly from terminal:

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

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