Audio

DearScenario Player routes decoded audio through libmpv, then to an OS output device. When sound is missing on site, check three layers before blaming the media file.

Volume layers

Layer	Where to look	Notes
Player	Controls tab volume / mute; `volume_set` / `mute_set`	Always available when media is loaded
Application session	Tools → Audio (Windows)	Per-process mixer row; may be missing until audio is playing
System master	Tools → Audio / OS sound settings	OS default device mute or volume

Output device

Config:

{ "audio": { "output_device": "auto" } }

Value	Behavior
`"auto"`	Follow the operating system default output device
Device ID	Force a specific libmpv audio-device ID

Change it from:

Settings (when exposed), or
debug panel Tools → Audio → Output device, then save

CLI: --audio-output-device.

Reading Tools → Audio routing

With media loaded, open Tools → Audio and refresh diagnostics:

Row	Meaning
Audio track	Track count and selection (or “No media loaded.”)
Available backends	Platform backends (CoreAudio, WASAPI, ALSA, …)
Active backend	Backend currently opened by libmpv
Requested device	Configured `output_device` (Auto = system default)
Resolved OS endpoint	Actual OS device when observable
Player volume	Player-level percent and mute

If the saved device is unavailable, playback falls back to auto and the panel shows a warning.

Troubleshooting checklist

Confirm media actually has an audio track (Status / Tools routing table).
Unmute player volume in Controls.
Set Output device to Auto, then to the correct HDMI / USB interface.
Check OS master mute and the correct default playback device.
On Windows, check the DearScenario Player session row in the system mixer while audio is playing.
Try another file / codec; see Encoding.

Also see Troubleshooting.

Debug panel
Configuration Reference (audio)
Command Reference (volume_set, mute_set)

Previous / Next

Previous: Debug Panel
Next: Window & Display