yt-dlp-web

Self-hosted yt-dlp with the Web UI.
You can watch or download videos downloaded to a remote server.

Docker Hub | Supported Sites

Preview

Mobile	Desktop

Getting Started

1. Star this repo ⭐️
2. Create a docker-compose.yml file, set user, volumes, and ports to your environment

version: "3"

services:
  yt-dlp-web:
    image: sooros5132/yt-dlp-web
    container_name: yt-dlp-web
    user: 1000:1000 # User Id, Group Id Setting
    # environment:
    #   If you need to protect the site, set AUTH_SECRET, CREDENTIAL_USERNAME, CREDENTIAL_PASSWORD.
    #   ex)
    #   AUTH_SECRET: "Random_string,_40+_characters_recommended"
    #   CREDENTIAL_USERNAME: "username"
    #   CREDENTIAL_PASSWORD: "password"
    volumes:
      - /path/to/downloads:/downloads # Downloads folder
      - /path/to/cache:/cache         # Cache folder
    ports:
      - 3000:3000 # Web Page Port Mapping
    restart: unless-stopped

3. Download and run the Docker image

# When docker-compose version is v1
docker-compose up -d

# When docker-compose version is v2
docker compose up -d

Change yt-dlp version

If you change versions, it might not work correctly.

# To update to nightly from stable executable/binary:
docker exec -u 0 -it yt-dlp-web /usr/local/bin/yt-dlp --update-to nightly

# Specifying versions, releases: https://github.com/yt-dlp/yt-dlp/releases
docker exec -u 0 -it yt-dlp-web /usr/local/bin/yt-dlp --update-to stable@<releases date>
# ex) docker exec -u 0 -it yt-dlp-web /usr/local/bin/yt-dlp --update-to [email protected]

iOS Shortcut

You can open yt-dlp-web in the app's share with a shortcut.
Before using it, please enter the domain where yt-dlp-web is deployed in the text box in the shortcut's settings below. https://www.icloud.com/shortcuts/8b038411c518474bbfe566f9fbe1e046

To Do

• Change to the component library shadcn/ui
• Add the ability to delete selected videos
• Options for Output filename
• Choose quality when downloading immediately
• Table View canceld

Tested

• Ubuntu 22.04.2 LTS
• macOS Sequoia v15.0.1

Used stack

• yt-dlp v2024.11.18
• ffmpeg v6.0.1
• Next.js v14.2.13
• React v18.2
• TypeScript v5
• Docker