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.