Setup & Integration

Connect TVSportsDB to your media server for rich sports metadata including posters, descriptions, and episode information.

Plex

Custom Metadata Provider

For Plex 1.43.0+ (2024 and newer). No plugin installation required - just add our provider URL in settings.

View setup guide

Jellyfin

Metadata Plugin

C# plugin for Jellyfin 10.9+. Download the plugin DLL and add it to your plugins folder.

View setup guide

File Naming Convention

Both Plex and Jellyfin agents expect standard TV show naming for your sports content:

Folder Structure

{Series}/Season {Season}/

Examples:
UFC 2025/Season 01/
NFL 2025/Season 17/
NBA 2025/Season 12/

File Naming

{Series} - S{Season}E{Episode} - {Title}.ext

Examples:
UFC 2025 - S01E01 - UFC 311 Makhachev vs Tsarukyan.mkv
NFL 2025 - S17E01 - Cowboys at Commanders.mkv
NBA 2025 - S12E05 - Lakers vs Celtics.mkv

Need help? Open an issue on GitHub