À faire une fois, par l’administrateur du serveur Jellyfin. Les personnes qui utilisent Sillon sur ce serveur n’ont rien à installer.
Ce que fait le plugin
Demandes d’albums
Depuis l’app, chacun demande les albums qui manquent sur le serveur. Avec Lidarr, le plugin les y ajoute et suit chaque demande jusqu’à ce que l’album soit dans votre bibliothèque.
Notifications
Quand l’album demandé est disponible, le plugin l’ajoute aux favoris de la personne et la prévient sur son téléphone.
Facultatif
La lecture et la navigation dans votre bibliothèque fonctionnent sans le plugin. Il n’ajoute que les demandes et les notifications.
Ce qu’il vous faut
Un serveur Jellyfin 12.2 ou plus récent (le plugin vise targetAbi 12.2.0.0).
Un compte administrateur sur ce serveur.
Pour que les demandes soient traitées automatiquement : Lidarr (facultatif). Sans Lidarr, les demandes sont seulement enregistrées, vous marquez chacune comme ajoutée une fois l’album dans la bibliothèque, et la recherche dans le catalogue n’est pas disponible.
1. Ajouter le dépôt
Le dépôt dit à Jellyfin où trouver le plugin et ses mises à jour.
Dans Jellyfin, ouvrez le Tableau de bord, puis Extensions, et cliquez sur Gérer les dépôts. Selon la version de Jellyfin, les dépôts sont plutôt dans un onglet Dépôts, ou sous Catalogue puis l’icône des paramètres.
Cliquez sur Nouveau dépôt (le bouton +) et remplissez :
Nom du dépôt : Sillon
URL du dépôt, exactement :https://overlabing.github.io/jellyfin-plugin-sillon/manifest.json
Validez avec Ajouter.
2. Installer Sillon
Revenez à Extensions. Choisissez Disponible, puis la catégorie Musiques, et ouvrez Sillon.
Cliquez sur Installer et confirmez. Jellyfin prévient qu’il devra être redémarré.
Redémarrez Jellyfin : bouton Redémarrer du tableau de bord, ou redémarrage du service ou du conteneur. Sillon apparaît ensuite dans les extensions installées et dans la barre latérale du tableau de bord.
3. Configurer
Ouvrez la page Sillon depuis la barre latérale du tableau de bord (ou Extensions, Sillon, Paramètres). Elle est en anglais et a cinq onglets : Overview, Requests, Lidarr, Notifications et Settings.
Lidarr (onglet Lidarr)
Cochez Add requested albums to Lidarr automatically. Décoché, les demandes sont seulement listées et vous marquez chacune comme ajoutée.
Paste your Lidarr address : l’adresse de Lidarr, par exemple http://lidarr:8686.
Paste your Lidarr key : la clé d’API, dans Lidarr sous Settings, General. Elle reste sur votre serveur et n’est plus jamais affichée.
Check the connection : cliquez sur Test connection.
Choose where albums go : Audio quality (le profil de qualité de Lidarr) et Music folder (le dossier racine). Sous Advanced, Release types est le profil de métadonnées ; laissez Not chosen pour celui de Lidarr par défaut.
Toujours sous Advanced, cliquez sur Copy the link, puis dans Lidarr ouvrez Settings, Connect, ajoutez un Webhook avec ce lien, la méthode POST et les événements On Grab, On Release Import et On Import Failure. Ce lien contient un secret : gardez-le comme un mot de passe.
Cliquez sur Save changes.
Si Lidarr et Jellyfin voient votre musique à des chemins différents (conteneurs séparés), renseignez les deux dossiers dans l’onglet Settings, sous Advanced, Music folders.
Notifications (onglet Notifications)
Through the Sillon relay (recommended), le mode par défaut : rien à configurer. Votre serveur chiffre chaque notification pour le seul téléphone destinataire avant de la confier au relais : le chiffrement est de bout en bout, et le relais la transmet sans pouvoir en lire le contenu (ni l’album, ni l’artiste, ni la personne).
With my own Apple key (advanced) : votre serveur parle directement à Apple avec une clé de votre compte développeur Apple. Il faut alors une version de l’app signée pour vous ; ce mode s’adresse à ceux qui compilent leur propre copie.
Off : personne n’est prévenu.
Le bouton Send me a test notification envoie une notification à vos propres téléphones. Un téléphone apparaît dans la liste dès que son propriétaire ouvre l’app Sillon connectée à ce serveur.
Réglages (onglet Settings)
Let people request albums est coché par défaut ; décoché, l’app masque les demandes. Vous y réglez aussi le délai au-delà duquel une demande échoue (14 jours par défaut) et des limites par personne.
4. Dans l’app Sillon
Connectez-vous à votre serveur dans Sillon, sur l’iPhone ou le Mac.
L’app détecte le plugin : dans Réglages, la section Liste d’envies affiche Plugin Sillon détecté.
Les demandes apparaissent alors : Liste d’envies parmi les onglets (dans la barre latérale sur le Mac), le choix Serveur ou Catalogue dans Rechercher, et sur un album du catalogue le bouton Ajouter à ma liste d’envies. La première fois, l’app demande l’autorisation d’envoyer des notifications.
Rien n’apparaît ? Vérifiez que Let people request albums est coché et, avec Lidarr, que l’adresse et la clé sont enregistrées, puis rouvrez l’app quelques minutes plus tard.
Mises à jour et désinstallation
Mises à jour : elles passent par le dépôt. La tâche planifiée Mettre à jour les extensions de Jellyfin installe les nouvelles versions automatiquement ; elles s’activent au redémarrage suivant.
Désinstaller : Extensions, Sillon, Désinstaller, puis redémarrez Jellyfin. L’app masque alors les demandes ; la lecture continue comme avant.
Besoin d’aide ?
Une question sur l’installation, un bug ? Ouvrez un ticket sur GitHub : c’est là que je réponds.
Ouvrir un ticketIl faut un compte GitHub (gratuit). N’y mettez ni mot de passe, ni clé d’API, ni lien de webhook, ni adresse de serveur privée : les tickets sont publics.