feat(episodes): add episode availability tracking and sync by 0xSysR3ll · Pull Request #1671 · seerr-team/seerr

0xSysR3ll · 2025-05-19T22:13:08Z

Description

This allows seerr to track the availability status of individual episodes, enabling better status reporting for partially available seasons.

Fixes See which episode of a series is available and which not #270

How Has This Been Tested?

Screenshots / Logs (if applicable)

Settings

Result

If TVDB not set

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
- Toggle to enable episode availability tracking in Settings with helper text and localization
- Episode availability badges shown on TV season/episode views when enabled
- Public settings now expose episode availability and metadata provider options
Chores
- Database and models updated to store and surface per-episode availability
- Background sync updated to fetch, cache and persist per-episode availability
- API responses include availability mapping for seasons
Migrations
- Added migration to create episode table for availability storage

fallenbagel · 2025-05-19T23:20:55Z

This will not work properly when theres a mismatch between tvdb and tmdb right? Thats why our original plan was to wait till tvdb pr is merged until this feature.

Unless you have some other ideas? (Haven't gone through the code yet)

0xSysR3ll · 2025-05-20T07:43:07Z

This will not work properly when theres a mismatch between tvdb and tmdb right? Thats why our original plan was to wait till tvdb pr is merged until this feature.

Unless you have some other ideas? (Haven't gone through the code yet)

You’re absolutely right about the TVDB/TMDB mismatch concern - I considered that during implementation. Instead of relying on direct TMDB ID mapping, I leveraged the existing Sonarr connection via externalServiceId and match episodes based on season and episode numbers. This approach works well for the majority of shows where episode numbering aligns across databases.

That said, I recognize there will be edge cases where TVDB and TMDB have inconsistent episode structures. I saw this as a pragmatic first step that covers most use cases.

I thought about a few options moving forward:
• Merge this as-is to support the majority of shows now.
• Hold off until the TVDB PR lands to enable more precise mapping.
• Make this behavior optional until we have more robust TVDB integration.

Wdyt ?

fallenbagel · 2025-05-31T00:33:54Z

Hold off until the TVDB PR lands to enable more precise mapping.

I think this would be the better idea. Or it will cause an influx of support requests saying why is this episode not available when it is etc etc

github-actions · 2025-09-02T20:42:58Z

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

Gauvino · 2025-09-02T20:44:10Z

Can a preview be made for this PR when the merge conflicts are resolved?

0xSysR3ll · 2025-09-02T21:03:09Z

Can a preview be made for this PR when the merge conflicts are resolved?

It still needs reviews and the merge of tvdb implementation's PR.

Gauvino · 2025-09-02T21:05:39Z

The merge of the tvdb is done

0xSysR3ll · 2025-09-03T21:30:58Z

The merge of the tvdb is done

Now it is yes

gauthier-th · 2025-09-04T09:49:38Z

Following up on the previous comments about episode mismatch with TMDB:
Do you think it would be a good idea to be able to enable this feature ONLY when TVDB is configured as metadata provider?
As said above, people will not understand why there are a lot of mismatch when they're using TMDB (the default metadata provider) and will constantly ask why there is a "bug".

0xSysR3ll · 2025-09-04T12:07:18Z

Do you think it would be a good idea to be able to enable this feature ONLY when TVDB is configured as metadata provider?

Yep, I think so. But we should be pretty clear about this - with a tooltip or something.

0xSysR3ll · 2025-09-05T19:51:17Z

@gauthier-th Just added a setting to make it optional. And sync only works when TVDB is set as metadata provider for either tv or anime.

gauthier-th · 2025-09-08T14:30:37Z

Isn't it weird to display an "error" badge when the episode is not available but not released yet? Or not requested yet?

0xSysR3ll · 2025-09-08T17:28:17Z

Isn't it weird to display an "error" badge when the episode is not available but not released yet? Or not requested yet?

Would an airdate check be enough? IMO the "Unavailable" badge should still appear even if the episode hasn't been requested. This could be changed later as part of the "per-episode request feature" ?

gauthier-th · 2025-09-08T17:46:07Z

Isn't it weird to display an "error" badge when the episode is not available but not released yet? Or not requested yet?

Would an airdate check be enough? IMO the '‘Unavailable" badge should still appear even if the episode hasn't been requested yet.

I mean, we don't write the status of a season when it's not requested. We only write "Requested" or "Available"/"Partially Available". Not a status in the error color, implying an error when it's "just" missing

0xSysR3ll · 2025-09-08T18:58:02Z

I mean, we don't write the status of a season when it's not requested. We only write "Requested" or "Available"/"Partially Available". Not a status in the error color, implying an error when it's "just" missing

Ah, that makes sense - my mistake. I thought it might be a small UX improvement, but you're right, it could be misleading.

This allows Jellyseerr to track the availability status of individual episodes, enabling better status reporting for partially available seasons.

The PR should not fix the issue reported in recent tvdb PR. Signed-off-by: 0xsysr3ll <0xsysr3ll@pm.me>

Signed-off-by: 0xsysr3ll <0xsysr3ll@pm.me>

…ading Signed-off-by: 0xsysr3ll <0xsysr3ll@pm.me>

…ilitySync to use getEpisodes Signed-off-by: 0xsysr3ll <0xsysr3ll@pm.me>

…y sync

…ude season index

0xSysR3ll marked this pull request as ready for review May 19, 2025 22:14

0xSysR3ll requested review from fallenbagel and gauthier-th as code owners May 19, 2025 22:14

fallenbagel added the blocked This issue can't be solved for now label Aug 19, 2025

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

0xSysR3ll force-pushed the feat-episode-availability branch from 1b35dd4 to 84dc865 Compare September 3, 2025 21:14

github-actions Bot removed the merge conflict Cannot merge due to merge conflicts label Sep 3, 2025

github-advanced-security AI found potential problems Sep 3, 2025

View reviewed changes

Comment thread server/api/servarr/sonarr.ts Fixed

gauthier-th removed the blocked This issue can't be solved for now label Sep 4, 2025

gauthier-th mentioned this pull request Sep 4, 2025

feat(notifications): adds a NEW_EPISODE notification for Jellyfin #1589

Closed

3 tasks

0xSysR3ll force-pushed the feat-episode-availability branch from 6624144 to 5e586d6 Compare September 5, 2025 19:46

gauthier-th requested changes Sep 8, 2025

View reviewed changes

Comment thread cypress/config/settings.cypress.json Outdated

Comment thread src/components/TvDetails/Season/index.tsx Outdated

Comment thread server/lib/availabilitySync.ts

Comment thread server/routes/tv.ts Outdated

0xSysR3ll force-pushed the feat-episode-availability branch from 5e586d6 to 2a62eb7 Compare September 8, 2025 19:26

0xSysR3ll commented Sep 8, 2025

View reviewed changes

Comment thread src/components/TvDetails/Season/index.tsx Outdated

gauthier-th mentioned this pull request Sep 10, 2025

Roadmap for Seerr #926

Open

0xSysR3ll force-pushed the feat-episode-availability branch 2 times, most recently from e39ead7 to d477dd4 Compare April 25, 2026 07:29

0xSysR3ll added 26 commits April 25, 2026 09:36

feat(episodes): add episode availability tracking and sync

f9b73e2

This allows Jellyseerr to track the availability status of individual episodes, enabling better status reporting for partially available seasons.

chore(tv): removed the wrong parameter.

840a7a5

The PR should not fix the issue reported in recent tvdb PR. Signed-off-by: 0xsysr3ll <0xsysr3ll@pm.me>

feat(settings): make the feature optionnal

19d169a

Signed-off-by: 0xsysr3ll <0xsysr3ll@pm.me>

fix(ui): only display availability if provider is tvdb

4176f44

Signed-off-by: 0xsysr3ll <0xsysr3ll@pm.me>

fix(api): only mark episode as available if provider is tvdb

0b2ed10

Signed-off-by: 0xsysr3ll <0xsysr3ll@pm.me>

fix(cypress): add missing newline

ffadd46

Signed-off-by: 0xsysr3ll <0xsysr3ll@pm.me>

fix(tv): rely on provider type instead of setting

fd4ef50

Signed-off-by: 0xsysr3ll <0xsysr3ll@pm.me>

feat(settings): add metadata settings for TV and anime

a50497c

Signed-off-by: 0xsysr3ll <0xsysr3ll@pm.me>

refactor(tv): simplify episode availability checks

d0728d5

Signed-off-by: 0xsysr3ll <0xsysr3ll@pm.me>

fix(settings): missing metadata settings

2474630

Signed-off-by: 0xsysr3ll <0xsysr3ll@pm.me>

feat(availability): implement episode caching

a7bfd95

Signed-off-by: 0xsysr3ll <0xsysr3ll@pm.me>

refactor(season): make episodes property optional and remove eager lo…

ba89999

…ading Signed-off-by: 0xsysr3ll <0xsysr3ll@pm.me>

refactor(api): remove getEpisodesBySeriesId method and update availab…

5c9486f

…ilitySync to use getEpisodes Signed-off-by: 0xsysr3ll <0xsysr3ll@pm.me>

chore: apply linting

e98f7a8

refactor(tv): change getSettings to synchronous call

1ff6d39

refactor(availability): enhance episode tracking logic in availabilit…

ec5d977

…y sync

chore: restore old changes

4c05fde

chore: reapply linting

c4546b2

feat(migration): add episode table migrations

85a7683

feat(episode): add index on season

d797661

feat(settings): add warning for episode availability without TVDB set

3dec6ed

refactor(migration): replace old episode table migration with to incl…

db8970c

…ude season index

refactor(episode): move index on ManyToOne relationship with Season

6629bf9

refactor(Episode): we shouldn't use onUpdate

ee892e3

feat: update migrations

18e0451

chore: remove old migrations

5c2bb1e

0xSysR3ll force-pushed the feat-episode-availability branch from d477dd4 to 5c2bb1e Compare April 25, 2026 07:38

0xSysR3ll requested a review from gauthier-th April 27, 2026 14:03

Uh oh!

Conversation

0xSysR3ll commented May 19, 2025 • edited 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)

Settings

Result

If TVDB not set

Checklist:

Summary by CodeRabbit

Uh oh!

fallenbagel commented May 19, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

0xSysR3ll commented May 20, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

fallenbagel commented May 31, 2025

Uh oh!

github-actions Bot commented Sep 2, 2025

Uh oh!

Gauvino commented Sep 2, 2025

Uh oh!

0xSysR3ll commented Sep 2, 2025

Uh oh!

Gauvino commented Sep 2, 2025

Uh oh!

Uh oh!

0xSysR3ll commented Sep 3, 2025

Uh oh!

gauthier-th commented Sep 4, 2025

Uh oh!

0xSysR3ll commented Sep 4, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

0xSysR3ll commented Sep 5, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

gauthier-th commented Sep 8, 2025

Uh oh!

0xSysR3ll commented Sep 8, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

gauthier-th commented Sep 8, 2025

Uh oh!

0xSysR3ll commented Sep 8, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

0xSysR3ll commented May 19, 2025 •

edited

Loading

fallenbagel commented May 19, 2025 •

edited

Loading

0xSysR3ll commented May 20, 2025 •

edited

Loading

0xSysR3ll commented Sep 4, 2025 •

edited

Loading

0xSysR3ll commented Sep 8, 2025 •

edited

Loading