yt-dlp-web

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

Preview

Mobile	Desktop

Getting Started

Star this repo ⭐️
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

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 stable@2024.08.06

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

sooros5132/yt-dlp-web