This release includes 5 breaking changes for platform teams planning a safe upgrade.
✓ No known CVEs patched in this version
Topics
+6 more
Affected surfaces
Summary
AI summaryUpgrading from v1 requires a fresh database and configuration; data migration is not supported.
Full changelog
[!IMPORTANT]
Upgrading from v1 is not a seamless process. Data migration is not supported. You will need to start with a fresh database and configuration. Please read the v2 Breaking Changes guide in full before proceeding, and back up your existing data beforehand.
Major thanks to @LuceoEtzio for their contributions to anibridge/anibridge-mappings. AniBridge wouldn't be possible without it ❤️.
What's Changed
- Rename project from PlexAniBridge to AniBridge, move the GitHub org, Docker image, and mappings repository; sunset deprecated v1 features by @eliasbenb in #193 #194
- Introduce library and list provider agnostic abstractions with official support for Plex, Jellyfin, Emby, AniList, and MyAnimeList; add
provider_classesoption to load third-party providers by @eliasbenb in #197 #198 c8f79b06 - Add simplified config with web editor; rename
sync_modes→scan_modesandsync_interval→scan_interval; nest web UI settings under awebkey; shared settings are now underglobal_configby @eliasbenb in #198 #199 - Replace
excluded_sync_fieldswithsync_rules, supporting field disabling, templates, and Python expression-based custom rules; splitdestructive_syncso that regression prevention is now independently controlled via theprevent_regressionstemplate by @eliasbenb in #208 #224 c744e77b - Introduce v3 mapping schema with source descriptors and explicit bidirectional episode ranges; all v1 custom mappings must be recreated; add Zstandard compressed mappings loader for faster startup by @eliasbenb in #200 #203
- Rename
plex_usertohome_userand restrict it to Plex Home user switching; standard users can now authenticate directly with their own token by @eliasbenb in https://github.com/anibridge/anibridge-plex-provider/pull/4 https://github.com/anibridge/anibridge-plex-provider/commit/9d7f60b694974112307fc771562b8515d813aa3d - Reduce heap memory usage from ~1 GB to ~300 MB by @eliasbenb in bf6febc 4128f43
- Improve FastAPI and iteration performance; improve timeline page load times by @eliasbenb in #230 #231
- Overhaul caching utilities to fix stale caches and improve cache isolation; fix various instances of caches slowing down processes by @eliasbenb in https://github.com/anibridge/anibridge-utils/commit/fb71524eb5c19264cf9b961e647abb649e0d3d4b 462b2935
- Add mapping ratio support with weighted and segmented range calculations; add controls for disabling and restoring mapping ranges; centralize mapping ratio schema by @eliasbenb in #225 #227 cfaab42d
- Add cron string support for
scan_intervalandpoll_interval; make poll interval independently configurable by @eliasbenb in #212 #226 - Add
rate_limitconfiguration options for the AniList and MAL providers by @eliasbenb in https://github.com/anibridge/anibridge-anilist-provider/commit/826b21499093ab8b7326115e047278b17569950c - Add
empty_syncoption to createplanningentries for items with no watch activity by @eliasbenb in a082758d - Add support for restarting the server from the frontend by @eliasbenb in #213 #232
- Update
user_ratingsync to prefer averaging episode ratings when more than half of all episodes are rated by @eliasbenb in a52e91de - Make dry run sync history ephemeral by @eliasbenb in #229
- Display disabled profiles that failed initialization on the dashboard by @eliasbenb in e1791f6e
- Fix Plex, Jellyfin, and Emby continue watching status desync and providers silently continuing on critical errors by @eliasbenb in https://github.com/anibridge/anibridge-plex-provider/commit/1445842728c3947744596dbe129ae3ed19dfba12 https://github.com/anibridge/anibridge-plex-provider/commit/e3bec8ca8ac6bddd468b081f77c08794b9b59a71
- Fix status calculation logic for shows by @eliasbenb in 75b06d3a
- Fix possible SQLite primary key collisions when deleting and re-inserting entries by @eliasbenb in 6846a4dd
- Fix log viewer returning lines non-deterministically when length-limited by @eliasbenb in a03d3969
- Harden scheduler by @eliasbenb in #209
- Add timeline debug info by @eliasbenb in #210
- Official Unraid CA template by @eliasbenb in https://github.com/anibridge/anibridge-unraid-templates/commit/1bc844f595061b69254c844616a3dbf9dc8c9bfe
Full Changelog: https://github.com/anibridge/anibridge/compare/v1.10.1...v2.1.0
Breaking Changes
- Upgrading from v1 is not seamless; data migration unsupported – start with a fresh database and configuration.
- Rename `sync_modes` → `scan_modes` and `sync_interval` → `scan_interval`.
- Replace `excluded_sync_fields` with `sync_rules`; split `destructive_sync` into independent `prevent_regressions` template.
- Introduce v3 mapping schema; all v1 custom mappings must be recreated.
- Rename `plex_user` to `home_user` and restrict it to Plex Home user switching.
Weekly OSS security release digest.
The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.
No spam, unsubscribe anytime.
Share this release
Related context
Beta — feedback welcome: [email protected]