Jellyfin : activer le transcodage matériel

Le transcodage matériel délègue l’encodage vidéo au GPU, réduisant fortement la charge CPU.

Prérequis

• GPU compatible (Intel Quick Sync, AMD VAAPI ou NVIDIA NVENC).
• Pilotes et /dev/dri (VAAPI) ou runtime NVIDIA (NVENC) accessibles au serveur.

1. Exposer le périphérique

Pour un conteneur Docker en VAAPI :

docker run -d --name jellyfin \
  --device /dev/dri:/dev/dri \
  -p 8096:8096 jellyfin/jellyfin

Vérifier l’accès au rendu :

ls -l /dev/dri/renderD128

2. Activer dans Jellyfin

Tableau de bord → Lecture → Transcodage :

Accélération matérielle : Video Acceleration API (VAAPI)
Périphérique VA-API     : /dev/dri/renderD128
Activer le décodage matériel : H264, HEVC

Pour NVIDIA, choisir NVIDIA NVENC.

3. Sauvegarder

Cliquer Enregistrer. Le changement est immédiat.

Vérification

Lancer une lecture forçant un transcodage (changer la qualité). Tableau de bord → Lecture active indique Transcodage (matériel). Côté hôte :

intel_gpu_top

L’occupation Video augmente pendant la lecture.

Dépannage

• Transcodage (logiciel) persistant : le périphérique n’est pas exposé ou les pilotes manquent.
• Image verte/corrompue : désactiver le décodage HEVC matériel si le GPU ne le supporte pas.
• Permission refusée : ajouter l’utilisateur du service au groupe render ou video.