Jellyfin

Jellyfin est un serveur multimédia. Il s'agit d'un fork de 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 IMDb et 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 dépôts d'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.

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 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.¹⁾
• Le serveur Jellyfin est aussi disponible en flatpak, pour les architectures x86_64 et aarch64, sur le dépôt Flathub et peut donc s'installer en suivant cette procédure puis en installant le paquet org.jellyfin.JellyfinServer.

Jellyfin est disponible en image Docker sur Docker Hub.

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

Pour commencer, Installez Docker et Docker Compose.

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 :

mkdir jellyfin

On créé ensuite un fichier docker-compose.yml (ici avec l'éditeur nano) :

nano docker-compose.yml

Ce fichier contiendra la configuration du container jellyfin pour Docker :

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

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. :

- '80:8096'

• 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 :

id

Sauvegardez et quittez (Ctrl+O puis Ctrl+X avec nano).

Vous pouvez dès lors installer Jellyfin et le lancer en une commande :

sudo docker compose up

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.

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 un script qui automatise toute la procédure d'installation.

• Activer HTTPS pour APT :

sudo apt install apt-transport-https

• Activer le dépôt Univers pour certaines dépendances :

sudo add-apt-repository universe

• Importer la clé signée par l'équipe Jellyfin :

wget -O - https://repo.jellyfin.org/ubuntu/jellyfin_team.gpg.key | sudo apt-key add -

• Ajouter le dépôt dans /etc/apt/sources.list.d/jellyfin.list :

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

• Mettre à jour les dépôts :

sudo apt update

• Installer Jellyfin :

sudo apt install jellyfin

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 :

sudo service jellyfin status

sudo service jellyfin stop

sudo service jellyfin start

Après certaines modifications via une console :

sudo service jellyfin restart

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.

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é.

Avant d'activer cette fonction, veuillez lire le sujet VA API de la documentation.

Installer le paquet mesa-utils puis vérifier que l'accélération graphique est bien supportée :

sudo apt install mesa-utils

glxinfo | grep "direct rendering"

Cela devrait retourner direct rendering: Yes.

Vérifier quel groupe est disponible pour le périphérique render :

ls -l /dev/dri

Vous devriez voir une ligne du type :

crw-rw----+ 1 root video 226, 128 juin  21 15:11 renderD128

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 :

sudo usermod -aG video jellyfin

Relancer jellyfin :

sudo systemctl restart jellyfin

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 ici.

Pour Ubuntu il existe en particulier Jellyfin Media Player, disponible sur Linux, macOS et Windows. Pour l'installer sur Ubuntu le plus simple est d'installer le flatpak com.github.iwalton3.jellyfin-media-player depuis 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).

On peut aussi noter :

• une extension pour Kodi qui permet de remplacer complètement son contenu.
• une application pour Android disponible ici.
• une application pour AndroidTV disponible là.
• Jellyfin MPV Shim, basé sur le lecteur libre MPV, ancêtre de Jellyfin Media Player.

On trouve aussi des clients spécifiquement dédiés à la musique :

• Feishin disponible sur Windows, Mac OS et Linux (donc Ubuntu) au format AppImage sur cette page.
• Finamp sur Android.
• Fintunes sur Android.
• Gelli sur Android.

• (en) site officiel
• (en) GitHub
• (en) documentation officielle
• page Wikipedia
• Autres serveurs multimédia

Contributeurs : krodelabestiole, stylou