This plugin fetches intro, recap, credits, and preview timestamps from TheIntroDB for your Emby library. It uses this data to enable intro skipping features in compatible Emby clients.
Requirements: Emby Server 4.7+. 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 populated when the TheIntroDB Media Segment Scan scheduled task runs. Until that task has run for your library, skip features may not be available.
- Open Emby's WebUI and navigate to the plugin catalog.
- Find TheIntroDB under the general plugin section.
- Install the latest version!
- Restart Emby Server.
- Configure the plugin at Dashboard → Plugins → TheIntroDB.
- Run the scheduled task to populate data: Dashboard → Scheduled Tasks → TheIntroDB Media Segment Scan and click the Play button (▶).
Tip: use Emby.GitHubRepoPluginInstall to install from GitHub releases directly!
- Download the latest plugin release from the Releases page.
- Place
TheIntroDB.dllinto your Emby plugins folder:- Linux:
/var/lib/emby/plugins/ - Windows:
C:\Users\{user}\AppData\Roaming\Emby-Server\plugins\ - macOS:
~/.config/emby-server/plugins/or/Library/Application Support/Emby-Server/plugins
- Linux:
- Restart Emby Server.
- Configure the plugin at Dashboard → Plugins → TheIntroDB.
- Run the scheduled task to populate data: Dashboard → Scheduled Tasks → TheIntroDB Media Segment Scan and click the Play button (▶).
TMDb is recommended. The plugin matches content by TMDb ID for best accuracy. Ensure your libraries are configured to fetch TMDb IDs for your movies and shows.
IMDb IDs work as a fallback but are less accurate for TV episodes. The plugin will use whichever IDs are available on your items.
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: (Intro, Recap, Credits, and Preview — 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.
TheIntroDB provides four segment types: Intro, Recap, Credits, and Preview. The plugin writes them as chapter markers, and how each one shows up depends on what Emby's clients are built to render:
| Segment | What you'll see in Emby clients |
|---|---|
| Intro | Emby's native "Skip Intro" button appears while the intro is playing. |
| Credits | Emby's "Coming Up Next" overlay appears at the credits start (for episodes that have a next episode), letting you jump straight to it. There is no literal "Skip Credits" button. |
| Recap | A regular chapter (Recap (TheIntroDB) → Recap End (TheIntroDB)) you can jump to from the chapter list. Emby has no recap skip button. |
| Preview | A regular chapter (Preview (TheIntroDB) → Preview End (TheIntroDB)) you can jump to from the chapter list. Emby has no preview skip button. |
Why no skip button for recap and preview? This is a limitation of Emby, not the plugin. Emby's player only renders skip UI for intro markers (
IntroStart/IntroEnd) and credits markers (CreditsStart) — those marker types are hard-coded into Emby's client apps. There is no plugin API for adding buttons to the player UI, and no "recap" or "preview" marker type exists in Emby. Until Emby adds them, recap and preview segments are exposed as chapters for manual navigation.
It's recommended to disable Emby's internal intro marker detection in Dashboard → Library → select library → Advanced/options → Disable "Generate intro video markers".
Thumbnail extraction is also recommended and can be done from Dashboard → Library → select library → Advanced/options → Enable "Video preview thumbnails".
And by running the scheduled task again.
dotnet build- Build:
dotnet build - Copy the DLL:
cp TheIntroDB/bin/Debug/netstandard2.0/TheIntroDB.dll /var/lib/emby/plugins/(adjust path for your OS) - Restart Emby Server.