Plex

End users

Connect Plex

1. Click Connect Plex.
2. A new tab opens and asks for a PIN.
3. Copy the PIN from Link code in CrossWatch. Paste it into the Plex page.
4. After Plex accepts the PIN, close the Plex tab.
5. Back in CrossWatch, open Settings for Plex.
6. Verify these values are filled:

   • Server ID
   • Username
   • Account ID
7. Click Save.

Plex users: owner, managed users, and friends

Plex can return several user types in the user list:

• Owner — the Plex account that authenticated CrossWatch
• Managed user — a user inside the owner’s Plex Home
• Friend or shared user — a separate Plex account with access to one or more shared libraries

A friend or shared account is not the same as a Plex Home managed user.

Friend and shared account support

CrossWatch stores the token from the Plex account that completed the sign-in flow.

When you select a friend or shared user, CrossWatch can try to use Plex’s server-scoped shared token for that user.

That token is limited to your Plex Media Server.

It does not give CrossWatch full access to the friend’s Plex account, profile, watchlist, ratings, or other cloud data.

Current support:

• ✅ History — supported
• ✅ Progress — supported
• ❌ Ratings — not supported
• ❌ Watchlist — not supported

This depends on Plex’s shared-server token behavior.

Plex has changed this path before and may change or remove it again.

When requested user scope cannot be applied, CW stops the operation.

Plex Home managed users

Plex Home managed users work differently from friends.

CW can try to switch the authenticated Plex Home account into the selected managed user.

If the managed user is protected by a Plex Home PIN, configure the correct PIN too.

Use the server owner’s Plex profile for Plex Home managed users.

Use a separately authenticated Plex profile for friends when you need personal account features like watchlist or ratings.

Optional: whitelisting (libraries)

If you don’t see your libraries:

1. Click Load Libraries.
2. Pick the libraries you want CW to use.
3. Click Save.

Guide: Library Whitelisting.

Power users