-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
diff --git a/docs/pyradio.1 b/docs/pyradio.1
index 1bd10d1..13b7691 100644
--- a/docs/pyradio.1
+++ b/docs/pyradio.1
@@ -2,7 +2,7 @@
.\" Copyright (C) 2018-2024 Spiros Georgaras
.\" 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
diff --git a/docs/pyradio_rec.1 b/docs/pyradio_rec.1
index 9b2d9a2..b87a3c7 100644
--- a/docs/pyradio_rec.1
+++ b/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
diff --git a/docs/pyradio_server.1 b/docs/pyradio_server.1
index 5cf5ace..b5becaf 100644
--- a/docs/pyradio_server.1
+++ b/docs/pyradio_server.1
@@ -1,7 +1,7 @@
.\" Copyright (C) 2018-2024 Spiros Georgaras
.\" 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
diff --git a/docs/themes.html b/docs/themes.html
index 7462fda..0c9e837 100644
--- a/docs/themes.html
+++ b/docs/themes.html
@@ -244,7 +244,7 @@ Optional Calculated Color in a The
# for secondary windows
# Valid values: 0 - 0.2
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.
Note: If the “Messages Border” theme option provides both a foreground and a background, both the calculated values provided will be ignored.