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

⌈⌋ ⎇ branch:  streamtuner2


Diff

Differences From Artifact [b84883b320]:

To Artifact [d424df7f25]:


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


streamtuner2
============

ST2 is a internet radio browser. It queries online directories like
shoutcast and xiph.org for music stations.

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


installation howto
------------------

You can just execute the main binary "st2.py".

All the other files need to be copied into /usr/share/streamtuner2/ however.

In particular the channel/ directory needs to reside there, so ST2 can find
all its plugins.



If it doesn't work, make sure you have Python and gtk/pygtk installed:








  sudo apt-get install python python-gtk2 python-glade2 python-xdg

And a few modules like:


  sudo apt-get install python-requests python-pyquery python-keybinder

You can also install Python modules per `pip` with

  sudo pip install requests

The gtk*.xml file represents the GUI, btw.  So with glade installed, you


can inspect and adapt the interface.


















































alternatives
------------

* http://sourceforge.net/projects/radiotray/
* https://sites.google.com/site/glrpgreatlittleradioplayer/
* http://tunapie.sourceforge.net/
* VLC also has a few directory discovery services built-in
* Rythmbox comes with last.fm, libre.fm, radio lookups


license
-------

Public Domain.
(no rules: unrestricted copying, modification, distribution, etc.)















|


|
>
|
>
|
<
>
>

|
>

>
>
>
>
>
>
|

<
>

|

|



|
>
>
|
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>















|
|
>
>

>
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

streamtuner2
============

ST2 is a internet radio browser. It queries online directories like
shoutcast and xiph.org for music stations.

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 an excessive maintenance break, some still have older 2.0.8 version
however - which barely works anymore.
If so, you should use a manually installed version.


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

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

 · python | python3
 · pygtk | python-gi
 · python-requests
 · python-pyquery
 · python-lxml
 · python-keybinder (optional)
 · python-xdg (optional)


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


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

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


PYZ
---

Other users may wish to try the new Python archive (.PYZ) instead. Which
requires little installation, but can just be run in-place:

    python streamtuner-2.1.5.pyz

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


Manual installation
-------------------

If you've checked out the source code repository, or did download the
*.src.txz archive, then you can just run it right there:

   ./st2.py

To install it manually:

  · Create a /usr/share/streamtuner2/
  · Copy all *.py files there.
  · Also copy the "gtk3.xml" file into /usr/share/streamtuner2/
  · Copy the channels/ subdir into /usr/share/streamtuner2/channels/
  · Install "bin" as /usr/bin/streamtuner2.
  · If you want to use another target, just edit the "bin" wrapper.
  · Optionally copy the help/ folder to /usr/share/docs/streamtuner2/
  · And the logo.png into the system pixmaps/,
    as well as the *.desktop file into /usr/share/applications/

That's pretty much what the binary packages extract to.


Hacking
-------

If you want to edit a channel plugin, just have a look into the
channels/*.py files. It's often rather easy to adapt things.

Moreover you can also edit the user interface. You need glade-3
installed, and open the "gtk3.xml" file. There it's easy to
rename or rearrange things.


alternatives
------------

* http://sourceforge.net/projects/radiotray/
* https://sites.google.com/site/glrpgreatlittleradioplayer/
* http://tunapie.sourceforge.net/
* VLC also has a few directory discovery services built-in
* Rythmbox comes with last.fm, libre.fm, radio lookups


license
-------

Public Domain. (Unrestricted copying, modification, etc.)

If you wish you could thus redistribute it under a BSD/MIT
or even GNU-style license.