CrossWatch v0.10.3

This version introduces very early experimental playlist syncs (not for production) only for early testing.

I've completed the redesign of SIMKL and Trakt history adapters. Anime syncs and other show mismatch between SIMKL/TRAKT should be much better. The adapters are now mapping every episode. Anime with different numbering systems, split shows etc.

If you use SIMKL or/and TRAKT history then Maintenance -> Sync and run (clean up your cache before using!)

Note: Note: Most anime specials cannot be matched reliably because SIMKL and Trakt number and/or group them differently.

Specials need to be treated as tracker specific. Not much i can do about it.

Metadata has been fixed to resolve anime. If you have wrong covers or metadata:

Maintenance -> Reports & Metadata -> Refresh artwork & metadata Probably also clear your own browser cache.

✨ Highlights

• Playlists: Experimental (not for production!) playlist synchronization with endpoints and mapping profiles.
• SIMKL/TRAKT: history syncs now preserves destination episode mappings and merges equivalent episode.
• Customizable Sync Hub: you can now enable/disable/relocate/resize the sync blocks in the main sync hub.
• Quick add: redesigned to have a step based Quick Add wizard.
• Whitelisting: redesigned Plex, Emby and Jellyfin library whitelisting.

🔧 Fixes & Improvements

• Improved: Connection profiles now require a successful connection before saving.
• Improved: Empty profiles are removed automatically.
• Fixed: Analyzer now recognizes history aliases and separates current mismatches from pending retries.
• Fixed: SIMKL anime movies in watchlist and ratings are no longer treated as shows.
• Fixed: Trakt watchlist limits now use the account limit provided by Trakt and not a hard limit.
• Fixed: Webhook and Plex watcher URLs now use https behind a TLS reverse proxy.
• Removed: The legacy Plex user picker.
• Removed: The Android companion app and mobile API.
• Updated: Trakt adapter to v1.4, Plex adapter to v2.1, MDBList adapter to v1.2 and SIMKL adapter to v1.6.

CrossWatch v0.10.2

The Scrobbler settings and configuration flow have been completely redesigned in this release.

Webhooks now behave more like Watcher, although Watcher remains my preferred option. You can decide which approach works best for you.

If you use Watcher routes or webhooks, review your Scrobbler configuration after upgrading.

Legacy webhook settings must be cleaned up. The Scrobbler page will display a banner that can handle this automatically.

If you have been using CrossWatch for a while, this may be a good moment to start with a clean config by using Factory Reset in Maintenance.

This restores all default values and may significantly improve your experience.

✨ Highlights

• Scrobbler redesign: Watcher routes and webhooks now have separate management flows.
• Webhooks: Webhooks are now configured per media server profile. Same as Watcher routes
• Improved configuration: Sources, destinations, filters, and options are easier to understand and manage.
• Improved anime matching: Trakt’s absolute episode number can now be match the correct SIMKL episode

🔧 Fixes & Improvements

• Added: Dedicated management for creating, editing, enabling, and deleting Watcher routes.
• Added: Dedicated management for Plex, Jellyfin, and Emby webhooks.
• Fixed: Native anime episodes can now be matched using Trakt’s absolute episodes.
• Removed: Outdated Scrobbler UI logic, unused helpers, and obsolete styling.
• Updated: Container build configuration and project exclusions.
• Updated: Trakt adapter to v1.3, SIMKL adapter to v1.5.
• Updated: Release version to v0.10.2.

CrossWatch v0.10.1

Webhook handling changed heavily in this release.

If you use Plex, Jellyfin or Emby webhooks, please check your webhook URLs, tokens and profile/instance routing after upgrading.

SIMKL users should refresh their sync state from Maintenance after upgrading.

This rebuilds the local SIMKL history cache with the new anime/history mapping logic.

Highlights

• Webhooks extended: Plex, Jellyfin and Emby webhooks now also support SIMKL and MDBList.
• Jellyfin Quick Connect: Jellyfin can now authenticate with Quick Connect.
• Events extended: Events now track scrobble and rating activity, including usage statistics.
• SIMKL anime history: improved SIMKL anime history sync that uses anime episode numbering.
• Design updates: UI Settings has received an overhaul including Connections.

Fixes & Improvements

