<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
<title>Settings dialog</title>
<link rel="stylesheet" type="text/css" href="C.css">
<script type="text/javascript" src="jquery.js"></script><script type="text/javascript" src="jquery.syntax.js"></script><script type="text/javascript" src="yelp.js"></script>
</head>
<body><div class="page" role="main">
<div class="header"><div class="trails" role="navigation"><div class="trail">
<a class="trail" href="index.html" title="♪ Streamtuner2"><span class="media"><span class="media media-image"><img src="img/logo.png" class="media media-inline" alt="♪"></span></span> Streamtuner2 </a> › <a class="trail" href="index.html#configuration" title="Configuration">Configuration</a> » </div></div></div>
<div class="body">
<div class="hgroup"><h1 class="title"><span class="title">Settings dialog</span></h1></div>
<div class="region">
<div class="contents">
<p class="p">There are many options in streamtuner2. You can find the settings dialog in the edit menu,
preferences (last entry).</p>
<div class="terms"><div class="inner">
<div class="title title-terms"><h2><span class="title">It is separated into four main areas.</span></h2></div>
<div class="region"><dl class="terms">
<dt class="terms">Player</dt>
<dd class="terms"><p class="p">Lists audio formats and the applications which shall be used for playing.</p></dd>
<dt class="terms">Display</dt>
<dd class="terms"><p class="p">Influences the display of all stream/station lists.</p></dd>
<dt class="terms">System</dt>
<dd class="terms"><p class="p">Filesystem and environment settings. Boring.</p></dd>
<dt class="terms">Channel Plugins</dt>
<dd class="terms"><p class="p">Every channel tab can have specific options. These are configured here. Also you can disable channels you don't need.</p></dd>
</dl></div>
</div></div>
</div>
<div id="apps" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Player application settings</span></h2></div>
<div class="region"><div class="contents">
<p class="p">MIME types are elaborate identifiers for file types. audio/mp3 for example represents MP3 files, and audio/ogg
means just OGG.</p>
<p class="p">The text entry fields can hold the application name of an audio player. Often the application name
is just a lower case version of the program title, but you might have to look it up.</p>
<p class="p">Behind the application program name is a placeholder. If the audio player is invoked, this placeholder
gets replaces with an URL (a http://..-Link) of the selected radio stream.</p>
<p class="p">It's introduced by percent sign, and followed by letters. %m3u for example generates a .m3u file. Most
audio players understand that. Otherwise try %pls, which might even be faster because streamtuner2 doesn't
have to download and preprocess it. %srv instead gives a direct stream link.</p>
<p class="p">The entry for */* is a catch-all. If the audio format of a radio station isn't know, this application
gets called.</p>
<p class="p">Recording</p>
<p class="p">The last entry in the 'Apps' section specifies streamripper. It is used for recording stations. You
might want to add some commandline -arguments here.</p>
<div class="links topiclinks"><div class="inner"><div class="region">
<div class="linkdiv "><a class="linkdiv" href="config_apps.html" title="Audio players"><span class="title">Audio players</span><span class="linkdiv-dash"> — </span><span class="desc">Common applications to use as players.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="recording.html" title="Recording"><span class="title">Recording</span><span class="linkdiv-dash"> — </span><span class="desc">Save radio songs as MP3 files via streamripper.</span></a></div>
</div></div></div>
</div></div>
</div></div>
<div id="gui" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Display/GUI options</span></h2></div>
<div class="region"><div class="contents">
<p class="p">Most options here a self-explanatory. The options for the favicons define if station entries should
show little icons. Not all stations have one, so you might as well turn this off to conserve a little
memory.</p>
<p class="p">The number of stations setting is not honored by all channel plugins. Often it's not possible to
load more or fewer station entries. Some plugins have own settings (in the 'Plugins' section) even.
For the major plugins this however limits how much scroll text appears in the stream lists.</p>
<p class="p">"Retain deleted stations" keeps old entries, when you reload a category/genre. Shoutcast often
forgets stations or throws them out. If you keep this option enabled, these entries are kept in
streamtuner2. Browse down in the stations list to still see them.</p>
<p class="p">It's possible to select a Gtk+ theme. But not all themes work with all Gtk display engines, and
not all themes work with streamtuner2. You just have to try it.</p>
<p class="p">Remembering window states makes streamtuner2 not forget which channel and category was last
selected. You can however disable this option, and instead manually save the window states/layout
in the edit menu, if you want.</p>
</div></div>
</div></div>
<div id="system" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">System info</span></h2></div>
<div class="region"><div class="contents">
<p class="p">There are just a few options here, and some are hard-wired. Usually you don't want to change them.</p>
<p class="p">Setting another temporary directory might be useful, if you want to keep the temporary .m3u cache
files. They are created whenever you hit play. For archival or speed-up porposes you might want to keep
them elsewhere. They don't take a lot of space.</p>
</div></div>
</div></div>
<div id="plugins" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Plugin and Channel settings</span></h2></div>
<div class="region"><div class="contents">
<p class="p">Each channel plugin can bring its own list of configuration settings. These are collected here.</p>
<p class="p">The heading for each plugin is actually a button, which allows disabling the plugin. Alas the state
cannot be easily discerned with all themes.</p>
<p class="p">If you want to find out more about the short option descriptions (most settings are checkboxes),
please have a look into the channels directory /usr/share/streamtuner2/channels/ and corresponding
*.py files. These are readable, and sometimes contain more information.</p>
<div class="links topiclinks"><div class="inner"><div class="region">
<div class="linkdiv "><a class="linkdiv" href="internet_radio_org_uk.html" title="Internet-Radio.org.uk"><span class="title">Internet-Radio.org.uk</span><span class="linkdiv-dash"> — </span><span class="desc">Large radio directory from the UK.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="myoggradio.html" title="MyOggRadio"><span class="title">MyOggRadio</span><span class="linkdiv-dash"> — </span><span class="desc">Open source stream directory.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="shoutcast.html" title="Shoutcast"><span class="title">Shoutcast</span><span class="linkdiv-dash"> — </span><span class="desc">One of the bigger radio station lists.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="xiph.html" title="Xiph.org"><span class="title">Xiph.org</span><span class="linkdiv-dash"> — </span><span class="desc">ICEcast radio directory.</span></a></div>
</div></div></div>
</div></div>
</div></div>
<div class="sect sect-links" role="navigation">
<div class="hgroup"></div>
<div class="contents"><div class="links guidelinks"><div class="inner">
<div class="title"><h2><span class="title">More Information</span></h2></div>
<div class="region"><ul><li class="links "><a href="index.html#configuration" title="Configuration">Configuration</a></li></ul></div>
</div></div></div>
</div>
</div>
<div class="clear"></div>
</div>
<div class="footer"></div>
</div></body>
</html>