version 0.9.2.2

Author: s-n-g

Changelog

@@ -1,6 +1,6 @@
-2023-03-25 s-n-g
-    * version 0.9.2.2 (not released)
-    * adding support for section headers in playlists
+2023-03-31 s-n-g
+    * version 0.9.2.2
+    * adding support for Groups in playlists
     * making sure that the stations update thread terminates timely
 
 2023-03-24 s-n-g

README.md

@@ -1398,6 +1398,7 @@ As of **v. 0.9.1**, **PyRadio** includes the icon in its distribution files, so
 ## TODO
 
 - [ ] Any user request I find interesting :)
+- [ ] Use some kind of a scheduler
 - [x] Use Radio Browser service ([#80](https://github.com/coderholic/pyradio/issues/80) [#93](https://github.com/coderholic/pyradio/issues/93) [#112](https://github.com/coderholic/pyradio/issues/112)) - v 0.9.0
 - [ ] Use some OPML service, [https://opml.radiotime.com](https://opml.radiotime.com) for example
 - [x] Notify the user that the package's stations.csv has changed -v 0.8.9

pyproject.toml

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

pyradio/__init__.py

@@ -1,6 +1,6 @@
 " pyradio -- Console radio player. "
 
-version_info = (0, 9, 2, 1)
+version_info = (0, 9, 2, 2)
 
 # Set it to True if new stations have been
 # added to the package's stations.csv

pyradio/radio.py

@@ -551,6 +551,7 @@ def __init__(self, pyradio_config,
             self.ws.UPDATE_STATIONS_CSV_RESULT_MODE: self._update_stations_result,
             self.ws.ASK_TO_UPDATE_STATIONS_CSV_MODE: self._ask_to_update_stations_csv,
             self.ws.GROUP_SELECTION_MODE: self._show_group_selection,
+            self.ws.GROUP_HELP_MODE: self._show_group_help,
         }
 
         ''' list of help functions '''
@@ -579,6 +580,7 @@ def __init__(self, pyradio_config,
             self.ws.RADIO_BROWSER_SEARCH_HELP_MODE: self._show_radio_browser_search_help,
             self.ws.RADIO_BROWSER_CONFIG_HELP_MODE: self._show_radio_browser_config_help,
             self.ws.BROWSER_CONFIG_SAVE_ERROR_MODE: self._print_browser_config_save_error,
+            self.ws.GROUP_HELP_MODE: self._show_group_help,
         }
 
         ''' search classes
@@ -2722,6 +2724,22 @@ def _show_radio_browser_config_help(self):
                         mode_to_set=self.ws.RADIO_BROWSER_CONFIG_HELP_MODE,
                         caption=' RadioBrowser Config Help ')
 
+    def _show_group_help(self):
+        txt = '''Up|,|j|,|PgUp|,
+                 Down|,|k|,|PgDown    |Change Group Header selection.
+                 g G              |Go to first / last Group Header.
+                 H M L            |Go to top / middle / bottom of screen.
+                 Space|, |Left|, |Enter
+                 _________________|Select a Group Header.
+                 Esc|,|q            |Cancel.
+                 %_Global functions_
+                 -|/|+| or |,|/|.       |Change volume.
+                 m| / |v            ||M|ute player / Save |v|olume (not in vlc).
+                 W| / |w            |Toggle title log / like a station.'''
+        self._show_help(txt,
+                        mode_to_set=self.ws.GROUP_HELP_MODE,
+                        caption=' Group Selection Help ')
+
     def _show_main_help(self, from_keyboard=False):
         txt = '''Up|,|j|,|PgUp|,
                  Down|,|k|,|PgDown    |Change station selection.
@@ -2822,12 +2840,16 @@ def _show_main_help_page_4(self, from_keyboard=False):
 
     def _show_main_help_page_5(self, from_keyboard=False):
         txt = '''!Change Player
-                 \m               |Open player selection window.
+                 \m               |Open the |Player Selection| window.
                  !Remote Control Server
                  \s               |Start/Stop the |Server|.
                  !Title Logger
                  W                |Toggle Logger on/off
                  w                |Tag a station as liked
+                 !Group Management
+                 a A              |Add a |Group| (set |URL| = |-|).
+                 ^E |/ |^Y          |Go to next /previous |Group|.
+                 ^G               |Open the |Group Selection| window.
                  !Windows Only
                  F7               |Delete old installation files.
                  F8               |Players management.
@@ -7761,6 +7783,7 @@ def keypress(self, char):
                 self.refreshBody()
             elif ret == 2:
                 ''' show help '''
+                self._show_group_help()
                 pass
             return
 

pyradio/window_stack.py

@@ -97,6 +97,7 @@ class Window_Stack_Constants(object):
     UPDATE_STATIONS_CSV_RESULT_MODE = 136
     GROUP_SELECTION_MODE = 137
     GROUP_SEARCH_MODE = 138
+    GROUP_HELP_MODE = 139
     # TODO: return values from opening theme
     PLAYLIST_RECOVERY_ERROR_MODE = 200
     PLAYLIST_NOT_FOUND_ERROR_MODE = 201
@@ -277,7 +278,8 @@ class Window_Stack_Constants(object):
         UPDATE_NOTIFICATION_MODE: 'UPDATE_NOTIFICATION_MODE',
         UPDATE_STATIONS_CSV_RESULT_MODE: 'UPDATE_STATIONS_CSV_RESULT_MODE',
         GROUP_SELECTION_MODE: 'GROUP_SELECTION_MODE',
-        GROUP_SEARCH_MODE: 'GROUP_SEARCH_MODE'
+        GROUP_SEARCH_MODE: 'GROUP_SEARCH_MODE',
+        GROUP_HELP_MODE: 'GROUP_HELP_MODE',
     }
 
     ''' When PASSIVE_WINDOWS target is one of them,
@@ -361,6 +363,7 @@ class Window_Stack_Constants(object):
         CHANGE_PLAYER_ONE_PLAYER_ERROR_MODE,
         CHANGE_PLAYER_SAME_PLAYER_ERROR_MODE,
         UPDATE_STATIONS_CSV_RESULT_MODE,
+        GROUP_HELP_MODE,
     )
 
     def __init__(self):