Skip to content

About

Jellyfin plugin that finds what's missing and related across your library and builds a todo list to fill the gaps: collections, series, cast & crew filmographies, and recommendations. Adds where-to-watch links and can optionally show missing entries as placeholders.

Resources

Contributing

Stars

38 stars

Watchers

1 watching

Forks

Latest commit

 

History

421 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Mind the Gaps Jellyfin Plugin

Mind the Gaps

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.

Build License Jellyfin 10.11 Jellyfin 12.0

What it does

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.

The Mind the Gaps report: movie collections laid out in columns with their missing parts

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"]
Loading

Features

  • 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.

The Web UI's "More like this you don't have" row, injected directly into a movie's own Jellyfin page

Installation

From the plugin catalog (recommended)

  1. In the dashboard: Plugins > Repositories > +.

  2. Add the repository (any name) with this URL:

    https://raw.githubusercontent.com/IDisposable/jellyfin-plugin-mindthegaps/main/manifest.json
    
  3. Open the Catalog tab, find Mind the Gaps under General, and click Install.

  4. Restart Jellyfin.

New releases show up in the catalog automatically.

Beta channel (optional)

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.

Manual

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)

Usage

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).

Configuration

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.

Virtual placeholders (opt-in)

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.

Works alongside your other plugins

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.

Documentation

Contributing

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.

License

MIT. See LICENSE.

Footnotes

  1. 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. ↩

About

Jellyfin plugin that finds what's missing and related across your library and builds a todo list to fill the gaps: collections, series, cast & crew filmographies, and recommendations. Adds where-to-watch links and can optionally show missing entries as placeholders.

Resources

Contributing

Stars

38 stars

Watchers

1 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages