Syncing

Align watchlists, history, and ratings between services. Start with one-way + one feature + dry run, then scale up.

Syncing aligns watchlists, history, and ratings between services. Start small. Scale up after the first clean run.

circle-exclamation

1) Connect authentication providers

Open Settings → Authentication. Connect only what you need.

Start with:

  • One media server: Plex, Jellyfin, or Emby

  • One tracker: Trakt, SIMKL, MDBList, etc.

Click the red Save button.

Related: Authentication

2) Create one pair

Open Settings → Pairs. Create one pair first.

Use the safest setup. Keep defaults unless you know why you’re changing them.

circle-info

Golden rule: start one-way, with one feature enabled.

Recommended first run

  • Mode: One-way

  • Feature: enable one

    • Watchlist

    • Ratings

    • History

  • Source: your media server

  • Target: your tracker

circle-exclamation

Keep Dry run enabled at first. It previews the plan without writing changes.

Click the red Save button.

Related: Configure Pairs

Open Settings → Metadata. Add TMDb (API key).

This improves matching. It also reduces missing peers.

Click the red Save button.

Related: Metadata

4) Run a sync

Run a sync. Review results. Fix matching issues. Repeat.

Use these tools when something looks off:

  • Analyzer for missing peers and mismatches

  • Editor for overrides, blocks, and cleanup

circle-check

Summary

Syncing aligns watchlists, history, and ratings between providers.

Start with one-way + one feature + dry run.

Add TMDb early to avoid bad matches.

Next steps

Last updated