• Added: Profile-specific webhook URLs and tokens for Plex, Jellyfin and Emby instances.
• Added: Support for Jellyfin Quick Connect.
• Added: Per-route scrobble policy overrides for watched and force-stop thresholds.
• Added: Events statistics for sync runs, scrobbles and duration trends.
• Added: Events database boot check with startup status and repair/rebuild handling.
• Added: Friendly unresolved reason labels for sync diagnostics and Events views.
• Added: SIMKL anime history can translate existing native anime episode numbers back to source.
• Improved: Trakt scrobbling now avoids premature watched writes below the watched threshold.
• Improved: SIMKL and MDBList scrobble stops below the watched threshold are treated as pause/progress.
• Improved: Watchlist auto-removal now follows the watched threshold.
• Improved: Webhook events are now recorded with source method.
• Improved: Events grouping now handles scrobble/rating sessions and duplicate sink completions.
• Improved: Jellyfin and Emby history writes now report confirmed keys, detailed result rows and reasons.
• Improved: Jellyfin progress support now validates the server version before enabling.
• Improved: SIMKL history writes now use safer anime-specific retries for confirmed SIMKL anime only.
• Improved: SIMKL history diagnostics now preserve exact failure reasons instead of collapsing to generic apply failures.
• Improved: SIMKL anime retry now reports unmapped anime episodes as unresolved instead of silently counting them as skipped.
• Improved: SIMKL anime detection caches normal-show misses per batch to avoid slow repeated lookups.
• Improved: Recent History, Latest Ratings and Recent Scrobble widgets now merge provider-local IDs.
• Improved: Settings overview and Connections have clearer setup steps and modal restyling.
• Fixed: SIMKL history indexing no longer treats show-level timestamps as episode-level watched history.
• Fixed: SIMKL confirmation handling avoids confirming items on failed, malformed, ambiguous or incomplete responses.
• Fixed: Profile webhook requests now log mismatched profile/global tokens.
• Fixed: Event clearing can target a specific domain instead of always wiping all Events data.
• Fixed: Stabilized idle summary SSE connections with 15s polling.
• Fixed: Prevent stale watchlist preview cache when resetting CrossWatch.
• Fixed: Continuous config requests from status dots no longer poll too frequently.
• Removed: Ask AI widget/integration.
• Updated: Emby adapter to v2.0, Jellyfin adapter to v2.0, SIMKL adapter to v1.4.
• Updated: New patch release version v0.10.1.

CrossWatch v0.10.0

This release includes some big orchestrator and adapter changes, especially around sync planning, unresolved handling and blackbox behavior.

As always with a new minor release, it’s recommended to clean up your state files from the Maintenance tools after updating.

✨ Highlights

• Orchestrator reworked: Sync planning, apply handling, unresolved, blackbox promotion more consistant.
• Plex reworked: Plex now handles selected libraries, accepted writes, live confirmation, episode matching more reliably.
• Events viewer: New searchable (SQLite-backed) events for sync runs, item issues, unresolved items, etc.
• Issue visibility: Sync output now show clearer unresolved and blackboxed counts, with item-level reasons.

🔧 Fixes & Improvements

• Improved: Orchestrator now records clearer sync run outcomes, including errors, unresolved items, blackboxed items, etc.
• Improved: Orchestrator blackbox promotion now follows the configured promote_after rules (default=3)
• Improved: Orchestrator now keeps unresolved, blackboxed, and failed item handling separated.
• Improved: Orchestrator apply results now better distinguish accepted writes from confirmed provider state.
• Improved: Orchestrator snapshots refresh after accepted writes where needed, reducing stale comparison results.
• Improved: Events viewer now groups sync runs and related item threads.
• Improved: Analyzer readability and paging were cleaned up for large issue sets.
• Improved: Plex history matching now checks the selected library catalog.
• Improved: Plex history now supports better episode resolution for tracker-to-Plex writes.
• Improved: Plex history now preserves show titles for episode sync results.
• Improved: Plex cache handling now respects server, user, and library changes.
• Improved: Plex duration handling for movies and episodes.
• Added: Playing card episode time left when duration or TMDb runtime is available.
• Added: Unresolved item details after sync runs, only when unresolved items exist.
• Added: Blackboxed item counts in Events run summaries.
• Fixed: API errors no longer expose internal exception details.
• Fixed: Sync locking keeps buttons and pair actions disabled while a sync is running.
• Fixed: Plex Playback Progress removals are now cleared and verified before success.
• Fixed: Analyzer now matches Emby and Jellyfin history episodes by show, season, and episode.
• Fixed: Watcher now enforces the library whitelist on every event.
• Fixed: Latest Ratings widget now uses real rating timestamps (when available)
• Removed: Client-side sync log formatting.
• Updated: Plex adapter to v2.0, SIMKL to v1.3, and TRAKT to v1.2.
• Updated: New minor release version v0.10.0.

