Plex + Kometa

Turn season-rating shapes into Plex collections and poster badges

← Back to Rising Seasons 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.

Build your config

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

Loading dataset…

How to use it

1

Drop the YAMLs into your Kometa config

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

Prefer no copying? Point Kometa at the GitHub raw URLs — they're regenerated weekly when the dataset refreshes:

libraries:
  TV Shows:
    collection_files:
      - file: config/tv_shows_collections.yml
      - file: config/rising-seasons/slow-burn.yml
      - file: config/rising-seasons/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-seasons/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.