Playback & Content

Idle Screen

When no media is playing, the idle screen follows RuntimeMode:

  • Formal / Normal entry: black, unless idle_screen.image_path points to a readable image.
  • Maintenance entry: the local guide (QR, address, open Web Console). Maintenance ignores image_path.
{
  "idle_screen": {
    "image_path": "",
    "fill_mode": "fill"
  }
}

Full diagnostic idle (IP tables, Debug panel button, etc.) appears only in a process started with --maintenance.

Custom background image

{
  "idle_screen": {
    "image_path": "C:\\DearScenario Player\\assets\\idle_background.png",
    "fill_mode": "fit"
  }
}

fill_mode is used only when image_path is set. An empty path is a black idle; changing fill mode has no visible effect until you set an image.

Fill modes

ModeBehavior
fillPreserve aspect ratio, crop to cover the screen.
fitPreserve aspect ratio, scale until fully visible.
stretchIgnore aspect ratio, stretch to fill screen.