Plex

Plex is a supported source provider in Brokerr. It supplies movies, shows, episodes, watched state, ratings, Continue Watching membership, libraries, and metadata identifiers.

Movie posters and root-series posters are available as source artwork. Brokerr proxies Plex image requests, so the Plex token is never sent to the browser. Episode screenshots are not used for series entries.

Prerequisites

• A Plex account with access to the server.
• A server URL reachable from the Brokerr container.
• Permission to configure Plex webhooks if event-triggered sync is required.

Configure

Use Sign in with Plex to authorize a PIN and import one or more accessible servers. Brokerr saves base URL, token, and machine identifier. Load libraries, enable the required ones, then save Settings before creating profiles.

Manual URL/token configuration is supported. Test the URL from the Brokerr host or container network; browser reachability alone is not sufficient.

State interpretation

Episode progress is derived from watched episodes. Movie progress is treated as an unwatched/watched state for periodic scans. Continue Watching determines whether a started, incomplete item is active or eligible for the profile’s pause rule. Plex ratings are resolved using the profile’s episode/season/show priority.

Specials do not contribute to normal season progress.

Identifiers and mapping

Plex GUIDs can contain TMDB, TVDB, IMDb, AniDB, AniList, or MAL identifiers. Brokerr prefers a direct target identifier and uses AniBridge as an anime fallback.

Webhooks

Configure the generated source URL in Plex account settings. Brokerr validates the machine identifier and profile library before creating a batch. See the webhook guide.

Troubleshooting

If libraries fail to load, check the token and container-reachable URL. If the wrong server triggers a webhook, compare the saved machine identifier with the incoming Plex Server.uuid shown in webhook events.