feat: track episode availability from sonarr by 0xSysR3ll · Pull Request #3355 · seerr-team/seerr

0xSysR3ll · 2026-08-08T21:38:06Z

Description

Part 2 of #1671 to make the review easier.
Implements episode availability in Sonarr's scanner.

How Has This Been Tested?

Same tests as part 1 + server checks.

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)

Summary by CodeRabbit

New Features
- Added optional episode-level availability tracking for Sonarr TV shows.
- Episode file status is synchronized, including support for 4K availability.
- Anime-specific metadata provider selection is supported during synchronization.
Bug Fixes
- Removed episodes no longer available are excluded from season availability results.
- Synchronization continues when episode lookups or metadata requests fail.

coderabbitai · 2026-08-08T21:38:15Z

Note

Currently processing new changes in this PR. This may take a few minutes, please wait...

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Advanced

Run ID: 10fbf24a-8604-4e5d-b02a-7f404701b827

📥 Commits

Reviewing files that changed from the base of the PR and between 34762ab and 5578a5e.

📒 Files selected for processing (6)

server/lib/availabilitySync.test.ts
server/lib/availabilitySync.ts
server/lib/scanners/baseScanner.ts
server/lib/scanners/sonarr/index.ts
server/lib/scanners/sonarr/sonarr.test.ts
server/routes/tv.ts

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

fallenbagel · 2026-08-09T01:48:51Z

Is the media server scanner gonna be stacked on this PR?

0xSysR3ll · 2026-08-09T07:17:10Z

Is the media server scanner gonna be stacked on this PR?

It's supposed to but I guess I missed a step somewhere.

github-actions · 2026-08-15T14:02:13Z

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

github-actions · 2026-08-31T16:58:06Z

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

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

