CrossWatch v0.9.19

Just a small cleanup release.
Icons now load locally for better privacy and the exporter provider selector no longer shows a duplicate dropdown.

We are getting close to the v1.0.0 production thus stable release. From that point onward, production and development releases will be handled separately, so stable users can stay on reliable builds while development changes can continue without disturbing the production version.

🔧 Fixes & Improvements

• Improved: Material Symbols icons are now loaded locally instead of from Google Fonts, improving privacy and compatibility with restricted networks.
• Fixed: The exporter now shows only the intended icon-based provider selector instead of rendering a duplicate dropdown.
• Changed: Updated the version to v0.9.19

CrossWatch v0.9.18

New Quick Add for desktop and mobile, manually send history, ratings and watchlist actions to one or more providers for titles watched outside your normal media server flow.

WIKI: https://wiki.crosswatch.app/crosswatch/navigation/quick-add

✨ Highlights

• Added: new Plex watcher route filter to ignore Live TV & DVR playback.
• Added: Quick Add for manually sending watched history, watchlist entries, and ratings to configured providers.

🔧 Fixes & Improvements

• Fixed: Jellyfin and Emby pair setups now correctly hide and disable Ratings where ratings sync is not supported.
• Fixed: Dashboard startup no longer waits on slow cold /api/status provider probes before loading the main widgets.
• Improved: /api/status now runs provider user-info lookups concurrently to reduce cold status latency.
• Improved: /api/state/wall now caches repeated identical responses until sync state, config, or wall filters change.
• Changed: Watchlist auto-remove now targets providers from enabled watchlist pairs instead of scanning all configured providers.

CrossWatch v0.9.17

Strict ID matching is now the default for Plex, Jellyfin, and Emby, because title fallback causes too many false positives.
Existing pairs needs to be changed manually (but only if you have issues)

If you have Plex and/or MDBList in your pairs: Maintenance -> Clear everything (or state and provider cache)

✨ Highlights

• Refactored Sync Hub previews item/title spotlights are now delivered through the UI summary path instead of the raw sync output.
• Updated: Providers pair settings now use Strict ID matching as the new default standard for newly configured pairs**
  • for existing pairs you need to change it in your pair - providers - Plex/Emby/Jellyfin and enable Strict ID Matching

🔧 Fixes & Improvements

• Fixed: One-way MDBList -> Plex ratings no longer apply mirror-style removals in non-mirror mode.
• Fixed: MDBList rating deletions are now detected more reliably when only journal activity changes.
• Fixed: Watchlist poster view could fail to render covers because of an undefined typeLabel error
• Fixed: Re-adding ratings after a delete no longer fails because sparse MDBList journal rows dropped needed metadata.
• Fixed: Plex history items can now be re-added after removal because stale local watched-cache state is cleared correctly.
• Fixed: upgrade warning reappearing after the first acknowledgement

CrossWatch v0.9.16

A lot of work in this version went into making sync behavior easier to trust in day-to-day use.
The goal was simple: make sync behavior more predictable, make summaries easier to trust and reduce false positives.

A big part of the providers (trackers/media servers) are refactored.
All providers, trackers, and media servers now use x.x versioning instead of x.x.x, starting from version 1.0.

As always when providers are changed. Maintenance -> Clear state and provider cache (or Clean everything)

✨ Highlights

• Ignore dropped shows support for MDBList, Trakt, and SIMKL, so your dropped titles can be excluded from sync behavior.
• CW Tracker progress support progress can now be synced into and out of the CrossWatch tracker just like Plex, Emby, and Jellyfin.
• Improved Analyzer is now more useful: as it validates sync providers and orchestrator modules.

🔧 Fixes & Improvements

• Fixed: Multiple edge cases where rating changes in two-way sync could be misread as adds or removals.
• Fixed: Re-rating items after deleting a rating could be blocked by stale pair tombstone behavior.
• Fixed: Recent sync summaries could show wrong counts because fallback stats could overwrite real zero-result runs.
• Fixed: Spotlight rows stay aligned with the actual applied sync results.
• Fixed: Apply events now carry richer spotlight data, improving reliability of the live sync UI.
• Fixed: Watermarks, shadow caches, and unresolved tracking are now handled more safely during capture/backup-style operations.
• Fixed: Progress fields are now preserved more reliably in persisted state, improving editor visibility and analyzer accuracy.
• Fixed: Editor loading was improved
• Improved: MDBList history syncing now handles rollups, episode removals, and journal-driven deletes much more reliably.
• Improved: SIMKL, Trakt, and MDBList large delete/apply operations now use safer provider-side chunking
• Improved: Cleanup tools now run in capture-style mode
• Improved: Compact/mobile handling is now smarter.
• Improved: Provider comparison logic was refactored to better match the way different services represent.
• Improved: Internal sync guardrails around tombstones, unresolved items, etc.
• Improved: Analyzer results are now more readable for end users, with clearer messages and better grouping.

CrossWatch v0.9.15

Normally, I do about one release per week. But...

This one is an URGENT UPDATE and I strongly recommend everyone update to this image as soon as possible. Why? Because I broke it :-(

✨ Highlights

• Global defaults and per-route control: Watcher settings now support both global defaults and route-specific options.
  • Simple setups stay easy while advanced setups get much more flexibility. https://github.com/cenodude/CrossWatch/issues/172
  • For the plex ratings webhook you can now create a webhook per route. I think nobody will use it...but its there.
  • For auto-remove on watchlist, same thing. You can set it globally or per route.
• Watcher routes refreshed: Filters and options now open directly per route, making watcher setup much easier to understand. https://github.com/cenodude/CrossWatch/issues/172
• Better active playback UI: The playing card and scheduler banner supports better multiple active streams. https://github.com/cenodude/CrossWatch/issues/173
• Trailer modal refreshed: provides a cleaner and better embedded viewing experience. https://github.com/cenodude/CrossWatch/issues/182

🔧 Fixes & Improvements

• Removed: Old legacy watcher code, leftover UI pieces, and outdated migration paths. https://github.com/cenodude/CrossWatch/issues/169
• Fixed: MDBList watchlist items are now classified more accurately. https://github.com/cenodude/CrossWatch/issues/177
• Fixed: Watchlist trailer playback now opens correctly again from the watchlist detail card. https://github.com/cenodude/CrossWatch/issues/182
• Fixed: Route filters now work correctly for Plex, Jellyfin, and Emby, including usernames, user IDs, and server UUIDs. https://github.com/cenodude/CrossWatch/issues/168
• Fixed: Watcher output tab showed only Plex and traks logs, thats fixed now and includes all watcher providers https://github.com/cenodude/CrossWatch/issues/170
• Fixed: Settings no longer spam repeated background config requests when you are not actively setting up a provider. https://github.com/cenodude/CrossWatch/issues/176
• Fixed: Watcher logs no longer spam the same filtered-session message over and over during blocked playback. https://github.com/cenodude/CrossWatch/issues/179
• Fixed: Unified watchlist items are now merged more reliably when different providers store the same title under different IDs. https://github.com/cenodude/CrossWatch/issues/177
• Added: Per-route watcher options such as route-specific auto-remove, plus custom Plex ratings webhooks. https://github.com/cenodude/CrossWatch/issues/172
• Added: New lightweight health check endpoints: /api/health and /healthz for your docker healthcheck https://github.com/cenodude/CrossWatch/issues/175
• Improved: Plex history and ratings indexing now use parallel workers. In testing, about a 34% speed improvement https://github.com/cenodude/CrossWatch/issues/181
• Improved: Jellyfin and Emby watcher behavior is now much closer to Plex for seek, progress, and stop handling. https://github.com/cenodude/CrossWatch/issues/172
• Improved: Watcher and sink logging is now more consistent and easier to follow. https://github.com/cenodude/CrossWatch/issues/172
• Improved: Watchlist delete actions now resolve correctly across providers with merged IDs. https://github.com/cenodude/CrossWatch/issues/177
• Improved: Watchlist metadata is now batched per visible set instead of sending one metadata request per item. https://github.com/cenodude/CrossWatch/issues/174
• Improved: Watchlist row hydration now only requests the metadata needed for the list view. https://github.com/cenodude/CrossWatch/issues/174
• Improved: Metadata cache reuse on the watchlist page is more effective and reducing unnecessary TMDb traffic. https://github.com/cenodude/CrossWatch/issues/174
• Improved: Main-page watchlist preview now loads faster by rendering sooner. https://github.com/cenodude/CrossWatch/issues/182
• Improved: Watchlist and playing-card metadata reuse is now more effective. https://github.com/cenodude/CrossWatch/issues/182

🔐 Security

• UI and Security: In Security UI added “Other browser sessions” summary with a single “Log out other sessions” action. https://github.com/cenodude/CrossWatch/issues/183

CrossWatch v0.9.14

Authentication is now mandatory. As it is the only reliable way to properly protect the endpoints.
To make things a bit easier, I added extended session caching and also Plex SSO support.

In the background, I am also working on a major overhaul of the orchestrator and providers, with more improvements coming in the next releases. The goal for the orchestrator/provider overhaul is better matches and less API requests.

After the upgrade to a hard browser refresh: Ctrl+Shift+R or Ctrl+F5

✨ Highlights

• Authentication:
  • New login screen: cleaner layout, improved session options.
  • Plex SSO: CrossWatch can now use a linked Plex account for sign-in, while still keeping the normal local admin login as fallback.
• Settings refresh: Settings overview has now a more progress-step approach. Making it easier for new users...well, i hope.
• Advanced Scheduling: can now trigger actions by events (watcher/webhook activity) and capture scheduling
• Scheduling UX refresh: Standard Scheduling is now more flexible with more recurrence options.
  • both Standard and Advanced Scheduling have a clearer setup experience.
• Connection Setup: the Configure Connection modal was refreshed.

🔧 Fixes & Improvements

• New: optional Sign in with Plex button on the login page for linked Plex admins.
• New: Security settings now allow linking or unlinking a Plex account for CrossWatch sign-in.
• Improved: authentication now reuses existing CrossWatch session cache and middleware protection.
• Improved: login and security settings received additional UI polish and clearer auth/session messaging.
• Improved: Standard Scheduling now supports Every hour, Every N hours, Daily at, and Custom interval modes. https://github.com/cenodude/CrossWatch/issues/165
• Improved: Standard Scheduling now uses a more guided wizard-style setup https://github.com/cenodude/CrossWatch/issues/165
• Improved: both Standard and Advanced Scheduling now include a clearer Current plan summary. https://github.com/cenodude/CrossWatch/issues/165
• Fixed: Sync Output no longer replays duplicate scheduler log lines after reconnecting the live log stream.
• Fixed: some frontend views did not correctly use cached TMDb metadata https://github.com/cenodude/CrossWatch/issues/143
• Fixed: History sync could miss watched history when rating a new movie auto-moved it to completed https://github.com/cenodude/CrossWatch/issues/153
• Fixed: editor watchlist entry could duplicate on sync due to TMDb/IMDb key mismatch https://github.com/cenodude/CrossWatch/issues/147
• Fixed: Sync Details output now refreshes reliably across consecutive syncs https://github.com/cenodude/CrossWatch/issues/154
• Fixed: disabling the CrossWatch tracker now properly hides CrossWatch from Insights, Watchlist, Editor, and Snapshots https://github.com/cenodude/CrossWatch/issues/160
• Removed: the old watcher bridge is removed; if you're still using the legacy watcher setup (<0.9), you need to move to watcher routes.
• Change: Captures now support bundles/full captures for diff compare https://github.com/cenodude/CrossWatch/issues/144
• Change: Captures can be scheduled directly in advanced scheduler or add as queue in Captures https://github.com/cenodude/CrossWatch/issues/89
• Change: added a separate Event Triggers panel next to the existing Time Plan in Advanced Scheduling https://github.com/cenodude/CrossWatch/issues/148
• Change: settings and connection setup now include more helper icons and tooltips https://github.com/cenodude/CrossWatch/issues/158

🔐 Security hardening https://github.com/cenodude/CrossWatch/issues/146

• username masking: for all watcher/sink and webhook logs. You now see only the first two letters of a username.

📚 WIKI updates:

• Scheduler: https://wiki.crosswatch.app/crosswatch/scheduling
• Captures: https://wiki.crosswatch.app/crosswatch/tools/captures
• Plex SSO: https://wiki.crosswatch.app/crosswatch/navigation/ui-settings/security/plex-sso

CrossWatch v0.9.13

Important, after your upgrade to v0.9.13 you cant downgrade. This version now includes encrypted config file, and is not comptabile with older versions. Hope you like the improved interface. The orchestrator and adapters were not changed, so there is no need to delete your cache.

✨ Highlights

• UI Refresh: Updated with a cleaner, more modern and improved status presentation for a fresher overall look (i hope) https://github.com/cenodude/CrossWatch/issues/137
  • updated: UI changes for main, analyzer, exporter, syncbar, Watchlist, Captures, Editor, Settings
• Refactor: Cleaned up, updated, and removed unnecessary parts for significantly better performance. https://github.com/cenodude/CrossWatch/issues/134

🔧 Fixes & Improvements

• Fixed: Scheduler thread is being started even when scheduling is fully disabled. https://github.com/cenodude/CrossWatch/issues/133
• Fixed: Setup wizard now opens correctly again after using Reset all to default https://github.com/cenodude/CrossWatch/issues/136
• Fixed: Browser accessibility/compliance warnings caused by unbound labels. https://github.com/cenodude/CrossWatch/issues/135
• Fixed: Increased modal slightly and fixed status badge clipping in the header area.
• Fixed: Cut down repeated scheduler start/stop messages during save and refresh. https://github.com/cenodude/CrossWatch/issues/132
• Fixed: Insight Settings Filtering:** The provider list in Insight Settings now shows only providers that are configured.
• Change: Added a Copy button to the Sync output toolbar so you can quickly copy the active Sync or Watcher log. https://github.com/cenodude/CrossWatch/issues/131
• Change: Watchlist, swapped the numeric overview for Coverage Pulse.

🔐 Security Enhancements https://github.com/cenodude/CrossWatch/issues/123

• Encrypted secrets: Sensitive values are now stored encrypted in config.json when settings are saved.
  • CW uses a simple local master key file to decrypt them when needed.
  • It will reduce accidental leakage but it does not protect against a compromised host.
  • WIKI: https://wiki.crosswatch.app/crosswatch/configuration-config-json/config-encryption

CrossWatch v0.9.12

Another huge update as i've continuing the work started in 0.9.11, where we moved from IMDb-first to TMDB-first.
I’ve made a bunch of optimizations and tightened up the orchestrator integration, so your sync results should be more reliable.

There’s also a new experimental feature called Progress, which lets you sync resume positions between media servers.

And last, but definitely not least, security has been improved.

IMPORTANT - what you absolutely need to do:

• All Webhooks are now protected with a unique URL/ID token. After updating, every (webhook)user must copy and paste the new webhook URL into their media server.
• As always, clear your existing cache first, it’s the smartest thing you can do. In Settings - Maintenance - Maintenance tools and then Clear Everything
  • If you don’t clear your existing cache, most improvements won’t be applied. That makes all my work a complete waste....so sad..

✨ Highlights

• Progress (Experimental): Sync resume position between Plex, Emby, and Jellyfin https://github.com/cenodude/CrossWatch/issues/119
  • Configurable per pair (source from/to target), supports one-way and two-way sync
  • WIKI: https://wiki.crosswatch.app/crosswatch/configure-pairs/features/progress

🔧 Fixes & Improvements

• History Sync Reliability: https://github.com/cenodude/CrossWatch/issues/117

  • Fixed a state persistence issue that could cause history statistics to shrink after a subsequent sync run.
  • CW now preserves watched timestamps/metadata when a provider returns sparse history.
  • Improved ID reconciliation to prevent duplicate history entries when providers disagree on IDs:
    • Uses TMDb first, then falls back to IMDb, then TVDb (in that order) to match the same title across systems.
  • Two-way sync: improved safeguards so ID drift doesn’t trigger false adds/removes or inflated counts.

• Plex Instances / Profiles: Fixed an issue where Plex per-instance library whitelists)were not being saved https://github.com/cenodude/CrossWatch/issues/126

• Plex Instances / Profiles: Fixed an issue where an extra PLEX-P01 could appear in settings. https://github.com/cenodude/CrossWatch/issues/129

• Upgrade Migration: The Migrate action in the upgrade warning modal now performs a real migration for required settings. https://github.com/cenodude/CrossWatch/issues/130

• History Sync Performance (Jellyfin / Emby / Trakt): Much faster history indexing....more speeeeeeeeeeeed https://github.com/cenodude/CrossWatch/issues/125

• Provider Rate Limiting (SIMKL / Trakt / MDBList): Added configurable request throttling to respect upstream API limits. https://github.com/cenodude/CrossWatch/issues/128

