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
# 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.






>
>
>
>
>
>
>
>
>
>
>







1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
# 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.
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
   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







|









|







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
   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
80
81
82
83
84
85
86

87
88
89
90
91
92
93
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]








>







91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
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].

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
# type: doc
# 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:








|
|


|





|
|
|
<
<







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
# type: doc
# 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:
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

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







|
<














|







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

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