CrossWatch Documentation

CrossWatch (CW) is a synchronization engine designed to keep multiple media platforms in sync. It acts as a central 'brain' for your media metadata, allowing you to manage watchlists, ratings, history, and playback progress across various providers.

Key Capabilities

• Synchronization: Syncs Watchlists, Ratings, History, and Progress across supported providers.
• Multi-Provider Support: Works with Plex, Jellyfin, Emby, SIMKL, Floppy, Trakt, AniList, TMDb, MDBList, PublicMetaDB, Tautulli, Kodi, Nuvio, Stremio, and the CW local tracker.
• Scrobbling: Tracks activity via a Watcher (Plex/Emby/Jellyfin/Kodi to Trakt/SIMKL/MDBList/Floppy/CW) or via Webhooks (Plex/Emby/Jellyfin to Trakt/SIMKL/MDBList).
• Profiles: Manage separate sync setups for different users or media servers.
• Data Safety: The CW Tracker maintains snapshots and backups of your media server and tracker data.

Built-in Tools

• Analyzer: Identifies items that are stuck or inconsistent between providers.
• Playback Progress Manager: View and edit unfinished playback sessions.
• Editor: Inspect, adjust, add, or block items.
• Events Viewer: Search and inspect sync run history.
• Captures: A rollback tool for provider watchlists, ratings, and history.

CrossWatch (CW) is a media sync hub designed to keep media servers, media clients, and trackers synchronized through a single local web UI. It acts as a control room for your media state, allowing you to manage accounts, profiles, sync pairs, schedules, snapshots, scrobbling routes, and repair tools.

Key Features:

• Sync: Aligns watchlists, ratings, history, and playback progress across providers.
• Hub: Supports multiple profiles to separate sync setups for different users or servers.
• Live (Watcher & Webhooks): Routes play events from Plex, Emby, Jellyfin, and Kodi to trackers like Trakt, SIMKL, or MDBList. Webhooks support Plex, Emby, and Jellyfin without requiring premium passes.
• Safe: Provides snapshots and captures to compare changes and restore data.
• Tools: Includes an analyzer, editor, and event inspector to manage records and clean up provider state.
• Anime Support: Uses AniBridge for clean anime ID mapping across providers.

Use the mount function to render the raw editor modal, which displays a flattened view of an item's fields alongside its raw JSON representation. This is useful for inspecting the data structure of items in CrossWatch.

Parameters

• shell: The DOM element (container) where the modal should be rendered.
• props: An object containing the data to display:
  • item (Object): The data object to inspect. If null or not an object, an empty state is shown.
  • title (String): The title displayed in the modal header. Defaults to item.title, item.series_title, or props.key.
  • source (String): Determines the source label. 'tracker' becomes Local Tracker, 'state' becomes Current State, otherwise defaults to Editor.
  • kind (String): An optional label displayed next to the source (e.g., Source - Kind).
  • key (String): An optional identifier displayed as a chip in the metadata section.
  • origin (String): An optional origin identifier displayed as a chip.

Behavior

• The component automatically handles HTML escaping for security.
• It includes a 'Copy JSON' button that uses the navigator.clipboard API.
• The close button triggers window.cxCloseModal() when clicked.

import { mount } from './path/to/assets/js/modals/editor-raw/index.js';

const shell = document.getElementById('modal-container');
const props = {
  item: { id: 1, name: 'Test Item', metadata: { color: 'blue' } },
  title: 'My Item',
  source: 'tracker',
  kind: 'debug',
  key: 'item_001'
};

await mount(shell, props);