title: HomeTube created: 2026-06-07 updated: 2026-06-07 type: app tags: [catalogue, arr, youtube, jellyfin, interface] confidence: high contested: false sources: [https://selfh.st/apps/?tag=*arr, https://github.com/nicocool84/hometube]

🎬 HomeTube

Interface unifiée YouTube + Jellyfin/Plex : permet de chercher sur YouTube depuis l'UI Jellyfin, d'envoyer vers un player, et de gérer les téléchargements locaux.

📋 Informations Générales

Attribut	Valeur
Nom	HomeTube
Slug	hometube
Description	Pont entre YouTube et Jellyfin/Plex : recherche, lecture, téléchargement local
Site officiel	https://hometube.app
Repository	https://github.com/nicocool84/hometube
Stars	964 ⭐
Licence	MIT
Langage principal	Python
Catégorie	*arr (frontend)
Tags	[catalogue, arr, youtube, jellyfin, interface]

📝 Description

HomeTube est né d'une frustration : on a Jellyfin/Plex pour la médiathèque locale, mais on continue d'aller sur YouTube via le navigateur pour le contenu exclusif. HomeTube intègre YouTube dans l'écosystème media-center : recherche, lecture, et même téléchargement local pour archivage.

Fonctionnalités principales :

Recherche YouTube intégrée : barre de recherche dans l'UI HomeTube, résultats avec jaquette, durée, chaîne, vues.
Player intégré : lecture directement dans le navigateur/HTPC, supporte les playlists YouTube.
Téléchargement : un clic pour télécharger via yt-dlp et ranger dans /data/youtube/ pour archivage.
Plugin Jellyfin : ajoute une section "YouTube" dans Jellyfin, avec recherche et lecture.
Historique : "ce que vous avez regardé récemment" synchronisé entre devices.
Watchlist partagée : ajoutez une vidéo à la watchlist familiale, elle apparaît partout.
SponsorBlock : skip automatique des sponsors/intros/outros pendant la lecture.
Playlists distantes : ajoutez une playlist YouTube publique, HomeTube l'importe et la suit.

L'UI est sobre, responsive, accessible depuis n'importe quel device du LAN (TV, mobile, desktop).

🚀 Installation

Via Docker (recommandé)

# docker-compose.yml
services:
  hometube:
    image: ghcr.io/nicocool84/hometube:latest
    container_name: hometube
    restart: unless-stopped
    environment:
      - TZ=Europe/Paris
      - JELLYFIN_URL=http://jellyfin:8096
      - JELLYFIN_API_KEY=xxxxxxxxxxxxxxxx
      - DOWNLOAD_PATH=/data/youtube
    volumes:
      - ./config:/app/config
      - /mnt/media/youtube:/data/youtube
    ports:
      - "8085:8085"

Installation manuelle

Python 3.10+, yt-dlp dans le PATH, ffmpeg installé. git clone, pip install -r requirements.txt, python hometube.py.

⚙️ Configuration

Jellyfin API key : Administration > Dashboard > API Keys, créer une nouvelle clé.
Cookies YouTube : exporter depuis navigateur (extension Get cookies.txt), monter dans /config/cookies.txt pour éviter les blocages.
Qualité par défaut : 1080p pour la lecture, 720p pour le téléchargement (économie de place).
SponsorBlock : activé par défaut, configurable par catégorie (sponsor, intro, outro, self-promotion).
Reverse proxy : hometube.example.com via Traefik avec Authelia.

🔗 Alternatives

Jellyfin + plugin YouTube — limité, recherche basique, pas de download.
TubeSync — équivalent mature côté téléchargement, sans player intégré.
Youtarr — focalisé sur le téléchargement + intégration Sonarr/Radarr.
Kodi + addons YouTube — possible, mais lourd et instable.
Piped/Invidious — frontends YouTube alternatifs, pas de download natif.

🔒 Sécurité

Cookies YouTube : critique,泄露 = vol de compte Google. À monter en read-only.
API key Jellyfin : clé avec permissions minimales (lecture seule suffit).
HTTPS obligatoire : le contenu YouTube consulté révèle vos centres d'intérêt.
Volumes : /data/youtube peut exploser, surveiller l'espace disque.
Logs : contenir les recherches YouTube, à protéger.
Rate limit YouTube : configurer des pauses, sinon l'IP se fait bannir.

📚 Ressources

Site officiel : https://hometube.app
Documentation : https://docs.hometube.app
Wiki *arr : https://wiki.servarr.com
SponsorBlock : https://sponsor.ajay.app

4.6 KiB Raw Permalink Blame History