Install Python>=2.3, wxPython>=2.6 and mxDateTime for Python

All these are available as part of most mainstream Linux Distributions.

Installing Tunapie

Uncompress the file (tar xzf tunapie_x.x.x.tar.gz) change into the tunapie directory and as root type ./install.

If you wish to install the uncensored TV listings, instead type ./install --adult

Using Tunapie

Hopefully it should be fairly self-evident. On startup, Tunapie will contact the Shoutcast directory server and try to download a the latest list of radio and TV streams. It will then show a list of the streams in the centre listbox of the Tunapie GUI. If there is some problem with downloading the listing, Tunapie will print "No Streams Found". This is usually due to a server-side problem, but check your internet connetction!

You should probably check out the preferences to start with, under the file menu. This will give you a listing of all the helper programs Tunapie will use to play audio or TV streams. As long as these are installed and the path is correct for them, you will not have to make any alterations. Also in the preferences window is a choice between Shoutcast or Icecast as the default directory server. Shoutcast is more complete (at the moment) but Icecast is more open!

You can play streams by highlighting a stream and pressing play, double clicking on it, or pressing enter. You can navigate the streams using the arrow keys. You can add favorites which will be stored by pressing the add button. These can be ordered using the up and down arrows under the favorites listbox, and deleted with the delete button.

You can select TV or radio with the radio selection buttons at the top of the GUI. You can also click info to get information about the streams (useful to find out the IP).


Type whatever you want to search for in the box below the main listbox and click the Go button. Tunapie will list all the streams in either TV or radio (depending on which is set) that match your search. Note that when searching radio on the Shoutcast server, Tunapie will contact the Shoutcast server to perform the search in order to get more matches. For Icecast, it downloads the full listing at startup, so there is no necessity to recontact the server.


For recording to work, you must have streamripper installed. Also, some versions of streamripper rip video files renaming them to *.mp3. You have to manually rename them back to *.nsv to play them once they have been recorded.

There are two options for the recording menu. You can either choose to record the selected stream immediately, in which case you will get an xterm which will give you feedback about the recording. You will have to manually terminate the recording. Alternatively, you can use the timer option. This is set to start recording from the current time so you can use it to record immediately for 1 hour (for example). Alternatively, you can set it to record the stream at some point in the future. If the stream changes it's IP in the time between setting the recording and the recording starting it will not work (obviously!).

After you have set a timed recording, you can view and potentially delete it (along with any other "at" tasks you might have set) with the File-Record Queue menu.


File-reload reloads the current directory. This is useful if the directory has not downloaded properly (as is happening quite a lot recently with the unreliable Shoutcast server). Also, as Icecast is set to download only once per day, this is useful if the Icecast listing gets too out of date (lots of streams stop working).