- adding PyRadioResourceOpener class, the window to insert a linux

  resource opener
- fixing #237
- updating docs

Author: s-n-g

README.md

@@ -96,11 +96,9 @@ and much more...
     - python-dateutil
     - netifaces (optional)
 * MPV, MPlayer or VLC installed and in your path
-* MKVToolNix (cli files) to insert tags, chapters and cover to recordings (optional)
+* MKVToolNix (cli files) to insert tags, chapters and cover to recordings (optional, if MPV or VLC is to be used, but mandatory in the case of MPlayer)
 
-Linux users will have to install the "**xdg-utils**" package (may be named differently in your distro) which will provide "**xdg-open**", the utility to open directories, html pages, etc.
-
-Linux and macOS users will have to have installed a font that supports the "**Unicode Geometric Shapes Block**". Any font mentioned in the [Font Support for Unicode Block 'Geometric Shapes'](https://www.fileformat.info/info/unicode/block/geometric_shapes/fontsupport.htm) page will do; as you can see these include **DejaVu**, **FreeMono**, **Unifont**, etc, some of which will fopefully be installed by default.
+Linux users will have to install a [resource opener](https://wiki.archlinux.org/title/default_applications#Resource_openers) package, a utility to open directories, html pages, etc. **PyRadio** will look for *xdg-open*, *gio*, *mimeopen*, *mimeo* or *handlr*, in that order of detection. If a different *resource opener* is used, one can declare it in the **Configuration Window**.
 
 <!-- Changelog -->
 

docs/index.html

@@ -199,10 +199,9 @@ <h2 id="requirements">Requirements <span style="padding-left: 10px;"><sup style=
 <li>netifaces</li>
 </ul></li>
 <li>MPV, MPlayer or VLC installed and in your path</li>
-<li>MKVToolNix (cli files) to insert tags, chapters and cover to recordings (optional)</li>
+<li>MKVToolNix (cli files) to insert tags, chapters and cover to recordings (optional, if MPV or VLC is to be used, but mandatory in the case of MPlayer)</li>
 </ul>
-<p>Linux users will have to install the “<strong>xdg-utils</strong>” package (may be named differently in your distro) which will provide “<strong>xdg-open</strong>”, the utility to open directories, html pages, etc.</p>
-<p>Linux and macOS users will have to have installed a font that supports the “<strong>Unicode Geometric Shapes Block</strong>”. Any font mentioned in the <a target="_blank" href="https://www.fileformat.info/info/unicode/block/geometric_shapes/fontsupport.htm">Font Support for Unicode Block ‘Geometric Shapes’</a> page will do; as you can see these include <strong>DejaVu</strong>, <strong>FreeMono</strong>, <strong>Unifont</strong>, etc, some of which will fopefully be installed by default.</p>
+<p>Linux users will have to install a <a target="_blank" href="https://wiki.archlinux.org/title/default_applications#Resource_openers">resource opener</a> package, a utility to open directories, html pages, etc. <strong>PyRadio</strong> will look for <em>xdg-open</em>, <em>gio</em>, <em>mimeopen</em>, <em>mimeo</em> or <em>handlr</em>, in that order of detection. If a different <em>resource opener</em> is used, one can declare it in the <strong>Configuration Window</strong>.</p>
 <!-- Changelog -->
 <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;">

docs/index.md

@@ -145,11 +145,9 @@ and much more...
     - python-dateutil
     - netifaces
 * MPV, MPlayer or VLC installed and in your path
-* MKVToolNix (cli files) to insert tags, chapters and cover to recordings (optional)
+* MKVToolNix (cli files) to insert tags, chapters and cover to recordings (optional, if MPV or VLC is to be used, but mandatory in the case of MPlayer)
 
-Linux users will have to install the "**xdg-utils**" package (may be named differently in your distro) which will provide "**xdg-open**", the utility to open directories, html pages, etc.
-
-Linux and macOS users will have to have installed a font that supports the "**Unicode Geometric Shapes Block**". Any font mentioned in the [Font Support for Unicode Block 'Geometric Shapes'](https://www.fileformat.info/info/unicode/block/geometric_shapes/fontsupport.htm) page will do; as you can see these include **DejaVu**, **FreeMono**, **Unifont**, etc, some of which will fopefully be installed by default.
+Linux users will have to install a [resource opener](https://wiki.archlinux.org/title/default_applications#Resource_openers) package, a utility to open directories, html pages, etc. **PyRadio** will look for *xdg-open*, *gio*, *mimeopen*, *mimeo* or *handlr*, in that order of detection. If a different *resource opener* is used, one can declare it in the **Configuration Window**.
 
 <!-- Changelog -->
 

pyradio/config

@@ -52,8 +52,9 @@ recording_dir = default
 # Default value is "auto", in which case, PyRadio will try to use xdg-open,
 # gio, mimeopen, mimeo or handlr, in that order of detection.  If none if found,
 # the requested file will simply not open.
-# To set a custom Opener, insert the absolute path to its executable, followed
-# by any parameter required, for example: "/usr/bin/gio open".
+# To set a custom Opener, insert its name (either absolute path to its executable
+# or its name, if it is in your PATH), followedi by any parameter required,
+# for example: "/usr/bin/gio open", "mimeopen -n".
 resource_opener = auto
 
 # Desktop notifications

pyradio/config.py

@@ -1716,6 +1716,10 @@ def remote_control_server_port(self):
     def remote_control_server_auto_start(self):
         return self.opts['remote_control_server_auto_start'][1]
 
+    @property
+    def resource_opener(self):
+        return self.opts['resource_opener'][1]
+
     @property
     def recording_dir(self):
         return self.opts['recording_dir'][1]
@@ -2054,7 +2058,6 @@ def _read_config(self, distro_config=False):
                 self._make_sure_dirs_exist()
                 self._first_read = False
                 return
-        self._linux_resource_opener = None
         lines = []
         try:
             with open(file_to_read, 'r', encoding='utf-8') as cfgfile:
@@ -2228,13 +2231,15 @@ def _read_config(self, distro_config=False):
                     sp[1].lower() == 'true':
                 self.xdg_compliant = True
             elif sp[0] == 'resource_opener' and \
-                    not platform.startswith('win'):
-                if self.opts['resource_opener'][1] != 'auto':
-                    tmp = self.opts['resource_opener'][1].split(' ')
+                    not (platform.startswith('win') or \
+                        platform.startswith('dar')):
+                if sp[1] != 'auto':
+                    tmp = sp[1].split(' ')
                     prog = validate_resource_opener_path(tmp[0])
                     if prog is not None:
                         tmp[0] = prog
                         self._linux_resource_opener = ' '.join(tmp)
+                        self.opts['resource_opener'][1] = sp[1]
 
         # logger.error('\n\nself.params{}\n\n'.format(self.params))
         ''' read distro from package config file '''
@@ -2657,6 +2662,7 @@ def save_config(self, from_command_line=False):
             logger.info('Config saved')
         self.dirty_config = False
         self.params_changed = False
+        self._linux_resource_opener = self.resource_opener
         return 0
 
     def read_playlist_file(

pyradio/config_window.py

@@ -728,6 +728,9 @@ def keypress(self, char):
         if char in self._global_functions.keys():
             self._global_functions[char]()
 
+        elif val[0] == 'resource_opener':
+            return self.n_u.INSERT_RESOURCE_OPENER, []
+
         elif val[0] == 'recording_dir':
             return self.n_u.INSERT_RECORDINGS_DIR_MODE, []