Internet radio browser GUI for music/video streams from various directory services.

โŒˆโŒ‹ โŽ‡ branch:  streamtuner2


Check-in [c032acbb92]

Overview
Comment:Add notes on deprecations.
Downloads: Tarball | ZIP archive | SQL archive
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA1:c032acbb92956d80cd854223fdc63509bdaf3d31
User & Date: mario on 2020-05-18 12:58:09
Other Links: manifest | tags
Context
2020-05-18
12:58
If enabling https/certifi doesn't seem to work, just suppress ssl warnings. check-in: b4fb10f598 user: mario tags: trunk
12:58
Add notes on deprecations. check-in: c032acbb92 user: mario tags: trunk
2020-05-17
07:47
Adapt some links between configuration docs check-in: 195e8e4ec5 user: mario tags: trunk
Changes

Modified PACKAGING from [4883c4bdc9] to [60b1f4be5f].

1
2
3
4
5
6











7
8
9
10
11
12
13
..
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
..
80
81
82
83
84
85
86

87
88
89
90
91
92
93
# pack: PACKAGING=

This is a short summary for distribution package maintainers.
For regular end-user documentation please see the README and
help/ pages.













Structural changes from 2.1.5 onwards (2015-04-xx)
--------------------------------------------------

 โ†’ There's a new `bin` script. It's a lightweight invocation
   wrapper, intended to be installed as /usr/bin/streamtuner2
   now.
................................................................................
   themselves later.)
 

Aux files
---------

 โ†’ Help files still need to go to share/docs/streamtuner2/help/
   unless you patch the source.

 โ†’ *.desktop as usual

 โ†’ and `icon.png` is the /share/pixmaps/ icon


Removed
-------

Most plugin PNGs may have been removed already. (Embedded
binary data may violate some distro guidelines(?), but hey,
fewer files are fewer files!)

And the streamtuner2.png logo is now source-embedded instead;
the `logo.py` module provides a `logo.png` base64-string.

The old `gtk2.xml` file is gone. It probably became obsolete
................................................................................
Also, hard dependencies are meanwhile:

  - gtk (>= 2.16)
  - pygtk                           [or python-gi for python3]
  - python-requests (>= 2.0.0)
  - python-pyquery    [though most plugins would work without]
  - and its implied python-lxml


Optional dependencies (just affects a single plugin, which
semi-gracefully disables itself):

  - python-keybinder   [for global_key]
  - python-dbus        [for radiotray]







>
>
>
>
>
>
>
>
>
>
>







 







|









|







 







>







1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
..
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
..
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
# pack: PACKAGING=

This is a short summary for distribution package maintainers.
For regular end-user documentation please see the README and
help/ pages.


Changes in 2.2.2 (2020-05-xx)
-----------------------------

There's been a few deprecations:

 ยท youtube is now in contrib/
 ยท dirble, listenlive, delicast, streamlicensing, tuner2
   are gone 
 ยท don't package the contrib/disabled/ folder


Structural changes from 2.1.5 onwards (2015-04-xx)
--------------------------------------------------

 โ†’ There's a new `bin` script. It's a lightweight invocation
   wrapper, intended to be installed as /usr/bin/streamtuner2
   now.
................................................................................
   themselves later.)
 

Aux files
---------

 โ†’ Help files still need to go to share/docs/streamtuner2/help/
   unless you patch the source. (Don't package html/ along.)

 โ†’ *.desktop as usual

 โ†’ and `icon.png` is the /share/pixmaps/ icon


Removed
-------

All prior channel icons/PNGs have been removed. (Embedded
binary data may violate some distro guidelines(?), but hey,
fewer files are fewer files!)

And the streamtuner2.png logo is now source-embedded instead;
the `logo.py` module provides a `logo.png` base64-string.

The old `gtk2.xml` file is gone. It probably became obsolete
................................................................................
Also, hard dependencies are meanwhile:

  - gtk (>= 2.16)
  - pygtk                           [or python-gi for python3]
  - python-requests (>= 2.0.0)
  - python-pyquery    [though most plugins would work without]
  - and its implied python-lxml
  - python-pillow     [or compatible PIL]

Optional dependencies (just affects a single plugin, which
semi-gracefully disables itself):

  - python-keybinder   [for global_key]
  - python-dbus        [for radiotray]

Modified README from [89ac5b1acb] to [335fcc53f6].

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
..
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
# pack: README=/usr/share/doc/streamtuner2/


Streamtuner2
============

ST2 is a browser for internet radio/streaming stations. It queries
directories like Shoutcast, TuneIn, MyOggRadio, Xiph.org. SurfMusic,
Jamendo etc. for music/video streams/collections.

It mimics the original streamtuner 1 to some extend.
It's however written in Python now instead of C.


Installation howto
------------------

If possible, prefer the package directly from your BSD/Linux distribution.


Due to a longer maintenance and release break, some still have older 2.0.x
versions however - whose channel plugins barely work anymore. If so, you
should install a newer version / manually.


Dependencies
------------

Running streamtuner2 requires Python and Gtk packages. Which nowadays are
installed per default. There's a few more Python packages required though:
................................................................................

Use your distro package manager with e.g.:

  sudo apt-get install python python-gtk2 python-xdg python-requests ...

Or utilize Pythons local package installer even:

  sudo pip install requests
  sudo pip install pyquery


DEB / RPM
---------

There are rudimentary packages built as .DEB and .RPM version. Install
those if feasible. The dependencies may not match with your package
................................................................................
manager, and are somewhat incomplete. (See "Dependencies" section.)


PYZ
---

Other users may wish to try the new Python archive (.PYZ) instead. Which
requires little installation and can be run asis:

    python streamtuner2.pyz

You could even make this Python ZIP executable, and copy it in your PATH.


EXE







|
|


|





|
<
>
|
<
<







 







|
<







 







|







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
..
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
# pack: README=/usr/share/doc/streamtuner2/


Streamtuner2
============

ST2 is a browser for internet radio/streaming stations. It queries
directories like Shoutcast, TuneIn, Xiph.org. SurfMusic, Jamendo etc.
for music/video streams/collections.

It mimics the original streamtuner 1 to some extend.
However it's written in Python now instead of C.


Installation howto
------------------

If possible, prefer the package directly from your BSD/Linux distribution

over manually installing dependencies.
The PYZ package is the easiest option for local installations.




Dependencies
------------

Running streamtuner2 requires Python and Gtk packages. Which nowadays are
installed per default. There's a few more Python packages required though:
................................................................................

Use your distro package manager with e.g.:

  sudo apt-get install python python-gtk2 python-xdg python-requests ...

Or utilize Pythons local package installer even:

  sudo pip install requests pyquery pillow



DEB / RPM
---------

There are rudimentary packages built as .DEB and .RPM version. Install
those if feasible. The dependencies may not match with your package
................................................................................
manager, and are somewhat incomplete. (See "Dependencies" section.)


PYZ
---

Other users may wish to try the new Python archive (.PYZ) instead. Which
requires little installation and can be run as is:

    python streamtuner2.pyz

You could even make this Python ZIP executable, and copy it in your PATH.


EXE