> For the complete documentation index, see [llms.txt](https://wiki.crosswatch.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.crosswatch.app/related-information/release-notes/version-0.10.md). # Version 0.10 ## Release 0.10.0 * Tag: `v0.10.0` This release reworks the orchestrator and Plex adapter. Sync planning, unresolved handling, and blackbox behavior are more reliable. {% hint style="warning" %} After upgrading, use [Maintenance](/crosswatch/settings/maintenance.md) to clean up state files. This is recommended for every new minor release. {% endhint %} ### Highlights * **Orchestrator reworked** * Sync planning, apply handling, unresolved items, and blackbox promotion are more consistent. * **Plex reworked** * Selected libraries, accepted writes, live confirmation, and episode matching are more reliable. * **Events viewer** * Search SQLite-backed events for sync runs, item issues, and unresolved items. * Guide: [Events](/crosswatch/main-dashboard/tools/events.md) * **Clearer issue visibility** * Sync output shows unresolved and blackboxed counts with item-level reasons. ### Fixes & improvements * **Orchestrator** * Records clearer sync-run outcomes, including errors, unresolved items, and blackboxed items. * Promotes items to the blackbox using `promote_after` rules. The default is `3`. * Keeps unresolved, blackboxed, and failed-item handling separate. * Distinguishes accepted writes from confirmed provider state. * Refreshes snapshots after accepted writes when needed. This reduces stale comparisons. * **Events and Analyzer** * Events groups sync runs with related item threads. * Run summaries include blackboxed item counts. * Analyzer readability and pagination now work better for large issue sets. * Unresolved-item details appear after a sync run when needed. * **Plex** * History matching checks the selected library catalog. * Tracker-to-Plex writes resolve episodes more reliably. * History results retain show titles for episodes. * Cache handling respects server, user, and library changes. * Movie and episode duration handling is more accurate. * Playback Progress removals clear and verify before reporting success. * **Watcher and dashboard** * Watcher enforces the library whitelist for every event. * The Playing Card shows episode time remaining when duration data exists. * Latest Ratings uses real rating timestamps when available. * **Reliability and security** * Sync locking disables buttons and pair actions during a sync. * API errors no longer expose internal exception details. * Emby and Jellyfin history episodes match by show, season, and episode. * Client-side sync-log formatting is removed. ### Adapter versions * Plex: `v2.0` * SIMKL: `v1.3` * Trakt: `v1.2` ## Release 0.10.3 * Tag: `v0.10.3` This release adds very early experimental playlist synchronization. Do not use playlist sync in production yet. SIMKL and Trakt history adapters were redesigned. Episode mappings now cover every episode. Anime and split-show matching works more reliably between SIMKL and Trakt. {% hint style="warning" %} If you use SIMKL or Trakt history, clear the cache first. Then run **Maintenance → Sync**. Most anime specials cannot match reliably. SIMKL and Trakt number or group them differently. Treat specials as tracker-specific. {% endhint %} Metadata resolution now supports anime more reliably. If artwork or metadata is incorrect, run **Maintenance → Reports & Metadata → Refresh artwork & metadata**. Clear your browser cache if issues persist. ### Highlights * **Playlists** * Experimental playlist synchronization supports endpoints and mapping profiles. * **SIMKL and Trakt** * History sync preserves destination episode mappings. * It merges equivalent episodes. * **Customizable Sync Hub** * Enable, disable, move, and resize sync blocks. * **Quick Add** * A redesigned, step-based wizard guides new items. * **Library whitelisting** * Plex, Emby, and Jellyfin whitelisting is redesigned. ### Fixes & improvements * **Connection profiles** * Profiles require a successful connection before saving. * Empty profiles are removed automatically. * **Analyzer** * History aliases are recognized. * Current mismatches are separated from pending retries. * **SIMKL and Trakt** * SIMKL anime movies in watchlists and ratings no longer appear as shows. * Trakt watchlist limits use the account limit supplied by Trakt. * **Networking** * Webhook and Plex Watcher URLs use `https` behind TLS reverse proxies. * **Removed** * The legacy Plex user picker. * The Android companion app and mobile API. ### Adapter versions * Trakt: `v1.4` * Plex: `v2.1` * MDBList: `v1.2` * SIMKL: `v1.6` ## Release 0.10.4 * Tag: `v0.10.4` This release improves the dashboard, Playback Progress settings, Editor, and CW Tracker archive handling. Hard-refresh your browser if you encounter issues. ### Highlights * **Customizable dashboard** * Dashboard widgets have updated styles and adjustable layouts. * **Editor** * A local Tracker workspace supports imported-item blocking and manual corrections. * Corrections prevent future syncs from overwriting changes. ### Fixes & improvements * **Recent Progress** * Uses sync-progress activity instead of live playback-progress endpoints. * **Dashboard widgets** * Watchlist Preview is now a resizable, reorderable, hideable dashboard widget. * Hidden widgets stop fetching data. * Sync Hub layout controls can restore hidden widgets. * **Playback Progress** * Provider selection supports multi-profile providers with counters. * Settings use the same provider-card experience as Insights Settings. * Disconnected providers remain hidden instead of displaying disabled cards. * **Editor** * Displays 100 rows per page. * The grid uses the full available height. * Baseline rows use a clearer block icon. * **CW Tracker archives** * Download ZIP and Import file actions appear before the cleanup **Run** button. * Download ZIP and Import file no longer trigger cleanup. * **Fixes** * Manual Editor blocks now apply correctly in the Analyzer. * This includes per-profile providers. * Watcher default controls now include watched thresholds. * Trakt history entries without watch dates are retained. ## Release 0.10.5 * Tag: `v0.10.5` This release adds Nuvio, the first provider in the new Media Clients category. ### Highlights * **Nuvio** * Nuvio is available as an experimental media client provider. * The adapter version is `v0.2`. * It supports watchlist, history, and playback-progress sync. * **PublicMetaDB** * PublicMetaDB support is promoted to adapter version `v1.0`. ### Fixes & improvements * **Provider discovery** * Sync provider discovery now uses the shared module registry. * **Playback Progress** * Visible warnings appear when provider profiles cannot refresh. * **Editor** * A row-details modal shows stored raw fields. * Refresh reloads Current State, Local Tracker, and playlists from the selected source. * Manual corrections work for editable Extra fields in Current State and Local Tracker. * **SIMKL** * Pro and VIP status appear in probes. * **PublicMetaDB** * Custom playlist creation sends the documented custom value. * Authentication health checks handle live API `401` responses. * **Emby and Jellyfin** * Scrobbling now sends stop events after whitelist matches. ### Adapter versions * Nuvio: `v0.2` * PublicMetaDB: `v1.0` ### Documentation * [Connect Nuvio](https://wiki.crosswatch.app/crosswatch/settings/connections/media-clients/nuvio) * [Synchronize Nuvio](https://wiki.crosswatch.app/crosswatch/settings/synchronization/media-clients/nuvio) ## Release 0.10.6 * Tag: `v0.10.6` This release expands playback-progress synchronization to trackers and refreshes key UI surfaces. ### Highlights * **Tracker progress sync** * Trakt, SIMKL, and MDBList now support playback-progress synchronization. * **UI refresh** * Captures has a redesigned interface. * Settings and main-page banners have been redesigned. ### Fixes & improvements * **Trakt** * Supports reading, updating, and removing playback progress. * **SIMKL** * Supports reading, updating, and removing playback progress. * Valid percent-only progress items no longer get skipped during sync to CrossWatch. * **MDBList** * Supports reading, updating, and clearing playback progress. * **Plex** * Provider Cleanup now supports clearing playback progress. * Plex Watcher rejects drop-alert log entries. * **Nuvio** * Connections can save when multiple profiles exist. * **Maintenance** * Capture cleanup tools are replaced by the Provider Cleanup modal. ### Adapter versions * MDBList: `v1.3` * SIMKL: `v1.7` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://wiki.crosswatch.app/related-information/release-notes/version-0.10.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.