From 05817ceb58d024aa076cbaf27ac528194609f925 Mon Sep 17 00:00:00 2001
From: imonlinux <39863321+imonlinux@users.noreply.github.com>
Date: Tue, 6 Jan 2026 13:46:32 -0800
Subject: [PATCH] Update config.json.example

Added volume_sync and max_volume_percent options.
---
 linux_voice_assistant/config.json.example | 26 +++++++++++++++++++++--
 1 file changed, 24 insertions(+), 2 deletions(-)

diff --git a/linux_voice_assistant/config.json.example b/linux_voice_assistant/config.json.example
index 989952f..0e447f0 100644
--- a/linux_voice_assistant/config.json.example
+++ b/linux_voice_assistant/config.json.example
@@ -14,7 +14,7 @@
   },
 
   // ---------------------------------------------------------------------------
-  // Optional: Audio I/O
+  // Optional: Audio I/O + Output Volume Sync
   // ---------------------------------------------------------------------------
   "audio": {
     // Optional:
@@ -29,7 +29,29 @@
     // Optional:
     // - null/omit => mpv chooses default output
     // - string => mpv audio-device (e.g. "pulse/alsa_output....")
-    "output_device": null
+    "output_device": null,
+
+    // Optional (NEW): Sync the host OS output device volume at startup to match
+    // the volume stored in preferences.json (LVA MediaPlayer volume).
+    //
+    // When enabled, LVA will attempt (in order): wpctl -> pactl -> amixer.
+    // This helps when PipeWire/Pulse/ALSA boots with a low default volume.
+    //
+    // Default: false
+    "volume_sync": false,
+
+    // Optional (NEW): Maximum output volume percent for the underlying sink.
+    //
+    // Many PipeWire/PulseAudio sinks support >100% (e.g. 150%) "amplified" volume.
+    // This sets the ceiling used when mapping LVA volume (0.0–1.0) to the sink.
+    //
+    // Example:
+    //   - max_volume_percent: 150
+    //   - LVA volume 1.0 => sink set to 150%
+    //   - LVA volume 0.5 => sink set to 75%
+    //
+    // Default: 100
+    "max_volume_percent": 100
   },
 
   // ---------------------------------------------------------------------------