110 lines
4.6 KiB
Markdown
110 lines
4.6 KiB
Markdown
---
|
|
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]]
|