Playback & Content
Idle Screen
When no media is playing, the idle screen follows RuntimeMode:
- Formal / Normal entry: black, unless
idle_screen.image_pathpoints 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
| Mode | Behavior |
|---|---|
fill | Preserve aspect ratio, crop to cover the screen. |
fit | Preserve aspect ratio, scale until fully visible. |
stretch | Ignore aspect ratio, stretch to fill screen. |

