- version 0.8.9.23 (0.9-beta20)

- several fixes for non linux OSs (freensd, openbsd, etc.)
- removing some debug messages

Author: s-n-g

Changelog

@@ -1,3 +1,11 @@
+2022-08-03 s-n-g
+    * version 0.8.9.23 (0.9-beta20)
+    * pyradio can now sync with themes created by base16, pywal and theme.sh
+    * if session is locked, the theme selection window will not be available
+    * if session is locked, do not create / download (watched) theme; wait
+      for main instance to do it instead, then just load it
+    * docs updated
+
 2022-07-03 s-n-g
     * version 0.8.9.22 (0.9-beta19)
     * themes can declare transparency hint

README.html

@@ -13,8 +13,10 @@
     body {max-width: 750px; margin: auto;} 
     h2 {margin-top: 2.5em; border-bottom:1px solid SaddleBrown; color: SaddleBrown;} 
     h3 {margin-top: 2em; color: SaddleBrown; text-decoration: underline SaddleBrown} 
-    h4 {margin-top: 2em; color: SaddleBrown;} 
-    h4:before {content: "# "; font-size: 200%; font-weight: bold; vertical-align: middle;} 
+    h4 {margin: 2em 0 1em 0; color: SaddleBrown; font-size: 150%;} 
+    h4:before {content: "# "; font-weight: bold; vertical-align: middle;} 
+    h5 {margin: 2em 0 1em 0; color: SaddleBrown; font-size: 120%;} 
+    h5:before {content: "## "; font-weight: bold; vertical-align: middle;} 
     STRONG {color: SaddleBrown;} 
     dl {margin: 2em;} 
     dd {margin: 1em;} 
@@ -107,11 +109,12 @@ <h2 id="table-of-contents">Table of Contents <span style="padding-left: 10px;"><
 <li><a href="#updating-themes-automatically">Updating themes automatically</a></li>
 <li><a href="#using-project-themes">Using Project Themes</a>
 <ul>
-<li><a href="#1.-base16">1. base16</a>
+<li><a href="#base16">base16</a>
 <ul>
 <li><a href="#using-the-themes-without-base16">Using the themes without base16</a></li>
 </ul></li>
-<li><a href="#2.-pywal">2. pywal</a></li>
+<li><a href="#pywal">pywal</a></li>
+<li><a href="#theme.sh">theme.sh</a></li>
 </ul></li>
 </ul></li>
 <li><a href="#mouse-support">Mouse support</a></li>
@@ -168,6 +171,14 @@ <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></style></h2>
 <pre style="height: 200px;">
 
+2022-08-03 s-n-g
+    * version 0.8.9.23 (0.9-beta20)
+    * pyradio can now sync with themes created by base16, pywal and theme.sh
+    * if session is locked, the theme selection window will not be available
+    * if session is locked, do not create / download (watched) theme; wait
+      for main instance to do it instead, then just load it
+    * docs updated
+
 2022-07-03 s-n-g
     * version 0.8.9.22 (0.9-beta19)
     * themes can declare transparency hint
@@ -1334,16 +1345,20 @@ <h3 id="using-project-themes">Using Project Themes</h3>
 <p><strong>PyRadio</strong> will detect theses projects (programs installed and initialized), and will add them under the “<strong>Ext. Themes Projects</strong>” section of the “<em>Themes Selection Window</em>.”</p>
 <p>If loading any of these themes fails, the default <strong>dark</strong> theme will be loaded, but contrary to a local theme being invalid, the selection will persist (so that the theme gets loaded wheneve it is available).</p>
 <p>Currently, the following projects are supported:</p>
-<h4 id="base16">1. <a target="_blank" href="https://github.com/base16-project">base16</a></h4>
-<p>Thanks to the wonderful work by user <a target="_blank" href="https://github.com/edunfelt">edunfelt</a>, there is now a <strong>PyRadio</strong> base16 template in place, and themes have been produced based on the project (there are more than 900 themes available).</p>
+<h4 id="base16">base16</h4>
+<p>Thanks to the wonderful work by user <a target="_blank" href="https://github.com/edunfelt">edunfelt</a>, there is now a <strong>PyRadio</strong> <a target="_blank" href="https://github.com/base16-project">base16</a> template in place, and themes have been produced based on the project (there are more than 900 themes available).</p>
 <p>This implementation will add four entries in the theme selection menu (with alternative and variant forms of the main theme).</p>
 <p>Then, any of the themes can either be activated or watched; in which case <strong>PyRadio</strong> will download and apply the corresponding theme.</p>
 <h5 id="using-the-themes-without-base16">Using the themes without base16</h5>
 <p>In case one wants to use any of these themes, but not install or use <a target="_blank" href="https://github.com/base16-project">base16</a>, one can get them <a target="_blank" href="https://github.com/edunfelt/base16-pyradio">from this repo</a>, and use the “<em>cycle_themes.py</em>” and “<em>install_themes.py</em>” scripts to inspect and install them.</p>
