project/ │ ├── app.py # Python backend (Flask or FastAPI) ├── templates/ │ └── index.html # Web page ├── static/ │ ├── style.css # CSS │ └── script.js # JavaScript └── downloads/

Features Paste a video URL. Choose video or audio download. Select quality. Display download progress. Show status/errors. Automatically save downloads. Tip: use VLC Media for viewing mp3 into video

YT-DLP Web Downloader

A hybrid Python + HTML/CSS/JavaScript web application using Flask and yt-dlp to download video or audio through a browser interface.

use python from terminal after the setup_ytdlp_webapp.py, Ytdlp.py
then go to same folder you will see a run.bat file enjoy👌

Features

• Browser-based interface
• Video downloads using yt-dlp
• Audio-only MP3 extraction
• Real-time download progress
• Simple HTML/CSS frontend
• Python Flask backend
• FFmpeg support

1 has run.bat file 2 has dwonloads ---

Requirements

1. Python

Install Python 3.10 or newer.

Check installation:

python --version

Recommended versions:

• Python 3.11
• Python 3.12

---

2. pip

Check pip:

pip --version

---

3. FFmpeg

FFmpeg is required for:

• Audio conversion
• MP3 extraction
• Video/audio merging

Check:

ffmpeg -version

Install FFmpeg

Windows

1. Download FFmpeg.
2. Extract the archive.
3. Add the bin folder to your system PATH.
4. Restart the terminal.

Ubuntu/Debian Linux

sudo apt update
sudo apt install ffmpeg

macOS

brew install ffmpeg

---

Project Structure

YTDownloader/
│
├── app.py
├── requirements.txt
│
├── templates/
│   └── index.html
│
├── static/
│   ├── style.css
│   └── script.js
│
├── downloads/
│
└── README.md

---

Installation Guide

Step 1: Create Project Folder

mkdir YTDownloader
cd YTDownloader

---

Step 2: Create Virtual Environment

Windows

python -m venv venv
venv\Scripts\activate

Linux/macOS

python3 -m venv venv
source venv/bin/activate

---

Step 3: Install Dependencies

Create a file named:

requirements.txt

Add:

Flask>=3.0.0
yt-dlp>=2026.01.01

Install:

pip install -r requirements.txt

---

Application Files

Backend

Create:

app.py

Add the Flask backend code.

---

Frontend

Create:

templates/index.html

Add the HTML interface.

---

Styling

Create:

static/style.css

Add CSS styling.

---

JavaScript

Create:

static/script.js

Add frontend JavaScript.

---

Running the Application

Start Flask:

python app.py

You should see:

Running on http://127.0.0.1:5000

Open your browser:

http://127.0.0.1:5000

---

Updating yt-dlp

yt-dlp updates frequently.

Update:

pip install -U yt-dlp

---

Troubleshooting

Module Not Found Error

Example:

ModuleNotFoundError: No module named 'flask'

Fix:

pip install flask yt-dlp

---

FFmpeg Not Found

Error:

ffmpeg not found

Fix:

• Install FFmpeg.
• Add FFmpeg to PATH.
• Restart terminal.

---

Download Errors

Try updating yt-dlp:

pip install --upgrade yt-dlp

Some websites change their systems frequently, so older versions may stop working.

---

Security Notes

• Only download content you are allowed to access.
• Respect website terms of service.
• Do not use this application to bypass access restrictions.
• Keep downloaded files in a controlled directory.

---

Possible Improvements

Future upgrades:

• Quality selector
• Playlist downloads
• Download history
• User authentication
• Mobile responsive UI
• Dark/light mode
• WebSocket live progress
• Multiple download queue
• Subtitle support
• Thumbnail downloader
• Docker deployment

---

or run this script: python setup_ytdlp_webapp.py