AniList target

AniList is an anime-only target for movies and shows. It supports list status, episode progress, canonical ratings, Continue Watching transitions, per-entry repeat counts, and custom list membership. It does not interpret brokerr:* note flags and never adds an automatic sync note.

Authorization and instance settings

Hosted via Brokerr (recommended) uses https://auth.brokerr.net. Custom mode uses an operator-owned AniList client ID, client secret, and redirect URI.

After sign-in, Brokerr reads the Viewer identity, avatar, profile URL, and AniList score format. The detected format populates the target setting, but the user may override it.

Score formats:

• 100 Point (0–100, integer)
• 10 Point Decimal (0–10, step 0.1)
• 10 Point (0–10, integer)
• 5 Star (0–5, integer)
• 3 Point smiley (1–3 using the documented score thresholds)

Default HTTP policy is a 2.1-second minimum request interval, three attempts, and one-second initial exponential backoff with Retry-After support.

The target API tester exposes Test connection and Search anime.

Mapping and segmentation

Mapping prefers a manual override or direct AniList ID, then uses the provider-neutral AniBridge catalog. One Plex show can map to multiple AniList entries, including multiple seasons or split cours. Each target entry has its own stable segment key, episode range/ratio projection, progress, rating, and repeat state.

AniBridge mapping provenance identifies the source descriptor and segment, for example a TVDB show and season. Incremental runs restore cached mapping and recompute source projections without repeating network mapping.

List status

The enabled-by-default List status feature provides:

• Planning source — Plex watchlist, all unwatched items, both, or disabled.
• Sync unlisted entries — allow enabled features to create entries absent from the AniList list. When disabled, status, progress, ratings, playback, and rewatch update existing entries only.
• Promote Planning to Watching — a started item may move from Planning to Current.
• Protect target state — block ordinary backward movement using Planning < Paused/Dropped < Current/Repeating < Completed.
• When removed from Planning source — Keep entry (default), Set Dropped, or Delete entry. Removal means the item no longer matches the selected Planning source, including deletion from Plex when all-unwatched library mode supplied it.

A confirmed Continue Watching transition and a confirmed rewatch intentionally override target-state protection. Delete removes the complete MediaListEntry; the revert payload retains restorable status, progress, repeat, score, notes, custom lists, advanced scores, priority, privacy, and data.

Progress

The Progress feature synchronizes the number of completed episodes inside each AniBridge segment. Protect target episode progress is enabled by default and prevents an ordinary source observation from reducing a higher AniList value.

Playback state

The Playback state feature reacts only after Brokerr has observed a known Continue Watching transition:

• outside → inside: an unfinished started item returns to Current;
• inside → outside: set Paused (default) or Dropped.

The first full import does not infer a removal transition. The rule does not apply to never-started or completed items and never reduces progress.

Rewatch count

Rewatch is enabled by default and operates on a whole AniList segment, not individual episode diary entries. A reset of a previously completed segment sets REPEATING; repeat increases only after every required mapped episode is completed again.

For a film, Plex rewatch count is max(viewCount - 1, 0). For a complete show segment, it uses the lowest viewCount across all required episodes. Incomplete coverage, new episodes, mapping topology changes, and season 0 cannot create a false repeat.

Initial live-full strategies:

• Use higher count (recommended) — max(Plex, AniList).
• Add both histories — add independent Plex and AniList histories.
• Keep AniList history — retain AniList as the baseline and count only future Plex replays.

Respect manual AniList changes (recommended) accepts later manual increases or decreases as the new base before adding future Plex replay deltas. When disabled, Brokerr restores its expected repeat on the next relevant run.

Pending state prevents a timeout or crash from counting one replay twice.

Ratings

AniList rating sources are evaluated independently for each segment. Configure ordered priority among episode average, season rating, and show rating.

Episode modes:

• All required — every segment episode must have a rating.
• Rated only — average only rated episodes.
• Unrated as zero — include missing episode ratings as zero.

Show fallback can be limited by source state; the default is Completed only. Canonical values are converted with exact Decimal arithmetic and ROUND_HALF_UP. Removing an explicit Plex rating clears AniList score unless Keep target when source is empty is enabled.

Safety options:

• Only fill missing ratings — never overwrite an existing AniList score.
• Keep target when source is empty — do not clear a manual target score when Plex is empty.

Custom lists

AniList supports managed custom-list membership but not independent ordering. The target creates a custom list by preserving all other user list options and updates an entry while preserving unrelated custom-list memberships. A missing entry is created as Planning unless ordinary list-status planning determines another state.

AniList custom lists are identified by encoded name because the API does not provide a stable list ID. Rename synchronization therefore updates the binding reference.

Provider I/O

Reads group up to 50 AniList IDs. Writes for the same target entry merge status, progress, score, repeat, and custom-list changes into one SaveMediaListEntry mutation. Network or ambiguous mutation failure performs one bounded reconciliation read before reporting the operation outcome.