<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#channels" title="Channel tabs">Channel tabs</a> » </div>
</div></div>
<div class="body">
<div class="hgroup"><h1 class="title"><span class="title">Bookmarks</span></h1></div>
<div class="region">
<div class="contents">

<p class="p">Streamtuner2 allows to bookmark favoured streams/stations.
	Which is what the <span class="gui">bookmarks</span> tab is for, of course.</p>
<p class="p">Use the right click a stations <span class="guiseq"><span class="gui">context menu</span> ▸ <span class="gui">bookmark</span></span>
        or <span class="key"><kbd>F8</kbd></span>.</p>
<p class="p">Once bookmarked the station is listed under
        <span class="guiseq"><span class="gui">bookmarks</span> ▸ <span class="gui">favourite</span></span>.
        Additionally every appearance of the station in channel tabs gets a ★
        star icon.</p>
</div>
<div id="editing" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Editing</span></h2></div>
<div class="region"><div class="contents">
<p class="p">Entries can be removed from the bookmark list again. Use
        <span class="guiseq"><span class="gui">Edit</span> ▸ <span class="gui">Delete</span></span> or the <span class="key"><kbd>DEL</kbd></span>
	key for that.</p>
<p class="p">You can also manually adapt an entry via <span class="guiseq"><span class="gui">Station</span> ▸ <span class="gui">Edit</span></span> or <span class="key"><kbd>F3</kbd></span>.
	</p>
</div></div>
</div></div>
<div id="other" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Subcategories</span></h2></div>
<div class="region"><div class="contents">
<p class="p">The bookmarks tab can display other categories besides "favourite". For example the
	search feature creates a "search", while the "timer" and "links" plugins also display
	lists here.</p>
<div class="note note-bug" title="Bug"><div class="inner"><div class="region"><div class="contents"><p class="p">However the favourite list itself can not yet be categorized
	further.</p></div></div></div></div>
<div class="links topiclinks"><div class="inner"><div class="region">
<div class="linkdiv "><a class="linkdiv" href="search.html" title="Searching"><span class="title">Searching</span><span class="linkdiv-dash"> — </span><span class="desc">Quicksearch field and Ctrl+F compound search window.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="timer.html" title="Timer"><span class="title">Timer</span><span class="linkdiv-dash"> — </span><span class="desc">Programming recurring play and recording events.</span></a></div>
</div></div></div>
</div></div>
</div></div>
<div class="sect sect-links" role="navigation">

<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#browsing" title="Browsing channels and radio stations">Browsing channels and radio stations</a> » </div></div></div>
<div class="body">
<div class="hgroup"><h1 class="title"><span class="title">Channels</span></h1></div>
<div class="region">
<div class="contents">
<p class="p">The tabs in the main window represent the music directory
        channels/services.  Each lists categories/genres and their associated radios/streams.</p>

<div class="media media-image"><div class="inner"><img src="img/channels.png" class="media media-block" alt=""></div></div>
<p class="p">The notebook tabs can also be repositioned with
        <span class="guiseq"><span class="gui">Edit</span> ▸ <span class="gui">Channel tab position</span> ▸ <span class="gui">Left</span></span>.</p>
<p class="p">If you first select a channel tab, the categories should appear or be loading.
        Otherwise:</p>
<div class="steps"><div class="inner"><div class="region"><ol class="steps">
<li class="steps"><p class="p">Select a channel tab</p></li>
<li class="steps"><p class="p">Choose <span class="guiseq"><span class="gui">Channel</span> ▸ <span class="gui">Reload categories...</span></span></p></li>
<li class="steps"><p class="p">Pick a category/genre from the overview, left.</p></li>
</ol></div></div></div>
<p class="p">Individual channels provide different music/radio information. The table
        views are mostly identical in each tab. Some views may rename columns, or remove
        them alltogether.</p>
</div>
<div id="list" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Available channels</span></h2></div>
<div class="region"><div class="contents"><div class="links topiclinks"><div class="inner"><div class="region">
<div class="linkdiv "><a class="linkdiv" href="bookmarks.html" title="Bookmarks"><span class="title">Bookmarks</span><span class="linkdiv-dash"> — </span><span class="desc">Collect favourites via bookmark function, entry editing and deleting.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="internet_radio_org_uk.html" title="Internet-Radio.com"><span class="title">Internet-Radio.com</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="jamendo.html" title="Jamendo"><span class="title">Jamendo</span><span class="linkdiv-dash"> — </span><span class="desc">Creative Commons music and artist hub.</span></a></div>

</div></div></div></div></div>
</div></div>
<div id="homepage" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Channel service homepage</span></h2></div>
<div class="region"><div class="contents"><p class="p">You can dobule click the channel tab to visit the channel/directory homepage.
	Alternatively there is an entry in the <span class="gui">Channel</span> menu.</p></div></div>
</div></div>
<div id="actions" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Channel menu actions</span></h2></div>
<div class="region"><div class="contents">
<div class="terms"><div class="inner"><div class="region"><dl class="terms">
<dt class="terms">Homepage of directory service</dt>
<dd class="terms"><p class="p">Opens a webbrowser with the current channels website.</p></dd>
<dt class="terms">Reload</dt>
<dd class="terms"><p class="p">Updates the current category and displays fresh station lists.</p></dd>
<dt class="terms">Update favicons...</dt>
<dd class="terms"><p class="p">Starts assembling favicons for the current list of stations in the background.
			To actually display the freshly loaded favicons, reselect the current category.</p></dd>
<dt class="terms">Reload category tree</dt>
<dd class="terms"><p class="p">Updates the genre list in the left category pane.
			For most channels the category list is already complete, but it might
			change over time. So this option is often only used for initializing streamtuner2
			channels when the list is empty.</p></dd>
</dl></div></div></div>
<p class="p">The channel menu also contains a list of available channels. Select an entry to switch
	into that tab.</p>
</div></div>
</div></div>
<div class="sect sect-links" role="navigation">

<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>CLI (command line interface)</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="glossary.html" title="Glossary">Glossary</a> » <a class="trail" href="index.html#extra" title="Additional features">Additional features</a> » </div>
<div class="trail">
<a class="trail" href="technical.html" title="Technical information">Technical information</a> » <a class="trail" href="index.html#extra" title="Additional features">Additional features</a> » </div>
</div></div>
<div class="body">
<div class="hgroup"><h1 class="title"><span class="title">CLI (command line interface)</span></h1></div>
<div class="region">
<div class="contents">
<p class="p">Streamtuner2 is a graphical tool. But it also has a limited commandline interface,
	which can be used to query station information. This is useful for interfacing with
	other applications.</p>

		the whole category. Note that the category name must have the excact case.</p></dd>
