You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
<h2id="changelog">Changelog <spanstyle="padding-left: 10px;"><supstyle="font-size: 50%"><ahref="#" title="Go to top of the page">Top</a></sup></style></h2>
Two themes by <atarget="_blank" href="https://github.com/edunfelt">edunfelt</a> inspired by the <atarget="_blank" href="https://github.com/base16-project">base16</a> project.</li>
1216
1224
<li><strong>gruvbox_dark_by_sng</strong> and <strong>gruvbox_light_by_sng</strong><br/>
1217
1225
Two themes based on the <atarget="_blank" href="https://github.com/morhetz/gruvbox">gruvbox</a> theme.</li>
1226
+
<li><strong>minima_by_ben_chile</strong><br/>
1227
+
A theme by user <atarget="_blank" href="https://forum.maboxlinux.org/u/ben_chile">ben_chile</a> created on the <atarget="_blank" href="https://maboxlinux.org">Mabox Linux</a> Forum.</li>
<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>
1257
1274
<pstyle="margin: 1.5em 4em 0 4em; text-indent: -2.5em;"><strong>Note:</strong> If the theme selected in the “<em>Theme selection window</em>”, (or requested using the “<strong>-t</strong>” command line option), is in any way invalid, or is of the old format, <strong>PyRadio</strong> will fall-back to the “<strong>dark</strong>” theme and will display a relevant message.</p>
1258
1275
<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>
1276
+
<p>Pressing “<strong>SPACE</strong>”, will apply the theme and make it default, and pressing “<strong>c</strong>” will apply the theme and make it default and start a file watch function on the file, so that if the file changes, <strong>PyRadio</strong> will automatically update itself.</p>
1259
1277
<h3id="css-color-themes-restrictions">CSS color themes restrictions</h3>
1260
1278
<p>Using CSS colors imposes a couple of restrictions on the type of terminals <strong>PyRadio</strong> will be able to run:</p>
<li>Save the theme provided as a template above in their themes folder using any (short) file name and a “<strong>.pyradio-theme</strong>” file extension.<br/>
1278
1296
<br/>
1279
-
For this reason, a folder called “<strong>themes</strong>” will probably have to be created in <strong>PyRadio</strong> config directory (<strong>~/.config/pyradio</strong> or **%APPDATA* on Windows)</p></li>
1297
+
For this reason, a folder called “<strong>themes</strong>” will probably have to be created in <strong>PyRadio</strong> config directory (<strong>~/.config/pyradio</strong> or <strong>%APPDATA%\pyradio</strong> on Windows)</p></li>
1280
1298
<li>Customize it as desired</p></li>
1281
1299
<li>Load it from the “<em>Theme selection window</em>” (it will be found under “<strong>User Themes</strong>”).</p></li>
1282
1300
</ol>
1283
1301
<h4id="converting-old-themes">Converting old themes</h4>
1284
1302
<p>An old theme (using the old format) can be asily converted to the new format, using the script found at <atarget="_blank" href="https://gist.github.com/s-n-g/65aa6ae12e135481bf3a503ece4e92d2">this gist</a>.</p>
1285
1303
<pstyle="margin: 1.5em 4em 0 4em; text-indent: -2.5em;"><strong>Note:</strong> In order to get the color intended to be used, the same palette as the one used when the original theme was created, must be used.</p>
<p><strong>PyRadio</strong> themes are able to be used with a transparent background.</p>
1288
-
<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>
1289
-
<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>
1305
+
<p>For <strong>PyRadio</strong>, transparency means that a theme’s background actually disappears, 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>
1306
+
<p>Not all themes look good when transparency is ON, so themes can now declare whether they want to use transparency or not. This is the “<strong>transparency</strong>” variable of the theme, which can have these values:</p>
1307
+
<ul>
1308
+
<li>0 means that the theme looks better with no transparency (default)</li>
1309
+
<li>1 means that the theme looks better when transparency in ON</li>
1310
+
<li>2 means that the theme looks good either way, and the global transparency setting (defined in <strong>PyRadio</strong> config file) can be used.</li>
1311
+
</ul>
1312
+
<p>Please notice that this is just a hint; themes will obey the rules above, but transparency can still be toggled using “<strong>T</strong>” (capital “<strong>t</strong>”).</p>
1290
1313
<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>
<p>Terminal users have been using all kind of software to change / update / adapt their terminal colors and palettes, such as <atarget="_blank" href="https://github.com/chriskempson/base16">bASE16</a>, <atarget="_blank" href="https://github.com/dylanaraps/pywal">pywal</a>, <atarget="_blank" href="https://github.com/deviantfero/wpgtk">wpgtk</a>, <atarget="_blank" href="https://github.com/lemnos/theme.sh">theme.sh</a>, to name a few.</p>
1316
+
<p><strong>PyRadio</strong> is now able to “watch” a given theme for changes and update its colors whenever the theme changes.</p>
1317
+
<p>To set up a theme for auto update, one would just open the “<em>Theme Selection</em>” window, navigate to a theme under “<strong>User Themes</strong>” and press “<strong>c</strong>”. To create a <strong>user theme</strong> just follow the procedure described in section <ahref="#user-themes">User themes</a>.</p>
1318
+
<p>Consecuently, the default theme name will be preceded by:</p>
1319
+
<ul>
1320
+
<li>“<strong>*</strong>” if the theme is the default one (the way it has always been).</li>
1321
+
<li>“<strong>+</strong>” if the theme is the default one, and <strong>PyRadio</strong> will watch it for changes.</li>
1322
+
</ul>
1291
1323
<h2id="mouse-support">Mouse support <spanstyle="padding-left: 10px;"><supstyle="font-size: 50%"><ahref="#" title="Go to top of the page">Top</a></sup></style></h2>
1292
1324
<p>Being a console application, <strong>PyRadio</strong> was never intended to work with a mouse.</p>
1293
1325
<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>
@@ -734,6 +735,8 @@ A clasic theme by [The OpenBSD Guy](https://github.com/OpenBSDGuy), originally c
734
735
Two themes by [edunfelt](https://github.com/edunfelt) inspired by the [base16](https://github.com/base16-project) project.
735
736
-**gruvbox_dark_by_sng** and **gruvbox_light_by_sng**\
736
737
Two themes based on the [gruvbox](https://github.com/morhetz/gruvbox) theme.
738
+
-**minima_by_ben_chile**\
739
+
A theme by user [ben_chile](https://forum.maboxlinux.org/u/ben_chile) created on the [Mabox Linux](https://maboxlinux.org) Forum.
737
740
-**pastel_based_by_sng**\
738
741
A dim but colorful theme.
739
742
@@ -775,6 +778,13 @@ PyRadio URL #a3b367
775
778
# Message window borser foreground
776
779
# (background color will come from Stations)
777
780
Messages Border #a3b367
781
+
782
+
# Theme Transparency
783
+
# Values are:
784
+
# 0: No transparency (default)
785
+
# 1: Theme is transparent
786
+
# 2: Obey config setting
787
+
transparency 0
778
788
```
779
789
780
790
Pressing "**t**" will bring up the *Theme selection window*, which can be used to activate a theme and set the default one.
@@ -783,6 +793,8 @@ Pressing "**t**" will bring up the *Theme selection window*, which can be used t
783
793
784
794
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).
785
795
796
+
Pressing "**SPACE**", will apply the theme and make it default, and pressing "**c**" will apply the theme and make it default and start a file watch function on the file, so that if the file changes, **PyRadio** will automatically update itself.
797
+
786
798
### CSS color themes restrictions
787
799
788
800
Using CSS colors imposes a couple of restrictions on the type of terminals **PyRadio** will be able to run:
@@ -807,7 +819,7 @@ Users can easiliy create their own themes, using for example [CSS color names](h
807
819
808
820
1. Save the theme provided as a template above in their themes folder using any (short) file name and a "**.pyradio-theme**" file extension. \
809
821
\
810
-
For this reason, a folder called "**themes**" will probably have to be created in **PyRadio** config directory (**~/.config/pyradio** or **%APPDATA\pyradio** on Windows)
822
+
For this reason, a folder called "**themes**" will probably have to be created in **PyRadio** config directory (**~/.config/pyradio** or **%APPDATA%\\pyradio** on Windows)
811
823
812
824
813
825
2. Customize it as desired
@@ -823,14 +835,32 @@ An old theme (using the old format) can be asily converted to the new format, us
823
835
824
836
### Using transparency
825
837
826
-
**PyRadio** themes are able to be used with a transparent background.
838
+
For **PyRadio**, transparency means that a theme's background actually disappears, 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.
839
+
840
+
Not all themes look good when transparency is ON, so themes can now declare whether they want to use transparency or not. This is the "**transparency**" variable of the theme, which can have these values:
827
841
828
-
Pressing "**T**" will toggle the transparency setting and save this state in **PyRadio**'s configuration file (transparency is off by default).
842
+
- 0 means that the theme looks better with no transparency (default)
843
+
- 1 means that the theme looks better when transparency in ON
844
+
- 2 means that the theme looks good either way, and the global transparency setting (defined in **PyRadio** config file) can be used.
829
845
830
-
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.
846
+
Please notice that this is just a hint; themes will obey the rules above, but transparency can still be toggled using "**T**" (capital "**t**").
831
847
832
848
When the "*Theme selection window*" is visible, a "**[T]**" string displayed at its bottom right corner will indicate that transparency is *on*.
833
849
850
+
### Updating themes automatically
851
+
852
+
Terminal users have been using all kind of software to change / update / adapt their terminal colors and palettes, such as [bASE16](https://github.com/chriskempson/base16), [pywal](https://github.com/dylanaraps/pywal), [wpgtk](https://github.com/deviantfero/wpgtk), [theme.sh](https://github.com/lemnos/theme.sh), to name a few.
853
+
854
+
**PyRadio** is now able to "watch" a given theme for changes and update its colors whenever the theme changes.
855
+
856
+
To set up a theme for auto update, one would just open the "*Theme Selection*" window, navigate to a theme under "**User Themes**" and press "**c**". To create a **user theme** just follow the procedure described in section [User themes](#user-themes).
857
+
858
+
Consecuently, the default theme name will be preceded by:
859
+
860
+
- "**\***" if the theme is the default one (the way it has always been).
861
+
- "**+**" if the theme is the default one, and **PyRadio** will watch it for changes.
862
+
863
+
834
864
## Mouse support
835
865
836
866
Being a console application, **PyRadio** was never intended to work with a mouse.
@@ -841,6 +844,10 @@ If the theme selected in the \fITheme selection window\fR, (or requested using t
841
844
.PP
842
845
The \fIThemeselectionwindow\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).
843
846
847
+
.PP
848
+
849
+
Pressing "\fISPACE\fR", will apply the theme and make it default, and pressing "\fIc\fR" will apply the theme and make it default and start a file watch function on the file, so that if the file changes, \fBpyradio\fR will automatically update itself.
850
+
844
851
.PP
845
852
\fBCSScolorthemesrestrictions\fR
846
853
@@ -898,23 +905,45 @@ An old theme (using the old format) can be asily converted to the new format, us
For \fBpyradio\fR, transparency means that a theme's background actually disappears, 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.
902
912
913
+
Not all themes look good when transparency is ON, so themes can now declare whether they want to use transparency or not. This is the "\fBtransparency\fR" variable of the theme, which can have these values:
903
914
915
+
.RS5
916
+
.IP\fI0\fR3
917
+
means that the theme looks better with no transparency (default)
904
918
919
+
.IP\fI1\fR3
920
+
means that the theme looks better when transparency in ON
905
921
922
+
.IP\fI2\fR3
923
+
means that the theme looks good either way, and the global transparency setting (defined in \fBpyrRadio\fR config file) can be used.
906
924
907
-
925
+
.RE
908
926
.PP
909
-
\fBUsingTransparency\fR
927
+
Please notice that this is just a hint; themes will obey the rules above, but transparency can still be toggled using "\fIT\fR" (capital "\fIt\fR").
928
+
929
+
When the \fIThemeselectionwindow\fR is visible, a "\fI[T]\fR" string displayed at its bottom right corner will indicate that transparency is \fIon\fR.
910
930
911
-
\fBPyRadio\fRthemes are able to be used with a transparent background.
931
+
.SH Updating themes automatically
912
932
913
-
Pressing "\fBT\fR" will toggle the transparency setting (it is \fIoff\fRby default) and save this state in \fBPyRadio\fR's configuration file.
933
+
Terminal users have been using all kind of software to change / update / adapt their terminal colors and palettes, such as i\fBbASE16\fR(\fIhttps://github.com/chriskempson/base16\fR), \fBpywal\fR (\fIhttps://github.com/dylanaraps/pywal\fR), \fBwpgtk\fR (\fIhttps://github.com/deviantfero/wpgtk\fR), \fBtheme.sh\fR (\fIhttps://github.com/lemnos/theme.sh\fR), to name a few.
914
934
915
-
Setting transparency on, will actually force \fBPyRadio\fRto 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.
935
+
\fBpyradio\fRis now able to "watch" a given theme for changes and update its colors whenever the theme changes.
916
936
917
-
When the \fIThemeselectionwindow\fR is visible, a "\fI[T]\fR" string displayed at its bottom right corner will indicate that transparency is \fIon\fR.
937
+
To set up a theme for auto update, one would just open the "\fIThemeSelection\fR window, navigate to a theme under \fBUserThemes\fR and press "\fBc\fR". To create a \fIusertheme\fR just follow the procedure described in section \fBUserthemes\fR.
938
+
939
+
Consecuently, the default theme name will be preceded by:
940
+
941
+
.RS5
942
+
.IP\fB*\fR3
943
+
if the theme is the default one (the way it has always been).
944
+
945
+
.IP\fB-\fR3
946
+
if the theme is the default one, and \fBpyradio\fR will watch it for changes.
0 commit comments