📚 updated WIKI

• Events:https://wiki.crosswatch.app/crosswatch/main-dashboard/tools/events

CrossWatch v0.9.26

I’m going to start migrating from JSON to SQLite, which will probably turn into one big horror show.
This is a major architectural change, but it is necessary to support CrossWatch’s future development.
For that reason, I’m already releasing v0.9.26, which includes several fixes and improvements before the migration work begins.

✨ Highlights

Jellyfin: the updated adapter require Jellyfin 10.9 or newer. Older Jellyfin versions are not supported anymore.
Jellyfin: Updated to current API routes with Jellyfin 10.9+ compatibility checks.
Playback Progress: faster and more accurate synchronization across Plex, Emby, and Jellyfin.

🔧 Fixes & Improvements

• Improved: Plex now retrieves complete progress directly from selected libraries
• Improved: Plex library whitelisting, pagination, duplicate selection, and Plex Home isolation remain fully supported.
• Improved: Duplicate media versions now select the newest and most accurate playback progress.
• Improved: Emby and Jellyfin query selected libraries individually and avoid unnecessary full-library scans.
• Improved: Active sessions, newer target progress, and watched items are no longer overwritten unexpectedly.
• Improved: Legacy null responses are handled safely while cached data prevents unnecessary full-library requests.
• Fixed: Pagination continues correctly when a page contains only duplicate items.
• Fixed: Clearing Plex progress now preserves the watched state.
• Fixed: Emby and Jellyfin episodes use series identifiers correctly instead of copying series IDs into episode IDs.
• Fixed: Failed SIMKL reads no longer become empty snapshots that could remove synced data.
• Added: Optional replay progress support for previously watched items.
• Changed: Updated CrossWatch to v0.9.26

CrossWatch v0.9.25

Huge update. This release introduces the new redesigned Sync Hub and other elements like the Now Playing experience.

✨ Highlights

• Sync Hub: Added live service, synchronization, application-health and update monitoring.
• Now Playing: Redesigned the live playback card with media information.
• Live Output: Redesigned Sync, Watcher and Debug output with structured, theme-aware live logs.
• Playback Progress: Added server- and pair-level library whitelisting for Plex, Emby and Jellyfin.
• PublicMetaDB: Added optional TMDb title and release-year enrichment.
• Performance: Optimized startup for slower devices.

🔧 Fixes & Improvements

• Improved: Live output now includes provider labels, severity levels, timestamps and readable copied logs.
• Improved: Bounded live-log rendering keeps the interface responsive during high-volume output.
• Improved: Faster Watchlist loading, dashboard counters, episode artwork and source-profile labels.
• Improved: Playback Progress indexing and target resolution now respect whitelistings.
• Improved: Plex progress synchronization avoids self-writes and protects currently playing,.
• Improved: Redesigned Maintenance with better cleanup, action summaries and capture management.
• Improved: Added persistent TMDb metadata caching.
• Fixed: Emby and Jellyfin episodes now resolve through exact provider IDs even when season or episode numbering differs.
• Fixed: Season-zero special episodes now sync and reconcile correctly across providers, including two-way pairs.
• Fixed: Plex webhooks now recover missing playback progress and duration from active sessions.
• Fixed: Playback Progress correctly handles profiles, live records, artwork and Trakt image URLs.
• Fixed: Playback Progress only combines matching profiles within a two-point progress tolerance.
• Fixed: Persistent metadata cache paths are handled safely across local and container environments.
• Fixed: Improved Analyzer accuracy and performance for large sync states.
• Fixed: Unraid runtime UID/GID mappings are handled correctly.
• Changed: included API token in the Authorization header for Jellyfin-compatible servers
• Changed: Updated CrossWatch to v0.9.25, PublicMetaDB to v0.3, Plex adapter to v1.2, and Emby and Jellyfin adapters to v1.1.

CrossWatch v0.9.24

✨ Highlights

Dashboard: Add three new configurable widgets: recent history, ratings and scrobble.

Plex shared-user support: Plex friend/shared users can now sync supported server-side state through shared-server tokens.

Playback Progress refresh: Provider data now refreshes automatically after the cache window.

