Plex + Kometa

Turn season-rating shapes into Plex collections and poster badges

← Back to Rising Shows What is Kometa? β†—

Shape collections

One Plex collection per shape - "Slow Burn Seasons", "Big Finale Seasons", "Rebound Seasons". Kometa builds them from TMDB / TVDB IDs.

Season-poster badges

Small text overlays - FINALE BURN BEST - appear on individual season posters so you spot the standouts at a glance.

MDBList lists

Plain IMDb-ID text files you can paste into MDBList to share or chain into other tooling.

Show Finder presets

Saved Show Finder filters published as ready-made Plex collections that rebuild themselves every time the data refreshes. Details below ↓

Build your config

Pick the shapes you want, adjust the confidence floor, then copy the YAML or download it.

Loading dataset…

Show Finder β†’ Plex collections

Any filter you can build in the Show Finder - shapes, votes, years, genres, rating gaps - can live on as a Plex collection that keeps itself current. Preset lists are replayed against fresh IMDb data on every refresh and published under exports/kometa/finder-*.yml, so a show that newly qualifies tomorrow joins the collection on its own.

1

Use a ready-made preset

Curated collections like Consistently Great (seasons never wavered) or Went Out On Top (final season rated best) ship pre-built. Point Kometa at a raw URL once and you're done:

libraries:
  TV Shows:
    collection_files:
      - url: https://raw.githubusercontent.com/nsoifer01/shevato/master/apps/rising-shows/exports/kometa/finder-consistently-great.yml

The live preset index with current counts is in exports/README.md β†—.

2

Roll your own

Dial in a filter in the Show Finder, copy everything after # in the address bar, and add it as a preset in finder-presets.json. From the next data refresh on, your collection publishes and updates itself.

Full walkthrough - preset fields, limits, and the optional local-template hook for your own collection attributes - in the integration guide β†—.

How to use it

1

Drop the YAMLs into your Kometa config

Save downloaded files under config/rising-shows/ in your Kometa install.

Prefer no copying? Point Kometa at the GitHub raw URLs - they're regenerated automatically whenever the dataset refreshes:

libraries:
  TV Shows:
    collection_files:
      - file: config/tv_shows_collections.yml
      - file: config/rising-shows/slow-burn.yml
      - file: config/rising-shows/big-finale.yml
      # …add other shape files as needed
2

Wire up season-poster overlays

Add season-overlays.yml to your TV library's overlay_files:

libraries:
  TV Shows:
    overlay_files:
      - file: config/tv_shows_overlays.yml
      - file: config/rising-shows/season-overlays.yml

Run Kometa with --overlays-only on the first pass so you can verify a few posters before committing the full overlay run.

3

Run Kometa

docker exec kometa python kometa.py --run --collections-only
# then later, once collections look good:
docker exec kometa python kometa.py --run --overlays-only

Open Plex β†’ TV Shows β†’ Collections. New collections appear sorted with !rs_-prefixed titles.

β˜…

"What to watch next" - CLI

If you have the repo on your NAS, you can also ask which seasons of a given shape live in your Plex library right now:

export PLEX_URL=http://nas.local:32400
export PLEX_TOKEN=<your token>
npm run watch-next -- --shape slow-burn --limit 10

Pipes a JSON shape via --json - wire it into Discord, Notifiarr, Homarr, or any cron-driven feed.