greglaprise/video-downloader repository overview

⁠Video/Audio Downloader

A modern, containerized web application for downloading videos and audio from 1000+ platforms including YouTube, Vimeo, Twitch, Twitter/X, Instagram, and TikTok.

⁠✨ Key Features

• Universal Platform Support - Download from any site supported by yt-dlp
• Real-time Progress Tracking - Live WebSocket updates with detailed progress bars
• Multiple Formats - Video downloads or audio-only MP3 extraction
• Quality Options - Choose from Best, 1080p, 720p, 480p, or 360p
• Accelerated Downloads - Integrated aria2 support for faster, more reliable downloads
• Modern Web Interface - Clean, responsive design that works on desktop and mobile
• Verbose Logging - Real-time output from yt-dlp and ffmpeg for troubleshooting
• File Management - Built-in download history and file browser

⁠🚀 Quick Start

docker run -d \
  -p 3000:3000 \
  -v ./downloads:/app/downloads \
  --name video-downloader \
  greglaprise/video-downloader

Access the web interface at http://localhost:3000

⁠🐳 Docker Compose

version: '3.8'
services:
  video-downloader:
    image: greglaprise/video-downloader
    ports:
      - "3000:3000"
    volumes:
      - ./downloads:/app/downloads
    restart: unless-stopped

⁠📦 What's Included

• Node.js 18 - Modern JavaScript runtime
• yt-dlp - Latest version for maximum platform compatibility
• ffmpeg - For video/audio processing and conversion
• aria2 - High-performance download acceleration
• WebSocket support - Real-time communication for progress updates

⁠🔧 Configuration

• Port: 3000 (configurable via PORT environment variable)
• Downloads: Stored in /app/downloads (mount as volume for persistence)
• Environment: Production-ready with automatic dependency management

⁠💡 Use Cases

• Archive educational content
• Download podcasts and music for offline listening
• Save social media videos
• Content backup and preservation
• Research and media analysis

⁠🛡️ Security

• Containerized environment with no shell injection vulnerabilities
• Downloads run in isolated processes
• Local WebSocket connections only
• No external network access required beyond downloading

⁠📋 Requirements

• Docker or Docker Compose
• 1GB+ free disk space for downloads
• Internet connection

Perfect for self-hosting, media archival, content creation workflows, and offline media consumption. No complex setup required - just run and go!

Tags: video-downloader, yt-dlp, media, archival, youtube, nodejs, ffmpeg, aria2, websocket