---
title: YT-DLP Web Player
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, media-streaming, yt-dlp, youtube, web-ui, downloader]
confidence: high
contested: false
sources:
  - https://selfh.st/apps/?tag=Media+Streaming
  - https://github.com/.../yt-dlp-web-player
---

# 🎬 YT-DLP Web Player

> Interface web légère pour piloter [[yt-dlp]] depuis un navigateur, avec file d'attente, formats et post-processing.

## 📋 Informations Générales

| Attribut | Valeur |
|----------|--------|
| **Nom** | YT-DLP Web Player |
| **Slug** | app-yt-dlp-web-player |
| **Description** | UI web pour yt-dlp avec gestion de queue, sélection qualité et streaming en réseau local |
| **Site officiel** | https://yt-dlp-web-player.io/ |
| **Repository** | https://github.com/marcopeocchi/yt-dlp-web-player |
| **Stars** | 214 ⭐ |
| **Licence** | MIT |
| **Langage principal** | TypeScript (frontend) + Go (backend) |
| **Catégorie** | Media Streaming |
| **Tags** | [catalogue, media-streaming, yt-dlp, youtube, web-ui, downloader] |

## 📝 Description

YT-DLP Web Player est l'interface web manquante pour [[yt-dlp]]. Là où yt-dlp reste un outil CLI puissant mais rebutant pour un usage ponctuel, ce projet offre une UI où l'on colle une URL, on choisit la qualité (vidéo seule, audio, best), le format (mp4, mkv, mp3, opus), et on lance le téléchargement. La file d'attente permet de chaîner plusieurs opérations.

Le backend Go délègue à `yt-dlp` et `ffmpeg` dans des conteneurs séparés, et peut streamer en direct (HLS) le fichier en cours de téléchargement vers un lecteur HTML5. C'est idéal pour récupérer rapidement un podcast vidéo ou un livestream en replay sans passer par un terminal.

Points forts : UI React moderne, support cookies navigateur (anti-bot), sous-titres auto, post-processing (extraction audio). Limites : attention au droit d'auteur — à utiliser sur vos propres vidéos ou du contenu sous licence libre (CC-BY).

## 🚀 Installation

### Via Docker (recommandé)

```yaml
# docker-compose.yml
version: "3.8"

services:
  yt-dlp-web:
    image: marcopeocchi/yt-dlp-webui:latest
    container_name: yt-dlp-web
    restart: unless-stopped
    ports:
      - "3082:3082"
    environment:
      - TZ=Europe/Paris
    volumes:
      - ./downloads:/app/downloads
```

### Installation manuelle

```bash
git clone https://github.com/marcopeocchi/yt-dlp-web-player
cd yt-dlp-web-player
# Backend Go
cd server && go build -o yt-dlp-web-server && ./yt-dlp-web-server &
# Frontend
cd ../ui && npm install && npm run build
# Servir le dossier build/ derrière Nginx
```

## ⚙️ Configuration

- **Téléchargements** : dossier local monté en volume, par défaut `/app/downloads`.
- **Format par défaut** : `bestvideo+bestaudio/best`, modifiable dans l'UI.
- **Cookies** : pour les sites protégés (YouTube avec restriction, Vimeo privé), fournir un `cookies.txt` exporté depuis le navigateur.
- **Streaming local** : active le mode "stream while downloading" pour les gros fichiers.
- **ffmpeg** : nécessaire pour le mux et l'extraction audio (image Docker inclut `yt-dlp + ffmpeg`).

## 🔗 Alternatives

- **yt-dlp (CLI)** — Référence, sans UI, scriptable.
- **TubeCast** — Interface web similaire, plus minimaliste.
- **MeTube** — Fork avec file d'attente intégrée, fork du même auteur.
- **Metube (mobile)** — App Android dédiée à yt-dlp.

## 🔒 Sécurité

- Ne pas exposer sur Internet : qui peut poster une URL peut déclencher des téléchargements arbitraires sur votre serveur.
- Si exposition WAN, mettre derrière une authentification forte ([[app-authentik]], [[app-traefik]] + ForwardAuth).
- Cookies YouTube : ils donnent accès à votre compte Google, à manipuler avec précaution.
- Surveiller l'espace disque : un usage intensif peut saturer rapidement un petit VPS.

## 📚 Ressources

- Repository : https://github.com/marcopeocchi/yt-dlp-web-player
- yt-dlp upstream : https://github.com/yt-dlp/yt-dlp
- Documentation formats : https://github.com/yt-dlp/yt-dlp#format-selection
- ffmpeg : https://ffmpeg.org/documentation.html

## 🔗 Pages Liées

- [[cat-media-streaming]] (catégorie parente)
- [[app-jellyfin]] — Peut ingérer les téléchargements
- [[app-plex]] — Alternative lecteur média
- [[app-traefik]] — Reverse proxy HTTPS
- [[app-authentik]] — SSO et forward auth
- [[securisation-home-lab]] — Bonnes pratiques
- [[recettes-docker-compose]] — Templates
