Plex on Zwindler's Reflection

Installer plex sur TrueNAS (SCALE)

Fri, 10 May 2024 18:00:00 +0200

Cet article fait partie d’une série dans laquelle je parle de mon nouveau NAS que j’ai construit moi-même :

Plex sur mon NAS

Un des prérequis quand je construis / achète un NAS, c’est la possibilité d’installer dessus Plex Media Server.

D’expérience, même s’il est possible d’avoir une VM sur un hyperviseur à côté qui gère la médiathèque “à côté” du NAS, ou même de déléguer ce rôle “serveur plex” à la box de l’opérateur ou même notre smartTV, c’est souvent plus pénible qu’autre chose :

je n’ai pas toujours un hyperviseur allumé à la maison et monté la médiathèque sur Internet est hors de question
le volume partagé qui héberge les médias entre le NAS et la VM peut sauter, et c’est pénible à debug / corriger quand ça arrive
les box / smartTV sont souvent trop limitées en hardware (espace disque pour les apps, CPU rachitique, RAM insuffisante…)
je change de box opérateur plus souvent que de NAS

Note : je suis certain qu’on ne sera pas d’accord avec moi sur certains de ces points, et c’est OK. Moi, je trouve que c’est mieux comme ça, mais vous faites bien comme vous voulez ;-P.

J’ai donc envie d’avoir Plex sur mon NAS et de ne pas trop m’embêter pour la gestion au quotidien.

Les “apps” dans TrueNAS

Et ça tombe plutôt bien, car nos amis de chez TrueNAS maintiennent à jour une application Plex pour TrueNAS. Sauf que sur le papier, elle est pas hyper simple à installer, d’où cet article pour vous guider ;-).

Tout cet article part du principe que vous utilisez TrueNAS SCALE et pas TrueNAS Core.

Si vous ne connaissez pas la différence, le mieux est que vous alliez voir par vous-même la documentation officielle - compare TrueNAS software.

TL;DR TrueNAS Core, c’est la version historique basée sur FreeBSD (qui s’appelait d’ailleurs FreeNAS, initialement). Cependant, depuis quelques années, iXsystems, l’entreprise qui développe TrueNAS, met à disposition une version basée sur Debian (donc GNU/Linux).

Pour des raisons que j’expliciterai dans l’article sur le choix du software (oui je viens donc de vous spoiler l’article suivant), j’ai TrueNAS SCALE et pas Core.

Pour faire tourner les “apps”, TrueNAS s’est appuyé sur un standard du marché : Kubernetes. Et oui, n’en déplaise à ses détracteurs, Kubernetes est devenu un standard du marché. Ca ne dit pas si c’est une bonne chose (on peut juger le précédent standard, aka VMware, à l’aune de l’actualité, par exemple). Mais c’est juste un fait.

Activer les apps

Par défaut, TrueNAS n’active pas les “apps”. Ca va être à nous de le faire. En soit, ce n’est pas forcément un mal : si vous n’en avez pas besoin aucune raison de consommer des ressources pour rien.

Et quand on parle de consommation de ressources et de Kubernetes je vois déjà les gens dans le fond qui font les gros yeux. Rassurez-vous (pas sûr que ça vous rassure, mais moi oui), les équipes d’iXsystems ont eu la sagesse de choisir k3s et non un kubernetes vanilla pour héberger Kubernetes sur notre NAS. Les ressources consommées par le control plane seront donc minimales (quelques centaines de Mo au max).

On va donc dans l’onglet “Apps” et on active k3s en l’installant simplement sur un de nos pools. Dans mon cas, j’en ai deux. Un avec mes disques durs classiques, et un avec un (unique) SSD.

Initialement j’avais installé le k3s sur le pool de HDDs, histoire de mutualiser le stockage et de maximiser la disponibilité (j’ai un RAID-Z1). Cependant, le k3s de TrueNAS a tendance à écrire pas mal sur les disques, qui se retrouvaient à gratouiller sous mon bureau pendant une demie seconde toutes les 5 secondes environ. Très énervant.

J’ai donc recréé un pool spécial pour les apps sur un SSD que j’avais en rab.

On clique sur Settings en haut à droite, puis Choose Pool

Installer plex media server via les apps