-<h4 id="pywal">2. <a target="_blank" href="https://github.com/dylanaraps/pywal">pywal</a></h4>
+<p>For Windows users, this is the only way to use any of these “<em>Project Themes</em>”, since their generation works on non-windows platforms only.</p>
+<h4 id="pywal">pywal</h4>
 <p>When detected, two themes will be added to the menu; the main and the alternative form.</p>
 <p>Since these themes are generated on the fly, as the wallpaper changes, there is no way to use them if <a target="_blank" href="https://github.com/dylanaraps/pywal">pywal</a> is not in use.</p>
 <p style="margin: 1.5em 4em 0 4em; text-indent: -2.5em;"><strong>Note:</strong> If <a target="_blank" href="https://github.com/dylanaraps/pywal">pywal</a> themes are activated but not watched, the theme will be corrupted when the wallpaper changes, and will have to be manually reloaded. So, it’s better to just always watch these themes.</p>
+<h4 id="theme.sh">theme.sh</h4>
+<p>When detected, four themes will be added to the menu; the main and the alternative forms (there are 400 plus themes available, which makes a stuggering number of around 1700 plus themes for <strong>PyRadio</strong>!)</p>
+<p>Since these themes are generated on the fly, there is no way to use them if <a target="_blank" href="https://github.com/lemnos/theme.sh">theme.sh</a> is not in use.</p>
 <h2 id="mouse-support">Mouse support <span style="padding-left: 10px;"><sup style="font-size: 50%"><a href="#" title="Go to top of the page">Top</a></sup></style></h2>
 <p>Being a console application, <strong>PyRadio</strong> was never intended to work with a mouse.</p>
 <p>Furthermore, when using the mouse on a console application, the result is highly dependent on the terminal used and the way it implements mouse support.</p>
@@ -1495,7 +1510,7 @@ <h2 id="acknowledgment">Acknowledgment <span style="padding-left: 10px;"><sup st
 </ol>
 <h2 id="special-thanks">Special thanks <span style="padding-left: 10px;"><sup style="font-size: 50%"><a href="#" title="Go to top of the page">Top</a></sup></style></h2>
 <ol type="1">
-<li><strong>PyRadio</strong> user <a target="_blank" href="https://github.com/edunfelt">edunfelt</a>, for her wonderful work on <a href="%5Bedunfelt%5D(https://github.com/edunfelt)">base16</a> themes, and ideas regarding theming and such.</li>
+<li><a target="_blank" href="https://github.com/edunfelt">edunfelt</a>, for her wonderful work on <a target="_blank" href="https://github.com/edunfelt/base16-pyradio">base16 themes</a>, and ideas regarding theming and such.</li>
 </ol>
 </body>
 </html>

README.md

