- version 0.9.3.11.21

- adding TTS volume properly
- adding confirmation message to TTS when config file saved

Author: s-n-g

docs/tts.html

@@ -70,6 +70,10 @@ <h2 id="table-of-contents">Table of Contents <span style="padding-left: 10px;"><
 <li><a href="#for-multi-language-content">For Multi-Language Content</a></li>
 </ul></li>
 <li><a href="#configuration-philosophy">Configuration Philosophy</a></li>
+<li><a href="#configuration-options">Configuration Options</a>
+<ul>
+<li><a href="#volume">Volume</a></li>
+</ul></li>
 <li><a href="#current-status-&amp;-roadmap">Current Status &amp; Roadmap</a></li>
 </ul>
 <!-- vim-markdown-toc -->
@@ -153,6 +157,15 @@ <h2 id="configuration-philosophy">Configuration Philosophy <span style="padding-
 <li>Maintains your preferred speech rate and volume</li>
 <li>Platform-native experience throughout</li>
 </ul>
+<h2 id="configuration-options">Configuration Options <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="volume">Volume</h3>
+<p>The TTS volume can be adjusted independently of audio playback volume:</p>
+<ul>
+<li><strong>Linux</strong>: Uses spd-say with volume range from <strong>-100 to +100</strong> (relative to base volume)</li>
+<li><strong>Windows</strong>: Uses SAPI with volume range from <strong>0 to 100</strong> (absolute)</li>
+<li><strong>macOS</strong>: Volume control is not supported - uses system speech volume</li>
+</ul>
+<p>This option can be found in the configuration menu under <strong>Config → TTS → Volume</strong>.</p>
 <h2 id="current-status-roadmap">Current Status &amp; Roadmap <span style="padding-left: 10px;"><sup style="font-size: 50%"><a href="#" title="Go to top of the page">Top</a></sup></span></h2>
 <p>This TTS implementation is actively developed. Planned enhancements include:</p>
 <ul>

docs/tts.md

