verion 0.9.3.7

Changelog

@@ -1,3 +1,23 @@
+2024-05-24 s-n-g
+    * version 0.9.3.7
+    * introducing the pyradio-client program
+    * adding three more System Themes
+    * do not allow to change the Recording Directory while recording
+      is on either in this instance or a headless instance
+    * fix PyRadioOpenDir: always open dir
+    * PyRadioRecordingDir: adding key 'd' to revert to deault
+    * fixing default opener detection
+    * if a linux opener is enetered but config not saved, and opener
+      window is opened again, display the one entered instead of the
+      saved opener
+    * fix stop mkvmerge recursive execution
+    * Remote Control Server: adding a warning to the info response,
+      if PyRadio is not in Main Mode
+    * Remote Control Server: introducing the /reconfig command
+    * Desktop Notifications: stations icons are now being cached
+    * config: adding parameter remove_station_icons, to remove
+      downloaded files on program exit
+
 2024-05-10 s-n-g
     * version 0.9.3.6
     * fixing #241 - pyradio-recordings folder keeps showing in home directory

docs/index.html

@@ -209,6 +209,26 @@ <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;">
 
+2024-05-24 s-n-g
+    * version 0.9.3.7
+    * introducing the pyradio-client program
+    * adding three more System Themes
+    * do not allow to change the Recording Directory while recording
+      is on either in this instance or a headless instance
+    * fix PyRadioOpenDir: always open dir
+    * PyRadioRecordingDir: adding key 'd' to revert to deault
+    * fixing default opener detection
+    * if a linux opener is enetered but config not saved, and opener
+      window is opened again, display the one entered instead of the
+      saved opener
+    * fix stop mkvmerge recursive execution
+    * Remote Control Server: adding a warning to the info response,
+      if PyRadio is not in Main Mode
+    * Remote Control Server: introducing the /reconfig command
+    * Desktop Notifications: stations icons are now being cached
+    * config: adding parameter remove_station_icons, to remove
+      downloaded files on program exit
+
 2024-05-10 s-n-g
     * version 0.9.3.6
     * fixing #241 - pyradio-recordings folder keeps showing in home directory

docs/packaging.html

@@ -48,7 +48,10 @@ <h2 id="table-of-contents">Table of Contents <span style="padding-left: 10px;"><
 <ul>
 <li><a href="#distro-name-(must-do)">distro name (must do)</a></li>
 <li><a href="#xdg-base-directory-specification-compliance">XDG Base Directory Specification Compliance</a></li>
-<li><a href="#desktop-notifications-(optional)">Desktop Notifications (optional)</a></li>
+<li><a href="#desktop-notifications-(optional)">Desktop Notifications (optional)</a>
+<ul>
+<li><a href="#desktop-notification-icons-(optional)">Desktop Notification Icons (optional)</a></li>
+</ul></li>
 <li><a href="#desktop-file-location">Desktop File location</a></li>
 <li><a href="#pyradio/__pycache__">pyradio/__pycache__</a></li>
 </ul></li>
@@ -98,6 +101,11 @@ <h3 id="desktop-notifications-optional">Desktop Notifications (optional)</h3>
 <p>to display titles whenever they are received, or</p>
 <pre>sed -i &#39;s/enable_notifications = -1/enable_notifications = 60/&#39; pyradio/config</pre>
 <p>to have notifications every 60 seconds, for example. You can use any value here, starting from 30 to 300 (meaning every 30 seconds up to 5 minutes), using a step of 30.</p>
+<h4 id="desktop-notification-icons-optional">Desktop Notification Icons (optional)</h4>
+<p><strong>PyRadio</strong> will download stations logos (icons) in the “<em>logos</em>” cache directory.</p>
+<p>This directory will be deleted at program exit, by default.</p>
+<p>If you want to keep the downloaded icons, do a</p>
+<pre>sed -i &#39;s/remove_station_icons  = True/remove_station_icons   = False/&#39; pyradio/config</pre>
 <h3 id="desktop-file-location">Desktop File location</h3>
 <p>If the Desktop File is not installed in <em>/usr/share/applications</em> or <em>/usr/local/share/applications</em>, it will have to be passed as a parameter to the script that will handle it, like so:</p>
 <pre>sed -i &quot;s,&#39; -t &#39;,&#39; -d /path/to/desktop_file&#39; + &amp;,&quot; pyradio/main.py</pre>

docs/packaging.md

