Version 0.7.2

Author: s-n-g

Changelog

@@ -1,26 +1,29 @@
-2019-02-22  s-n-g
+2019-02-02  s-n-g
 
-	* Theme support added (4 hardcoded themes)
-	* Command line option -t (--theme) THEME added
-	* Config option "theme" added
-	* Key "T" will toggle transparency / use terminal's background color
-	* Alt keyboard combinations will not be considered as ESCAPE char
+    * Version 0.7.2
+    * Themes support added (4 hardcoded themes).
+    * Command line option -t (--theme) THEME added.
+    * Config option "theme" added.
+    * Key "T" will toggle transparency / use terminal's background color.
+    * Alt keyboard combinations will not be considered as ESCAPE char.
+    * Help / message windows use multiple colors.
+    * Fixing a couple of minor bugs.
 
 2019-02-10  s-n-g
 
-	* Version 0.7.1
+    * Version 0.7.1
     * Avoiding curses layout breakage due to BROKEN PIPE errors
     * Start of playback detection implemented. This is done by
       detecting the players audio decoder info, which actually mean
       that playback is on. If not detected within a timeout value,
       failure to connect is presumed
     * Volume adjustment, saving and muting is inhibited before start
       of playback is detected
-	* Playing a station in random order will not stop until a
-	  working station is acquired or another action is taken (e.g 
-	  pressing a key)
+    * Playing a station in random order will not stop until a
+      working station is acquired or another action is taken (e.g 
+      pressing a key)
     * Stations name is limited to window width
-	* Station title is validated before displayed
+    * Station title is validated before displayed
 
 2019-01-21  s-n-g
 

README.html

@@ -219,13 +219,23 @@ <h3 id="mplayer">MPlayer</h3>
 volstep=1
 volume=28</pre>
 <h2 id="pyradio-themes">PyRadio Themes</h2>
-<p><strong>PyRadio</strong> comes with 4 preconfigured (hardcoded) themes:</p>
+<p><strong>PyRadio</strong> comes with 4 preconfigured (hard coded) themes:</p>
 <ol type="1">
 <li><strong>dark</strong> (8 color theme). This is the appearance <strong>PyRadio</strong> has always had. Enabled by default.</li>
-<li><strong>light</strong> (8 color thmem). A theme for light terminal background settings.</li>
+<li><strong>light</strong> (8 color theme). A theme for light terminal background settings.</li>
 <li><strong>white_on_black</strong> or <strong>wob</strong> (256 color b&amp;w theme). A theme for dark terminal background settings.</li>
 <li><strong>black_on_white</strong> or <strong>bow</strong> (256 color b&amp;w theme). A theme for light terminal background settings.</li>
 </ol>
+<p>The visual result of an applied theme greatly depends on the terminal settings (e.g. foreground and background color settings, palette used, number of colors supported, real or pseudo-transparency support, etc.)</p>
+<p>Pressing “<strong>t</strong>” will bring up the <em>Theme selection window</em>, which can be used to activate a theme and set the default one.</p>
+<p style="margin: 1.5em 4em 0 4em; text-indent: -2.5em;"><strong>Note:</strong> If the terminal supports 8 colors only, 256 color themes will not be present in this window. Furthermore, if a 256 color theme is set as default (or requested using the “<strong>-t</strong>” command line option), <strong>PyRadio</strong> will silently revert to the “<strong>dark</strong>” theme.</p>
+<p>The <em>Theme selection window</em> will remain open after activating a theme, so that the user can inspect the visual result and easily change it, if desired. Then, when he is satisfied with the activated theme, the window will have to be manually closed (by pressing “<strong>q</strong>” or any other relevant key - pressing “<strong>?</strong>” will bring up its help).</p>
+<p>The use of custom themes and theme editing is not implemented yet; theses are features for future releases.</p>
+<h3 id="using-transparency">Using transparency</h3>
+<p><strong>PyRadio</strong> themes are able to be used with a transparent background.</p>
+<p>Pressing “<strong>T</strong>” will toggle the transparency setting and save this state in <strong>PyRadio</strong>’s configuration file (transparency is off by default).</p>
+<p>Setting transparency on, will actually force <strong>PyRadio</strong> to not use its own background color, effectively making it to display whatever is on the terminal (color/picture/transparency). The visual result depends on terminal settings and whether a compositor is running.</p>
+<p>When the <em>Theme selection window</em> is visible, a “<strong>[T]</strong>” string displayed at its bottom right corner will indicate that transparency is <em>on</em>.</p>
 <h2 id="debug-mode">Debug mode</h2>
 <p>Adding the <strong><em>-d</em></strong> option to the command line will instruct <strong>PyRadio</strong> to enter <em>Debug mode</em>, which means that it will print debug messages to a file. This file will always reside in the user’s home directory and will be named <em>pyradio.log</em>.</p>
 <p>In case of a bug or a glitch, please include this file to the issue you will <a href="https://github.com/coderholic/pyradio/issues">open in github</a>.</p>

