# MeTube (yt-dlp Web UI)

> Web GUI for yt-dlp to download videos from YouTube and other sites

- Category: Media & Entertainment
- Difficulty: beginner
- Components: metube
- Tags: youtube, download, video, yt-dlp, media
- Source: https://docker.recipes/media/metube

## Overview

MeTube is a modern web-based frontend for yt-dlp, the most powerful and actively maintained YouTube video downloader available today. Built as a successor to the original youtube-dl project, yt-dlp supports over 1,000 video platforms including YouTube, Vimeo, TikTok, Twitter, and countless others. MeTube wraps this command-line tool in an intuitive web interface, making video downloading accessible to users who prefer GUI interactions over terminal commands. This Docker deployment creates a self-hosted video downloading service that operates entirely within your network, giving you complete control over your media acquisition workflow. The containerized approach ensures yt-dlp stays updated with the latest site compatibility fixes while maintaining a consistent user experience across different host systems. MeTube is perfect for content creators, researchers, educators, and media enthusiasts who need reliable video downloading capabilities without depending on third-party online services or browser extensions that may compromise privacy or functionality.

## Features

- Clean web interface for yt-dlp with real-time download progress monitoring
- Support for over 1,000 video platforms including YouTube, Vimeo, TikTok, and Twitch
- Flexible download queue management with ability to add multiple URLs simultaneously
- Advanced yt-dlp options passthrough via YTDL_OPTIONS environment variable
- Automatic video format selection with manual quality override capabilities
- Playlist and channel downloading with individual video selection options
- Download history tracking and management through persistent state storage
- Subtitle and metadata extraction with configurable filename templates

## Use cases

- Content creators archiving their own videos from multiple platforms for backup purposes
- Educational institutions downloading lecture videos and course materials for offline access
- Researchers collecting video data from social media platforms for academic analysis
- Media professionals creating local libraries of reference materials and inspiration content
- Home media server operators building collections of legally downloadable content
- Corporate training departments archiving webinars and instructional videos
- Digital preservationists maintaining copies of important cultural or historical video content

## Prerequisites

- Docker and Docker Compose installed on host system
- Minimum 2GB RAM for handling multiple concurrent downloads
- At least 10GB free disk space for video storage (more for extensive downloading)
- Port 8081 available on host system (or ability to modify METUBE_PORT)
- Basic understanding of yt-dlp options syntax for advanced configuration
- Network connectivity to target video platforms (some may require VPN for geo-restrictions)

## docker-compose.yml

```yaml
services:
  metube:
    image: ghcr.io/alexta69/metube:latest
    container_name: metube
    restart: unless-stopped
    ports:
      - "${METUBE_PORT:-8081}:8081"
    volumes:
      - ./downloads:/downloads
    environment:
      - UID=${UID:-1000}
      - GID=${GID:-1000}
      - DOWNLOAD_DIR=/downloads
      - STATE_DIR=/downloads/.metube
      - YTDL_OPTIONS=${YTDL_OPTIONS:-{}}
```

## .env

```bash
# MeTube Configuration
METUBE_PORT=8081

# User/Group IDs for file permissions
UID=1000
GID=1000

# yt-dlp options as JSON
# Example: {"format": "bestvideo+bestaudio/best"}
YTDL_OPTIONS={}
```

## Usage notes

- Web interface at http://localhost:8081
- Paste video URLs to download
- Downloads saved to ./downloads folder
- Supports YouTube, Vimeo, and 1000+ sites
- Configure quality via YTDL_OPTIONS
- Based on yt-dlp (youtube-dl fork)

## Troubleshooting

- HTTP Error 429 or rate limiting messages: Add delays between downloads using YTDL_OPTIONS with sleep-interval parameter
- Downloads failing with 'Video unavailable' errors: Update the container image as yt-dlp frequently patches site compatibility issues
- Permission denied errors when writing files: Verify UID and GID environment variables match your host system user ownership
- Container fails to start with port binding errors: Check if port 8081 is already in use or modify METUBE_PORT variable
- Downloads stuck at 0% progress: Some sites require cookies or authentication - configure these via YTDL_OPTIONS
- Large video files causing container crashes: Increase Docker memory limits or use format selection to download smaller files