Au bout de quelques secondes / minutes, k3s est installé et on peut commencer à chercher une app parmi le catalogue (>100). Ici on recherche plex et on clique sur Install

A partir de là, une fenêtre avec plein de paramètres va apparaitre. Mais avant d’aller plus loin, on va aller sur la page www.plex.tv/claim/. Une fois loggué sur votre compte, la page va vous générer un token temporaire, qui va permettre de relier directement le serveur une fois qu’il aura démarré sur votre NAS avec votre compte. Pratique !

Dans la looongue page de configuration, on a que quelques paramètres à changer. D’abord, il faut renseigner le token qu’on vient de générer dans la section Plex Configuration. Si vous avez le Plex pass, vous pouvez aussi changer Image :

Ensuite, dans la partie Storage configuration, il va falloir indiquer le chemin vers le pool qui contient les médias. Moi c’est /mnt/rpool/tank/Vidéos. rpool est le nom de mon pool RAID-Z1, tank est mon volume principal.

Attention : assurez-vous que l’utilisateur unix (local) “apps” a bien accès en lecture/exécution sur toute l’arborescence, sinon vous ne verrez pas le dossier quand Plex sera lancé (très frustrant, il n’y a aucun message d’erreur, juste “rien”).

De manière optionnelle, vous pouvez tuner les “limits” (au sens docker/kubernetes du terme) de votre app. Par défaut, la chart plex de TrueNAS propose 4 CPUs et 8 Go de RAM, ce qui est beaucoup. Mon plex ne consomme que 100 Mo au repos. J’ai baissé à 2 CPUs (avec un risque de throttling, mais là on rentre dans des notions un peu tricky de Kubernetes que je préfère esquiver aujourd’hui dans cet article) et 4 Gio de RAM (j’en ai 16 mais je veux garder le plus de cache possible).

Une fois terminé, l’application se déploie, puis affiche Running. On a alors un cartouche Application Info dans Details qui devrait afficher un bouton Web Portal qui devrait nous rediriger sur l’IP de notre NAS sur le port 32400 (celui habituel de plex).

On peut donc se laisser guider par le wizard de configuration de Plex Media Server, lui donner un nom mignon et aller chercher nos médiathèques dans /data. Normalement, le dossier que vous avez donné lors de l’étape Storage configuration devrait apparaitre.

Bonus

Pour une raison que j’ignore (peut être parce que c’est un container avec un adressage à part), j’ai dû explicitement indiquer le port public (32400 sur ma box, qui redirige sur l’IP de mon NAS et le port 32400) pour que le Control à distance fonctionne et que l’accès direct (sur le réseau local) fonctionne correctement.

Erreur dans l’ordre des épisodes dans Plex (Aired vs DVD order)

Tue, 01 Aug 2017 11:30:42 +0000

« J’ai un problèèèèèmeuh »

J’ai un problème (dramatique) sous Plex Media Server (PMS) avec la séries The Powerpuff girls (Les Super Nanas). En réalité, j’en ai même deux…

1er problème : l’ordre des premiers épisodes ne colle pas

Lorsque je me suis mis à re-regarder les Powerpuff Girls, j’ai remarqué que le premier épisode n’avait aucun rapport avec le titre de l’épisode affiché dans Plex.

Le premier épisode que j’ai lancé aurait du contenir, selon Plex, « Monkey See, Doggie Do ». Or, après lecture, je me suis rendu compte qu’il s’agissait d’en fait un double épisode contenant « Insect Inside » et « Powerpuff Bluff ». Rien à voir.

En gros :

Selon Plex, on a S01E01 « Monkey See, Doggie Do » et S01E02 « Mommy Fearest »
En réalité, ces deux épisodes sont contenus dans le S01E02, tandis que le VRAI S01E01 contient « Insect Inside » et « Powerpuff Bluff ».

Le problème vient visiblement de ma série source, dont l’ordre ne correspond pas avec le référentiel de Plex.

Je me suis rappelé que la source de Plex vient pour mes séries du site TheTVDB.com. Voilà ce qu’on voit quand on affiche la page des Powerpuff Girls :

Jusque là c’est logique, les épisodes sont bien identiques à ce que m’affiche Plex.

Mais ça n’explique pas pourquoi ma série n’a pas le même ordre que TheTVDB !