README.md

@@ -312,13 +312,33 @@ Example:
 
 ## PyRadio Themes
 
-**PyRadio** comes with 4 preconfigured (hardcoded) themes:
+**PyRadio** comes with 4 preconfigured (hard coded) themes:
 
 1. **dark** (8 color theme). This is the appearance **PyRadio** has always had. Enabled by default.
-2. **light** (8 color thmem). A theme for light terminal background settings.
+2. **light** (8 color theme). A theme for light terminal background settings.
 3. **white_on_black** or **wob** (256 color b&w theme). A theme for dark terminal background settings.
 4. **black_on_white** or **bow** (256 color b&w theme). A theme for light terminal background settings.
 
+The visual result of an applied theme greatly depends on the terminal settings (e.g. foreground and background color settings, palette used, number of colors supported, real or pseudo-transparency support, etc.)
+
+Pressing "**t**" will bring up the *Theme selection window*, which can be used to activate a theme and set the default one.
+
+**Note:** If the terminal supports 8 colors only, 256 color themes will not be present in this window. Furthermore, if a 256 color theme is set as default (or requested using the "**-t**" command line option), **PyRadio** will silently revert to the "**dark**" theme.
+
+The  *Theme selection window* will remain open after activating a theme, so that the user can inspect the visual result and easily change it, if desired. Then, when he is satisfied with the activated theme, the window will have to be manually closed (by pressing "**q**" or any other relevant key - pressing "**?**" will bring up its help).
+
+The use of custom themes and theme editing is not implemented yet; theses are features for future releases.
+
+### Using transparency
+
+**PyRadio** themes are able to be used with a transparent background.
+
+Pressing "**T**"  will toggle the transparency setting and save this state in **PyRadio**'s configuration file (transparency is off by default). 
+
+Setting transparency on, will actually force **PyRadio** to not use its own background color, effectively making it to display whatever is on the terminal (color/picture/transparency).  The visual result depends on terminal settings and whether a compositor is running.
+
+When the *Theme selection window* is visible, a "**[T]**" string displayed  at  its  bottom right corner will indicate that transparency is *on*.
+
 ## Debug mode
 
 Adding the ***-d*** option to the command line will instruct **PyRadio** to enter *Debug mode*, which means that it will print debug messages to a file. This file will always reside in the user's home directory and will be named *pyradio.log*.

pyradio.1

@@ -1,7 +1,7 @@
 .\" Copyright (C) 2011 Ben Dowling <http://www.coderholic.com/pyradio>
 .\" This manual is freely distributable under the terms of the GPL.
 .\"
-.TH PYRADIO 1 "February 2019"
+.TH PYRADIO 1 "March 2019"
 
 .SH NAME
 .PP
@@ -34,6 +34,8 @@ List of available playlists in config dir.
 List of available stations in a playlist.
 .IP \fB-scd\fR,\fB--show-config-dir\fR
 Print config directory location and exit.