+    if (shouldTrackEpisodes && hasEpisodeCache) {
+      const existingEpisodes = dbEpisodesBySeasonId.get(season.id) ?? [];
+      const toSave: Episode[] = [];
+
+      for (const existingEpisode of existingEpisodes) {
+        const hasFile = episodeHasFileByNumber.get(
+          existingEpisode.episodeNumber
+        );
+        const currentStatus = existingEpisode[is4k ? 'status4k' : 'status'];
+
+        if (
+          hasFile !== true &&
+          currentStatus !== MediaStatus.DELETED &&
+          currentStatus !== MediaStatus.UNKNOWN
+        ) {
+          existingEpisode[is4k ? 'status4k' : 'status'] = MediaStatus.DELETED;
+          toSave.push(existingEpisode);
+        }
+      }


Rows for numbers Sonarr no longer returns get marked DELETED but stay in the table, and the season route's guard counts every tracked row regardless of status:

seerr/server/routes/tv.ts

Lines 115 to 130 in 9062976

if (trackedEpisodes.length > 0 && metadataEpisodeNumbers.size > 0) {

const hasEpisodeNumberMismatch = trackedEpisodes.some(

(episode) => !metadataEpisodeNumbers.has(episode.episodeNumber)

);

if (hasEpisodeNumberMismatch) {

logger.debug(

'Skipping episode availability due to episode number mismatch',

{

label: 'API',

tvId: req.params.id,

seasonNumber: req.params.seasonNumber,

metadataEpisodeCount: metadataEpisodeNumbers.size,

trackedEpisodeCount: trackedEpisodes.length,

}

);

So one renumbered episode kills badges for that whole season permanently, with only a debug line to explain it. Delete the rows whose numbers are gone instead of soft-removing them, or maybe filter DELETED out of the guard.

github-actions · 2026-09-15T10:31:10Z

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

0xSysR3ll requested a review from a team as a code owner August 8, 2026 21:38

0xSysR3ll mentioned this pull request Aug 10, 2026

feat(episodes): add episode availability tracking and sync #3361

Open

6 of 7 tasks

0xSysR3ll force-pushed the feat-episode-availability-scanners branch from b2315e6 to 105baae Compare August 10, 2026 16:26

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

0xSysR3ll force-pushed the feat-episode-availability-scanners branch from 105baae to 7e1e85c Compare August 15, 2026 14:06

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

0xSysR3ll force-pushed the feat-episode-availability-scanners branch from 7e1e85c to c355d99 Compare August 15, 2026 14:39

0xSysR3ll mentioned this pull request Aug 15, 2026

feat: track episode availability from media servers scanners #3402

Open

4 of 7 tasks

0xSysR3ll changed the title ~~feat: wire episode availability to Sonarr scanner~~ feat: track episode availability from sonarr Aug 18, 2026

0xSysR3ll marked this pull request as draft August 18, 2026 17:15

0xSysR3ll force-pushed the feat-episode-availability-scanners branch 2 times, most recently from e1d4158 to 3937280 Compare August 18, 2026 19:56

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

0xSysR3ll force-pushed the feat-episode-availability-scanners branch from 3937280 to 2a65ca9 Compare August 31, 2026 17:02

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

0xSysR3ll force-pushed the feat-episode-availability-scanners branch from 2a65ca9 to ab54e8f Compare August 31, 2026 17:16

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

fallenbagel requested changes Aug 31, 2026

View reviewed changes

0xSysR3ll force-pushed the feat-episode-availability-scanners branch 2 times, most recently from d7c374a to 93eab24 Compare September 2, 2026 18:46

rrizik mentioned this pull request Sep 13, 2026

[Feature Request] Single episode requests #264

Open

1 task done

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

0xSysR3ll force-pushed the feat-episode-availability-scanners branch from 93eab24 to 5578a5e Compare September 18, 2026 21:46

0xSysR3ll added 2 commits September 18, 2026 23:46

feat: wire episode availability to Sonarr scanner

88eb2da

fix(episodes): avoid stale Sonarr episode rows breaking season badges

5578a5e

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

View reviewed changes

Comment thread server/lib/availabilitySync.ts Fixed

Comment thread server/lib/availabilitySync.ts Fixed

fix(availability): fetch TMDB show before episode tracking gate

0321ea6

0xSysR3ll merged commit 0ffd199 into develop Sep 18, 2026
4 checks passed

0xSysR3ll deleted the feat-episode-availability-scanners branch September 18, 2026 21:54

0xSysR3ll restored the feat-episode-availability-scanners branch September 18, 2026 21:54

snapetech mentioned this pull request Oct 31, 2026

feat: track individual Sonarr episode availability snapetech-org/seerrng#454

Draft

Navigation Menu

Repository navigation

feat: track episode availability from sonarr - #3355

feat: track episode availability from sonarr#3355
0xSysR3ll merged 3 commits into
feat-episode-availabilityfrom
feat-episode-availability-scanners

0xSysR3ll commented Aug 8, 2026 •

edited by coderabbitai Bot

Loading

Uh oh!

coderabbitai Bot commented Aug 8, 2026 •

edited

Loading

Uh oh!

fallenbagel commented Aug 9, 2026

Uh oh!

0xSysR3ll commented Aug 9, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Aug 15, 2026

Uh oh!

github-actions Bot commented Aug 31, 2026

Uh oh!

Uh oh!

Uh oh!

fallenbagel Aug 31, 2026

Uh oh!

Uh oh!

github-actions Bot commented Sep 15, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

	if (trackedEpisodes.length > 0 && metadataEpisodeNumbers.size > 0) {
	const hasEpisodeNumberMismatch = trackedEpisodes.some(
	(episode) => !metadataEpisodeNumbers.has(episode.episodeNumber)
	);

	if (hasEpisodeNumberMismatch) {
	logger.debug(
	'Skipping episode availability due to episode number mismatch',
	{
	label: 'API',
	tvId: req.params.id,
	seasonNumber: req.params.seasonNumber,
	metadataEpisodeCount: metadataEpisodeNumbers.size,
	trackedEpisodeCount: trackedEpisodes.length,
	}
	);

Conversation

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

Uh oh!

Description

How Has This Been Tested?

Screenshots / Logs (if applicable)

Checklist:

Summary by CodeRabbit

Uh oh!

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

Uh oh!

Uh oh!

fallenbagel commented Aug 9, 2026

Uh oh!

0xSysR3ll commented Aug 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Aug 15, 2026

Uh oh!

github-actions Bot commented Aug 31, 2026

Uh oh!

Uh oh!

Uh oh!

fallenbagel Aug 31, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

github-actions Bot commented Sep 15, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

0xSysR3ll commented Aug 8, 2026 •

edited by coderabbitai Bot

Loading

coderabbitai Bot commented Aug 8, 2026 •

edited

Loading

0xSysR3ll commented Aug 9, 2026 •

edited

Loading