> 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/getting-started/support-matrix/providers.md).

# Providers

This section shows provider support for sync, watchlists, ratings, history, progress, and setup.

{% hint style="success" %}
Best first pair:

* source: Plex, Jellyfin, or Emby
* target: Trakt, SIMKL, MDBList, or PublicMetaDB
* mode: one-way
  {% endhint %}

{% hint style="warning" %}
Jellyfin and Emby do not have a native watchlist.

CrossWatch maps watchlists to Favorites, Playlists, or Collections.
{% endhint %}

{% hint style="info" %}
Tautulli is read-only.

Use it only as a history source.
{% endhint %}

### Use this page for quick checks

* Which providers can act as sources or targets
* Which features each provider supports
* Which entity types each feature can handle
* Which auth and connection methods each provider uses

### Provider overview

#### Provider roles

| Provider         | Category        |                                          Pair source |                                          Pair target |                                       Named profiles |
| ---------------- | --------------- | ---------------------------------------------------: | ---------------------------------------------------: | ---------------------------------------------------: |
| Emby             | Media server    | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |
| Jellyfin         | Media server    | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |
| Plex             | Media server    | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |
| Kodi             | Media client    | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |
| Nuvio            | Media client    | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |
| Stremio          | Media client    | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |
| AniList          | Anime tracker   | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |
| Floppy           | Tracker         | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |
| MDBList          | Tracker         | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |
| PublicMetaDB     | Tracker         | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |
| PunchPlay        | Tracker         | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |
| Scrob            | Tracker         | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |
| SIMKL            | Tracker         | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |
| TMDb             | Tracker         | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |
| Trakt            | Tracker         | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |
| CrossWatch local | Local tracker   | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |                                          Local state |
| Tautulli         | Plex monitoring |                                          Source only |   <i class="fa-xmark" style="color:red;">:xmark:</i> | <i class="fa-check" style="color:green;">:check:</i> |

#### Sync feature support

| Provider         |                                       Watchlist sync |                                         Ratings sync |                                         History sync |                                        Progress sync |
| ---------------- | ---------------------------------------------------: | ---------------------------------------------------: | ---------------------------------------------------: | ---------------------------------------------------: |
| CrossWatch local | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |
| Plex             | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |
| Jellyfin         |                                              Limited |   <i class="fa-xmark" style="color:red;">:xmark:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |
| Emby             |                                              Limited |   <i class="fa-xmark" style="color:red;">:xmark:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |
| Floppy           | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |
| Nuvio            | <i class="fa-check" style="color:green;">:check:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |
| Kodi             |   <i class="fa-xmark" style="color:red;">:xmark:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |
| Stremio          | <i class="fa-check" style="color:green;">:check:</i> |                                          Target only | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |
| Trakt            | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |
| SIMKL            | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |
| MDBList          | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |
| PublicMetaDB     | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |
| PunchPlay        | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |
| Scrob            | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |
| AniList          |                                              Limited |                                              Limited |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |
| TMDb             | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |
| Tautulli         |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |                                          Source only |   <i class="fa-xmark" style="color:red;">:xmark:</i> |

#### Real-time and manager support

| Provider         |                                     Progress Manager |                                       Watcher source |                                       Webhook source |                                         Watcher sink |                                         Webhook sink |
| ---------------- | ---------------------------------------------------: | ---------------------------------------------------: | ---------------------------------------------------: | ---------------------------------------------------: | ---------------------------------------------------: |
| CrossWatch local |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |
| Plex             | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |
| Jellyfin         | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |
| Emby             | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |
| Floppy           |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |
| Nuvio            |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |
| Kodi             | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |
| Stremio          |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |
| Trakt            | <i class="fa-check" style="color:green;">:check:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |
| SIMKL            | <i class="fa-check" style="color:green;">:check:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> | <i class="fa-check" style="color:green;">:check:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |
| MDBList          | <i class="fa-check" style="color:green;">:check:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> | <i class="fa-check" style="color:green;">:check:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |
| PublicMetaDB     | <i class="fa-check" style="color:green;">:check:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |
| PunchPlay        |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> | <i class="fa-check" style="color:green;">:check:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |
| Scrob            |   <i class="fa-xmark" style="color:red;">:xmark:</i> | <i class="fa-check" style="color:green;">:check:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> |
| AniList          |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |
| TMDb             |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |
| Tautulli         |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> |

