Repository navigation
Configuration
Michael Riddle edited this page Aug 19, 2026
·
6 revisions
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.
| 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.
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). |
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). |
See Getting Started for the on-disk layout (cache/, logs/, the SQLite file).
KHost
Architecture
- Architecture
- Projects
- Screens and Casting
- Break Music and Ads
- Messaging
- Data and Persistence
- Plugins
Contributing