🎬 VidHealer

The ultimate, high-performance YouTube downloader designed for everyone—featuring a brand-new, minimal, and clear terminal interface.

---

---

✨ Why VidHealer?

• 🚀 One-Click Ready: No complex installation on Windows—just run the .exe.
• 🎨 Visual & Simple: Beautiful colors and clear instructions.
• 🛠️ Play Everywhere: Automatically saves videos in formats that work on iPhones, Androids, TVs, and Macs.
• 🧩 Smart Bypassing: Handles age-restricted and private videos without breaking a sweat.
• 🔍 Built-in Search: Find videos directly inside the app—no browser needed.
• ✂️ Download Segments: Only want the first 30 seconds? VidHealer can do that.
• ✨ Minimal & Clean: No more terminal clutter—see only what matters when you download.

---

🚀 Getting Started (Windows - Easiest)

If you are on Windows, you don't need to install Python or know how to code!

1. Download the latest release: Go to the bin-release folder (or your downloads).
2. Open the folder: Look for the file named VidHealer.exe.
3. Run it:
   • Hold Shift and Right-Click in any empty space in that folder.
   • Select "Open PowerShell window here" or "Open in Terminal".
   • Type .\VidHealer.exe --help and press Enter.

---

💻 Setup for macOS & Linux

If you are on Mac or Linux, follow these simple steps to get started:

1. Install Python

• Mac: Open your browser and go to python.org. Download and install the latest version.
• Linux: Open your terminal and type sudo apt install python3 python3-pip.

2. Open your "Terminal"

• Mac: Press Command + Space, type Terminal, and hit Enter.
• Linux: Press Ctrl + Alt + T.

3. Install VidHealer

Once your terminal is open, type these commands one by one:

# Clone the project (or download the ZIP and unzip it)
# Go into the folder:
cd VidHealer

# Install the "brain" of the app:
pip install -r requirements.txt

4. Run it

Instead of VidHealer.exe, you will type python main.py:

python main.py --help

---

📥 How to Use VidHealer (Examples)

Note

Windows users use .\VidHealer.exe. Mac/Linux users use python main.py.

1. Download a Video

Simply type the command followed by the link in quotes. VidHealer will show you all available sizes (720p, 1080p, etc.) and let you pick!

.\VidHealer.exe download "https://www.youtube.com/watch?v=dQw4w9WgXcQ"

2. Download just the Music (MP3)

Want the highest quality audio for your phone? Use the --audio flag.

.\VidHealer.exe download --audio "URL"

3. Search for a Video

Don't want to go to YouTube? Search directly:

.\VidHealer.exe search "OpenAI Sora"

4. Download a specific part (Trim)

Download only from the 1-minute mark to the 2-minute mark:

.\VidHealer.exe download "URL" --start 00:01:00 --end 00:02:00

---

🔐 Handling Restricted Content

If a video says "Sign in to confirm your age," VidHealer can fix it:

1. Open your browser (Chrome, Brave, Firefox, etc.) and log into YouTube.
2. In VidHealer, add --cookies-browser followed by your browser name:

   .\VidHealer.exe download "URL" --cookies-browser chrome

---

🛠️ Frequently Asked Questions (FAQ)

Q: I double-clicked the EXE and it disappeared! A: This is a command-line tool. You must open a "Terminal" or "PowerShell" window first (see the Windows guide above) to see the beautiful interface!

Q: Where are my files saved? A: By default, they are saved in the same folder as the app. You can change this using --out "C:/MyVideos".

---

Made with ❤️ for the video community.