Skip to content
Brokerr

Emby

Emby is a source provider for movies, shows, personal ratings, watched progress, rewatches, and Continue Watching. Brokerr supports Emby Server 4.9 and newer.

Primary movie images and root-series images are used as source posters through the authenticated Brokerr artwork endpoint. The Emby API key is not exposed to the browser.

Before you start

Section titled “Before you start”

Create a dedicated API key in the Emby Server dashboard. The server URL must be reachable from the Brokerr container. You may enter the server origin or a URL that already ends in /emby; Brokerr adds the API path when needed.

Add the source

Section titled “Add the source”
  1. Open Settings > Sources > Emby and add a source.
  2. Enter the server URL and API key, then choose Load users.
  3. Select one user. Create another source for another user.
  4. Choose Load libraries, enable the required movie or TV libraries, and save.
  5. Choose how duplicate movie versions should be selected.
  6. Run Test connection before assigning the source to a profile.

The API key is encrypted in SQLite and is never returned by the API or config export. Leaving the field empty while editing preserves the saved key.

Synchronized state

Section titled “Synchronized state”
  • Played supplies completed movies and watched episodes.
  • PlayCount supplies rewatch count where the target supports it.
  • PlaybackPositionTicks marks media as started.
  • Personal Rating values use the profile rating rules.
  • Resume and Next Up supply Continue Watching state.
  • Specials are excluded from regular episode progress.

Brokerr maps TMDB, TVDB, IMDb, AniDB, AniList, and MAL identifiers exposed by Emby. Direct target identifiers win; AniBridge remains the anime fallback.

Duplicate movie versions

Section titled “Duplicate movie versions”

Movies sharing a TMDB, IMDb, or TVDB ID are reduced to one version using Highest watch state (default), Largest file, or First returned by Emby. Movies without a stable external identifier are never merged by title. Shared stable identifiers also allow the thumbnail cache to reuse one poster across Emby and other configured sources.

Webhooks

Section titled “Webhooks”

Configure Emby Webhooks to send these events to the source URL shown in Settings > Sources > Emby:

  • Playback stop and playback scrobble
  • Mark played and mark unplayed
  • Rating changes

Append ?api_key=<brokerr-api-key> when Brokerr API-key protection is enabled. Brokerr accepts both native JSON and Emby’s multipart data payload. It validates the server and user, reloads authoritative state from Emby, and sends only the matching movie or show to profiles that accept its library.

Playback start, pause, unpause, progress, and system test events are ignored to avoid excessive scans. Emby Webhooks may require Emby Premiere; scheduled, manual, full, and incremental sync continue to work without webhooks.