MediaLab Marketplace pour Jellyfin — guide d’installation et d’utilisation

Produit gratuit sur medialab.works. Installez, mettez à jour, désinstallez et revenez à une version précédente de tous les plugins MediaLab couverts par la licence du serveur, depuis un seul endroit. Mise à jour automatique la nuit (04:00 par défaut) et redémarrage automatique uniquement lorsque personne ne regarde.

Prérequis

Emby Server 4.10.1+ ou Jellyfin 12.x / medialab Server.
La clé de licence du serveur (le pack MediaLab — la même clé qui active les autres plugins).
L’accès au tableau de bord d’administration du serveur.

Installation depuis le terminal

Linux (Emby)

# 1. Téléchargez la DLL (depuis votre compte medialab.works → produit MediaLab Marketplace, ou via le lien signé)
#    Exemple avec la clé de licence (remplacez <RELEASE_ID> et <KEY>) :
curl -fL -o /tmp/MediaLabMarketplace.dll \
  "https://medialab.works/api/license/catalog/download/<RELEASE_ID>/<KEY>"

# 2. Vérifiez la somme de contrôle (elle figure sur la page de la version)
sha256sum /tmp/MediaLabMarketplace.dll

# 3. Copiez dans le dossier des plugins et redémarrez Emby (quand personne ne regarde)
sudo install -o emby -g emby -m 644 /tmp/MediaLabMarketplace.dll /var/lib/emby/plugins/
sudo systemctl restart emby-server
sudo systemctl status emby-server --no-pager

Linux (Jellyfin / medialab Server)

# Jellyfin s’installe depuis un zip, dans son propre dossier (NE le nommez PAS comme la DLL !)
curl -fL -o /tmp/jf-marketplace.zip \
  "https://medialab.works/api/license/catalog/download/<RELEASE_ID>/<KEY>"
sudo mkdir -p "/var/lib/jellyfin/plugins/MediaLab Marketplace_<version>.0"
sudo unzip -o /tmp/jf-marketplace.zip -d "/var/lib/jellyfin/plugins/MediaLab Marketplace_<version>.0"
sudo chown -R jellyfin:jellyfin "/var/lib/jellyfin/plugins/MediaLab Marketplace_<version>.0"
sudo systemctl restart jellyfin
sudo systemctl status jellyfin --no-pager

Sur le conteneur mlprod (medialab Server), le chemin est celui du conteneur ; les mises à jour se font depuis la page du plugin ou depuis le gestionnaire de mises à jour du système.

Windows (Emby) — PowerShell en administrateur

# 1. Téléchargez la DLL dans le dossier temporaire
Invoke-WebRequest -Uri "https://medialab.works/api/license/catalog/download/<RELEASE_ID>/<KEY>" `
  -OutFile "$env:TEMP\MediaLabMarketplace.dll" -UseBasicParsing

# 2. Vérifiez sha256 (comparez avec celui de la page de la version)
Get-FileHash "$env:TEMP\MediaLabMarketplace.dll" -Algorithm SHA256

# 3. Copiez dans le dossier des plugins Emby et redémarrez le service
Copy-Item "$env:TEMP\MediaLabMarketplace.dll" "C:\ProgramData\Emby-Server\programdata\plugins\" -Force
Get-Service "Emby Server" | Restart-Service
Get-Service "Emby Server"

Windows (Jellyfin) — PowerShell en administrateur

# Jellyfin : décompressez le zip dans un nouveau dossier sous plugins
$dest = "C:\ProgramData\Jellyfin\Server\plugins\MediaLab Marketplace_<version>.0"
Expand-Archive -Path "$env:TEMP\jf-marketplace.zip" -DestinationPath $dest -Force
Get-Service "JellyfinServer" | Restart-Service
Get-Service "JellyfinServer"

Si le service porte un autre nom, vérifiez-le avec Get-Service | Where-Object DisplayName -like "*Emby*" ou Get-Service | Where-Object DisplayName -like "*Jellyfin*".

Utilisation

Ouvrez le tableau de bord d’administration → MediaLab Marketplace.
Collez la clé de licence (du pack) et cliquez sur Enregistrer. La clé est stockée chiffrée, jamais en clair.
Cliquez sur Recharger le catalogue : vous voyez tous les plugins couverts par la licence, la version installée et la plus récente.
Installer / Mettre à jour / Revenir (rollback) / Désinstaller depuis les boutons de chaque ligne.
Mise à jour automatique : à 04:00 par défaut, uniquement les versions stables, par plugin (interrupteur sur chaque ligne). Le serveur ne redémarre que lorsque personne ne regarde ; si un plugin ne se charge pas après le redémarrage, il revient seul à la version précédente.
L’historique de la page du plugin indique ce qui a été ajouté et quelle version est installée.

Avant de placer un fichier, le Marketplace vérifie son SHA-256 et la signature MediaLab avec la clé incluse dans le plugin. Un fichier qui échoue à la vérification est refusé.

Dépannage

« Le catalogue n’a pas pu être chargé » / HTTP 403 : la requête vers la plateforme (POST /api/license/catalog) est bloquée par Cloudflare ; cela se règle par une exception WAF sur la plateforme (pas sur votre serveur). Si le problème persiste, envoyez au support cf-ray et le User-Agent.
Le plugin n’apparaît pas après la copie : vérifiez le propriétaire du fichier (emby/jellyfin), le bon chemin, puis redémarrez le service.
Windows : utilisez PowerShell en administrateur ; le dossier Emby est C:\ProgramData\Emby-Server\programdata\plugins, celui de Jellyfin C:\ProgramData\Jellyfin\Server\plugins.
« Non couvert » : la clé est valide mais ne couvre aucun plugin MediaLab, ou ce plugin n’en fait pas partie. Vérifiez la licence dans votre compte.
« Non activé » : l’id du serveur ne correspond à aucune activation de la clé ; ouvrez la page Licence d’un plugin installé et activez-la une fois avec la même clé.
Le téléchargement échoue : le lien signé expire après 30 minutes ; cliquez à nouveau sur Recharger le catalogue pour en obtenir un nouveau.
Un fichier est refusé après le téléchargement : le SHA-256 ou la signature ne correspondent pas ; réessayez et, si cela persiste, contactez le support.