From 174393b3907480da661662c92488355bd859bd77 Mon Sep 17 00:00:00 2001
From: Kobe De Peuter <development@kobedepeuter.be>
Date: Mon, 11 May 2026 21:08:56 +0200
Subject: [PATCH] feat: modify TTS speaking rate for notifications

---
 extension/entrypoints/background/notifications.ts | 2 ++
 extension/entrypoints/offscreen/offscreen.ts      | 5 ++++-
 extension/entrypoints/options/index.html          | 4 ++++
 extension/entrypoints/options/settings.ts         | 2 ++
 extension/utils/common/data/default-database.ts   | 1 +
 public/changelog.json                             | 3 ++-
 6 files changed, 15 insertions(+), 2 deletions(-)

diff --git a/extension/entrypoints/background/notifications.ts b/extension/entrypoints/background/notifications.ts
index 8064ca22e..9bf141f85 100644
--- a/extension/entrypoints/background/notifications.ts
+++ b/extension/entrypoints/background/notifications.ts
@@ -189,6 +189,7 @@ export async function notifyUser(title: string, message: string, url?: string) {
 
 				if (matchedVoice) ttsMessage.voice = matchedVoice;
 			}
+			ttsMessage.rate = settings.notifications.ttsRate;
 			window.speechSynthesis.speak(ttsMessage);
 		} else {
 			// Offscreen documents
@@ -199,6 +200,7 @@ export async function notifyUser(title: string, message: string, url?: string) {
 				text: text,
 				volume: settings.notifications.volume / 100,
 				voice: settings.notifications.ttsVoice,
+				rate: settings.notifications.ttsRate,
 			} satisfies OffscreenMessage);
 		}
 	}
diff --git a/extension/entrypoints/offscreen/offscreen.ts b/extension/entrypoints/offscreen/offscreen.ts
index 41b464bba..831bf4b65 100644
--- a/extension/entrypoints/offscreen/offscreen.ts
+++ b/extension/entrypoints/offscreen/offscreen.ts
@@ -16,9 +16,10 @@ interface PlayTTSOptions {
 	text: string;
 	volume: number;
 	voice: string;
+	rate: number;
 }
 
-function playTTS({ text, volume, voice }: PlayTTSOptions) {
+function playTTS({ text, volume, voice, rate }: PlayTTSOptions) {
 	const ttsMessage = new SpeechSynthesisUtterance(text);
 	ttsMessage.volume = volume;
 	if (voice !== "default") {
@@ -26,6 +27,8 @@ function playTTS({ text, volume, voice }: PlayTTSOptions) {
 
 		if (matchedVoice) ttsMessage.voice = matchedVoice;
 	}
+	ttsMessage.rate = rate;
+
 	window.speechSynthesis.speak(ttsMessage);
 }
 
diff --git a/extension/entrypoints/options/index.html b/extension/entrypoints/options/index.html
index e5c81fae3..32ace6415 100644
--- a/extension/entrypoints/options/index.html
+++ b/extension/entrypoints/options/index.html
@@ -737,6 +737,10 @@ <h2>
 							<input id="notification-tts" type="checkbox" />
 							<label for="notification-tts">Use text-to-speech.</label>
 						</div>
+						<div class="option tabbed">
+							<label for="notification-ttsRate">Rate</label>
+							<input id="notification-ttsRate" type="number" min="0.1" max="10" step="0.1" />
+						</div>
 						<div class="option">
 							<input id="notification-link" type="checkbox" />
 							<label for="notification-link">Open the corresponding link when clicking a notification.</label>
diff --git a/extension/entrypoints/options/settings.ts b/extension/entrypoints/options/settings.ts
index 3580ccfc1..ce47127e8 100644
--- a/extension/entrypoints/options/settings.ts
+++ b/extension/entrypoints/options/settings.ts
@@ -744,6 +744,7 @@ async function setupPreferences(requireCleanup: boolean = false) {
 
 		_preferences.querySelector<HTMLInputElement>("#notification-sound").value = settings.notifications.sound;
 		_preferences.querySelector<HTMLInputElement>("#notification-tts").checked = settings.notifications.tts;
+		_preferences.querySelector<HTMLInputElement>("#notification-ttsRate").value = settings.notifications.ttsRate.toString();
 		_preferences.querySelector<HTMLInputElement>("#notification-link").checked = settings.notifications.link;
 		_preferences.querySelector<HTMLInputElement>("#notification-requireInteraction").checked = settings.notifications.requireInteraction;
 		_preferences.querySelector<HTMLInputElement>("#notification-volume").value = settings.notifications.volume.toString();
@@ -1202,6 +1203,7 @@ async function setupPreferences(requireCleanup: boolean = false) {
 
 		settings.notifications.tts = _preferences.querySelector<HTMLInputElement>("#notification-tts").checked;
 		settings.notifications.ttsVoice = _preferences.querySelector<HTMLInputElement>("#tts-voice").value;
+		settings.notifications.ttsRate = parseFloat(_preferences.querySelector<HTMLInputElement>("#notification-ttsRate").value);
 		settings.notifications.link = _preferences.querySelector<HTMLInputElement>("#notification-link").checked;
 		settings.notifications.requireInteraction = _preferences.querySelector<HTMLInputElement>("#notification-requireInteraction").checked;
 		settings.notifications.volume = parseInt(_preferences.querySelector<HTMLInputElement>("#notification-volume").value);
diff --git a/extension/utils/common/data/default-database.ts b/extension/utils/common/data/default-database.ts
index def4160db..af26b9beb 100644
--- a/extension/utils/common/data/default-database.ts
+++ b/extension/utils/common/data/default-database.ts
@@ -71,6 +71,7 @@ export const DEFAULT_STORAGE = {
 			soundCustom: new DefaultSetting("string", ""),
 			tts: new DefaultSetting("boolean", false),
 			ttsVoice: new DefaultSetting("string", "default"),
+			ttsRate: new DefaultSetting("number", 1),
 			link: new DefaultSetting("boolean", true),
 			volume: new DefaultSetting("number", 100),
 			requireInteraction: new DefaultSetting("boolean", false),
diff --git a/public/changelog.json b/public/changelog.json
index 77c726df6..5ad142b57 100644
--- a/public/changelog.json
+++ b/public/changelog.json
@@ -6,7 +6,8 @@
 		"logs": {
 			"features": [
 				{ "message": "'FF Scouter' score filter for ranked wars.", "contributor": "DeKleineKobini" },
-				{ "message": "Labels for stakeouts.", "contributor": "DeKleineKobini" }
+				{ "message": "Labels for stakeouts.", "contributor": "DeKleineKobini" },
+				{ "message": "Modify TTS speaking rate for notifications.", "contributor": "DeKleineKobini" }
 			],
 			"fixes": [
 				{ "message": "Filtering on profit in the 'Stocks Filter' gave errors for stocks you don't own.", "contributor": "DeKleineKobini" },