Files
Felitendo af69893de4 fix: stop matching instrumental tracks against unrelated songs (#40)
Honor LRCLIB's instrumental flag, validate every match against the
requested duration and artist, and drop the track-name-only fuzzy
fallback when artist info is available. Adds a configurable
duration-tolerance filter (default on, ±15s) with a UI toggle so users
can disable or tune it.
2026-05-06 14:14:18 +02:00

69 lines
2.4 KiB
C#

using System.Diagnostics.CodeAnalysis;
using MediaBrowser.Model.Plugins;
namespace Jellyfin.Plugin.Lyrics.Configuration;
/// <summary>
/// Configuration for lyrics plugin.
/// </summary>
public class PluginConfiguration : BasePluginConfiguration
{
/// <summary>
/// Gets or sets a value indicating whether to use strict search.
/// </summary>
public bool UseStrictSearch { get; set; }
/// <summary>
/// Gets or sets a value indicating whether to exclude artist name.
/// </summary>
public bool ExcludeArtistName { get; set; } = false;
/// <summary>
/// Gets or sets a value indicating whether to exclude album name.
/// </summary>
public bool ExcludeAlbumName { get; set; } = true;
/// <summary>
/// Gets or sets a value indicating whether to enable adaptive retry backoff.
/// </summary>
public bool EnableAdaptiveRetryBackoff { get; set; } = true;
/// <summary>
/// Gets or sets a value indicating whether to enforce a per-run processing cap.
/// </summary>
public bool EnableRunCap { get; set; } = true;
/// <summary>
/// Gets or sets the maximum number of tracks to process per run.
/// </summary>
public int MaxTracksPerRun { get; set; } = 2000;
/// <summary>
/// Gets or sets the state entry retention in days.
/// </summary>
public int FailureStateTtlDays { get; set; } = 90;
/// <summary>
/// Gets or sets the adaptive backoff schedule in days.
/// </summary>
[SuppressMessage("Performance", "CA1819:Properties should not return arrays", Justification = "Plugin configuration is persisted and exchanged via simple array values.")]
public int[] BackoffScheduleDays { get; set; } = [1, 3, 7, 30];
/// <summary>
/// Gets or sets a value indicating whether to filter LRCLIB matches by track duration.
/// </summary>
public bool EnableDurationFilter { get; set; } = true;
/// <summary>
/// Gets or sets the duration tolerance in seconds for accepting an LRCLIB match.
/// Results whose duration differs from the local track by more than this value are rejected.
/// Ignored when <see cref="EnableDurationFilter"/> is false.
/// </summary>
public int DurationToleranceSeconds { get; set; } = 15;
/// <summary>
/// Gets or sets the legacy state cursor value.
/// </summary>
public int StateCursor { get; set; }
}