progress

Plex progress feature implementation (resume position indexing and writes).

Related:

• Pair setting: Progress

• Technical blueprint: Progress

End users

What syncs

This feature syncs resume position ("Continue Watching") for Plex items.

Supported media types

• Movies: ✅

• Episodes: ✅

Reads vs writes

• Reads: Plex "Continue Watching" / resumable items.

• Writes:

  • add upserts resume position.

  • remove (clear) is blocked on Plex for safety.

Key settings (per pair)

• features.progress.enable

• features.progress.add

• features.progress.remove: ignored for Plex clears

• features.progress.min_seconds (default 60)

• features.progress.delta_seconds (default 30)

• features.progress.max_percent (default 95)

Known limitations

• Progress never clears from absence.

• Near-complete items (>= max_percent) are skipped.

• Clearing progress on Plex is unreliable. CrossWatch blocks it.

Power users