Skip to content

Configuration

Michael Riddle edited this page Aug 19, 2026 · 6 revisions

Configuration

src/KHost.UserInterface/appsettings.json is the host's configuration file. Environment-specific overrides live in appsettings.Development.json. Options-pattern sections bind whether or not they appear in the file; absent keys use the defaults below.

Host settings

Section / key Default Purpose
Logging — Standard Microsoft.Extensions.Logging levels. Serilog is layered on top in Program.cs.
AllowedHosts * ASP.NET Core host filter.
Urls http://0.0.0.0:5251 Where Kestrel listens (semicolon-separated). Binds every interface so Cast receivers and off-machine screens can reach the stream; only /media and /ipc/screen are answered off-box (see Architecture).
Audio.Volume 1.0 Master audio volume (0.0–1.0).
FFmpegPath null Path to the FFmpeg binary directory when it is not on PATH.
Playback.StopFadeDuration 5 s Audio fade applied on stop.
Playback.SyncStartLead 400 ms How far in the future the shared-timeline start is scheduled, so every screen starts on the same instant.
LocalScreen.ExePath KHost.Screen2 next to the host binary Override for the screen executable path.
LocalScreen.ServerUri host's live listening address SignalR hub URI passed to launched screen processes. The host injects the address it is actually bound on; set only to force a specific URI.
MediaStream.BaseAddress host's live listening address Base URL embedded in HLS playlist URLs handed to screens and Cast receivers.
MediaStream.WorkingDirectory %TEMP%/khost-streams Where per-session HLS output (stream.m3u8 + segments) is written.
MediaStream.SegmentSeconds 2 HLS segment length.
MediaFileParsingService.* — Filename-to-metadata parsing: Format (ArtistFirst/TitleFirst), Separators, PrefixStripPatterns, TitleNoisePatterns, FeaturingPattern, FeaturingHandling, FallbackArtistName.

Cast discovery is not configured here: it sweeps the whole network, so it is off at startup and enabled from the Screens dialog only while the dialog is open.

Per-venue settings

These are stored on the venue (Venue.Settings, a JSON column) and edited in the venue editor, not in appsettings.json:

Setting Default Purpose
DefaultVolume 100 Venue starting volume.
OnScreenDisconnect ResumeOnReconnect What playback does when the last screen disconnects.
ShowEstimatedWaitTime true Show estimated wait per queued singer.
TippingEnabled true Enable tip recording.
WarnOnDuplicateSong false Prompt when a song was already sung recently.
DuplicateSongWindowHours 4 Window for the duplicate-song warning.
PromptBeforeRemovingSinger true Confirmation prompt when removing a singer.
PromptBeforeRemovingPerformance true Confirmation prompt when removing a queued performance.
ClearQueueOnClose true Clear the queue on any graceful shutdown — closing the window, Ctrl+C, SIGTERM. A force kill leaves the queue in place.
QueueRotation FIFO Queue-rotation strategy and its parameters (see Plugins for the built-in modes).

Command-line flags

Host (KHost.UserInterface):

Flag Effect
--headless No native Photino window; the console is served to a browser.
--start-page <route> One-time redirect to the given route on first load.

Screen (KHost.Screen2):

Flag Default Effect
--server-uri http://localhost:5000/ipc/screen SignalR hub to connect to. Screens launched from the Screens dialog get the host's live address injected.
--screen-id machine name Identity reported to the host; also names the screen's log files.
--log-level Information debug additionally logs the state the page reports each tick (position, expected position, readyState).

Runtime files

See Getting Started for the on-disk layout (cache/, logs/, the SQLite file).

Clone this wiki locally