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 12+. TMDb metadata is recommended for best accuracy (IMDb and Tvdb works as a fallback but is less accurate for TV). (10.11.6+ version]

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. Please ensure you have your content metadata source set to TMDb.

IMDb and Tvdb 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. The settings page validates the key server-side and shows your TheIntroDB contribution stats when the token is valid.
• Selected Libraries And Shows: Optionally limit the Media Segment Scan task from the plugin settings page. You can browse Jellyfin libraries, whitelist an entire library/folder, or pick individual series. When a filter is active, the plugin only fetches segments for items inside those selected libraries or for the selected shows.
• 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