@@ -8,6 +8,7 @@
     * [distro name (must do)](#distro-name-(must-do))
     * [XDG Base Directory Specification Compliance](#xdg-base-directory-specification-compliance)
     * [Desktop Notifications (optional)](#desktop-notifications-(optional))
+        * [Desktop Notification Icons (optional)](#desktop-notification-icons-(optional))
     * [Desktop File location](#desktop-file-location)
     * [pyradio/\_\_pycache\_\_](#pyradio/\_\_pycache\_\_)
 * [Recordings Directory](#recordings-directory)
@@ -49,13 +50,17 @@ In order to accomplice that, you just have to change the **distro** configuratio
 
 Once you are in the sources top level directory (typically "*pyradio*"), you execute the command:
 
-    sed -i 's/distro = None/distro = YOUR DISTRO NAME/' pyradio/config
+```
+sed -i 's/distro = None/distro = YOUR DISTRO NAME/' pyradio/config
+```
 
 Then you go on to produce the package as you would normally do.
 
 For example, an **Arch Linux** packager would use this command:
 
-    sed -i 's/distro = None/distro = Arch Linux/' pyradio/config
+```
+sed -i 's/distro = None/distro = Arch Linux/' pyradio/config
+```
 
 The distro name you insert here will appear in **PyRadio**'s "*Configuration Window*". In addition to that it will appear in the log file, so that I know where the package came from while debugging.
 
@@ -69,20 +74,37 @@ By default, all **PyRadio** configuration, operational and state files are store
 
 If you want to comply to this specification, just execute the following command from the sources top level directory (typically "*pyradio*"):
 
-    sed -i 's/xdg_compliant = False/xdg_compliant = True/' pyradio/config
+```
+sed -i 's/xdg_compliant = False/xdg_compliant = True/' pyradio/config
+```
 
 ### Desktop Notifications (optional)
 
 If you want to enable [Desktop Notifications](index.md#desktop-notifications), do a
 
-    sed -i 's/enable_notifications = -1/enable_notifications = 0/' pyradio/config
+```
+sed -i 's/enable_notifications = -1/enable_notifications = 0/' pyradio/config
+```
 
 to display titles whenever they are received, or
 
-    sed -i 's/enable_notifications = -1/enable_notifications = 60/' pyradio/config
-
+```
+sed -i 's/enable_notifications = -1/enable_notifications = 60/' pyradio/config
+```
 to have notifications every 60 seconds, for example. You can use any value here, starting from 30 to 300 (meaning every 30 seconds up to 5 minutes), using a step of 30.
 
+#### Desktop Notification Icons (optional)
+
+**PyRadio** will download stations logos (icons) in the "*logos*" cache directory.
+
+This directory will be deleted at program exit, by default.
+
+If you want to keep the downloaded icons, do a
+
+```
+sed -i 's/remove_station_icons  = True/remove_station_icons   = False/' pyradio/config
+```
+
 ### Desktop File location
 
 If the Desktop File is not installed in */usr/share/applications* or */usr/local/share/applications*, it will have to be passed as a parameter to the script that will handle it, like so:
@@ -123,7 +145,9 @@ This means that your users will eventaually have to **manually** move the files
 
 If this is acceptable for you, and you have a way to inform your users about it, go no and
 
-    sed -i 's|recording_dir = default|recording_dir = ~/whatever|' config
+```
+sed -i 's|recording_dir = default|recording_dir = ~/whatever|' config
+```
 
 In any other case, I would suggest you leave this parameter as is and let the user select customize their setup.
 
@@ -147,7 +171,9 @@ Most Linux distros will probably have *xdg-open* (from *xdg-utils* package) inst
 
 In case a different *resource opener* is to be used, one can declare it like so:
 
-    sed -i 's/resource_opener = auto/resource_opener = MY_RESOURCE_OPENER/' config
+```
+sed -i 's/resource_opener = auto/resource_opener = MY_RESOURCE_OPENER/' config
+```
 
 This will instruct **PyRadio** to use the file **MY_RESOURCE_OPENER** as a *resource opener*.
 

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "pyradio"
-version = "0.9.3.6"
+version = "0.9.3.7"
 authors = [
   { name="Ben Dowling", email="ben.m.dowling@gmail.com" },
   { name="Spiros Georgaras", email="sng@hellug.gr" },

pyradio/__init__.py

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

pyradio/install.py

@@ -16,7 +16,7 @@
 ''' This is PyRadio version this
     install.py was released for
 '''
-PyRadioInstallPyReleaseVersion = '0.9.3.6'
+PyRadioInstallPyReleaseVersion = '0.9.3.7'
 
 import locale
 locale.setlocale(locale.LC_ALL, "")