Vidleech

A modern GUI video downloader powered by yt-dlp.

Features

• 🎨 Clean, modern GUI interface
• 🎥 Support for multiple video platforms
• 📊 Real-time download progress tracking
• 🔧 Format selection (Best, HD, SD, Audio)
• 📁 Custom download directory
• ⚡ No external dependencies required (ffmpeg included)
• 🚀 Single-file Windows executable

Installation

Option 1: Download Executable (Windows)

1. Go to the Actions page
2. Click on the latest successful "Build" workflow run
3. Scroll down to "Artifacts"
4. Download "vidleech-windows"
5. Extract and run vidleech.exe

Option 2: From Source

1. Clone the repository:

git clone https://github.com/maread2/vidleech.git
cd vidleech

2. Install Poetry (if not already installed):

curl -sSL https://install.python-poetry.org | python3 -

3. Install dependencies:

poetry install

4. Run the application:

poetry run python src/main.py

Usage

1. Launch Vidleech
2. Paste a video URL
3. Select desired format
4. Choose download location
5. Click Download

Supported Platforms

Vidleech supports downloading from various platforms including:

• YouTube
• Vimeo
• Dailymotion
• And many more...

See the full list of supported sites here.

Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

1. Fork the repository
2. Create your feature branch
3. Make your changes
4. Submit a pull request

Development

• Built with Python 3.11 and PyQt6
• Uses Poetry for dependency management
• Follows Black code style
• Includes comprehensive test suite

Running Tests

poetry run pytest

Building Executable

poetry run pyinstaller src/main.py --name=vidleech --onefile --noconsole

Security

For security issues, please see our Security Policy.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• yt-dlp for the core downloading functionality
• PyQt6 for the GUI framework