2ème problème : Un fichier = 2 épisodes

J’ai déjà un peu abordé le 2ème dans le paragraphe précédent. Vous l’aurez surement compris, la série Powerpuff Girls est une série dont les épisodes sont doubles. Un même fichier (par ex. S02E03) contient donc 2 sous épisodes, chacun ayant son propre titre et son propre résumé.

Or, malheureusement, Plex ne semble pas comprendre qu’un seul fichier peut contenir plus d’un épisode, ce qui induit un décalage (au delà de l’ordre qui est mauvais, cf le premier problème).

1er contournement (pour le 2ème problème)

Ça ne règle pas le premier problème, mais dans Plex il est possible d’indiquer qu’un fichier contient 2 épisodes : renommer en maserie_s01e01-e02 (ou s01e01-s01e02, la syntaxe est floue et les retours sont parfois erratiques selon le forum de Plex).

Après rescan de la bibliothèque, les deux épisodes apparaissent bien dans Plex.

Cependant cette technique est tout sauf optimale ! Les deux épisodes sont bien visibles mais ne sont pas « liés ». Bien qu’il n’y ait qu’un seul fichier contenant 2 épisodes, Plex traite ce fichier comme 2 fichiers !

Quand vous aurez fini de voir le premier, Plex vous proposera de lancer le second (qu’il considérera comme « Non vu ») et relancera le même fichier… Pas top.

« DVD order » versus « Aired date order »

En réalité ce problème est connu. Il apparaît souvent dans des séries de type dessins animés (à quelques exceptions notables comme Firefly, a priori).

Un petit retour sur TVDB permet de se rendre compte qu’il existe parfois, pour une même série, des ordres et des découpages différents entre ce qui a été diffusé à la TV et le DVD de la série !

Ces deux ordres sont renseignés dans TVDB sous l’appellation « Aired Order » et « DVD Order ». Malheureusement, le plugin TVDB officiel de Plex ne semble pas prendre en compte le DVD Order et cela explique les divergences qu’on retrouve dans notre bibliothèque.

Installation de l’agent

Comme le problème est connu depuis longtemps, un personne a modifié le plugin officiel de Plex pour TVDB et l’a adapté pour proposer à la main de modifier une séries pour qu’elle prenne en compte le « DVD order ».

Malheureusement, l’auteur du script ne semble plus le maintenir et ça ne fonctionne plus « out of the box ».

Récupérer la dernière version

La dernière version est cachée au milieu des commentaires. Vous pouvez la télécharger directement sur ce lien qui pointe vers le bon commentaire :

forums.plex.tv/discussion/comment/652345/#Comment_652345

Installer le module

Personnellement, je n’avais aucune idée de comment installer un module (Plex App) dans PMS. C’est quelque chose qu’on ne fait jamais car l’appli se suffit à elle même (je trouve), contrairement à Kodi qui lui met en avant un magasin d’extension par exemple.

Comme je suis sympa je vous donne les commandes que j’ai tapé sur la machine qui héberge mon PMS :

cd '/var/lib/plexmediaserver/Library/Application Support/Plex Media Server/Plug-ins/'
sudo wget https://us.v-cdn.net/6025034/uploads/ipb/monthly_05_2014/DVD%20Order%20Agent.bundle.zip
sudo unzip DVD\ Order\ Agent.bundle.zip
sudo mv DVD\ Order\ Agent.bundle DVDorder.bundle
sudo chown -R plex:plex DVDorder.bundle/
/var/lib/plexmediaserver/Library/Application Support/Plex Media Server/Plug-ins$ ll
total 16
drwxr-xr-x 4 plex plex 4096 juin 4 14:32 ./
drwxr-xr-x 12 plex plex 4096 juin 4 14:34 ../
drwxr-xr-x 3 plex plex 4096 déc. 16 2010 DVDorder.bundle/
drwxr-xr-x 3 plex plex 4096 mai 7 17:51 Services.bundle/
sudo systemctl restart plexmediaserver.service

Voici les sujets que j’ai consultés pour trouver la solution à ce problème (car un bon ENSEIRBien cite toujours ses sources).

Une fois que c’est fait, il faut ensuite se connecter sur Plex depuis un navigateur avec le compte lié au serveur Plex, pour configurer (activer) le module.

