Install the Jellyfin plugin

Done once, by the administrator of the Jellyfin server. People who use Sillon on that server have nothing to install.

What the plugin does

Album requests

From the app, anyone can ask for albums the server does not have yet. With Lidarr, the plugin adds them there and follows each request until the album is in your library.

Notifications

When a requested album is available, the plugin adds it to that person’s favourites and tells them on their phone.

Optional

Playback and browsing your library work without the plugin. It only adds requests and notifications.

What you need

1. Add the repository

The repository tells Jellyfin where to find the plugin and its updates.

  1. In Jellyfin, open the Dashboard, then Plugins, and click Manage Repositories. Depending on the Jellyfin version, repositories may instead be in a Repositories tab, or under Catalog and then the settings icon.
  2. Click New Repository (the + button) and fill in:
    • Repository Name: Sillon
    • Repository URL, exactly:https://overlabing.github.io/jellyfin-plugin-sillon/manifest.json
  3. Confirm with Add.

2. Install Sillon

  1. Go back to Plugins. Pick Available, then the Music category, and open Sillon.
  2. Click Install and confirm. Jellyfin warns that it will need to be restarted.
  3. Restart Jellyfin: the Restart button on the dashboard, or restart the service or container. Sillon then shows up among the installed plugins and in the dashboard’s sidebar.

3. Configure

Open the Sillon page from the dashboard’s sidebar (or Plugins, Sillon, Settings). It has five tabs: Overview, Requests, Lidarr, Notifications and Settings.

Lidarr (Lidarr tab)

  1. Tick Add requested albums to Lidarr automatically. When off, requests are only listed and you mark each one as added.
  2. Paste your Lidarr address: Lidarr’s address, for example http://lidarr:8686.
  3. Paste your Lidarr key: the API key, found in Lidarr under Settings, General. It stays on your server and is never shown again.
  4. Check the connection: click Test connection.
  5. Choose where albums go: Audio quality (Lidarr’s quality profile) and Music folder (the root folder). Under Advanced, Release types is the metadata profile; leave it on Not chosen for Lidarr’s default.
  6. Still under Advanced, click Copy the link, then in Lidarr open Settings, Connect, and add a Webhook with that link, the POST method and the events On Grab, On Release Import and On Import Failure. The link contains a secret: treat it like a password.
  7. Click Save changes.

If Lidarr and Jellyfin see your music at different paths (separate containers), fill in both folders in the Settings tab, under Advanced, Music folders.

Notifications (Notifications tab)

The Send me a test notification button sends a notification to your own phones. A phone appears in the list once its owner opens the Sillon app signed in to this server.

Settings (Settings tab)

Let people request albums is on by default; when off, the app hides requests. This is also where you set how long a request may wait before it fails (14 days by default) and per-person limits.

4. In the Sillon app

  1. Sign in to your server in Sillon, on iPhone or Mac.
  2. The app detects the plugin: in Settings, the Wishlist section shows Sillon plug-in detected.
  3. Requests then appear: Wishlist among the tabs (in the sidebar on the Mac), the Server or Catalog choice in Search, and on a catalogue album the Add to My Wishlist button. The first time, the app asks for permission to send notifications.

Nothing shows up? Check that Let people request albums is ticked and, with Lidarr, that the address and key are saved, then reopen the app a few minutes later.

Updates and uninstalling

Need help?

A question about the setup, a bug? Open an issue on GitHub: that is where I answer.

Open an issueYou need a (free) GitHub account. Do not post a password, an API key, a webhook link or a private server address: issues are public.