{{tag>noble serveur multimedia media_center}}
{{ :logo:jellyfin.png?80}}

====== Jellyfin  ======

**[[wpfr>Jellyfin]]** est un [[:multimedia#serveurs_multimedia|serveur multimédia]]. Il s'agit d'un fork de **[[https://emby.media/|Emby]]** (anciennement **Media Browser**) ce dernier étant devenu officiellement propriétaire en 2018.

Il permet de mettre sa médiathèque à disposition sur le [[:web]], qu'il s'agisse de contenu vidéo (films et séries, télévision), audio (musique, livres audio, //podcasts//), d'images, d'//eBooks//, de bandes dessinées numériques, etc., et propose des visionneuses adaptées à chaque type de contenu.

Il récupère automatiquement les informations concernant les films et les séries depuis [[https://www.imdb.com/|IMDb]] et [[https://www.themoviedb.org/|TheMovieDb]] : descriptions, affiches, réalisateurs, acteurs, etc.
Ceci permet de naviguer entre les différents réalisateurs, ou les différents genres, de trier par date, de voir tous les films avec un acteur particulier, sa photo et sa biographie, etc.

Il implémente de plus des [[https://jellyfin.org/docs/general/server/plugins/#repositories|dépôts]] d'[[https://jellyfin.org/docs/general/server/plugins|extensions]] qui permettent d'enrichir ses fonctionnalités, grâce à des solutions logicielles fournies par son importante communauté.

De base avec **Jellyfin** cette médiathèque est donc accessible et visionnable avec n'importe quel [[:navigateur]] web (à condition que celui-ci dispose des codecs nécessaires), mais de nombreux [[#clients]] dédiés améliorent son utilisation quel que soit l'appareil qu'on utilise.

Le [[:DLNA]] est activé par défaut et votre bibliothèque devrait être vue sur votre réseau local, et donc votre TV (si connectée à la box internet).

La création de comptes permet de partager ce contenu avec ses ami·e·s.

===== Installation =====

Il existe plusieurs méthodes pour installer le //[[:serveur]]// **Jellyfin** (à ne pas confondre avec **Jellyfin Media Player** qui en est un client, et ne fonctionne pas sans serveur) :
  * **[[:docker|Docker]]** est une méthode très pratique et particulièrement sécurisée : en plus de faciliter les éventuelles migrations à venir, elle assure qu'on installe la dernière version stable et fournit une bonne sécurité par design en isolant les services web du reste du système.
  * **Jellyfin** est aussi disponible depuis les [[:dépôts]] officiels d'Ubuntu. Cependant cette méthode n'est pas recommandée parce que [[:APT]] ne permet pas de profiter immédiatement de la dernière version, n'isole pas les services web du reste du système, et rend les futures migration des services beaucoup plus complexes et chronophages.((Sur la page concernant les CMS, voir l'[[:cms#cms|avertissement concernant l'installation de services web]] depuis les dépôts d'Ubuntu / APT.))
  * Le serveur **Jellyfin** est aussi disponible en [[:flatpak]], pour les architectures x86_64 et aarch64, sur le dépôt [[https://flathub.org/apps/details/org.jellyfin.JellyfinServer|Flathub]] et peut donc s'installer en suivant [[:tutoriel:installer_application_flatpak|cette procédure]] puis en installant le paquet ''[[https://flathub.org/apps/details/org.jellyfin.JellyfinServer|org.jellyfin.JellyfinServer]]''.

==== Docker (recommandé) ====

**Jellyfin** est disponible en image **[[:Docker]]** sur [[https://hub.docker.com/r/jellyfin/jellyfin/|Docker Hub]].

Pour des raisons de simplicité (et éviter des lignes de commande à rallonge) on utilisera ici l'outil **[[docker#Docker Compose]]**.

Pour commencer, [[:docker#installation|Installez Docker et Docker Compose]].

[[#comment_ouvrir_un_terminal|Ouvrez ensuite un nouveau terminal]] et assurez-vous d'être placé dans votre répertoire personnel, puis créez un répertoire qui contiendra la configuration et la base de données de **Jellyfin** :
<code>mkdir jellyfin</code>

On créé ensuite un fichier ''docker-compose.yml'' (ici avec l'éditeur [[:nano]]) :
<code>nano docker-compose.yml</code>

Ce fichier contiendra la configuration du container ''jellyfin'' pour Docker :
<file - docker-compose.yml>services:
  jellyfin:
    image: jellyfin/jellyfin
    ports:
    - '8096:8096'
    volumes:
    - /home/utilisateur_courant/jellyfin:/config
    - /home/utilisateur_courant/Vidéos:/media
    environment:
    - UID=1000
    - GID=1000
    restart: always</file>
Ce contenu est à adapter :
  * remplacez ''utilisateur_courant'' par votre nom d'utilisateur
  * et éventuellement ''/home/utilisateur_courant/Vidéos'' par le chemin de votre médiathèque.
  * on peut aussi choisir un autre port que le port ''8096'', il suffit de remplacer le premier numéro de la ligne ''- '8096:8096%%'%%''.
Par ex. :
<file>- '80:8096'</file>
  * ''UID'' et ''GID'' correspondent respectivement aux ID de l'utilisateur courant et de son groupe principal. Sur Ubuntu si vous n'avez qu'un utilisateur il s'agit très probablement de ''1000'' / ''1000''. Vous pouvez vous assurer de cela avec la commande :
<code>id</code>

<note tip>D'une manière générale avec [[:Docker]] pour les ''ports'', ''volumes'' et ''devices'', on spécifie à gauche l'élément de la machine hôte (par ex. le port ou le chemin local qu'on souhaite utiliser), puis '':'', puis à droite l'élément qui lui correspondra dans le container (en général on ne le personnalise pas, cela dépend de l'image Docker qu'on utilise : ici ''8086'', ''/config'' et ''/media'').</note>

Sauvegardez et quittez (''Ctrl''+''O'' puis ''Ctrl''+''X'' avec [[:nano]]).

Vous pouvez dès lors installer **Jellyfin** et le lancer en une commande :
<code>sudo docker compose up</code>

**Jellyfin** est alors disponible à l'adresse [[http://localhost:8096]].

Lors du premier accès, un guide d'installation (//wizard//) s'affiche, grâce auquel vous pouvez paramétrer votre serveur pas à pas :
  * choisissez par exemple //French// comme //Preferred display language//, puis cliquez sur //Next//
  * choisissez ensuite un nom d'utilisateur
  * puis ajoutez une nouvelle bibliothèque par ex. //Movies// pour des films, dans laquelle vous pouvez ajouter le //Folder// ''/media'' (tel que défini dans la colonne de droite du volume correspondant dans le fichier ''docker-compose.yml'' créé précédemment)
  * choisissez d'obtenir les //metadata// en //French// dans //Preferred metadata language//.
  * //ok// puis //Next//, choisissez les langues et pays préférés par défaut pour les //metadata//.
  * Mieux vaut désactiver l'[[:UPnP]] dans un premier temps.

==== Dépôts APT Ubuntu ====

L'équipe de **Jellyfin** fournit un dépôt pour l'installation sur Ubuntu. Les architectures prises en charge sont amd64, arm64 et armhf.
Cette équipe propose aussi [[https://jellyfin.org/docs/general/installation/linux/|un script]] qui automatise toute la procédure d'installation.

<note>**Jellyfin** n'est pas pris en charge sur l'architecture i386 (processeurs 32 bit).</note>

  * Activer HTTPS pour APT :
<code>sudo apt install apt-transport-https</code>

  * Activer le dépôt Univers pour certaines dépendances :
<code>sudo add-apt-repository universe</code>

  * Importer la clé signée par l'équipe Jellyfin :
<code>wget -O - https://repo.jellyfin.org/ubuntu/jellyfin_team.gpg.key | sudo apt-key add -</code>

  * Ajouter le dépôt dans ''/etc/apt/sources.list.d/jellyfin.list'' :
<code>echo "deb [arch=$( dpkg --print-architecture )] https://repo.jellyfin.org/ubuntu $( lsb_release -c -s ) main" | sudo tee /etc/apt/sources.list.d/jellyfin.list</code>

  * Mettre à jour les dépôts :
<code>sudo apt update</code>

  * Installer **Jellyfin** :
<code>sudo apt install jellyfin</code>

===== Utilisation =====

==== Nativement ====

**Jellyfin** est accessible par son Interface Web à l'adresse [[http://locahost:8096]].

Suivez l'assistant de configuration initiale. Il vous permettra, entre autre, de choisir la langue par défaut des métadonnées et d'importer votre bibliothèque.
Selon le nombres de fichiers à scanner, cela peut prendre du temps la première fois pour que **Jellyfin** récupère toutes les métadonnées.

Le [[:DLNA]] est activé par défaut et votre bibliothèque devrait être vu sur votre réseau.

**Jellyfin** est installé en tant que service système. Vous n'avez rien à lancer manuellement. Les commandes suivantes peuvent toutefois vous être utiles dans certains cas :
<code>sudo service jellyfin status</code>
<code>sudo service jellyfin stop</code>
<code>sudo service jellyfin start</code>
 
Après certaines modifications via une [[:console]] :
<code>sudo service jellyfin restart</code>

==== via Docker ====

**Jellyfin** est disponible à l'adresse [[http://localhost:8096]].

Après l'installation vous pouvez démarrer ou arrêter le service avec ''sudo docker compose start jellyfin'' et ''sudo docker compose stop jellyfin''.\\ 
Si vous modifiez le fichier ''docker-compose.yml'', utilisez plutôt ''sudo docker compose up'' et ''sudo docker compose down''.

Un menu sandwich ''☰'' en haut à gauche donne accès à la gestion du serveur et au gestionnaire de métadonnées.

Vous pouvez ajouter plusieurs répertoires de médias depuis ce menu -> //Gérer le serveur// -> //Médiathèque//.
<note>
Attention si vous utilisez **[[:Docker]]**, et que votre médiathèque est dispersée sur votre ou vos stockages locaux : vous devez faire correspondre chaque répertoire local à un répertoire dans le container, qui sera visible par **Jellyfin** (depuis un container, **Jellyfin** n'a pas accès à l'arborescence de l'hôte). Par ex. :
<file - docker-compose.yml>    volumes:
    - /home/utilisateur_courant/jellyfin:/config
    - /mnt/usb/media/Vidéos:/media/Vidéos
    - /home/utilisateur_courant/Musique:/media/Musique</file>
Dans cette configuration les répertoires de médiathèques à indiquer à **Jellyfin** seront ''/media/Vidéos'' et ''/media/Musique''.
</note>

===== Accélération matérielle =====

**Jellyfin** prend en charge l'accélération matérielle pour du transcodage vidéo à l'aide de FFmpeg. Il prend en charge plusieurs types d'accélération, AMD AMF, Intel Quick Sync, OpenMax OMX, nVidia NVENC, Intel/AMD VAAPI ...

Les options d'accélération matérielle se trouvent dans le panneau d'administration sous la section //Transcodage//. Sélectionnez une option d'accélération matérielle dans le menu déroulant, indiquez un périphérique si besoin, et cochez //Activer l'encodage matériel//.

L'accélération matérielle est disponible immédiatement pour la lecture multimédia. Aucun redémarrage du serveur n'est requis.

Chaque type d'accélération matérielle, ainsi que chaque type d'installation **Jellyfin**, nécessite différentes options de configuration avant de pouvoir être utilisé.

==== Méthode VA API ====

Avant d'activer cette fonction, veuillez lire le sujet [[:vaapi|VA API]] de la documentation.
  
[[:tutoriel:comment_installer_un_paquet|Installer le paquet]] ''[[apt>mesa-utils]]'' puis vérifier que l'accélération graphique est bien supportée :
<code>sudo apt install mesa-utils</code>
<code>glxinfo | grep "direct rendering"</code>
Cela devrait retourner ''direct rendering: Yes''.

Vérifier quel groupe est disponible pour le périphérique ''render'' :
<code>ls -l /dev/dri</code> 

Vous devriez voir une ligne du type :
<code>crw-rw----+ 1 root video 226, 128 juin  21 15:11 renderD128</code>
Le groupe dans cet exemple est ''video''.

Ajouter l'utilisateur du service à ce groupe pour permettre au processus ''jellyfin-ffmpeg'' d'accéder au périphérique :
<code>sudo usermod -aG video jellyfin</code>

Relancer ''jellyfin'' :
<code>sudo systemctl restart jellyfin</code>

===== Clients =====

On peut utiliser n'importe quel navigateur web pour accéder à du contenu sur **Jellyfin**, mais les formats et codecs disponibles dépendent du navigateur.

La liste des clients existants ou en développement est disponible [[https://jellyfin.org/downloads/clients/|ici]].

==== Jellyfin Media Player ====

Pour Ubuntu il existe en particulier **[[https://github.com/jellyfin/jellyfin-media-player|Jellyfin Media Player]]**, disponible sur Linux, macOS et Windows. Pour l'installer sur Ubuntu le plus simple est d'[[[:tutoriel:installer_application_flatpak|installer le flatpak]] ''[[https://flathub.org/apps/details/com.github.iwalton3.jellyfin-media-player|com.github.iwalton3.jellyfin-media-player]]'' depuis [[https://flathub.org/apps/details/com.github.iwalton3.jellyfin-media-player|Flathub]]. Contrairement à un navigateur web de très nombreux formats sont lisibles nativement, et il n'est donc pas nécessaire de réencoder à la volée côté serveur (ce qui est très gourmand en ressources).

==== Général ====

On peut aussi noter :
  * une [[https://github.com/jellyfin/jellyfin-kodi|extension]] pour **[[:Kodi]]** qui permet de remplacer complètement son contenu.
  * une [[https://github.com/jellyfin/jellyfin-android|application pour Android]] disponible [[https://repo.jellyfin.org/releases/client/android/|ici]].
  * une [[https://github.com/jellyfin/jellyfin-androidtv|application pour AndroidTV]] disponible [[https://repo.jellyfin.org/releases/client/androidtv/|là]].
  * **[[https://flathub.org/apps/details/com.github.iwalton3.jellyfin-mpv-shim|Jellyfin MPV Shim]]**, basé sur le lecteur libre [[https://mpv.io/|MPV]], ancêtre de Jellyfin Media Player.

==== Musique ====

On trouve aussi des clients spécifiquement dédiés à la musique :
  * **[[https://github.com/jeffvli/feishin|Feishin]]** disponible sur Windows, Mac OS et Linux (donc Ubuntu) au format [[:AppImage]] sur [[https://github.com/jeffvli/feishin/releases/tag/v0.0.1-alpha6|cette page]].
  * **[[https://f-droid.org/fr/packages/com.unicornsonlsd.finamp/|Finamp]]** sur Android.
  * **[[https://f-droid.org/fr/packages/nl.moeilijkedingen.jellyfinaudioplayer/|Fintunes]]** sur Android.
  * **[[https://f-droid.org/fr/packages/com.dkanada.gramophone/|Gelli]]** sur Android.

===== Voir aussi =====

  * (//en//) [[https://jellyfin.org/|site officiel]]
  * (//en//) [[https://github.com/jellyfin/jellyfin|GitHub]]
  * (//en//) [[https://jellyfin.org/docs/|documentation officielle]]
  * [[wpfr>Jellyfin|page Wikipedia]]
  * Autres [[:multimedia#serveurs multimédia]]

----

//Contributeurs : [[:utilisateurs:krodelabestiole]], [[:utilisateurs:stylou]]//