progress

Jellyfin 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 a Jellyfin user.

Supported media types

• Movies: ✅

• Episodes: ✅

Reads vs writes

• Reads: Jellyfin resumable items.

• Writes:

  • add upserts resume position.

  • remove clears resume position (sets it to 0) when enabled.

Key settings (per pair)

• features.progress.enable

• features.progress.add

• features.progress.remove

• features.progress.min_seconds (default 60)

• features.progress.delta_seconds (default 30)

• features.progress.max_percent (default 95)

Safety rules (important)

• Progress never clears from absence.

• Only an explicit progress_ms = 0 can trigger a clear.

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

Power users