🌌 VoidGrab

A sleek personal video downloader with a modern dark UI. VoidGrab lets you easily download YouTube videos in MP4 format with a clean, space-themed interface.

🎯 Download Features

• MP4 Video Downloads: High-quality video files
• Simple One-Click: No format confusion - just MP4 videos
• Custom Output: Choose download location
• Fast Downloads: Optimized for quick video retrieval

🚀 Easy to Use

• Simple Interface: Just paste URL and download
• Auto Dependencies: Installs yt-dlp automatically

📋 Requirements

• Windows 10/11 (64-bit recommended)
• Python 3.7+ (for development only)
• Internet Connection (for downloads and dependency installation)
• No FFmpeg required - simplified MP4-only downloads

🚀 Quick Start

Option 1: Run the Executable

1. Download VoidGrab.exe from releases
2. Double-click to run
3. Paste a YouTube URL and download!

Option 2: Run from Source

# Clone the repository
git clone https://github.com/itsjustadarsh/VoidGrab
cd voidgrab

# Install dependencies
pip install -r requirements.txt

# Run the app
python youtube_downloader.py

🔧 Building

Create your own executable:

# Install dependencies
pip install -r requirements.txt

# Build the app
python build.py

Your VoidGrab.exe will be in the dist/ folder!

📁 Project Structure

voidgrab/
├── youtube_downloader.py    # Main app
├── build.py                 # Build script
├── version_info.py          # App metadata
├── requirements.txt         # Dependencies
├── README.md               # This file
├── LICENSE                 # License
├── .gitignore              # Git ignore rules
├── output/                 # Downloads (auto-created)
└── dist/                   # Built executable

🎮 How to Use

1. Launch VoidGrab
2. Paste a YouTube URL
3. Click Download MP4
4. Wait for it to finish!

Simple as that - no format selection needed!

🐛 Troubleshooting

• yt-dlp not found: App will auto-install it
• Download failed: Check your URL and internet connection
• Permission error: Try a different output folder
• Video unavailable: Some videos may be region-locked or private

🤝 Contributing

This is a personal project, but feel free to:

• Report bugs
• Suggest features
• Submit pull requests
• Fork for your own use

---

Personal project for YouTube downloading

For personal use only. Respect copyright laws and YouTube's ToS.