Playback Progress live state: Plex, Emby, and Jellyfin cards can now show live watcher/webhook state such as Playing now.

SIMKL anime movie handling: SIMKL anime movies with episode-style progress now stay as movie records.

Debug output: Added a new Debug tab to the sync output.

🔧 Fixes & Improvements

Fixed: watchlist preview leaking onto other pages

Fixed: SIMKL history could import anime movies as S01E01 episode records.

Fixed: TMDB movie IDs are no longer treated as TV-show parent IDs during episode-key planning.

Fixed: Playback Progress could keep showing stale provider data until the refresh icon was clicked.

Improved: Grouped same-source Recent Activity scrobble entries into one card

Improved: Playback Progress now overlays media-server watcher/webhook live state on matching progress records.

Improved: SIMKL health checks now use the same request path and required URL parameters as normal SIMKL sync calls.

Improved: SIMKL watchlist, ratings, and history calls now consistently include client_id, app-name, and app-version.

Improved: SIMKL history writes now preserve returned media classification such as simkl_type, anime_type, and status.

Changed: Updated the version to v0.9.24.

📚 updated WIKI

Dashboard widgets: https://wiki.crosswatch.app/crosswatch/navigation/main-dashboard-widgets

CrossWatch v0.9.23

This release introduces several new experimental features, including the Playback Progress Manager and Backup & Restore.

Playback progress can now be synchronized across supported trackers and media servers.

Configuration and local state can now be backed up manually or through scheduled background backups.

The release also includes authentication improvements, stricter Plex user handling, clearer error reporting, and several reliability fixes.

✨ Highlights

• Playback Progress: Added a new Playback Progress workflow to manage progress across supported trackers/media servers.
• Backup & Restore: Added a new Backup & Restore workflow for CrossWatch configuration and local state.
• Scheduled backups: Backups can now be scheduled to run automatically in the background.

🔧 Fixes & Improvements

• Improved: Playback Progress now supports provider/profile selection and slow-provider timeout handling.
• Improved: Added Playback Progress support for Trakt, SIMKL, MDBList, PublicMetaDB, Plex, Emby, and Jellyfin.
• Improved: Upgrade backups now use the new backup system where possible.
• Improved: TMDb Sync now handles saved/masked keys more reliably and shows clearer connection errors.
• Improved: Plex friend/shared users now show a warning when selected.
• Fixed: Plex selected-user scope failures no longer silently fall back to the token owner’s watchlist, ratings, or progress data.
• Fixed: Plex PIN auth no longer logs clipboard errors when the browser focus moves to Plex.
• Changed: TMDb Sync Session ID is now read-only because it is created automatically after approval.
• Changed: Added real TMDb API key checks for metadata and improved TMDb Sync authentication feedback.
• Changed: Updated the version to v0.9.23.

📚 updated WIKI

• Playback Progress: https://wiki.crosswatch.app/crosswatch/navigation/playback
• Backup & Restore: https://wiki.crosswatch.app/crosswatch/maintenance/backup-and-restore

CrossWatch v0.9.22

This update is mainly an AniList and anime matching update.

AniList can now sync ratings and anime matches can use a local AniBridge-powered ID mapping database instead of relying only on title search. This makes AniList watchlist and ratings sync more reliable when syncing from Plex, Emby, Jellyfin, and other providers.

This release also adds a new theme selector, with Flat dark now used as the new (and default) CrossWatch look.

✨ Highlights

• AniList ratings sync: AniList now supports ratings sync.
• Anime ID Mapping: Added anime ID mapping (powered AniBridge) for better AniList matching across providers.
• Local mapping database: Added update, rebuild index, status, and daily background update for Anime ID Mapping database.
• Per-pair AniList controls: Added Anime ID Mapping and Anime-only sync options for AniList watchlist and ratings pairs.
• Anime-only sync: AniList targets can now skip non-anime and unmapped items before falling back to AniList title search.
• Themes: Added Flat dark, Flat light, and Original theme options. Flat dark is now the default.
• Simplified authentication: Some provider authentication flows are now easier to configure.

🔧 Fixes & Improvements