• Security Enhancements: https://github.com/cenodude/CrossWatch/issues/123

  • Authentication now fails closed if `config.json exists but can’t be loaded/parsed correctly.
  • Hardened TMDb artwork caching to block path traversal / unintended file overwrite.
  • Webhook endpoints are now protected via a unique URL token generated by CW:
    • /webhook/plextrakt?uniqueID
    • /webhook/jellyfintrakt?uniqueID
    • /webhook/embytrakt?uniqueID
    • /webhook/plexwatcher?uniqueID
  • Added Trusted reverse proxies setting in Settings - Security
    • Use this only if you run CW behind reversed proxies. This will improves secure cookies and rate limiting accuracy.
  • UI logs now redact common secrets (tokens/keys) to reduce leakage.
  • TLS certificate download endpoint now only serves valid X.509 cert files
  • Improved error handling to avoid leaking internal details via API responses.
  • Stronger path validation to prevent unintended directory access via file listing.

CrossWatch v0.9.11

Read this. Or cry later. Your choice.

BREAKING UPDATE: ID priority is now TMDb-first

Classic small change, huge impact.
This affects every sync pair. The old split (IMDb for UI/state, TMDb for sync) became too fragile and kept causing avoidable bugs.
I've changing it now so we can actually reach a stable release someday.

CrossWatch now prefers IDs in this order: TMDb → IMDb → TVDb → (everything else).

Why this matters

• Better matching across providers
• Fewer duplicates and unresolved items

Migration behavior (important)

When you upgrade and click Migrate, we will:

• Wipe your current state and cache
• Temporarily stop your scheduler

This is intentional. It prevents duplicate entries from being pushed to your trackers.

After migration

• Re-enable one pair at a time and let it rebuild your state gradually
• If you have captures; recreate them.
• At the moment DONT do any tracker to media server pairs.

Testing
This also means that large parts of CrossWatch need to be re-tested. I’ll phase this in, because I’m a one-person operation.

• Webhooks / Watcher: Tested
• Sync pairs - Plex to trackers: Tested
• Sync pairs - tracker from/to tracker: Tested

Next up: testing Emby/Jellyfin (and friends). I’m not expecting major issues, but please be careful. Plex has already been updated as a delta provider; we still need to apply the same change for Emby/Jellyfin. Until that’s done, the Emby/Jellyfin results won’t reflect any improvements yet.

🔧 Fixes & Improvements

• CrossWatch: Reorder ID keys for consistency across various modules (TMDB first) https://github.com/cenodude/CrossWatch/issues/117
• Orchestrator: Many improvements for better sync results.
• Plex Sync (History): Fixed an issue where Plex history could drop to 0 on the second sync
• Plex Sync (History): Improved state handling so Plex history is treated as incremental (“delta”)
• Plex Sync (History): Reduced false weird counters in Insights caused by incremental snapshots being stored as full snapshots.
• Plex Sync (History): Improved shows/episode enrichment.
• Trakt Sync (History): Fixed a loop where history sync could report +1 added on every run even when nothing new was added.
• Trakt Sync (History): Improved episode matching
• Trakt Sync (History): Corrected unresolved/blocked handling so repeated failures are properly blocked

CrossWatch v0.9.10

🔧 Fixes & Improvements

• Scrobble: Suppressed user=None playback alerts to reduce filter-log noise when no one is actively watching.
• Scrobble: Fixed non-default scrobble watchers missing playback events when Plex alert payloads omit the account/user field.
• Scrobble: Added a debug log entry before dropping unresolved-user alerts to make it clearer why an event was ignored.
• Scrobble: Improved support for Plex shared-server tokens by using the configured profile username for that watcher.
• Scrobble UI: Fixed route filter settings leaking into the default profile due to cached provider presets while editing routes.
• Captures: Fixed history-restore gaps when two entries share the same watch timestamp.
• Captures: Fixed an edge case where items can return multiple distinct items with the same IMDb ID.
• Sync Engine: Improved bulk sync completion performance by batching internal blackbox/flap bookkeeping instead of updating it item-by-item.
  • Fixed an issue where large sync runs, especially history imports, could appear to stall after the write phase while CrossWatch was still processing internal retry/unresolved tracking.
  • Reduced post-sync overhead for large add/remove operations so runs can finish and report completion more reliably.
• Sync Engine: Improved sync result reporting for large one-way runs.
  • Added clearer accounting for provider-confirmed adds versus internally deduplicated items.
  • Improved skipped-item reporting so inferred remainder skips are tracked more transparently during bulk syncs.
  • Added better visibility into duplicate canonical-key collapse during apply/reporting, which helps explain mismatches between provider-reported adds and final run totals.
• MDBList: Updated the MDBList adapter to v4.1.0.
  • Improved sync compatibility with the current MDBList API blueprint across history, ratings, watchlist, and scrobble flows.
  • Fixed watched-history sync handling for show-level and season-level updates/removals.
  • Improved ratings sync support for additional MDBList-supported IDs, including Trakt, MDBList, and Kitsu where applicable.
  • Hardened watchlist parsing for unified responses and aligned internal health checks/activity tracking with MDBList sync behavior.
• SIMKL: Updated the SIMKL adapter to v4.1.0.
  • Improved compatibility with the current SIMKL API blueprint across history, ratings, watchlist, and scrobble flows.
  • Fixed anime scrobble handling by sending the correct SIMKL payload shape and supporting additional anime IDs where available.
  • Improved history and ratings sync matching by preserving a broader set of SIMKL-supported IDs.
  • Fixed an anime ratings sync issue where SIMKL anime library data could be parsed incorrectly, causing weaker item matching.
  • Hardened Plan to Watch sync by correctly accepting successful SIMKL removals even when the API returns an empty response body.
  • Fixed history season sync handling by sending season entries using SIMKL's documented season payload shape instead of treating them like plain show-level writes.
  • Improved SIMKL history write accounting so successful season-level additions are counted correctly during bulk imports.
• Trakt: Updated the Trakt adapter to v4.4.0.
  • Improved compatibility with the current Trakt API blueprint across history, ratings, watchlist, and scrobble flows.
  • Fixed watched-history sync handling for show-level and season-level updates/removals, and improved support for removing entries by Trakt history ID.
  • Improved watchlist sync support for movies, shows, seasons, and episodes to better match Trakt's supported payloads.
  • Fixed scrobble behavior that could create multiple watched dates when stopping near the end and finishing later (configurable via stop_pause_threshold).
  • Improved scrobble logging by downgrading Trakt 422 pause rejections near the scrobble cutoff to WARN (no longer treated as hard errors).
  • Hardened scrobble handling for duplicate/recent playback conflicts to better align with Trakt responses.

CrossWatch v0.9.9 (quick-fix)

Because of filtering issues affecting Plex users. I’m releasing this quick fix.

This patch is focused on improving user detection and filtering behavior, which should reduce incorrect matches and missed events.
It removes the PMS owner fallback and relies more on actual session/user data, which should give more consistent results.
The main or real issue is that Plex is very inconsistent when it comes to providing the actual usernames.

This is a quick fix(hotfix). It hasn’t been thoroughly tested yet, so treat it as an improvement release rather than a guaranteed final fix.
That said, it should deliver better results than the current (0.9.8) version regaring watcher and filtering for Plex.

🔧 Fixes & Improvements

• Plex: Fixed misidentificationstreams as the server owner, which affect route filters.

CrossWatch v0.9.8

Important (Plex users)

CrossWatch now supports shared Plex servers (servers you don’t own - no PMS owner) thanks for the idea and support @mesitisg
This required major changes to Plex authentication and sync adapters.

Recommended action: Recreate your Plex authentication configs (delete and re-add)

• Disable Watcher first before recreating Plex auth
• You can keep your pairs and watcher config.
• Dont forget to set your whitelists and double check your Plex settings.

✨ Highlights

• Plex: Shared Plex server support is now supported (sync and watcher)

🔧 Fixes & Improvements

• Plex: Keeps separate tokens for Plex account (cloud) and Plex server (PMS) access, so PMS features use the correct token.
• Plex: History and ratings sync now use the PMS-scoped token, fixing shared-server authorization issues.
• Plex: Manual Mark as Watched/Unwatched actions in Plex are now tracked more reliably for history sync and use a separate cache.
• Plex: Fallback-GUID option. History sync no longer drops entries. https://github.com/cenodude/CrossWatch/issues/111
• Scrobble: With multiple scrobble routes, CW now logs a single summary line (wired providers: X | wired sinks: Y).
• Scrobble: Newly created provider profiles/instances now appear immediately in Watcher route dropdowns.
• Scrobble: Fixed route filter UI state leaking between routes. Opening Filters now loads the correct filters for the selected route.
• Scrobble: Removed the Live panel/toggle from the Watcher screen. It was confusing for most users.
• Tautulli: Fixed auth UI where the auth buttons were not visible. (Issue #112)
• Captures: CW now uses a dedicated Capture Mode when creating captures, ignoring cache and watermarks for consistancy. https://github.com/cenodude/CrossWatch/issues/110

CrossWatch v0.9.8

Important (Plex users)

CrossWatch now supports shared Plex servers (servers you don’t own - no PMS owner) thanks for the idea and support @mesitisg
This required major changes to Plex authentication and sync adapters.

Recommended action: Recreate your Plex authentication configs (delete and re-add)

• Disable Watcher first before recreating Plex auth
• You can keep your pairs and watcher config.
• Dont forget to set your whitelists and double check your Plex settings.

✨ Highlights

• Plex: Shared Plex server support is now supported (sync and watcher)

🔧 Fixes & Improvements

• Plex: Keeps separate tokens for Plex account (cloud) and Plex server (PMS) access, so PMS features use the correct token.
• Plex: History and ratings sync now use the PMS-scoped token, fixing shared-server authorization issues.
• Plex: Manual Mark as Watched/Unwatched actions in Plex are now tracked more reliably for history sync and use a separate cache.
• Plex: Fallback-GUID option. History sync no longer drops entries. https://github.com/cenodude/CrossWatch/issues/111
• Scrobble: With multiple scrobble routes, CW now logs a single summary line (wired providers: X | wired sinks: Y).
• Scrobble: Newly created provider profiles/instances now appear immediately in Watcher route dropdowns.
• Scrobble: Fixed route filter UI state leaking between routes. Opening Filters now loads the correct filters for the selected route.
• Scrobble: Removed the Live panel/toggle from the Watcher screen. It was confusing for most users.
• Tautulli: Fixed auth UI where the auth buttons were not visible. (Issue #112)
• Captures: CW now uses a dedicated Capture Mode when creating captures, ignoring cache and watermarks for consistancy. https://github.com/cenodude/CrossWatch/issues/110

CrossWatch v0.9.7

This release streamlines and improves scheduling for a more reliable overall experience.

✨ Highlights

• Scheduler status: The banner and Setting Insight now reflect Standard and Advanced scheduling modes.

🔧 Fixes & Improvements

• Scheduler: guardrails: Switching to Advanced automatically turns Standard off (and vice versa) to prevent conflicting schedules.
• Scheduler: logs: Added scheduler logs (start / next run / trigger / success / failure) so scheduled runs aren’t silent.
• Scheduler: next-run handling: Disabling scheduling no longer shows a far-future placeholder.
• Advanced scheduler: Advanced jobs now correctly catch up if a job time has already passed.
• Advanced scheduler: The banner now makes it obvious when the next run is today vs tomorrow/another day.
• Settings Insight: Insight refreshes far less when the Settings page isn’t open, improving overall UI performance.
• Settings Insight: Prevents re-rendering when nothing changed, reducing repeated icon reloads.

Previous change v0.9.6 below:

CrossWatch v0.9.6

Big changes: the Plex adapter (history and ratings) was refactored for better accuracy and much faster history syncs.
First run may still be slow, but follow-up runs should be way faster.

For users still on v0.8.x, now’s the perfect time to upgrade to v0.9.6.

⚠️ Warning possible breaking update for Trakt History pairs

Trakt is rolling out a change that rounds watched_at to minute precision
I've changed the Trakt adapter following that same principle now.
If you have a pair with Trakt using History then either recreate the pair or even better:
Go to maintenance tools to clean everything. Ref: https://wiki.crosswatch.app/crosswatch/faq

✨ Highlights

• Snapshots - Captures: The UI now labels “Snapshots” as Captures.
• Captures Compare (Advanced): Side-by-side A/B diff viewer. Select two Captures, then click Advanced. Ref: https://wiki.crosswatch.app/crosswatch/tools/captures/capture-compare-advanced

🔧 Fixes & Improvements

• Trakt: minute precision: Changed the Trakt adapter to follow-up the new minute precision approach.
• Plex: Home token reliability: History writes now use the active Plex session token (prevents “sometimes only season 1” / random unresolved writes when Plex Home switching is involved).
• Plex: Strict IDs-only matching: History sync is now fixed and can run in strict ID mode using Plex GUIDs (TMDB/IMDb/TVDB) without title/search fallbacks. This reduces mismatches and makes “IDs-only” actually work.
• Plex: history capture: Plex history capture is now incremental (watermark and correct mindate usage) instead of re-scanning the entire server history every run.
• Plex: Persistent GUID index: Uses a per-pair, on-disk GUID→ratingKey index to speed up strict matching.
• Plex: ratings strict matching improved: Episode/season ratings resolution now also uses show IDs (TMDB/IMDb/TVDB) when matching in Plex, improving accuracy and reducing “unresolved” ratings in strict ID mode.
• Editor: timestamps: “Watched At” display/editing now matches the UI. Manual edits are interpreted in local time and stored consistently (prevents timezone shifts).
• Captures - Compare: Compare is now limited to same provider and same feature to prevent misleading diffs. Ref: https://github.com/cenodude/CrossWatch/issues/97
• Captures - Compare: Smarter diffing (including timestamp normalization) to avoid false “updates” caused by tiny time differences. Ref: https://github.com/cenodude/CrossWatch/issues/97
• Plex: history timestamps: Fixed a potential timezone offset issue by reading Plex history using Plex’s native epoch format for consistent results. Ref: https://github.com/cenodude/CrossWatch/issues/103
• Pair-config - One-Way Remove mode UI toggle: Added a new switch in pair-config under Allow mass delete to control one-way deletion behavior:
  • Enabled (default): Deletions are based on source matches — items are only deleted when a match exists between source and destination.
  • Disabled: Mirror mode (mirror) - always follows source (destructive; use with care).
  • NB: The logics was already available in v0.9.5, i only added the UI toggle.
  • Ref: https://wiki.crosswatch.app/crosswatch/configure-pairs/global-settings

CrossWatch v0.9.6

Big changes: the Plex adapter (history and ratings) was refactored for better accuracy and much faster history syncs.
First run may still be slow, but follow-up runs should be way faster.

For users still on v0.8.x, now’s the perfect time to upgrade to v0.9.6.

⚠️ Warning possible breaking update for Trakt History pairs

Trakt is rolling out a change that rounds watched_at to minute precision
I've changed the Trakt adapter following that same principle now.
If you have a pair with Trakt using History then either recreate the pair or even better:
Go to maintenance tools to clean everything. Ref: https://wiki.crosswatch.app/crosswatch/faq

✨ Highlights

• Snapshots - Captures: The UI now labels “Snapshots” as Captures.
• Captures Compare (Advanced): Side-by-side A/B diff viewer. Select two Captures, then click Advanced. Ref: https://wiki.crosswatch.app/crosswatch/tools/captures/capture-compare-advanced

🔧 Fixes & Improvements

• Trakt: minute precision: Changed the Trakt adapter to follow-up the new minute precision approach.
• Plex: Home token reliability: History writes now use the active Plex session token (prevents “sometimes only season 1” / random unresolved writes when Plex Home switching is involved).
• Plex: Strict IDs-only matching: History sync is now fixed and can run in strict ID mode using Plex GUIDs (TMDB/IMDb/TVDB) without title/search fallbacks. This reduces mismatches and makes “IDs-only” actually work.
• Plex: history capture: Plex history capture is now incremental (watermark and correct mindate usage) instead of re-scanning the entire server history every run.
• Plex: Persistent GUID index: Uses a per-pair, on-disk GUID→ratingKey index to speed up strict matching.
• Plex: ratings strict matching improved: Episode/season ratings resolution now also uses show IDs (TMDB/IMDb/TVDB) when matching in Plex, improving accuracy and reducing “unresolved” ratings in strict ID mode.
• Editor: timestamps: “Watched At” display/editing now matches the UI. Manual edits are interpreted in local time and stored consistently (prevents timezone shifts).
• Captures - Compare: Compare is now limited to same provider and same feature to prevent misleading diffs. Ref: https://github.com/cenodude/CrossWatch/issues/97
• Captures - Compare: Smarter diffing (including timestamp normalization) to avoid false “updates” caused by tiny time differences. Ref: https://github.com/cenodude/CrossWatch/issues/97
• Plex: history timestamps: Fixed a potential timezone offset issue by reading Plex history using Plex’s native epoch format for consistent results. Ref: https://github.com/cenodude/CrossWatch/issues/103
• Pair-config - One-Way Remove mode UI toggle: Added a new switch in pair-config under Allow mass delete to control one-way deletion behavior:
  • Enabled (default): Deletions are based on source matches — items are only deleted when a match exists between source and destination.
  • Disabled: Mirror mode (mirror) - always follows source (destructive; use with care).
  • NB: The logics was already available in v0.9.5, i only added the UI toggle.
  • Ref: https://wiki.crosswatch.app/crosswatch/configure-pairs/global-settings

CrossWatch v0.9.5

There was an issue with the Trakt provider when using multiple profiles: additional profiles incorrectly reused the default profile’s client_id.
Most users won’t notice this (because most don’t run multiple Trakt profiles), but if you do: delete all extra Trakt profiles (keep the default), then recreate them.

Another important change: the default delete behavior for one-way syncs has been updated. Previously, one-way deletes acted like “mirror mode” by default.
If you intentionally want the old (destructive) mirroring behavior back, set this in your config.json:
sync.one_way_remove_mode = "mirror"

✨ Highlights

• Watchlist list view improvements: Posters no longer collide with sync icons; the layout is cleaner and easier to scan.
• Snapshots comparison: Pick two snapshots and see what changed - Added, Deleted, and Updated (with old/new values).

🔧 Fixes & Improvements

• Synchronization Providers / Pairs: Fixed the pairs list getting cut off when you have many pairs; it now becomes scrollable after ~5 pairs.
• Providers (multi-profile visibility): Provider status now always reflects your default profile, even if other profiles exist.
• Providers (tooltip improvements): Hovering a provider now shows which profiles/instances are configured and which ones are actually used by your sync pairs.
• Watchlist: Provider icons no longer “jump” left/right per item. Each provider now keeps a fixed slot, making it easier to spot what isn’t synced.
• Watchlist (customizable columns): You can now show/hide columns like Poster, Genre, etc., to build your preferred view.
• MDBList (Watchlist IDs): Watchlist items from MDBList now correctly store TMDb IDs (instead of losing them), improving matching and reducing duplicates.
• Providers (ID preference): Provider ID matching now prefers TMDb before IMDb for improved consistency across integrations. (Orchestrator behavior is unchanged.)
• Trakt (per-pair Collection sync): Add to Trakt Collection is now configured per Trakt pair instead of globally.
• Trakt (Movies/Shows selection): When enabled, you can choose whether Collection updates apply to Movies and/or Shows (default: Movies).
• Trakt (multi-profile auth): Fixed Trakt profiles not storing their own Client ID and Client Secret correctly.
• Trakt (renew all profiles): Token refresh/renew now applies to all Trakt profiles, not only the default one.
• One-way sync (safe deletes): Fixed one-way pairs with Delete enabled incorrectly behaving like mirror mode on subsequent runs, causing unintended mass deletions on the target. Deletes now only propagate items actually deleted on the source.

BELOW the v0.9.4 release notes:

CrossWatch v0.9.4

🔧 Fixes & Improvements

• Watcher Scrobble no longer defaults to Trakt when no sink is configured.
• Watcher If no scrobble sink is set, watching still works, we just don’t scrobble anywhere.
• Watchlist (Internal Tracker) Covers/posters now show up again in both Watchlist and Watchlist Preview

BELOW the v0.9.3 release notes:

CrossWatch v0.9.3

🔧 Fixes & Improvements

• Plex Auth / Profiles: Fixed profile settings leaking into the default profile. Profile values now stay isolated and update immediately. https://github.com/cenodude/CrossWatch/issues/80
• Plex Home Switching: Improved Home user switching logic (correctly distinguishes Home user ID vs Plex account ID) for more reliable profile/session behavior. https://github.com/cenodude/CrossWatch/issues/81
• Plex Module Cleanup: Refactored and centralized Plex sync code (shared helpers moved into _common, removed duplication/unused code).
• Maintenance: “Clear provider cache” and “Clean everything” now preserve /config/.cw_state/id/ (Plex device and auth identifiers stay intact).
• Maintenance: Added “Reset all to default” Wipes local state/caches/reports/TLS, backs up config.json with a timestamp, keeps snapshots, then restarts CrossWatch.

BELOW the v0.9.2 release notes:

CrossWatch v0.9.2

Updated Now Playing card and banner to properly handle multiple streams (Watcher Routes mode).
If anything looks off after updating: Settings → Maintenance → Reset Currently Playing.
You can also run sinlgle pairs now from the main Synchronize button..

✨ Highlights

• Split “Synchronize” button (new)
  • Click Synchronize to run everything (as before).
  • Click the ▾ to run Sync all or run a single enabled pair directly.

🔧 Fixes & Improvements

• Scrobble Watcher: Fixed an issue where resume after pause could be missed until the next progress milestone.
• Playing card (Routes mode): Now supports multiple simultaneous streams (such as Plex and Emby to same sink)
• Playing card: Fixed the Now playing time ticker.. it now shows the time played

BELOW the v0.9.1 release notes:

CrossWatch v0.9.1

As always: do a hard refresh (CTRL+F5) - or better, clear your browser cache.
The number of times caching causes ghost bugs is basically infinite. So tripple please...do it...

🔧 Fixes & Improvements

• Emby/Jellyfin “Pick User”: Fixed a front-end bind issue where the button could do nothing.
• Strict ID matching (per pair): Optional per-pair setting to match IDs only (disables title/year fallback) for Plex/Emby/Jellyfin.
• Plex Home user history: History sync now writes to the selected Home user, with a safety guard to skip writes if scope switching fails.
• Plex Watcher - Fetch Server UUID: Fixed No server UUID by using the correct UUID endpoint.
• Insights UI counters: Fixed tab counters not updating reliably when switching features.

BELOW the v0.9.0 release notes:

CrossWatch v0.9.0 (experimental)

v0.9.0 brings a new Profile/Instance system and the new Watcher Routes model.
It’s marked experimental because profiles multiply the possible setups far beyond what older CrossWatch builds had to handle.

If your current version works and are happy: you can just wait a few versions before it's stable again..
But if you want to upgrade to test it and help the community shake out bugs, I’ll gladly take it.
Expect rough edges while I stabilize the new foundation...Look it is what it is....

If I had to sum this release up in one sentence: you can now run CrossWatch as a multi-profile sync hub for multiple friends/family and their services, even using their tracker APIs.

IMPORTANT and WARNINGS

1. Clear your browser cache for this release. i had some issues with it.. cleaning it did the trick
2. The Watcher is much more flexible with the new Routes model - and that also means more ways to accidentally annoy your trackers.
   Be careful: keep the progress step at the default 25% (validate in advanced).
   If you set it to 1% (almost realtime) and run Plex/ Emby/Jellyfin the same time, you’ll push the huge amount of ~300 API calls to a tracker during a 60-minute movie. And yes,, some trackers will kill you and me about it.
   So… think before you configure. You’re responsible for what you do. CrossWatch can do a lot (maybe way too much)… but that doesn’t mean you should enable all of it.
3. Be careful with profiles: in v0.9.0 they’re still experimental. They need refinement, but they should already do the job.

WIKI: Profiles and instances
WIKI: Watcher
WIKI: Insights settings

Look, I get it, nobody wants to read. But I also don’t want to answer questions with “I thought that’s what it was supposed to do.”
Please read first. If it’s still unclear, ask in Discussions. I’m happy to help Always ask before you hit “sync” and discover new ways to suffer.

✨ Highlights

• Provider Profiles / Instances
  • Multiple profiles per provider (such as, Plex “Default” and “Kids”)
  • Basically, you can now act as the sync hub for family or friends - including using their tracker APIs.
  • Watchlist, Analyzer, Exporter, Editor updated to be profile-aware
• Insights Settings
  • New modal to include/exclude Features and Provider Profiles

Watcher / Routes

• Why the new routes mode
  • Configure any media server(s) with any tracker(s) and run all together
  • Legacy watcher configs migrate to routes mode (Default profile auto-applied)
  • UI reflects active routes
  • Status shows mode and providers

Profiles & State (Core Improvements)

• Watchlist
  • Aggregates from Default and all profiles
  • Insights shows which profile(s) each item comes from
• Analyzer
  • Understands multi-profile setups; no longer flags “instances-only” as unconfigured
  • Diagnostics support newer scope formats with profile context
• Exporter
  • Export modal adds Profile selector
  • Export endpoints support optional provider_instance (export per profile where supported)
• Editor
  • Current State: load/save per Default and profiles
  • State Import (debug): can target a specific profile
  • Pair Cache editor supports modern scopes (no legacy pair_ dependency)
• State & Insights Accuracy
  • Orchestrator tags synced items with source profile in state.json
  • Enables correct per-profile totals and prevents blending

UI & Visibility

• Configured Providers - Counts configured profiles (including Default), with compact display
• Whitelisting - Whitelists include profiles and show profile names

🔧 Fixes and Improvements

• Plex Home user picker - Managed users marked as Home Prevents wrong selection / bad account_id
• Plex Watchlist (Discover)- Fixes unauthorized errors after switching Plex Home users
• Emby/Jellyfin - Allow empty password setups (issue #74)

CrossWatch v0.9.4

🔧 Fixes & Improvements

• Watcher Scrobble no longer defaults to Trakt when no sink is configured.
• Watcher If no scrobble sink is set, watching still works, we just don’t scrobble anywhere.
• Watchlist (Internal Tracker) Covers/posters now show up again in both Watchlist and Watchlist Preview

BELOW the v0.9.3 release notes:

CrossWatch v0.9.3

🔧 Fixes & Improvements

• Plex Auth / Profiles: Fixed profile settings leaking into the default profile. Profile values now stay isolated and update immediately. https://github.com/cenodude/CrossWatch/issues/80
• Plex Home Switching: Improved Home user switching logic (correctly distinguishes Home user ID vs Plex account ID) for more reliable profile/session behavior. https://github.com/cenodude/CrossWatch/issues/81
• Plex Module Cleanup: Refactored and centralized Plex sync code (shared helpers moved into _common, removed duplication/unused code).
• Maintenance: “Clear provider cache” and “Clean everything” now preserve /config/.cw_state/id/ (Plex device and auth identifiers stay intact).
• Maintenance: Added “Reset all to default” Wipes local state/caches/reports/TLS, backs up config.json with a timestamp, keeps snapshots, then restarts CrossWatch.

BELOW the v0.9.2 release notes:

CrossWatch v0.9.2

Updated Now Playing card and banner to properly handle multiple streams (Watcher Routes mode).
If anything looks off after updating: Settings → Maintenance → Reset Currently Playing.
You can also run sinlgle pairs now from the main Synchronize button..

✨ Highlights

• Split “Synchronize” button (new)
  • Click Synchronize to run everything (as before).
  • Click the ▾ to run Sync all or run a single enabled pair directly.

🔧 Fixes & Improvements

• Scrobble Watcher: Fixed an issue where resume after pause could be missed until the next progress milestone.
• Playing card (Routes mode): Now supports multiple simultaneous streams (such as Plex and Emby to same sink)
• Playing card: Fixed the Now playing time ticker.. it now shows the time played

BELOW the v0.9.1 release notes:

CrossWatch v0.9.1

As always: do a hard refresh (CTRL+F5) - or better, clear your browser cache.
The number of times caching causes ghost bugs is basically infinite. So tripple please...do it...

🔧 Fixes & Improvements

• Emby/Jellyfin “Pick User”: Fixed a front-end bind issue where the button could do nothing.
• Strict ID matching (per pair): Optional per-pair setting to match IDs only (disables title/year fallback) for Plex/Emby/Jellyfin.
• Plex Home user history: History sync now writes to the selected Home user, with a safety guard to skip writes if scope switching fails.
• Plex Watcher - Fetch Server UUID: Fixed No server UUID by using the correct UUID endpoint.
• Insights UI counters: Fixed tab counters not updating reliably when switching features.

BELOW the v0.9.0 release notes:

CrossWatch v0.9.0 (experimental)

v0.9.0 brings a new Profile/Instance system and the new Watcher Routes model.
It’s marked experimental because profiles multiply the possible setups far beyond what older CrossWatch builds had to handle.

If your current version works and are happy: you can just wait a few versions before it's stable again..
But if you want to upgrade to test it and help the community shake out bugs, I’ll gladly take it.
Expect rough edges while I stabilize the new foundation...Look it is what it is....

If I had to sum this release up in one sentence: you can now run CrossWatch as a multi-profile sync hub for multiple friends/family and their services, even using their tracker APIs.

IMPORTANT and WARNINGS

1. Clear your browser cache for this release. i had some issues with it.. cleaning it did the trick
2. The Watcher is much more flexible with the new Routes model - and that also means more ways to accidentally annoy your trackers.
   Be careful: keep the progress step at the default 25% (validate in advanced).
   If you set it to 1% (almost realtime) and run Plex/ Emby/Jellyfin the same time, you’ll push the huge amount of ~300 API calls to a tracker during a 60-minute movie. And yes,, some trackers will kill you and me about it.
   So… think before you configure. You’re responsible for what you do. CrossWatch can do a lot (maybe way too much)… but that doesn’t mean you should enable all of it.
3. Be careful with profiles: in v0.9.0 they’re still experimental. They need refinement, but they should already do the job.

WIKI: Profiles and instances
WIKI: Watcher
WIKI: Insights settings

Look, I get it, nobody wants to read. But I also don’t want to answer questions with “I thought that’s what it was supposed to do.”
Please read first. If it’s still unclear, ask in Discussions. I’m happy to help Always ask before you hit “sync” and discover new ways to suffer.

✨ Highlights

• Provider Profiles / Instances
  • Multiple profiles per provider (such as, Plex “Default” and “Kids”)
  • Basically, you can now act as the sync hub for family or friends - including using their tracker APIs.
  • Watchlist, Analyzer, Exporter, Editor updated to be profile-aware
• Insights Settings
  • New modal to include/exclude Features and Provider Profiles

Watcher / Routes

• Why the new routes mode
  • Configure any media server(s) with any tracker(s) and run all together
  • Legacy watcher configs migrate to routes mode (Default profile auto-applied)
  • UI reflects active routes
  • Status shows mode and providers

Profiles & State (Core Improvements)

• Watchlist
  • Aggregates from Default and all profiles
  • Insights shows which profile(s) each item comes from
• Analyzer
  • Understands multi-profile setups; no longer flags “instances-only” as unconfigured
  • Diagnostics support newer scope formats with profile context
• Exporter
  • Export modal adds Profile selector
  • Export endpoints support optional provider_instance (export per profile where supported)
• Editor
  • Current State: load/save per Default and profiles
  • State Import (debug): can target a specific profile
  • Pair Cache editor supports modern scopes (no legacy pair_ dependency)
• State & Insights Accuracy
  • Orchestrator tags synced items with source profile in state.json
  • Enables correct per-profile totals and prevents blending

UI & Visibility

• Configured Providers - Counts configured profiles (including Default), with compact display
• Whitelisting - Whitelists include profiles and show profile names

🔧 Fixes and Improvements

• Plex Home user picker - Managed users marked as Home Prevents wrong selection / bad account_id
• Plex Watchlist (Discover)- Fixes unauthorized errors after switching Plex Home users
• Emby/Jellyfin - Allow empty password setups (issue #74)

CrossWatch v0.9.3

🔧 Fixes & Improvements

• Plex Auth / Profiles: Fixed profile settings leaking into the default profile. Profile values now stay isolated and update immediately. https://github.com/cenodude/CrossWatch/issues/80
• Plex Home Switching: Improved Home user switching logic (correctly distinguishes Home user ID vs Plex account ID) for more reliable profile/session behavior. https://github.com/cenodude/CrossWatch/issues/81
• Plex Module Cleanup: Refactored and centralized Plex sync code (shared helpers moved into _common, removed duplication/unused code).
• Maintenance: “Clear provider cache” and “Clean everything” now preserve /config/.cw_state/id/ (Plex device and auth identifiers stay intact).
• Maintenance: Added “Reset all to default” Wipes local state/caches/reports/TLS, backs up config.json with a timestamp, keeps snapshots, then restarts CrossWatch.

BELOW the v0.9.2 release notes:

CrossWatch v0.9.2

Updated Now Playing card and banner to properly handle multiple streams (Watcher Routes mode).
If anything looks off after updating: Settings → Maintenance → Reset Currently Playing.
You can also run sinlgle pairs now from the main Synchronize button..

✨ Highlights

• Split “Synchronize” button (new)
  • Click Synchronize to run everything (as before).
  • Click the ▾ to run Sync all or run a single enabled pair directly.

🔧 Fixes & Improvements

• Scrobble Watcher: Fixed an issue where resume after pause could be missed until the next progress milestone.
• Playing card (Routes mode): Now supports multiple simultaneous streams (such as Plex and Emby to same sink)
• Playing card: Fixed the Now playing time ticker.. it now shows the time played

BELOW the v0.9.1 release notes:

CrossWatch v0.9.1

As always: do a hard refresh (CTRL+F5) - or better, clear your browser cache.
The number of times caching causes ghost bugs is basically infinite. So tripple please...do it...

🔧 Fixes & Improvements

• Emby/Jellyfin “Pick User”: Fixed a front-end bind issue where the button could do nothing.
• Strict ID matching (per pair): Optional per-pair setting to match IDs only (disables title/year fallback) for Plex/Emby/Jellyfin.
• Plex Home user history: History sync now writes to the selected Home user, with a safety guard to skip writes if scope switching fails.
• Plex Watcher - Fetch Server UUID: Fixed No server UUID by using the correct UUID endpoint.
• Insights UI counters: Fixed tab counters not updating reliably when switching features.

BELOW the v0.9.0 release notes:

CrossWatch v0.9.0 (experimental)

v0.9.0 brings a new Profile/Instance system and the new Watcher Routes model.
It’s marked experimental because profiles multiply the possible setups far beyond what older CrossWatch builds had to handle.

If your current version works and are happy: you can just wait a few versions before it's stable again..
But if you want to upgrade to test it and help the community shake out bugs, I’ll gladly take it.
Expect rough edges while I stabilize the new foundation...Look it is what it is....

If I had to sum this release up in one sentence: you can now run CrossWatch as a multi-profile sync hub for multiple friends/family and their services, even using their tracker APIs.

IMPORTANT and WARNINGS

1. Clear your browser cache for this release. i had some issues with it.. cleaning it did the trick
2. The Watcher is much more flexible with the new Routes model - and that also means more ways to accidentally annoy your trackers.
   Be careful: keep the progress step at the default 25% (validate in advanced).
   If you set it to 1% (almost realtime) and run Plex/ Emby/Jellyfin the same time, you’ll push the huge amount of ~300 API calls to a tracker during a 60-minute movie. And yes,, some trackers will kill you and me about it.
   So… think before you configure. You’re responsible for what you do. CrossWatch can do a lot (maybe way too much)… but that doesn’t mean you should enable all of it.
3. Be careful with profiles: in v0.9.0 they’re still experimental. They need refinement, but they should already do the job.

WIKI: Profiles and instances
WIKI: Watcher
WIKI: Insights settings

Look, I get it, nobody wants to read. But I also don’t want to answer questions with “I thought that’s what it was supposed to do.”
Please read first. If it’s still unclear, ask in Discussions. I’m happy to help Always ask before you hit “sync” and discover new ways to suffer.

✨ Highlights

• Provider Profiles / Instances
  • Multiple profiles per provider (such as, Plex “Default” and “Kids”)
  • Basically, you can now act as the sync hub for family or friends - including using their tracker APIs.
  • Watchlist, Analyzer, Exporter, Editor updated to be profile-aware
• Insights Settings
  • New modal to include/exclude Features and Provider Profiles

Watcher / Routes

• Why the new routes mode
  • Configure any media server(s) with any tracker(s) and run all together
  • Legacy watcher configs migrate to routes mode (Default profile auto-applied)
  • UI reflects active routes
  • Status shows mode and providers

Profiles & State (Core Improvements)

• Watchlist
  • Aggregates from Default and all profiles
  • Insights shows which profile(s) each item comes from
• Analyzer
  • Understands multi-profile setups; no longer flags “instances-only” as unconfigured
  • Diagnostics support newer scope formats with profile context
• Exporter
  • Export modal adds Profile selector
  • Export endpoints support optional provider_instance (export per profile where supported)
• Editor
  • Current State: load/save per Default and profiles
  • State Import (debug): can target a specific profile
  • Pair Cache editor supports modern scopes (no legacy pair_ dependency)
• State & Insights Accuracy
  • Orchestrator tags synced items with source profile in state.json
  • Enables correct per-profile totals and prevents blending

UI & Visibility

• Configured Providers - Counts configured profiles (including Default), with compact display
• Whitelisting - Whitelists include profiles and show profile names

🔧 Fixes and Improvements

• Plex Home user picker - Managed users marked as Home Prevents wrong selection / bad account_id
• Plex Watchlist (Discover)- Fixes unauthorized errors after switching Plex Home users
• Emby/Jellyfin - Allow empty password setups (issue #74)

CrossWatch v0.9.2

Updated Now Playing card and banner to properly handle multiple streams (Watcher Routes mode).
If anything looks off after updating: Settings → Maintenance → Reset Currently Playing.
You can also run sinlgle pairs now from the main Synchronize button..

✨ Highlights

• Split “Synchronize” button (new)
  • Click Synchronize to run everything (as before).
  • Click the ▾ to run Sync all or run a single enabled pair directly.

🔧 Fixes & Improvements

• Scrobble Watcher: Fixed an issue where resume after pause could be missed until the next progress milestone.
• Playing card (Routes mode): Now supports multiple simultaneous streams (such as Plex and Emby to same sink)
• Playing card: Fixed the Now playing time ticker.. it now shows the time played

BELOW the v0.9.1 release notes:

CrossWatch v0.9.1

As always: do a hard refresh (CTRL+F5) - or better, clear your browser cache.
The number of times caching causes ghost bugs is basically infinite. So tripple please...do it...

🔧 Fixes & Improvements

• Emby/Jellyfin “Pick User”: Fixed a front-end bind issue where the button could do nothing.
• Strict ID matching (per pair): Optional per-pair setting to match IDs only (disables title/year fallback) for Plex/Emby/Jellyfin.
• Plex Home user history: History sync now writes to the selected Home user, with a safety guard to skip writes if scope switching fails.
• Plex Watcher - Fetch Server UUID: Fixed No server UUID by using the correct UUID endpoint.
• Insights UI counters: Fixed tab counters not updating reliably when switching features.

BELOW the v0.9.0 release notes:

CrossWatch v0.9.0 (experimental)

v0.9.0 brings a new Profile/Instance system and the new Watcher Routes model.
It’s marked experimental because profiles multiply the possible setups far beyond what older CrossWatch builds had to handle.

If your current version works and are happy: you can just wait a few versions before it's stable again..
But if you want to upgrade to test it and help the community shake out bugs, I’ll gladly take it.
Expect rough edges while I stabilize the new foundation...Look it is what it is....

If I had to sum this release up in one sentence: you can now run CrossWatch as a multi-profile sync hub for multiple friends/family and their services, even using their tracker APIs.

IMPORTANT and WARNINGS

1. Clear your browser cache for this release. i had some issues with it.. cleaning it did the trick
2. The Watcher is much more flexible with the new Routes model - and that also means more ways to accidentally annoy your trackers.
   Be careful: keep the progress step at the default 25% (validate in advanced).
   If you set it to 1% (almost realtime) and run Plex/ Emby/Jellyfin the same time, you’ll push the huge amount of ~300 API calls to a tracker during a 60-minute movie. And yes,, some trackers will kill you and me about it.
   So… think before you configure. You’re responsible for what you do. CrossWatch can do a lot (maybe way too much)… but that doesn’t mean you should enable all of it.
3. Be careful with profiles: in v0.9.0 they’re still experimental. They need refinement, but they should already do the job.

WIKI: Profiles and instances
WIKI: Watcher
WIKI: Insights settings

Look, I get it, nobody wants to read. But I also don’t want to answer questions with “I thought that’s what it was supposed to do.”
Please read first. If it’s still unclear, ask in Discussions. I’m happy to help Always ask before you hit “sync” and discover new ways to suffer.

✨ Highlights

• Provider Profiles / Instances
  • Multiple profiles per provider (such as, Plex “Default” and “Kids”)
  • Basically, you can now act as the sync hub for family or friends - including using their tracker APIs.
  • Watchlist, Analyzer, Exporter, Editor updated to be profile-aware
• Insights Settings
  • New modal to include/exclude Features and Provider Profiles

Watcher / Routes

• Why the new routes mode
  • Configure any media server(s) with any tracker(s) and run all together
  • Legacy watcher configs migrate to routes mode (Default profile auto-applied)
  • UI reflects active routes
  • Status shows mode and providers

Profiles & State (Core Improvements)

• Watchlist
  • Aggregates from Default and all profiles
  • Insights shows which profile(s) each item comes from
• Analyzer
  • Understands multi-profile setups; no longer flags “instances-only” as unconfigured
  • Diagnostics support newer scope formats with profile context
• Exporter
  • Export modal adds Profile selector
  • Export endpoints support optional provider_instance (export per profile where supported)
• Editor
  • Current State: load/save per Default and profiles
  • State Import (debug): can target a specific profile
  • Pair Cache editor supports modern scopes (no legacy pair_ dependency)
• State & Insights Accuracy
  • Orchestrator tags synced items with source profile in state.json
  • Enables correct per-profile totals and prevents blending

UI & Visibility

• Configured Providers - Counts configured profiles (including Default), with compact display
• Whitelisting - Whitelists include profiles and show profile names

🔧 Fixes and Improvements

• Plex Home user picker - Managed users marked as Home Prevents wrong selection / bad account_id
• Plex Watchlist (Discover)- Fixes unauthorized errors after switching Plex Home users
• Emby/Jellyfin - Allow empty password setups (issue #74)

CrossWatch v0.9.1

As always: do a hard refresh (CTRL+F5) - or better, clear your browser cache.
The number of times caching causes ghost bugs is basically infinite. So tripple please...do it...

🔧 Fixes & Improvements

• Emby/Jellyfin “Pick User”: Fixed a front-end bind issue where the button could do nothing.
• Strict ID matching (per pair): Optional per-pair setting to match IDs only (disables title/year fallback) for Plex/Emby/Jellyfin.
• Plex Home user history: History sync now writes to the selected Home user, with a safety guard to skip writes if scope switching fails.
• Plex Watcher - Fetch Server UUID: Fixed No server UUID by using the correct UUID endpoint.
• Insights UI counters: Fixed tab counters not updating reliably when switching features.

BELOW the v0.9.0 release notes:

CrossWatch v0.9.0 (experimental)

v0.9.0 brings a new Profile/Instance system and the new Watcher Routes model.
It’s marked experimental because profiles multiply the possible setups far beyond what older CrossWatch builds had to handle.

If your current version works and are happy: you can just wait a few versions before it's stable again..
But if you want to upgrade to test it and help the community shake out bugs, I’ll gladly take it.
Expect rough edges while I stabilize the new foundation...Look it is what it is....

If I had to sum this release up in one sentence: you can now run CrossWatch as a multi-profile sync hub for multiple friends/family and their services, even using their tracker APIs.

IMPORTANT and WARNINGS

1. Clear your browser cache for this release. i had some issues with it.. cleaning it did the trick
2. The Watcher is much more flexible with the new Routes model - and that also means more ways to accidentally annoy your trackers.
   Be careful: keep the progress step at the default 25% (validate in advanced).
   If you set it to 1% (almost realtime) and run Plex/ Emby/Jellyfin the same time, you’ll push the huge amount of ~300 API calls to a tracker during a 60-minute movie. And yes,, some trackers will kill you and me about it.
   So… think before you configure. You’re responsible for what you do. CrossWatch can do a lot (maybe way too much)… but that doesn’t mean you should enable all of it.
3. Be careful with profiles: in v0.9.0 they’re still experimental. They need refinement, but they should already do the job.

WIKI: Profiles and instances
WIKI: Watcher
WIKI: Insights settings

Look, I get it, nobody wants to read. But I also don’t want to answer questions with “I thought that’s what it was supposed to do.”
Please read first. If it’s still unclear, ask in Discussions. I’m happy to help Always ask before you hit “sync” and discover new ways to suffer.

✨ Highlights

• Provider Profiles / Instances
  • Multiple profiles per provider (such as, Plex “Default” and “Kids”)
  • Basically, you can now act as the sync hub for family or friends - including using their tracker APIs.
  • Watchlist, Analyzer, Exporter, Editor updated to be profile-aware
• Insights Settings
  • New modal to include/exclude Features and Provider Profiles

Watcher / Routes

• Why the new routes mode
  • Configure any media server(s) with any tracker(s) and run all together
  • Legacy watcher configs migrate to routes mode (Default profile auto-applied)
  • UI reflects active routes
  • Status shows mode and providers

Profiles & State (Core Improvements)

• Watchlist
  • Aggregates from Default and all profiles
  • Insights shows which profile(s) each item comes from
• Analyzer
  • Understands multi-profile setups; no longer flags “instances-only” as unconfigured
  • Diagnostics support newer scope formats with profile context
• Exporter
  • Export modal adds Profile selector
  • Export endpoints support optional provider_instance (export per profile where supported)
• Editor
  • Current State: load/save per Default and profiles
  • State Import (debug): can target a specific profile
  • Pair Cache editor supports modern scopes (no legacy pair_ dependency)
• State & Insights Accuracy
  • Orchestrator tags synced items with source profile in state.json
  • Enables correct per-profile totals and prevents blending

UI & Visibility

• Configured Providers - Counts configured profiles (including Default), with compact display
• Whitelisting - Whitelists include profiles and show profile names

🔧 Fixes and Improvements

• Plex Home user picker - Managed users marked as Home Prevents wrong selection / bad account_id
• Plex Watchlist (Discover)- Fixes unauthorized errors after switching Plex Home users
• Emby/Jellyfin - Allow empty password setups (issue #74)

CrossWatch v0.9.0 (experimental)

v0.9.0 brings a new Profile/Instance system and the new Watcher Routes model.
It’s marked experimental because profiles multiply the possible setups far beyond what older CrossWatch builds had to handle.

If your current version works and are happy: you can just wait a few versions before it's stable again..
But if you want to upgrade to test it and help the community shake out bugs, I’ll gladly take it.
Expect rough edges while I stabilize the new foundation...Look it is what it is....

If I had to sum this release up in one sentence: you can now run CrossWatch as a multi-profile sync hub for multiple friends/family and their services, even using their tracker APIs.

IMPORTANT and WARNINGS

1. Clear your browser cache for this release. i had some issues with it.. cleaning it did the trick
2. The Watcher is much more flexible with the new Routes model - and that also means more ways to accidentally annoy your trackers.
   Be careful: keep the progress step at the default 25% (validate in advanced).
   If you set it to 1% (almost realtime) and run Plex/ Emby/Jellyfin the same time, you’ll push the huge amount of ~300 API calls to a tracker during a 60-minute movie. And yes,, some trackers will kill you and me about it.
   So… think before you configure. You’re responsible for what you do. CrossWatch can do a lot (maybe way too much)… but that doesn’t mean you should enable all of it.
3. Be careful with profiles: in v0.9.0 they’re still experimental. They need refinement, but they should already do the job.

WIKI: Profiles and instances
WIKI: Watcher
WIKI: Insights settings

Look, I get it, nobody wants to read. But I also don’t want to answer questions with “I thought that’s what it was supposed to do.”
Please read first. If it’s still unclear, ask in Discussions. I’m happy to help Always ask before you hit “sync” and discover new ways to suffer.

✨ Highlights

• Provider Profiles / Instances
  • Multiple profiles per provider (such as, Plex “Default” and “Kids”)
  • Basically, you can now act as the sync hub for family or friends - including using their tracker APIs.
  • Watchlist, Analyzer, Exporter, Editor updated to be profile-aware
• Insights Settings
  • New modal to include/exclude Features and Provider Profiles

Watcher / Routes

• Why the new routes mode
  • Configure any media server(s) with any tracker(s) and run all together
  • Legacy watcher configs migrate to routes mode (Default profile auto-applied)
  • UI reflects active routes
  • Status shows mode and providers

Profiles & State (Core Improvements)

• Watchlist
  • Aggregates from Default and all profiles
  • Insights shows which profile(s) each item comes from
• Analyzer
  • Understands multi-profile setups; no longer flags “instances-only” as unconfigured
  • Diagnostics support newer scope formats with profile context
• Exporter
  • Export modal adds Profile selector
  • Export endpoints support optional provider_instance (export per profile where supported)
• Editor
  • Current State: load/save per Default and profiles
  • State Import (debug): can target a specific profile
  • Pair Cache editor supports modern scopes (no legacy pair_ dependency)
• State & Insights Accuracy
  • Orchestrator tags synced items with source profile in state.json
  • Enables correct per-profile totals and prevents blending

UI & Visibility

• Configured Providers - Counts configured profiles (including Default), with compact display
• Whitelisting - Whitelists include profiles and show profile names

🔧 Fixes and Improvements

• Plex Home user picker - Managed users marked as Home Prevents wrong selection / bad account_id
• Plex Watchlist (Discover)- Fixes unauthorized errors after switching Plex Home users
• Emby/Jellyfin - Allow empty password setups (issue #74)

CrossWatch - v0.8.2

Mostly small bug fixes in this release. The v0.8.x line is primarily focused on stability.
In the background, work is ongoing on v0.9.0, which will introduce Profiles with support for multi-server and multi-account setups.
Progress/status: https://github.com/cenodude/CrossWatch/issues/73

🔧 Fixes & Improvements

• Protocol switch restart banner

  • The Restart required prompt now clears correctly
  • Added a 1-minute TTL fallback logic to auto-remove stale restart prompts

• Show/Hide Ask AI restart banner

  • Fixed cases where toggling “Show/Hide Ask AI” could trigger the wrong banner (or no banner)
  • “Restart now” now works reliably

CrossWatch - v0.8.1

CrossWatch now supports a new sync provider: TMDb (sync).
TMDb is available both as a metadata provider and as a sync provider but they’re separate features and need different configuration.

✨ Highlights

• TMDb (sync) Provider (new)
  • Link your TMDb API in Settings/Authentication and use it as a sync source and/or target.
  • Supported features:
    • Watchlist
    • Ratings Movies, Shows, Episodes (no seasons)

🔧 Fixes & Improvements

• SIMKL Anime Movies (ID and Type Handling)

  • Anime entries that are actually movies are now treated as Movies for matching and syncing.
  • Improves syncing to providers that rely on movie IDs, reducing wrong matches.

• ProbesAPI

  • Throttled probe refreshes so repeated requests wouldn’t overwhelm the system.

  📚 Wiki

• TMDb authentication - read here

• TMDb sync adapter - read here

CrossWatch - v0.8.0

Welcome at v0.8: I've added also some nice new features such as Snapshots, HTTPS support and help assistance. Also, CW has improved SIMKL anime support for shows: sync is now TVDB-first to avoid season mismatches. However, Anime is still a work in progress for now.

For better security (and a few extra features), I recommend using HTTPS.
Ideally use a reverse proxy, but you can also enable HTTPS in CW. Just note: webhooks will NOT work with self-signed certificates.
Do NOT forget that after switching to HTTPS anything that points at your CrossWatch URL must be updated (webhooks and redirect URLs)

You may have noticed: I moved the wiki to a new site: https://wiki.crosswatch.app
If you use HTTPS for CW, the new wiki is fully integrated, including chatbot, from within CW.

✨ Highlights

• Snapshots (new, experimental)

  • Create snapshots and let you rollback provider data if something goes wrong.
  • Captures: Watchlist / Ratings / History (or All features)
  • Two restore modes: Merge (safe): only adds missing items and Clear (destructive): wipes the dataset first, then restores

• HTTPS Support (new, experimental)

  • CW can now run over HTTPS (self-signed by default), and you can manage TLS settings from the UI.
  • Note: self-signed certificates does NOT work with Webhooks!
  • Next to Protocol there’s an Advanced button that opens the TLS manager:
    • View current certificate status.
    • Download the .crt so you can trust the certificate on your device/browser (fewer angry browser warnings).
    • Optional: Regenerate a self-signed certificate.
    • Optional: configure custom cert/key paths (for your own certificates / reverse proxy setups).

Tip: For a “real” trusted certificate on the internet, use a reverse proxy (Caddy/Nginx/Traefik) with Let’s Encrypt and run CW behind it.

• About/Help Assistance (new)
  • About/Help Opens the wiki (wiki.crosswatch.app) - and when you’re on HTTPS, it’s integrated directly into CW.
  • Ask AI (only works in HTTPS) - The Ask AI button lets you quickly look up CW help and docs.

🔧 Fixes & Improvements

• Plex history sync is faster when you whitelist libraries
  • If you configured Plex whitelisting, CW now fetches history only for those libraries (server-side filtering).
  • Big speed-up on large servers, because it no longer loads your entire Plex history and filters it locally.
• Authentication now supports multiple sessions (multi-device login)
  • You can stay logged in on multiple devices/browsers at the same time.
• Sync results now show only real changes in UI
  • The UI no longer shows “added” items that were only part of a snapshot/cache.
  • When nothing was applied, the summary stays at 0 changes (as it should).
• Trakt API compliance (Feb 2026 readiness) - CrossWatch is compliant with Trakt’s upcoming pagination requirements.
• SIMKL Anime (History) – TVDB season mapping - Uses SIMKL’s mapping so anime episodes.
• Better matching to Plex/Emby/Jellyfin (title hints) - English-style slug (TVDB/Trakt), CW uses that as a title hint.
• SIMKL ratings and watchlist are more accurate - Prefer TVDB-based matching for anime where available.
• Ratings updates now sync correctly - Changing a rating now updates on the other provider too.
• Fix: Webhooks were being blocked by the auth gate, so they became unreachable once authentication was enabled.
• Fix: CW tracker in pair would disable sync button - When CW tracker was in a pair, the sync button would be greyed out.

CrossWatch - v0.7.8

Better mobile experience: CrossWatch now shows a compact mobile dashboard view on phones, focused on what matters most.

✨ Highlights

• Mobile dashboard support

  • Phone-friendly overview that prioritizes only the essentials
  • Shows Statistics and Recent syncs and the Scrobble “Now Playing” card
  • Optional quick toggle to switch between Compact and Full UI on mobile
  • Optional install as app in Android and iPhone. Requires reverse proxy with public SSL certificate
    

• Watcher “Now Playing” improvements (for mobile)

  • Better layout and spacing for smaller screens
  • Cleaner, more readable card content on phones

🔧 Fixes & Improvements

• SIMKL ratings titles

  • Fixed SIMKL ratings parsing so titles/years are read correctly
  • Removes “IMDB:tt123…” placeholder titles in ratings sync summaries

• Security UI feedback

  • Password confirmation now shows a clear error when it doesn’t match
  • Prevents saving until the issue is fixed (no more silent “nothing happened”)

CrossWatch - v0.7.6

This update fixes the episode titles in the UI for History & Ratings.
Adds optional authentication for people who don’t want CrossWatch UI wide open.

✨ Highlights

• Security: Optional UI authentication
  • Enable it in Settings (UI / Security / CW Tracker) turn on authentication and set a username and password.
  • 30-day “remember me” login once you sign in.

🔧 Fixes & Improvements

• UI: History & Ratings episode titles

  • Correct episode formatting: episodes now show as Show - S01E01 where possible
  • No more “title flip” after loading: the dashboard no longer overwrites the run summary spotlight items with a simplified version from the insights refresh.
  • More consistent spotlight details: CW keeps episode metadata (show name and season/episode) so the lanes stay stable and readable.

• UI: Provider library whitelists no longer reset

  • Whitelists are preserved on Save after restarts: Plex/Emby/Jellyfin library selections won’t get wiped just because you restarted the container and hit Save.

CrossWatch - v0.7.5

Sorry people, I normally don’t push two updates in a day, but this one brings some nice performance boosts. Didn’t want to make you wait.

🔧 Fixes & Improvements

• Performance & stability

  • Less CPU usage when idle: the server no longer keeps re-reading and re-decoding the same big JSON “state” file over and over.
  • Faster dashboard updates: run summaries (the “lanes” / timeline view) are now cached and only recalculated when something actually changed.
  • Smoother streaming updates: the live status stream uses a lightweight change-check instead of repeatedly rebuilding huge JSON strings.

• Watchers (Plex / Jellyfin / Emby)

  • Smarter polling: watchers back off when nothing is playing, so they don’t waste cycles.
  • Fewer redundant lookups: TV show ID lookups are cached, so episode scrobbles don’t trigger extra network calls all the time.
  • Cleaner event output: fewer duplicate start/pause/stop events, which makes the sync timeline less noisy.

• UI (Synchronize button)

  • Returning to the main screen now triggers an immediate refresh, so the Synchronize button becomes available right away.
  • More reliable enable/disable logic: the button state is based on real conditions.

CrossWatch - v0.7.4

🔧 Fixes & Improvements

• Optimalizations

  • The core script now loads only what’s needed for the current screen.
  • CSS cleanup: branding styles are merged and more consistent.
  • Removed duplicate progress handling so the progress bar and sync timeline behave more reliably.
  • Removed leftover/unused code that could cause small edge-case glitches.

• Cleaner provider icons in Settings

  • Provider logos now only show when that provider is actually configured (instead of showing everything).
  • Scrobbler icons now reflect your enabled Watcher provider and selected sinks (instead of showing everything).

• SIMKL and Trakt auth behaves better after approval

  • “Waiting for token” polling is smarter: ~2s intervals for ~30s, then it slows down.
  • Switching back to the CrossWatch tab triggers an immediate check (no unnecessary waiting).

• SIMKL history sync includes completed shows and anime

  • Fixed an issue where shows/anime could disappear from the snapshot after finishing the final episode.

• Fewer API calls, faster syncs (new batching controls)

  • Added provider-specific batching controls so large syncs can run with fewer requests.
  • Default behavior stays the same (safe 100), but you can override per provider when needed (such as SIMKL).
  • Config-only (for now): currently only SIMKL is wired up; other providers will keep the default until they’re tested and added.

read here for updated orchestrator

Example config.json

"apply_chunk_size_by_provider": {
  "SIMKL": 500,    <-- currently added
  "TRAKT": 500,
  "MDBLIST": 500
}

CrossWatch - v0.7.3

🔧 Fixes & Improvements

• Auth providers now load only when needed

  • Authentication provider are no longer loaded on every page load.
  • This reduces initial network requests and keeps the UI lighter.

• Orchestrator: history

  • Fixed a bug where episode entries could be mistaken as “already synced” when the show existed on target provider.
  • Fixed a matching bug that could cause ghost changes during history sync (planned adds that end up being skipped).
  • Result: more accurate history syncs and less noisy sync summaries.

• Plex authentication UI improvement

  • Clear warning when Plex Media Server (PMS) can’t be reached
  • If Plex account auth succeeds but the configured PMS URL is wrong/unreachable, CrossWatch now shows:
    • Connected, but PMS is not reachable - validate settings.

• MDBList provider history sync is more stable

  • No more “remove everything / add everything back” loops.
  • MDBList show/season summary entries are ignored; only real history items are synced.
  • Sync summary no longer shows fake “skipped” items when MDBList processes bulk updates.
  • Prevents fake “+1 rating” changes caused by invalid IMDb IDs.

CrossWatch - v0.7.2

🔧 Fixes & Improvements

• API and performance improvement (SIMKL/TRAKT/MDBLIST)

  • Removed “episode title enrichment” lookups during sync. This was too API-intensive.
    • Episode entries from now on display as Show Name - S01E01 and not the episode title anymore.
  • Prevents hitting daily API limits and avoids API request spikes on first syncs.
  • In future releases, I’ll aim to reduce API calls even further.
  • Thanks to @Entixs for the bug report.

• Episode display regression in the Sync summary / History spotlight

  • Episode items now show the show name (South Park - S01E05) instead of only S01E05.

• Plex history sync is faster and lighter

  • The optional “include marked watched” hydration no longer scans entire Plex libraries.
  • CrossWatch now requests only watched items, paginates, and stops once it reaches older plays.
  • Big speed-up on large libraries and fewer Plex API calls after the first run.

• Web UI network usage reduced

  • The Sync status screen now prefers live updates and uses polling only as a fallback.
  • The Pairs list refresh is now event-driven (updates when something changes), with a slow safety refresh.
  • Scheduler banner updates are now throttled to prevent bursty refresh storms from focus/tab events.
  • “Currently watching” UI updates are de-duplicated

• Pair-scoped tombstones

  • Tombstones are now pair-scoped and stored under .cw_state, preventing “delete memory” from one provider pair blocking another.
  • Fixes cases where shows (and full seasons) could stay stuck even after a reset.

CrossWatch - v0.7.1

🔧 Fixes & Improvements

• Big performance fix

  • Fixed an issue that would spam CrossWatch with background requests, causing huge lag.
    - Thanks to @jabrown93 for opening the bug report and debugging.

• AniList linking

  • Improved the AniList login/link flow so it doesn’t keep “refreshing” in the background.

CrossWatch - v0.7.0

This release has many many many changes and big changes. Really big!.....

• Existing users: you’ll see a migration window. It wipes the old cache. After upgrading and migrating, do a hard cache refresh in your browser (CTR-F5)
• New users: you'll get a welcome message that opens op the settings page for you.

The orchestrator got a serious overhaul, which means bugs are more likely. So watch your step and report bugs!
It’ll take some iterations/versions to get things fine-tuned, but this major change was absolute necessary.
Analyzer and Editor still aren’t perfect, but they’re functional enough to get the job done....

IMPORTANT:
i've also fixed a real murder bug that was in v0.6.4. Going to Settings could kick off an infinite /api/config request loop, basically freezing CrossWatch.

Orchestrator state vs Pair-scoped provider caches (what changed in v0.7.0)

CrossWatch now clearly separates global orchestration state from pair-specific provider caches.
This means that the old provider caches are useless and needs to be recreated.

Global

• Baselines & drop-guard remain global per provider and feature.
  • Used for sanity checksand delta safety.
• Manual blocks / allow-lists remain global.
  • If you block an item via the Editor state.json, it’s filtered out of planning across all pairs where that provider and feature applies.
  • If you block an item via the Editor Pair cache, it’s filtered out of planning for that specific pair only.

Pair-scoped (new provider-side caches/shadows)

• Providers now store watermarks, snapshots and write-through shadows per pair scope.

This means:

• Multiple pairs can run without overwriting each other’s cached snapshots/watermarks.
• Providers can safely reuse cached “present” indexes (when activities timestamps match) without risking cross-pair contamination.
• Less API traffic because “unchanged” states can reuse pair-local shadows instead of re-fetching full lists.

Practical impact

• Reliability improves in multi-pair setups: pairs no longer “move the clock” for each other.
• State editing still works: blocking items in the Editor still affects planning (global policy),
  while pair-scoped files only affect provider caching behavior and incremental checkpoints.

🔧 Fixes & Improvements

FIX: Scrobble settings leak fix

• Navigating to Settings could previously trigger an infinite request loop to /api/config, effectively freezing CrossWatch.
  This is now fixed: the scrobbler is properly gated and no longer hammers /api/config.

Pair-specific watermarks (SIMKL, TRAKT, MDBList)

• SIMKLand MDBList now use pair-specific watermarks
  • Every sync pair keeps its own “last synced” timestamps per feature (watchlist / ratings / history).
  • This prevents one pair from “moving the clock forward” for another pair and accidentally skipping items.

MDBList

• New: Watch History support
  • MDBList can now sync your watch history in addition to watchlist and ratings.
  • i've also updated the /scripts/mdblist_cleanup.py with watch history support and fixed pagination issue with ratings.

Pair deletion cleanup

• New: Pair-scoped cache cleanup on delete
  • When a sync pair is deleted, CrossWatch now removes the corresponding pair-scoped provider cache/shadow files from .cw_state.
  • Prevents stale cache buildup and avoids old pair artifacts lingering after cleanup.

UI / Status Probes (API call reduction)

• Reduced provider API calls on browser refresh
• Some UI improvements in settings
• Scrobbe/Watcher UI fine-tuned.

Auth UI reliability

• Popup opening made consistent across providers
  • SIMKL now opens a blank tab immediately on click, then navigates to the real authorize URL once fetched (prevents popup blockers from killing the flow).
  • Trakt now shows a clear warning when the activation tab is blocked by the browser ("Popup blocked - allow popups and try again").
  • Plex now shows the same warning when the link tab is blocked, and closes the placeholder tab if PIN creation fails.
• Some consitancy tweaks across all providers

Watcher Scrobble sinks (Trakt - MDBList - SIMKL)

• Progress throttling to reduce API calls
  • Trakt, MDBList, and SIMKL scrobble sinks now support sending progress updates in steps (default: 5%*).
  • This turns “~one call per 1%” into “~one call per 5%”, which is a big drop in API traffic during long plays.
  • This value can be adjusted in Watcher/Advanced (1%-25%) where 1% is almost realtime (most API calls) and 25% acts more like webhooks (minimum API calls)

CrossWatch - v0.7.7

This update overhauls the Settings UI to make it much easier to navigate.
Plex, Emby, Jellyfin, Scrobbler (Webhooks and Watcher), Metadata, Scheduling, and general Settings are now grouped and organized more clearly.

✨ Highlights

• Settings UI overhaul
  • Cleaner navigation with better grouping and less scrolling
  • Media servers: Plex / Jellyfin / Emby
  • Scrobbler: Webhooks and Watcher, now easier to manage
  • Metadata and Scheduling reorganized for faster access
  • General Settings improved layout and discoverability

CrossWatch - v0.7.6

This update fixes the episode titles in the UI for History & Ratings.
Adds optional authentication for people who don’t want CrossWatch UI wide open.

✨ Highlights

• Security: Optional UI authentication
  • Enable it in Settings (UI / Security / CW Tracker) turn on authentication and set a username and password.
  • 30-day “remember me” login once you sign in.

🔧 Fixes & Improvements

• UI: History & Ratings episode titles

  • Correct episode formatting: episodes now show as Show - S01E01 where possible
  • No more “title flip” after loading: the dashboard no longer overwrites the run summary spotlight items with a simplified version from the insights refresh.
  • More consistent spotlight details: CW keeps episode metadata (show name and season/episode) so the lanes stay stable and readable.

• UI: Provider library whitelists no longer reset

  • Whitelists are preserved on Save after restarts: Plex/Emby/Jellyfin library selections won’t get wiped just because you restarted the container and hit Save.

CrossWatch - v0.7.5

Sorry people, I normally don’t push two updates in a day, but this one brings some nice performance boosts. Didn’t want to make you wait.

🔧 Fixes & Improvements

• Performance & stability

  • Less CPU usage when idle: the server no longer keeps re-reading and re-decoding the same big JSON “state” file over and over.
  • Faster dashboard updates: run summaries (the “lanes” / timeline view) are now cached and only recalculated when something actually changed.
  • Smoother streaming updates: the live status stream uses a lightweight change-check instead of repeatedly rebuilding huge JSON strings.

• Watchers (Plex / Jellyfin / Emby)

  • Smarter polling: watchers back off when nothing is playing, so they don’t waste cycles.
  • Fewer redundant lookups: TV show ID lookups are cached, so episode scrobbles don’t trigger extra network calls all the time.
  • Cleaner event output: fewer duplicate start/pause/stop events, which makes the sync timeline less noisy.

• UI (Synchronize button)

  • Returning to the main screen now triggers an immediate refresh, so the Synchronize button becomes available right away.
  • More reliable enable/disable logic: the button state is based on real conditions.

CrossWatch - v0.7.4

🔧 Fixes & Improvements

• Optimalizations

  • The core script now loads only what’s needed for the current screen.
  • CSS cleanup: branding styles are merged and more consistent.
  • Removed duplicate progress handling so the progress bar and sync timeline behave more reliably.
  • Removed leftover/unused code that could cause small edge-case glitches.

• Cleaner provider icons in Settings

  • Provider logos now only show when that provider is actually configured (instead of showing everything).
  • Scrobbler icons now reflect your enabled Watcher provider and selected sinks (instead of showing everything).

• SIMKL and Trakt auth behaves better after approval

  • “Waiting for token” polling is smarter: ~2s intervals for ~30s, then it slows down.
  • Switching back to the CrossWatch tab triggers an immediate check (no unnecessary waiting).

• SIMKL history sync includes completed shows and anime

  • Fixed an issue where shows/anime could disappear from the snapshot after finishing the final episode.

• Fewer API calls, faster syncs (new batching controls)

  • Added provider-specific batching controls so large syncs can run with fewer requests.
  • Default behavior stays the same (safe 100), but you can override per provider when needed (such as SIMKL).
  • Config-only (for now): currently only SIMKL is wired up; other providers will keep the default until they’re tested and added.

read here for updated orchestrator

Example config.json

"apply_chunk_size_by_provider": {
  "SIMKL": 500,    <-- currently added
  "TRAKT": 500,
  "MDBLIST": 500
}

CrossWatch - v0.7.3

🔧 Fixes & Improvements

• Auth providers now load only when needed

  • Authentication provider are no longer loaded on every page load.
  • This reduces initial network requests and keeps the UI lighter.

• Orchestrator: history

  • Fixed a bug where episode entries could be mistaken as “already synced” when the show existed on target provider.
  • Fixed a matching bug that could cause ghost changes during history sync (planned adds that end up being skipped).
  • Result: more accurate history syncs and less noisy sync summaries.

• Plex authentication UI improvement

  • Clear warning when Plex Media Server (PMS) can’t be reached
  • If Plex account auth succeeds but the configured PMS URL is wrong/unreachable, CrossWatch now shows:
    • Connected, but PMS is not reachable - validate settings.

• MDBList provider history sync is more stable

  • No more “remove everything / add everything back” loops.
  • MDBList show/season summary entries are ignored; only real history items are synced.
  • Sync summary no longer shows fake “skipped” items when MDBList processes bulk updates.
  • Prevents fake “+1 rating” changes caused by invalid IMDb IDs.

CrossWatch - v0.7.2

🔧 Fixes & Improvements

• API and performance improvement (SIMKL/TRAKT/MDBLIST)

  • Removed “episode title enrichment” lookups during sync. This was too API-intensive.
    • Episode entries from now on display as Show Name - S01E01 and not the episode title anymore.
  • Prevents hitting daily API limits and avoids API request spikes on first syncs.
  • In future releases, I’ll aim to reduce API calls even further.
  • Thanks to @Entixs for the bug report.

• Episode display regression in the Sync summary / History spotlight

  • Episode items now show the show name (South Park - S01E05) instead of only S01E05.

• Plex history sync is faster and lighter

  • The optional “include marked watched” hydration no longer scans entire Plex libraries.
  • CrossWatch now requests only watched items, paginates, and stops once it reaches older plays.
  • Big speed-up on large libraries and fewer Plex API calls after the first run.

• Web UI network usage reduced

  • The Sync status screen now prefers live updates and uses polling only as a fallback.
  • The Pairs list refresh is now event-driven (updates when something changes), with a slow safety refresh.
  • Scheduler banner updates are now throttled to prevent bursty refresh storms from focus/tab events.
  • “Currently watching” UI updates are de-duplicated

• Pair-scoped tombstones

  • Tombstones are now pair-scoped and stored under .cw_state, preventing “delete memory” from one provider pair blocking another.
  • Fixes cases where shows (and full seasons) could stay stuck even after a reset.

CrossWatch - v0.7.1

🔧 Fixes & Improvements

• Big performance fix

  • Fixed an issue that would spam CrossWatch with background requests, causing huge lag.
    - Thanks to @jabrown93 for opening the bug report and debugging.

• AniList linking

  • Improved the AniList login/link flow so it doesn’t keep “refreshing” in the background.

CrossWatch - v0.7.0

This release has many many many changes and big changes. Really big!.....

• Existing users: you’ll see a migration window. It wipes the old cache. After upgrading and migrating, do a hard cache refresh in your browser (CTR-F5)
• New users: you'll get a welcome message that opens op the settings page for you.

The orchestrator got a serious overhaul, which means bugs are more likely. So watch your step and report bugs!
It’ll take some iterations/versions to get things fine-tuned, but this major change was absolute necessary.
Analyzer and Editor still aren’t perfect, but they’re functional enough to get the job done....

IMPORTANT:
i've also fixed a real murder bug that was in v0.6.4. Going to Settings could kick off an infinite /api/config request loop, basically freezing CrossWatch.

Orchestrator state vs Pair-scoped provider caches (what changed in v0.7.0)

CrossWatch now clearly separates global orchestration state from pair-specific provider caches.
This means that the old provider caches are useless and needs to be recreated.

Global

• Baselines & drop-guard remain global per provider and feature.
  • Used for sanity checksand delta safety.
• Manual blocks / allow-lists remain global.
  • If you block an item via the Editor state.json, it’s filtered out of planning across all pairs where that provider and feature applies.
  • If you block an item via the Editor Pair cache, it’s filtered out of planning for that specific pair only.

Pair-scoped (new provider-side caches/shadows)

• Providers now store watermarks, snapshots and write-through shadows per pair scope.

This means:

• Multiple pairs can run without overwriting each other’s cached snapshots/watermarks.
• Providers can safely reuse cached “present” indexes (when activities timestamps match) without risking cross-pair contamination.
• Less API traffic because “unchanged” states can reuse pair-local shadows instead of re-fetching full lists.

Practical impact

• Reliability improves in multi-pair setups: pairs no longer “move the clock” for each other.
• State editing still works: blocking items in the Editor still affects planning (global policy),
  while pair-scoped files only affect provider caching behavior and incremental checkpoints.

🔧 Fixes & Improvements

FIX: Scrobble settings leak fix

• Navigating to Settings could previously trigger an infinite request loop to /api/config, effectively freezing CrossWatch.
  This is now fixed: the scrobbler is properly gated and no longer hammers /api/config.

Pair-specific watermarks (SIMKL, TRAKT, MDBList)

• SIMKLand MDBList now use pair-specific watermarks
  • Every sync pair keeps its own “last synced” timestamps per feature (watchlist / ratings / history).
  • This prevents one pair from “moving the clock forward” for another pair and accidentally skipping items.

MDBList

• New: Watch History support
  • MDBList can now sync your watch history in addition to watchlist and ratings.
  • i've also updated the /scripts/mdblist_cleanup.py with watch history support and fixed pagination issue with ratings.

Pair deletion cleanup

• New: Pair-scoped cache cleanup on delete
  • When a sync pair is deleted, CrossWatch now removes the corresponding pair-scoped provider cache/shadow files from .cw_state.
  • Prevents stale cache buildup and avoids old pair artifacts lingering after cleanup.

UI / Status Probes (API call reduction)

• Reduced provider API calls on browser refresh
• Some UI improvements in settings
• Scrobbe/Watcher UI fine-tuned.

Auth UI reliability

• Popup opening made consistent across providers
  • SIMKL now opens a blank tab immediately on click, then navigates to the real authorize URL once fetched (prevents popup blockers from killing the flow).
  • Trakt now shows a clear warning when the activation tab is blocked by the browser ("Popup blocked - allow popups and try again").
  • Plex now shows the same warning when the link tab is blocked, and closes the placeholder tab if PIN creation fails.
• Some consitancy tweaks across all providers

Watcher Scrobble sinks (Trakt - MDBList - SIMKL)

• Progress throttling to reduce API calls
  • Trakt, MDBList, and SIMKL scrobble sinks now support sending progress updates in steps (default: 5%*).
  • This turns “~one call per 1%” into “~one call per 5%”, which is a big drop in API traffic during long plays.
  • This value can be adjusted in Watcher/Advanced (1%-25%) where 1% is almost realtime (most API calls) and 25% acts more like webhooks (minimum API calls)

CrossWatch - v0.7.6

This update fixes the episode titles in the UI for History & Ratings.
Adds optional authentication for people who don’t want CrossWatch UI wide open.

✨ Highlights

• Security: Optional UI authentication
  • Enable it in Settings (UI / Security / CW Tracker) turn on authentication and set a username and password.
  • 30-day “remember me” login once you sign in.

🔧 Fixes & Improvements

• UI: History & Ratings episode titles

  • Correct episode formatting: episodes now show as Show - S01E01 where possible
  • No more “title flip” after loading: the dashboard no longer overwrites the run summary spotlight items with a simplified version from the insights refresh.
  • More consistent spotlight details: CW keeps episode metadata (show name and season/episode) so the lanes stay stable and readable.

• UI: Provider library whitelists no longer reset

  • Whitelists are preserved on Save after restarts: Plex/Emby/Jellyfin library selections won’t get wiped just because you restarted the container and hit Save.

CrossWatch - v0.7.5

Sorry people, I normally don’t push two updates in a day, but this one brings some nice performance boosts. Didn’t want to make you wait.

🔧 Fixes & Improvements

• Performance & stability

  • Less CPU usage when idle: the server no longer keeps re-reading and re-decoding the same big JSON “state” file over and over.
  • Faster dashboard updates: run summaries (the “lanes” / timeline view) are now cached and only recalculated when something actually changed.
  • Smoother streaming updates: the live status stream uses a lightweight change-check instead of repeatedly rebuilding huge JSON strings.

• Watchers (Plex / Jellyfin / Emby)

  • Smarter polling: watchers back off when nothing is playing, so they don’t waste cycles.
  • Fewer redundant lookups: TV show ID lookups are cached, so episode scrobbles don’t trigger extra network calls all the time.
  • Cleaner event output: fewer duplicate start/pause/stop events, which makes the sync timeline less noisy.

• UI (Synchronize button)

  • Returning to the main screen now triggers an immediate refresh, so the Synchronize button becomes available right away.
  • More reliable enable/disable logic: the button state is based on real conditions.

CrossWatch - v0.7.4

🔧 Fixes & Improvements

• Optimalizations

  • The core script now loads only what’s needed for the current screen.
  • CSS cleanup: branding styles are merged and more consistent.
  • Removed duplicate progress handling so the progress bar and sync timeline behave more reliably.
  • Removed leftover/unused code that could cause small edge-case glitches.

• Cleaner provider icons in Settings

  • Provider logos now only show when that provider is actually configured (instead of showing everything).
  • Scrobbler icons now reflect your enabled Watcher provider and selected sinks (instead of showing everything).

• SIMKL and Trakt auth behaves better after approval

  • “Waiting for token” polling is smarter: ~2s intervals for ~30s, then it slows down.
  • Switching back to the CrossWatch tab triggers an immediate check (no unnecessary waiting).

• SIMKL history sync includes completed shows and anime

  • Fixed an issue where shows/anime could disappear from the snapshot after finishing the final episode.

• Fewer API calls, faster syncs (new batching controls)

  • Added provider-specific batching controls so large syncs can run with fewer requests.
  • Default behavior stays the same (safe 100), but you can override per provider when needed (such as SIMKL).
  • Config-only (for now): currently only SIMKL is wired up; other providers will keep the default until they’re tested and added.

read here for updated orchestrator

Example config.json

"apply_chunk_size_by_provider": {
  "SIMKL": 500,    <-- currently added
  "TRAKT": 500,
  "MDBLIST": 500
}

CrossWatch - v0.7.3

🔧 Fixes & Improvements

• Auth providers now load only when needed

  • Authentication provider are no longer loaded on every page load.
  • This reduces initial network requests and keeps the UI lighter.

• Orchestrator: history

  • Fixed a bug where episode entries could be mistaken as “already synced” when the show existed on target provider.
  • Fixed a matching bug that could cause ghost changes during history sync (planned adds that end up being skipped).
  • Result: more accurate history syncs and less noisy sync summaries.

• Plex authentication UI improvement

  • Clear warning when Plex Media Server (PMS) can’t be reached
  • If Plex account auth succeeds but the configured PMS URL is wrong/unreachable, CrossWatch now shows:
    • Connected, but PMS is not reachable - validate settings.

• MDBList provider history sync is more stable

  • No more “remove everything / add everything back” loops.
  • MDBList show/season summary entries are ignored; only real history items are synced.
  • Sync summary no longer shows fake “skipped” items when MDBList processes bulk updates.
  • Prevents fake “+1 rating” changes caused by invalid IMDb IDs.

CrossWatch - v0.7.2

🔧 Fixes & Improvements

• API and performance improvement (SIMKL/TRAKT/MDBLIST)

  • Removed “episode title enrichment” lookups during sync. This was too API-intensive.
    • Episode entries from now on display as Show Name - S01E01 and not the episode title anymore.
  • Prevents hitting daily API limits and avoids API request spikes on first syncs.
  • In future releases, I’ll aim to reduce API calls even further.
  • Thanks to @Entixs for the bug report.

• Episode display regression in the Sync summary / History spotlight

  • Episode items now show the show name (South Park - S01E05) instead of only S01E05.

• Plex history sync is faster and lighter

  • The optional “include marked watched” hydration no longer scans entire Plex libraries.
  • CrossWatch now requests only watched items, paginates, and stops once it reaches older plays.
  • Big speed-up on large libraries and fewer Plex API calls after the first run.

• Web UI network usage reduced

  • The Sync status screen now prefers live updates and uses polling only as a fallback.
  • The Pairs list refresh is now event-driven (updates when something changes), with a slow safety refresh.
  • Scheduler banner updates are now throttled to prevent bursty refresh storms from focus/tab events.
  • “Currently watching” UI updates are de-duplicated

• Pair-scoped tombstones

  • Tombstones are now pair-scoped and stored under .cw_state, preventing “delete memory” from one provider pair blocking another.
  • Fixes cases where shows (and full seasons) could stay stuck even after a reset.

CrossWatch - v0.7.1

🔧 Fixes & Improvements

• Big performance fix

  • Fixed an issue that would spam CrossWatch with background requests, causing huge lag.
    - Thanks to @jabrown93 for opening the bug report and debugging.

• AniList linking

  • Improved the AniList login/link flow so it doesn’t keep “refreshing” in the background.

CrossWatch - v0.7.0

This release has many many many changes and big changes. Really big!.....

• Existing users: you’ll see a migration window. It wipes the old cache. After upgrading and migrating, do a hard cache refresh in your browser (CTR-F5)
• New users: you'll get a welcome message that opens op the settings page for you.

The orchestrator got a serious overhaul, which means bugs are more likely. So watch your step and report bugs!
It’ll take some iterations/versions to get things fine-tuned, but this major change was absolute necessary.
Analyzer and Editor still aren’t perfect, but they’re functional enough to get the job done....

IMPORTANT:
i've also fixed a real murder bug that was in v0.6.4. Going to Settings could kick off an infinite /api/config request loop, basically freezing CrossWatch.

Orchestrator state vs Pair-scoped provider caches (what changed in v0.7.0)

CrossWatch now clearly separates global orchestration state from pair-specific provider caches.
This means that the old provider caches are useless and needs to be recreated.

Global

• Baselines & drop-guard remain global per provider and feature.
  • Used for sanity checksand delta safety.
• Manual blocks / allow-lists remain global.
  • If you block an item via the Editor state.json, it’s filtered out of planning across all pairs where that provider and feature applies.
  • If you block an item via the Editor Pair cache, it’s filtered out of planning for that specific pair only.

Pair-scoped (new provider-side caches/shadows)

• Providers now store watermarks, snapshots and write-through shadows per pair scope.

This means:

• Multiple pairs can run without overwriting each other’s cached snapshots/watermarks.
• Providers can safely reuse cached “present” indexes (when activities timestamps match) without risking cross-pair contamination.
• Less API traffic because “unchanged” states can reuse pair-local shadows instead of re-fetching full lists.

Practical impact

• Reliability improves in multi-pair setups: pairs no longer “move the clock” for each other.
• State editing still works: blocking items in the Editor still affects planning (global policy),
  while pair-scoped files only affect provider caching behavior and incremental checkpoints.

🔧 Fixes & Improvements

FIX: Scrobble settings leak fix

• Navigating to Settings could previously trigger an infinite request loop to /api/config, effectively freezing CrossWatch.
  This is now fixed: the scrobbler is properly gated and no longer hammers /api/config.

Pair-specific watermarks (SIMKL, TRAKT, MDBList)

• SIMKLand MDBList now use pair-specific watermarks
  • Every sync pair keeps its own “last synced” timestamps per feature (watchlist / ratings / history).
  • This prevents one pair from “moving the clock forward” for another pair and accidentally skipping items.

MDBList

• New: Watch History support
  • MDBList can now sync your watch history in addition to watchlist and ratings.
  • i've also updated the /scripts/mdblist_cleanup.py with watch history support and fixed pagination issue with ratings.

Pair deletion cleanup

• New: Pair-scoped cache cleanup on delete
  • When a sync pair is deleted, CrossWatch now removes the corresponding pair-scoped provider cache/shadow files from .cw_state.
  • Prevents stale cache buildup and avoids old pair artifacts lingering after cleanup.

UI / Status Probes (API call reduction)

• Reduced provider API calls on browser refresh
• Some UI improvements in settings
• Scrobbe/Watcher UI fine-tuned.

Auth UI reliability

• Popup opening made consistent across providers
  • SIMKL now opens a blank tab immediately on click, then navigates to the real authorize URL once fetched (prevents popup blockers from killing the flow).
  • Trakt now shows a clear warning when the activation tab is blocked by the browser ("Popup blocked - allow popups and try again").
  • Plex now shows the same warning when the link tab is blocked, and closes the placeholder tab if PIN creation fails.
• Some consitancy tweaks across all providers

Watcher Scrobble sinks (Trakt - MDBList - SIMKL)

• Progress throttling to reduce API calls
  • Trakt, MDBList, and SIMKL scrobble sinks now support sending progress updates in steps (default: 5%*).
  • This turns “~one call per 1%” into “~one call per 5%”, which is a big drop in API traffic during long plays.
  • This value can be adjusted in Watcher/Advanced (1%-25%) where 1% is almost realtime (most API calls) and 25% acts more like webhooks (minimum API calls)

CrossWatch - v0.7.5

Sorry people, I normally don’t push two updates in a day, but this one brings some nice performance boosts. Didn’t want to make you wait.

🔧 Fixes & Improvements

• Performance & stability

  • Less CPU usage when idle: the server no longer keeps re-reading and re-decoding the same big JSON “state” file over and over.
  • Faster dashboard updates: run summaries (the “lanes” / timeline view) are now cached and only recalculated when something actually changed.
  • Smoother streaming updates: the live status stream uses a lightweight change-check instead of repeatedly rebuilding huge JSON strings.

• Watchers (Plex / Jellyfin / Emby)

  • Smarter polling: watchers back off when nothing is playing, so they don’t waste cycles.
  • Fewer redundant lookups: TV show ID lookups are cached, so episode scrobbles don’t trigger extra network calls all the time.
  • Cleaner event output: fewer duplicate start/pause/stop events, which makes the sync timeline less noisy.

• UI (Synchronize button)

  • Returning to the main screen now triggers an immediate refresh, so the Synchronize button becomes available right away.
  • More reliable enable/disable logic: the button state is based on real conditions.

CrossWatch - v0.7.4

🔧 Fixes & Improvements

• Optimalizations

  • The core script now loads only what’s needed for the current screen.
  • CSS cleanup: branding styles are merged and more consistent.
  • Removed duplicate progress handling so the progress bar and sync timeline behave more reliably.
  • Removed leftover/unused code that could cause small edge-case glitches.

• Cleaner provider icons in Settings

  • Provider logos now only show when that provider is actually configured (instead of showing everything).
  • Scrobbler icons now reflect your enabled Watcher provider and selected sinks (instead of showing everything).

• SIMKL and Trakt auth behaves better after approval

  • “Waiting for token” polling is smarter: ~2s intervals for ~30s, then it slows down.
  • Switching back to the CrossWatch tab triggers an immediate check (no unnecessary waiting).

• SIMKL history sync includes completed shows and anime

  • Fixed an issue where shows/anime could disappear from the snapshot after finishing the final episode.

• Fewer API calls, faster syncs (new batching controls)

  • Added provider-specific batching controls so large syncs can run with fewer requests.
  • Default behavior stays the same (safe 100), but you can override per provider when needed (such as SIMKL).
  • Config-only (for now): currently only SIMKL is wired up; other providers will keep the default until they’re tested and added.

read here for updated orchestrator

Example config.json

"apply_chunk_size_by_provider": {
  "SIMKL": 500,    <-- currently added
  "TRAKT": 500,
  "MDBLIST": 500
}

CrossWatch - v0.7.3

🔧 Fixes & Improvements

• Auth providers now load only when needed

  • Authentication provider are no longer loaded on every page load.
  • This reduces initial network requests and keeps the UI lighter.

• Orchestrator: history

  • Fixed a bug where episode entries could be mistaken as “already synced” when the show existed on target provider.
  • Fixed a matching bug that could cause ghost changes during history sync (planned adds that end up being skipped).
  • Result: more accurate history syncs and less noisy sync summaries.

• Plex authentication UI improvement

  • Clear warning when Plex Media Server (PMS) can’t be reached
  • If Plex account auth succeeds but the configured PMS URL is wrong/unreachable, CrossWatch now shows:
    • Connected, but PMS is not reachable - validate settings.

• MDBList provider history sync is more stable

  • No more “remove everything / add everything back” loops.
  • MDBList show/season summary entries are ignored; only real history items are synced.
  • Sync summary no longer shows fake “skipped” items when MDBList processes bulk updates.
  • Prevents fake “+1 rating” changes caused by invalid IMDb IDs.

CrossWatch - v0.7.2

🔧 Fixes & Improvements

• API and performance improvement (SIMKL/TRAKT/MDBLIST)

  • Removed “episode title enrichment” lookups during sync. This was too API-intensive.
    • Episode entries from now on display as Show Name - S01E01 and not the episode title anymore.
  • Prevents hitting daily API limits and avoids API request spikes on first syncs.
  • In future releases, I’ll aim to reduce API calls even further.
  • Thanks to @Entixs for the bug report.

• Episode display regression in the Sync summary / History spotlight

  • Episode items now show the show name (South Park - S01E05) instead of only S01E05.

• Plex history sync is faster and lighter

  • The optional “include marked watched” hydration no longer scans entire Plex libraries.
  • CrossWatch now requests only watched items, paginates, and stops once it reaches older plays.
  • Big speed-up on large libraries and fewer Plex API calls after the first run.

• Web UI network usage reduced

  • The Sync status screen now prefers live updates and uses polling only as a fallback.
  • The Pairs list refresh is now event-driven (updates when something changes), with a slow safety refresh.
  • Scheduler banner updates are now throttled to prevent bursty refresh storms from focus/tab events.
  • “Currently watching” UI updates are de-duplicated

• Pair-scoped tombstones

  • Tombstones are now pair-scoped and stored under .cw_state, preventing “delete memory” from one provider pair blocking another.
  • Fixes cases where shows (and full seasons) could stay stuck even after a reset.

CrossWatch - v0.7.1

🔧 Fixes & Improvements

• Big performance fix

  • Fixed an issue that would spam CrossWatch with background requests, causing huge lag.
    - Thanks to @jabrown93 for opening the bug report and debugging.

• AniList linking

  • Improved the AniList login/link flow so it doesn’t keep “refreshing” in the background.

CrossWatch - v0.7.0

This release has many many many changes and big changes. Really big!.....

• Existing users: you’ll see a migration window. It wipes the old cache. After upgrading and migrating, do a hard cache refresh in your browser (CTR-F5)
• New users: you'll get a welcome message that opens op the settings page for you.

The orchestrator got a serious overhaul, which means bugs are more likely. So watch your step and report bugs!
It’ll take some iterations/versions to get things fine-tuned, but this major change was absolute necessary.
Analyzer and Editor still aren’t perfect, but they’re functional enough to get the job done....

IMPORTANT:
i've also fixed a real murder bug that was in v0.6.4. Going to Settings could kick off an infinite /api/config request loop, basically freezing CrossWatch.

Orchestrator state vs Pair-scoped provider caches (what changed in v0.7.0)

CrossWatch now clearly separates global orchestration state from pair-specific provider caches.
This means that the old provider caches are useless and needs to be recreated.

Global

• Baselines & drop-guard remain global per provider and feature.
  • Used for sanity checksand delta safety.
• Manual blocks / allow-lists remain global.
  • If you block an item via the Editor state.json, it’s filtered out of planning across all pairs where that provider and feature applies.
  • If you block an item via the Editor Pair cache, it’s filtered out of planning for that specific pair only.

Pair-scoped (new provider-side caches/shadows)

• Providers now store watermarks, snapshots and write-through shadows per pair scope.

This means:

• Multiple pairs can run without overwriting each other’s cached snapshots/watermarks.
• Providers can safely reuse cached “present” indexes (when activities timestamps match) without risking cross-pair contamination.
• Less API traffic because “unchanged” states can reuse pair-local shadows instead of re-fetching full lists.

Practical impact

• Reliability improves in multi-pair setups: pairs no longer “move the clock” for each other.
• State editing still works: blocking items in the Editor still affects planning (global policy),
  while pair-scoped files only affect provider caching behavior and incremental checkpoints.

🔧 Fixes & Improvements

FIX: Scrobble settings leak fix

• Navigating to Settings could previously trigger an infinite request loop to /api/config, effectively freezing CrossWatch.
  This is now fixed: the scrobbler is properly gated and no longer hammers /api/config.

Pair-specific watermarks (SIMKL, TRAKT, MDBList)

• SIMKLand MDBList now use pair-specific watermarks
  • Every sync pair keeps its own “last synced” timestamps per feature (watchlist / ratings / history).
  • This prevents one pair from “moving the clock forward” for another pair and accidentally skipping items.

MDBList

• New: Watch History support
  • MDBList can now sync your watch history in addition to watchlist and ratings.
  • i've also updated the /scripts/mdblist_cleanup.py with watch history support and fixed pagination issue with ratings.

Pair deletion cleanup

• New: Pair-scoped cache cleanup on delete
  • When a sync pair is deleted, CrossWatch now removes the corresponding pair-scoped provider cache/shadow files from .cw_state.
  • Prevents stale cache buildup and avoids old pair artifacts lingering after cleanup.

UI / Status Probes (API call reduction)

• Reduced provider API calls on browser refresh
• Some UI improvements in settings
• Scrobbe/Watcher UI fine-tuned.

Auth UI reliability

• Popup opening made consistent across providers
  • SIMKL now opens a blank tab immediately on click, then navigates to the real authorize URL once fetched (prevents popup blockers from killing the flow).
  • Trakt now shows a clear warning when the activation tab is blocked by the browser ("Popup blocked - allow popups and try again").
  • Plex now shows the same warning when the link tab is blocked, and closes the placeholder tab if PIN creation fails.
• Some consitancy tweaks across all providers

Watcher Scrobble sinks (Trakt - MDBList - SIMKL)

• Progress throttling to reduce API calls
  • Trakt, MDBList, and SIMKL scrobble sinks now support sending progress updates in steps (default: 5%*).
  • This turns “~one call per 1%” into “~one call per 5%”, which is a big drop in API traffic during long plays.
  • This value can be adjusted in Watcher/Advanced (1%-25%) where 1% is almost realtime (most API calls) and 25% acts more like webhooks (minimum API calls)

CrossWatch - v0.7.4

🔧 Fixes & Improvements

• Optimalizations

  • The core script now loads only what’s needed for the current screen.
  • CSS cleanup: branding styles are merged and more consistent.
  • Removed duplicate progress handling so the progress bar and sync timeline behave more reliably.
  • Removed leftover/unused code that could cause small edge-case glitches.

• Cleaner provider icons in Settings

  • Provider logos now only show when that provider is actually configured (instead of showing everything).
  • Scrobbler icons now reflect your enabled Watcher provider and selected sinks (instead of showing everything).

• SIMKL and Trakt auth behaves better after approval

  • “Waiting for token” polling is smarter: ~2s intervals for ~30s, then it slows down.
  • Switching back to the CrossWatch tab triggers an immediate check (no unnecessary waiting).

• SIMKL history sync includes completed shows and anime

  • Fixed an issue where shows/anime could disappear from the snapshot after finishing the final episode.

• Fewer API calls, faster syncs (new batching controls)

  • Added provider-specific batching controls so large syncs can run with fewer requests.
  • Default behavior stays the same (safe 100), but you can override per provider when needed (such as SIMKL).
  • Config-only (for now): currently only SIMKL is wired up; other providers will keep the default until they’re tested and added.

read here for updated orchestrator

Example config.json

"apply_chunk_size_by_provider": {
  "SIMKL": 500,    <-- currently added
  "TRAKT": 500,
  "MDBLIST": 500
}

CrossWatch - v0.7.3

🔧 Fixes & Improvements

• Auth providers now load only when needed

  • Authentication provider are no longer loaded on every page load.
  • This reduces initial network requests and keeps the UI lighter.

• Orchestrator: history

  • Fixed a bug where episode entries could be mistaken as “already synced” when the show existed on target provider.
  • Fixed a matching bug that could cause ghost changes during history sync (planned adds that end up being skipped).
  • Result: more accurate history syncs and less noisy sync summaries.

• Plex authentication UI improvement

  • Clear warning when Plex Media Server (PMS) can’t be reached
  • If Plex account auth succeeds but the configured PMS URL is wrong/unreachable, CrossWatch now shows:
    • Connected, but PMS is not reachable - validate settings.

• MDBList provider history sync is more stable

  • No more “remove everything / add everything back” loops.
  • MDBList show/season summary entries are ignored; only real history items are synced.
  • Sync summary no longer shows fake “skipped” items when MDBList processes bulk updates.
  • Prevents fake “+1 rating” changes caused by invalid IMDb IDs.

CrossWatch - v0.7.2

🔧 Fixes & Improvements

• API and performance improvement (SIMKL/TRAKT/MDBLIST)

  • Removed “episode title enrichment” lookups during sync. This was too API-intensive.
    • Episode entries from now on display as Show Name - S01E01 and not the episode title anymore.
  • Prevents hitting daily API limits and avoids API request spikes on first syncs.
  • In future releases, I’ll aim to reduce API calls even further.
  • Thanks to @Entixs for the bug report.

• Episode display regression in the Sync summary / History spotlight

  • Episode items now show the show name (South Park - S01E05) instead of only S01E05.

• Plex history sync is faster and lighter

  • The optional “include marked watched” hydration no longer scans entire Plex libraries.
  • CrossWatch now requests only watched items, paginates, and stops once it reaches older plays.
  • Big speed-up on large libraries and fewer Plex API calls after the first run.

• Web UI network usage reduced

  • The Sync status screen now prefers live updates and uses polling only as a fallback.
  • The Pairs list refresh is now event-driven (updates when something changes), with a slow safety refresh.
  • Scheduler banner updates are now throttled to prevent bursty refresh storms from focus/tab events.
  • “Currently watching” UI updates are de-duplicated

• Pair-scoped tombstones

  • Tombstones are now pair-scoped and stored under .cw_state, preventing “delete memory” from one provider pair blocking another.
  • Fixes cases where shows (and full seasons) could stay stuck even after a reset.

CrossWatch - v0.7.1

🔧 Fixes & Improvements

• Big performance fix

  • Fixed an issue that would spam CrossWatch with background requests, causing huge lag.
    - Thanks to @jabrown93 for opening the bug report and debugging.

• AniList linking

  • Improved the AniList login/link flow so it doesn’t keep “refreshing” in the background.

CrossWatch - v0.7.0

This release has many many many changes and big changes. Really big!.....

• Existing users: you’ll see a migration window. It wipes the old cache. After upgrading and migrating, do a hard cache refresh in your browser (CTR-F5)
• New users: you'll get a welcome message that opens op the settings page for you.

The orchestrator got a serious overhaul, which means bugs are more likely. So watch your step and report bugs!
It’ll take some iterations/versions to get things fine-tuned, but this major change was absolute necessary.
Analyzer and Editor still aren’t perfect, but they’re functional enough to get the job done....

IMPORTANT:
i've also fixed a real murder bug that was in v0.6.4. Going to Settings could kick off an infinite /api/config request loop, basically freezing CrossWatch.

Orchestrator state vs Pair-scoped provider caches (what changed in v0.7.0)

CrossWatch now clearly separates global orchestration state from pair-specific provider caches.
This means that the old provider caches are useless and needs to be recreated.

Global

• Baselines & drop-guard remain global per provider and feature.
  • Used for sanity checksand delta safety.
• Manual blocks / allow-lists remain global.
  • If you block an item via the Editor state.json, it’s filtered out of planning across all pairs where that provider and feature applies.
  • If you block an item via the Editor Pair cache, it’s filtered out of planning for that specific pair only.

Pair-scoped (new provider-side caches/shadows)

• Providers now store watermarks, snapshots and write-through shadows per pair scope.

This means:

• Multiple pairs can run without overwriting each other’s cached snapshots/watermarks.
• Providers can safely reuse cached “present” indexes (when activities timestamps match) without risking cross-pair contamination.
• Less API traffic because “unchanged” states can reuse pair-local shadows instead of re-fetching full lists.

Practical impact

• Reliability improves in multi-pair setups: pairs no longer “move the clock” for each other.
• State editing still works: blocking items in the Editor still affects planning (global policy),
  while pair-scoped files only affect provider caching behavior and incremental checkpoints.

🔧 Fixes & Improvements

FIX: Scrobble settings leak fix

• Navigating to Settings could previously trigger an infinite request loop to /api/config, effectively freezing CrossWatch.
  This is now fixed: the scrobbler is properly gated and no longer hammers /api/config.

Pair-specific watermarks (SIMKL, TRAKT, MDBList)

• SIMKLand MDBList now use pair-specific watermarks
  • Every sync pair keeps its own “last synced” timestamps per feature (watchlist / ratings / history).
  • This prevents one pair from “moving the clock forward” for another pair and accidentally skipping items.

MDBList

• New: Watch History support
  • MDBList can now sync your watch history in addition to watchlist and ratings.
  • i've also updated the /scripts/mdblist_cleanup.py with watch history support and fixed pagination issue with ratings.

Pair deletion cleanup

• New: Pair-scoped cache cleanup on delete
  • When a sync pair is deleted, CrossWatch now removes the corresponding pair-scoped provider cache/shadow files from .cw_state.
  • Prevents stale cache buildup and avoids old pair artifacts lingering after cleanup.

UI / Status Probes (API call reduction)

• Reduced provider API calls on browser refresh
• Some UI improvements in settings
• Scrobbe/Watcher UI fine-tuned.

Auth UI reliability

• Popup opening made consistent across providers
  • SIMKL now opens a blank tab immediately on click, then navigates to the real authorize URL once fetched (prevents popup blockers from killing the flow).
  • Trakt now shows a clear warning when the activation tab is blocked by the browser ("Popup blocked - allow popups and try again").
  • Plex now shows the same warning when the link tab is blocked, and closes the placeholder tab if PIN creation fails.
• Some consitancy tweaks across all providers

Watcher Scrobble sinks (Trakt - MDBList - SIMKL)

• Progress throttling to reduce API calls
  • Trakt, MDBList, and SIMKL scrobble sinks now support sending progress updates in steps (default: 5%*).
  • This turns “~one call per 1%” into “~one call per 5%”, which is a big drop in API traffic during long plays.
  • This value can be adjusted in Watcher/Advanced (1%-25%) where 1% is almost realtime (most API calls) and 25% acts more like webhooks (minimum API calls)

CrossWatch - v0.7.3

🔧 Fixes & Improvements

• Auth providers now load only when needed

  • Authentication provider are no longer loaded on every page load.
  • This reduces initial network requests and keeps the UI lighter.

• Orchestrator: history

  • Fixed a bug where episode entries could be mistaken as “already synced” when the show existed on target provider.
  • Fixed a matching bug that could cause ghost changes during history sync (planned adds that end up being skipped).
  • Result: more accurate history syncs and less noisy sync summaries.

• Plex authentication UI improvement

  • Clear warning when Plex Media Server (PMS) can’t be reached
  • If Plex account auth succeeds but the configured PMS URL is wrong/unreachable, CrossWatch now shows:
    • Connected, but PMS is not reachable - validate settings.

• MDBList provider history sync is more stable

  • No more “remove everything / add everything back” loops.
  • MDBList show/season summary entries are ignored; only real history items are synced.
  • Sync summary no longer shows fake “skipped” items when MDBList processes bulk updates.
  • Prevents fake “+1 rating” changes caused by invalid IMDb IDs.

CrossWatch - v0.7.2

🔧 Fixes & Improvements

• API and performance improvement (SIMKL/TRAKT/MDBLIST)

  • Removed “episode title enrichment” lookups during sync. This was too API-intensive.
    • Episode entries from now on display as Show Name - S01E01 and not the episode title anymore.
  • Prevents hitting daily API limits and avoids API request spikes on first syncs.
  • In future releases, I’ll aim to reduce API calls even further.
  • Thanks to @Entixs for the bug report.

• Episode display regression in the Sync summary / History spotlight

  • Episode items now show the show name (South Park - S01E05) instead of only S01E05.

• Plex history sync is faster and lighter

  • The optional “include marked watched” hydration no longer scans entire Plex libraries.
  • CrossWatch now requests only watched items, paginates, and stops once it reaches older plays.
  • Big speed-up on large libraries and fewer Plex API calls after the first run.

• Web UI network usage reduced

  • The Sync status screen now prefers live updates and uses polling only as a fallback.
  • The Pairs list refresh is now event-driven (updates when something changes), with a slow safety refresh.
  • Scheduler banner updates are now throttled to prevent bursty refresh storms from focus/tab events.
  • “Currently watching” UI updates are de-duplicated

• Pair-scoped tombstones

  • Tombstones are now pair-scoped and stored under .cw_state, preventing “delete memory” from one provider pair blocking another.
  • Fixes cases where shows (and full seasons) could stay stuck even after a reset.

CrossWatch - v0.7.1

🔧 Fixes & Improvements

• Big performance fix

  • Fixed an issue that would spam CrossWatch with background requests, causing huge lag.
    - Thanks to @jabrown93 for opening the bug report and debugging.

• AniList linking

  • Improved the AniList login/link flow so it doesn’t keep “refreshing” in the background.

CrossWatch - v0.7.0

This release has many many many changes and big changes. Really big!.....

• Existing users: you’ll see a migration window. It wipes the old cache. After upgrading and migrating, do a hard cache refresh in your browser (CTR-F5)
• New users: you'll get a welcome message that opens op the settings page for you.

The orchestrator got a serious overhaul, which means bugs are more likely. So watch your step and report bugs!
It’ll take some iterations/versions to get things fine-tuned, but this major change was absolute necessary.
Analyzer and Editor still aren’t perfect, but they’re functional enough to get the job done....

IMPORTANT:
i've also fixed a real murder bug that was in v0.6.4. Going to Settings could kick off an infinite /api/config request loop, basically freezing CrossWatch.

Orchestrator state vs Pair-scoped provider caches (what changed in v0.7.0)

CrossWatch now clearly separates global orchestration state from pair-specific provider caches.
This means that the old provider caches are useless and needs to be recreated.

Global

• Baselines & drop-guard remain global per provider and feature.
  • Used for sanity checksand delta safety.
• Manual blocks / allow-lists remain global.
  • If you block an item via the Editor state.json, it’s filtered out of planning across all pairs where that provider and feature applies.
  • If you block an item via the Editor Pair cache, it’s filtered out of planning for that specific pair only.

Pair-scoped (new provider-side caches/shadows)

• Providers now store watermarks, snapshots and write-through shadows per pair scope.

This means:

• Multiple pairs can run without overwriting each other’s cached snapshots/watermarks.
• Providers can safely reuse cached “present” indexes (when activities timestamps match) without risking cross-pair contamination.
• Less API traffic because “unchanged” states can reuse pair-local shadows instead of re-fetching full lists.

Practical impact

• Reliability improves in multi-pair setups: pairs no longer “move the clock” for each other.
• State editing still works: blocking items in the Editor still affects planning (global policy),
  while pair-scoped files only affect provider caching behavior and incremental checkpoints.

🔧 Fixes & Improvements

FIX: Scrobble settings leak fix

• Navigating to Settings could previously trigger an infinite request loop to /api/config, effectively freezing CrossWatch.
  This is now fixed: the scrobbler is properly gated and no longer hammers /api/config.

Pair-specific watermarks (SIMKL, TRAKT, MDBList)

• SIMKLand MDBList now use pair-specific watermarks
  • Every sync pair keeps its own “last synced” timestamps per feature (watchlist / ratings / history).
  • This prevents one pair from “moving the clock forward” for another pair and accidentally skipping items.

MDBList

• New: Watch History support
  • MDBList can now sync your watch history in addition to watchlist and ratings.
  • i've also updated the /scripts/mdblist_cleanup.py with watch history support and fixed pagination issue with ratings.

Pair deletion cleanup

• New: Pair-scoped cache cleanup on delete
  • When a sync pair is deleted, CrossWatch now removes the corresponding pair-scoped provider cache/shadow files from .cw_state.
  • Prevents stale cache buildup and avoids old pair artifacts lingering after cleanup.

UI / Status Probes (API call reduction)

• Reduced provider API calls on browser refresh
• Some UI improvements in settings
• Scrobbe/Watcher UI fine-tuned.

Auth UI reliability

• Popup opening made consistent across providers
  • SIMKL now opens a blank tab immediately on click, then navigates to the real authorize URL once fetched (prevents popup blockers from killing the flow).
  • Trakt now shows a clear warning when the activation tab is blocked by the browser ("Popup blocked - allow popups and try again").
  • Plex now shows the same warning when the link tab is blocked, and closes the placeholder tab if PIN creation fails.
• Some consitancy tweaks across all providers

Watcher Scrobble sinks (Trakt - MDBList - SIMKL)

• Progress throttling to reduce API calls
  • Trakt, MDBList, and SIMKL scrobble sinks now support sending progress updates in steps (default: 5%*).
  • This turns “~one call per 1%” into “~one call per 5%”, which is a big drop in API traffic during long plays.
  • This value can be adjusted in Watcher/Advanced (1%-25%) where 1% is almost realtime (most API calls) and 25% acts more like webhooks (minimum API calls)

CrossWatch - v0.7.2

🔧 Fixes & Improvements

• API and performance improvement (SIMKL/TRAKT/MDBLIST)

  • Removed “episode title enrichment” lookups during sync. This was too API-intensive.
    • Episode entries from now on display as Show Name - S01E01 and not the episode title anymore.
  • Prevents hitting daily API limits and avoids API request spikes on first syncs.
  • In future releases, I’ll aim to reduce API calls even further.
  • Thanks to @Entixs for the bug report.

• Episode display regression in the Sync summary / History spotlight

  • Episode items now show the show name (South Park - S01E05) instead of only S01E05.

• Plex history sync is faster and lighter

  • The optional “include marked watched” hydration no longer scans entire Plex libraries.
  • CrossWatch now requests only watched items, paginates, and stops once it reaches older plays.
  • Big speed-up on large libraries and fewer Plex API calls after the first run.

• Web UI network usage reduced

  • The Sync status screen now prefers live updates and uses polling only as a fallback.
  • The Pairs list refresh is now event-driven (updates when something changes), with a slow safety refresh.
  • Scheduler banner updates are now throttled to prevent bursty refresh storms from focus/tab events.
  • “Currently watching” UI updates are de-duplicated

• Pair-scoped tombstones

  • Tombstones are now pair-scoped and stored under .cw_state, preventing “delete memory” from one provider pair blocking another.
  • Fixes cases where shows (and full seasons) could stay stuck even after a reset.

CrossWatch - v0.7.1

🔧 Fixes & Improvements

• Big performance fix

  • Fixed an issue that would spam CrossWatch with background requests, causing huge lag.
    - Thanks to @jabrown93 for opening the bug report and debugging.

• AniList linking

  • Improved the AniList login/link flow so it doesn’t keep “refreshing” in the background.

CrossWatch - v0.7.0

This release has many many many changes and big changes. Really big!.....

• Existing users: you’ll see a migration window. It wipes the old cache. After upgrading and migrating, do a hard cache refresh in your browser (CTR-F5)
• New users: you'll get a welcome message that opens op the settings page for you.

The orchestrator got a serious overhaul, which means bugs are more likely. So watch your step and report bugs!
It’ll take some iterations/versions to get things fine-tuned, but this major change was absolute necessary.
Analyzer and Editor still aren’t perfect, but they’re functional enough to get the job done....

IMPORTANT:
i've also fixed a real murder bug that was in v0.6.4. Going to Settings could kick off an infinite /api/config request loop, basically freezing CrossWatch.

Orchestrator state vs Pair-scoped provider caches (what changed in v0.7.0)

CrossWatch now clearly separates global orchestration state from pair-specific provider caches.
This means that the old provider caches are useless and needs to be recreated.

Global

• Baselines & drop-guard remain global per provider and feature.
  • Used for sanity checksand delta safety.
• Manual blocks / allow-lists remain global.
  • If you block an item via the Editor state.json, it’s filtered out of planning across all pairs where that provider and feature applies.
  • If you block an item via the Editor Pair cache, it’s filtered out of planning for that specific pair only.

Pair-scoped (new provider-side caches/shadows)

• Providers now store watermarks, snapshots and write-through shadows per pair scope.

This means:

• Multiple pairs can run without overwriting each other’s cached snapshots/watermarks.
• Providers can safely reuse cached “present” indexes (when activities timestamps match) without risking cross-pair contamination.
• Less API traffic because “unchanged” states can reuse pair-local shadows instead of re-fetching full lists.

Practical impact

• Reliability improves in multi-pair setups: pairs no longer “move the clock” for each other.
• State editing still works: blocking items in the Editor still affects planning (global policy),
  while pair-scoped files only affect provider caching behavior and incremental checkpoints.

🔧 Fixes & Improvements

FIX: Scrobble settings leak fix

• Navigating to Settings could previously trigger an infinite request loop to /api/config, effectively freezing CrossWatch.
  This is now fixed: the scrobbler is properly gated and no longer hammers /api/config.

Pair-specific watermarks (SIMKL, TRAKT, MDBList)

• SIMKLand MDBList now use pair-specific watermarks
  • Every sync pair keeps its own “last synced” timestamps per feature (watchlist / ratings / history).
  • This prevents one pair from “moving the clock forward” for another pair and accidentally skipping items.

MDBList

• New: Watch History support
  • MDBList can now sync your watch history in addition to watchlist and ratings.
  • i've also updated the /scripts/mdblist_cleanup.py with watch history support and fixed pagination issue with ratings.

Pair deletion cleanup

• New: Pair-scoped cache cleanup on delete
  • When a sync pair is deleted, CrossWatch now removes the corresponding pair-scoped provider cache/shadow files from .cw_state.
  • Prevents stale cache buildup and avoids old pair artifacts lingering after cleanup.

UI / Status Probes (API call reduction)

• Reduced provider API calls on browser refresh
• Some UI improvements in settings
• Scrobbe/Watcher UI fine-tuned.

Auth UI reliability

• Popup opening made consistent across providers
  • SIMKL now opens a blank tab immediately on click, then navigates to the real authorize URL once fetched (prevents popup blockers from killing the flow).
  • Trakt now shows a clear warning when the activation tab is blocked by the browser ("Popup blocked - allow popups and try again").
  • Plex now shows the same warning when the link tab is blocked, and closes the placeholder tab if PIN creation fails.
• Some consitancy tweaks across all providers

Watcher Scrobble sinks (Trakt - MDBList - SIMKL)

• Progress throttling to reduce API calls
  • Trakt, MDBList, and SIMKL scrobble sinks now support sending progress updates in steps (default: 5%*).
  • This turns “~one call per 1%” into “~one call per 5%”, which is a big drop in API traffic during long plays.
  • This value can be adjusted in Watcher/Advanced (1%-25%) where 1% is almost realtime (most API calls) and 25% acts more like webhooks (minimum API calls)

CrossWatch - v0.7.1

🔧 Fixes & Improvements

• Big performance fix

  • Fixed an issue that would spam CrossWatch with background requests, causing huge lag.
    - Thanks to @jabrown93 for opening the bug report and debugging.

• AniList linking

  • Improved the AniList login/link flow so it doesn’t keep “refreshing” in the background.

CrossWatch - v0.7.0

This release has many many many changes and big changes. Really big!.....

• Existing users: you’ll see a migration window. It wipes the old cache. After upgrading and migrating, do a hard cache refresh in your browser (CTR-F5)
• New users: you'll get a welcome message that opens op the settings page for you.

The orchestrator got a serious overhaul, which means bugs are more likely. So watch your step and report bugs!
It’ll take some iterations/versions to get things fine-tuned, but this major change was absolute necessary.
Analyzer and Editor still aren’t perfect, but they’re functional enough to get the job done....

IMPORTANT:
i've also fixed a real murder bug that was in v0.6.4. Going to Settings could kick off an infinite /api/config request loop, basically freezing CrossWatch.

Orchestrator state vs Pair-scoped provider caches (what changed in v0.7.0)

CrossWatch now clearly separates global orchestration state from pair-specific provider caches.
This means that the old provider caches are useless and needs to be recreated.

Global

• Baselines & drop-guard remain global per provider and feature.
  • Used for sanity checksand delta safety.
• Manual blocks / allow-lists remain global.
  • If you block an item via the Editor state.json, it’s filtered out of planning across all pairs where that provider and feature applies.
  • If you block an item via the Editor Pair cache, it’s filtered out of planning for that specific pair only.

Pair-scoped (new provider-side caches/shadows)

• Providers now store watermarks, snapshots and write-through shadows per pair scope.

This means:

• Multiple pairs can run without overwriting each other’s cached snapshots/watermarks.
• Providers can safely reuse cached “present” indexes (when activities timestamps match) without risking cross-pair contamination.
• Less API traffic because “unchanged” states can reuse pair-local shadows instead of re-fetching full lists.

Practical impact

• Reliability improves in multi-pair setups: pairs no longer “move the clock” for each other.
• State editing still works: blocking items in the Editor still affects planning (global policy),
  while pair-scoped files only affect provider caching behavior and incremental checkpoints.

🔧 Fixes & Improvements

FIX: Scrobble settings leak fix

• Navigating to Settings could previously trigger an infinite request loop to /api/config, effectively freezing CrossWatch.
  This is now fixed: the scrobbler is properly gated and no longer hammers /api/config.

Pair-specific watermarks (SIMKL, TRAKT, MDBList)

• SIMKLand MDBList now use pair-specific watermarks
  • Every sync pair keeps its own “last synced” timestamps per feature (watchlist / ratings / history).
  • This prevents one pair from “moving the clock forward” for another pair and accidentally skipping items.

MDBList

• New: Watch History support
  • MDBList can now sync your watch history in addition to watchlist and ratings.
  • i've also updated the /scripts/mdblist_cleanup.py with watch history support and fixed pagination issue with ratings.

Pair deletion cleanup

• New: Pair-scoped cache cleanup on delete
  • When a sync pair is deleted, CrossWatch now removes the corresponding pair-scoped provider cache/shadow files from .cw_state.
  • Prevents stale cache buildup and avoids old pair artifacts lingering after cleanup.

UI / Status Probes (API call reduction)

• Reduced provider API calls on browser refresh
• Some UI improvements in settings
• Scrobbe/Watcher UI fine-tuned.

Auth UI reliability

• Popup opening made consistent across providers
  • SIMKL now opens a blank tab immediately on click, then navigates to the real authorize URL once fetched (prevents popup blockers from killing the flow).
  • Trakt now shows a clear warning when the activation tab is blocked by the browser ("Popup blocked - allow popups and try again").
  • Plex now shows the same warning when the link tab is blocked, and closes the placeholder tab if PIN creation fails.
• Some consitancy tweaks across all providers

Watcher Scrobble sinks (Trakt - MDBList - SIMKL)

• Progress throttling to reduce API calls
  • Trakt, MDBList, and SIMKL scrobble sinks now support sending progress updates in steps (default: 5%*).
  • This turns “~one call per 1%” into “~one call per 5%”, which is a big drop in API traffic during long plays.
  • This value can be adjusted in Watcher/Advanced (1%-25%) where 1% is almost realtime (most API calls) and 25% acts more like webhooks (minimum API calls)

CrossWatch - v0.7.0

This release has many many many changes and big changes. Really big!.....

• Existing users: you’ll see a migration window. It wipes the old cache. After upgrading and migrating, do a hard cache refresh in your browser (CTR-F5)
• New users: you'll get a welcome message that opens op the settings page for you.

The orchestrator got a serious overhaul, which means bugs are more likely. So watch your step and report bugs!
It’ll take some iterations/versions to get things fine-tuned, but this major change was absolute necessary.
Analyzer and Editor still aren’t perfect, but they’re functional enough to get the job done....

IMPORTANT:
i've also fixed a real murder bug that was in v0.6.4. Going to Settings could kick off an infinite /api/config request loop, basically freezing CrossWatch.

Orchestrator state vs Pair-scoped provider caches (what changed in v0.7.0)

CrossWatch now clearly separates global orchestration state from pair-specific provider caches.
This means that the old provider caches are useless and needs to be recreated.

Global

• Baselines & drop-guard remain global per provider and feature.
  • Used for sanity checksand delta safety.
• Manual blocks / allow-lists remain global.
  • If you block an item via the Editor state.json, it’s filtered out of planning across all pairs where that provider and feature applies.
  • If you block an item via the Editor Pair cache, it’s filtered out of planning for that specific pair only.

Pair-scoped (new provider-side caches/shadows)

• Providers now store watermarks, snapshots and write-through shadows per pair scope.

This means:

• Multiple pairs can run without overwriting each other’s cached snapshots/watermarks.
• Providers can safely reuse cached “present” indexes (when activities timestamps match) without risking cross-pair contamination.
• Less API traffic because “unchanged” states can reuse pair-local shadows instead of re-fetching full lists.

Practical impact

• Reliability improves in multi-pair setups: pairs no longer “move the clock” for each other.
• State editing still works: blocking items in the Editor still affects planning (global policy),
  while pair-scoped files only affect provider caching behavior and incremental checkpoints.

🔧 Fixes & Improvements

FIX: Scrobble settings leak fix

• Navigating to Settings could previously trigger an infinite request loop to /api/config, effectively freezing CrossWatch.
  This is now fixed: the scrobbler is properly gated and no longer hammers /api/config.

Pair-specific watermarks (SIMKL, TRAKT, MDBList)

• SIMKLand MDBList now use pair-specific watermarks
  • Every sync pair keeps its own “last synced” timestamps per feature (watchlist / ratings / history).
  • This prevents one pair from “moving the clock forward” for another pair and accidentally skipping items.

MDBList

• New: Watch History support
  • MDBList can now sync your watch history in addition to watchlist and ratings.
  • i've also updated the /scripts/mdblist_cleanup.py with watch history support and fixed pagination issue with ratings.

Pair deletion cleanup

• New: Pair-scoped cache cleanup on delete
  • When a sync pair is deleted, CrossWatch now removes the corresponding pair-scoped provider cache/shadow files from .cw_state.
  • Prevents stale cache buildup and avoids old pair artifacts lingering after cleanup.

UI / Status Probes (API call reduction)

• Reduced provider API calls on browser refresh
• Some UI improvements in settings
• Scrobbe/Watcher UI fine-tuned.

Auth UI reliability

• Popup opening made consistent across providers
  • SIMKL now opens a blank tab immediately on click, then navigates to the real authorize URL once fetched (prevents popup blockers from killing the flow).
  • Trakt now shows a clear warning when the activation tab is blocked by the browser ("Popup blocked - allow popups and try again").
  • Plex now shows the same warning when the link tab is blocked, and closes the placeholder tab if PIN creation fails.
• Some consitancy tweaks across all providers

Watcher Scrobble sinks (Trakt - MDBList - SIMKL)

• Progress throttling to reduce API calls
  • Trakt, MDBList, and SIMKL scrobble sinks now support sending progress updates in steps (default: 5%*).
  • This turns “~one call per 1%” into “~one call per 5%”, which is a big drop in API traffic during long plays.
  • This value can be adjusted in Watcher/Advanced (1%-25%) where 1% is almost realtime (most API calls) and 25% acts more like webhooks (minimum API calls)

CrossWatch - v0.6.4 (hotfix)

Oeps… we had a bug that prevented new users from enabling the Watcher in the UI. That’s fixed now.

• Fixed: Watcher enable/disable now reliably saves to your configuration
• Fixed: Watcher settings no longer revert to old values while you’re editing them.

CrossWatch - v0.6.3

Jellyfin officially joined the Watcher family. We also added a new tracker sink: MDBList.

That means Watcher can now scrobble from Jellyfin, Emby, and Plex to SIMKL, Trakt, and MDBList (any combination you want).
Plex Watcher also supports real-time rating sync to SIMKL, Trakt, and MDBList.

If you have never heard of MDBList, have a look,

I also made some UI changes again, so please do a hard refresh in your browser to clear the cache (Ctrl+F5).

[!NOTE]
As of v0.6.3, the legacy webhook setup is deprecated and no longer maintained or supported.
Use the Watcher instead. Watcher replaces webhooks and is the only recommended path going forward.
It is more reliable, easier to operate, and comes with more features.

If you are still on webhooks, expect no fixes and no support for webhook-related issues.
Please migrate to Watcher as soon as possible.

🔧 Fixes & Changes

• Changed: Improved the Watcher settings UI for smoother configuration.
• Changed: Standardized Watcher playback behavior across all providers (consistent start, pause, stop handling).
  • Stops below 85% are treated as pause to improve resume behavior.
  • High-progress pause events no longer incorrectly mark items as completed.
• New: Added API endpoint /api/logs/watcher to view all Watcher-related log events.
• New: Added a Live Event Viewer in the Watcher section.
• New: Added Watcher output to Main: View Details.

Migrate from Webhook to Watcher

1. Remove the webhook from Jellyfin, Emby, or Plex.
2. Restart your media server (do not skip this).
3. Disable webhook in CrossWatch.
4. Enable Watcher in CrossWatch, select your sinks (SIMKL, Trakt, MDBList or any mix), set your filters, and enable the autoboot slider.
5. Restart the CrossWatch container to make sure everything is applied cleanly.

For Emby and Jellyfin users: configure Trakt even if you do not use it.
The Emby/Jellyfin Watcher uses a Trakt fallback when episode IDs cannot be resolved.

CrossWatch - v0.6.2

Rather huge update; v0.6.2 shows some love for anime, despite the fact that I’m not exactly an anime expert.
Consider v0.6.2 the first step into the anime world, but expect many iterations and fine-tuning in upcoming releases.
In this release we introduce SIMKL that now has Anime support and a new provider called ANILIST.
Note that Anime support is considered experimental.

[!IMPORTANT]
CrossWatch will never be 100% optimized for anime as the main focus remains Movies and Shows.
Combining both worlds into one tool is… difficult. Most providers needs IMDB/TMDB keys but Anilist only understands MAL/ANILIST IDs.
As you can imagine, in a multi-provider aware tool like CrossWatch, this bring many ... many.....many challanges.
So don’t treat CrossWatch as an anime expert tool, see it as a Movies/Shows sync tool with some experimental anime support on the side.

When used in a pair (for example, SIMKL to AniList), CrossWatch will try to map each item to the correct IMDb ID so it stays compatible with other providers. If no mapping is possible, or if you import an AniList dataset into the Editor, the item may only have a MAL ID. Other providers can’t use MAL IDs, which can result in duplicates (multiple entries for the same title).

Read more here: mod_ANILIST

So regarding Anime… in a nutshell:

• Anime-compatible providers: SIMKL and a new provider AniList for Watchlist
• Default setups for Plex / Jellyfin don’t natively understand anime IDs (MAL / AniList), so CrossWatch does bridging and normalization.
  • Result: most things work, but exotic anime titles may still fail.
• Anime limitations:
  • CrossWatch uses TMDB for metadata, but TMDB’s anime coverage isn’t complete. Expect many missing titles and wrong/mismatched metadata for Anime titles in Watchlist preview and Watchlist section.
  • Anime works, but ID mapping isn’t guaranteed, and when it falls back to MAL-only IDs, other providers may not recognize the same title, causing duplicate entries
• It’s recommended to use separate pairs for Anime and pair-level library whitelisting to minimize non-anime items.
• Even SIMKL, which does support anime, often has titles wrong. So yeah… anime is a special kind of chaos.
  • i'm unable to provide any kind of user support with messages such as: 魔道祖师 has not been synced.... sorry. i just dont have the time for that.

What’s new

• SIMKL module now supports Anime (Plan to Watch).
• Added the new AniList provider for watchlist syncing.

Anime Support for SIMKL

• New: SIMKL anime lists are now supported (Plan to Watch).
• New: Anime items now keep and use anime-specific IDs (MAL / AniList / Kitsu / AniDB) where available, improving match accuracy.
• Improved: Better season/episode mapping for anime via SIMKL’s extended anime season data.

new provider: AniList

• Added AniList provider for anime watchlist sync.
• Cross-provider key strategy: items remain keyed by IMDb where available (to stay compatible with Plex/Emby/Jellyfin/SIMKL), while AniList still resolves and reads anime IDs (AniList/MAL) from ids.
• AniList will skip non-Anime items and the orchestrator will exclude them.
• AniList state persistence filters “ignored” non-anime matches to avoid polluting state.json and repeated re-resolve attempts.

🔧 Fixes & Changes

• Fixed: Metadata lookups no longer misclassify anime as movies (anime is treated as show-type internally for sync logic).
• Fixed: Anime ratings and watchlist items are no longer skipped when filters are enabled.
• Fixed: Plex watcher and webhook ratings “clear stars” (unrate) now sends a proper ratings remove/0.
• Changed: In insight overview we already had M for Movies, S for Shows and now also A for Anime
• Changed: Analyzed and Editor includes Anime types and AniList is added to the list.
• Improved: Unresolved-item reporting now shows better keys for anime items.

CrossWatch - v0.6.1

🔧 Fixes & Changes

• Fixed: Importing SIMKL History from the Editor no longer creates lots of “Unknown” entries (movies and episodes now import with proper IDs).
• Fixed: SIMKL History episode imports now keep real episode titles instead of falling back to generic S01E01 style names.
• Fixed: Plex watcher Live scrobble progress is now accurate even when multiple Plex users watch the same movie/show at the same time.
• Fixed: Plex webhook scrobble progress is now accurate even when multiple Plex users watch the same movie/show at the same time.
• Fixed: MDBList cleanup tool in /scripts/ - pagination now works reliably and stops correctly at the end.
• Fixed: MDBList episode ratings now store the real episode title in state.json
• Improved: SIMKL History imports are more reliable overall thanks to better handling of SIMKL’s nested data format (the Editor now reads what SIMKL actually sends).

CrossWatch - v0.6.0

Happy 2026. v0.6.0 is mainly about ratings: most provider modules were reworked to behave sanely in true two-way setups.
Big win: Plex ratings are now dramatically faster thanks to query changes (in some libraries, up to ~50×).

As with any feature release, it’s a good idea to run Maintenance to clean up your environment.
If you’re still using a config.json from older versions (< 0.5.x), you should think about rebuilding a fresh, clean config.json.
As with any feature release, expect a few bugs, don’t be surprised.

🔧 Fixes & Improvements

Orchestrator

• Two-way ratings: improved planning and execution for bidirectional ratings sync.
• Disabled pairs: disabled pairs no longer trigger snapshots (cleaner logs).

Ratings

• Plex: major query optimization (can be ~50× faster in some cases).
• Plex: improved ID resolving and lookups.
• Trakt: better season/episode ID resolving.
• SIMKL: better show/movie ID resolving.
• MDBList: fixed pagination behavior (no more “needs multiple sync runs to finish”).

Watcher & Webhooks

• Trakt sink: no more duplicate history entries
  • Fixed a rare legacy-config edge case causing two “finish” events for the same playback.
  • Improved duplicate-stop suppression for stop/resume/credit-skip edge cases.
• Plex ratings: fixed ratings processing in both Plex Webhook and Plex Watcher.
• Quick stops now actually stop
  • Fixed debounce issues where very short sessions could miss the final stop event.
  • Trakt and SIMKL scrobble state now ends cleanly even if you stop within a few seconds.
• Jellyfin webhook reliability
  • Stronger protection against double “finish” events.
  • More consistent stop handling during frequent progress updates.

Analyzer

• Pair-scope awareness: analyzer now respects per-pair feature scope (such as ratings.types: ["movies","shows"]).
• Out-of-scope summary: when everything is “All good”, the analyzer can still show what’s excluded by configuration
  (example: “X seasons / Y episodes not synced due to pair setup”), so you don’t go hunting ghosts.

Other

• SIMKL Watchlist: added some caching improvements.
• SIMKL History: episodes now include episode titles.
• Editor: UI tweaks - season and episode shown next to TV shows.

CrossWatch - v0.5.8

This release add ratings for Plex webhook/watcher and fixes a long-standing Plex annoyance: PIN-protected Plex Home users.
CrossWatch can now switch into the correct Plex user context (even when that user has a PIN).
NOTE: This is ONLY needed for the default enabled Marked Watched plex option (manual “Mark as Watched” actions in the Plex UI).

Ratings are now supported for Plex Webhooks and Plex Watcher. CrossWatch will forward your ratings to Trakt and/or SIMKL.

updated WIKI pages:
PLEX Module
Webhook
Watcher

✨ Highlights

• Ratings for Plex Webhook and Plex Watcher are now supported
  • You can now include ratings; enable it in Webhook options or Watcher options.
  • For Watcher, you need to add a webhook helper, so Plex Pass is required for this option to work.
• Plex Marked Watched enhancements
  • This option fetches items you manually marked as watched in Plex. Default: enabled.
  • Previously it only worked reliably for the Plex Owner; Home users (with or without PINs) were not handled correctly.

🔧 Fixes & Improvements

• Correct Plex user context
  • CrossWatch now attempts to switch to the configured Plex user before syncing user-specific data.
  • If the user is PIN-protected, the PIN is used during the switch.
  • If switching isn’t possible (wrong/missing PIN, not a Home user, etc.), CrossWatch falls back to the token user and logs why.
  • If CrossWatch cannot switch to the intended user, it disables marked watched to avoid syncing the wrong profile.
• Trakt ratings
  • Added retries and backoff, including Retry-After support.
  • Canonical keys for seasons/episodes: cache merge/remove now includes show_ids + season/episode identifiers.
  • Improved debug logging: status codes and short response bodies on failures.

I’d love to add ratings for Emby and Jellyfin, just like Plex. The problem is: I can’t find any UI option to set user-specific ratings in Emby/Jellyfin.
Maybe I’m just blind. I do see rating-related fields in their APIs, but I’m not seeing the equivalent in the UI. Since I’m not an Emby or Jellyfin user, I might be missing something.
If you know where user ratings live in the UI (or if I’m wrong about how it works), please drop a note in the discussion so I can take another look.

CrossWatch - v0.5.7

BEST WISHES FOR 2026
This release adds Scrobble Library Whitelisting for Plex, Emby, and Jellyfin.
You can now choose exactly which libraries are allowed to generate scrobbles (Simkl/Trakt, etc.).
Configure it under settings - authentication - Plex/Emby/Jellyfin - settings.. Look for the Kermit-the-Frog green dots, that’s Scrobble.
If the scrobble whitelist is empty, CrossWatch will scrobble everything (current behavior).

This applies to both Scrobble input paths (watchers and webhooks):

• Watchers (local polling/stream watchers)
• Webhooks (server push events)

READ the WIKI regarding whitelisting

✨ Highlights

• Scrobble Library Whitelisting (Plex / Emby / Jellyfin)
  • Empty whitelist = allow all (no filtering)
  • New S (Scrobble) column next to H (History) and R (Ratings) in provider settings
  • Emby/Jellyfin use “virtual” views, so CrossWatch resolves the correct View before applying the whitelist
  • Prevents scrobbles leaking from non-whitelisted libraries

CrossWatch - v0.5.6

This release adds a new provider: Tautulli.
Tautulli is a Plex monitoring and analytics tool and NOT a tracker or media server, so CrossWatch uses it only to import your existing Plex watch history

DO NOT pair Tautulli as a destination (or “sync into” anything). It’s not a tracker/media server and will generate garbage matches: wrong IDs, tons of false items, and a bad time. Use it as a source-only helper and NEVER as a direct sync target to Plex, Jellyfin, Trakt, SIMKL, or anything else. The only correct use case: Either import the Tautulli dataset directly into the Editor, or create a one-way sync pair from Tautulli to CrossWatch Tracker.

If this all doesn’t ring a bell, you probably don’t need Tautulli imports, it’s only for a specific group of long-time Plex users with lots of existing history in Tautulli.

READ the WIKI

✨ Highlights

• New provider: Tautulli (History Import only)
  • Import your historical watches from Tautulli into CrossWatch
  • Tautulli is source-only: it can’t be selected as a destination
  • When using Tautulli, sync is one-way only

CrossWatch - v0.5.5

This update focuses on making Plex to Trakt scrobbling (webhook mode) behave a litte bit better.
Plex fixed some webhook autoplay bugs where a new scrobble start was never sent.
The CW Plex webhook logic now matches Plex’s updated behavior, and the old quarantine/autoplay workaround has been removed.

🔧 Fixes & Improvements

• Plex Webhook (Plex to Trakt scrobble)
  • Removed the autoplay quarantine logic that was meant to detect autoplay episodes. Obsolute due to Plex bug fixes.
  • Scrobble state is now tied more strongly to the correct user and playback session, reducing mix-ups in multi-user setups.
  • Better handling of Plex progress weirdness (including the classic “pause at 100%”).
  • Smarter decisions on whether an event should be treated as pause or stop, keeping Trakt history cleaner.
  • Stronger fallback logic for resolving episode/show IDs when Plex metadata is incomplete, improving Trakt matching for TV episodes.

CrossWatch - v0.5.4

Another small but important update, and the last one of the year. Wishing you all a great time.

This one is again editor-focused. If you don’t see the changes, do a hard refresh / clear your browser cache (yes, again).
You can now populate state.json without setting up a sync pair first, a huge improvement.

Read all about the new import datasets function here

🔧 Fixes & Improvements

• Editor upgrades – Import datasets
  • Import your datasets from Plex, Trakt, etc. (Watchlist / History / Ratings) so you can edit/block items before running any sync.
• Changed: MetaAPI now uses an absolute path, improving compatibility with some reverse proxies.

CrossWatch - v0.5.3

A small update for improved editing. Please refresh/clean your browser cache if you dont see the changes in editor.

🔧 Fixes & Improvements

• Editor upgrades
  • Bulk selection (select page / multi-select) with bulk delete/restore.
  • Type filters (Movie / Show / Season / Episode) and a Blocked-only view (Current State).

CrossWatch - v0.5.2

Some small fixes.

🔧 Fixes & Changes

• Fallback GUID: works again (Plex only option). In 0.5.0 the index was cleaned before the fallback GUIDs were merged. Now fixed again. Note: use this as a one-time sync, then disable it.
• Plex changes: fallback has been removed so usernames and user IDs are honored again.

CrossWatch - v0.5.1

Some small updates and quality-of-life improvements. And one big update.
One long-standing irritation by me was that there was no simple way to say: “do not sync this movie, show, or episode”.
If a provider kept reporting it, CrossWatch would keep planning it. That ends now: you can block items per provider so they won’t be pushed out to targets.
Blocking happens at the highest level: the CW Orchestrator. This function is still experimental...

And like with all my updates: hit Save in Settings at least once, so any new/changed config variables get written into your config.json.

✨ Highlights

• Metadata localization (TMDB): descriptions can now show in your own language (when available)
  , Default is en-US
  , Change it in Settings -> Metadata providers -> TMDB -> Advanced

I've updated the WIKI Metadata with all possible localizatin codes here.

• Improved Editor: the editor now supports two different data sources
  • CW Tracker (the existing CW tracker editing and snapshots)
    -Current State (/config/state.json) with a Provider and Feature selector
    -In Current State, you can block items per provider so they won’t sync out to targets.
  • The trashbin button will block them, and if you want to unblock them just push the same trashbin button again.
  • Your Current State changes are saved separately (/config/state.manual.json) and will NOT be deleted automatically.

I've updated the WIKI Editor page here

🔧 Fixes & Changes

• Changed: absolute path is used for watchlist, to be compatible with some reverse proxies
• Changed: watcher sink adjustments apply immediately, no container restart needed
• Fixed: deleting an item in watchlist for CW TRacker, now actually deletes it
• Fixed: watchlist posters more often include titles on the cover

CrossWatch - v0.5.0

Welcome at version 0.5.0 as stated before this release is all about Refactors, file moves, and code restructuring.
Not glamorous, but it stops the codebase from evolving into a dumpster fire.
There are so many things improved, fixed, and changed that I honestly lost track.

⚠️ Important

Because of the larger code changes, I strongly recommend doing a full cleanup:

• Go to Settings → Maintenance
• Run Delete Everything / Clean Everything
• Then re-open CrossWatch so it rebuilds fresh state/caches
• Remove any pairs with Jellyfin that included ratings! and Create them again.
• Optional: remove you config.json to start clean.

This avoids stale tracker data, cached metadata, and old snapshots getting in the way of the refactor.

🔧 Fixes & Changes

• Jellyfin ratings sync is disabled.
  • I tried, but Jellyfin (and Emby) ratings behavior is… special.
  • It wasn’t working reliably anyway, so it’s off until it’s properly understood and implemented.
• UI improvement added: M: Movies S: Shows in insight
• Overal UI improvements smaller probes, css changes etc etc...
• Watchlist changes:
  • Removed the movie/show overlay when in list view.
  • Added background for the overlay (same principle as the Playing card)
• Provider changes:
  • SIMKL Improved shadowing (more reliable diffing + fewer “phantom repeats”).
  • TRAKT changes:
    • Improved ID resolving (fewer mismatches, fewer “unresolved” surprises).
    • CW now better supports Free accounts with better handling when Trakt limits are reached.
      • Console now shows: “Trakt account limit reached”
      • Trakt probe now reports:
        • free-tier and VIP limits (watchlist + collections)
        • last limit-related error (so you can actually see what happened)
        • Analyzer will tell you when limits has reached.
  • MDBList Ratings handling improved (fewer retries/loops).
  • Jellyfin and Emby Watchlist pagination fixed.
• Added three more provider shell tools in /scripts for MDBList / Trakt / SIMKL.
• Analyzer changes:
  • Improved detection logic.
  • Finds more issues and is better at pointing out why something didn’t sync.
• Help function: in pair configuration i've added some help icons with mouse-over information.

From 0.5.x onward I’ll continue with some refactoring for javascript and CSS

CrossWatch - v0.6.3

Jellyfin officially joined the Watcher family. We also added a new tracker sink: MDBList.

That means Watcher can now scrobble from Jellyfin, Emby, and Plex to SIMKL, Trakt, and MDBList (any combination you want).
Plex Watcher also supports real-time rating sync to SIMKL, Trakt, and MDBList.

If you have never heard of MDBList, have a look,

I also made some UI changes again, so please do a hard refresh in your browser to clear the cache (Ctrl+F5).

[!NOTE]
As of v0.6.3, the legacy webhook setup is deprecated and no longer maintained or supported.
Use the Watcher instead. Watcher replaces webhooks and is the only recommended path going forward.
It is more reliable, easier to operate, and comes with more features.

If you are still on webhooks, expect no fixes and no support for webhook-related issues.
Please migrate to Watcher as soon as possible.

🔧 Fixes & Changes

• Changed: Improved the Watcher settings UI for smoother configuration.
• Changed: Standardized Watcher playback behavior across all providers (consistent start, pause, stop handling).
  • Stops below 85% are treated as pause to improve resume behavior.
  • High-progress pause events no longer incorrectly mark items as completed.
• New: Added API endpoint /api/logs/watcher to view all Watcher-related log events.
• New: Added a Live Event Viewer in the Watcher section.
• New: Added Watcher output to Main: View Details.

Migrate from Webhook to Watcher

1. Remove the webhook from Jellyfin, Emby, or Plex.
2. Restart your media server (do not skip this).
3. Disable webhook in CrossWatch.
4. Enable Watcher in CrossWatch, select your sinks (SIMKL, Trakt, MDBList or any mix), set your filters, and enable the autoboot slider.
5. Restart the CrossWatch container to make sure everything is applied cleanly.

For Emby and Jellyfin users: configure Trakt even if you do not use it.
The Emby/Jellyfin Watcher uses a Trakt fallback when episode IDs cannot be resolved.

CrossWatch - v0.6.2

Rather huge update; v0.6.2 shows some love for anime, despite the fact that I’m not exactly an anime expert.
Consider v0.6.2 the first step into the anime world, but expect many iterations and fine-tuning in upcoming releases.
In this release we introduce SIMKL that now has Anime support and a new provider called ANILIST.
Note that Anime support is considered experimental.

[!IMPORTANT]
CrossWatch will never be 100% optimized for anime as the main focus remains Movies and Shows.
Combining both worlds into one tool is… difficult. Most providers needs IMDB/TMDB keys but Anilist only understands MAL/ANILIST IDs.
As you can imagine, in a multi-provider aware tool like CrossWatch, this bring many ... many.....many challanges.
So don’t treat CrossWatch as an anime expert tool, see it as a Movies/Shows sync tool with some experimental anime support on the side.

When used in a pair (for example, SIMKL to AniList), CrossWatch will try to map each item to the correct IMDb ID so it stays compatible with other providers. If no mapping is possible, or if you import an AniList dataset into the Editor, the item may only have a MAL ID. Other providers can’t use MAL IDs, which can result in duplicates (multiple entries for the same title).

Read more here: mod_ANILIST

So regarding Anime… in a nutshell:

• Anime-compatible providers: SIMKL and a new provider AniList for Watchlist
• Default setups for Plex / Jellyfin don’t natively understand anime IDs (MAL / AniList), so CrossWatch does bridging and normalization.
  • Result: most things work, but exotic anime titles may still fail.
• Anime limitations:
  • CrossWatch uses TMDB for metadata, but TMDB’s anime coverage isn’t complete. Expect many missing titles and wrong/mismatched metadata for Anime titles in Watchlist preview and Watchlist section.
  • Anime works, but ID mapping isn’t guaranteed, and when it falls back to MAL-only IDs, other providers may not recognize the same title, causing duplicate entries
• It’s recommended to use separate pairs for Anime and pair-level library whitelisting to minimize non-anime items.
• Even SIMKL, which does support anime, often has titles wrong. So yeah… anime is a special kind of chaos.
  • i'm unable to provide any kind of user support with messages such as: 魔道祖师 has not been synced.... sorry. i just dont have the time for that.

What’s new

• SIMKL module now supports Anime (Plan to Watch).
• Added the new AniList provider for watchlist syncing.

Anime Support for SIMKL

• New: SIMKL anime lists are now supported (Plan to Watch).
• New: Anime items now keep and use anime-specific IDs (MAL / AniList / Kitsu / AniDB) where available, improving match accuracy.
• Improved: Better season/episode mapping for anime via SIMKL’s extended anime season data.

new provider: AniList

• Added AniList provider for anime watchlist sync.
• Cross-provider key strategy: items remain keyed by IMDb where available (to stay compatible with Plex/Emby/Jellyfin/SIMKL), while AniList still resolves and reads anime IDs (AniList/MAL) from ids.
• AniList will skip non-Anime items and the orchestrator will exclude them.
• AniList state persistence filters “ignored” non-anime matches to avoid polluting state.json and repeated re-resolve attempts.

🔧 Fixes & Changes

• Fixed: Metadata lookups no longer misclassify anime as movies (anime is treated as show-type internally for sync logic).
• Fixed: Anime ratings and watchlist items are no longer skipped when filters are enabled.
• Fixed: Plex watcher and webhook ratings “clear stars” (unrate) now sends a proper ratings remove/0.
• Changed: In insight overview we already had M for Movies, S for Shows and now also A for Anime
• Changed: Analyzed and Editor includes Anime types and AniList is added to the list.
• Improved: Unresolved-item reporting now shows better keys for anime items.

CrossWatch - v0.6.1

🔧 Fixes & Changes

• Fixed: Importing SIMKL History from the Editor no longer creates lots of “Unknown” entries (movies and episodes now import with proper IDs).
• Fixed: SIMKL History episode imports now keep real episode titles instead of falling back to generic S01E01 style names.
• Fixed: Plex watcher Live scrobble progress is now accurate even when multiple Plex users watch the same movie/show at the same time.
• Fixed: Plex webhook scrobble progress is now accurate even when multiple Plex users watch the same movie/show at the same time.
• Fixed: MDBList cleanup tool in /scripts/ - pagination now works reliably and stops correctly at the end.
• Fixed: MDBList episode ratings now store the real episode title in state.json
• Improved: SIMKL History imports are more reliable overall thanks to better handling of SIMKL’s nested data format (the Editor now reads what SIMKL actually sends).

CrossWatch - v0.6.0

Happy 2026. v0.6.0 is mainly about ratings: most provider modules were reworked to behave sanely in true two-way setups.
Big win: Plex ratings are now dramatically faster thanks to query changes (in some libraries, up to ~50×).

As with any feature release, it’s a good idea to run Maintenance to clean up your environment.
If you’re still using a config.json from older versions (< 0.5.x), you should think about rebuilding a fresh, clean config.json.
As with any feature release, expect a few bugs, don’t be surprised.

🔧 Fixes & Improvements

Orchestrator

• Two-way ratings: improved planning and execution for bidirectional ratings sync.
• Disabled pairs: disabled pairs no longer trigger snapshots (cleaner logs).

Ratings

• Plex: major query optimization (can be ~50× faster in some cases).
• Plex: improved ID resolving and lookups.
• Trakt: better season/episode ID resolving.
• SIMKL: better show/movie ID resolving.
• MDBList: fixed pagination behavior (no more “needs multiple sync runs to finish”).

Watcher & Webhooks

• Trakt sink: no more duplicate history entries
  • Fixed a rare legacy-config edge case causing two “finish” events for the same playback.
  • Improved duplicate-stop suppression for stop/resume/credit-skip edge cases.
• Plex ratings: fixed ratings processing in both Plex Webhook and Plex Watcher.
• Quick stops now actually stop
  • Fixed debounce issues where very short sessions could miss the final stop event.
  • Trakt and SIMKL scrobble state now ends cleanly even if you stop within a few seconds.
• Jellyfin webhook reliability
  • Stronger protection against double “finish” events.
  • More consistent stop handling during frequent progress updates.

Analyzer

• Pair-scope awareness: analyzer now respects per-pair feature scope (such as ratings.types: ["movies","shows"]).
• Out-of-scope summary: when everything is “All good”, the analyzer can still show what’s excluded by configuration
  (example: “X seasons / Y episodes not synced due to pair setup”), so you don’t go hunting ghosts.

Other

• SIMKL Watchlist: added some caching improvements.
• SIMKL History: episodes now include episode titles.
• Editor: UI tweaks - season and episode shown next to TV shows.

CrossWatch - v0.5.8

This release add ratings for Plex webhook/watcher and fixes a long-standing Plex annoyance: PIN-protected Plex Home users.
CrossWatch can now switch into the correct Plex user context (even when that user has a PIN).
NOTE: This is ONLY needed for the default enabled Marked Watched plex option (manual “Mark as Watched” actions in the Plex UI).

Ratings are now supported for Plex Webhooks and Plex Watcher. CrossWatch will forward your ratings to Trakt and/or SIMKL.

updated WIKI pages:
PLEX Module
Webhook
Watcher

✨ Highlights

• Ratings for Plex Webhook and Plex Watcher are now supported
  • You can now include ratings; enable it in Webhook options or Watcher options.
  • For Watcher, you need to add a webhook helper, so Plex Pass is required for this option to work.
• Plex Marked Watched enhancements
  • This option fetches items you manually marked as watched in Plex. Default: enabled.
  • Previously it only worked reliably for the Plex Owner; Home users (with or without PINs) were not handled correctly.

🔧 Fixes & Improvements

• Correct Plex user context
  • CrossWatch now attempts to switch to the configured Plex user before syncing user-specific data.
  • If the user is PIN-protected, the PIN is used during the switch.
  • If switching isn’t possible (wrong/missing PIN, not a Home user, etc.), CrossWatch falls back to the token user and logs why.
  • If CrossWatch cannot switch to the intended user, it disables marked watched to avoid syncing the wrong profile.
• Trakt ratings
  • Added retries and backoff, including Retry-After support.
  • Canonical keys for seasons/episodes: cache merge/remove now includes show_ids + season/episode identifiers.
  • Improved debug logging: status codes and short response bodies on failures.

I’d love to add ratings for Emby and Jellyfin, just like Plex. The problem is: I can’t find any UI option to set user-specific ratings in Emby/Jellyfin.
Maybe I’m just blind. I do see rating-related fields in their APIs, but I’m not seeing the equivalent in the UI. Since I’m not an Emby or Jellyfin user, I might be missing something.
If you know where user ratings live in the UI (or if I’m wrong about how it works), please drop a note in the discussion so I can take another look.

CrossWatch - v0.5.7

BEST WISHES FOR 2026
This release adds Scrobble Library Whitelisting for Plex, Emby, and Jellyfin.
You can now choose exactly which libraries are allowed to generate scrobbles (Simkl/Trakt, etc.).
Configure it under settings - authentication - Plex/Emby/Jellyfin - settings.. Look for the Kermit-the-Frog green dots, that’s Scrobble.
If the scrobble whitelist is empty, CrossWatch will scrobble everything (current behavior).

This applies to both Scrobble input paths (watchers and webhooks):

• Watchers (local polling/stream watchers)
• Webhooks (server push events)

READ the WIKI regarding whitelisting

✨ Highlights

• Scrobble Library Whitelisting (Plex / Emby / Jellyfin)
  • Empty whitelist = allow all (no filtering)
  • New S (Scrobble) column next to H (History) and R (Ratings) in provider settings
  • Emby/Jellyfin use “virtual” views, so CrossWatch resolves the correct View before applying the whitelist
  • Prevents scrobbles leaking from non-whitelisted libraries

CrossWatch - v0.5.6

This release adds a new provider: Tautulli.
Tautulli is a Plex monitoring and analytics tool and NOT a tracker or media server, so CrossWatch uses it only to import your existing Plex watch history

DO NOT pair Tautulli as a destination (or “sync into” anything). It’s not a tracker/media server and will generate garbage matches: wrong IDs, tons of false items, and a bad time. Use it as a source-only helper and NEVER as a direct sync target to Plex, Jellyfin, Trakt, SIMKL, or anything else. The only correct use case: Either import the Tautulli dataset directly into the Editor, or create a one-way sync pair from Tautulli to CrossWatch Tracker.

If this all doesn’t ring a bell, you probably don’t need Tautulli imports, it’s only for a specific group of long-time Plex users with lots of existing history in Tautulli.

READ the WIKI

✨ Highlights

• New provider: Tautulli (History Import only)
  • Import your historical watches from Tautulli into CrossWatch
  • Tautulli is source-only: it can’t be selected as a destination
  • When using Tautulli, sync is one-way only

CrossWatch - v0.5.5

This update focuses on making Plex to Trakt scrobbling (webhook mode) behave a litte bit better.
Plex fixed some webhook autoplay bugs where a new scrobble start was never sent.
The CW Plex webhook logic now matches Plex’s updated behavior, and the old quarantine/autoplay workaround has been removed.

🔧 Fixes & Improvements

• Plex Webhook (Plex to Trakt scrobble)
  • Removed the autoplay quarantine logic that was meant to detect autoplay episodes. Obsolute due to Plex bug fixes.
  • Scrobble state is now tied more strongly to the correct user and playback session, reducing mix-ups in multi-user setups.
  • Better handling of Plex progress weirdness (including the classic “pause at 100%”).
  • Smarter decisions on whether an event should be treated as pause or stop, keeping Trakt history cleaner.
  • Stronger fallback logic for resolving episode/show IDs when Plex metadata is incomplete, improving Trakt matching for TV episodes.

CrossWatch - v0.5.4

Another small but important update, and the last one of the year. Wishing you all a great time.

This one is again editor-focused. If you don’t see the changes, do a hard refresh / clear your browser cache (yes, again).
You can now populate state.json without setting up a sync pair first, a huge improvement.

Read all about the new import datasets function here

🔧 Fixes & Improvements

• Editor upgrades – Import datasets
  • Import your datasets from Plex, Trakt, etc. (Watchlist / History / Ratings) so you can edit/block items before running any sync.
• Changed: MetaAPI now uses an absolute path, improving compatibility with some reverse proxies.

CrossWatch - v0.5.3

A small update for improved editing. Please refresh/clean your browser cache if you dont see the changes in editor.

🔧 Fixes & Improvements

• Editor upgrades
  • Bulk selection (select page / multi-select) with bulk delete/restore.
  • Type filters (Movie / Show / Season / Episode) and a Blocked-only view (Current State).

CrossWatch - v0.5.2

Some small fixes.

🔧 Fixes & Changes

• Fallback GUID: works again (Plex only option). In 0.5.0 the index was cleaned before the fallback GUIDs were merged. Now fixed again. Note: use this as a one-time sync, then disable it.
• Plex changes: fallback has been removed so usernames and user IDs are honored again.

CrossWatch - v0.5.1

Some small updates and quality-of-life improvements. And one big update.
One long-standing irritation by me was that there was no simple way to say: “do not sync this movie, show, or episode”.
If a provider kept reporting it, CrossWatch would keep planning it. That ends now: you can block items per provider so they won’t be pushed out to targets.
Blocking happens at the highest level: the CW Orchestrator. This function is still experimental...

And like with all my updates: hit Save in Settings at least once, so any new/changed config variables get written into your config.json.

✨ Highlights

• Metadata localization (TMDB): descriptions can now show in your own language (when available)
  , Default is en-US
  , Change it in Settings -> Metadata providers -> TMDB -> Advanced

I've updated the WIKI Metadata with all possible localizatin codes here.

• Improved Editor: the editor now supports two different data sources
  • CW Tracker (the existing CW tracker editing and snapshots)
    -Current State (/config/state.json) with a Provider and Feature selector
    -In Current State, you can block items per provider so they won’t sync out to targets.
  • The trashbin button will block them, and if you want to unblock them just push the same trashbin button again.
  • Your Current State changes are saved separately (/config/state.manual.json) and will NOT be deleted automatically.

I've updated the WIKI Editor page here

🔧 Fixes & Changes

• Changed: absolute path is used for watchlist, to be compatible with some reverse proxies
• Changed: watcher sink adjustments apply immediately, no container restart needed
• Fixed: deleting an item in watchlist for CW TRacker, now actually deletes it
• Fixed: watchlist posters more often include titles on the cover

CrossWatch - v0.5.0

Welcome at version 0.5.0 as stated before this release is all about Refactors, file moves, and code restructuring.
Not glamorous, but it stops the codebase from evolving into a dumpster fire.
There are so many things improved, fixed, and changed that I honestly lost track.

⚠️ Important

Because of the larger code changes, I strongly recommend doing a full cleanup:

• Go to Settings → Maintenance
• Run Delete Everything / Clean Everything
• Then re-open CrossWatch so it rebuilds fresh state/caches
• Remove any pairs with Jellyfin that included ratings! and Create them again.
• Optional: remove you config.json to start clean.

This avoids stale tracker data, cached metadata, and old snapshots getting in the way of the refactor.

🔧 Fixes & Changes

• Jellyfin ratings sync is disabled.
  • I tried, but Jellyfin (and Emby) ratings behavior is… special.
  • It wasn’t working reliably anyway, so it’s off until it’s properly understood and implemented.
• UI improvement added: M: Movies S: Shows in insight
• Overal UI improvements smaller probes, css changes etc etc...
• Watchlist changes:
  • Removed the movie/show overlay when in list view.
  • Added background for the overlay (same principle as the Playing card)
• Provider changes:
  • SIMKL Improved shadowing (more reliable diffing + fewer “phantom repeats”).
  • TRAKT changes:
    • Improved ID resolving (fewer mismatches, fewer “unresolved” surprises).
    • CW now better supports Free accounts with better handling when Trakt limits are reached.
      • Console now shows: “Trakt account limit reached”
      • Trakt probe now reports:
        • free-tier and VIP limits (watchlist + collections)
        • last limit-related error (so you can actually see what happened)
        • Analyzer will tell you when limits has reached.
  • MDBList Ratings handling improved (fewer retries/loops).
  • Jellyfin and Emby Watchlist pagination fixed.
• Added three more provider shell tools in /scripts for MDBList / Trakt / SIMKL.
• Analyzer changes:
  • Improved detection logic.
  • Finds more issues and is better at pointing out why something didn’t sync.
• Help function: in pair configuration i've added some help icons with mouse-over information.

From 0.5.x onward I’ll continue with some refactoring for javascript and CSS

CrossWatch - v0.6.2

Rather huge update; v0.6.2 shows some love for anime, despite the fact that I’m not exactly an anime expert.
Consider v0.6.2 the first step into the anime world, but expect many iterations and fine-tuning in upcoming releases.
In this release we introduce SIMKL that now has Anime support and a new provider called ANILIST.
Note that Anime support is considered experimental.

[!IMPORTANT]
CrossWatch will never be 100% optimized for anime as the main focus remains Movies and Shows.
Combining both worlds into one tool is… difficult. Most providers needs IMDB/TMDB keys but Anilist only understands MAL/ANILIST IDs.
As you can imagine, in a multi-provider aware tool like CrossWatch, this bring many ... many.....many challanges.
So don’t treat CrossWatch as an anime expert tool, see it as a Movies/Shows sync tool with some experimental anime support on the side.

When used in a pair (for example, SIMKL to AniList), CrossWatch will try to map each item to the correct IMDb ID so it stays compatible with other providers. If no mapping is possible, or if you import an AniList dataset into the Editor, the item may only have a MAL ID. Other providers can’t use MAL IDs, which can result in duplicates (multiple entries for the same title).

Read more here: mod_ANILIST

So regarding Anime… in a nutshell:

• Anime-compatible providers: SIMKL and a new provider AniList for Watchlist
• Default setups for Plex / Jellyfin don’t natively understand anime IDs (MAL / AniList), so CrossWatch does bridging and normalization.
  • Result: most things work, but exotic anime titles may still fail.
• Anime limitations:
  • CrossWatch uses TMDB for metadata, but TMDB’s anime coverage isn’t complete. Expect many missing titles and wrong/mismatched metadata for Anime titles in Watchlist preview and Watchlist section.
  • Anime works, but ID mapping isn’t guaranteed, and when it falls back to MAL-only IDs, other providers may not recognize the same title, causing duplicate entries
• It’s recommended to use separate pairs for Anime and pair-level library whitelisting to minimize non-anime items.
• Even SIMKL, which does support anime, often has titles wrong. So yeah… anime is a special kind of chaos.
  • i'm unable to provide any kind of user support with messages such as: 魔道祖师 has not been synced.... sorry. i just dont have the time for that.

What’s new

• SIMKL module now supports Anime (Plan to Watch).
• Added the new AniList provider for watchlist syncing.

Anime Support for SIMKL

• New: SIMKL anime lists are now supported (Plan to Watch).
• New: Anime items now keep and use anime-specific IDs (MAL / AniList / Kitsu / AniDB) where available, improving match accuracy.
• Improved: Better season/episode mapping for anime via SIMKL’s extended anime season data.

new provider: AniList

• Added AniList provider for anime watchlist sync.
• Cross-provider key strategy: items remain keyed by IMDb where available (to stay compatible with Plex/Emby/Jellyfin/SIMKL), while AniList still resolves and reads anime IDs (AniList/MAL) from ids.
• AniList will skip non-Anime items and the orchestrator will exclude them.
• AniList state persistence filters “ignored” non-anime matches to avoid polluting state.json and repeated re-resolve attempts.

🔧 Fixes & Changes

• Fixed: Metadata lookups no longer misclassify anime as movies (anime is treated as show-type internally for sync logic).
• Fixed: Anime ratings and watchlist items are no longer skipped when filters are enabled.
• Fixed: Plex watcher and webhook ratings “clear stars” (unrate) now sends a proper ratings remove/0.
• Changed: In insight overview we already had M for Movies, S for Shows and now also A for Anime
• Changed: Analyzed and Editor includes Anime types and AniList is added to the list.
• Improved: Unresolved-item reporting now shows better keys for anime items.

CrossWatch - v0.6.1

🔧 Fixes & Changes

• Fixed: Importing SIMKL History from the Editor no longer creates lots of “Unknown” entries (movies and episodes now import with proper IDs).
• Fixed: SIMKL History episode imports now keep real episode titles instead of falling back to generic S01E01 style names.
• Fixed: Plex watcher Live scrobble progress is now accurate even when multiple Plex users watch the same movie/show at the same time.
• Fixed: Plex webhook scrobble progress is now accurate even when multiple Plex users watch the same movie/show at the same time.
• Fixed: MDBList cleanup tool in /scripts/ - pagination now works reliably and stops correctly at the end.
• Fixed: MDBList episode ratings now store the real episode title in state.json
• Improved: SIMKL History imports are more reliable overall thanks to better handling of SIMKL’s nested data format (the Editor now reads what SIMKL actually sends).

CrossWatch - v0.6.0

Happy 2026. v0.6.0 is mainly about ratings: most provider modules were reworked to behave sanely in true two-way setups.
Big win: Plex ratings are now dramatically faster thanks to query changes (in some libraries, up to ~50×).

As with any feature release, it’s a good idea to run Maintenance to clean up your environment.
If you’re still using a config.json from older versions (< 0.5.x), you should think about rebuilding a fresh, clean config.json.
As with any feature release, expect a few bugs, don’t be surprised.

🔧 Fixes & Improvements

Orchestrator

• Two-way ratings: improved planning and execution for bidirectional ratings sync.
• Disabled pairs: disabled pairs no longer trigger snapshots (cleaner logs).

Ratings

• Plex: major query optimization (can be ~50× faster in some cases).
• Plex: improved ID resolving and lookups.
• Trakt: better season/episode ID resolving.
• SIMKL: better show/movie ID resolving.
• MDBList: fixed pagination behavior (no more “needs multiple sync runs to finish”).

Watcher & Webhooks

• Trakt sink: no more duplicate history entries
  • Fixed a rare legacy-config edge case causing two “finish” events for the same playback.
  • Improved duplicate-stop suppression for stop/resume/credit-skip edge cases.
• Plex ratings: fixed ratings processing in both Plex Webhook and Plex Watcher.
• Quick stops now actually stop
  • Fixed debounce issues where very short sessions could miss the final stop event.
  • Trakt and SIMKL scrobble state now ends cleanly even if you stop within a few seconds.
• Jellyfin webhook reliability
  • Stronger protection against double “finish” events.
  • More consistent stop handling during frequent progress updates.

Analyzer

• Pair-scope awareness: analyzer now respects per-pair feature scope (such as ratings.types: ["movies","shows"]).
• Out-of-scope summary: when everything is “All good”, the analyzer can still show what’s excluded by configuration
  (example: “X seasons / Y episodes not synced due to pair setup”), so you don’t go hunting ghosts.

Other

• SIMKL Watchlist: added some caching improvements.
• SIMKL History: episodes now include episode titles.
• Editor: UI tweaks - season and episode shown next to TV shows.

CrossWatch - v0.5.8

This release add ratings for Plex webhook/watcher and fixes a long-standing Plex annoyance: PIN-protected Plex Home users.
CrossWatch can now switch into the correct Plex user context (even when that user has a PIN).
NOTE: This is ONLY needed for the default enabled Marked Watched plex option (manual “Mark as Watched” actions in the Plex UI).

Ratings are now supported for Plex Webhooks and Plex Watcher. CrossWatch will forward your ratings to Trakt and/or SIMKL.

updated WIKI pages:
PLEX Module
Webhook
Watcher

✨ Highlights

• Ratings for Plex Webhook and Plex Watcher are now supported
  • You can now include ratings; enable it in Webhook options or Watcher options.
  • For Watcher, you need to add a webhook helper, so Plex Pass is required for this option to work.
• Plex Marked Watched enhancements
  • This option fetches items you manually marked as watched in Plex. Default: enabled.
  • Previously it only worked reliably for the Plex Owner; Home users (with or without PINs) were not handled correctly.

🔧 Fixes & Improvements

• Correct Plex user context
  • CrossWatch now attempts to switch to the configured Plex user before syncing user-specific data.
  • If the user is PIN-protected, the PIN is used during the switch.
  • If switching isn’t possible (wrong/missing PIN, not a Home user, etc.), CrossWatch falls back to the token user and logs why.
  • If CrossWatch cannot switch to the intended user, it disables marked watched to avoid syncing the wrong profile.
• Trakt ratings
  • Added retries and backoff, including Retry-After support.
  • Canonical keys for seasons/episodes: cache merge/remove now includes show_ids + season/episode identifiers.
  • Improved debug logging: status codes and short response bodies on failures.

I’d love to add ratings for Emby and Jellyfin, just like Plex. The problem is: I can’t find any UI option to set user-specific ratings in Emby/Jellyfin.
Maybe I’m just blind. I do see rating-related fields in their APIs, but I’m not seeing the equivalent in the UI. Since I’m not an Emby or Jellyfin user, I might be missing something.
If you know where user ratings live in the UI (or if I’m wrong about how it works), please drop a note in the discussion so I can take another look.

CrossWatch - v0.5.7

BEST WISHES FOR 2026
This release adds Scrobble Library Whitelisting for Plex, Emby, and Jellyfin.
You can now choose exactly which libraries are allowed to generate scrobbles (Simkl/Trakt, etc.).
Configure it under settings - authentication - Plex/Emby/Jellyfin - settings.. Look for the Kermit-the-Frog green dots, that’s Scrobble.
If the scrobble whitelist is empty, CrossWatch will scrobble everything (current behavior).

This applies to both Scrobble input paths (watchers and webhooks):

• Watchers (local polling/stream watchers)
• Webhooks (server push events)

READ the WIKI regarding whitelisting

✨ Highlights

• Scrobble Library Whitelisting (Plex / Emby / Jellyfin)
  • Empty whitelist = allow all (no filtering)
  • New S (Scrobble) column next to H (History) and R (Ratings) in provider settings
  • Emby/Jellyfin use “virtual” views, so CrossWatch resolves the correct View before applying the whitelist
  • Prevents scrobbles leaking from non-whitelisted libraries

CrossWatch - v0.5.6

This release adds a new provider: Tautulli.
Tautulli is a Plex monitoring and analytics tool and NOT a tracker or media server, so CrossWatch uses it only to import your existing Plex watch history

DO NOT pair Tautulli as a destination (or “sync into” anything). It’s not a tracker/media server and will generate garbage matches: wrong IDs, tons of false items, and a bad time. Use it as a source-only helper and NEVER as a direct sync target to Plex, Jellyfin, Trakt, SIMKL, or anything else. The only correct use case: Either import the Tautulli dataset directly into the Editor, or create a one-way sync pair from Tautulli to CrossWatch Tracker.

If this all doesn’t ring a bell, you probably don’t need Tautulli imports, it’s only for a specific group of long-time Plex users with lots of existing history in Tautulli.

READ the WIKI

✨ Highlights

• New provider: Tautulli (History Import only)
  • Import your historical watches from Tautulli into CrossWatch
  • Tautulli is source-only: it can’t be selected as a destination
  • When using Tautulli, sync is one-way only

CrossWatch - v0.5.5

This update focuses on making Plex to Trakt scrobbling (webhook mode) behave a litte bit better.
Plex fixed some webhook autoplay bugs where a new scrobble start was never sent.
The CW Plex webhook logic now matches Plex’s updated behavior, and the old quarantine/autoplay workaround has been removed.

🔧 Fixes & Improvements

• Plex Webhook (Plex to Trakt scrobble)
  • Removed the autoplay quarantine logic that was meant to detect autoplay episodes. Obsolute due to Plex bug fixes.
  • Scrobble state is now tied more strongly to the correct user and playback session, reducing mix-ups in multi-user setups.
  • Better handling of Plex progress weirdness (including the classic “pause at 100%”).
  • Smarter decisions on whether an event should be treated as pause or stop, keeping Trakt history cleaner.
  • Stronger fallback logic for resolving episode/show IDs when Plex metadata is incomplete, improving Trakt matching for TV episodes.

CrossWatch - v0.5.4

Another small but important update, and the last one of the year. Wishing you all a great time.

This one is again editor-focused. If you don’t see the changes, do a hard refresh / clear your browser cache (yes, again).
You can now populate state.json without setting up a sync pair first, a huge improvement.

Read all about the new import datasets function here

🔧 Fixes & Improvements

• Editor upgrades – Import datasets
  • Import your datasets from Plex, Trakt, etc. (Watchlist / History / Ratings) so you can edit/block items before running any sync.
• Changed: MetaAPI now uses an absolute path, improving compatibility with some reverse proxies.

CrossWatch - v0.5.3

A small update for improved editing. Please refresh/clean your browser cache if you dont see the changes in editor.

🔧 Fixes & Improvements

• Editor upgrades
  • Bulk selection (select page / multi-select) with bulk delete/restore.
  • Type filters (Movie / Show / Season / Episode) and a Blocked-only view (Current State).

CrossWatch - v0.5.2

Some small fixes.

🔧 Fixes & Changes

• Fallback GUID: works again (Plex only option). In 0.5.0 the index was cleaned before the fallback GUIDs were merged. Now fixed again. Note: use this as a one-time sync, then disable it.
• Plex changes: fallback has been removed so usernames and user IDs are honored again.

CrossWatch - v0.5.1

Some small updates and quality-of-life improvements. And one big update.
One long-standing irritation by me was that there was no simple way to say: “do not sync this movie, show, or episode”.
If a provider kept reporting it, CrossWatch would keep planning it. That ends now: you can block items per provider so they won’t be pushed out to targets.
Blocking happens at the highest level: the CW Orchestrator. This function is still experimental...

And like with all my updates: hit Save in Settings at least once, so any new/changed config variables get written into your config.json.

✨ Highlights

• Metadata localization (TMDB): descriptions can now show in your own language (when available)
  , Default is en-US
  , Change it in Settings -> Metadata providers -> TMDB -> Advanced

I've updated the WIKI Metadata with all possible localizatin codes here.

• Improved Editor: the editor now supports two different data sources
  • CW Tracker (the existing CW tracker editing and snapshots)
    -Current State (/config/state.json) with a Provider and Feature selector
    -In Current State, you can block items per provider so they won’t sync out to targets.
  • The trashbin button will block them, and if you want to unblock them just push the same trashbin button again.
  • Your Current State changes are saved separately (/config/state.manual.json) and will NOT be deleted automatically.

I've updated the WIKI Editor page here

🔧 Fixes & Changes

• Changed: absolute path is used for watchlist, to be compatible with some reverse proxies
• Changed: watcher sink adjustments apply immediately, no container restart needed
• Fixed: deleting an item in watchlist for CW TRacker, now actually deletes it
• Fixed: watchlist posters more often include titles on the cover

CrossWatch - v0.5.0

Welcome at version 0.5.0 as stated before this release is all about Refactors, file moves, and code restructuring.
Not glamorous, but it stops the codebase from evolving into a dumpster fire.
There are so many things improved, fixed, and changed that I honestly lost track.

⚠️ Important

Because of the larger code changes, I strongly recommend doing a full cleanup:

• Go to Settings → Maintenance
• Run Delete Everything / Clean Everything
• Then re-open CrossWatch so it rebuilds fresh state/caches
• Remove any pairs with Jellyfin that included ratings! and Create them again.
• Optional: remove you config.json to start clean.

This avoids stale tracker data, cached metadata, and old snapshots getting in the way of the refactor.

🔧 Fixes & Changes

• Jellyfin ratings sync is disabled.
  • I tried, but Jellyfin (and Emby) ratings behavior is… special.
  • It wasn’t working reliably anyway, so it’s off until it’s properly understood and implemented.
• UI improvement added: M: Movies S: Shows in insight
• Overal UI improvements smaller probes, css changes etc etc...
• Watchlist changes:
  • Removed the movie/show overlay when in list view.
  • Added background for the overlay (same principle as the Playing card)
• Provider changes:
  • SIMKL Improved shadowing (more reliable diffing + fewer “phantom repeats”).
  • TRAKT changes:
    • Improved ID resolving (fewer mismatches, fewer “unresolved” surprises).
    • CW now better supports Free accounts with better handling when Trakt limits are reached.
      • Console now shows: “Trakt account limit reached”
      • Trakt probe now reports:
        • free-tier and VIP limits (watchlist + collections)
        • last limit-related error (so you can actually see what happened)
        • Analyzer will tell you when limits has reached.
  • MDBList Ratings handling improved (fewer retries/loops).
  • Jellyfin and Emby Watchlist pagination fixed.
• Added three more provider shell tools in /scripts for MDBList / Trakt / SIMKL.
• Analyzer changes:
  • Improved detection logic.
  • Finds more issues and is better at pointing out why something didn’t sync.
• Help function: in pair configuration i've added some help icons with mouse-over information.

From 0.5.x onward I’ll continue with some refactoring for javascript and CSS

CrossWatch - v0.6.1

🔧 Fixes & Changes

• Fixed: Importing SIMKL History from the Editor no longer creates lots of “Unknown” entries (movies and episodes now import with proper IDs).
• Fixed: SIMKL History episode imports now keep real episode titles instead of falling back to generic S01E01 style names.
• Fixed: Plex watcher Live scrobble progress is now accurate even when multiple Plex users watch the same movie/show at the same time.
• Fixed: Plex webhook scrobble progress is now accurate even when multiple Plex users watch the same movie/show at the same time.
• Fixed: MDBList cleanup tool in /scripts/ - pagination now works reliably and stops correctly at the end.
• Fixed: MDBList episode ratings now store the real episode title in state.json
• Improved: SIMKL History imports are more reliable overall thanks to better handling of SIMKL’s nested data format (the Editor now reads what SIMKL actually sends).

CrossWatch - v0.6.0

Happy 2026. v0.6.0 is mainly about ratings: most provider modules were reworked to behave sanely in true two-way setups.
Big win: Plex ratings are now dramatically faster thanks to query changes (in some libraries, up to ~50×).

As with any feature release, it’s a good idea to run Maintenance to clean up your environment.
If you’re still using a config.json from older versions (< 0.5.x), you should think about rebuilding a fresh, clean config.json.
As with any feature release, expect a few bugs, don’t be surprised.

🔧 Fixes & Improvements

Orchestrator

• Two-way ratings: improved planning and execution for bidirectional ratings sync.
• Disabled pairs: disabled pairs no longer trigger snapshots (cleaner logs).

Ratings

• Plex: major query optimization (can be ~50× faster in some cases).
• Plex: improved ID resolving and lookups.
• Trakt: better season/episode ID resolving.
• SIMKL: better show/movie ID resolving.
• MDBList: fixed pagination behavior (no more “needs multiple sync runs to finish”).

Watcher & Webhooks

• Trakt sink: no more duplicate history entries
  • Fixed a rare legacy-config edge case causing two “finish” events for the same playback.
  • Improved duplicate-stop suppression for stop/resume/credit-skip edge cases.
• Plex ratings: fixed ratings processing in both Plex Webhook and Plex Watcher.
• Quick stops now actually stop
  • Fixed debounce issues where very short sessions could miss the final stop event.
  • Trakt and SIMKL scrobble state now ends cleanly even if you stop within a few seconds.
• Jellyfin webhook reliability
  • Stronger protection against double “finish” events.
  • More consistent stop handling during frequent progress updates.

Analyzer

• Pair-scope awareness: analyzer now respects per-pair feature scope (such as ratings.types: ["movies","shows"]).
• Out-of-scope summary: when everything is “All good”, the analyzer can still show what’s excluded by configuration
  (example: “X seasons / Y episodes not synced due to pair setup”), so you don’t go hunting ghosts.

Other

• SIMKL Watchlist: added some caching improvements.
• SIMKL History: episodes now include episode titles.
• Editor: UI tweaks - season and episode shown next to TV shows.

CrossWatch - v0.5.8

This release add ratings for Plex webhook/watcher and fixes a long-standing Plex annoyance: PIN-protected Plex Home users.
CrossWatch can now switch into the correct Plex user context (even when that user has a PIN).
NOTE: This is ONLY needed for the default enabled Marked Watched plex option (manual “Mark as Watched” actions in the Plex UI).

Ratings are now supported for Plex Webhooks and Plex Watcher. CrossWatch will forward your ratings to Trakt and/or SIMKL.

updated WIKI pages:
PLEX Module
Webhook
Watcher

✨ Highlights

• Ratings for Plex Webhook and Plex Watcher are now supported
  • You can now include ratings; enable it in Webhook options or Watcher options.
  • For Watcher, you need to add a webhook helper, so Plex Pass is required for this option to work.
• Plex Marked Watched enhancements
  • This option fetches items you manually marked as watched in Plex. Default: enabled.
  • Previously it only worked reliably for the Plex Owner; Home users (with or without PINs) were not handled correctly.

🔧 Fixes & Improvements

• Correct Plex user context
  • CrossWatch now attempts to switch to the configured Plex user before syncing user-specific data.
  • If the user is PIN-protected, the PIN is used during the switch.
  • If switching isn’t possible (wrong/missing PIN, not a Home user, etc.), CrossWatch falls back to the token user and logs why.
  • If CrossWatch cannot switch to the intended user, it disables marked watched to avoid syncing the wrong profile.
• Trakt ratings
  • Added retries and backoff, including Retry-After support.
  • Canonical keys for seasons/episodes: cache merge/remove now includes show_ids + season/episode identifiers.
  • Improved debug logging: status codes and short response bodies on failures.

I’d love to add ratings for Emby and Jellyfin, just like Plex. The problem is: I can’t find any UI option to set user-specific ratings in Emby/Jellyfin.
Maybe I’m just blind. I do see rating-related fields in their APIs, but I’m not seeing the equivalent in the UI. Since I’m not an Emby or Jellyfin user, I might be missing something.
If you know where user ratings live in the UI (or if I’m wrong about how it works), please drop a note in the discussion so I can take another look.

CrossWatch - v0.5.7

BEST WISHES FOR 2026
This release adds Scrobble Library Whitelisting for Plex, Emby, and Jellyfin.
You can now choose exactly which libraries are allowed to generate scrobbles (Simkl/Trakt, etc.).
Configure it under settings - authentication - Plex/Emby/Jellyfin - settings.. Look for the Kermit-the-Frog green dots, that’s Scrobble.
If the scrobble whitelist is empty, CrossWatch will scrobble everything (current behavior).

This applies to both Scrobble input paths (watchers and webhooks):

• Watchers (local polling/stream watchers)
• Webhooks (server push events)

READ the WIKI regarding whitelisting

✨ Highlights

• Scrobble Library Whitelisting (Plex / Emby / Jellyfin)
  • Empty whitelist = allow all (no filtering)
  • New S (Scrobble) column next to H (History) and R (Ratings) in provider settings
  • Emby/Jellyfin use “virtual” views, so CrossWatch resolves the correct View before applying the whitelist
  • Prevents scrobbles leaking from non-whitelisted libraries

CrossWatch - v0.5.6

This release adds a new provider: Tautulli.
Tautulli is a Plex monitoring and analytics tool and NOT a tracker or media server, so CrossWatch uses it only to import your existing Plex watch history

DO NOT pair Tautulli as a destination (or “sync into” anything). It’s not a tracker/media server and will generate garbage matches: wrong IDs, tons of false items, and a bad time. Use it as a source-only helper and NEVER as a direct sync target to Plex, Jellyfin, Trakt, SIMKL, or anything else. The only correct use case: Either import the Tautulli dataset directly into the Editor, or create a one-way sync pair from Tautulli to CrossWatch Tracker.

If this all doesn’t ring a bell, you probably don’t need Tautulli imports, it’s only for a specific group of long-time Plex users with lots of existing history in Tautulli.

READ the WIKI

✨ Highlights

• New provider: Tautulli (History Import only)
  • Import your historical watches from Tautulli into CrossWatch
  • Tautulli is source-only: it can’t be selected as a destination
  • When using Tautulli, sync is one-way only

CrossWatch - v0.5.5

This update focuses on making Plex to Trakt scrobbling (webhook mode) behave a litte bit better.
Plex fixed some webhook autoplay bugs where a new scrobble start was never sent.
The CW Plex webhook logic now matches Plex’s updated behavior, and the old quarantine/autoplay workaround has been removed.

🔧 Fixes & Improvements

• Plex Webhook (Plex to Trakt scrobble)
  • Removed the autoplay quarantine logic that was meant to detect autoplay episodes. Obsolute due to Plex bug fixes.
  • Scrobble state is now tied more strongly to the correct user and playback session, reducing mix-ups in multi-user setups.
  • Better handling of Plex progress weirdness (including the classic “pause at 100%”).
  • Smarter decisions on whether an event should be treated as pause or stop, keeping Trakt history cleaner.
  • Stronger fallback logic for resolving episode/show IDs when Plex metadata is incomplete, improving Trakt matching for TV episodes.

CrossWatch - v0.5.4

Another small but important update, and the last one of the year. Wishing you all a great time.

This one is again editor-focused. If you don’t see the changes, do a hard refresh / clear your browser cache (yes, again).
You can now populate state.json without setting up a sync pair first, a huge improvement.

Read all about the new import datasets function here

🔧 Fixes & Improvements

• Editor upgrades – Import datasets
  • Import your datasets from Plex, Trakt, etc. (Watchlist / History / Ratings) so you can edit/block items before running any sync.
• Changed: MetaAPI now uses an absolute path, improving compatibility with some reverse proxies.

CrossWatch - v0.5.3

A small update for improved editing. Please refresh/clean your browser cache if you dont see the changes in editor.

🔧 Fixes & Improvements

• Editor upgrades
  • Bulk selection (select page / multi-select) with bulk delete/restore.
  • Type filters (Movie / Show / Season / Episode) and a Blocked-only view (Current State).

CrossWatch - v0.5.2

Some small fixes.

🔧 Fixes & Changes

• Fallback GUID: works again (Plex only option). In 0.5.0 the index was cleaned before the fallback GUIDs were merged. Now fixed again. Note: use this as a one-time sync, then disable it.
• Plex changes: fallback has been removed so usernames and user IDs are honored again.

CrossWatch - v0.5.1

Some small updates and quality-of-life improvements. And one big update.
One long-standing irritation by me was that there was no simple way to say: “do not sync this movie, show, or episode”.
If a provider kept reporting it, CrossWatch would keep planning it. That ends now: you can block items per provider so they won’t be pushed out to targets.
Blocking happens at the highest level: the CW Orchestrator. This function is still experimental...

And like with all my updates: hit Save in Settings at least once, so any new/changed config variables get written into your config.json.

✨ Highlights

• Metadata localization (TMDB): descriptions can now show in your own language (when available)
  , Default is en-US
  , Change it in Settings -> Metadata providers -> TMDB -> Advanced

I've updated the WIKI Metadata with all possible localizatin codes here.

• Improved Editor: the editor now supports two different data sources
  • CW Tracker (the existing CW tracker editing and snapshots)
    -Current State (/config/state.json) with a Provider and Feature selector
    -In Current State, you can block items per provider so they won’t sync out to targets.
  • The trashbin button will block them, and if you want to unblock them just push the same trashbin button again.
  • Your Current State changes are saved separately (/config/state.manual.json) and will NOT be deleted automatically.

I've updated the WIKI Editor page here

🔧 Fixes & Changes

• Changed: absolute path is used for watchlist, to be compatible with some reverse proxies
• Changed: watcher sink adjustments apply immediately, no container restart needed
• Fixed: deleting an item in watchlist for CW TRacker, now actually deletes it
• Fixed: watchlist posters more often include titles on the cover

CrossWatch - v0.5.0

Welcome at version 0.5.0 as stated before this release is all about Refactors, file moves, and code restructuring.
Not glamorous, but it stops the codebase from evolving into a dumpster fire.
There are so many things improved, fixed, and changed that I honestly lost track.

⚠️ Important

Because of the larger code changes, I strongly recommend doing a full cleanup:

• Go to Settings → Maintenance
• Run Delete Everything / Clean Everything
• Then re-open CrossWatch so it rebuilds fresh state/caches
• Remove any pairs with Jellyfin that included ratings! and Create them again.
• Optional: remove you config.json to start clean.

This avoids stale tracker data, cached metadata, and old snapshots getting in the way of the refactor.

🔧 Fixes & Changes

• Jellyfin ratings sync is disabled.
  • I tried, but Jellyfin (and Emby) ratings behavior is… special.
  • It wasn’t working reliably anyway, so it’s off until it’s properly understood and implemented.
• UI improvement added: M: Movies S: Shows in insight
• Overal UI improvements smaller probes, css changes etc etc...
• Watchlist changes:
  • Removed the movie/show overlay when in list view.
  • Added background for the overlay (same principle as the Playing card)
• Provider changes:
  • SIMKL Improved shadowing (more reliable diffing + fewer “phantom repeats”).
  • TRAKT changes:
    • Improved ID resolving (fewer mismatches, fewer “unresolved” surprises).
    • CW now better supports Free accounts with better handling when Trakt limits are reached.
      • Console now shows: “Trakt account limit reached”
      • Trakt probe now reports:
        • free-tier and VIP limits (watchlist + collections)
        • last limit-related error (so you can actually see what happened)
        • Analyzer will tell you when limits has reached.
  • MDBList Ratings handling improved (fewer retries/loops).
  • Jellyfin and Emby Watchlist pagination fixed.
• Added three more provider shell tools in /scripts for MDBList / Trakt / SIMKL.
• Analyzer changes:
  • Improved detection logic.
  • Finds more issues and is better at pointing out why something didn’t sync.
• Help function: in pair configuration i've added some help icons with mouse-over information.

From 0.5.x onward I’ll continue with some refactoring for javascript and CSS

CrossWatch - v0.6.0

Happy 2026. v0.6.0 is mainly about ratings: most provider modules were reworked to behave sanely in true two-way setups.
Big win: Plex ratings are now dramatically faster thanks to query changes (in some libraries, up to ~50×).

As with any feature release, it’s a good idea to run Maintenance to clean up your environment.
If you’re still using a config.json from older versions (< 0.5.x), you should think about rebuilding a fresh, clean config.json.
As with any feature release, expect a few bugs, don’t be surprised.

🔧 Fixes & Improvements

Orchestrator

• Two-way ratings: improved planning and execution for bidirectional ratings sync.
• Disabled pairs: disabled pairs no longer trigger snapshots (cleaner logs).

Ratings

• Plex: major query optimization (can be ~50× faster in some cases).
• Plex: improved ID resolving and lookups.
• Trakt: better season/episode ID resolving.
• SIMKL: better show/movie ID resolving.
• MDBList: fixed pagination behavior (no more “needs multiple sync runs to finish”).

Watcher & Webhooks

• Trakt sink: no more duplicate history entries
  • Fixed a rare legacy-config edge case causing two “finish” events for the same playback.
  • Improved duplicate-stop suppression for stop/resume/credit-skip edge cases.
• Plex ratings: fixed ratings processing in both Plex Webhook and Plex Watcher.
• Quick stops now actually stop
  • Fixed debounce issues where very short sessions could miss the final stop event.
  • Trakt and SIMKL scrobble state now ends cleanly even if you stop within a few seconds.
• Jellyfin webhook reliability
  • Stronger protection against double “finish” events.
  • More consistent stop handling during frequent progress updates.

Analyzer

• Pair-scope awareness: analyzer now respects per-pair feature scope (such as ratings.types: ["movies","shows"]).
• Out-of-scope summary: when everything is “All good”, the analyzer can still show what’s excluded by configuration
  (example: “X seasons / Y episodes not synced due to pair setup”), so you don’t go hunting ghosts.

Other

• SIMKL Watchlist: added some caching improvements.
• SIMKL History: episodes now include episode titles.
• Editor: UI tweaks - season and episode shown next to TV shows.

CrossWatch - v0.5.8

This release add ratings for Plex webhook/watcher and fixes a long-standing Plex annoyance: PIN-protected Plex Home users.
CrossWatch can now switch into the correct Plex user context (even when that user has a PIN).
NOTE: This is ONLY needed for the default enabled Marked Watched plex option (manual “Mark as Watched” actions in the Plex UI).

Ratings are now supported for Plex Webhooks and Plex Watcher. CrossWatch will forward your ratings to Trakt and/or SIMKL.

updated WIKI pages:
PLEX Module
Webhook
Watcher

✨ Highlights

• Ratings for Plex Webhook and Plex Watcher are now supported
  • You can now include ratings; enable it in Webhook options or Watcher options.
  • For Watcher, you need to add a webhook helper, so Plex Pass is required for this option to work.
• Plex Marked Watched enhancements
  • This option fetches items you manually marked as watched in Plex. Default: enabled.
  • Previously it only worked reliably for the Plex Owner; Home users (with or without PINs) were not handled correctly.

🔧 Fixes & Improvements

• Correct Plex user context
  • CrossWatch now attempts to switch to the configured Plex user before syncing user-specific data.
  • If the user is PIN-protected, the PIN is used during the switch.
  • If switching isn’t possible (wrong/missing PIN, not a Home user, etc.), CrossWatch falls back to the token user and logs why.
  • If CrossWatch cannot switch to the intended user, it disables marked watched to avoid syncing the wrong profile.
• Trakt ratings
  • Added retries and backoff, including Retry-After support.
  • Canonical keys for seasons/episodes: cache merge/remove now includes show_ids + season/episode identifiers.
  • Improved debug logging: status codes and short response bodies on failures.

I’d love to add ratings for Emby and Jellyfin, just like Plex. The problem is: I can’t find any UI option to set user-specific ratings in Emby/Jellyfin.
Maybe I’m just blind. I do see rating-related fields in their APIs, but I’m not seeing the equivalent in the UI. Since I’m not an Emby or Jellyfin user, I might be missing something.
If you know where user ratings live in the UI (or if I’m wrong about how it works), please drop a note in the discussion so I can take another look.

CrossWatch - v0.5.7

BEST WISHES FOR 2026
This release adds Scrobble Library Whitelisting for Plex, Emby, and Jellyfin.
You can now choose exactly which libraries are allowed to generate scrobbles (Simkl/Trakt, etc.).
Configure it under settings - authentication - Plex/Emby/Jellyfin - settings.. Look for the Kermit-the-Frog green dots, that’s Scrobble.
If the scrobble whitelist is empty, CrossWatch will scrobble everything (current behavior).

This applies to both Scrobble input paths (watchers and webhooks):

• Watchers (local polling/stream watchers)
• Webhooks (server push events)

READ the WIKI regarding whitelisting

✨ Highlights

• Scrobble Library Whitelisting (Plex / Emby / Jellyfin)
  • Empty whitelist = allow all (no filtering)
  • New S (Scrobble) column next to H (History) and R (Ratings) in provider settings
  • Emby/Jellyfin use “virtual” views, so CrossWatch resolves the correct View before applying the whitelist
  • Prevents scrobbles leaking from non-whitelisted libraries

CrossWatch - v0.5.6

This release adds a new provider: Tautulli.
Tautulli is a Plex monitoring and analytics tool and NOT a tracker or media server, so CrossWatch uses it only to import your existing Plex watch history

DO NOT pair Tautulli as a destination (or “sync into” anything). It’s not a tracker/media server and will generate garbage matches: wrong IDs, tons of false items, and a bad time. Use it as a source-only helper and NEVER as a direct sync target to Plex, Jellyfin, Trakt, SIMKL, or anything else. The only correct use case: Either import the Tautulli dataset directly into the Editor, or create a one-way sync pair from Tautulli to CrossWatch Tracker.

If this all doesn’t ring a bell, you probably don’t need Tautulli imports, it’s only for a specific group of long-time Plex users with lots of existing history in Tautulli.

READ the WIKI

✨ Highlights

• New provider: Tautulli (History Import only)
  • Import your historical watches from Tautulli into CrossWatch
  • Tautulli is source-only: it can’t be selected as a destination
  • When using Tautulli, sync is one-way only

CrossWatch - v0.5.5

This update focuses on making Plex to Trakt scrobbling (webhook mode) behave a litte bit better.
Plex fixed some webhook autoplay bugs where a new scrobble start was never sent.
The CW Plex webhook logic now matches Plex’s updated behavior, and the old quarantine/autoplay workaround has been removed.

🔧 Fixes & Improvements

• Plex Webhook (Plex to Trakt scrobble)
  • Removed the autoplay quarantine logic that was meant to detect autoplay episodes. Obsolute due to Plex bug fixes.
  • Scrobble state is now tied more strongly to the correct user and playback session, reducing mix-ups in multi-user setups.
  • Better handling of Plex progress weirdness (including the classic “pause at 100%”).
  • Smarter decisions on whether an event should be treated as pause or stop, keeping Trakt history cleaner.
  • Stronger fallback logic for resolving episode/show IDs when Plex metadata is incomplete, improving Trakt matching for TV episodes.

CrossWatch - v0.5.4

Another small but important update, and the last one of the year. Wishing you all a great time.

This one is again editor-focused. If you don’t see the changes, do a hard refresh / clear your browser cache (yes, again).
You can now populate state.json without setting up a sync pair first, a huge improvement.

Read all about the new import datasets function here

🔧 Fixes & Improvements

• Editor upgrades – Import datasets
  • Import your datasets from Plex, Trakt, etc. (Watchlist / History / Ratings) so you can edit/block items before running any sync.
• Changed: MetaAPI now uses an absolute path, improving compatibility with some reverse proxies.

CrossWatch - v0.5.3

A small update for improved editing. Please refresh/clean your browser cache if you dont see the changes in editor.

🔧 Fixes & Improvements

• Editor upgrades
  • Bulk selection (select page / multi-select) with bulk delete/restore.
  • Type filters (Movie / Show / Season / Episode) and a Blocked-only view (Current State).

CrossWatch - v0.5.2

Some small fixes.

🔧 Fixes & Changes

• Fallback GUID: works again (Plex only option). In 0.5.0 the index was cleaned before the fallback GUIDs were merged. Now fixed again. Note: use this as a one-time sync, then disable it.
• Plex changes: fallback has been removed so usernames and user IDs are honored again.

CrossWatch - v0.5.1

Some small updates and quality-of-life improvements. And one big update.
One long-standing irritation by me was that there was no simple way to say: “do not sync this movie, show, or episode”.
If a provider kept reporting it, CrossWatch would keep planning it. That ends now: you can block items per provider so they won’t be pushed out to targets.
Blocking happens at the highest level: the CW Orchestrator. This function is still experimental...

And like with all my updates: hit Save in Settings at least once, so any new/changed config variables get written into your config.json.

✨ Highlights

• Metadata localization (TMDB): descriptions can now show in your own language (when available)
  , Default is en-US
  , Change it in Settings -> Metadata providers -> TMDB -> Advanced

I've updated the WIKI Metadata with all possible localizatin codes here.

• Improved Editor: the editor now supports two different data sources
  • CW Tracker (the existing CW tracker editing and snapshots)
    -Current State (/config/state.json) with a Provider and Feature selector
    -In Current State, you can block items per provider so they won’t sync out to targets.
  • The trashbin button will block them, and if you want to unblock them just push the same trashbin button again.
  • Your Current State changes are saved separately (/config/state.manual.json) and will NOT be deleted automatically.

I've updated the WIKI Editor page here

🔧 Fixes & Changes

• Changed: absolute path is used for watchlist, to be compatible with some reverse proxies
• Changed: watcher sink adjustments apply immediately, no container restart needed
• Fixed: deleting an item in watchlist for CW TRacker, now actually deletes it
• Fixed: watchlist posters more often include titles on the cover

CrossWatch - v0.5.0

Welcome at version 0.5.0 as stated before this release is all about Refactors, file moves, and code restructuring.
Not glamorous, but it stops the codebase from evolving into a dumpster fire.
There are so many things improved, fixed, and changed that I honestly lost track.

⚠️ Important

Because of the larger code changes, I strongly recommend doing a full cleanup:

• Go to Settings → Maintenance
• Run Delete Everything / Clean Everything
• Then re-open CrossWatch so it rebuilds fresh state/caches
• Remove any pairs with Jellyfin that included ratings! and Create them again.
• Optional: remove you config.json to start clean.

This avoids stale tracker data, cached metadata, and old snapshots getting in the way of the refactor.

🔧 Fixes & Changes

• Jellyfin ratings sync is disabled.
  • I tried, but Jellyfin (and Emby) ratings behavior is… special.
  • It wasn’t working reliably anyway, so it’s off until it’s properly understood and implemented.
• UI improvement added: M: Movies S: Shows in insight
• Overal UI improvements smaller probes, css changes etc etc...
• Watchlist changes:
  • Removed the movie/show overlay when in list view.
  • Added background for the overlay (same principle as the Playing card)
• Provider changes:
  • SIMKL Improved shadowing (more reliable diffing + fewer “phantom repeats”).
  • TRAKT changes:
    • Improved ID resolving (fewer mismatches, fewer “unresolved” surprises).
    • CW now better supports Free accounts with better handling when Trakt limits are reached.
      • Console now shows: “Trakt account limit reached”
      • Trakt probe now reports:
        • free-tier and VIP limits (watchlist + collections)
        • last limit-related error (so you can actually see what happened)
        • Analyzer will tell you when limits has reached.
  • MDBList Ratings handling improved (fewer retries/loops).
  • Jellyfin and Emby Watchlist pagination fixed.
• Added three more provider shell tools in /scripts for MDBList / Trakt / SIMKL.
• Analyzer changes:
  • Improved detection logic.
  • Finds more issues and is better at pointing out why something didn’t sync.
• Help function: in pair configuration i've added some help icons with mouse-over information.

From 0.5.x onward I’ll continue with some refactoring for javascript and CSS

CrossWatch - v0.5.8

This release add ratings for Plex webhook/watcher and fixes a long-standing Plex annoyance: PIN-protected Plex Home users.
CrossWatch can now switch into the correct Plex user context (even when that user has a PIN).
NOTE: This is ONLY needed for the default enabled Marked Watched plex option (manual “Mark as Watched” actions in the Plex UI).

Ratings are now supported for Plex Webhooks and Plex Watcher. CrossWatch will forward your ratings to Trakt and/or SIMKL.

updated WIKI pages:
PLEX Module
Webhook
Watcher

✨ Highlights

• Ratings for Plex Webhook and Plex Watcher are now supported
  • You can now include ratings; enable it in Webhook options or Watcher options.
  • For Watcher, you need to add a webhook helper, so Plex Pass is required for this option to work.
• Plex Marked Watched enhancements
  • This option fetches items you manually marked as watched in Plex. Default: enabled.
  • Previously it only worked reliably for the Plex Owner; Home users (with or without PINs) were not handled correctly.

🔧 Fixes & Improvements

• Correct Plex user context
  • CrossWatch now attempts to switch to the configured Plex user before syncing user-specific data.
  • If the user is PIN-protected, the PIN is used during the switch.
  • If switching isn’t possible (wrong/missing PIN, not a Home user, etc.), CrossWatch falls back to the token user and logs why.
  • If CrossWatch cannot switch to the intended user, it disables marked watched to avoid syncing the wrong profile.
• Trakt ratings
  • Added retries and backoff, including Retry-After support.
  • Canonical keys for seasons/episodes: cache merge/remove now includes show_ids + season/episode identifiers.
  • Improved debug logging: status codes and short response bodies on failures.

I’d love to add ratings for Emby and Jellyfin, just like Plex. The problem is: I can’t find any UI option to set user-specific ratings in Emby/Jellyfin.
Maybe I’m just blind. I do see rating-related fields in their APIs, but I’m not seeing the equivalent in the UI. Since I’m not an Emby or Jellyfin user, I might be missing something.
If you know where user ratings live in the UI (or if I’m wrong about how it works), please drop a note in the discussion so I can take another look.

CrossWatch - v0.5.7

BEST WISHES FOR 2026
This release adds Scrobble Library Whitelisting for Plex, Emby, and Jellyfin.
You can now choose exactly which libraries are allowed to generate scrobbles (Simkl/Trakt, etc.).
Configure it under settings - authentication - Plex/Emby/Jellyfin - settings.. Look for the Kermit-the-Frog green dots, that’s Scrobble.
If the scrobble whitelist is empty, CrossWatch will scrobble everything (current behavior).

This applies to both Scrobble input paths (watchers and webhooks):

• Watchers (local polling/stream watchers)
• Webhooks (server push events)

READ the WIKI regarding whitelisting

✨ Highlights

• Scrobble Library Whitelisting (Plex / Emby / Jellyfin)
  • Empty whitelist = allow all (no filtering)
  • New S (Scrobble) column next to H (History) and R (Ratings) in provider settings
  • Emby/Jellyfin use “virtual” views, so CrossWatch resolves the correct View before applying the whitelist
  • Prevents scrobbles leaking from non-whitelisted libraries

CrossWatch - v0.5.6

This release adds a new provider: Tautulli.
Tautulli is a Plex monitoring and analytics tool and NOT a tracker or media server, so CrossWatch uses it only to import your existing Plex watch history

DO NOT pair Tautulli as a destination (or “sync into” anything). It’s not a tracker/media server and will generate garbage matches: wrong IDs, tons of false items, and a bad time. Use it as a source-only helper and NEVER as a direct sync target to Plex, Jellyfin, Trakt, SIMKL, or anything else. The only correct use case: Either import the Tautulli dataset directly into the Editor, or create a one-way sync pair from Tautulli to CrossWatch Tracker.

If this all doesn’t ring a bell, you probably don’t need Tautulli imports, it’s only for a specific group of long-time Plex users with lots of existing history in Tautulli.

READ the WIKI

✨ Highlights

• New provider: Tautulli (History Import only)
  • Import your historical watches from Tautulli into CrossWatch
  • Tautulli is source-only: it can’t be selected as a destination
  • When using Tautulli, sync is one-way only

CrossWatch - v0.5.5

This update focuses on making Plex to Trakt scrobbling (webhook mode) behave a litte bit better.
Plex fixed some webhook autoplay bugs where a new scrobble start was never sent.
The CW Plex webhook logic now matches Plex’s updated behavior, and the old quarantine/autoplay workaround has been removed.

🔧 Fixes & Improvements

• Plex Webhook (Plex to Trakt scrobble)
  • Removed the autoplay quarantine logic that was meant to detect autoplay episodes. Obsolute due to Plex bug fixes.
  • Scrobble state is now tied more strongly to the correct user and playback session, reducing mix-ups in multi-user setups.
  • Better handling of Plex progress weirdness (including the classic “pause at 100%”).
  • Smarter decisions on whether an event should be treated as pause or stop, keeping Trakt history cleaner.
  • Stronger fallback logic for resolving episode/show IDs when Plex metadata is incomplete, improving Trakt matching for TV episodes.

CrossWatch - v0.5.4

Another small but important update, and the last one of the year. Wishing you all a great time.

This one is again editor-focused. If you don’t see the changes, do a hard refresh / clear your browser cache (yes, again).
You can now populate state.json without setting up a sync pair first, a huge improvement.

Read all about the new import datasets function here

🔧 Fixes & Improvements

• Editor upgrades – Import datasets
  • Import your datasets from Plex, Trakt, etc. (Watchlist / History / Ratings) so you can edit/block items before running any sync.
• Changed: MetaAPI now uses an absolute path, improving compatibility with some reverse proxies.

CrossWatch - v0.5.3

A small update for improved editing. Please refresh/clean your browser cache if you dont see the changes in editor.

🔧 Fixes & Improvements

• Editor upgrades
  • Bulk selection (select page / multi-select) with bulk delete/restore.
  • Type filters (Movie / Show / Season / Episode) and a Blocked-only view (Current State).

CrossWatch - v0.5.2

Some small fixes.

🔧 Fixes & Changes

• Fallback GUID: works again (Plex only option). In 0.5.0 the index was cleaned before the fallback GUIDs were merged. Now fixed again. Note: use this as a one-time sync, then disable it.
• Plex changes: fallback has been removed so usernames and user IDs are honored again.

CrossWatch - v0.5.1

Some small updates and quality-of-life improvements. And one big update.
One long-standing irritation by me was that there was no simple way to say: “do not sync this movie, show, or episode”.
If a provider kept reporting it, CrossWatch would keep planning it. That ends now: you can block items per provider so they won’t be pushed out to targets.
Blocking happens at the highest level: the CW Orchestrator. This function is still experimental...

And like with all my updates: hit Save in Settings at least once, so any new/changed config variables get written into your config.json.

✨ Highlights

• Metadata localization (TMDB): descriptions can now show in your own language (when available)
  , Default is en-US
  , Change it in Settings -> Metadata providers -> TMDB -> Advanced

I've updated the WIKI Metadata with all possible localizatin codes here.

• Improved Editor: the editor now supports two different data sources
  • CW Tracker (the existing CW tracker editing and snapshots)
    -Current State (/config/state.json) with a Provider and Feature selector
    -In Current State, you can block items per provider so they won’t sync out to targets.
  • The trashbin button will block them, and if you want to unblock them just push the same trashbin button again.
  • Your Current State changes are saved separately (/config/state.manual.json) and will NOT be deleted automatically.

I've updated the WIKI Editor page here

🔧 Fixes & Changes

• Changed: absolute path is used for watchlist, to be compatible with some reverse proxies
• Changed: watcher sink adjustments apply immediately, no container restart needed
• Fixed: deleting an item in watchlist for CW TRacker, now actually deletes it
• Fixed: watchlist posters more often include titles on the cover

CrossWatch - v0.5.0

Welcome at version 0.5.0 as stated before this release is all about Refactors, file moves, and code restructuring.
Not glamorous, but it stops the codebase from evolving into a dumpster fire.
There are so many things improved, fixed, and changed that I honestly lost track.

⚠️ Important

Because of the larger code changes, I strongly recommend doing a full cleanup:

• Go to Settings → Maintenance
• Run Delete Everything / Clean Everything
• Then re-open CrossWatch so it rebuilds fresh state/caches
• Remove any pairs with Jellyfin that included ratings! and Create them again.
• Optional: remove you config.json to start clean.

This avoids stale tracker data, cached metadata, and old snapshots getting in the way of the refactor.

🔧 Fixes & Changes

• Jellyfin ratings sync is disabled.
  • I tried, but Jellyfin (and Emby) ratings behavior is… special.
  • It wasn’t working reliably anyway, so it’s off until it’s properly understood and implemented.
• UI improvement added: M: Movies S: Shows in insight
• Overal UI improvements smaller probes, css changes etc etc...
• Watchlist changes:
  • Removed the movie/show overlay when in list view.
  • Added background for the overlay (same principle as the Playing card)
• Provider changes:
  • SIMKL Improved shadowing (more reliable diffing + fewer “phantom repeats”).
  • TRAKT changes:
    • Improved ID resolving (fewer mismatches, fewer “unresolved” surprises).
    • CW now better supports Free accounts with better handling when Trakt limits are reached.
      • Console now shows: “Trakt account limit reached”
      • Trakt probe now reports:
        • free-tier and VIP limits (watchlist + collections)
        • last limit-related error (so you can actually see what happened)
        • Analyzer will tell you when limits has reached.
  • MDBList Ratings handling improved (fewer retries/loops).
  • Jellyfin and Emby Watchlist pagination fixed.
• Added three more provider shell tools in /scripts for MDBList / Trakt / SIMKL.
• Analyzer changes:
  • Improved detection logic.
  • Finds more issues and is better at pointing out why something didn’t sync.
• Help function: in pair configuration i've added some help icons with mouse-over information.

From 0.5.x onward I’ll continue with some refactoring for javascript and CSS

CrossWatch - v0.5.7

BEST WISHES FOR 2026
This release adds Scrobble Library Whitelisting for Plex, Emby, and Jellyfin.
You can now choose exactly which libraries are allowed to generate scrobbles (Simkl/Trakt, etc.).
Configure it under settings - authentication - Plex/Emby/Jellyfin - settings.. Look for the Kermit-the-Frog green dots, that’s Scrobble.
If the scrobble whitelist is empty, CrossWatch will scrobble everything (current behavior).

This applies to both Scrobble input paths (watchers and webhooks):

• Watchers (local polling/stream watchers)
• Webhooks (server push events)

READ the WIKI regarding whitelisting

✨ Highlights

• Scrobble Library Whitelisting (Plex / Emby / Jellyfin)
  • Empty whitelist = allow all (no filtering)
  • New S (Scrobble) column next to H (History) and R (Ratings) in provider settings
  • Emby/Jellyfin use “virtual” views, so CrossWatch resolves the correct View before applying the whitelist
  • Prevents scrobbles leaking from non-whitelisted libraries

CrossWatch - v0.5.6

This release adds a new provider: Tautulli.
Tautulli is a Plex monitoring and analytics tool and NOT a tracker or media server, so CrossWatch uses it only to import your existing Plex watch history

DO NOT pair Tautulli as a destination (or “sync into” anything). It’s not a tracker/media server and will generate garbage matches: wrong IDs, tons of false items, and a bad time. Use it as a source-only helper and NEVER as a direct sync target to Plex, Jellyfin, Trakt, SIMKL, or anything else. The only correct use case: Either import the Tautulli dataset directly into the Editor, or create a one-way sync pair from Tautulli to CrossWatch Tracker.

If this all doesn’t ring a bell, you probably don’t need Tautulli imports, it’s only for a specific group of long-time Plex users with lots of existing history in Tautulli.

READ the WIKI

✨ Highlights

• New provider: Tautulli (History Import only)
  • Import your historical watches from Tautulli into CrossWatch
  • Tautulli is source-only: it can’t be selected as a destination
  • When using Tautulli, sync is one-way only

CrossWatch - v0.5.5

This update focuses on making Plex to Trakt scrobbling (webhook mode) behave a litte bit better.
Plex fixed some webhook autoplay bugs where a new scrobble start was never sent.
The CW Plex webhook logic now matches Plex’s updated behavior, and the old quarantine/autoplay workaround has been removed.

🔧 Fixes & Improvements

• Plex Webhook (Plex to Trakt scrobble)
  • Removed the autoplay quarantine logic that was meant to detect autoplay episodes. Obsolute due to Plex bug fixes.
  • Scrobble state is now tied more strongly to the correct user and playback session, reducing mix-ups in multi-user setups.
  • Better handling of Plex progress weirdness (including the classic “pause at 100%”).
  • Smarter decisions on whether an event should be treated as pause or stop, keeping Trakt history cleaner.
  • Stronger fallback logic for resolving episode/show IDs when Plex metadata is incomplete, improving Trakt matching for TV episodes.

CrossWatch - v0.5.4

Another small but important update, and the last one of the year. Wishing you all a great time.

This one is again editor-focused. If you don’t see the changes, do a hard refresh / clear your browser cache (yes, again).
You can now populate state.json without setting up a sync pair first, a huge improvement.

Read all about the new import datasets function here

🔧 Fixes & Improvements

• Editor upgrades – Import datasets
  • Import your datasets from Plex, Trakt, etc. (Watchlist / History / Ratings) so you can edit/block items before running any sync.
• Changed: MetaAPI now uses an absolute path, improving compatibility with some reverse proxies.

CrossWatch - v0.5.3

A small update for improved editing. Please refresh/clean your browser cache if you dont see the changes in editor.

🔧 Fixes & Improvements

• Editor upgrades
  • Bulk selection (select page / multi-select) with bulk delete/restore.
  • Type filters (Movie / Show / Season / Episode) and a Blocked-only view (Current State).

CrossWatch - v0.5.2

Some small fixes.

🔧 Fixes & Changes

• Fallback GUID: works again (Plex only option). In 0.5.0 the index was cleaned before the fallback GUIDs were merged. Now fixed again. Note: use this as a one-time sync, then disable it.
• Plex changes: fallback has been removed so usernames and user IDs are honored again.

CrossWatch - v0.5.1

Some small updates and quality-of-life improvements. And one big update.
One long-standing irritation by me was that there was no simple way to say: “do not sync this movie, show, or episode”.
If a provider kept reporting it, CrossWatch would keep planning it. That ends now: you can block items per provider so they won’t be pushed out to targets.
Blocking happens at the highest level: the CW Orchestrator. This function is still experimental...

And like with all my updates: hit Save in Settings at least once, so any new/changed config variables get written into your config.json.

✨ Highlights

• Metadata localization (TMDB): descriptions can now show in your own language (when available)
  , Default is en-US
  , Change it in Settings -> Metadata providers -> TMDB -> Advanced

I've updated the WIKI Metadata with all possible localizatin codes here.

• Improved Editor: the editor now supports two different data sources
  • CW Tracker (the existing CW tracker editing and snapshots)
    -Current State (/config/state.json) with a Provider and Feature selector
    -In Current State, you can block items per provider so they won’t sync out to targets.
  • The trashbin button will block them, and if you want to unblock them just push the same trashbin button again.
  • Your Current State changes are saved separately (/config/state.manual.json) and will NOT be deleted automatically.