Clean up stale Continue Watching entries
🏗️ Build Plugin / build (push) Successful in 1m43s
🧪 Test Plugin / test (push) Successful in 34s
🚀 Release Plugin / build-and-release (push) Successful in 51s
Nightly Build / nightly-build (push) Failing after 50s

Livestreams and ended broadcasts accumulated in every user's resume row
because Jellyfin saves a playback position for channel items regardless
of whether the position means anything. A livestream has nothing to
return to, so the entry stayed pinned forever.

Two parts:

- PlaybackResumeGuard, an IHostedService on ISessionManager.PlaybackStopped.
  Jellyfin saves the resume point before raising the event, so the guard
  zeroes it afterwards for livestreams. Stops new entries at the source.
- ResumeCleanupService plus a daily 4 AM task (after the 3 AM expiration
  check) for the existing backlog. Clears livestreams, resume points older
  than N days, positions under N seconds and playback past N% of runtime,
  each threshold configurable.

Only plugin-owned items are touched, matched by the SRF provider ID with a
fallback to the owning channel ID so recordings are covered too. Clearing
sets PlaybackPositionTicks to 0 and leaves Played false: nothing is deleted
and the item stays unwatched.

Config page gains the thresholds plus "Clean Up Stale Entries Now" and
"Clear All SRF Play Entries" buttons, backed by MaintenanceController
under RequiresElevation.

Also folds the duplicated urn.Contains("livestream") check in
MediaSourceFactory and RecordingService into UrnHelper.IsLivestreamUrn.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
2026-08-12 18:55:41 +02:00
co-authored by Claude Opus 5
parent a9db0aa09c
commit 390146e8d4
13 changed files with 766 additions and 2 deletions
@@ -0,0 +1,29 @@
using System.Collections.Generic;
namespace Jellyfin.Plugin.SRFPlay.Api.Models;
/// <summary>
/// Outcome of a resume point ("Continue Watching") cleanup run.
/// </summary>
public class ResumeCleanupResult
{
/// <summary>
/// Gets or sets the number of users whose resume list was inspected.
/// </summary>
public int UsersChecked { get; set; }
/// <summary>
/// Gets or sets the number of plugin-owned resume points that were inspected.
/// </summary>
public int Inspected { get; set; }
/// <summary>
/// Gets or sets the number of resume points that were cleared.
/// </summary>
public int Cleared { get; set; }
/// <summary>
/// Gets the number of cleared resume points grouped by the rule that matched.
/// </summary>
public Dictionary<string, int> ClearedByReason { get; } = new Dictionary<string, int>();
}