Python Video Downloader by true_lock

A PyQt6-based GUI and CLI video downloader that leverages yt-dlp for video extraction and downloading.
The application provides an easy to use graphical user interface with usefull Costumization Settings.
You can also use this as a CLI tool (interactive or for scripting). Learn more
This Tool supports every Site yt-dlp supports + additional ones.

CLI only Builds

Features

• 📥 Video Downloading: You can Download Videos and Audio from most Websites.
• ⚡ Faster Download Speed: Automatically adjusts download settings based on your network connection.
• ⌨️ CLI Support: The Code offers Support for (interactive) CLI usage, so you can also use it for scripting or just without the UI. Learn more
• 🏷️ Video Metadata Extraction: Automatically retrieves video title, thumbnail, and file size.
• 🎞️ Download Options: Choose from multiple formats including mp4 (with/without audio), mp3, avi, and mkv.
• 🎚️ Quality Settings: Customize video quality and audio bitrate.
• 📊 Progress Tracking: Monitor individual download progress as well as overall progress.
• 🔗 Multi Threading: Download as much at the same time as you want.
• ⏸️▶️✖️ Download Control: Pause, cancel and resume downloads.
• 🌙 Dark Mode UI: A modern, dark-themed interface built with PyQt6.

Prerequisites

• Python 3.6 or higher. (only if using the raw source code instead of an Release Binary)
• ffmpeg is required for merging files. The application checks for ffmpeg and offers to install it via winget if it's not found.

Installation

Using an compiled Binary from Releases:

1. Download the zip file for your operating system from the Latest Release

2. Unpack it

Using the Python Code

1. Clone the repository:

   git clone https://github.com/truelockmc/video-downloader.git
   cd video-downloader

2. Install the required packages:

   pip install -r requirements.txt

Usage

Run the main Python script:

python main.py

(or just run the Executable you got from releases)

Upon launching, the UI will allow you to input a video URL, choose a download folder, select a file format, and configure quality settings. The downloader will then extract metadata, display a preview, and manage the download process.

Configuration & Log Files

This application stores its configuration and logs in a user-writable directory.

Platform	Path
macOS	~/Library/Application Support/VideoDownloader/
Windows	%APPDATA%\VideoDownloader\
Linux	~/.config/VideoDownloader/

Files in that directory:

• download_config.ini - download settings (speed tier, output folder, Deno path)
• videodownloader.log - application log, capped at 3 files
• deno(.exe) - if you chose to automatically download deno

To troubleshoot a silent crash (e.g. the app closes immediately without showing a window), check the log file.

Important

On Windows, logging is only going to work if you start the executable using your cmd.

Additonally supported Sites:

• Videasy, a known 🏴‍☠️ video Provider Site. (You cannot directly input the player link, you need to get the .m3u8 Link) Here's how. This also works for similiar Websites.
• Every site using cloudflare anti-bot protection

Help

If you have any questions or Encounter Problems feel free to contact me per E-mail (anonyson@proton.me) or Discord. You can also create an Github Issue.

Contributing

Contributions are welcome! Please open an issue or submit a pull request for any improvements or bug fixes.

Made by me : )