TheIntroDB – Jellyfin Plugin

This plugin integrates TheIntroDB API with Jellyfin’s Media Segments feature. It fetches intro, recap, credits, and preview timestamps by TMDB ID and exposes them as Jellyfin media segments so clients can show skip buttons.

Requirements: Jellyfin 10.11.6+. TMDb metadata is recommended for best accuracy (IMDb works as a fallback but is less accurate for TV).

Important: Segments are not fetched when you press play. They are filled when the Media segment scan task runs (manually or on its schedule). Until that task has run for your library, skip intro/outro will not appear.

Troubleshooting (no segments): See the Metadata Requirements and Installation sections below.

---

Installation

Option A: Add repository (automatic updates)

1. In Jellyfin: Dashboard → Plugins → Repositories → Add.
2. Add this repository URL: https://raw.githubusercontent.com/TheIntroDB/jellyfin-plugin/main/manifest.json
3. Go to Catalog and install TheIntroDB.
4. Jellyfin will notify you when updates are available.
5. Configure at Dashboard → Plugins → TheIntroDB (optional API key, enable/disable segment types).
6. Run Dashboard → Scheduled Tasks → Media Segment Scan and click the Play button (▶) to populate segments.

Option B: Manual install

It's recommended to use the repository. Manual installations don't automatically update!

1. Download the latest plugin from the Releases page.
2. Extract TheIntroDB.zip into your Jellyfin plugins folder:
   • Linux/macOS: ~/.local/share/jellyfin/plugins/ or $HOME/Library/Application Support/jellyfin/plugins/
   • Windows: %LocalAppData%\jellyfin\plugins\ Ensure that TheIntroDB/ folder contains TheIntroDB.dll
3. Restart Jellyfin.
4. Configure at Dashboard → Plugins → TheIntroDB (optional API key, enable/disable segment types).
5. Run Dashboard → Scheduled Tasks → Media Segment Scan and click the Play button (▶) to populate segments. Skip intro/outro buttons will appear in clients once the scan has run for your library.

Metadata Requirements

TMDb is recommended. The plugin matches content by TMDb ID for best accuracy. Add the TMDb metadata plugin and let it fill provider IDs for your library.

IMDb IDs work as a fallback but are less accurate for TV episodes. The plugin will use whichever IDs are available on your items.

Customizing Skip Button

You can use the File Transformation plugin to adjust the delay and timeout of Jellyfin's segment skip button.

• Plugin repo: https://github.com/IAmParadox27/jellyfin-plugin-file-transformation

Easiest way to install:

• Add as a plugin source repository to your Jellyfin server. https://www.iamparadox.dev/jellyfin/plugins/manifest.json
• Find "File Transformation" in the Catalog and install it.

Configuration

TheIntroDB plugin includes some configuration options to adjust and improve your experience.

• API Key: You can enter your TheIntroDB API key to fetch your submissions even if they're still pending and prioritize yours in the averaging calculation.
• Segment Toggles: (All enabled by default) You can disable each segment individually so they're not applied when fetching.
• Ignore Media That Already Has Segments: (Enabled by default) Prevent refetching of media that already has segments. This is recommended for large libraries.

---

Development

Prerequisites

• .NET 9.0 SDK

Build Commands

dotnet build

Quick Test Loop

1. Build: dotnet build
2. Copy: cp TheIntroDB/bin/Debug/net9.0/TheIntroDB.dll ~/.local/share/jellyfin/plugins/TheIntroDB/ (adjust path for your OS)
3. Restart Jellyfin