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

⌈⌋ branch:  streamtuner2

Top-level Files of 57e4b7c323f2985a

Files in the top-level directory of check-in 57e4b7c323f2985a

# type: doc
# pack: README=/usr/share/doc/streamtuner2/


ST2 is a browser for internet radio/streaming stations. It queries
directories like Shoutcast, TuneIn, MyOggRadio, 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.


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
  sudo pip install pyquery


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


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:


The easy way:

 · Run `sudo make install`
   which installs into the default location (/usr/share/streamtuner2).

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.


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
installed, and open the "gtk3.xml" file. There it's easy to
rename or rearrange things.

Note that newer releases expect a compressed version of that
ui description. Use `make glade` simply, or `make gtk3` to
update the compressed version from the plain gtk.xml afterwards.


You'll find the current source files under

That's a fossil DVCS repository. Which is miles easier to use than
git. You can download the single binary from
or from your distro, then check out the repo:

  fossil clone st2.fossil
  fossil open st2.fossil

Or browse the contents

  fossil ui

Alternatively there are git and svn exports.

  fossil export --svn

You can send in patches, a fossil bundle, or set up your cloned
repo publically per `fossil cgi`. Else just create an account on, and send a mail, so I can elevate that
account to developer/commit/push permissions quickly. (Fossil
repos don't break. So dealing out sync access is a no-brainer.)


for a list of recommended alternatives. Future ST2 versions will
try to interface and share more with them.


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

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