#### Notes

* Jellyfin and Emby have no native watchlist.
* Jellyfin and Emby Playlist mode is episode-only.
* Jellyfin and Emby ratings sync is disabled.
* Floppy is experimental. It supports watchlist, ratings, and history only.
* Nuvio is experimental. It supports watchlist, history, and progress only.
* PunchPlay is experimental. It supports watchlist, ratings, history, progress, and Watcher.
* Scrob is experimental. It supports sync, rewatches, and Watcher routes.
* Kodi is experimental. It supports ratings, history, progress, and Watcher only.
* Stremio is experimental. Ratings can sync to Stremio only.
* AniList supports anime watchlist and ratings only.
* Tautulli is read-only and history-only.
* Playlist sync is not a CrossWatch feature.
* Trakt, SIMKL, and MDBList support Progress Manager, not normal `progress` sync.
* PublicMetaDB supports both normal `progress` sync and Progress Manager.

### Provider entity support

#### Entity coverage

| Provider         | Watchlist entities               | Rating entities                  | History entities                      | Progress entities                |
| ---------------- | -------------------------------- | -------------------------------- | ------------------------------------- | -------------------------------- |
| CrossWatch local | Movies, shows, seasons, episodes | Movies, shows, seasons, episodes | Movies, shows, seasons, episodes      | Movies, shows, seasons, episodes |
| Plex             | Movies, shows                    | Movies, shows, seasons, episodes | Movies, episodes                      | Movies, episodes                 |
| Jellyfin         | Movies, shows, library items     | Not supported                    | Movies, episodes                      | Movies, episodes                 |
| Emby             | Movies, shows, library items     | Not supported                    | Movies, episodes                      | Movies, episodes                 |
| Floppy           | Movies, shows                    | Movies, shows                    | Movies, episodes                      | Not supported                    |
| Nuvio            | Movies, shows                    | Not supported                    | Movies, episodes                      | Movies, episodes                 |
| Kodi             | Not supported                    | Movies, episodes                 | Movies, episodes                      | Movies, episodes                 |
| Stremio          | Movies, shows                    | Movies, shows (target only)      | Movies, episodes                      | Movies, episodes                 |
| Trakt            | Movies, shows                    | Movies, shows, seasons, episodes | Movies, episodes                      | Not a normal sync feature        |
| SIMKL            | Movies, shows, anime             | Movies, shows, anime titles      | Movies, episodes, anime               | Not a normal sync feature        |
| MDBList          | Movies, shows                    | Movies, shows, seasons, episodes | Movies, shows, seasons, episodes      | Not a normal sync feature        |
| PublicMetaDB     | Movies, shows                    | Movies, shows, episodes          | Movies, episodes                      | Movies, episodes                 |
| PunchPlay        | Movies, shows                    | Movies, shows, seasons, episodes | Movies, episodes                      | Movies, episodes                 |
| Scrob            | Movies, shows                    | Movies, shows, seasons, episodes | Movies, episodes, including rewatches | Movies, episodes                 |
| AniList          | Anime movies, anime series       | Anime movies, anime series       | Not supported                         | Not supported                    |
| TMDb             | Movies, shows                    | Movies, shows, episodes          | Not supported                         | Not supported                    |
| Tautulli         | Not supported                    | Not supported                    | Plex movies, episodes                 | Not supported                    |

#### Important restrictions

| Provider         | Notes                                                                         |
| ---------------- | ----------------------------------------------------------------------------- |
| CrossWatch local | Local JSON tracker with snapshots                                             |
| Plex             | Uses Plex Discover. Progress removal can be limited                           |
| Jellyfin         | No native watchlist. Playlist is episode-only. Strict ID matching is optional |
| Emby             | No native watchlist. Playlist is episode-only. Strict ID matching is optional |
| Floppy           | Experimental. Requires TMDb IDs. No progress or playlists                     |
| Nuvio            | Experimental. Watchlist maps to the Nuvio Library. TMDb is recommended        |
| Kodi             | Experimental. Writes need existing library items and unique external IDs      |
| Stremio          | Experimental. Library acts as watchlist. Ratings are target-only              |
| Trakt            | History writes can also add to Trakt Collections                              |
| SIMKL            | No season or episode ratings                                                  |
| MDBList          | Dropped shows can be excluded from history sync                               |
| PublicMetaDB     | Requires TMDb identity. Progress also needs duration                          |
| PunchPlay        | Experimental. Supports Watcher and uses provider IDs for matching             |
| Scrob            | Experimental. Requires a reachable server, API key, and user credentials      |
| AniList          | Anime mapping supports watchlist and ratings only                             |
| TMDb             | Requires a TMDb API key and account session                                   |
| Tautulli         | Read-only source. No writes                                                   |

