version 0.9.3.5

Changelog

@@ -1,25 +1,34 @@
-2024-04-30 s-n-g
-    * version 0.9.3.5 (BUG FIX)
-    * Config Window: do not use hardcoded values when loading default params
-    * Config Window: do not change transparency settings when themes are not
-      being used
-    * Config Window: do not toggle transparency when repeatedly pressing r / d
-    * Config Window: when r / d (revert to saved / default params) is typed,
-      correctly load the corresponding theme
-    * Config Window: preserve theming config options when a terminal that does
-      not support color change is used and config is saved
-    * suppress list of files moved when migrating to XDG dirs
-    * if both XDG_DATA_HOME and XDG_STATE_HOME directories already exist,
-      xdg_compliant will be set to True, even if not set in the configuration
-      file (it means an XDG migration has been performed in the past; using the
-      non-XDG dirs will lead to data loss)
-    * adding config option console_theme; this way eiter thr dark or the light
-      theme can be used if PyRadio is executed in a Linux Virtual Console or
-      using a terminal that cannot change colors * if PyRadio is executed in a
-      Linux Virtual Console, do not open html files,
-      display list of dirs when \o is pressed and desktop notifications will
-      not be issued
-    * updating packagers info page
+2024-05-06 s-n-g
+    * version 0.9.3.5
+    * Config Window changes:
+        * when r / d (revert to saved / default params) is typed,
+          correctly load the corresponding theme
+        * do not use hardcoded values when loading default params
+        * do not toggle transparency when repeatedly pressing r / d
+        * do not change transparency settings when themes are not being used
+        * fixing cursor positioning for PgDn
+    * XDD compliant operation changes:
+        * if both XDG_DATA_HOME and XDG_STATE_HOME directories already exist,
+          xdg_compliant will be set to True, even if not set in the
+          configuration file (it means an XDG migration has been performed
+          in the past; using the non-XDG dirs will lead to data loss)
+        * suppress list of files moved when migrating to XDG dirs
+    * Theming changes:
+        * preserve theming config options when a terminal that does not
+          support color change is used and config is saved
+        * adding "Color Factor" parameter to themes
+    * Linux Vistual Console
+        * adding config option console_theme; this way either the dark
+          or the light theme can be used when on the console
+        * detect execution on the Virtual Console
+        * do not open HTML help
+        * display list of directories when \o is pressed
+        * do not issue desktop notifications
+        * clear console at exit
+    * fixing #240 - AttributeError: NoneType object has no attribute page
+    * actually open playlists list ('o') or RabioBrowser ('O'), after a
+      dirty palylist save query has been performed
+    * updating Windows Media Players links
     * updating docs
 
 2024-04-23 s-n-g

docs/index.html

@@ -206,28 +206,37 @@ <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-04-30 s-n-g
-    * version 0.9.3.5 (BUG FIX)
-    * Config Window: do not use hardcoded values when loading default params
-    * Config Window: do not change transparency settings when themes are not
-      being used
-    * Config Window: do not toggle transparency when repeatedly pressing r / d
-    * Config Window: when r / d (revert to saved / default params) is typed,
-      correctly load the corresponding theme
-    * Config Window: preserve theming config options when a terminal that does
-      not support color change is used and config is saved
-    * suppress list of files moved when migrating to XDG dirs
-    * if both XDG_DATA_HOME and XDG_STATE_HOME directories already exist,
-      xdg_compliant will be set to True, even if not set in the configuration
-      file (it means an XDG migration has been performed in the past; using the
-      non-XDG dirs will lead to data loss)
-    * adding config option console_theme; this way eiter thr dark or the light
-      theme can be used if PyRadio is executed in a Linux Virtual Console or
-      using a terminal that cannot change colors * if PyRadio is executed in a
-      Linux Virtual Console, do not open html files,
-      display list of dirs when \o is pressed and desktop notifications will
-      not be issued
-    * updating packagers info page
+2024-05-06 s-n-g
+    * version 0.9.3.5
+    * Config Window changes:
+        * when r / d (revert to saved / default params) is typed,
+          correctly load the corresponding theme
+        * do not use hardcoded values when loading default params
+        * do not toggle transparency when repeatedly pressing r / d
+        * do not change transparency settings when themes are not being used
+        * fixing cursor positioning for PgDn
+    * XDD compliant operation changes:
+        * if both XDG_DATA_HOME and XDG_STATE_HOME directories already exist,
+          xdg_compliant will be set to True, even if not set in the
+          configuration file (it means an XDG migration has been performed
+          in the past; using the non-XDG dirs will lead to data loss)
+        * suppress list of files moved when migrating to XDG dirs
+    * Theming changes:
+        * preserve theming config options when a terminal that does not
+          support color change is used and config is saved
+        * adding "Color Factor" parameter to themes
+    * Linux Vistual Console
+        * adding config option console_theme; this way either the dark
+          or the light theme can be used when on the console
+        * detect execution on the Virtual Console
+        * do not open HTML help
+        * display list of directories when \o is pressed
+        * do not issue desktop notifications
+        * clear console at exit
+    * fixing #240 - AttributeError: NoneType object has no attribute page
+    * actually open playlists list ('o') or RabioBrowser ('O'), after a
+      dirty palylist save query has been performed
+    * updating Windows Media Players links
     * updating docs
 
 2024-04-23 s-n-g

