feat(OSD): add support for media volume

Signed-off-by: Sefa Eyeoglu <contact@scrumplex.net>

Author: Scrumplex

Assets/Translations/en-GB.json

@@ -1574,6 +1574,8 @@
       "types-lockkey-label": "Lock keys",
       "types-media-description": "Show OSD when media playback state changes (play, pause, skip).",
       "types-media-label": "Media playback",
+      "types-media-volume-description": "Show OSD when media volume changes.",
+      "types-media-volume-label": "Media volume",
       "types-title": "OSD trigger events",
       "types-volume-description": "Show OSD when audio output volume changes.",
       "types-volume-label": "Output volume"

Assets/Translations/en.json

@@ -1574,6 +1574,8 @@
       "types-lockkey-label": "Lock keys",
       "types-media-description": "Show OSD when media playback state changes (play, pause, skip).",
       "types-media-label": "Media playback",
+      "types-media-volume-description": "Show OSD when media volume changes.",
+      "types-media-volume-label": "Media volume",
       "types-title": "OSD trigger events",
       "types-volume-description": "Show OSD when audio output volume changes.",
       "types-volume-label": "Output volume"

Assets/settings-default.json

@@ -478,7 +478,8 @@
     "enabledTypes": [
       0,
       1,
-      2
+      2,
+      4
     ],
     "monitors": []
   },

Commons/Settings.qml

@@ -707,7 +707,7 @@ Singleton {
       property int autoHideMs: 2000
       property bool overlayLayer: true
       property real backgroundOpacity: 1.0
-      property list<var> enabledTypes: [OSD.Type.Volume, OSD.Type.InputVolume, OSD.Type.Brightness]
+      property list<var> enabledTypes: [OSD.Type.Volume, OSD.Type.InputVolume, OSD.Type.Brightness, OSD.Type.MediaVolume]
       property list<string> monitors: [] // holds osd visibility per monitor
     }
 

Modules/OSD/OSD.qml

@@ -19,7 +19,8 @@ Variants {
     Volume,
     InputVolume,
     Brightness,
-    LockKey
+    LockKey,
+    MediaVolume
   }
 
   model: Quickshell.screens.filter(screen => (Settings.data.osd.monitors.includes(screen.name) || Settings.data.osd.monitors.length === 0) && Settings.data.osd.enabled)
@@ -45,6 +46,7 @@ Variants {
     readonly property bool isMuted: AudioService.muted
     readonly property real currentInputVolume: AudioService.inputVolume
     readonly property bool isInputMuted: AudioService.inputMuted
+    readonly property real currentMediaVolume: MediaService.volume
     readonly property real epsilon: 0.005
 
     // LockKey OSD enabled state (reactive to settings)
@@ -72,6 +74,11 @@ Variants {
         return currentVolume <= 0.5 ? "volume-low" : "volume-high";
       case OSD.Type.InputVolume:
         return isInputMuted ? "microphone-off" : "microphone";
+      case OSD.Type.MediaVolume:
+        // Show volume-x icon when volume is effectively 0% (within rounding threshold)
+        if (currentMediaVolume < root.epsilon)
+          return "volume-x";
+        return currentMediaVolume <= 0.5 ? "volume-low" : "volume-high";
       case OSD.Type.Brightness:
         // Show sun-off icon when brightness is effectively 0% (within rounding threshold)
         if (currentBrightness < root.epsilon)
@@ -90,6 +97,8 @@ Variants {
         return isMuted ? 0 : currentVolume;
       case OSD.Type.InputVolume:
         return isInputMuted ? 0 : currentInputVolume;
+      case OSD.Type.MediaVolume:
+        return currentMediaVolume;
       case OSD.Type.Brightness:
         return currentBrightness;
       case OSD.Type.LockKey:
@@ -124,7 +133,7 @@ Variants {
     }
 
     function getProgressColor() {
-      const isMutedState = (currentOSDType === OSD.Type.Volume && isMuted) || (currentOSDType === OSD.Type.InputVolume && isInputMuted);
+      const isMutedState = (currentOSDType === OSD.Type.Volume && isMuted) || (currentOSDType === OSD.Type.InputVolume && isInputMuted) || (currentOSDType === OSD.Type.MediaVolume && currentMediaVolume < root.epsilon);
       if (isMutedState) {
         return Color.mError;
       }
@@ -150,7 +159,7 @@ Variants {
     }
 
     function getIconColor() {
-      const isMutedState = (currentOSDType === OSD.Type.Volume && isMuted) || (currentOSDType === OSD.Type.InputVolume && isInputMuted);
+      const isMutedState = (currentOSDType === OSD.Type.Volume && isMuted) || (currentOSDType === OSD.Type.InputVolume && isInputMuted) || (currentOSDType === OSD.Type.MediaVolume && currentMediaVolume < root.epsilon);
       if (isMutedState)
         return Color.mError;
 
@@ -313,6 +322,15 @@ Variants {
       }
     }
 
+    // MediaService monitoring
+    Connections {
+      target: MediaService
+
+      function onVolumeChanged() {
+        showOSD(OSD.Type.MediaVolume);
+      }
+    }
+
     // Brightness monitoring
     Connections {
       target: BrightnessService

Modules/Panels/Settings/Tabs/Osd/EventsSubTab.qml

@@ -30,6 +30,10 @@ ColumnLayout {
       {
         type: OSD.Type.LockKey,
         key: "types-lockkey"
+      },
+      {
+        type: OSD.Type.MediaVolume,
+        key: "types-media-volume"
       }
     ]
     delegate: NCheckbox {

Services/Media/MediaService.qml

@@ -41,6 +41,8 @@ Singleton {
   property bool canGoNext: currentPlayer ? currentPlayer.canGoNext : false
   property bool canGoPrevious: currentPlayer ? currentPlayer.canGoPrevious : false
   property bool canSeek: currentPlayer ? currentPlayer.canSeek : false
+  property bool isMuted: currentPlayer ? currentPlayer.volume < root.epsilon : false
+  property real volume: currentPlayer ? currentPlayer.volume : 0.0
   property string positionString: formatTime(currentPosition)
   property string lengthString: formatTime(trackLength)
   property real infiniteTrackLength: 922337203685