Profiles and rules
A profile connects one source and selected libraries to one target. It also controls webhook eligibility, default dry-run behavior, schedule opt-outs, media types, and sync policy.
| Rule | Config field | Meaning | Supported targets |
|---|---|---|---|
| Progress | sync_progress | Synchronize watched movie or episode progress. | AniList, MAL, SIMKL, Trakt |
| Ratings | sync_ratings | Write the resolved source rating to the target. | AniList, MAL, SIMKL, Trakt |
| Notes | sync_notes | Allow provider notes to be changed when target sync notes are enabled. | AniList |
| Rewatch | sync_rewatch | Detect and synchronize a new rewatch cycle. | AniList, MAL |
| Movies | sync_movies | Include movie libraries and movie source items. | All targets |
| Shows | sync_shows | Include series and episode source items. | All targets |
| Sync unlisted | sync_unlisted_entries | Create target entries that do not exist in the connected account yet. | All targets |
| Protect target progress | protect_target_progress | Do not reduce target episode progress when the target is ahead of the source. | AniList, MAL, SIMKL, Trakt |
| Protect target state | protect_target_state | Do not move a target entry to an earlier lifecycle state. | AniList, MAL, SIMKL, Trakt |
| Detect rewatch | detect_rewatch | Use previous snapshots to identify a new source rewatch. | AniList, MAL |
| Pause outside Continue Watching | pause_when_not_in_continue_watching | Pause an incomplete item after it leaves source Continue Watching. | AniList, MAL, SIMKL |
| Set target sync note | set_target_sync_note | Add the Brokerr marker to target notes. | AniList |
Unsupported rules are removed from the effective policy and hidden or reported as validation warnings. A disabled rule does not imply that the provider field is cleared; it means Brokerr does not manage that field.
Protection interaction
Section titled “Protection interaction”Protect target progress protects the numeric watched progress. Protect target state protects lifecycle state such as Completed against regression. They are independent.
For Plex, Jellyfin, and Emby, Pause outside Continue Watching is an explicit state-protection exception. An incomplete item that leaves Continue Watching can become Paused/On Hold even while target state protection is enabled. Numeric target progress can remain ahead when progress protection is enabled.
Example: MAL is Watching episode 2, the source has episode 1 watched, and the show is outside Continue Watching. With both progress protection and pause enabled, Brokerr plans episode 2 plus On Hold.
Safe profile setup
Section titled “Safe profile setup”Start with dry-run and both automatic modes paused. Run a full scan, resolve unmatched items, inspect status/progress/ratings, and only then enable writes or group scheduling.
