feat: track episode availability from media servers scanners by 0xSysR3ll · Pull Request #3402 · seerr-team/seerr

0xSysR3ll · 2026-08-15T14:55:24Z

Description

Part 3 of #1671, stacked on #3355.

Wires episode availability into the media server scanners so media-server-only users get per-episode badges without Sonarr.
Episode numbers come from the library agent, so Seerr's metadata provider must match that agent (TMDB or TVDB).

Sonarr tracking stays TVDB-only.

How Has This Been Tested?

Only unit tests for now.

Screenshots / Logs (if applicable)

Checklist:

I have read and followed the contribution guidelines.
Disclosed any use of AI (see our policy)
I have updated the documentation accordingly.
All new and existing tests passed.
Successful build pnpm build
Translation keys pnpm i18n:extract
Database migration (if required)

coderabbitai · 2026-08-15T14:55:34Z

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Team

Run ID: 814e0ac6-d3e0-4005-90b1-40f50b3a4687

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

🔍 Trigger review

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands.}

github-actions · 2026-08-18T19:56:21Z

This pull request has merge conflicts. Please resolve the conflicts so the PR can be successfully reviewed and merged.

github-actions · 2026-08-31T17:10:41Z

This pull request has merge conflicts. Please resolve the conflicts so the PR can be successfully reviewed and merged.

fallenbagel

Two changes in here aren't about episode badges. The Jellyfin cache key fix should go straight to develop on its own as it's fixing a bug live today. The Plex 4K detection switch should either come out or land as its own PR covering the movie path too, since right now the file is half on videoResolution and half on width and there is no explanation as to why. The Jellyfin season-existence change is fine but keys off enable4kShow rather than the tracking setting, so it needs a gate or this will change behaviour for people who do not use this setting. The worst blocker is the per-source demotion since, as written, each source deletes what it can't see and the sources disagree.

fallenbagel · 2026-08-31T22:24:23Z

