Interactive Sync
Review a sync plan, resolve conflicts, and apply only selected changes.
Interactive Sync lets you review a sync pair before CrossWatch applies changes to your providers.
CrossWatch reads the configured providers and builds a sync plan. You can review additions, updates, removals, conflicts, and items needing attention. Only selected changes are applied.
Start an Interactive Sync
Open Settings and go to Synchronization.
Find the sync pair you want to run.
Select Run.
CrossWatch prepares the review: Connect, Read providers, Build plan, then Prepare review.
Review the proposed changes when the plan is ready.
The review shows the source and target providers. It also shows whether the pair is One-way or Two-way.
Review the sync plan
The review shows four counters:
Proposed changes
Total additions, updates, and removals found by CrossWatch.
Selected
Changes currently selected for application.
Conflicts to review
Values that need a provider choice.
Need attention
Items CrossWatch could not resolve automatically, or that are blocked.
Each proposed change shows its item, feature, action, and review status.
Possible results are:
Add — adds the item to the destination.
Update — changes an existing value.
Remove — removes the item from the destination.
Needs attention — CrossWatch could not safely resolve the item.
Blocked — CrossWatch cannot currently apply the proposed change.
Conflict — both providers have a value and CrossWatch needs your decision.
CrossWatch selects actionable changes where possible. Items needing attention are not selected automatically.
Review removals carefully, especially after changing pair settings, provider accounts, or mappings.
Find and select changes
Use the review controls to narrow a larger plan. You can:
Search by title or ID.
Filter by feature or result.
Use Select filtered or Deselect filtered.
Select or clear individual changes.
Only selected proposals are applied in this run. Deselecting a proposal excludes it only from the current apply operation.
Resolve conflicts
A conflict appears when both sides have different values and CrossWatch cannot choose automatically.
For each conflict, choose the provider value CrossWatch should use. For example, select Use Trakt or Use SIMKL, depending on the pair.
CrossWatch updates the review after you decide.
Conflict choices apply to the values you reviewed. If provider data changes before application, CrossWatch does not reuse an outdated choice. It checks the plan again before writing provider changes.
Correct a mapping
If CrossWatch matched the wrong title, season, episode, or provider ID, correct the mapping from Interactive Sync.
Select Mapping for an eligible addition or update. Use Edit selected to work through multiple selected items.
In the mapping editor, you can:
Search for the correct title when a catalog is configured.
Use automatic matching where available.
Correct titles, season and episode numbers, or episode numbering.
Enter provider IDs under Advanced Manual IDs.
Mappings can use either scope:
This sync pair
Applies the correction only to the current pair.
All pairs using this provider instance
Shares the correction with every pair using that provider instance.
A pair-specific mapping takes precedence over a shared correction for that pair.
Saved mappings persist and can be reused by future syncs. Saving a mapping does not start a sync. CrossWatch recalculates the current review so you can inspect the corrected result.
Refresh the plan
Use Refresh plan when provider data or sync settings change while the review is open.
CrossWatch reads the providers again and rebuilds the plan. Existing selections remain where they match the same proposed changes.
Refreshing the plan does not write changes to your providers.
Apply selected changes
When the review is correct:
Check the selected-change count.
Resolve any conflicts you want included.
Review items marked Needs attention or Blocked.
Select Apply selected (N).
CrossWatch checks the providers again. It also validates that the reviewed plan remains current.
If settings, mappings, or provider data changed, CrossWatch stops the operation and returns you to an updated review. It does not apply anything from the outdated plan.
If checks succeed, CrossWatch applies only selected proposals.
After the apply phase starts, successfully written changes are not rolled back if the operation is cancelled or interrupted.
Review the result
After applying changes, Interactive Sync shows a run report.
The report includes counts for:
Added, updated, and removed.
Skipped, unresolved, and blocked.
Errors.
You can also review results by feature and destination, provider notices, and items still needing attention. Provider activity is available in Events.
Use Download JSON to retain the detailed result outside the current review session.
No changes proposed
If CrossWatch finds no media changes, there is nothing to select or apply.
For a normal sync, CrossWatch can still complete required bookkeeping and save the current baseline. It does not add, update, or remove provider media.
Resume or close a review
You do not need to finish a review immediately.
Reopen pending reviews from Synchronization or Notifications. Status shows whether CrossWatch is preparing, awaiting review, applying, finished, or needs attention.
Open reviews remain available for one hour of inactivity. They also close when you close them or CrossWatch restarts.
Select Close review when you no longer need the session. Closing a review does not apply remaining proposals.
Interactive Sync and Selective Sync
Interactive Sync and Selective Sync serve different workflows.
Starting point
A configured sync pair.
Selected items in the Editor.
Purpose
Review a complete sync plan before applying it.
Send specific items to another provider.
Changes reviewed
Additions, updates, and removals.
Items you explicitly selected.
Conflict review
Yes.
Not the primary workflow.
Mapping correction
Available for eligible review changes.
Managed through the Editor workflow.
Use Interactive Sync to inspect a configured pair before it writes changes. Use Editor when you know which Editor items to send.
Common issues
An item shows Needs attention
CrossWatch could not safely resolve the proposal. Check the title and provider IDs. For eligible additions and updates, use Mapping to correct the match and recalculate the review.
An item is Blocked
Check the notice in the review. A provider might be unavailable. Required data might be missing. An existing sync protection might prevent the operation.
Interactive Sync does not bypass configured sync protections.
Apply returned me to the review
CrossWatch detected that the reviewed plan was no longer current. Provider data, pair settings, or mappings may have changed between review and application.
Review the updated plan, then apply it when correct.
Mapping is not available
You cannot open Mapping for removals or playlists. It is available for eligible additions and updates.
My review disappeared
Interactive Sync sessions are temporary. Open reviews remain available for one hour of inactivity. CrossWatch also clears them when it restarts.
Next steps
Last updated
Was this helpful?