+.IP \fB-t\fR\ \fITHEME\fR,\ \fB--theme\fR\ \fITHEME\fR
+Use specified \fITHEME\fR.
 .IP \fB-ocd\fR,\fB--open-config-dir\fR
 Open config directory with default file manager.
 .IP \fB-d\fR,\fB\ \--debug
@@ -340,6 +342,43 @@ volstep=1
 .br
 volume=28
 
+.SH PYRADIO THEMES
+.PP
+
+\fBpyradio\fR comes with 4 preconfigured (hard coded) themes:
+
+.IP \fBdark\fR\ (8\ color\ theme)
+This is the appearance \fBpyradio\fR has always had. Enabled by default.
+.IP \fBlight\fR\ (8\ color\ theme)
+A theme for light terminal background settings.
+.IP \fBwhite_on_black\fR\ or\ \fBwob\fR \(256\ color\ b&w\ theme)
+A theme for dark terminal background settings.
+.IP \fBblack_on_white\fR\ or\ \fBbow\fR\ (256\ color\ b&w\ theme)
+A theme for light terminal background settings.
+
+.PP
+The visual result of an applied theme greatly depends on the terminal settings (e.g. foreground and background color settings, palette used, number of colors supported, real or pseudo-transparency support, etc.)
+
+Pressing "\fBt\fR" will bring up the \fITheme selection window\fR, which can be used to activate a theme and set the default one.
+
+.IP \fBNote\fR
+If the terminal supports 8 colors only, 256 color themes will not be present in the \fITheme selection window\fR. Furthermore, if a 256 color theme is set as default (or requested using the "\fB-t\fR" command line option), \fBpyradio\fR will silently revert to the "\fBdark\fR" theme.
+
+.PP
+The \fITheme selection window\fR will remain open after activating a theme, so that the user can inspect the visual result and easily change it, if desired. Then, when he is satisfied with the activated theme, the window will have to be manually closed (by pressing "\fBq\fR" or any other relevant key - pressing "\fB?\fR" will bring up its help).
+
+The use of custom themes and theme editing is not implemented yet; theses are features for future releases.
+
+\fBUSING TRANSPARENCY\fR
+
+\fBpyradio\fR themes are able to be used with a transparent background.
+
+Pressing "\fBT\fR"  will toggle the transparency setting (it is \fIoff\fR by default) and save this state in \fBpyradio\fR's configuration file. 
+
+Setting transparency on, will actually force \fBpyradio\fR to not use its own background color, effectively making it to display whatever is on the terminal (color/picture/transparency). The visual result depends on terminal settings and whether a compositor is running.
+
+When the \fITheme selection window\fR is visible, a "\fI[T]\fR" string displayed at its bottom right corner will indicate that transparency is \fIon\fR.
+
 .SH DEBUG MODE
 .PP
 Adding the \fB-d\fR option to the command line will instruct \fBpyradio\fR to enter \fBDebug mode\fR, which means that it will print debug messages to a file. This file will always reside in the user's home directory and will be named \fIpyradio.log\fR.
@@ -363,5 +402,11 @@ On \fBMac OS\fR, these file may be installed in \fI/usr/local/share/doc/pyradio\
 
 .SH AUTHOR
 .PP
- \fBBen Dowling\fR\ \<\fIhttps://github.com/coderholic\fR\>
+\fBBen Dowling\fR\ \<\fIhttps://github.com/coderholic\fR\>,\ (Origianl\ author)
+.PP
+\fBKirill Klenov\fR\ \<\fIhttps://github.com/klen\fR\>,\ (2012)
+.PP
+\fBPeter Stevenson (2E0PGS)\fR\ \<\fIhttps://github.com/2E0PGS\fR\>,\ (2018)
+.PP
+\fBSpiros Georgaras\fR\ \<\fIhttps://github.com/s-n-g\fR\>,\ (2018-2019)
 

pyradio/__init__.py

@@ -1,6 +1,6 @@
 " pyradio -- Console radio player. "
 
-version_info = (0, 7, 1)
+version_info = (0, 7, 2)
 
 __version__ = version = '.'.join(map(str, version_info))
 __project__ = __name__