From 01c892df2ee8e18c0ea94aa641e6dd53b39c72d5 Mon Sep 17 00:00:00 2001
From: kyle <keao.chen@outlook.com>
Date: Mon, 19 Jan 2026 00:56:03 +1100
Subject: [PATCH] feat(audio): implement volume feedback sound

---
 Assets/Sounds/volume-change.wav               | Bin 0 -> 11342 bytes
 Assets/Translations/en.json                   |   4 ++-
 Assets/Translations/zh-CN.json                |   4 ++-
 CREDITS.md                                    |   1 +
 Commons/Settings.qml                          |   1 +
 .../Settings/Tabs/Audio/VolumesSubTab.qml     |  15 +++++++++
 Services/Media/AudioService.qml               |  30 ++++++++++++++++++
 7 files changed, 53 insertions(+), 2 deletions(-)
 create mode 100644 Assets/Sounds/volume-change.wav

diff --git a/Assets/Sounds/volume-change.wav b/Assets/Sounds/volume-change.wav
new file mode 100644
index 0000000000000000000000000000000000000000..24bcc44602936e7efa543b659936b11691dd931d
GIT binary patch
literal 11342
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

literal 0
HcmV?d00001

diff --git a/Assets/Translations/en.json b/Assets/Translations/en.json
index 3ec109b0d..317ec4ee3 100644
--- a/Assets/Translations/en.json
+++ b/Assets/Translations/en.json
@@ -679,7 +679,9 @@
       "volumes-step-size-description": "Adjust the step size for volume changes (scroll wheel, keyboard shortcuts).",
       "volumes-step-size-label": "Volume step size",
       "volumes-volume-overdrive-description": "Allow raising volume above 100%. May not be supported by all hardware.",
-      "volumes-volume-overdrive-label": "Allow volume overdrive"
+      "volumes-volume-overdrive-label": "Allow volume overdrive",
+      "volumes-volume-feedback-label": "Play volume feedback sound",
+      "volumes-volume-feedback-description": "Play a feedback sound when adjusting volume"
     },
     "bar": {
       "appearance-background-opacity-description": "Set the background opacity specifically for the bar.",
diff --git a/Assets/Translations/zh-CN.json b/Assets/Translations/zh-CN.json
index 348b6ac9a..858e99882 100644
--- a/Assets/Translations/zh-CN.json
+++ b/Assets/Translations/zh-CN.json
@@ -679,7 +679,9 @@
       "volumes-step-size-description": "调整音量变化的步长（滚轮、键盘快捷键）。",
       "volumes-step-size-label": "音量步长",
       "volumes-volume-overdrive-description": "允许将音量提高到100%以上。可能不被所有硬件支持。",
-      "volumes-volume-overdrive-label": "允许音量过载"
+      "volumes-volume-overdrive-label": "允许音量过载",
+      "volumes-volume-feedback-label": "播放音量反馈",
+      "volumes-volume-feedback-description": "调整音量时播放反馈音效"
     },
     "bar": {
       "appearance-background-opacity-description": "为状态栏设置背景不透明度。",
diff --git a/CREDITS.md b/CREDITS.md
index a626fdd22..50c7302a7 100644
--- a/CREDITS.md
+++ b/CREDITS.md
@@ -33,6 +33,7 @@ Noctalia Shell is made possible by the incredible work of many open-source proje
 ## Audio Assets
 - **[Universfield on Pixabay](https://pixabay.com/users/universfield-28281460/)** - Notification sound effect
 - **[DrNI on Freesound](https://freesound.org/people/DrNI/sounds/34562/)** - Timer's alarm sound effect
+- **[Lucas McCallister on Freesound](http://www.freesound.org/samplesViewSingle.php?id=67091)** - Volume change feedback sound effect
 
 
 ## Special Thanks
diff --git a/Commons/Settings.qml b/Commons/Settings.qml
index f583a3d8d..2f5bfcc41 100644
--- a/Commons/Settings.qml
+++ b/Commons/Settings.qml
@@ -586,6 +586,7 @@ Singleton {
       property string visualizerType: "linear"
       property list<string> mprisBlacklist: []
       property string preferredPlayer: ""
+      property bool volumeFeedback: false
     }
 
     // brightness
diff --git a/Modules/Panels/Settings/Tabs/Audio/VolumesSubTab.qml b/Modules/Panels/Settings/Tabs/Audio/VolumesSubTab.qml
index bc86441af..f4fa88824 100644
--- a/Modules/Panels/Settings/Tabs/Audio/VolumesSubTab.qml
+++ b/Modules/Panels/Settings/Tabs/Audio/VolumesSubTab.qml
@@ -61,6 +61,21 @@ ColumnLayout {
     }
   }
 
+  // Volume Feedback sound Toggle
+  ColumnLayout {
+    spacing: Style.marginS
+    Layout.fillWidth: true
+
+    NToggle {
+      label: I18n.tr("panels.audio.volumes-volume-feedback-label")
+      description: I18n.tr("panels.audio.volumes-volume-feedback-description")
+      checked: Settings.data.audio.volumeFeedback
+      defaultValue: Settings.getDefaultValue("audio.volumeFeedback")
+      onToggled: checked => Settings.data.audio.volumeFeedback = checked
+    }
+  }
+
+
   // Mute Toggle
   ColumnLayout {
     spacing: Style.marginS
diff --git a/Services/Media/AudioService.qml b/Services/Media/AudioService.qml
index aa3949eed..2befa950d 100644
--- a/Services/Media/AudioService.qml
+++ b/Services/Media/AudioService.qml
@@ -4,10 +4,15 @@ import QtQuick
 import Quickshell
 import Quickshell.Services.Pipewire
 import qs.Commons
+import qs.Services.System
 
 Singleton {
   id: root
 
+  // Rate limiting for volume feedback (minimum 100ms between sounds)
+  property var lastVolumeFeedbackTime: 0
+  readonly property int minVolumeFeedbackInterval: 100
+
   // Devices
   readonly property PwNode sink: Pipewire.ready ? Pipewire.defaultAudioSink : null
   readonly property PwNode source: validatedSource
@@ -230,6 +235,8 @@ Singleton {
     sink.audio.muted = false;
     sink.audio.volume = clampedVolume;
 
+    playVolumeFeedback(clampedVolume);
+
     // Clear flag after a short delay to allow external changes to be detected
     Qt.callLater(() => {
                    isSettingOutputVolume = false;
@@ -305,6 +312,29 @@ Singleton {
                  });
   }
 
+  function playVolumeFeedback(currentVolume: real) {
+    if (!SoundService.multimediaAvailable) {
+      return;
+    }
+
+    if (!Settings.data.audio.volumeFeedback) {
+      return;
+    }
+
+    const now = Date.now();
+    if (now - lastVolumeFeedbackTime < minVolumeFeedbackInterval) {
+      return;
+    }
+    lastVolumeFeedbackTime = now;
+
+    const feedbackVolume = currentVolume;
+    SoundService.playSound("volume-change.wav", {
+      volume: feedbackVolume,
+      fallback: false,
+      repeat:  false
+    });
+  }
+
   function setInputMuted(muted: bool) {
     if (!Pipewire.ready || !source?.audio) {
       Logger.w("AudioService", "No source available or Pipewire not ready");