- updating docs

Author: s-n-g

Changelog

@@ -1,3 +1,9 @@
+2025-11-06 s-n-g
+    * version 0.9.3.11.21 - 0.9.3.12-beta21
+    * fixing #312 - VLC crashes PyRadio after the radio station starts playing
+    * fixing several minor bugs
+    * adding basic TTS support (enabled from config or the toggle option \T)
+
 2025-10-23 s-n-g
     * version 0.9.3.11.20 - 0.9.3.12-beta20
     * adding error messages for charset-normalizer module not found (#305)

docs/index.html

@@ -197,6 +197,12 @@ <h2 id="requirements">Requirements <span style="padding-left: 10px;"><sup style=
 <h2 id="changelog">Changelog <span style="padding-left: 10px;"><sup style="font-size: 50%"><a href="#" title="Go to top of the page">Top</a></sup></span></h2>
 <pre style="height: 200px;">
 
+2025-11-06 s-n-g
+    * version 0.9.3.11.21 - 0.9.3.12-beta21
+    * fixing #312 - VLC crashes PyRadio after the radio station starts playing
+    * fixing several minor bugs
+    * adding basic TTS support (enabled from config or the toggle option \T)
+
 2025-10-23 s-n-g
     * version 0.9.3.11.20 - 0.9.3.12-beta20
     * adding error messages for charset-normalizer module not found (#305)

docs/tts.html

@@ -91,7 +91,7 @@ <h3 id="temporary-activation">Temporary Activation</h3>
 <p>Toggle TTS during runtime by pressing <strong>\T</strong> (backslash + T). This setting is session-only and resets when restarting PyRadio.</p>
 <h2 id="platform-implementation">Platform Implementation <span style="padding-left: 10px;"><sup style="font-size: 50%"><a href="#" title="Go to top of the page">Top</a></sup></span></h2>
 <h3 id="linux">Linux</h3>
-<p>Utilizes <strong>speech-dispatcher</strong> configured for English language by default. Provides robust, interruptible speech synthesis with priority-based queue management.</p>
+<p>Utilizes <a target="_blank" href="https://freebsoft.org/speechd">speech-dispatcher</a> configured for English language by default. Provides robust, interruptible speech synthesis with priority-based queue management.</p>
 <h3 id="windows">Windows</h3>
 <p>Leverages <strong>Windows SAPI (Speech API)</strong> with automatic selection of English voices when available. Features immediate speech interruption and consistent volume control.</p>
 <h3 id="macos">macOS</h3>

docs/tts.md

@@ -54,7 +54,7 @@ Toggle TTS during runtime by pressing **\\T** (backslash + T). This setting is s
 ## Platform Implementation
 
 ### Linux
-Utilizes **speech-dispatcher** configured for English language by default. Provides robust, interruptible speech synthesis with priority-based queue management.
+Utilizes [speech-dispatcher](https://freebsoft.org/speechd) configured for English language by default. Provides robust, interruptible speech synthesis with priority-based queue management.
 
 ### Windows  
 Leverages **Windows SAPI (Speech API)** with automatic selection of English voices when available. Features immediate speech interruption and consistent volume control.

pyradio/radio.py

@@ -512,6 +512,7 @@ def __init__(self, pyradio_config,
             in log.write, if _current_player_id != _active_player_id
                     do not display any message
         '''
+
         self._enable_tts = pyradio_config.enable_tts
         self.ws = Window_Stack(self._speak_selection)
         self.player = None
@@ -6767,9 +6768,8 @@ def _speak_normal(self, msg):
         self.tts.queue_speech(msg, Priority.NORMAL)
 
     def _speak_selection(self):
-        if self.ws.operation_mode == self.ws.NORMAL_MODE:
-            self.tts.queue_speech(f'{self.selection+1}, {self.stations[self.selection][0]}', Priority.NORMAL)
-        elif self.ws.operation_mode == self.ws.PLAYLIST_MODE:
+        if self._enable_tts and \
+                self.ws.operation_mode in (self.ws.NORMAL_MODE, self.ws.PLAYLIST_MODE):
             self.tts.queue_speech(f'{self.selection+1}, {self.stations[self.selection][0]}', Priority.NORMAL)
 
     def keypress(self, char):