# YT-DLP Web Player

YT-DLP Web Player is a lightweight media player powered by yt-dlp that streams, searches, and downloads online videos, including livestreams, for users who want a minimal interface. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1533/yt-dlp-web-player

## Description

YT-DLP Web Player is a lightweight media player powered by yt-dlp that streams, searches, and downloads online videos, including livestreams, for users who want a minimal interface.

## Platform availability

Available on 3 of 10 platforms: Unraid, Linux, Any server.

## Desktop and other devices

Linux.

## Health score

79/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 18 days ago)
- Popular: 58 (812 GitHub stars)
- Easy to install: 55 (3 install platforms, install notes, Docker image)
- Security check: 85 (no serious findings, CI)

## Links

- Docker Hub: https://hub.docker.com/r/matszwe02/ytdlp_web_player
- GitHub: https://github.com/Matszwe02/ytdlp_web_player
- desktop: https://github.com/Matszwe02/ytdlp_web_player/releases/latest
- Unraid: https://ca.unraid.net/apps/yt-dlp-web-player-1ueyzjo0lupqig?q=YT-DLP-Web-Player

## Common questions

### Which port does the app use by default?

It should be accessible on port 5000. The Docker example maps host port 5000 to container port 5000.

### Which Docker tag should I use for a stable self-hosted instance?

Use the stable tag for everyday use. The latest tag may contain new experimental features and more bugs.

### Where are the optional features configured?

Some features are off by default and need to be turned on in .env. For Docker Compose, uncomment env_file and copy src/example.env to src/.env.

### How do I run it over HTTPS using the included compose setup?

You can enable HTTPS in compose.yml. The HTTPS app is then served on port 5001, and the browser will warn about the untrusted certificate, so you need to click allow.

### Why does playback take longer than expected for some videos?

Most videos load in around 3 seconds. If that fails, transcoding starts and the video may load in around 10 seconds, and if that also fails the whole video is downloaded until it becomes available.

---
Source: Our Local Host (https://ourlocalhost.com/app/1533/yt-dlp-web-player), the self-hosted and open-source app directory.
