Connect at least one media server first.

Plekt can then import current watched state and begin recording playback events.

Add the other services once the first connection is healthy.

Service guides

Media servers

Plekt Media servers settings showing Plex, Emby, and Jellyfin connection cards
Media server cards keep account setup, manual fallback, testing, and enablement together.
Service What Plekt uses it for Inbound events
Plex Library state, playback, watch history, artwork context, and playlists Built-in WebSocket notification channel and scheduled checks
Emby Library state, playback, watch history, resume progress, and playlists Webhooks plus polling
Jellyfin Library state, playback, watch history, resume progress, and playlists Plekt plugin or Webhooks plugin, plus polling

The server running Plekt must reach each configured URL.

Playlists can sync two ways with any of the three servers, chosen per playlist. Automatic playlists are sent one way, from Plekt to the apps.

The Plex, Jellyfin, and Trakt account connection flows also work when Plekt is opened by a plain HTTP address on your local network.

Shows or films that share a title are kept apart by their TMDB, TVDB, and IMDb ids. When two Plex shows share a title, Plekt uses the one whose ids match, including a show Plex titles with a country tag such as The Assembly (UK). When a title alone cannot tell two items apart on Emby or Jellyfin, Plekt skips that server instead of writing to both; a title with a year such as Scrubs (2026) finds only that show.

When a browser test succeeds but background sync does not move, test the same hostname, port, and protocol from the Plekt host.

The connection checklist

Plekt Sync Activity showing destination results after a connection check
A connection is proven by a small real event and its visible destination result.

For every integration:

  1. Open the matching group in Settings.
  2. Enter the URL, credentials, key, or token requested by that provider.
  3. Save and wait for the connection test to finish.
  4. Confirm the server/library or provider status is healthy.
  5. Import or refresh only after the connection test succeeds.
  6. Make one small change and verify it in Sync Activity.

Keep the first test narrow.

It is easier to identify a bad URL or unmatched item before a large import fills the activity log.

Private-list and rating sync

Personal Rating Sync is optional and uses the authenticated Plex, Emby, Jellyfin, and Trakt accounts for two-way rating reconciliation. Plekt remains the conflict authority, and provider outages do not change local ratings or watched state.

Plex Watchlist Sync is a separate optional toggle. Its first pass safely unions Plekt’s canonical movie/show Watchlist with Plex’s account Watchlist; later complete snapshots reconcile changes. Emby and Jellyfin do not offer an equivalent account-level watchlist, so their old watchlist projections are not supported.

See Watchlist, Ratings, and Settings → Sync → Personal Rating Sync for recovery and queue details.

Verify a connection without guessing

After any integration change, create one known test:

  1. Use a title that is already present in the local library.
  2. Make one watched, unwatched, or resume change from the source.
  3. Wait for the webhook or polling interval.
  4. Open Sync Activity.
  5. Read each destination result and follow the matching troubleshooting link if it is skipped or failed.

Continue with the sync model or open Settings.