### Jellyfin and Emby watchlist mapping

| Mode             |                                                 Read |                                                Write | Suitable content                       | Limitations                                  |
| ---------------- | ---------------------------------------------------: | ---------------------------------------------------: | -------------------------------------- | -------------------------------------------- |
| Favorites        | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | Movies, shows, episodes, library items | Uses the provider Favorite flag              |
| Playlist         | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | Episodes                               | Does not represent shows. No item migration. |
| Collections      | <i class="fa-check" style="color:green;">:check:</i> | <i class="fa-check" style="color:green;">:check:</i> | Movies, shows, library items           | Uses a named collection                      |
| Native watchlist |   <i class="fa-xmark" style="color:red;">:xmark:</i> |   <i class="fa-xmark" style="color:red;">:xmark:</i> | N/A                                    | No native watchlist                          |

### Authentication and connection methods

#### Authentication

| Provider         | Authentication                        |                                      Refresh support |
| ---------------- | ------------------------------------- | ---------------------------------------------------: |
| CrossWatch local | None                                  |                                                  N/A |
| Plex             | Plex device PIN                       |                                    No refresh action |
| Jellyfin         | Server connection and access token    |                                   Provider-dependent |
| Emby             | Server connection and access token    |                                   Provider-dependent |
| Floppy           | Server URL and API token              |                                                   No |
| Nuvio            | Temporary login code and profile      |                                                  Yes |
| Kodi             | HTTP JSON-RPC with Basic Auth         |                                                  N/A |
| Stremio          | Email and password to obtain auth key |                                                   No |
| Trakt            | OAuth device code                     | <i class="fa-check" style="color:green;">:check:</i> |
| SIMKL            | OAuth                                 |                                   Provider-dependent |
| MDBList          | OAuth device code, legacy API key     |                                        Yes for OAuth |
| PublicMetaDB     | API key                               |                                                   No |
| PunchPlay        | OAuth device code                     |                                                  Yes |
| AniList          | OAuth access token                    |                                   Provider-dependent |
| TMDb             | API key plus user session             |                                        Session-based |
| Tautulli         | Server URL plus API key               |                                                   No |

#### Important connection options

| Provider         | Key options                                                                 |
| ---------------- | --------------------------------------------------------------------------- |
| CrossWatch local | Storage path, retention, snapshots, restore selection                       |
| Plex             | Server, owner, managed users, shared users, Home profile, optional Home PIN |
| Jellyfin         | Server URL, user ID, device ID, optional SSL verification                   |
| Emby             | Server URL, user ID, device ID, optional SSL verification                   |
| Floppy           | Server URL, API token, SSL verification, watchlist name                     |
| Nuvio            | Selected Nuvio profile and stored authentication tokens                     |
| Kodi             | Server URL, HTTP credentials, SSL validation, source-path whitelists        |
| Stremio          | Stored auth key, Like and Love rating thresholds                            |
| Trakt            | Client ID, client secret, access token, refresh token                       |
| SIMKL            | Client ID, client secret, access token                                      |
| MDBList          | Access token, refresh token, API key fallback                               |
| PublicMetaDB     | Base URL                                                                    |
| PunchPlay        | Device-code connection and stored refresh tokens                            |
| AniList          | Client ID, client secret, access token                                      |
| TMDb             | Auto-discovered account ID                                                  |
| Tautulli         | Optional user filter and SSL verification                                   |

#### Authentication notes

1. CrossWatch supports multiple named provider profiles.
2. Plex supports shared tokens and separate friend or shared users.
3. TMDb has two roles: `tmdb` for metadata and `tmdb_sync` for account sync.
4. Provider secrets are redacted from public config responses.


---

# 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/getting-started/support-matrix/providers.md?ask=<question>&goal=<endgoal>
```

`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.
