Finds what's missing and what's related across your Jellyfin library and builds an easy todo list for filling the gaps: movies absent from a collection, episodes absent from a series, films your cast and crew made that you don't own, and related titles worth adding.
A scheduled task scans your library; a dashboard page (Dashboard > Gaps Report) shows the results: tabbed by media domain, filterable and searchable within a tab, with links out (TMDB, IMDb, and more) and an on-demand "Where to watch" for each item. What it scans for is on its own page (Dashboard > Mind the Gaps), which is also where the plugin's Settings button lands.
More screenshots throughout the report guide and the configuration reference.
The report's tabs are your media domains (Movies, Shows, Music, Books), each badged with its gap count; a View dropdown inside the active tab picks which of three kinds of gap you are looking at:
| View | What it finds | Examples |
|---|---|---|
| Set completion | a missing piece of something you partly own | a movie missing from a collection or franchise; a missing season or episode; a music artist's missing albums |
| Creator works | other work by a person or artist you own | a film or series an owned actor or director made; a music artist's wider catalog; an author's other books |
| Discover | related titles worth exploring and adding (off by default) | TMDB "similar" titles for what you own, TMDB's own feeds, and the unowned titles on a list you have added1 |
Movies and shows work out of the box; music and books are on by default too. Discogs, Trakt, TheTVDB, MDBList, and JustWatch are opt-in cross-checks and sources that need their own credentials. IMDb lists are opt-in but need no credential.
How the pieces connect: the providers and lists you enable feed three gap patterns, and each pattern is one of the View options inside whichever domain tab you are on.
flowchart LR
classDef movies fill:#e3f2fd,stroke:#1565c0,color:#0d47a1;
classDef shows fill:#ede7f6,stroke:#5e35b1,color:#311b92;
classDef music fill:#e8f5e9,stroke:#2e7d32,color:#1b5e20;
classDef books fill:#fff3e0,stroke:#ef6c00,color:#e65100;
col["TMDB collections and BoxSets"]:::movies --> SET
cur["Curated studios and keywords"]:::movies --> SET
ser["Series content (Jellyfin, TheMovieDb, TVmaze, TheTVDB)"]:::shows --> SET
mbd["MusicBrainz discography, Discogs labels"]:::music --> SET
cbs["Curated OpenLibrary subjects"]:::books --> SET
ppl["TMDB people"]:::movies --> CRE
trk["Trakt filmography"]:::movies --> CRE
ipl["IMDb people lists"]:::movies --> CRE
art["MusicBrainz and Discogs artists"]:::music --> CRE
aut["OpenLibrary authors"]:::books --> CRE
etw["Everyone's TODO list (household watchlist)"] --> DIS
sim["TMDB similar titles"] --> DIS
tdf["TMDB's own feeds (Top Rated, Popular, Upcoming, Now Playing)"] --> DIS
tli["TMDB lists"] --> DIS
mli["MDBList lists"] --> DIS
trl["Trakt lists"] --> DIS
ili["IMDb watchlists and lists"] --> DIS
jwl["JustWatch watchlist"] --> DIS
mwl["MDBList watchlist"] --> DIS
twl["Trakt watchlist"] --> DIS
tmw["TMDB watchlist and favorites"] --> DIS
tvf["TheTVDB favorites"]:::shows --> DIS
dwl["Discogs wantlist"]:::music --> DIS
owl["OpenLibrary want to read"]:::books --> DIS
SET["Set completion<br/>Movies: Set completion<br/>Shows: Series completion<br/>Music: Discography<br/>Books: Bibliography"]
CRE["Creator works<br/>Movies and Shows: Creator works<br/>Music: Artist works<br/>Books: Author works"]
DIS["Discover<br/>related titles and curated lists"]
- Set completion: missing movies in a collection/BoxSet, missing seasons and episodes in a series (cross-checked against TheMovieDb/TVmaze/TheTVDB), missing entries in a curated studio, keyword, record label, or book-subject set, and a collected music artist's missing discography.
- Creator works: an owned actor, director, or writer's filmography (TMDB, Trakt, or an IMDb people list), a music artist's wider catalog, and an author's other books.
- Discover (opt-in): TMDB "similar" titles for what you own, TMDB's own feeds, any TMDB/MDBList/ Trakt/IMDb list or JustWatch watchlist you point it at, your own want-lists across eight services, and every user's TODO list folded into one household watchlist, shown first.
- Where to watch: streaming availability per item, looked up on demand or in the background, never during the scan.
- A usable report: tabbed by domain, filterable and searchable, saved views and shareable links, Markdown export, and a per-row Diagnose popup that explains a false "missing" instead of just flagging it.
- Clears itself out: one click checks your library and drops what you now hold everywhere it appeared (its collection, its studio set, its director's filmography, any list that suggested it), then offers to re-check the source for whatever is still missing.
- Send to your acquisition stack (opt-in): hand a gap to Radarr, Sonarr, or Jellyseerr/Overseerr with a per-row Send action.
- Web UI on Jellyfin's own pages (opt-in): the same "missing from your library" rows on a person, movie, series, artist, or book page, plus a "Discover" row on the home screen and a per-user want to watch list.
- Virtual placeholders (opt-in): mint greyed-out "missing" placeholders in place, the way a missing episode renders inside a series. Fully reversible. See below.
Full detail on every source, setting, and screenshot of each: report guide and configuration reference.
-
In the dashboard: Plugins > Repositories > +.
-
Add the repository (any name) with this URL:
https://raw.githubusercontent.com/IDisposable/jellyfin-plugin-mindthegaps/main/manifest.json -
Open the Catalog tab, find Mind the Gaps under General, and click Install.
-
Restart Jellyfin.
New releases show up in the catalog automatically.
To get pre-release builds before they reach the stable channel, add this repository URL instead of the one above:
https://raw.githubusercontent.com/IDisposable/jellyfin-plugin-mindthegaps/main/manifest-beta.json
The beta channel carries every release (stable and pre-release); the stable channel carries only stable releases. Both publish the same plugin, so Jellyfin always offers the highest version it sees and a stable release supersedes the betas that led up to it. Use one channel or the other, not both.
Download the .zip from the latest release,
extract it into a folder under your server's config/plugins/ directory (e.g.
config/plugins/MindTheGaps/), and restart Jellyfin.
Requires a server matching the plugin's targetAbi (currently 10.11 and net9.0 or 12.0 and net10.0)
Open Dashboard > Mind the Gaps and click Rescan now. For collection gaps, your BoxSets need a TMDB id (from the TMDB box-set provider). The scan also runs on a schedule (editable under Dashboard > Scheduled Tasks).
See the report guide for the domain tabs and the View dropdown (Set completion, Creator works, Discover), the filters and saved views, and the per-row actions (where to watch, send, mint, dismiss).
In the dashboard, go to Plugins > Mind the Gaps. Settings are grouped the way the data is: What to scan holds the plain toggles (collections, series, filmographies, recommendations, music, books), and Sources has one collapsible section per provider (TMDB, Trakt, MDBList, Discogs, OpenLibrary, TheTVDB, IMDb, JustWatch), each holding that provider's toggles, ids, and credential together. Every section folds under its heading, and a search box above them narrows to whatever matches.
Nothing is required to get a useful report: the defaults scan collections, series, filmographies, music, and books against the built-in TMDB key. Everything else, including the acquisition-stack handoff to Radarr/Sonarr/Jellyseerr and every credential-gated source, is opt-in. For every setting, what it does, and what changes when you set or clear it, see the configuration reference; for every HTTP route the plugin serves, the API reference.
Off by default. The plugin can mint pathless "virtual" placeholder items so a gap renders greyed-out in place, the way a missing episode does today - a stand-in for proper server support, fully reversible. Mint a gap from its row, or several at once from the multi-select bar; Remove minted items in the report's Maintenance section undoes everything. See the virtual items section of the configuration reference for the mechanics.
Mind the Gaps is self-contained, so it does not depend on any other plugin and will not clash with them. Its links are still extensible without any setup: it folds in whatever your server's own link providers emit, so TMDB and IMDb links come from core, and a JustWatch link lights up automatically if the separate Jellyfin.Plugin.JustWatch is installed. For the architecture behind this, see CONTRIBUTING.
- Configuration reference - every setting, what it does, and what changes when you set or clear it.
- Report guide - the three tabs, the filters and saved views, and the per-row actions.
- Roadmap and status - what is built, what is planned, and what is deliberately not.
- Advanced CSS customization - target a provider's links with your own stylesheet, plus a ready-to-paste icon snippet.
- Architecture decision records - the reasoning behind the non-obvious design choices.
Bug reports, ideas, and pull requests are welcome. See CONTRIBUTING for how to build, test, release, and find your way around the code.
Thanks tons to David @rappo for the inspiration to add the WebUI that injects the gaps directly into the Homepage, Movie, Series, and Artist pages.
MIT. See LICENSE.
Footnotes
-
The feeds are Top Rated, Popular, Upcoming and Now Playing. A list can be a TMDB, MDBList, Trakt or IMDb list, or your own JustWatch watchlist, and each list is shown as its own group. Every user's TODO list is folded into one such group too, shown first: treat it as the household's own watchlist. ↩