• Improved: AniList watchlist and ratings items can be enriched with mapped TMDb, TVDb, IMDb, MAL, AniDB before syncing.
• Improved: Providers can use Anime ID Mapping per AniList watchlist or ratings pair instead of relying only on title search.
• Improved: AniList sync now reports skipped non-anime items separately from unresolved matching errors..
• Fixed: Docker runtime UID/GID remapping now works correctly with APP_UID, APP_GID, APP_USER, and APP_GROUP.
• Fixed: SIMKL history sync now includes include_all_episodes=yes when fetching /sync/all-items.
• Changed: Provider auth profiles and credentials validation are now centralized.
• Changed: Updated the version to v0.9.22.

📚 updated WIKI

https://wiki.crosswatch.app/crosswatch/providers/synchronization/adapter-anilist

https://wiki.crosswatch.app/crosswatch/providers/metadata-id-mapping/anime-id-mapping

https://wiki.crosswatch.app/crosswatch/navigation/ui-settings/user-interface#theme-1

https://wiki.crosswatch.app/crosswatch/configure-pairs/anilist-pair-options

CrossWatch v0.9.21

Because security is a top priority for CrossWatch, this release is being released earlier than planned to address an issue in the authentication status endpoint. It also adds Recent Activity and new authentication method for MDBList Device Code authentication this is the new default.

✨ Highlights

• Added: Recent Activity dashboard widget for recently scrobbled movies and episodes.
• Added: “View all” activity history with search and filters.
• Added: Activity method labels so entries show whether they came from Watcher, Webhook, or failed activity.
• Added: Provider/profile details in the full activity history view to make multi-profile setups easier to audit.
• Added: UI setting to show or hide Recent Activity. Default is enabled.
• Added: UI settings to choose how many Recent Activity and Recent Sync rows appear on the dashboard.
• Added: Maintenance action for clearing the local activity log.
• Added: MDBList Device Code authentication as the preferred connection method.
• Added: MDBList API key mode remains available for existing and legacy setups.

🔒 Security

• Fixed: /api/app-auth/status no longer exposes active session metadata to unauthenticated clients.
• Fixed: Unauthenticated clients can no longer enumerate session IP addresses, User-Agent strings, internal session IDs, or session timestamps.
• Hardened: POST /api/maintenance/reset-all-default is no longer reachable through an unauthenticated setup-lock bypass.
• Hardened: Legacy clean-reset recovery now requires setup credentials first, then runs through an authenticated session.
• Hardened: Unauthenticated /api/config/meta responses no longer include local filesystem details such as config path, file size, or modification time.

🔧 Fixes & Improvements

• Changed: Updated the version to v0.9.21.

CrossWatch v0.9.20

This release adds a new sync provider: PublicMetaDB and improvements for the export tool.

Exports are now more flexible, clearer to configure, and better aligned with the native import formats of supported platforms.

This release also improves scrobbling flexibility by allowing Webhooks and Watcher to be enabled together.

✨ Highlights

• Added: PublicMetaDB provider support with watchlist, history, progression and ratings support [experimental]
• Added: hybrid scrobbling support by allowing Webhooks and Watcher to be enabled at the same time.
• Added: Server UUID allowlist and blacklist filtering for Plex Webhooks and Watcher routes.
• Added: Exporter - media type filtering for Movies, Shows, Seasons, and Episodes. Movies remain enabled by default.
• Added: Exporter - new History and Ratings export option, allowing both to be exported together in one pass where supported.
• Added: Exporter - WatchedDate support for Letterboxd exports, enabled by default.

🔧 Fixes & Improvements

• Fixed: MDBList watchlist add/remove payloads now preserve MDBList item IDs when available.
• Fixed: Plex library whitelist selection no longer rehydrates repeatedly from unrelated UI updates.
• Fixed: Plex, Jellyfin, and Emby whitelist library headers now align with the History, Ratings, and Scrobble row toggles.
• Fixed: Mandatory sign-in setup can no longer be bypassed from a fresh browser session.
• Improved: The Scrobbler UI now supports independent Webhook and Watcher toggles.
• Improved: Scrobbler status now shows Webhook and Watcher separately when both are enabled.
• Improved: Plex scrobbler filters now also includes Server UUID blacklistings and multiple servers.
• Improved: The exporter layout is more compact, with media type filters moved into the lower action row.
• Improved: Export previews now better reflect what will actually be exportable for the selected format and filters.
• Improved: Yamtrack exports now use Yamtrack’s native CSV format instead of the previous simplified export.
• Changed: Updated the version to v0.9.20.

Note: PublicMetaDB is still in an experimental phase. The recommended flow is from media server to PublicMetaDB, one way.

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