NshDownload 📥

NshDownload is a modern YouTube video downloader desktop application built with Python. This project was developed as a technical study to understand multi-threading, network stream handling, and media merging processes in a GUI environment.

⚠️ Disclaimer (Educational Purposes Only)

Important: This project is strictly for educational purposes only. It was created to demonstrate software engineering concepts such as:

• GUI development with customtkinter
• Asynchronous programming and multi-threading
• Dependency management and external process handling (FFmpeg)
• Regular expressions for string sanitization

The developer does not encourage or condone the unauthorized downloading of copyrighted material. Users are responsible for complying with YouTube's Terms of Service and local copyright laws.

🚀 Features

• High-Quality Downloads: Merges separate video and audio streams for the best possible resolution using FFmpeg
• Modern UI: A clean, dark-mode responsive interface using CustomTkinter
• Multi-threaded Execution: The interface remains responsive during the download and merging process
• Smart Cleanup: Automatically removes temporary files after a successful merge or unexpected exit

🛠️ Prerequisites

This application requires FFmpeg to merge high-resolution video and audio files.

Installing FFmpeg:

Linux (Debian/Ubuntu):

sudo apt update && sudo apt install ffmpeg

Windows:

1. Download the build from ffmpeg.org

• Get the Essentials version from ffmpeg.org. Don't bother with other versions (like Full or Master); the Essentials build is more than enough for this tool.

2. Add the bin folder to your System PATH OR place ffmpeg.exe in the project root directory

📦 Setup & Usage

1. Clone the repository:

git clone https://github.com/hasancabuk/NshDownload.git
cd NshDownload

2. Install dependencies:

pip install -r requirements.txt

3. Run the application:

python main.py

---

Developed by: Hasan Çabuk