Persistent Media Player Volume After Restart

* Extended Preferences and ServerState to store the normalized media volume and provide a helper to persist it only when the value changes.

* Load the saved volume during startup and apply it immediately to both mpv players so the remembered level is active after every restart.

* Initialize the media player entity with the stored volume and write back updates from Home Assistant so future sessions reuse the latest setting.

Author: Dyaxler

linux_voice_assistant/__main__.py

@@ -133,6 +133,10 @@ async def main() -> None:
     else:
         preferences = Preferences()
 
+    initial_volume = preferences.volume if preferences.volume is not None else 1.0
+    initial_volume = max(0.0, min(1.0, float(initial_volume)))
+    preferences.volume = initial_volume
+
     libtensorflowlite_c_path = _LIB_DIR / "libtensorflowlite_c.so"
     _LOGGER.debug("libtensorflowlite_c path: %s", libtensorflowlite_c_path)
 
@@ -190,8 +194,13 @@ async def main() -> None:
         oww_melspectrogram_path=Path(args.oww_melspectrogram_model),
         oww_embedding_path=Path(args.oww_embedding_model),
         refractory_seconds=args.refractory_seconds,
+        volume=initial_volume,
     )
 
+    initial_volume_percent = int(round(initial_volume * 100))
+    state.music_player.set_volume(initial_volume_percent)
+    state.tts_player.set_volume(initial_volume_percent)
+
     process_audio_thread = threading.Thread(
         target=process_audio, args=(state,), daemon=True
     )

linux_voice_assistant/entity.py

@@ -42,16 +42,17 @@ def __init__(
         object_id: str,
         music_player: MpvMediaPlayer,
         announce_player: MpvMediaPlayer,
+        initial_volume: float = 1.0,
     ) -> None:
         ESPHomeEntity.__init__(self, server)
 
         self.key = key
         self.name = name
         self.object_id = object_id
         self.state = MediaPlayerState.IDLE
-        self.volume = 1.0
+        self.volume = max(0.0, min(1.0, initial_volume))
         self.muted = False
-        self.previous_volume = 1.0
+        self.previous_volume = self.volume
         self.music_player = music_player
         self.announce_player = announce_player
 
@@ -140,6 +141,10 @@ def handle_message(self, msg: message.Message) -> Iterable[message.Message]:
                 self.music_player.set_volume(volume)
                 self.announce_player.set_volume(volume)
                 self.volume = msg.volume
+                if hasattr(self.server, "state") and getattr(
+                    self.server, "state", None
+                ) is not None:
+                    self.server.state.persist_volume(self.volume)  # type: ignore[attr-defined]
                 yield self._update_state(self.state)
         elif isinstance(msg, ListEntitiesRequest):
             yield ListEntitiesMediaPlayerResponse(

linux_voice_assistant/models.py

@@ -56,6 +56,7 @@ def load(
 @dataclass
 class Preferences:
     active_wake_words: List[str] = field(default_factory=list)
+    volume: Optional[float] = None
 
 
 @dataclass
@@ -86,6 +87,7 @@ class ServerState:
     refractory_seconds: float = 2.0
     muted: bool = False
     connected: bool = False
+    volume: float = 1.0
 
     def save_preferences(self) -> None:
         """Save preferences as JSON."""
@@ -95,3 +97,18 @@ def save_preferences(self) -> None:
             json.dump(
                 asdict(self.preferences), preferences_file, ensure_ascii=False, indent=4
             )
+
+    def persist_volume(self, volume: float) -> None:
+        """Persist the normalized media volume (0.0 - 1.0)."""
+        clamped_volume = max(0.0, min(1.0, volume))
+
+        if (
+            abs(self.volume - clamped_volume) < 0.0001
+            and self.preferences.volume is not None
+            and abs(self.preferences.volume - clamped_volume) < 0.0001
+        ):
+            return
+
+        self.volume = clamped_volume
+        self.preferences.volume = clamped_volume
+        self.save_preferences()

linux_voice_assistant/satellite.py

@@ -87,12 +87,15 @@ def __init__(self, state: ServerState) -> None:
                 object_id="linux_voice_assistant_media_player",
                 music_player=state.music_player,
                 announce_player=state.tts_player,
+                initial_volume=state.volume,
             )
             self.state.entities.append(self.state.media_player_entity)
         elif self.state.media_player_entity not in self.state.entities:
             self.state.entities.append(self.state.media_player_entity)
 
         self.state.media_player_entity.server = self
+        self.state.media_player_entity.volume = state.volume
+        self.state.media_player_entity.previous_volume = state.volume
 
         # Add/update mute switch entity (like ESPHome Voice PE)
         mute_switch = self.state.mute_switch_entity