feat(api): settings read/write endpoints (#93)

GET/PUT /api/settings/{ffmpeg,playout,xmltv,scanner,logging,ui,hdhr}
wrapping the existing MediatR settings handlers, plus custom resolution
list/create/delete under /api/settings/resolutions. String-enum OpenAPI
schemas extended to OutputFormatKind + LogEventLevel.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-07-07 09:22:50 +02:00
co-authored by Claude Fable 5
parent 82a93ea3be
commit 57905bc0f4
26 changed files with 2464 additions and 0 deletions
@@ -0,0 +1,8 @@
using ErsatzTV.Application.Resolutions;
namespace ErsatzTV.Controllers.Api.Requests;
public record CreateResolutionRequest(int Width, int Height)
{
public CreateCustomResolution ToCommand() => new(Width, Height);
}
@@ -0,0 +1,43 @@
using ErsatzTV.Application.FFmpegProfiles;
using ErsatzTV.FFmpeg.OutputFormat;
namespace ErsatzTV.Controllers.Api.Requests;
public record UpdateFFmpegSettingsRequest(
string FFmpegPath,
string FFprobePath,
int DefaultFFmpegProfileId,
string PreferredAudioLanguageCode,
bool UseEmbeddedSubtitles,
bool ExtractEmbeddedSubtitles,
bool ProbeForInterlacedFrames,
bool SaveReports,
int? GlobalWatermarkId,
int? GlobalFallbackFillerId,
int HlsSegmenterIdleTimeout,
int WorkAheadSegmenterLimit,
int InitialSegmentCount,
OutputFormatKind HlsDirectOutputFormat,
string DefaultMpegTsScript)
{
public UpdateFFmpegSettings ToCommand() =>
new(
new FFmpegSettingsViewModel
{
FFmpegPath = FFmpegPath,
FFprobePath = FFprobePath,
DefaultFFmpegProfileId = DefaultFFmpegProfileId,
PreferredAudioLanguageCode = PreferredAudioLanguageCode,
UseEmbeddedSubtitles = UseEmbeddedSubtitles,
ExtractEmbeddedSubtitles = ExtractEmbeddedSubtitles,
ProbeForInterlacedFrames = ProbeForInterlacedFrames,
SaveReports = SaveReports,
GlobalWatermarkId = GlobalWatermarkId,
GlobalFallbackFillerId = GlobalFallbackFillerId,
HlsSegmenterIdleTimeout = HlsSegmenterIdleTimeout,
WorkAheadSegmenterLimit = WorkAheadSegmenterLimit,
InitialSegmentCount = InitialSegmentCount,
HlsDirectOutputFormat = HlsDirectOutputFormat,
DefaultMpegTsScript = DefaultMpegTsScript
});
}
@@ -0,0 +1,8 @@
using ErsatzTV.Application.HDHR;
namespace ErsatzTV.Controllers.Api.Requests;
public record UpdateHdhrSettingsRequest(int TunerCount)
{
public UpdateHDHRTunerCount ToCommand() => new(TunerCount);
}
@@ -0,0 +1,25 @@
using ErsatzTV.Application.Configuration;
using Serilog.Events;
namespace ErsatzTV.Controllers.Api.Requests;
public record UpdateLoggingSettingsRequest(
LogEventLevel DefaultMinimumLogLevel,
LogEventLevel ScanningMinimumLogLevel,
LogEventLevel SchedulingMinimumLogLevel,
LogEventLevel SearchingMinimumLogLevel,
LogEventLevel StreamingMinimumLogLevel,
LogEventLevel HttpMinimumLogLevel)
{
public UpdateLoggingSettings ToCommand() =>
new(
new LoggingSettingsViewModel
{
DefaultMinimumLogLevel = DefaultMinimumLogLevel,
ScanningMinimumLogLevel = ScanningMinimumLogLevel,
SchedulingMinimumLogLevel = SchedulingMinimumLogLevel,
SearchingMinimumLogLevel = SearchingMinimumLogLevel,
StreamingMinimumLogLevel = StreamingMinimumLogLevel,
HttpMinimumLogLevel = HttpMinimumLogLevel
});
}
@@ -0,0 +1,15 @@
using ErsatzTV.Application.Configuration;
namespace ErsatzTV.Controllers.Api.Requests;
public record UpdatePlayoutSettingsRequest(int DaysToBuild, bool SkipMissingItems, int ScriptedScheduleTimeoutSeconds)
{
public UpdatePlayoutSettings ToCommand() =>
new(
new PlayoutSettingsViewModel
{
DaysToBuild = DaysToBuild,
SkipMissingItems = SkipMissingItems,
ScriptedScheduleTimeoutSeconds = ScriptedScheduleTimeoutSeconds
});
}
@@ -0,0 +1,9 @@
using ErsatzTV.Application.Configuration;
namespace ErsatzTV.Controllers.Api.Requests;
/// <summary>Library scan cadence. <see cref="LibraryRefreshInterval" /> is expressed in hours.</summary>
public record UpdateScannerSettingsRequest(int LibraryRefreshInterval)
{
public UpdateLibraryRefreshInterval ToCommand() => new(LibraryRefreshInterval);
}
@@ -0,0 +1,14 @@
using ErsatzTV.Application.Configuration;
namespace ErsatzTV.Controllers.Api.Requests;
public record UpdateUiSettingsRequest(bool IsDarkMode, string Language)
{
public UpdateUiSettings ToCommand() =>
new(
new UiSettingsViewModel
{
IsDarkMode = IsDarkMode,
Language = Language
});
}
@@ -0,0 +1,17 @@
using ErsatzTV.Application.Configuration;
using ApiXmltvBlockBehavior = ErsatzTV.Core.Api.Settings.XmltvBlockBehavior;
using ApiXmltvTimeZone = ErsatzTV.Core.Api.Settings.XmltvTimeZone;
namespace ErsatzTV.Controllers.Api.Requests;
public record UpdateXmltvSettingsRequest(int DaysToBuild, ApiXmltvTimeZone TimeZone, ApiXmltvBlockBehavior BlockBehavior)
{
public UpdateXmltvSettings ToCommand() =>
new(
new XmltvSettingsViewModel
{
DaysToBuild = DaysToBuild,
TimeZone = (XmltvTimeZone)(int)TimeZone,
BlockBehavior = (XmltvBlockBehavior)(int)BlockBehavior
});
}