-
Notifications
You must be signed in to change notification settings - Fork 127
/
Copy pathindex.html
2310 lines (2144 loc) · 138 KB
/
index.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head>
<meta charset="utf-8" />
<meta name="generator" content="pandoc" />
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
<title>PyRadio Documentation</title>
<style>
body {padding: 2em;}
@media screen and (max-width: 770px) {
body {padding: 10px;}
}
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: 2em 0 1em 0; color: SaddleBrown; font-size: 1em;}
h4:before {content: "# "; font-weight: bold; vertical-align: middle;}
h5 {margin: 2em 0 1em 0; color: SaddleBrown; font-size: 1em;;}
h5:before {content: "## "; font-weight: bold; vertical-align: middle;}
p, table, ol, ul {margin-left: .8em;}
STRONG {color: SaddleBrown;}
dl {margin: 2em;}
dd {margin: 1em;}
dt {font-weight: bold;}
TABLE {border: 1px solid SaddleBrown; border-collapse: collapse; margin-left: auto; margin-right: auto; border-radius: 5px; -moz-border-radius: 5px; border-collapse:separate; box-shadow: 5px 5px 15px #888888;}
TH {text-align: left; vertical-align: top; padding: 5px;color: SaddleBrown;border: 1px solid SaddleBrown; background-color: SaddleBrown; color: white;}
TD {text-align: left; vertical-align: top; padding: 5px 10px;border: 1px solid SaddleBrown;}
pre { background-color: rgba(245, 245, 245, 1); color: #474747; padding: 1.5em; border: 1px solid #C7C7C7; border-radius: 5px; -moz-border-radius: 5px; -webkit-border-radius: 5px; overflow: auto; box-shadow: 5px 5px 15px #C7C7C7;}
.task-list {list-style-type: none; padding: 0; margin: 0 0 0 1em ;}
img{display: block; margin-left: auto; margin-right: auto; max-width: 750px; width: 100%; background:transparent; padding:3px; border:1px solid #999999; border-radius: 5px; -moz-border-radius: 5px; -webkit-border-radius: 5px; box-shadow:5px 5px 15px #888888;}
.indented {text-indent: -1.5em; padding-left: 1.5em; margin-left: 1em;}
a{ color: SaddleBrown;}
a:visited{color: SaddleBrown;}
</style>
</head>
<body>
<header id="title-block-header">
</header>
<h1 style="color: SaddleBrown" id="pyradio">PyRadio</h1>
<p>Command line internet radio player.</p>
<p><a href="https://members.hellug.gr/sng/pyradio/pyradio.png" target="_blank"><img style="width: 600px" src="https://members.hellug.gr/sng/pyradio/pyradio.png" alt="PyRadio" /></a></p>
<h2 id="table-of-contents">Table of Contents <span style="padding-left: 10px;"><sup style="font-size: 50%"><a href="#" title="Go to top of the page">Top</a></sup></span></h2>
<!-- vim-markdown-toc Marked -->
<ul>
<li><a href="#features">Features</a></li>
<li><a href="#requirements">Requirements</a></li>
<li><a href="#changelog">Changelog</a></li>
<li><a href="#installation">Installation</a></li>
<li><a href="#command-line-options">Command line options</a></li>
<li><a href="#controls">Controls</a>
<ul>
<li><a href="#global-shortcuts">Global shortcuts</a></li>
<li><a href="#customizing-key-bindings">Customizing key bindings</a></li>
</ul></li>
<li><a href="#html-help">HTML help</a></li>
<li><a href="#pyradio-modes">PyRadio Modes</a>
<ul>
<li><a href="#secondary-modes">Secondary Modes</a></li>
<li><a href="#tiling-manager-modes">Tiling manager modes</a></li>
</ul></li>
<li><a href="#config-file">Config file</a>
<ul>
<li><a href="#the-package-config-file">The package config file</a></li>
<li><a href="#the-user-config-file">The user config file</a></li>
</ul></li>
<li><a href="#about-playlist-files">About Playlist files</a>
<ul>
<li><a href="#defining-and-using-groups">Defining and using Groups</a></li>
<li><a href="#integrating-new-stations">Integrating new stations</a></li>
<li><a href="#specifying-a-playlist-to-load-(command-line)">Specifying a playlist to load (command line)</a></li>
<li><a href="#autoloading-playlists">Autoloading playlists</a></li>
<li><a href="#managing-playlists-(within-pyradio)">Managing playlists (within PyRadio)</a></li>
<li><a href="#managing-foreign-playlists">Managing foreign playlists</a></li>
<li><a href="#playlist-history">Playlist history</a></li>
</ul></li>
<li><a href="#stations-history">Stations history</a></li>
<li><a href="#search-function">Search function</a></li>
<li><a href="#line-editor">Line editor</a>
<ul>
<li><a href="#cjk-characters-support">CJK characters support</a></li>
</ul></li>
<li><a href="#moving-stations-around">Moving stations around</a></li>
<li><a href="#specifying-stations-encoding">Specifying stations’ encoding</a>
<ul>
<li><a href="#station-by-station-encoding-declaration">Station by station encoding declaration</a></li>
<li><a href="#global-encoding-declaration">Global encoding declaration</a></li>
</ul></li>
<li><a href="#player-detection-/-selection">Player detection / selection</a>
<ul>
<li><a href="#changing-player-mid-session">Changing player mid-session</a></li>
<li><a href="#specifying-a-stations-referer-url">Specifying a station’s Referer URL</a>
<ul>
<li><a href="#note-about-mplayer">Note about MPlayer</a></li>
<li><a href="#referer-support-in-the-playlist">Referer support in the playlist</a></li>
</ul></li>
<li><a href="#extra-player-parameters">Extra Player Parameters</a>
<ul>
<li><a href="#using-the-configuration-window">Using the Configuration Window</a></li>
</ul></li>
</ul></li>
<li><a href="#player-connection-protocol">Player connection protocol</a>
<ul>
<li><a href="#visual-reminder">Visual reminder</a></li>
</ul></li>
<li><a href="#player-default-volume-level">Player default volume level</a>
<ul>
<li><a href="#mpv">MPV</a></li>
<li><a href="#mplayer">MPlayer</a></li>
<li><a href="#vlc">VLC</a></li>
</ul></li>
<li><a href="#buffering">Buffering</a></li>
<li><a href="#displaying-station-info">Displaying Station Info</a></li>
<li><a href="#copying-and-pasting---registers">Copying and pasting - Registers</a></li>
<li><a href="#favorites-playlist">Favorites playlist</a></li>
<li><a href="#displaying-the-current-time">Displaying the Current Time</a>
<ul>
<li><a href="#configuration">Configuration</a></li>
</ul></li>
<li><a href="#pyradio-themes">PyRadio Themes</a></li>
<li><a href="#recording-stations">Recording stations</a></li>
<li><a href="#mouse-support">Mouse support</a></li>
<li><a href="#title-logging">Title logging</a>
<ul>
<li><a href="#tagging-a-title">Tagging a title</a></li>
</ul></li>
<li><a href="#online-radio-directory-services">Online radio directory services</a></li>
<li><a href="#desktop-notifications">Desktop Notifications</a></li>
<li><a href="#desktop-file">Desktop File</a>
<ul>
<li><a href="#specifying-the-terminal-to-use">Specifying the terminal to use</a>
<ul>
<li><a href="#specifying-pyradio-parameters">Specifying PyRadio parameters</a></li>
</ul></li>
</ul></li>
<li><a href="#session-locking">Session Locking</a>
<ul>
<li><a href="#session-unlocking">Session unlocking</a></li>
</ul></li>
<li><a href="#update-notification">Update notification</a></li>
<li><a href="#remote-control-server">Remote Control Server</a>
<ul>
<li><a href="#remote-control-client">Remote Control Client</a></li>
</ul></li>
<li><a href="#playing-a-station-in-the-terminal">Playing a station in the terminal</a></li>
<li><a href="#debug-mode">Debug mode</a></li>
<li><a href="#reporting-bugs">Reporting bugs</a></li>
<li><a href="#packaging-pyradio">Packaging PyRadio</a></li>
</ul>
<!-- vim-markdown-toc -->
<h2 id="features">Features <span style="padding-left: 10px;"><sup style="font-size: 50%"><a href="#" title="Go to top of the page">Top</a></sup></span></h2>
<p><strong>PyRadio</strong> provides the following features:</p>
<ul>
<li>vi like keys in addition to arrows and special keys</li>
<li><a href="radio-browser.html">RadioBrowser</a> support</li>
<li>Remote Control Server</li>
<li>Multiple playlist support</li>
<li>vi like station registers</li>
<li>Theming support</li>
<li>Station editor (add/edit) with <a href="#cjk-characters-support">CJK characters support</a></li>
<li>Configuration editor</li>
<li>Search function</li>
<li>Customizable key bindings</li>
<li>Easy installation / updating</li>
<li>Runs on Linux, macOS and Windows</li>
</ul>
<p>and much more…</p>
<h2 id="requirements">Requirements <span style="padding-left: 10px;"><sup style="font-size: 50%"><a href="#" title="Go to top of the page">Top</a></sup></span></h2>
<ul>
<li>python 3.7+
<ul>
<li>setuptools</li>
<li>wheel</li>
<li>requests</li>
<li>dnspython</li>
<li>psutil</li>
<li>rich</li>
<li>python-dateutil</li>
<li>netifaces</li>
</ul></li>
<li>MPV, MPlayer or VLC installed and in your path</li>
<li>MKVToolNix (cli files) to insert tags, chapters and cover to recordings (optional, if MPV or VLC is to be used, but mandatory in the case of MPlayer)</li>
</ul>
<p>Linux users will have to install a <a target="_blank" href="https://wiki.archlinux.org/title/default_applications#Resource_openers">resource opener</a> package, a utility to open directories, html pages, etc. <strong>PyRadio</strong> will look for <em>xdg-open</em>, <em>gio</em>, <em>mimeopen</em>, <em>mimeo</em> or <em>handlr</em>, in that order of detection. If a different <em>resource opener</em> is used, one can declare it in the <strong>Configuration Window</strong>.</p>
<!-- Changelog -->
<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;">
2025-03-21 s-n-g
* version 0.9.3.11.9 - 0.9.3.12-beta9
* fixing default station selection in the config window
* adding search support for both the config window and the shortcuts window
2025-03-19 s-n-g
* version 0.9.3.11.8 - 0.9.3.12-beta8
* fixing #281 - Favourite list becomes corrupted after adding station
* adding buffering config parameters: buffering and mplayer_save_br
* pressing \b will toggle global buffering for the session
* the Buffering Window will change station buffering value instead of config
* station volume will be saved (\v by default) and the playlist will
be silently saved - station volume will work for VLC only
* saveCurrentPlaylist: trailling commas will be eliminated
* updating Windows MPV download link
* adding bufferring.md and pyradio_buf man page
* updating docs
2025-03-13 s-n-g
* version 0.9.3.11.7 - 0.9.3.12-beta7
* fixing #280 - Removing station and saving removes
all URLs from stations.csv file
2025-03-10 s-n-g
* version 0.9.3.11.6 - 0.9.3.12-beta6
* fixing #279 - The list of favorite stations is reset when added
* fixing #278 - Typos 'RyRadio' when updating
* updating docs
2025-02-27 s-n-g
* version 0.9.3.11.5 - 0.9.3.12-beta5
* fixing the installation script
* playlist format change: adding profile, buffering, http, volume
and referer fields (support for these fields not implemented yet)
* referer files will be integrated to playlists
* config option added to invert the mouse wheel action (#272)
* fixing #276 : mouse support will always be on
- if disabled, mouse keys will be ignored
- toggling the config option does not require a program restart any more
* fixing #277: installation fails when username contains a space character
* removing not working stations from stations.csv
* updating docs
2025-01-18 s-n-g
* version 0.9.3.11.4 - 0.9.3.12-beta4
* adding a clock displayed at the beginning of the Status Line
* adding a new system theme: lambda_by_amski1
* all players will try to catch (and display) HTTP errors (403, 404,
503, etc) and player errors through Crash detection
* rearranging options in the Config Window
* the remote control server will be cleanly terminated when the terminal closes
* titles log: fixing a bug that would disallow writing the station name to the log
* when the External Player is used, pyradio will not exit; it will reload the tui
and continue from where it left off
* keep working on keyboard.py
* started working on localized shortcuts
* updating mpv player link on Windows
* fixing issues reported by pylint
* removing more python 2 code
* updating docs
2024-12-05 s-n-g
* version 0.9.3.11.3 - 0.9.3.12-beta3
* fixing a crash when opening RadioBrowser Config
* all config windows will display distro info (if applicable)
2024-12-05 s-n-g
* version 0.9.3.11.2 - 0.9.3.12-beta2
* Implementing the Shortcuts Window, making it possible to customize
PyRadio's key bindings
* fixing install.py (#262)
* implementing #252
2024-10-17 s-n-g
* version 0.9.3.11.1 (BUG FIX) - 0.9.3.12-beta1
* adding -sdd (--show_dirs) command line parameter
* fixing a couple of bugs (some reported by pylint /ruff)
* integrating suggestions by pylint / ruff
* adding a Everforest based system theme
* all keybindings are now customizable (interface not implemented yet)
2024-08-30 s-n-g
* version 0.9.3.11 (BUG FIX)
* recovering from regression after addressing #249
* updating docs
2024-08-30 s-n-g
* version 0.9.3.10
* do not enable xdg compliant if user_config_dir is specified
* do not create the default recording directory until it is
actually needed (to save data in it)
* when saving players' extra parameters reduce the list by removing
the unused porifles from the list
* Fixing player_params_file and schedule_file location when XDG
compliance is ON
* fixing a pyradio-client crash when no command is specified
* fixing: MPV Volume resets to 0% when trying to increase
beyond maximum #251
* fixing a help crash: adding H_CONFIG_PLAYER help key
* added a gruvbox variation system theme
* updating docs and fixing broken links
2024-06-04 s-n-g
* version 0.9.3.9
* fixing a crash when adding a station to favorites
2024-06-04 s-n-g
* version 0.9.3.8
* pressing "*" will add the selected station to favorites
* adding the possibility to declare a "Referer URL" for a station
* pyradio-client: /title will actually report the song title
* pyradio-client: beautifying output
* removing more python 2 code
* updating docs
2024-05-24 s-n-g
* version 0.9.3.7
* introducing the pyradio-client program
* adding three more System Themes
* do not allow to change the Recording Directory while recording
is on either in this instance or a headless instance
* fix PyRadioOpenDir: always open dir
* PyRadioRecordingDir: adding key 'd' to revert to deault
* fixing default opener detection
* if a linux opener is enetered but config not saved, and opener
window is opened again, display the one entered instead of the
saved opener
* fix stop mkvmerge recursive execution
* Remote Control Server: adding a warning to the info response,
if PyRadio is not in Main Mode
* Remote Control Server: introducing the /reconfig command
* Desktop Notifications: stations icons are now being cached
* config: adding parameter remove_station_icons, to remove
downloaded files on program exit
2024-05-10 s-n-g
* version 0.9.3.6
* fixing #241 - pyradio-recordings folder keeps showing in home directory
* When XDG compliance is forced due to both XDG_DATA_HOME and XDG_STATE_HOME
directories already exist, update the local Desktop file, so that the
Icon point to its new location
* fixing typos
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
* version 0.9.3.4 (BUG FIX)
* adding --no-video command line parameter for vlc
* removing more python 2 code
* updating macOS installation instructions (based on Ventura)
* fixing #239 - PyRadio doesn't remember warning message was already shown
* fixing loading saved and default config options in Config Window,
Recording Dir is excluded from change
* updating docs
2024-04-18 s-n-g
* version 0.9.3.3 (BUG FIX)
* adding a resource opener parameter for linux installations
* fixing issues #236 and #237
* fixing several minor bugs
2024-04-08 s-n-g
* version 0.9.3.2 (BUG FIX)
* fixing #233 (move .registers to state dir)
* fixing stations.csv (from erroneous PR #227)
* updating headless.md
2024-04-06 s-n-g
* version 0.9.3.1 (BUG FIX)
* fixing #231 - [BUG] pyradio-0.9.3 cannot be executed
* closing #232 - [BUG] self.xdg.xdg_compliant = False
2024-04-05 s-n-g
* version 0.9.3
* user config file will not be automatically created; it will be
created only when some parameter value is different to the one
set in the package config file
* adding -pc (--print-config) command line option
* adding the xdg_compliant config option (packagers option)
if set to True, config dir contents will be moved to XDG Base
dir (https://wiki.archlinux.org/title/XDG_Base_Directory)
* RadioBrowser: present next previous result pages
* RadioBrowser: adding Icon to station DB info
* Remote Control Server: adding commands relevant to RadioBrowser results
page navigation (text interface) and relevant web interface buttons
* Remote Control Server: adding REC button to web interface
* Remote Control Server: the output of the /info command will report
headless operation and if RadioBrowser is active, search term used and
page number
* introducing the Messaging System; most messages displayed to the user
have been transfered to messages_system.py
* moving PyRadio cache contents to ~/.cache (not on Windows)
* moving the recordings directory to home folder and renaming it to
"pyradio-recordings".
* adding recording_dir config parameter and window to customize it
* titles log files will be saved in the recordings directory
* if netifaces module is not installed, headless operation will be aborted
* fixing #229: Crash when $HOME/.mplayer directory does not exist
* fixing escaped chars in window title and litles log file
* adding a Windows python 3.12 workaround to the "curses silently exits" bug
* adding two Serbian stations in station.csv - PR #227
* updating documentation
2024-02-24 s-n-g
* version 0.9.2.25
* dropping python 2 - PyRadio will only run on python 3
* fixing #228
2024-01-12 s-n-g
* version 0.9.2.24 (BUG FIX)
* fixing mpv title parsing (once again)
* fixing "Genre" field wrapping on Station Info window
2024-01-11 s-n-g
* version 0.9.2.23 (BUG FIX)
* fixing issue #224 - crash when "artist", "album", "year"
string in received data
2024-01-05 s-n-g
* version 0.9.2.22 (BUG FIX)
* fixing bug #222 - Appending a radio station with A in a playlist
leads to a crash (when number stations is less than window height)
* fixing a crash that would occur when pressing ENTER on the Cancel
button of the "rename playlist" and "new playlist" window
2024-01-04 s-n-g
* version 0.9.2.21
* adding --headless command line parameter and functionality
* adding the --address command line parameter
* recorded files will always be saved in the recordings folder
If mkvtoolnix is present, a tmp_ prefix will be used to record
the raw file, which will be removed after chapters integration
* the message to indicate failure to connect to RadioBrowser will
be displayed for 2 seconds (instead of requiring a key press)
* mpv will read the "artist" and "title" fields from station response (#217)
* remote control server: adding functionality for RadioBrowser
* remote control server: do not disable individual buttons
* remote control server: will restart if crashed
* remote control server: can now accept real IPs (config option)
* introducing "remote control server lock" files
* trying to fix "pipx not found" on MacOS again
* fixing config window rendering bug (#215)
* fixing cover insertion to mkv files
* fixing escape character warnings for python 3.12
* fixing lock refresh issues
* working on scheduler (not available yet)
* updating win mplayer link
* creating issues templates
* updating documentation
2023-11-23 s-n-g
* version 0.9.2.20
* Creating the docs folder and moving files there
* Updating pyproject.toml and setup.py for the latest
Installation method changes
* Working on scheduler (not applicable yet)
* Updating docs
2023-11-06 s-n-g
* version 0.9.2.19 (BUG FIX release)
* cover.png updated
* make sure cover.png is in the data folder
* fix "No chapters found" message when recorded file has
less than 3 chapter markers
2023-11-03 s-n-g
* version 0.9.2.18
* fixing a crash on mkvtoolnix.py
2023-11-03 s-n-g
* version 0.9.2.17
* Recorded MKV files will have a cover image by default
(when MKVToolNix is installed)
* Adding -mkv, -scv, -srt, -ach and -lr command line parameters
(applicable when MKVToolNix is installed)
* Rearranging and grouping options in the program's help screen
* Working on scheduler (not applicable yet)
* Updating docs
2023-10-15 s-n-g
* version 0.9.2.16
* install.py: will terminate if python not in PATH
* recorded files will have tags inserted in them if mkvmerge
is detected. Chapters will also be added if the station
provides ICY Titles
* opening the config folder while recording will actually open the
recording folder
* buffering can now be disabled (in 0.9.2.15, once buffering was
enabled, it could not be disabled until program termination)
* fixing a couple of race conditions (threading lock files not being
released) that would lead to a freeze
* fixing players crash detection routines
* fixing config players parsing
* on Windows, downloaded recording files in the data directory
will be deleted at startup, when recording is not active
* adding recording man page
* Updating docs
2023-10-05 s-n-g
* version 0.9.2.15 (BUG FIX)
* fixing mplayer and vlc recording
* mplayer buffering min changed to 250KB
* fixing updateRecordingStatus not exiting when asked
* buffer size cannot be 0
2023-10-04 s-n-g
* version 0.9.2.14
* adding players buffering
* [B] will be displayed at top left corner of the window
when player is buffering
* adding "Force transparency" config option (as per #201)
* redesigning players' extra parameters window
* removing command line parameters -ep, -ap, lp
and changing -ocd etc.
* Windows: MPV installation will check CPU flags to
download V3 or normal mpv release
* fix_pyradio_desktop_file: parameters will be placed
after terminal name (before -e)
* fixing mpv parameter which might throw a warning
which would break the TUI
* fixing mplayer volume parsing error
* fixing a couple of python2 crashes
* updating build_install_pyradio (as per #203)
* updating docs
2023-07-15 s-n-g
* version 0.9.2.13
* all search widgets will save up to 20 of their last search terms
* VLC will now save its default volume
* adding --record command line parameter
* \l will toggle the "Open last playlist" config setting
* updating docs
2023-07-01 s-n-g
* version 0.9.2.12
* Implementing VLC recorder (not for Windows)
* MPlayer recorder will display volume level
* MPlayer on Windows 7 will not use profiles
* Trying different recorded file limit to start monitor
* updating docs
2023-06-20 s-n-g
* version 0.9.2.11
* implementing station recording for MPlayer media player
* players' config file will be backed up on Windows
* fixing a couple of potential crashes
2023-06-14 s-n-g
* version 0.9.2.10
* all PyRadio threads will terminate when Alt-F4 or the
close button is used to close the program
* adding a message about dateutil module missing
* fixing a Windows error that has made PyRadio unusable
on Windows
2023-06-13 s-n-g
* version 0.9.2.9
* fixing: Remote Control Server does not terminate when
PyRadio is closed with Alt-F4 or using the close button
2023-06-13 s-n-g
* version 0.9.2.8
* \o will open the config directory in a file manager
* implementing station recording for MPV media player
* implementing playback pause for MPV media player, when
player in recording mode
* fixing Windows installayion scripts
2023-06-05 s-n-g
* version 0.9.2.7
* fixing a couple of install.py potential crashes
* fixing a theme download potential crash
* theme transparency will always be honored, in contrast
to global (config transparency setting)
2023-05-08 s-n-g
* version 0.9.2.6
* using pipx for installation on "externally-managed"
python installations
* adding cache for pipx installation (and command line
parameters to handle it)
* --list will indicate Group Headers
* started working on scheduling
* updating docs
2023-04-07 s-n-g
* version 0.9.2.5
* Desktop Notifications will display the image
provided by the station (jpg or png).
* adding config option "Use station icon"
* adding a fourth optional column for pyradio playlists.
This column will define a station icon url.
* adding CJK chars support for Group Headers
* fixing a potential crash when randomly playing stations.
* trying to limit duplicate Desktop Notifications.
* adding a system theme: blue_by_boxer
* updating docs
2023-04-01 s-n-g
* version 0.9.2.4
* do not crash when we have a small number of Groups
* get a minimum size so that we don't get stuck
* position all windows relevant to parent
2023-04-01 s-n-g
* version 0.9.2.3
* fixing search function for Group Selection window (pressing
"n" or "N" will now work)
* random playback will not stop on a Group Header
* do not put new selection in the middle of window if already
visible (Group Selection window)
2023-03-31 s-n-g
* version 0.9.2.2
* adding support for Groups in playlists
* making sure that the stations update thread terminates timely
2023-03-24 s-n-g
* version 0.9.2.1
* do not ask to update stations when first installing pyradio
or when stations.csv has been copied from package
* perform a more thorough check when updating a station
2023-03-23 s-n-g
* version 0.9.2
* implementing "player change" (key: \m)
* working on stations deletion, do not delete stations
when session is locked
* changing the way stations.csv updates are done
* adding --update-stations (-us) command line option
* adding indication to denote forced http connection mode
* adding Catppuccin themes - https://github.com/catppuccin
* using rich to add color to console messages as per #174
(python 3 only)
* "Press ? for help" message will not show up when overlapping
normal messages
* working on MPV auto-installation on first install on Windows
* moving last-playlist file in data dir
* fixing pyradio not terminating when answering no to save a
modified playlist
* fixing a theme save crash
* removing some curses.ungetch calls
* updating docs
2023-02-20 s-n-g
* version 0.9.1
* adding pyproject.toml (as per pep-0518)
* adding the --config-dir (-c) command line argument
(as per #187) - Not available on Windows
* adding icons directory to distribution
* adding the /set_volume (/sv) text only RC command
* adding the /volume (/v) text only RC command
* adding WNYC station to stations.csv
* working on Windows MPV installation procedure
(making it less cumbersome and transparent)
* fixing system themes main border color
* fixing typos (thanks to @Wikinaut)
2023-01-28 s-n-g
* version 0.9.0
* finalizing RadioBrowser service (adding config
search term navigation), closing #93 and partially
closing #80
* adding search function to all stations/playlists
lists
* when terminal cannot change colors, always ask to
not display the warning message
* window title will not be resetted randomly
* fixing python2 config dirty indication
2023-01-16 s-n-g
* version 0.8.9.36 (0.9-beta33)
* fixing config win left ("h") key: will not exit when should be
decreasing a number
* fixing notification settings (pull request #175 from
RaeedAhmed/bugfix/notifications)
* moving execution data to "data" folder
* fixing Desktop file installation (linux)
* fixing pyradio_server man paget to installation
2023-01-10 s-n-g
* version 0.8.9.35 (0.9-beta32)
* fixing call to fix_pyradio_desktop_file during installation
2023-01-10 s-n-g
* version 0.8.9.34 (0.9-beta31)
* fixing a line editor crash
* adding \s to help (page 5)
2023-01-10 s-n-g
* version 0.8.9.33 (0.9-beta30)
* adding Remote Control Server
* mpv volume will not go from zero to max when decreasing
* all file read/write will be utf-8 encoded
(python2 not affected)
* fixing Windows lnk installation
* editing gruvbox themes
* adding "Border" parameter to themes as per #173
(not used by default in any of the existing themes)
* updating docs, creating pyradio_server man page
2022-12-09 s-n-g
* version 0.8.9.32 (0.9-beta29)
* Making it possible to disable the no themes start
up notification
* Fixing Config Window scrolling
* Fixing ping for python2 and the BSDs (again)
* Desktop Notification will stop when player is muted
* RadioBrowser config will be centered on screen
* RadioBrowser config will return to Config Window
* Started working on remote controlling PyRadio
2022-11-25 s-n-g
* version 0.8.9.31 (0.9-beta28)
* fixing icon installation and discovery
* fixing config window not showing last entry
2022-11-25 s-n-g
* version 0.8.9.30 (0.9-beta27)
* Adding a Desktop File
* Adding Desktop Notifications
* Adding --terminal and --terminal-param command line options
* Adding --no-themes command line option
* Fixing Windows uninstallation script
* Fixing opening registers by name
* Fixing ping command for BSD
* The installation will fail if pip not found
* Trying to restore windows title on exit (not for Windows)
* URL will not overlap the title
2022-09-27 s-n-g
* version 0.8.9.28 (0.9-beta25)
* adding play next/previous station to global functions
* fixing Connection Type window colors
* fixing line editor blobal function handler
* fixing a couple of stations history bugs
* fixing station listing for CJL characters
* updating docs
2022-09-18 s-n-g
* version 0.8.9.27 (0.9-beta24)
* Implementing Stations History as per #161
* Station encoding will be checked before used
* Fixing several crashes
* Fixing several Python 2 errors
* Fixing station paste to playlist
* Fixing RadioBrowser columns when CJK characters are
present, on Windows
2022-08-28 s-n-g
* version 0.8.9.26 (0.9-beta23)
* adding calculated messages windows color
* adding "Calculated Color" config option
* Windows installation will try to install 7-Zip, if not
already installed
2022-08-14 s-n-g
* version 0.8.9.25 (0.9-beta22)
* fixing global shorcuts inside RadioBrowser search window
(as per #164)
2022-08-12 s-n-g
* version 0.8.9.24 (0.9-beta21)
* fixing several theme issues (exchanging cursors background color
and making borders visible for theme.sh themes, when border
color is equal to background color)
* fixing a crash when requests fails to download a base16 theme
* transparency changes will now be consistent with theme transparency
* updating docs, including info on theme-sh-pyradio repo
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
* theme auto update implemented
* themes updated (1 added)
* updating docs
2022-06-26 s-n-g
* version 0.8.9.21 (0.9-beta18)
* Theme Selection window partly rewritten
* Converting themes to using CSS colors
* Themes updated and new themes added
* Updated docs
2022-05-22 s-n-g
* version 0.8.9.20 (0.9-beta17)
* going back to history will ask to save a modified playlist
* fixing #157 (python2 only)
* other minor changes
2022-05-19 s-n-g
* version 0.8.9.19 (0.9-beta16)
* fixing main window galobal shortcuts ( #156 )
* fixing RadioBrowser Search Window global shortcuts
2022-05-18 s-n-g
* version 0.8.9.18 (0.9-beta15)
* changing shortcut w and ^W to e and ^E on the RadioBrowser
Search Window
* implementing global functions
* fixing a couple of bugs and crashes
* updating docs
2022-04-29 s-n-g
* version 0.8.9.17 (0.9-beta14)
* adding Title's Log
* changing versioning
* fixing user installation in build_install_pyradio
* fixing python2 main.py crash (#153)
* updating docs
2022-03-18 s-n-g (0.9-beta13)
* version 0.8.9.16 (0.9-beta13)
* fixing install.py script
* installing Start Menu Shortcut on Windows
2022-03-15 s-n-g
* version 0.8.9.15 (0.9-beta12)
* fixing "0" and "$" insertion on RadioBrowser search window
* macOS installation method updated to pip
* fixing a macOS RadioBrowser interface breakage
* Windows installation method updated to pip
* adding F7, F8, F9, F10 functionality for Windows
* updating docs
2022-02-14 s-n-g
* version 0.8.9.14 (0.9-beta11)
* fixing typo in player.py
2022-02-13 s-n-g
* version 0.8.9.13 (0.9-beta10)
* fixing #148
* fixing a potential psutil crash
2022-01-26 s-n-g
* version 0.8.9.12 (0.9-beta9)
* Fixing install.py
2022-01-25 s-n-g
* version 0.8.9.11 (0.9-beta8)
* Fixing (#147): Cannot type "t" in RadioBrowser Search window
* Trying to fix install.py crash
* Adding MPV support on Windows
2022-01-17 s-n-g
* version 0.8.9.10 (0.9-beta7)
* RadioBrowser config window almost finished
* RadioBrowser search window shortcuts changes
* save config before entering config window, when theme is changed
* fixing compiling/build error for arch linux (#146)
* fixing Windows installation as per (#145)
* adding check for -p parameter (int)
* keep looking for a station after playback failure when random is on
* trying to better VLC start of playback detection
* trying to eliminate crashes when window width gets small
(like in tilling managers)
* show correct help page when in online browser
* disabling theme editing per (#141)
* adding last opened playlist support as per (#138)
* HTML help can be displayed using \h
* Fixing installation of HTML files for all platforms and modes
* Incorporating the Changelog into README.html (offline help)
* install.py will always use the requested python version
* install.py will use special indication per command line
(-sng for --sng-master and -sng-dev for --sng-devel)
* Adding --git option to install.py
* Windows installation will fail if a dependency fails to install
* mplayer on Windows: do not fail to start a station
after astop/start command
* Updating docs
2021-08-31 s-n-g
* Version 0.8.9.9 (0.9-beta6)
* Search history navigation will work with normal keys
in addition to Control-key combinations (when a line
editor does not have the focus)
* When navigating to a new search term, in the RadioBrowser
Search Window, the two main check boxes will always get
the focus (makes it easier to navigate using normal keys)
* Docs Updated
2021-08-22 s-n-g
* Version 0.8.9.8 (0.9-beta5)
* Fixing RadioBrowser save pop up window
* Interchanging ^T and ^Y in the RadioBrowser Search Window
* Addinf FULL_SCREEN_MODES for farter rendering
2021-08-20 s-n-g
* Version 0.8.9.7 (0.9-beta4)
* RadioBrowser: closing with "q" or "Escape"
* RadioBrowser: do not close if network fails
* RadioBrowser: added hidebroken to all queries
* RadioBrowser: if limit=0, disable result limit
* RadioBrowser: finalized config save / read function
* RadioBrowser: All Search Window movement keys (^N, ^P, ^Y)
will add a new history item (if possible)
* RadioBrowser: ^B does not save history to file
* RadioBrowser: Better navigation in the Search Window
* Fixed a couple of python 2 crashes
* Updated docs
2021-08-15
* Version 0.8.9.6 (0.9-beta3)
* RadioBrowser History Management finalized
* Fields' placement fixed in RadioBrowser Search Window
* RadioBrowser man page added
* Docs updated
2021-08-11 s-n-g
* Version 0.8.9.5 (0.9-beta2)
* Fixed a crash that would occur when searching for name only in
RadioBrowser Search Window
* Do not display the Theme Selection Window when pressing "t" in a
RadioBrowser Line Editor
* Updated History legend aread
* Updated docs
2021-08-11 s-n-g
* Version 0.8.9.4 (0.9-beta1)
* RadioBrowser implementation is now usable (but still not complete)
* Implemented ^N,^P to play next/previous station as per (#135)
* Several python2 fixes
* Updating docs
2021-07-13 s-n-g
* Version 0.8.9.3
This is an "internal" release testing (#135)
2021-05-11 s-n-g
* Version 0.8.9.2
* Screen flickering when moving within the stations' list eliminated
* VLC player is available again (disabled by unreported bug)
* Advancing RadioBrowser support
* Fixing python 2 return from RadioBrowser TUI breakage
* Adding dnspython module availability check
2021-04-14 s-n-g
* Version 0.8.9.1
* Implemented the so called "Listening" mode, in which PyRadio TUI
can be reduced down to a single line (the "Status Bar"). Requested
for tilling WM use (#128)[https://github.com/coderholic/pyradio/issues/128]
2021-04-03 s-n-g
* Version 0.8.9
* Implemented a simplified method to install, update, uninstall.
* PyRadio will detect its player abnormal termination.
* Player's connection timeout can now be disabled. Once a player is
started, it will be considered to be connected immediately.
* stations.csv changes can now be integrated into user's stations.csv
* mplayer "pyradio" profile will use the internal mixer to adjust volume
* BUG FIX: Active players parameter list is always synchronized to saved.
* BUG FIX: Clicking on empty space (past last station) will not crash pyradio.
2021-02-27 s-n-g
* Version 0.8.8.5 (BUG FIX release)
* Fixing -ap value not activated by player
* Commenting out excessive error log messages
2021-02-27 s-n-g
* Version 0.8.8.4 (BUG FIX release)
* Fixing double click behavior (while in playback
double clicking to a different station will start it.
* vcl will not start muted (volume = 0)
2021-02-26 s-n-g
* Version 0.8.8.3
* Basic mouse support implemented
* Config option to enable mouse support added
* Implementing players extra parameters set.
* Player selection Config window redesigned.
* Adding -ep. -ap, -lp command line parameters.
* Fixing a bug which would lead to a crash when "r"