Installer HomeTube avec Docker

zarev 21 sept. 2025 4 min de lecture

Table des matières

Encore une application pour télécharger des vidéos YouTube ? Non. Pas que sur YouTube ! Sur pas loin de 1800 plateformes. HomeTube est orienté fichier individuel et non playlist.

Aujourd'hui, nous allons parler de HomeTube ! Cet outil va vous permettre de pomper les vidéos qui vous intéressent à gauche et à droite, dans la meilleure qualité possible et le tout, très simplement.

Pour le moment vous obtiendrez un fichier .mkv, mais il y a déjà une demande sur GitHub pour choisir le format de sortie.

⚡ Caractéristiques

🎯 Téléchargements en un clic : collez l'URL → obtenez une vidéo parfaitement organisée.
🚫 Contenu sans publicité : bloquez les sponsors et les publicités des vidéos.
🎬 Traitement avancé : coupez des clips, intégrez des sous-titres, convertissez des formats.
🔐 Débloquez les vidéos restreintes : prise en charge des cookies pour les vidéos réservées aux membres, les vidéos soumises à une restriction d'âge, etc.
📊 Contrôle qualité : sélection automatique de la meilleure qualité ou remplacement manuel.
🎥 Sources vidéo : YouTube, Reddit, Vimeo, Dailymotion, TikTok, Twitch, Facebook, Instagram, etc. Voir la liste complète (plus de 1800).

💾 Installation

Prérequis

Avant de commencer, assurez-vous d’avoir :

Distribution Linux (Ubuntu, Debian, etc ...).
Docker installé.
Accès terminal.
Connexion internet.

Étapes d'installation

Créez votre compose.yml dans le dossier ou vous comptez installer HomeTube :

nano compose.yml

Et collez ça dedans :

services:
  hometube:
    image: ghcr.io/egalitarianmonkey/hometube:latest
    ports:
      - "8501:8501"
    environment:
      - TZ=Europe/Paris      # Configure timezone
      - PORT=8501            # Web interface port
      - VIDEOS_FOLDER=/data/Videos
      - TMP_DOWNLOAD_FOLDER=/data/tmp
      - YOUTUBE_COOKIES_FILE_PATH=/config/youtube_cookies.txt
    volumes:
      - ./downloads:/data/Videos    # Downloads folder
      - ./cookies:/config           # Cookies folder
    restart: unless-stopped

On va déployer l'application :

docker compose up -d

Rendez-vous sur l'ip:port, suivant l'IP de votre serveur local et du port choisi, 8501 par défaut :

http://ip:8501/

ou votre domaine :

https://hometube.mondomaine.com

🎬 Extraire une vidéo

Dans mon cas je vais extraire la vidéo suivante :

Complétez les informations suivantes :

1 => Collez le lien de la vidéo.
2 => Nommez votre vidéo ou HomeTube choisira le titre par défaut de la vidéo si vous laissez cet espace vide.
3 => Choisissez éventuellement un dossier de destination, ici par défaut.
4 => Choisissez ou non l'extraction des sous-titres.

1 => Choisissez "le niveau" de retrait des publicités, des sponsors , intro ou encore outro.

Vous pouvez choisir de ne prendre qu'une partie de la vidéo, si vous voulez la vidéo dans son entièreté, ne touchez à rien :

1 => Keyframes ou Precise. Si vous optez pour Keyframes, il n'y aura pas de réencodage. Si vous optez pour Precise, il y aura un réencodage de la vidéo.
2 => Choisissez le temps en minutes et secondes pour choisir quelle partie de la vidéo vous souhaitez.

1 => Par défaut ça sera la meilleure qualité. Mais si vous cliquez sur Detect qualities, HomeTube affichera les qualités disponibles.
2 => Dans le cas où vous auriez cliqué sur Detect qualities, choisissez la qualité souhaitée.