+            } else {
+              const episodes = await this.jellyfinClient.getEpisodes(
+                seriesId,
+                seasonMeta.Id,
+                { includeMediaInfo: true }
+              );


This runs for every 4K instance whether or not episode tracking is on. The branch splits on enable4kShow, not shouldTrackEpisodes, so the 4K pass stops treating a season as present just because episodes exist and starts requiring a stream over 2000 wide. That's the right behavior and it lines up with what the scanner already does, but it changes 4K season removal for anyone with a 4K Sonarr configured whether or not they turned tracking on. Gate it on shouldTrackEpisodes and let the existing behavior stand for everyone else.

fallenbagel · 2026-08-31T22:31:12Z

+        for (const episode of episodes) {
+          const versions = episode.Media ?? [];
+          const hasStandard = this.enable4kShow
+            ? versions.some((media) => media.videoResolution !== '4k')
+            : versions.length > 0;
+          const has4k =
+            this.enable4kShow &&
+            versions.some((media) => media.videoResolution === '4k');
+
+          if (hasStandard) {
+            totalStandard += 1;
+          }
+          if (has4k) {
+            total4k += 1;
+          }


With 4K off, an episode Plex returns without a Media array which used to count toward totalStandard and now doesn't. Probably fine since it is typed non-pption but hasStandard = this.enable4kShow ? versions.some(...) : true keeps the count identical and the ?? [] still does its job in the 4K branch.

fallenbagel · 2026-08-31T22:36:11Z

+        const episodeDetails: ProcessableEpisode[] | undefined = settings.main
+          .enableEpisodeAvailability
+          ? []
+          : undefined;


I think we need to make this very clear. Either in settings or settings that leads to docs or whatever, Plex agents are per-library, so an install with one TMDB-agent library and one TVDB-agent library can't satisfy the provider-matching requirement for both. Same with jellyfin

fallenbagel · 2026-08-31T22:42:07Z

        if (existingEpisode) {
          if (episodeDetail.hasFile) {
            existingEpisode[is4k ? 'status4k' : 'status'] =
              MediaStatus.AVAILABLE;
            toSave.push(existingEpisode);
          }
+          if (this.enable4kShow && episodeDetail.hasFile4k) {
+            existingEpisode.status4k = MediaStatus.AVAILABLE;
+            toSave.push(existingEpisode);
+          }


Same entity gets pushed twice when both flags are set.

0xSysR3ll · 2026-09-02T18:10:15Z

Two changes in here aren't about episode badges. The Jellyfin cache key fix should go straight to develop on its own as it's fixing a bug live today. The Plex 4K detection switch should either come out or land as its own PR covering the movie path too, since right now the file is half on videoResolution and half on width and there is no explanation as to why. The Jellyfin season-existence change is fine but keys off enable4kShow rather than the tracking setting, so it needs a gate or this will change behaviour for people who do not use this setting. The worst blocker is the per-source demotion since, as written, each source deletes what it can't see and the sources disagree.

Yep, since I already had the fixes I wanted to include them directly here but I'll revert and keep that for another PR then.

fallenbagel · 2026-09-02T18:33:23Z

Two changes in here aren't about episode badges. The Jellyfin cache key fix should go straight to develop on its own as it's fixing a bug live today. The Plex 4K detection switch should either come out or land as its own PR covering the movie path too, since right now the file is half on videoResolution and half on width and there is no explanation as to why. The Jellyfin season-existence change is fine but keys off enable4kShow rather than the tracking setting, so it needs a gate or this will change behaviour for people who do not use this setting. The worst blocker is the per-source demotion since, as written, each source deletes what it can't see and the sources disagree.

Yep, since I already had the fixes I wanted to include them directly here but I'll revert and keep that for another PR then.

We can merge those before this stack so they will get added here anyways. Like the cache one is a live bug already present in develop so

0xSysR3ll force-pushed the feat-episode-availability-media-scanners branch from b686913 to 31c93b5 Compare August 18, 2026 17:14

github-actions Bot added the merge conflict Cannot merge due to merge conflicts label Aug 18, 2026

This comment has been minimized.

Sign in to view

0xSysR3ll force-pushed the feat-episode-availability-media-scanners branch 2 times, most recently from 5d9fd87 to 5d061b0 Compare August 18, 2026 19:38

github-actions Bot removed the merge conflict Cannot merge due to merge conflicts label Aug 18, 2026

github-actions Bot added the merge conflict Cannot merge due to merge conflicts label Aug 18, 2026

0xSysR3ll force-pushed the feat-episode-availability-media-scanners branch from 5d061b0 to 6e41f8f Compare August 18, 2026 19:58

github-actions Bot removed the merge conflict Cannot merge due to merge conflicts label Aug 18, 2026

0xSysR3ll force-pushed the feat-episode-availability-media-scanners branch from 6e41f8f to fcdb7aa Compare August 31, 2026 17:02

0xSysR3ll force-pushed the feat-episode-availability-media-scanners branch from fcdb7aa to 737842d Compare August 31, 2026 17:10

github-actions Bot added the merge conflict Cannot merge due to merge conflicts label Aug 31, 2026

github-actions Bot removed the merge conflict Cannot merge due to merge conflicts label Aug 31, 2026

0xSysR3ll marked this pull request as ready for review August 31, 2026 17:21

0xSysR3ll requested a review from a team as a code owner August 31, 2026 17:21

fallenbagel requested changes Aug 31, 2026

View reviewed changes

0xSysR3ll force-pushed the feat-episode-availability-media-scanners branch from 737842d to 1773b28 Compare September 2, 2026 17:14

github-actions Bot added the merge conflict Cannot merge due to merge conflicts label Sep 2, 2026

This comment was marked as outdated.

Sign in to view

github-actions Bot added merge conflict Cannot merge due to merge conflicts and removed merge conflict Cannot merge due to merge conflicts labels Sep 2, 2026

This comment was marked as outdated.

Sign in to view

0xSysR3ll force-pushed the feat-episode-availability-media-scanners branch from 1773b28 to a4fbb6a Compare September 2, 2026 17:48

github-actions Bot removed the merge conflict Cannot merge due to merge conflicts label Sep 2, 2026

0xSysR3ll force-pushed the feat-episode-availability-media-scanners branch from a4fbb6a to 0ab8476 Compare September 2, 2026 18:00

0xSysR3ll force-pushed the feat-episode-availability-media-scanners branch from 0ab8476 to 56b276e Compare September 2, 2026 18:25

github-code-quality Bot found potential problems Sep 2, 2026

View reviewed changes

Comment thread server/lib/availabilitySync.ts Fixed

Comment thread server/lib/availabilitySync.ts Fixed

Comment thread server/lib/availabilitySync.ts Fixed

github-advanced-security Bot found potential problems Sep 2, 2026

View reviewed changes

Comment thread server/lib/availabilitySync.ts Fixed

Comment thread server/lib/availabilitySync.ts Fixed

Comment thread server/lib/availabilitySync.ts Fixed

0xSysR3ll force-pushed the feat-episode-availability-media-scanners branch from 56b276e to 25fa072 Compare September 2, 2026 18:31

0xSysR3ll force-pushed the feat-episode-availability-media-scanners branch from 25fa072 to d8201b7 Compare September 2, 2026 18:46

feat: track episode availability from media servers scanners

d8201b7

Uh oh!

Uh oh!

Conversation

0xSysR3ll commented Aug 15, 2026

Description

How Has This Been Tested?

Screenshots / Logs (if applicable)

Checklist:

Uh oh!

coderabbitai Bot commented Aug 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Review skipped

Uh oh!

This comment has been minimized.

github-actions Bot commented Aug 18, 2026

Uh oh!

github-actions Bot commented Aug 31, 2026

Uh oh!

fallenbagel left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

fallenbagel Aug 31, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

fallenbagel Aug 31, 2026

Choose a reason for hiding this comment

Uh oh!

fallenbagel Aug 31, 2026

Choose a reason for hiding this comment

Uh oh!

fallenbagel Aug 31, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

This comment was marked as outdated.

This comment was marked as outdated.

0xSysR3ll commented Sep 2, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

fallenbagel commented Sep 2, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

coderabbitai Bot commented Aug 15, 2026 •

edited

Loading