#include <infodrom.style>

<page title="Infodrom Oldenburg Tools"
      keywords="netradio, Internet Radio, webradio, playlist, WinAmp">

<h2>netradio-list</h2>

<p>This utility helps keeping track of your favourite Internet radio
stations.  Its goal is to reduce the hassle of lost and outdated
streams.  The program produces output compatible to the m3u format and
can be used directly as input for several audio players, such as the
<a href="http://www.musicpd.org/">music player daemon</a>.</p>

<p>Unfortunately, Internet radio stations have to change their stream
addresses from time to time.  Whenever this happens the streams stored
inside your player configuration become invalid.  The hassle and
search for the proper stream address starts again.</p>

<p>This program will calculate a new playlist in the m3u format upon
every execution.  It works on the assumption that the address of the
pls and m3u playlist file for a particular Internet radio station
expire less frequently.</p>

<p>Input is read from a simple configuration file in which all
favourite radio stations are configured.  The output will be written
to standard out and can thus be redirected by the shell or
post-processed by the calling program.  As a bonus the name and
website (if provided) for a given Internet radio station will be
written into the output as a comment.</p>

<h3>Synopsis</h3>

<pre>
  netradio-list [--config|-c conffile] [--agent|--useragent|-ua agentstring]
</pre>

<p>The default location for the config file is <file>~/etc/netradio.conf</file>.
This is changed with the <em>--config</em> parameter.  The program
sends the <em>UserAgent</em> string configured in the LWP library if
not specified otherwise with the <em>--useragent</em> parameter.</p>

<h3>Configuration file</h3>

<p>The configuration file uses a very simple format.  Only the name of
the station (given in square brackets) and the address of the playlist
file is required.  The url is given only for later reference in case
the playlist file is hosted on a different server and became
invalid.</p>

<p>One station entry looks like:</p>

<p><pre>
   [Frequence 3]
   url = http://www.frequence3.net/
   stream = http://streams.frequence3.net/mp3-192.m3u
</pre></p>

<p>Several of these are allowed.  The order in which stations are
listed are honoured by the program and thus the resulting playlist
file.  You may list more than one playlist stream addresses by
duplicating the <em>stream</em> line.</p>

<h3>Program Code</h3>

<p>The program is written in Perl using only Getopt::Long and
LWP::UserAgent.  It should run without problems on any GNU/Linux, BSD
and Unix systems.</p>

<p><a href="http://cvs.infodrom.org/scripts/netradio-list?cvsroot=infodrom">CVS</a>.
<p><a href="http://cvs.infodrom.org/~checkout~/scripts/netradio-list?rev=HEAD&content-type=text/plain&cvsroot=infodrom">Download</a>.

</page>

# Local variables:
# mode: indented-text
# end: