kavehbc/video-downloader repository overview

⁠🎬 Video Downloader

GitHub Repository: https://github.com/kavehbc/video-downloader⁠

A Streamlit web app for downloading videos from YouTube, X (Twitter), Facebook, Instagram, TikTok, and hundreds of other sites powered by yt-dlp⁠.

⁠Features

• Single video downloads — paste any supported URL and download in your chosen format
• YouTube quality selector — Best, 1080p, 720p, 480p, 360p, or Audio Only (MP3)
• YouTube playlist support — fetches the full playlist into a live-updating dataframe showing each video's status (Pending / In Progress / Downloaded / Failed)
• Persistent archive — already-downloaded playlist videos are remembered across sessions via a local archive file
• In-browser save — a download button appears after each completed download so you can save the file directly from the browser
• FFmpeg integration — automatic merging of separate video and audio streams; MP3 extraction for audio-only downloads
• Docker ready — multi-stage Dockerfile and Docker Compose for one-command deployment

⁠Requirements

⁠Running locally

• Python 3.10+
• FFmpeg⁠ on your PATH

Install Python dependencies:

pip install -r requirements.txt

⁠Running with Docker

• Docker⁠ (FFmpeg is installed automatically in the image)

⁠Usage

⁠Local

streamlit run main.py

Open http://localhost:8501⁠ in your browser.

⁠Docker Compose

docker compose up --build

Open http://localhost:8501⁠ in your browser.

Downloaded files are stored in a named Docker volume (downloads) and persist across container restarts. To stop:

docker compose down

Add -v to also remove the downloads volume:

docker compose down -v

⁠Docker Run

Build the image first (if not already built):

docker build -t kavehbc/video-downloader:latest .

Then run the container:

docker run -d \
  --name video-downloader \
  -p 8501:8501 \
  -v downloads:/app/static \
  --restart unless-stopped \
  kavehbc/video-downloader:latest

Open http://localhost:8501⁠ in your browser.

To use a local folder instead of a named volume, replace -v downloads:/app/static with a bind mount:

# Linux / macOS
-v /your/local/path:/app/download

# Windows (PowerShell)
-v C:\your\local\path:/app/download

To stop and remove the container:

docker stop video-downloader
docker rm video-downloader

⁠Project Structure

video-downloader/
├── main.py              # Streamlit app (UI + download logic)
├── requirements.txt     # Python dependencies
├── Dockerfile           # Multi-stage Docker image with FFmpeg
├── docker-compose.yml   # Build and run with a single command
└── download/            # Downloaded files (git-ignored)
    └── .archive.txt     # Tracks downloaded playlist video IDs

⁠Supported Sites

Any site supported by yt-dlp — including YouTube, X (Twitter), Facebook, Instagram, TikTok, Vimeo, Twitch, Reddit, and 1000+ more⁠. Quality/format options are only shown for YouTube URLs; other sites download at the best available quality automatically.

⁠Notes

• Merging video and audio streams (1080p and above) requires FFmpeg. If FFmpeg is not installed locally, use the Docker setup instead.
• Downloaded files are saved to the download/ directory relative to main.py.
• The in-browser Save to your device button reads the file from the server and streams it to your browser — it only appears after a successful download.