Pelagica Jellyfin Plugin

Companion plugin for the Pelagica app. It stores the Pelagica configuration (home screen sections, item page settings, branding, links, and so on) on the Jellyfin server itself, so every user connecting through Pelagica sees the same setup instead of each client having its own local copy.

Installation

1. In Jellyfin, go to Dashboard > Plugins > Repositories.
2. Add a repository with this URL: https://raw.githubusercontent.com/PelagicaApp/jellyfin-plugin/main/manifest.json
3. Go to the Catalog tab, find Pelagica under General, and install it.
4. Restart Jellyfin when prompted.

Alternatively, download the release zip from the Releases page, extract it into your Jellyfin plugins directory (for example /config/plugins/Pelagica), and restart Jellyfin.

Development setup

Requirements:

• .NET 9 SDK
• Docker and Docker Compose
• Task

The repository includes a Taskfile that builds the plugin and runs it in a local Jellyfin instance via Docker Compose.

Common commands:

task up

Builds the plugin, stages it into dev/plugin, and starts Jellyfin at http://localhost:8096.

task restart

Rebuilds the plugin and restarts the Jellyfin container to pick up changes.

task logs

Tails the Jellyfin container logs.

task down

Stops the Jellyfin container.

task clean

Stops Jellyfin, removes its volumes, and deletes the staged plugin build.

Once running, the plugin's dashboard page is available under Dashboard > Plugins > Pelagica in the local Jellyfin instance.