@@ -53,9 +53,10 @@ Ben Dowling - [https://github.com/coderholic](https://github.com/coderholic)
     * [Using transparency](#using-transparency)
     * [Updating themes automatically](#updating-themes-automatically)
     * [Using Project Themes](#using-project-themes)
-        * [1. base16](#1.-base16)
+        * [base16](#base16)
             * [Using the themes without base16](#using-the-themes-without-base16)
-        * [2. pywal](#2.-pywal)
+        * [pywal](#pywal)
+        * [theme.sh](#theme.sh)
 * [Mouse support](#mouse-support)
 * [Titles logging](#titles-logging)
     * [Tagging a title](#tagging-a-title)
@@ -875,9 +876,9 @@ If loading any of these themes fails, the default **dark** theme will be loaded,
 
 Currently, the following projects are supported:
 
-#### 1. [base16](https://github.com/base16-project)
+#### base16
 
-Thanks to the wonderful work by user [edunfelt](https://github.com/edunfelt), there is now a **PyRadio** base16 template in place, and themes have been produced based on the project (there are more than 900 themes available).
+Thanks to the wonderful work by user [edunfelt](https://github.com/edunfelt), there is now a **PyRadio** [base16](https://github.com/base16-project) template in place, and themes have been produced based on the project (there are more than 900 themes available).
 
 This implementation will add four entries in the theme selection menu (with alternative and variant forms of the main theme).
 
@@ -887,14 +888,22 @@ Then, any of the themes can either be activated or watched; in which case **PyRa
 
 In case one wants to use any of these themes, but not install or use [base16](https://github.com/base16-project), one can get them [from this repo](https://github.com/edunfelt/base16-pyradio), and use the "*cycle_themes.py*" and "*install_themes.py*" scripts to inspect and install them.
 
-#### 2. [pywal](https://github.com/dylanaraps/pywal)
+For Windows users, this is the only way to use any of these "*Project Themes*", since their generation works on non-windows platforms only.
+
+#### pywal
 
 When detected, two themes will be added to the menu; the main and the alternative form.
 
 Since these themes are generated on the fly, as the wallpaper changes, there is no way to use them if [pywal](https://github.com/dylanaraps/pywal) is not in use.
 
 **Note:** If [pywal](https://github.com/dylanaraps/pywal) themes are activated but not watched, the theme will be corrupted when the wallpaper changes, and will have to be manually reloaded. So, it's better to just always watch these themes.
 
+#### theme.sh
+
+When detected, four themes will be added to the menu; the main and the alternative forms (there are 400 plus themes available, which makes a stuggering number of around 1700 plus themes for **PyRadio**!)
+
+Since these themes are generated on the fly, there is no way to use them if [theme.sh](https://github.com/lemnos/theme.sh) is not in use.
+
 ## Mouse support
 
 Being a console application, **PyRadio** was never intended to work with a mouse.
@@ -1083,4 +1092,4 @@ Having said that, if you are not packaging for a specific distribution, please d
 
 ## Special thanks
 
-1. **PyRadio** user [edunfelt](https://github.com/edunfelt), for her wonderful work on [base16]([edunfelt](https://github.com/edunfelt)) themes, and ideas regarding theming and such.
+1. [edunfelt](https://github.com/edunfelt), for her wonderful work on [base16 themes](https://github.com/edunfelt/base16-pyradio), and ideas regarding theming and such.

build.html

@@ -13,8 +13,10 @@
     body {max-width: 750px; margin: auto;} 
     h2 {margin-top: 2.5em; border-bottom:1px solid SaddleBrown; color: SaddleBrown;} 
     h3 {margin-top: 2em; color: SaddleBrown; text-decoration: underline SaddleBrown} 
-    h4 {margin-top: 2em; color: SaddleBrown;} 
-    h4:before {content: "# "; font-size: 200%; font-weight: bold; vertical-align: middle;} 
+    h4 {margin: 2em 0 1em 0; color: SaddleBrown; font-size: 150%;} 
+    h4:before {content: "# "; font-weight: bold; vertical-align: middle;} 
+    h5 {margin: 2em 0 1em 0; color: SaddleBrown; font-size: 120%;} 
+    h5:before {content: "## "; font-weight: bold; vertical-align: middle;} 
     STRONG {color: SaddleBrown;} 
     dl {margin: 2em;} 
     dd {margin: 1em;} 

devel/pre-commit

@@ -72,8 +72,10 @@ do
     body {max-width: 750px; margin: auto;} \
     h2 {margin-top: 2.5em; border-bottom:1px solid SaddleBrown; color: SaddleBrown;} \
     h3 {margin-top: 2em; color: SaddleBrown; text-decoration: underline SaddleBrown} \
-    h4 {margin-top: 2em; color: SaddleBrown;} \
-    h4:before {content: "# "; font-size: 200%; font-weight: bold; vertical-align: middle;} \
+    h4 {margin: 2em 0 1em 0; color: SaddleBrown; font-size: 150%;} \
+    h4:before {content: "# "; font-weight: bold; vertical-align: middle;} \
+    h5 {margin: 2em 0 1em 0; color: SaddleBrown; font-size: 120%;} \
+    h5:before {content: "## "; font-weight: bold; vertical-align: middle;} \
     STRONG {color: SaddleBrown;} \
     dl {margin: 2em;} \
     dd {margin: 1em;} \

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 "July 2022" PyRadio
+.TH pyradio 1 "August 2022" PyRadio
 
 .SH Name
 .PP
@@ -945,6 +945,58 @@ if the theme is the default one (the way it has always been).
 .IP \fB-\fR 3
 if the theme is the default one, and \fBpyradio\fR will watch it for changes.
 
+.RE
+
+\fBUsing Project Themes\fR
+
+\fBpyradio\fR is able to use (and watch) the output of certain projects that modify terminal colors.
+
+\fBpyradio\fR will detect theses projects (programs installed and initialized), and will add them under the \fBExt. Themes Projects\fR section of the \fIThemes Selection Window\fR.
+
+If loading any of these themes fails, the default \FBdark\fR theme will be loaded, but contrary to a local theme being invalid, the selection will persist (so that the theme gets loaded wheneve it is available).
+
+Currently, the following projects are supported:
+
+\fB1.\ base16\fR
+
+.RS 3
+
+Thanks to the wonderful work by user \fBedunfelt\fR (\fIhttps://github.com/edunfelt\fR), there is now a \fBpyradio base16\fR (\fIhttps://github.com/base16-project\fR) \fBtemplate\fR in place, and themes have been produced based on the project (there are more than 900 themes available).
+
+This implementation will add four entries in the theme selection menu (with alternative and variant forms of the main theme).
+
+Then, any of the themes can either be activated or watched; in which case \fBpyradio\fR will download and apply the corresponding theme.
+
+\fBUsing the themes without base16\fR
+
+.RS 4
+
+In case one wants to use any of these themes, but not install or use \fBbase16\fR (\fIhttps://github.com/base16-project\fR), one can get them \fIfrom this repo\fR (\fIhttps://github.com/edunfelt/base16-pyradio\fR), and use the \fBcycle_themes.py\fR and \fBinstall_themes.py\fR scripts to inspect and install them.
+
+.RE
+.RE
+
+\fB2.\ pywal\fR
+
+.RS 3
+
+When detected, two themes will be added to the menu; the main and the alternative form.
+
+Since these themes are generated on the fly, as the wallpaper changes, there is no way to use them if \fBpywal\fR (\fIhttps://github.com/dylanaraps/pywal\fR) is not in use.
+
+.IP \fBNote:
+If \fBpywal\fR (\fIhttps://github.com/dylanaraps/pywal\fR) themes are activated but not watched, the theme will be corrupted when the wallpaper changes, and will have to be manually reloaded. So, it's better to just always watch these themes.
+
+.RE
+
+\fB3.\ theme.sh\fR
+
+.RS 3
+
+When detected, four themes will be added to the menu; the main and the alternative forms (there are 400 plus themes available, which makes a stuggering number of around 1700 plus themes for \fBpyradio\fR!)
+
+Since these themes are generated on the fly, there is no way to use them if \fBtheme.sh\fR (\fIhttps://github.com/lemnos/theme.sh\fR) is not in use.
+
 .SH Mouse Support
 
 Being a console application, \fBPyRadio\fR was never intended to work with a mouse.
@@ -1145,10 +1197,15 @@ On \fBMac OS\fR, these file may be installed in \fI/usr/local/share/doc/pyradio\
 .PP
 \fBPeter Stevenson (2E0PGS)\fR\ \<\fIhttps://github.com/2E0PGS\fR\>,\ (2018)
 .PP
-\fBSpiros Georgaras\fR\ \<\fIhttps://github.com/s-n-g\fR\>,\ (2018-2021)
+\fBSpiros Georgaras\fR\ \<\fIhttps://github.com/s-n-g\fR\>,\ (2018-2022)
 .PP
 You can see a complete list of contributors at
-  https://github.com/coderholic/pyradio/graphs/contributors
+   \fIhttps://github.com/coderholic/pyradio/graphs/contributors\fR
+
+.SH Special thanks
+
+.IP \fI1. 3
+\fBedunfelt\fR (\fIhttps://github.com/edunfelt\fR), for her wonderful work on \fBbase16 themes\fR (\fIhttps://github.com/edunfelt/base16-pyradio\fR), and ideas regarding theming and such.
 
 .SH See also
 

pyradio/__init__.py

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