Activer le DVD Order ?

A partir de là, j’étais assez content de moi et je me suis dis : « Chouette, ça va marcher maintenant. » Et ben non…

Voici ce que j’ai tenté :

Sur la vignette des Powerpuff Girls, [petit crayon]

Sur la ligne « Episode ordering », passer à « DVD order »

Ça ne marche pas !

Même après modification, enregistrement, rescan de la librairie… rien n’y fait. L’ordre de mes épisodes n’a pas changé.

Du coup, je me suis dis que c’était peut être un conflit entre sources. Habituellement, lorsqu’un film ou une série est mal détectée par Plex (et que ce n’est pas de la faute d’un mauvais nommage du fichier), on peut forcer l’association pour imposer la bonne version.

Typiquement, j’ai eu l’exemple avec « Kung Fu Panda (2008) » qui était par erreur (j’ignore pourquoi) détecté comme le 3ème opus.

Pour en revenir à mon cas, j’ai donc tenté de forcer l’association en utilisant l’agent TheTVDBdvdorder.

Et c’est comme ça que j’ai trouvé mon erreur. L’agent ne trouve aucune information, et l’association automatique bascule donc sur l’Aired Order !

Le fix de la mort

A partir de cette erreur, j’ai rapidement pu trouver des gens qui ont débugué le plugin.

https://forums.plex.tv/discussion/21141/dvd-order-agent/p18

Il faut modifier le code source du fichier __init__.py pour commenter deux vieilles URL qui ne répondent plus, et les remplacer par trois autres.

cd "/var/lib/plexmediaserver/Library/Application Support/Plex Media Server/Plug-ins/DVDorder.bundle/Contents/Code"
cp __init__.py __init__.py.ori
vi __init__.py
#TVDB_GUID_SEARCH = freebase.plexapp.com/tv/guid/
#TVDB_QUICK_SEARCH = freebase.plexapp.com/tv/names/
TVDB_GUID_SEARCH = http://meta.plex.tv/tv/guid/
TVDB_QUICK_SEARCH = http://meta.plex.tv/tv/names/
TVDB_TITLE_SEARCH = http://meta.plex.tv/tv/titles/
sudo systemctl restart plexmediaserver.service

Taaaadaaaa : Après redémarrage, les 2 problèmes ont été résolus d’un seul coup !!!

Bonus : On a perdu la musique de générique

Bon, bien sûr ça ne pouvait pas fonctionner à 100%…

Par défaut, PMS lance un extrait de la musique de générique d’une série quand on arrive sur la page de cette série. C’est vraiment très sympa (même si ça peut paraître gadget dit comme ça).

Et oui… en ajoutant le TVDBdvdorder nous avons cassé un autre plugin et nous devons donc continuer notre petite séance de hacking !

Dans son post, jooniloh parle d’un plugin PlexThemeMusic.

Nevermind! Figured it out. Did not see the bit about editing PlxThemeMusic.bundle’s __init__.py earlier.

jooniloh

Cependant ce plugin, comme le dit l’auteur, n’en est plus un. C’est maintenant une fonction intégrée qu’il faut donc aller chercher dans les ressources de PMS (ici 995fidead est ma version, la dernière à l’heure où j’écris ces lignes) et non plus dans le dossier Plex Media Server/Plug-ins.

Vous pouvez retrouver ce dossier de la façon suivante :

locate PlexThemeMusic.bundle
/usr/lib/plexmediaserver/Resources/Plug-ins-995f1dead/PlexThemeMusic.bundle

On garde une copie du fichier source pour plus de sécurité

cd '/usr/lib/plexmediaserver/Resources/Plug-ins-995f1dead/PlexThemeMusic.bundle/Contents/Code'
sudo cp __init__.py __init__.py.ori

On créé un patch et on l’applique

sudo echo "41,42c41,42
<   def update(self, metadata, media, lang, force=False):
<     if force or THEME_URL % metadata.id not in metadata.themes: --- >   def update(self, metadata, media, lang):
>     if THEME_URL % metadata.id not in metadata.themes:" > __init__.py.patch
patch __init__.py __init__.py.patch
patching file __init__.py
sudo systemctl restart plexmediaserver.service

Si vous voyez où je me suis trompé, je suis preneur !