docs/pyradio.1

@@ -2,7 +2,7 @@
 .\" Copyright (C) 2018-2024 Spiros Georgaras <sng@hellug.gr>
 .\" This manual is freely distributable under the terms of the GPL.
 .\"
-.TH pyradio 1 "April 2024" pyradio
+.TH pyradio 1 "May 2024" pyradio
 
 .SH Name
 .PP
@@ -1336,7 +1336,7 @@ This information is actually relevant to creating a new \fBpyradio\fR theme, but
 
 \fBpyradio\fR will use the same background color for all windows by default, provided that the theme used does not define a \fIMessages Border\fR background color.
 
-In order to use a \fIMessages Border\fR background color different than the \fIStations background\fR color, when \fIMessages Border\fR background color is not defined in the selected theme, a config option is available; \fBCalculated color\fR".
+In order to use a \fIMessages Border\fR background color different than the \fIStations background\fR color, when \fIMessages Border\fR background color is not defined in the selected theme, a config option is available; "\fBCalculated color\fR".
 
 This config option takes a value that's between 0 and 0.2.
 
@@ -1349,11 +1349,38 @@ This is how this works: \fBpyradio\fR will calculate the \fIStations background\
 Finally, a check will be made to see if this color is close to \fIMessages Border\fR foreground color, and re-adjusted as possible.
 
 
-.IP \fBNote\fR
-When a calculated background color is used, pressing \fI~\fR (\fItilde\fR) will toggle it on and off. This setting will be valid until \fBpyradio\fR terminates, or a new theme is loaded.
+.RE
+
+\fBOptional Calculated Color in a Theme\fR
+.RS 3
 
+Another way to use a different background color for secondary windows, is to provide one in the actual theme file. For example:
+
+.RS 3
+\fI# Luminance Color Factor
+.br
+# The factor to lighten or darken Stations background
+.br
+# color, to get a calculated color used as background
+.br
+# for secondary windows
+.br
+# Valid values: 0 - 0.2
+.br
+Color Factor        0.05\fR
 .RE
+
+In this case, the value provided (i.e. 0.05) will be used the same way as the config option "\fBCalculated color\fR".
+
+In fact, if both a theme and a config factor value is provided, the value provided by the theme will be used.
+
 .RE
+.IP \fBNote\fR
+If the "\fBMessages Border\fR" theme option provides both a foreground and a background, both the calculated values provided will be ignored.
+
+.IP \fBNote\fR
+When a calculated background color is used, pressing \fI~\fR (\fItilde\fR) will toggle it on and off. This setting will be valid until \fBpyradio\fR terminates, or a new theme is loaded.
+
 .RE
 .PP
 \fBUser themes\fR

docs/pyradio_rec.1

@@ -1,4 +1,4 @@
-.TH pyradio_rec 1 "April 2024" pyradio
+.TH pyradio_rec 1 "May 2024" pyradio
 
 .SH Name
 .PP

docs/pyradio_server.1

@@ -1,7 +1,7 @@
 .\" Copyright (C) 2018-2024 Spiros Georgaras <sng@hellug.gr>
 .\" This manual is freely distributable under the terms of the GPL.
 .\"
-.TH pyradio_server 1 "April 2024" pyradio
+.TH pyradio_server 1 "May 2024" pyradio
 
 .SH Name
 .PP

docs/themes.html

@@ -244,7 +244,7 @@ <h5 id="optional-calculated-color-in-a-theme">Optional Calculated Color in a The
 # for secondary windows
 # Valid values: 0 - 0.2
 Color Factor        0.05</pre>
-<p>In this case, the value provided (i.e. 0.05) will be used the same way as the config oprion <strong>Calculated color</strong>.</p>
+<p>In this case, the value provided (i.e. 0.05) will be used the same way as the config option <strong>Calculated color</strong>.</p>
 <p>In fact, if both a theme and a config factor value is provided, the value provided by the theme will be used.</p>
 <p style="margin: 1.5em 4em 0 4em; text-indent: -2.5em;"><strong>Note:</strong> If the “<strong>Messages Border</strong>” theme option provides both a foreground and a background, both the <em>calculated</em> values provided will be ignored.</p>
 <h3 id="alternative-main-window-border-color">Alternative Main Window border color</h3>

docs/themes.md

@@ -246,7 +246,7 @@ Another way to use a different background color for secondary windows, is to pro
 Color Factor        0.05
 ```
 
-In this case, the value provided (i.e. 0.05) will be used the same way as the config oprion **Calculated color**.
+In this case, the value provided (i.e. 0.05) will be used the same way as the config option **Calculated color**.
 
 In fact, if both a theme and a config factor value is provided, the value provided by the theme will be used.