@@ -26,6 +26,8 @@
     * [For English-Dominant Users](#for-english-dominant-users)
     * [For Multi-Language Content](#for-multi-language-content)
 * [Configuration Philosophy](#configuration-philosophy)
+* [Configuration Options](#configuration-options)
+    * [Volume](#volume)
 * [Current Status & Roadmap](#current-status-&-roadmap)
 
 <!-- vim-markdown-toc -->
@@ -120,6 +122,18 @@ The system is optimized for English while respecting platform conventions:
 - Maintains your preferred speech rate and volume
 - Platform-native experience throughout
 
+## Configuration Options
+
+### Volume
+
+The TTS volume can be adjusted independently of audio playback volume:
+
+- **Linux**: Uses `spd-say` with volume range from **-100 to +100** (relative to base volume)
+- **Windows**: Uses SAPI with volume range from **0 to 100** (absolute)
+- **macOS**: Volume control is not supported - uses system speech volume
+
+This option can be found in the configuration menu under **Config → TTS → Volume**.
+
 ## Current Status & Roadmap
 
 This TTS implementation is actively developed. Planned enhancements include:
@@ -128,4 +142,3 @@ This TTS implementation is actively developed. Planned enhancements include:
 - Detailed interface element descriptions
 - Enhanced context-aware speech patterns
 - Extended configuration options
-

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "pyradio"
-version = "0.9.3.11.20"
+version = "0.9.3.11.21"
 authors = [
   { name="Ben Dowling", email="[email protected]" },
   { name="Spiros Georgaras", email="[email protected]" },

pyradio/__init__.py

@@ -1,7 +1,7 @@
 # -*- coding: utf-8 -*-
 " pyradio -- Console radio player. "
 
-version_info = (0, 9, 3, 11, 20)
+version_info = (0, 9, 3, 11, 21)
 
 # Set it to True if new stations have been
 # added to the package's stations.csv

pyradio/config

@@ -133,6 +133,13 @@ remove_station_icons = True
 # Default value: False
 enable_tts = False
 
+# TTS Volume
+# This is the volume to be used by the TTS engine
+# It applies to Linux and Windows only
+#
+# Default value: 50
+tts_volume = 50
+
 # Titles logging
 # If this option is True, PyRadio will start logging song titles to a log file
 # at startup, provided that the station playing does provide title data.

pyradio/config.py

@@ -1361,7 +1361,8 @@ def _init_vars(self):
         self.opts['use_station_icon'] = ['  Use station icon: ', True]
         self.opts['remove_station_icons'] = ['  Remove cached icons: ', True]
         self.opts['tts_title'] = ['TTS', '']
-        self.opts['enable_tts'] = ['  Enable TTS: ', False]
+        self.opts['enable_tts'] = ['Enable TTS: ', False]
+        self.opts['tts_volume'] = ['  Volume: ', '50']
         self.opts['clock_title'] = ['Clock', '']
         self.opts['enable_clock'] = ['Display on startup: ', False]
         self.opts['time_format'] = ['Time format: ', '1']
@@ -1712,6 +1713,16 @@ def enable_tts(self, val):
         self.opts['enable_tts'][1] = val
         self.opts['dirty_config'][1] = True
 
+    @property
+    def tts_volume(self):
+        ''' connection timeout as string '''
+        return self.opts['tts_volume'][1]
+
+    @tts_volume.setter
+    def tts_volume(self, val):
+        self.opts['tts_volume'][1] = val
+        self.opts['dirty_config'][1] = True
+
     @property
     def player(self):
         return self.opts['player'][1]
@@ -2561,6 +2572,8 @@ def _read_config(self, distro_config=False):
                     self.opts['enable_tts'][1] = False
                 else:
                     self.opts['enable_tts'][1] = True
+            elif sp[0] == 'tts_volume':
+                    self.opts['tts_volume'][1] = sp[1]
             elif sp[0] == 'confirm_station_deletion':
                 if sp[1].lower() == 'false':
                     self.opts['confirm_station_deletion'][1] = False
@@ -3138,31 +3151,6 @@ def save_config(self, from_command_line=False):
             with open(self.config_file, 'w', encoding='utf-8') as cfgfile:
                 if out:
                     cfgfile.write('\n'.join(out) + '\n')
-                # cfgfile.write(txt.format(
-                #     self.opts['player'][1],
-                #     self.opts['open_last_playlist'][1],
-                #     self.opts['default_playlist'][1],
-                #     self.opts['default_station'][1],
-                #     self.opts['default_encoding'][1],
-                #     self.opts['enable_mouse'][1],
-                #     self.opts['enable_notifications'][1],
-                #     self.opts['use_station_icon'][1],
-                #     rec_dir,
-                #     self.opts['connection_timeout'][1],
-                #     self.opts['force_http'][1],
-                #     theme,
-                #     trnsp,
-                #     self.opts['force_transparency'][1],
-                #     calcf,
-                #     self.opts['confirm_station_deletion'][1],
-                #     self.opts['confirm_playlist_reload'][1],
-                #     self.opts['auto_save_playlist'][1],
-                #     self.show_no_themes_message,
-                #     self.show_recording_start_message,
-                #     self.remote_control_server_ip,
-                #     self.remote_control_server_port,
-                #     self.remote_control_server_auto_start
-                # ))
 
             ''' write extra player parameters to file '''
             if path.exists(self.player_params_file):

pyradio/config_window.py

@@ -41,6 +41,7 @@
 class PyRadioConfigWindow():
     _title = 'PyRadio Configuration'
 
+    _tts_volume_date = (0, 0, 0)
     _help_text = []
     _help_text.append(None)
     _help_text.append(['Specify the player to use with PyRadio, or the player detection order.', '|',
@@ -80,7 +81,15 @@ class PyRadioConfigWindow():
     _help_text.append(['Notice: Not applicable on Windows!', '|',  'Online Radio Directory Services (like RadioBrowser) will usually provide an icon for the stations they advertise.', '|', 'PyRadio can use this icon (provided that one exists and is of JPG or PNG format) while displaying Desktop Notifications.', '|', 'Setting this option to True, will enable the behavior above.', '|', 'If this option is False, the default icon will be used.', '|', 'Default value: True'])
     _help_text.append(['Notice: Not applicable on Windows!', '|', 'If the previous option is enabled, Stations Icons will be cached.', '|', 'If this option is set to True, all icons will be deleted at program exit.', '|', 'If set to False, the icons will be available for future use.', '|', 'Default value: True'])
     _help_text.append(None)
-    _help_text.append(['PyRadio now features comprehensive Text-to-Speech (TTS) support, providing auditory feedback for an enhanced radio streaming experience.', '|', 'This system delivers contextual information about station navigation, playback status, and system events.', '|', 'Default value: False'])
+    _help_text.append(['PyRadio now features comprehensive Text-to-Speech (TTS) support, providing auditory feedback for an enhanced radio streaming experience.', '|', 'This system delivers contextual information about station navigation, playback status, and system events.', '|', 'The TTS function cal also be termporarily toggled by pressing ' + to_str('open_extra') + to_str('toggle_tts') + '.', '|', 'Default value: False'])
+    if platform.startswith('dar'):
+        _help_text.append(['This option will not be used by the TTS engine.', '|', 'Adjust the System Volume instead.'])
+    elif platform.startswith('win'):
+        _help_text.append(['This is the volume to be used by the TTS engine.', '|', 'Valid values: 0 (silent) - 100', '|', 'Default value: 50'])
+        _tts_volume_date = (0, 100, 5)
+    else:
+        _help_text.append(['This is the volume to be used by the speech dispatcher, provided that the engine selected supports it.', '|', 'Valid values: -100,+100', '|', 'Default value: 50'])
+        _tts_volume_date = (-100, 100, 10)
     _help_text.append(None)
     _help_text.append(['If this option is enabled, the current time will be displayed at the bottom left corner of the window at program startup.', '|', 'Adjust the time format in the next option to change how the current time is displayed.', '|', r'You can always hide it by pressing ' + to_str('open_extra') + to_str('toggle_time') +  '.', '|', 'Default value: False'])
     _help_text.append(['This is the time format to be used when the clock is visible.', '|', 'Available values are:', '   0: 24h, with seconds', '   1: 24h, no seconds', '   2: 12h, with am/pm and seconds', '   3: 12h, no am/pm, with seconds', '   4: 12h, with am/pm, no seconds', '   5: 12h, no am/pm, no seconds', '|', 'Default value: 1'])
@@ -813,6 +822,7 @@ def keypress(self, char):
                 'time_format',
                 'buffering',
                 'mplayer_save_br',
+                'tts_volume',
             ) and char in (
                 curses.KEY_LEFT,
                 curses.KEY_RIGHT,
@@ -1123,6 +1133,37 @@ def keypress(self, char):
                 self._win.refresh()
                 return -1, []
 
+        elif val[0] == 'tts_volume':
+            if char in (curses.KEY_RIGHT, kbkey['l']) or \
+                    check_localized(char, (kbkey['l'], )):
+                t = int(val[1][1])
+                if t < self._tts_volume_date[1]:
+                    t += self._tts_volume_date[2]
+                    if t > self._tts_volume_date[1]:
+                        t = self._tts_volume_date[1]
+                    self._config_options[val[0]][1] = str(t)
+                    self._win.addstr(
+                        Y, 3 + len(val[1][0]),
+                        str(t) + ' ', curses.color_pair(6))
+                    self._print_title()
+                    self._win.refresh()
+                return -1, []
+
+            elif char in (curses.KEY_LEFT, kbkey['h']) or \
+                    check_localized(char, (kbkey['h'], )):
+                t = int(val[1][1])
+                if t > self._tts_volume_date[0]:
+                    t -= self._tts_volume_date[2]
+                if t < self._tts_volume_date[0]:
+                    t = self._tts_volume_date[0]
+                self._config_options[val[0]][1] = str(t)
+                self._win.addstr(
+                    Y, 3 + len(val[1][0]),
+                    str(t) + ' ', curses.color_pair(6))
+                self._print_title()
+                self._win.refresh()
+                return -1, []
+
         if char in (curses.KEY_ENTER, ord('\n'), ord('\r'),
                     kbkey['pause'], kbkey['l'], curses.KEY_RIGHT) or \
                     check_localized(char, (kbkey['l'], kbkey['pause'])):

pyradio/install.py

@@ -17,7 +17,7 @@
 ''' This is PyRadio version this
     install.py was released for
 '''
-PyRadioInstallPyReleaseVersion = '0.9.3.11.20'
+PyRadioInstallPyReleaseVersion = '0.9.3.11.21'
 
 locale.setlocale(locale.LC_ALL, "")
 

pyradio/messages_system.py

@@ -749,7 +749,7 @@ def set_text(self, parent, *args):
 |{}|'s configuration has been altered
 but not saved. Do you want to save it now?
 
-Press |{y}| to save it or |n| to disregard it.
+Press |{y}| to save it or |{n}| to disregard it.
 '''
 )),
 
@@ -1730,8 +1730,10 @@ def set_text(self, parent, *args):
                 pass
         self.simple_dialog = False
         self._txt = {}
+        return text
 
-    def __init__(self, config, op_mode, prev_op_mode):
+    def __init__(self, config, op_mode, prev_op_mode, speak_high):
+        self._speak_high = speak_high
         self._args = None
         self._txt = None
         self._active_token = None

pyradio/radio.py

@@ -513,6 +513,7 @@ def __init__(self, pyradio_config,
                     do not display any message
         '''
 
+        self._tts_volume = pyradio_config.tts_volume
         self._enable_tts = pyradio_config.enable_tts
         self.ws = Window_Stack(self._speak_selection)
         self.player = None
@@ -869,7 +870,8 @@ def __init__(self, pyradio_config,
         self._messaging_win = PyRadioMessagesSystem(
                 self._cnf,
                 lambda: self.ws.operation_mode,
-                lambda: self.ws.previous_operation_mode
+                lambda: self.ws.previous_operation_mode,
+                lambda: self._speak_high
         )
 
         ''' keep resource opener from Opener Selection window.
@@ -2134,7 +2136,7 @@ def run(self):
             except KeyboardInterrupt:
                 pass
         else:
-            self.tts = TTSManager(self._cnf.enable_tts)
+            self.tts = TTSManager(self._cnf.enable_tts, volume=lambda: self._tts_volume)
             ''' start update detection and notification thread '''
             if CAN_CHECK_FOR_UPDATES:
                 if self._cnf.locked:
@@ -3344,7 +3346,9 @@ def _open_simple_message_by_key(self, *args):
 
     def _open_message_win_by_key(self, *args):
         # logger.error('args = "{}"'.format(args))
-        self._messaging_win.set_text(self.bodyWin, *args)
+        text = self._messaging_win.set_text(self.bodyWin, *args)
+        # self._speak_high(''.join(text).replace('|', '').replace('ESC', 'escape'))
+        logger.error('\n\ntext =\n{}\n\n'.format(text))
         self.ws.operation_mode = self._message_system_default_operation_mode
         self._messaging_win.show()
 
@@ -7279,7 +7283,7 @@ def keypress(self, char):
                 self.tts.set_enabled(False)
                 sleep(0.1)
                 self.tts = None
-                self.tts = TTSManager(enabled=True)
+                self.tts = TTSManager(enabled=True, volume=lambda: self._tts_volume)
                 # self.tts.set_enabled(self._enable_tts)
                 if self._enable_tts:
                     self.tts.queue_speech('T T S enabled', Priority.HIGH)
@@ -8022,6 +8026,7 @@ def keypress(self, char):
                     self._cnf.backup_player_params[0] = self._cnf.params[self._cnf.PLAYER_NAME][:]
                     ret = self._cnf.save_config()
                     if ret == -1:
+                        # self._speak_high(msg[0])
                         ''' Error saving config '''
                         if self.player.isPlaying():
                             self.stopPlayer()
@@ -8030,6 +8035,9 @@ def keypress(self, char):
                         self.log.write(msg_id=STATES.ANY, msg=msg[0], help_msg=False, suffix=self._status_suffix)
                         self._print_config_save_error()
                     elif ret == 0:
+                        if self._enable_tts:
+                            self.tts.queue_speech('Config saved successfully', Priority.HIGH)
+                        # self._speak_high(msg[1])
                         ''' Config saved successfully '''
 
                         ''' update functions dicts '''
@@ -8152,6 +8160,18 @@ def keypress(self, char):
                                 self._cnf.buffering_data = []
                             else:
                                 self._update_config_buffering_data(reset=False)
+
+                        # update TTS
+                        logger.error('\n\n\n')
+                        logger.error(f'{self._cnf.enable_tts = }')
+                        logger.error(f'{self._enable_tts = }')
+                        logger.error('\n\n\n')
+                        if self._enable_tts != self._cnf.enable_tts:
+                            self._enable_tts = self._cnf.enable_tts
+                            self.tts.set_enabled(self._enable_tts)
+                            if self._enable_tts:
+                                self.tts.queue_speech('Config saved successfully', Priority.HIGH)
+                        self._tts_volume = self._cnf.tts_volume
                     elif ret == 1:
                         ''' config not modified '''
                         self._show_notification_with_delay(