allstarr/allstarr/Models/Settings/ScrobblingSettings.cs

using System.Text;

namespace allstarr.Models.Settings;

/// <summary>
/// Settings for scrobbling services (Last.fm, ListenBrainz, etc.).
/// </summary>
public class ScrobblingSettings
{
    /// <summary>
    /// Whether scrobbling is enabled globally.
    /// </summary>
    public bool Enabled { get; set; }

    /// <summary>
    /// Whether to scrobble local library tracks.
    /// Recommended: Keep disabled and use native Jellyfin plugins instead.
    /// </summary>
    public bool LocalTracksEnabled { get; set; }

    /// <summary>
    /// Emits a synthetic local "played" signal from progress events when local scrobbling is disabled.
    /// Default is false to avoid duplicate local scrobbles with Jellyfin plugins.
    /// </summary>
    public bool SyntheticLocalPlayedSignalEnabled { get; set; }

    /// <summary>
    /// Last.fm settings.
    /// </summary>
    public LastFmSettings LastFm { get; set; } = new();

    /// <summary>
    /// ListenBrainz settings (future).
    /// </summary>
    public ListenBrainzSettings ListenBrainz { get; set; } = new();
}

/// <summary>
/// Last.fm scrobbling settings.
/// </summary>
public class LastFmSettings
{
    // These defaults match the Jellyfin Last.fm plugin credentials.
    // Stored base64-encoded to avoid plain-text source exposure.
    private const string DefaultApiKeyBase64 = "Y2IzYmRjZDQxNWZjYjQwY2Q1NzJiMTM3YjJiMjU1ZjU=";
    private const string DefaultSharedSecretBase64 = "M2EwOGY5ZmFkNmRkYzRjMzViMGRjZTAwNjJjZWNiNWU=";

    public static string DefaultApiKey => DecodeBase64(DefaultApiKeyBase64);
    public static string DefaultSharedSecret => DecodeBase64(DefaultSharedSecretBase64);

    /// <summary>
    /// Whether Last.fm scrobbling is enabled.
    /// </summary>
    public bool Enabled { get; set; }

    /// <summary>
    /// Last.fm API key (32-character hex string).
    /// Uses hardcoded credentials from Jellyfin Last.fm plugin for convenience.
    /// Users can override by setting SCROBBLING_LASTFM_API_KEY in .env
    /// </summary>
    public string ApiKey { get; set; } = DefaultApiKey;

    /// <summary>
    /// Last.fm shared secret (32-character hex string).
    /// Uses hardcoded credentials from Jellyfin Last.fm plugin for convenience.
    /// Users can override by setting SCROBBLING_LASTFM_SHARED_SECRET in .env
    /// </summary>
    public string SharedSecret { get; set; } = DefaultSharedSecret;

    /// <summary>
    /// Last.fm session key (obtained via Mobile Authentication).
    /// This is user-specific and has infinite lifetime (unless revoked by user).
    /// </summary>
    public string SessionKey { get; set; } = string.Empty;

    /// <summary>
    /// Last.fm username.
    /// </summary>
    public string? Username { get; set; }

    /// <summary>
    /// Last.fm password (stored for automatic re-authentication if needed).
    /// Only used for authentication, not stored in plaintext in production.
    /// </summary>
    public string? Password { get; set; }

    private static string DecodeBase64(string encoded)
    {
        return Encoding.UTF8.GetString(Convert.FromBase64String(encoded));
    }
}

/// <summary>
/// ListenBrainz scrobbling settings (future implementation).
/// </summary>
public class ListenBrainzSettings
{
    /// <summary>
    /// Whether ListenBrainz scrobbling is enabled.
    /// </summary>
    public bool Enabled { get; set; }

    /// <summary>
    /// ListenBrainz user token.
    /// Get from: https://listenbrainz.org/profile/
    /// </summary>
    public string UserToken { get; set; } = string.Empty;
}