Skip to content

refactor: unify Overseerr and Jellyseerr into single Seerr abstraction#2397

Merged
ydkmlt84 merged 5 commits into
Maintainerr:mainfrom
enoch85:seerr-migration
Feb 28, 2026
Merged

refactor: unify Overseerr and Jellyseerr into single Seerr abstraction#2397
ydkmlt84 merged 5 commits into
Maintainerr:mainfrom
enoch85:seerr-migration

Conversation

@enoch85

@enoch85 enoch85 commented Feb 21, 2026

Copy link
Copy Markdown
Collaborator

Summary

Unifies the separate Overseerr and Jellyseerr integrations into a single Seerr abstraction. They are forks of the same project with identical APIs — maintaining two parallel implementations was unnecessary duplication.

What changed

  • Merged duplicate services, getters, UI components, and contracts into single seerr-* equivalents
  • Renamed DB columns (overseerr_urlseerr_url, forceOverseerrforceSeerr, etc.)
  • Removed Application.JELLYSEERR enum value; Application.SEERR covers both

Migration

Fully automatic — no user action required:

  • Settings: COALESCE(overseerr_url, jellyseerr_url)seerr_url
  • Rules: JSON references to app ID 5 (Jellyseerr) rewritten to 3 (Seerr)
  • Collections: forceOverseerr values preserved as forceSeerr

Backward compatibility

API route aliases for /overseerr and /jellyseerr endpoints are retained so existing consumers are not broken.

@enoch85 enoch85 requested a review from ydkmlt84 as a code owner February 21, 2026 22:38
@enoch85

enoch85 commented Feb 21, 2026

Copy link
Copy Markdown
Collaborator Author

@ydkmlt84 This is ready now.

Once we merge jellyfin-dev to main, I'll change the base here to main instead, and you can review/merge/whatever.

@enoch85 enoch85 self-assigned this Feb 25, 2026
@enoch85 enoch85 changed the base branch from jellyfin-dev to main February 27, 2026 19:45
Consolidate the separate Overseerr and Jellyseerr integrations into a single
'Seerr' abstraction. Both Overseerr and Jellyseerr are forks of the same
project with identical APIs, so maintaining two parallel implementations was
unnecessary duplication.

Changes:
- Merge OverseerrApiService + JellyseerrApiService into SeerrApiService
- Merge OverseerrGetterService + JellyseerrGetterService into SeerrGetterService
- Merge Overseerr + Jellyseerr UI settings components into single Seerr component
- Rename DB columns: overseerr_url/overseerr_api_key -> seerr_url/seerr_api_key
- Rename DB column: forceOverseerr -> forceSeerr on collection table
- Drop jellyseerr_url/jellyseerr_api_key columns (redundant after merge)
- Remove Application.JELLYSEERR (5) enum value; Application.SEERR (3) covers both
- Unify cache IDs from separate overseerr/jellyseerr entries to single seerr entry
- Remove duplicate JELLYSEERR rule constants (identical props to OVERSEERR)

Data migration (automatic on upgrade):
- Settings: COALESCE(overseerr_url, jellyseerr_url) -> seerr_url (and api_key)
- Rules: ruleJson firstVal/lastVal app ID 5 (JELLYSEERR) rewritten to 3 (SEERR)
- Collection: forceOverseerr values preserved as forceSeerr

Backward-compatible API route aliases retained for /overseerr and /jellyseerr
endpoints so existing consumers are not broken.

Net result: -1130 lines of code, zero duplicated logic.
The hand-written migration was missing the totalSizeBytes column in the
collection table recreation, causing a fatal crash after migration.
Regenerated with TypeORM and preserved manual COALESCE data migration
for overseerr/jellyseerr → seerr and ruleJson REPLACE for enum values.
@ydkmlt84 ydkmlt84 merged commit e52cfeb into Maintainerr:main Feb 28, 2026
9 checks passed
@enoch85 enoch85 deleted the seerr-migration branch February 28, 2026 08:51
enoch85 added a commit to enoch85/Maintainerr that referenced this pull request Feb 28, 2026
…ndling branch

Resolve conflicts from the Seerr migration (PR Maintainerr#2397) which unified
Overseerr and Jellyseerr into a single Seerr abstraction. Accept
deletions of old Jellyseerr-specific files, carry over connection-test
utilities to the unified Seerr service, and preserve parallel test
execution in settings.
@github-actions

Copy link
Copy Markdown
Contributor

🎉 This PR is included in version 3.0.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants