Jellyfin Setup

Metadata Plugin for Jellyfin 10.9+

Requirements

  • Jellyfin Server version 10.9.0 or newer
  • .NET 8.0 runtime (included with Jellyfin)

Download Plugin

Download TVSportsDB.dll

Download the latest release from GitHub

Installation Steps

  1. 1

    Download the Plugin

    Download TVSportsDB.dll from the latest release

  2. 2

    Copy to Plugins Folder

    Create a folder and copy the DLL to your Jellyfin plugins directory:

    Linux

    /var/lib/jellyfin/plugins/TVSportsDB/

    Windows

    %APPDATA%\jellyfin\plugins\TVSportsDB\

    Docker

    /config/plugins/TVSportsDB/
  3. 3

    Restart Jellyfin

    Restart Jellyfin Server for the plugin to be loaded

  4. 4

    Configure Plugin (Optional)

    Go to Dashboard → Plugins → TVSportsDB to configure the API URL if needed

    Default API URL: https://tvsportsdb.com

  5. 5

    Create Library

    Create a new TV Shows library and enable TVSportsDB as a metadata provider in the library settings

Building from Source

If you prefer to build the plugin yourself:

git clone https://github.com/tvsportsdb/tvsportsdb.git
cd tvsportsdb/agents/jellyfin/TVSportsDB
dotnet build -c Release

The compiled DLL will be in bin/Release/net8.0/

Troubleshooting

Plugin not appearing

  • Ensure the DLL is in a subfolder named TVSportsDB
  • Check Jellyfin logs for plugin loading errors
  • Verify you have Jellyfin 10.9.0 or newer

No metadata found

  • Check that your file naming matches the expected format
  • Use "Identify" to manually search and select the correct show
  • Ensure the show exists in TVSportsDB

Connection errors

  • Verify your server can reach the API URL
  • Check plugin settings for correct API URL
  • Look for network errors in Jellyfin logs