Kodi service add-on that gets intro, recap, credits, and preview segments from TheIntroDB for movies and TV shows and shows a skip button or auto skips for you!
Requirements: Kodi 19+. TVDB metadata is recommended: TVDB is the API's identity, so it is what the add-on asks with first (TMDB, then IMDb, are fallbacks).
Important: Lookups happen when playback starts. If the current item does not expose a usable TVDB, TMDb or IMDb ID, the add-on cannot match it with TheIntroDB.
Troubleshooting (no skip button): See the Metadata Requirements and Installation sections below.
- Download repository.tidb.repo-2.0.0.zip or add
https://theintrodb.github.io/kodi-addon/as a source in the Kodi File Manager. - Install
repository.tidb.repo.zipby selecting Settings → Add-ons → Install from zip file within Kodi. - Go to Settings → Add-ons → Install from Repository.
- Open TheIntroDB Kodi Addon Repo and install TheIntroDB Kodi Addon.
- Allow third-party repository updates under Settings → System → Add-ons if you want automatic updates.
- Download the latest add-on zip plugin.video.tidb-1.8.1.zip:
- In Kodi, choose Settings → Add-ons → Install from zip file.
- Select the zip to install the add-on directly.
- Unzip the add-on folder and rename it to
plugin.video.tidb, move it into Kodi’s add-ons directory for your platform. - Restart Kodi or reload add-ons.
TVDB is recommended. TVDB is TheIntroDB's identity, so it is what the add-on asks with first; TMDB is next, then IMDb tt.... When the item exposes several, the add-on uses the best one and falls back to the others if the first finds nothing.
Alongside the id, an episode's own TVDB episode id is sent when Kodi has one. It is the add-on's way of saying which exact episode record it means; note that the API currently answers /media from the season/episode numbers rather than that id (measured 2026-10-17: a pinned id naming a different episode than the numbers returns the numbers' episode), so the numbering is still what decides the answer. The id is sent for when that precedence is honoured.
For TV episodes, the playing item also needs valid season and episode numbers. If your source add-on or library does not expose provider IDs, TheIntroDB cannot match the item.
Known limitation: for a series whose episode numbers follow a release order rather than TVDB's default (streaming rips, absolute-numbered anime, some specials), a lookup is answered from the numbers as TVDB's default order, which can be a different episode than the one you are watching. Kodi does not expose which order its numbers came from, so the add-on cannot pass an order to convert; if your library is scraped in a non-default order, prefer a source that carries a TVDB id and check the result against the episode you are watching.
On each new playback, the add-on reads what Kodi exposes for the current item through JSON-RPC Player.GetItem and VideoInfoTag: TVDB ID when available, otherwise TMDb ID, otherwise IMDb tt... ID, plus season, episode and (for episodes) the TVDB episode ID.
It then calls TheIntroDB, retrieves segment start and end times, waits until the segment window begins, and either shows the skip overlay or seeks automatically depending on your settings.
TheIntroDB Kodi Addon includes a few settings to adjust behavior:
- Auto-skip: Skip without showing the button
- Extra seconds after segment end: Adds a small offset to the skip target
- Enable lookups: Turns TheIntroDB requests on or off
- API key: Lets you use your TheIntroDB API key.
- Debug options: Enables verbose logging and on-screen notifications
- TheIntroDB — database and API: theintrodb.org · github.com/TheIntroDB
- JZOnTheGit — original addon creator: github.com/JZOnTheGit
See LICENSE for details.