---
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é)
```yaml
# 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

## 🔗 Pages Liées
- [[cat-arr]]
- [[app-jellyfin]]
- [[app-plex]]
- [[app-emby]]
- [[app-youtarr]]
- [[app-tubesync]]
- [[app-tubearchivist]]
- [[app-traefik]]
- [[app-flaresolverr]]
- [[recettes-docker-compose]]
- [[securisation-home-lab]]