<dt class="terms"><span class="code">streamtuner2 categories channel</span></dt>
<dd class="terms"><p class="p">Fetches the current list of available categories/genres for a channel service.</p></dd>
</dl></div>
</div></div>
<p class="p">Specifying a channel name is often optional. If you add one, it should be all-lowercase.
	You can also give a list, like "shoutcast,xiph" which would be searched then.</p>
</div>
<div id="" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">GUI options</span></h2></div>
<div class="region"><div class="contents"><p class="p">There are also --gtk3 and --gtk2 command line options. Usually the right toolkit
	is picked depending on Python version. But you can manually override this.</p></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#extra" title="Additional features">Additional features</a></li></ul></div>
</div></div></div>
</div>
</div>
<div class="clear"></div>
</div>
<div class="footer"></div>
</div></body>
</html>

<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> » <a class="trail" href="configuration.html" title="Settings dialog">Settings dialog</a> › <a class="trail" href="configuration.html#apps" title="Player application settings">Player application settings</a> » </div></div></div>
<div class="body">
<div class="hgroup"><h1 class="title"><span class="title">Audio players</span></h1></div>
<div class="region">
<div class="contents">
<p class="p">On BSD/Linux systems there are a plethora of audio players. In streamtuner2 you can
	<span class="link"><a href="configuration.html" title="Settings dialog">configure</a></span> most of them as target application. Mostly it makes sense to use a single
	application for all audio formats. But at least the */* media type should be handled
	by a generic player, like vlc.</p>
<div class="table"><div class="inner"><div class="region"><table class="table">
<tr>
<td><p class="p"><span class="app">Audacious</span></p></td>
<td style="border-left-style: solid;"><p class="p"><span class="cmd">audacious %m3u</span></p></td>
<td style="border-left-style: solid;"><p class="p">audio</p></td>

<td style="border-top-style: solid;"><p class="p"><span class="app">mplayer</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">mplayer %srv</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p">console</p></td>
</tr>
<tr>
<td style="border-top-style: solid;"><p class="p"><span class="app">VLC</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">vlc %u</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p">video</p></td>
</tr>
<tr class="shade">
<td style="border-top-style: solid;"><p class="p"><span class="app">Totem</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">totem %u</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p">video</p></td>
</tr>
<tr>
<td style="border-top-style: solid;"><p class="p"><span class="app">Media Player</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">mplayer2.exe %pls</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p">Win32</p></td>
</tr>
</table></div></div></div>
<p class="p">Some audio players open a second instance when you actually want to switch radios.
	In this case it's a common workaround to write <span class="code">pkill vlc ; vlc %u</span> instead,
	which ends the previous player process and starts it anew.
        For VLC there's however also the <span class="code">--one-instance</span> option, which sometimes
        works better. (And sometimes not.)</p>
<p class="p">Some applications, like Rhythmbox or Banshee, are primarily audio browsers, not players,
        and cannot be invoked with a play URL by other apps. This makes them less suitable for use with
	streamtuner2.</p>
</div>
<div id="placeholders" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">URL placeholders</span></h2></div>
<div class="region"><div class="contents">
<p class="p">Any listed application can be invoked with a different kind of
	URL or filename.be invoked with a play URL by other apps.  Which to
	use often depends on the application.</p>
<div class="table"><div class="inner"><div class="region"><table class="table">
<thead><tr>

</table></div></div></div>
<p class="p">You sould preferrably use the long forms. Most audio players like
	%m3u most, while streamripper needs %srv for recording.</p>
</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="configuration.html#apps" title="Player application settings">Player application settings</a></li></ul></div>
</div></div>
<div class="links seealsolinks"><div class="inner">
<div class="title"><h2><span class="title">See Also</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>

<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 various options for streamtuner2, available under <span class="guiseq"><span class="gui">Edit</span> ▸ <span class="gui">Preferences</span></span> or via <span class="key"><kbd>F12</kbd></span>.
</p>
<div class="terms"><div class="inner">
<div class="title title-terms"><h2><span class="title">It's separated into three 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 audio player applications, or recording tools below.
    It's a file type to application table. Double click an entry for editing.</p></dd>
<dt class="terms">Options</dt>
<dd class="terms"><p class="p">Influences the display of all stream/station lists, and contains some system settings.</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 categorzied identifiers for file types. <span class="var">Audio/mpeg</span> for example represents MP3 files,
    and <span class="var">audio/ogg</span> means just OGG. And the player setting dialog simply associates an audio type with a
    playback application:</p>
<div class="table"><div class="inner"><div class="region"><table class="table">
<thead><tr>
<td><p class="p">Format</p></td>

<td style="border-left-style: solid;"><p class="p">Application</p></td>
</tr></thead>
<tr>
<td><p class="p"><span class="var">audio/mpeg</span></p></td>
<td style="border-left-style: solid;"><p class="p"><span class="cmd">audacious</span></p></td>
</tr>
<tr class="shade">
<td style="border-top-style: solid;"><p class="p"><span class="var">audio/ogg</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">audacious</span></p></td>
</tr>
<tr>
<td style="border-top-style: solid;"><p class="p"><span class="var">audio/*</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">vlc --one-instance</span></p></td>
</tr>
<tr class="shade">
<td style="border-top-style: solid;"><p class="p"><span class="var">video/*</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">totem</span></p></td>
</tr>
<tr>
<td style="border-top-style: solid;"><p class="p"><span class="var">video/youtube</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">vlc %srv</span></p></td>
</tr>
</table></div></div></div>
<p class="p">Application names are always lowercase binary names. Double click an entry to edit it.</p>
<p class="p">After the application name, you can use a placeholder like "<span class="var">%pls</span>" (default),
    or "<span class="var">%m3u</span>" and "<span class="var">%src</span>". See <span class="link"><a href="config_apps.html#placeholders" title="URL placeholders">placeholders</a></span>.</p>
<p class="p">Catch-all entries like <span class="var">*/*</span> or a generic <span class="var">audio/*</span> entry allow to configure a default player.
    While <span class="var">video/youtube</span> is specific to the Youtube channel. And <span class="var">url/http</span> a psdeudo MIME type
    to configure a web browser (for station homepages).</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></div></div>
</div></div>
</div></div>
<div id="recording" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Recording Apps</span></h2></div>
<div class="region"><div class="contents">
<p class="p">The second block of entries in the 'Apps' section specifies recording applications.
    Here streamripper is preconfigured for audio streams, and youtube-dl for Youtube videos for instance.</p>
<div class="table"><div class="inner"><div class="region"><table class="table">
<tr>
<td><p class="p"><span class="var">audio/*</span></p></td>
<td style="border-left-style: solid;"><p class="p"><span class="cmd">xterm -e streamripper %srv</span></p></td>
</tr>
<tr class="shade">
<td style="border-top-style: solid;"><p class="p"><span class="var">video/youtube</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">xterm -e "youtube-dl %srv"</span></p></td>
</tr>
</table></div></div></div>
<p class="p">To define a target directory, you can add commandline arguments to each. Also it's typically
    helpful to leave the xterm prefix on, so you can follow the processing state. (Alternatively to
    xterm there is x-terminal-emulator, or rxvt, gnome-terminal, xfce4-terminal, etc.)</p>
<div class="links topiclinks"><div class="inner"><div class="region"><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">
<div class="terms"><div class="inner">
<div class="title title-terms"><h3><span class="title">Display settings</span></h3></div>
<div class="region"><dl class="terms">
<dt class="terms">Display favicons</dt>
<dd class="terms"><p class="p">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></dd>
<dt class="terms">Load favicons</dt>
<dd class="terms"><p class="p">When starting to play a station, its homepage favicon is automatically retrieved in the
      background. It's not going to be displayed right away, but after you reload the category/station list.
      Alternatively use <span class="guiseq"><span class="gui">Channel</span> ▸ <span class="gui">Update favicons...</span></span> to update all
      station icons at once.</p></dd>
<dt class="terms">Show bookmark star</dt>
<dd class="terms"><p class="p">Bookmarked stations will be marked with a ★ star in all other station lists / categories.
      That doesn't often work for the same station entry from two different channel services / tabs though.</p></dd>
<dt class="terms">Gtk+ theme</dt>
<dd class="terms"><p class="p"><span class="em">Be careful</span>. While Gtk allows to select a different theme per application, not all themes
      work right away. Switching the theme might hang streamtuner2. Just restart if that happens.</p></dd>
<dt class="terms">Save window states</dt>
<dd class="terms"><p class="p">Automatically remember window size, selected channel tab, categories, or selected station.
      Also keeps the width of station list columns. If disabled, you can manually save the current
      layout/selections via <span class="guiseq"><span class="gui">Edit</span> ▸ <span class="gui">Save States</span></span>.</p></dd>
</dl></div>
</div></div>
<div class="terms"><div class="inner">
<div class="title title-terms"><h3><span class="title">Station loading</span></h3></div>
<div class="region"><dl class="terms">
<dt class="terms">Prefer HTML traversing (PyQuery) over regex</dt>
<dd class="terms"><p class="p">Some channels provide proper APIs to fetch station lists. Others are just websites, that
      require scraping listings out. Most channel tabs provide two alternative methods for that.
      The DOM/HTML selection method is sometimes more reliable. As fallback streamtuner2 plugins
      often use a regex to match text. Occassionally the regex method is actually more reliable,
      because directory services often use frightful unstructured HTML. If available, both methods
      are tried. You can influence the order with this setting.</p></dd>
<dt class="terms">[<span class="input">250</span>] Limit stream number</dt>
<dd class="terms"><p class="p"> Constraints the length of station lists per category.
      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></dd>
<dt class="terms">Retain deleted stations</dt>
<dd class="terms"><p class="p">When enabled, keeps old station entries when
      updating/reloading a category/genre.  Services often forget stations or throws them out when inavailable.
      With this option enabled, these entries are kept in streamtuner2 as strikethrough entries (often
      at the end of the list).</p></dd>
<dt class="terms">Update favouries from freshened URLs</dt>
<dd class="terms"><p class="p">Streaming URLs in bookmarked stations get renewed on category reloads/updates. This isn't
      very reliable, as often station titles change together with the streaming URLs.</p></dd>
<dt class="terms">google station homepages</dt>
<dd class="terms"><p class="p">When playing a station that doesn't have a homepage entry, streamtuner2 tries to google
      the station title. The found URL is then used/kept as station homepage. (Btw, station titles
      like www.mymusicstation.com are automatically mapped to homepage URLs already.)</p></dd>
</dl></div>
</div></div>
<div class="terms"><div class="inner">

<div class="title title-terms"><h3><span class="title">System</span></h3></div>
<div class="region"><dl class="terms">


<dt class="terms">Temporary files</dt>
<dd class="terms"><p class="p">Streamtuner2 creates temporary .m3u files - for audio players that are configured to use %m3u files
      instead of %pls or %srv URLs. For archival purposes you might want to set a dedicated directory
      for this. Leave this to the default /tmp else.</p></dd>
<dt class="terms">Config directory</dt>
<dd class="terms"><p class="p">Is where streamtuner2 keeps its <span class="file">settings.json</span> and channel caches, favicons, etc.
      You can't set this in the config dialog. This is just for display. Set the <span class="sys">XDG_CONFIG_HOME</span>
      environment variable to adapt.</p></dd>
<dt class="terms">Enable debug messages</dt>
<dd class="terms"><p class="p">If you start streamtuner2 from a terminal window (xterm/rxvt), you can get a load of state
      and processing or debug infos. Enable this only for testing, as it might slow down station
      rendering.</p></dd>
</dl></div>
</div></div>
</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">This tab lists all available channel and feature plugins. Mark checkboxes for those plugins
    you want to enable. You have to restart Streamtuner2 for any changes here to take effect.</p>
<p class="p">Each channel plugin may come with its own set of addition configuration settings

    below.</p>
<div class="note" title="Note"><div class="inner"><div class="region"><div class="contents"><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></div></div></div>
<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.com"><span class="title">Internet-Radio.com</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="surfmusik.html" title="SurfMusic"><span class="title">SurfMusic</span><span class="linkdiv-dash"> — </span><span class="desc">International radio listings.</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 class="linkdiv "><a class="linkdiv" href="youtube.html" title="Youtube"><span class="title">Youtube</span><span class="linkdiv-dash"> — </span><span class="desc">Youtube music/video listings.</span></a></div>

<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>Global_key</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="glossary.html" title="Glossary">Glossary</a> » <a class="trail" href="index.html#extra" title="Additional features">Additional features</a> » </div>
<div class="trail">
<a class="trail" href="technical.html" title="Technical information">Technical information</a> » <a class="trail" href="index.html#extra" title="Additional features">Additional features</a> » </div>
</div></div>
<div class="body">
<div class="hgroup"><h1 class="title"><span class="title">Global_key</span></h1></div>
<div class="region">
<div class="contents">
<p class="p">Using the global_key extension you can define a keyboard shortcut for switching within
	a list of favourite radio stations. Per default it uses your bookmarks list, but it can be
	configured to alternate in any other channel.</p>
<p class="p">This is useful if you don't want to keep streamtuner2 atop your
	desktop all the time, but still want to switch radios easily.</p>
<p class="p">Go into settings <span class="key"><kbd>F12</kbd></span> for plugins to define a keyboard shortcut:</p>
<div class="table"><div class="inner"><div class="region"><table class="table">
<thead><tr>
<td><p class="p">keyspec</p></td>
<td style="border-left-style: solid;"><p class="p">corresponds to</p></td>
</tr></thead>
<tr>

	it won't work. And if you choose it too generic, you won't be able to type longer
	documents. Also found out: key names are case sensitive.</p></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#extra" title="Additional features">Additional features</a></li></ul></div>
</div></div></div>
</div>
</div>
<div class="clear"></div>
</div>
<div class="footer"></div>
</div></body>
</html>

<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>Glossary</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>

<div class="body">
<div class="hgroup"><h1 class="title"><span class="title">Glossary</span></h1></div>
<div class="region">
<div class="contents">
<div class="terms"><div class="inner"><div class="region"><dl class="terms">
<dt class="terms">Channel</dt>
<dd class="terms"><p class="p">Each tab in the main window is a "channel". It represents one
   	    music directory service.</p></dd>
<dt class="terms">Stream</dt>
<dd class="terms">
<p class="p">"stream" is a technical term which means continuosly flowing
	    data.  MP3 radio music for example is streamed, because it's not
	    just a time-limited audio file, but unending (unless you stop
	    the player or paying your ISP).</p>
<p class="p">In streamtuner2 the terms "stream" and radio "station" are used interchangably.</p>
</dd>
<dt class="terms">Genre</dt>
<dd class="terms"><p class="p">Music genres are represented as "categories" in the left
	    pane.  Every channel groups its music stations into some
	    structure.</p></dd>
<dt class="terms">URL</dt>
<dd class="terms"><p class="p">URL stands for "Uniform Resource Locator"
	    and simply refers to something retrievable hyperlinks or web addresses like
	    http://www.example.org/.  Radio stations/streams are stored as URLs internally.
            The more generic hipster term "URI" (long superseded by "IRI" anyway)
            makes less sense in this context, because ISBN: or MailTo: references aren't

            overly useful for such purposes.</p></dd>
<dt class="terms">Radio</dt>
<dd class="terms"><p class="p">Plays music. Sometimes interrupted by advertisements.
   	    </p></dd>
<dt class="terms">Favicons</dt>
<dd class="terms"><p class="p">Favicons are small symbols for
	    websites.  Most website should have one.  (ST2 downloads
	    favicons either per menu command or automatically for the

            audio/mpeg, and not audio/mp3 as shown in the settings window.</p></dd>
<dt class="terms">Bitrate</dt>
<dd class="terms"><p class="p">Audio streams are compressed with exactness loss. This can be heard
	    at lower "bitrates". For MP3 files any music with less than 100 kbit/s
	    starts to hiss, while OGG Vorbis still sounds okay at a datarate of
	    e.g. 64 kbit per second. So while bitrate basically means file size per duration,
	    it's commonly used as quality indicator.</p></dd>
</dl></div></div></div>
<div class="links topiclinks"><div class="inner"><div class="region"><div class="linkdiv "><a class="linkdiv" href="index.html#extra" title="Additional features"><span class="title">Additional features</span></a></div></div></div></div>
</div>
<div id="filetypes" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Filetypes</span></h2></div>
<div class="region"><div class="contents">
<p class="p">Besides audio formats MP3 and OGG, there are also station/streaming link files.
            These are often downloaded from the directory servers, before your music player gets activated.</p>
<div class="links topiclinks"><div class="inner"><div class="region">
<div class="linkdiv "><a class="linkdiv" href="m3u.html" title=".M3U files"><span class="title">.M3U files</span><span class="linkdiv-dash"> — </span><span class="desc">MP3-URL playlist file.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="pls.html" title=".PLS files"><span class="title">.PLS files</span><span class="linkdiv-dash"> — </span><span class="desc">Playlist file format.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="json.html" title="JSON files"><span class="title">JSON files</span><span class="linkdiv-dash"> — </span><span class="desc">JavaScript Object Notation is a common data exchange format.</span></a></div>
</div></div></div>
</div></div>
</div></div>







</div>
<div class="clear"></div>
</div>
<div class="footer"></div>
</div></body>
</html>

<div class="linkdiv "><a class="linkdiv" href="saving.html" title="Saving"><span class="title">Saving</span><span class="linkdiv-dash"> — </span><span class="desc">Export a station entry as .m3u/.pls file.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="search.html" title="Searching"><span class="title">Searching</span><span class="linkdiv-dash"> — </span><span class="desc">Quicksearch field and Ctrl+F compound search window.</span></a></div>
</div>
</div></div></div></div></div>
</div></div>
<div id="configuration" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Configuration</span></h2></div>
<div class="region">
<div class="contents"><div class="links topiclinks"><div class="inner"><div class="region">
<div class="links-twocolumn"><div class="linkdiv "><a class="linkdiv" href="configuration.html" title="Settings dialog"><span class="title">Settings dialog</span><span class="linkdiv-dash"> — </span><span class="desc"><span class="key"><kbd>F12</kbd></span> brings up the options window with the Player, Display, System and Plugin sections.</span></a></div></div>
<div class="links-twocolumn"></div>
</div></div></div></div>
<div class="sect sect-links" role="navigation">
<div class="hgroup"></div>
<div class="contents"><div class="links seealsolinks"><div class="inner">
<div class="title"><h3><span class="title">See Also</span></h3></div>
<div class="region"><ul><li class="links ">
<a href="config_apps.html" title="Audio players">Audio players</a><span class="desc"> — Common applications to use as players.</span>
</li></ul></div>
</div></div></div>
</div>
</div>
</div></div>
<div id="extra" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Additional features</span></h2></div>
<div class="region">
<div class="contents"><div class="links topiclinks"><div class="inner"><div class="region">
<div class="links-twocolumn">
<div class="linkdiv "><a class="linkdiv" href="cli.html" title="CLI (command line interface)"><span class="title">CLI (command line interface)</span><span class="linkdiv-dash"> — </span><span class="desc">Console interface, exporting data.</span></a></div>

<div class="linkdiv "><a class="linkdiv" href="global_key.html" title="Global_key"><span class="title">Global_key</span><span class="linkdiv-dash"> — </span><span class="desc">Global keyboard shortcut for radio switching.</span></a></div>
</div>
<div class="links-twocolumn"><div class="linkdiv "><a class="linkdiv" href="timer.html" title="Timer"><span class="title">Timer</span><span class="linkdiv-dash"> — </span><span class="desc">Programming recurring play and recording events.</span></a></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"><h3><span class="title">More Information</span></h3></div>
<div class="region"><ul>
<li class="links ">
<a href="glossary.html" title="Glossary">Glossary</a><span class="desc"> — Technical and streamtuner2 specific terminology and jargon.</span>
</li>
<li class="links ">
<a href="technical.html" title="Technical information">Technical information</a><span class="desc"> — Filenames, Directories, Dependencies</span>

</li>
</ul></div>
</div></div></div>
</div>
</div>
</div></div>
<div id="footer" class="sect"><div class="inner">
<div class="hgroup"></div>
<div class="region"><div class="contents">
<p class="p">You can get additional help from the online forum. See <span class="guiseq"><span class="gui">Help</span> ▸ <span class="gui">Forum</span></span>.</p>
<p class="p">This documentation was last updated for available functions in streamtuner2
	version 2.1.4, as of March 2015.</p>
</div></div>
</div></div>
</div>
<div class="clear"></div>
</div>
<div class="footer"><div class="sect about ui-expander" role="contentinfo">
<div class="yelp-data yelp-data-ui-expander" data-yelp-expanded="false"></div>

<div class="hgroup"><h2 class="title"><span class="title">What else can you do?</span></h2></div>
<div class="region"><div class="contents">
<p class="p">Double clicking an entry row in the radio list starts your audio player. But there are
	other functions available. Either go to the <span class="guiseq"><span class="gui"></span> ▸ <span class="gui">Station</span></span> menu,
	or access the context menu with a right click.</p>
<div class="table"><div class="inner"><div class="region"><table class="table">
<tr>
<td><p class="p"><span class="link"><a href="playing.html" title="Playing">Play</a></span></p></td>
<td style="border-left-style: solid;"><p class="p">Starts the radio in a configured audio player</p></td>
</tr>
<tr class="shade">
<td style="border-top-style: solid;"><p class="p"><span class="link"><a href="recording.html" title="Recording">Record</a></span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p">Opens a terminal window and streamripper, which cuts the radio broadcast into individual mp3 songs.</p></td>
</tr>
<tr>
<td style="border-top-style: solid;"><p class="p"><span class="link"><a href="bookmarks.html" title="Bookmarks">Bookmarks</a></span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p">Copy radio entry over into the <span class="gui">bookmarks</span> channel.</p></td>
</tr>
<tr class="shade">
<td style="border-top-style: solid;"><p class="p">Homepage</p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p">Most radio stations have a homepage. Open this in a web browser.</p></td>
</tr>
<tr>

<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#channels" title="Channel tabs">Channel tabs</a> » </div>
</div></div>
<div class="body">
<div class="hgroup"><h1 class="title"><span class="title">Jamendo</span></h1></div>
<div class="region">
<div class="contents">
<p class="p">Jamendo is a Creative Comments licensing oriented music distributor. It hosts audio
files for individual musicians and artists. Tracks and albums can thus be downloaded
free of charge. Yeah, imagine that.</p>
<p class="p">The new Jamendo v3.0 is now utilized. It allows to list albums,
playlists, and individual tracks by genre.  The radio list is static
(they're looping over randomized songs from each genre.)</p>
<p class="p">Instead of favicons, streamtuner2 can fetch album or track
covers.  Thus the images are a bit larger, and retrieving them all
via <span class="guiseq"><span class="gui">Channel</span> ▸ <span class="gui">Load favicons...</span></span>
takes a while longer.</p>
</div>
<div id="options" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title"><span class="link"><a href="configuration.html" title="Settings dialog">Config</a></span> options</span></h2></div>
<div class="region"><div class="contents"><div class="terms"><div class="inner">
<div class="title title-terms"><h3><span class="title">System</span></h3></div>
<div class="region"><dl class="terms">
<dt class="terms">Streaming format</dt>
<dd class="terms"><p class="p">You can switch between MP3 and Ogg Vorbis audio streams for Jamendo.
     It's not honored by the radio section, but albums and tracks should be
     received as Ogg when configured so.</p></dd>
<dt class="terms">Preview image sizes</dt>
<dd class="terms"><p class="p">Album covers are downloaded in lieu of favicons. They're available
     in different sizes. Use 25px if you want just favicon-sized icons.</p></dd>
<dt class="terms">Result length</dt>
<dd class="terms">
<p class="p">Currently only 1 page (of 200 entries each) of album/track lists are
     fetched.</p>
<div class="note note-bug" title="Bug"><div class="inner"><div class="region"><div class="contents"><p class="p">Setting a higher value may not work.</p></div></div></div></div>
</dd>
</dl></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="channels.html#list" title="Available channels">Available channels</a></li>
<li class="links "><a href="index.html#channels" title="Channel tabs">Channel tabs</a></li>

<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>JSON files</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="glossary.html" title="Glossary">Glossary</a> › <a class="trail" href="glossary.html#filetypes" title="Filetypes">Filetypes</a> » </div></div></div>
<div class="body">
<div class="hgroup"><h1 class="title"><span class="title">JSON files</span></h1></div>
<div class="region">
<div class="contents">
<p class="p">JSON is a data representation format derived from Javascript (the browser embedded
        programming language for websites). Streamtuner2 uses it to store its configuration
        and radio station data files.</p>

<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>.M3U files</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="glossary.html" title="Glossary">Glossary</a> › <a class="trail" href="glossary.html#filetypes" title="Filetypes">Filetypes</a> » </div></div></div>
<div class="body">
<div class="hgroup"><h1 class="title"><span class="title">.M3U files</span></h1></div>
<div class="region">
<div class="contents">
<p class="p">M3U files also contain playlists, like .pls files. They're often used by desktop audio players.</p>
<p class="p">The MIME type of these files is audio/x-mpegurl and they often look like: </p>
<div class="code"><pre class="contents ">#M3U

<div class="list"><div class="inner"><div class="region"><ul class="list">
<li class="list"><p class="p">XMP/libxmp</p></li>
<li class="list"><p class="p">MikMod</p></li>
<li class="list"><p class="p">MODPlug for XMMS</p></li>
<li class="list"><p class="p">GModplay</p></li>
<li class="list"><p class="p">VLC (built-in support)</p></li>
</ul></div></div></div>
<div class="note" title="Note"><div class="inner"><div class="region"><div class="contents"><p class="p">See <span class="link"><a href="recording.html" title="Recording">recording
	configuration</a></span> if you want to enable the download mode. (Audio
	files are packaged up in ZIP files on MODArchive.)</p></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="channels.html#list" title="Available channels">Available channels</a></li>

<div class="body">
<div class="hgroup"><h1 class="title"><span class="title">MyOggRadio</span></h1></div>
<div class="region">
<div class="contents">
<p class="p"><span class="link"><a href="http://ehm.homelinux.org/MyOggRadio/" title="http://ehm.homelinux.org/MyOggRadio/">MyOggRadio</a></span> is an open
        source internet radio directory project. Since it provides its station list as
	JSON it's very well supported.</p>
<p class="p">To help with populating the directory further,
	streamtuner2 provides an option to share radion station links.
	Use <span class="guiseq"><span class="gui">Station</span> ▸ <span class="gui">Extensions</span> ▸ <span class="gui">Share on MyOggRadio...</span></span> menu entry to upload the currently
	selected radio (e.g. from your favourite bookmarks).</p>
<p class="p">The personal section is empty per default. You need to specify an user account
	in the settings dialog, and actually bookmark stations in the MyOggRadio web site.
	Shared entries aren't automatically in the MOR favorite list.</p>
<p class="p">There's also <span class="link"><a href="http://freshcode.club/projects/jmorp" title="http://freshcode.club/projects/jmorp">JMyOggRadioPlayer</a></span>
	as specific frontend and player for MyOggRadio.</p>
<div class="terms"><div class="inner">
<div class="title title-terms"><h2><span class="title">Channel options.</span></h2></div>
<div class="region"><dl class="terms">
<dt class="terms"><span class="code">Login settings</span></dt>
<dd class="terms"><p class="p">If you want to upload station infos to MyOggRadio, you need an account there. Registration

</div></div>
<div class="body">
<div class="hgroup"><h1 class="title"><span class="title">Playing</span></h1></div>
<div class="region">
<div class="contents">
<p class="p">Simply double click a station entry. It starts with your configured audio player.</p>
<p class="p">In streamtuner2 you can configure different audio players for different audio
        formats (MP3 or OGG). In the <span class="link"><a href="config_apps.html" title="Audio players">Apps</a></span> section of the
        <span class="link"><a href="configuration.html" title="Settings dialog">settings dialog</a></span>, you can associate one player
        with each audio file (MIME) type. Per default this is audacious, but you can use any other
        media player (like VLC).</p>
<div class="note" title="Note"><div class="inner"><div class="region"><div class="contents"><p class="p">Note however that some audio players will run multiple instance and won't
        allow simple station switching. In such situations it might be sensible to write
        a wrapper script, or configure special commandline arguments to your favoured audio
        player (e.g. "vlc --one-instance").</p></div></div></div></div>
<p class="p">It's also possible to save a station entry as .m3u or .pls file, and load this manually

<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>.PLS files</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="glossary.html" title="Glossary">Glossary</a> › <a class="trail" href="glossary.html#filetypes" title="Filetypes">Filetypes</a> » </div></div></div>
<div class="body">
<div class="hgroup"><h1 class="title"><span class="title">.PLS files</span></h1></div>
<div class="region">
<div class="contents">
<p class="p">Playlist files often have the extension .pls</p>
<p class="p">It's the primary station stream link format of SHOUTcast, and was
	popularized by WinAmp.</p>
<p class="p">The MIME type of these files is <span class="sys">audio/x-scpls</span> and they often look like: </p>
<div class="code"><pre class="contents ">[playlist]
numberofentries=1
File1=http://123.45.67.189:8222
Title1=(#1 - 555/2000) radio station Xyz - top 100 - all the hitzez
Length1=-1</pre></div>
</div>
<div class="sect sect-links" role="navigation">

<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>Recording</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#browsing" title="Browsing channels and radio stations">Browsing channels and radio stations</a> » <a class="trail" href="streams.html" title="Streams / Stations">Streams / Stations</a> › <a class="trail" href="streams.html#actions" title="Actions">Actions</a> » </div>
<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> » <a class="trail" href="configuration.html" title="Settings dialog">Settings dialog</a> › <a class="trail" href="configuration.html#recording" title="Recording Apps">Recording Apps</a> » </div>
<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#functions" title="Functions">Functions</a> » </div>
</div></div>
<div class="body">
<div class="hgroup"><h1 class="title"><span class="title">Recording</span></h1></div>
<div class="region">
<div class="contents">
<p class="p">Most stations that stream MP3 or OGG music can be recorded. This is
accomplished through the command-line tool <span class="app">streamripper</span>.  If you
select a station and press <span class="gui">● record</span>, a console
window should appear, where streamripper shows its progress.</p>
<p class="p">You can <span class="link"><a href="configuration.html" title="Settings dialog">configure the recording tool</a></span> according to audio types again.</p>

</div>
<div id="" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Streamripper</span></h2></div>
<div class="region"><div class="contents">
<p class="p">The <span class="cmd">xterm -e</span> prefix brings up the terminal popup. If you want
silent downloads in the background instead of seeing its progress, remove
the xterm call.</p>
<div class="table"><div class="inner"><div class="region"><table class="table">
<thead><tr>
<td><p class="p">Format</p></td>

<td style="border-left-style: solid;"><p class="p">Application</p></td>
</tr></thead>
<tr>
<td><p class="p"><span class="var">audio/*</span></p></td>
<td style="border-left-style: solid;"><p class="p"><span class="cmd">xterm -e streamripper %srv</span></p></td>
</tr>
</table></div></div></div>
<p class="p">To configure a default download directory, use the <span class="cmd">-d</span> option to streamripper.
For example <span class="cmd">xterm -e "streamripper -d /media/music/"</span> would use an absolute path.
Else it downloads to the current working directory (often your HOME path),
and creates one directory per radio station there.</p>
</div></div>
</div></div>
<div id="" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">fIcy/fPls</span></h2></div>
<div class="region"><div class="contents">
<p class="p">As alternative to streamripper, check out <span class="link"><a href="http://freshcode.club/projects/ficy" title="http://freshcode.club/projects/ficy">fIcy/fPls</a></span>
for recording ICEcast/SHOUTcast streaming servers.</p>
<p class="p">It can be configured with <span class="cmd">xterm -e "fPls %srv"</span> simply.</p>
</div></div>
</div></div>
<div id="" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Youtube-DL</span></h2></div>
<div class="region"><div class="contents"><p class="p">The recording settings have a specific entry for "video/youtube" URLs. To configure a specific download
directory, use <span class="cmd">xterm -e "cd /media/music ; youtube-dl %srv"</span> for example. (The <span class="cmd">cd</span>
trick works with streamripper too.)</p></div></div>
</div></div>
<div id="" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Wget for MOD files</span></h2></div>
<div class="region"><div class="contents"><p class="p">To download audio files from The MOD Archive directly, you can define a
few custom handlers.  Scroll/click on the empty row in the recording apps
table.  There create a new recording MIME type <span class="var">audio/mod+zip</span> with
a command like <span class="cmd">xterm -e wget %srv</span>.  Copy it alike for
<span class="var">audio/it+zip</span> and <span class="var">audio/xm+zip</span> to cover the most common
file types.  Using <span class="cmd">curl</span> would also work of course.  </p></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="streams.html#actions" title="Actions">Actions</a></li>
<li class="links "><a href="index.html#functions" title="Functions">Functions</a></li>
<li class="links "><a href="configuration.html#recording" title="Recording Apps">Recording Apps</a></li>
</ul></div>
</div></div></div>
</div>
</div>
<div class="clear"></div>
</div>
<div class="footer"></div>
</div></body>
</html>

<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#browsing" title="Browsing channels and radio stations">Browsing channels and radio stations</a> » <a class="trail" href="streams.html" title="Streams / Stations">Streams / Stations</a> › <a class="trail" href="streams.html#actions" title="Actions">Actions</a> » </div></div></div>
<div class="body">
<div class="hgroup"><h1 class="title"><span class="title">Reloading</span></h1></div>
<div class="region">
<div class="contents">
<p class="p">Station information can get stale. Especially Shoutcast invalidates old information
        frequently. Therefore you have to <span class="guiseq"><span class="gui"></span> ▸ <span class="gui">Reload</span></span> the lists. There is an action button below
        the menu bar for this. It retrieves the current data from the directory service.</p>
<p class="p">Favicons aren't loaded automatically. There is a menu entry in Channels for that, which
        works in the background and doesn't display the new icons automatically either. Simply
        reselect the category/genre in the left pane. Or again, use the station reload button.</p>
</div>
<div class="sect sect-links" role="navigation">
<div class="hgroup"></div>

<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#functions" title="Functions">Functions</a> » </div>
</div></div>
<div class="body">
<div class="hgroup"><h1 class="title"><span class="title">Saving</span></h1></div>
<div class="region">
<div class="contents">
<p class="p">You can export the currently selected stream using
	<span class="guiseq"><span class="gui">Station</span> ▸ <span class="gui">Save</span></span> or
	<span class="key"><kbd>F2</kbd></span>.  A file dialog opens, where you can adapt the title.
	</p>
<p class="p">The extension of the filename decides on the saved link format.  Per
	default a .m3u file is created, because that's what most audio players
	understand.</p>
<div class="note" title="Note"><div class="inner"><div class="region"><div class="contents"><p class="p"> But you can also save in <span class="file">.pls</span> or <span class="file">.xspf</span>
	or <span class="file">.asx</span> or <span class="file">.smil</span> format.  Note that the
	lower right dropdown has no effect.  You have to edit the extension
	into the filename field.</p></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="streams.html#actions" title="Actions">Actions</a></li>

	to this dialog is the text field, where you can specify the phrase
	to scan for.</p>
<p class="p">It either will search in all channels, or just the last active
        channel/service.</p>
<p class="p">Then there are two search methods.  You mostly want to use
        the live <span class="gui">Server search</span>.  It passes your search terms to
        the actual directory services, and loads the most recent data into a
        result list. This might take a few seconds. And it's not implemented
        for all channel plugins however.</p>
<p class="p">With <span class="gui">Cache find</span> would just look up entries in your
        already downloaded channel/genre lists.  This is sufficient when
        you're just looking for something previously seen/listended to.</p>

</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>

<div class="region">
<div class="contents">
<p class="p">SHOUTcast is the name of a MP3 streaming server software. It automatically collects all
	station lists on shoutcast.com.
        </p>
<div class="list"><div class="inner"><div class="region"><ul class="list">
<li class="list"><p class="p">Station entries usually provide current playing information.</p></li>
<li class="list"><p class="p">Stream links are plain <span class="link"><a href="gloassry_pls.html" title="gloassry_pls">PLS files</a></span>.</p></li>
<li class="list"><p class="p">Genres are subcategorized, so the main groups in the category
		list must be expanded to see the interesting entries.</p></li>
</ul></div></div></div>
<p class="p">Since being sold from AOL to Radionomy, the directory got cut down. There are no longer
        entries for currently played songs, and homepage links are largely gone. Hencewhy the
        Shoutcast channel is no longer considered a primary feature.</p>








</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="channels.html#list" title="Available channels">Available channels</a></li>

<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>Technical information</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>

<div class="body">
<div class="hgroup"><h1 class="title"><span class="title">Technical information</span></h1></div>
<div class="region">
<div class="contents"><div class="links topiclinks"><div class="inner"><div class="region"><div class="linkdiv "><a class="linkdiv" href="index.html#extra" title="Additional features"><span class="title">Additional features</span></a></div></div></div></div></div>
<div id="dependecies" class="sect"><div class="inner">
<div class="hgroup"></div>
<div class="region"><div class="contents">
<div class="terms"><div class="inner">
<div class="title title-terms"><h3><span class="title">Dependencies</span></h3></div>
<div class="region"><dl class="terms">
<dd class="terms"><p class="p"><span class="link">Python 2.7 or 3.x</span></p></dd>
<dd class="terms"><p class="p"><span class="link">PyGtk or PyGI</span></p></dd>
<dd class="terms"><p class="p">Gtk2 or Gtk3</p></dd>
<dd class="terms"><p class="p"><span class="link">Requests/urllib3</span></p></dd>
</dl></div>
</div></div>
<div class="terms"><div class="inner">
<div class="title title-terms"><h3><span class="title">Soft dependencies</span></h3></div>
<div class="region"><dl class="terms">
<dd class="terms"><p class="p"><span class="link">Python-LXML</span></p></dd>
<dd class="terms"><p class="p"><span class="link">Python-PyQuery</span></p></dd>
<dd class="terms"><p class="p">Python-Kronos</p></dd>
<dd class="terms"><p class="p">Audacious</p></dd>
</dl></div>
</div></div>
</div></div>
</div></div>
<div id="config_files" class="sect"><div class="inner">

<div class="region"><div class="contents">
<p class="p">The majority of code distributed with ST2 is placed into the Public Domain; meaning
        no licensing requirement and all code can be copied, modified
	and distributed unrestrictively.</p>
<p class="p">The bundled kronos.py and requests/ library are NOT however.</p>
</div></div>
</div></div>







</div>
<div class="clear"></div>
</div>
<div class="footer"></div>
</div></body>
</html>

<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>Timer</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#browsing" title="Browsing channels and radio stations">Browsing channels and radio stations</a> » <a class="trail" href="streams.html" title="Streams / Stations">Streams / Stations</a> › <a class="trail" href="streams.html#actions" title="Actions">Actions</a> » <a class="trail" href="bookmarks.html" title="Bookmarks">Bookmarks</a> › <a class="trail" href="bookmarks.html#other" title="Subcategories">Subcategories</a> » </div>
<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#browsing" title="Browsing channels and radio stations">Browsing channels and radio stations</a> » <a class="trail" href="channels.html" title="Channels">Channels</a> › <a class="trail" href="channels.html#list" title="Available channels">Available channels</a> » <a class="trail" href="bookmarks.html" title="Bookmarks">Bookmarks</a> › <a class="trail" href="bookmarks.html#other" title="Subcategories">Subcategories</a> » </div>
<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#channels" title="Channel tabs">Channel tabs</a> » <a class="trail" href="bookmarks.html" title="Bookmarks">Bookmarks</a> › <a class="trail" href="bookmarks.html#other" title="Subcategories">Subcategories</a> » </div>
<div class="trail">
<a class="trail" href="glossary.html" title="Glossary">Glossary</a> » <a class="trail" href="index.html#extra" title="Additional features">Additional features</a> » </div>
<div class="trail">
<a class="trail" href="technical.html" title="Technical information">Technical information</a> » <a class="trail" href="index.html#extra" title="Additional features">Additional features</a> » </div>
</div></div>
<div class="body">
<div class="hgroup"><h1 class="title"><span class="title">Timer</span></h1></div>
<div class="region">
<div class="contents">
<p class="p">You can programm play/recording events with the timer plugin. Simply select a station
	and choose <span class="guiseq"><span class="gui">Station</span> ▸ <span class="gui">Extensions</span> ▸ <span class="gui">Add timer...</span></span>.

</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#extra" title="Additional features">Additional features</a></li>
<li class="links "><a href="bookmarks.html#other" title="Subcategories">Subcategories</a></li>
</ul></div>
</div></div></div>
</div>
</div>
<div class="clear"></div>
</div>
<div class="footer"></div>
</div></body>
</html>

<p class="p">Xiph also uses the .xspf format, instead of .pls stream links</p>
<div class="terms"><div class="inner">
<div class="title title-terms"><h2><span class="title">Channel options.</span></h2></div>
<div class="region"><dl class="terms">
<dt class="terms"><span class="code">Filter by minimum bitrate</span></dt>
<dd class="terms"><p class="p">The bitrate of an audio stream determines the music quality. Many Xiph streams have simple
    and low quality microphone sources. To filter these out, and only leave high quality music
    stations, you can therefore change this option. OGG starts to sound well with 96 kbit/s (whereas
    MP3 often requires 148 or 192 at least).</p></dd>
</dl></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="body">
<div class="hgroup"><h1 class="title"><span class="title">Youtube</span></h1></div>
<div class="region">
<div class="contents">
<p class="p">Googles <span class="link"><a href="https://youtube.com/" title="https://youtube.com/">Youtube</a></span> provides a quirky
        JSON API that makes browsing channels and genres feasible. This beta plugin
        provides a little overview, and usually retrieves recent video uploads.</p>
<p class="p">VLC can directly play Youtube URLs. For other players one can use
        <span class="link"><a href="http://youtube-dl.org/" title="http://youtube-dl.org/">youtube-dl</a></span> as wrapper.
        For example <span class="cmd">totem $(youtube-dl %srv)</span> as configured player
        command.</p>
<p class="p">Youtube-dl is preconfigued as "recording"/download tool for this channel
        tab.</p>
<p class="p">Of course you could also just invoke a specific YT video by
        opening it in your web browser - click the station <span class="key"><kbd>home</kbd></span>
        button simply.</p>
<div class="terms"><div class="inner">
<div class="title title-terms"><h2><span class="title">Channel options.</span></h2></div>
<div class="region"><dl class="terms">
<dt class="terms"><span class="code">Region</span></dt>
<dd class="terms"><p class="p">With the country dropdown you can predefine which mostPopular listins are returned.</p></dd>
<dt class="terms"><span class="code">My Channels</span></dt>
<dd class="terms">
<p class="p">You can edit the list of YT channel names to fetch some of your favourite artists/uploaders.
    To apply this setting, and have new categories show up in the genre pane, use
    <span class="guiseq"><span class="gui">Channel</span> ▸ <span class="gui">Update category tree</span></span> first.</p>
<p class="p">It's not an exact map, but utilizes the search function to find channels.</p>
</dd>
<dt class="terms"><span class="code">Wadsworth constant</span></dt>
<dd class="terms"><p class="p">Only influences the video homepage link.</p></dd>
</dl></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>