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

⌈⌋ branch:  streamtuner2


Check-in [9d10307ec9]

Overview
Comment:Add missing pages to HTML manual version.
Downloads: Tarball | ZIP archive | SQL archive
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA1: 9d10307ec9c578037da8502dfdfe53f7bbdf283f
User & Date: mario on 2015-06-01 21:43:35
Other Links: manifest | tags
Context
2015-09-10
19:08
Fix https:// URL prefix, to avoid extraneous redirects. Add referer=1, ajax=1 to all GET/POST requests. More readable extraction (rx/pq) callback. check-in: 976c41ca3a user: mario tags: trunk
2015-06-01
21:43
Add missing pages to HTML manual version. check-in: 9d10307ec9 user: mario tags: trunk
2015-05-27
21:42
Link separate pages in feature plugin list. check-in: 2ac7d822d9 user: mario tags: trunk
Changes

Added help/html/contrib_channels.html version [f39c37c317].

            1  +<html>
            2  +<head>
            3  +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
            4  +<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
            5  +<title>→ Contrib/Extra Channels</title>
            6  +<link rel="stylesheet" type="text/css" href="C.css">
            7  +<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>
            8  +</head>
            9  +<body><div class="page" role="main">
           10  +<div class="header"><div class="trails" role="navigation">
           11  +<div class="trail">
           12  +<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#extra" title="Additional features">Additional features</a> » <a class="trail" href="pluginmanager2.html" title="Plugin Manager 2">Plugin Manager 2</a> » </div>
           13  +<div class="trail">
           14  +<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#extra" title="Additional features">Additional features</a> » <a class="trail" href="pluginmanager2.html" title="Plugin Manager 2">Plugin Manager 2</a> » <a class="trail" href="configuration.html#plugins" title="Channel and feature plugins and settings">Channel and feature plugins and settings</a> » </div>
           15  +<div class="trail">
           16  +<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> » </div>
           17  +<div class="trail">
           18  +<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>
           19  +</div></div>
           20  +<div class="body">
           21  +<div class="hgroup"><h1 class="title"><span class="title">→ Contrib/Extra Channels</span></h1></div>
           22  +<div class="region">
           23  +<div class="contents">
           24  +<p class="p">Besides the standard channels, there are a few more plugins available
           25  +for download. See the <span class="link"><a href="pluginmanager2.html" title="Plugin Manager 2">Plugin Manager</a></span>
           26  +and its <span class="key"><kbd>📦 Add</kbd></span> tab.</p>
           27  +<div class="terms"><div class="inner"><div class="region"><dl class="terms">
           28  +<dt class="terms">Reddit</dt>
           29  +<dd class="terms"><p class="p">Reddit is a social media site. Among its various sections is a large
           30  +    /r/Music subreddit group. Most of them link popular or novel Youtube
           31  +    music videos, or user-produced content etc. Radioreddit.com even provides
           32  +    streaming servers. This plugin can also list Soundcloud/Mixcloud/Bandcamp
           33  +    links. But those would require a custom audio player. There's an extra
           34  +    Soundcloud plugin however, which makes those streams readily playble.</p></dd>
           35  +<dt class="terms">Di.fm</dt>
           36  +<dd class="terms"><p class="p">"Digitally Imported" are mostly electronic music radio stations.
           37  +    The freely available stations stream with 64kbit/s AAC+ only.</p></dd>
           38  +<dt class="terms">Radio.net</dt>
           39  +<dd class="terms"><p class="p">Radio.net is a European radio directory. It nicely catalogues
           40  +    stations into genres as usual. The primary list is ordered by
           41  +    popularity even. </p></dd>
           42  +<dt class="terms">Magnatune</dt>
           43  +<dd class="terms"><p class="p">Magnatune is an independent label for artists. It makes most
           44  +    albums available for free listening with only a few intermittent
           45  +    adverts. Otherwise it's a flatrate payable music discovery and
           46  +    download service. </p></dd>
           47  +<dt class="terms">PublicRadioFan</dt>
           48  +<dd class="terms"><p class="p">PublicRadioFan.com hosts a huge lists of worldwide radio stations.
           49  +    This plugin displays just the genre list though.</p></dd>
           50  +<dt class="terms">WindowsMedia</dt>
           51  +<dd class="terms"><p class="p">Is actually a Windows-specific streaming directory. Station entries
           52  +    are converted from ASX into standard playlist formats by ST2. </p></dd>
           53  +<dt class="terms">Delicast</dt>
           54  +<dd class="terms"><p class="p">Delicast.com is another web directory of radio stations. It's
           55  +    somewhat slower because playback addresses are hidden away with extra
           56  +    page requests. Works reliably still. </p></dd>
           57  +<dt class="terms">ListenLive.eu</dt>
           58  +<dd class="terms"><p class="p">ListenLive is also an Europe-centric radio directory. </p></dd>
           59  +<dt class="terms">PunkCast</dt>
           60  +<dd class="terms"><p class="p">PunkCast is no longer maintained. It covered the NY music and tech
           61  +    scenes, but existing recordings are still accessible mostly (some are
           62  +    just weblinks howeever). This plugin is kept for nostalgic reasons;
           63  +    it was available with streamtuner1 as well. </p></dd>
           64  +<dt class="terms">GrLittleRadioPlayer</dt>
           65  +<dd class="terms"><p class="p">Great Little Radio Player is another Linux desktop radio browser.
           66  +    It comes with a default set of categorized stations. This plugin merely
           67  +    imports that list as static directory. </p></dd>
           68  +<dt class="terms">Compound</dt>
           69  +<dd class="terms"><p class="p">The compound channel is a meta plugin. It can aggregate categories
           70  +    from other channel plugins on a per-category basis. You for example
           71  +    can mash Top40 or Classic genres from Shoutcast, Xiph, InternetRadio,
           72  +    Tunein, etc. Which avoids switching between channel tabs somewhat. </p></dd>
           73  +<dt class="terms">File browser</dt>
           74  +<dd class="terms"><p class="p">You can also browser local files with streamtuner2 using the file
           75  +    browser plugin. It must be configured with your music collection path.
           76  +    It's not a default plugin, because this isn't really what Streamtuner2
           77  +    is made for. There are way better local music collection managers for
           78  +    Linux. It's just here for convenience, and displays files just as any
           79  +    other channel list. It has no specific file management features, and
           80  +    won't get any. </p></dd>
           81  +</dl></div></div></div>
           82  +</div>
           83  +<div class="sect sect-links" role="navigation">
           84  +<div class="hgroup"></div>
           85  +<div class="contents"><div class="links guidelinks"><div class="inner">
           86  +<div class="title"><h2><span class="title">More Information</span></h2></div>
           87  +<div class="region"><ul>
           88  +<li class="links "><a href="channels.html#list" title="Available channels">Available channels</a></li>
           89  +<li class="links "><a href="configuration.html#plugins" title="Channel and feature plugins and settings">Channel and feature plugins and settings</a></li>
           90  +<li class="links "><a href="index.html#channels" title="Channel tabs">Channel tabs</a></li>
           91  +<li class="links ">
           92  +<a href="pluginmanager2.html" title="Plugin Manager 2">Plugin Manager 2</a><span class="desc"> — User plugin installation</span>
           93  +</li>
           94  +</ul></div>
           95  +</div></div></div>
           96  +</div>
           97  +</div>
           98  +<div class="clear"></div>
           99  +</div>
          100  +<div class="footer"></div>
          101  +</div></body>
          102  +</html>

Added help/html/contrib_features.html version [2622f96e5c].

            1  +<html>
            2  +<head>
            3  +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
            4  +<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
            5  +<title>→ Feature plugins</title>
            6  +<link rel="stylesheet" type="text/css" href="C.css">
            7  +<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>
            8  +</head>
            9  +<body><div class="page" role="main">
           10  +<div class="header"><div class="trails" role="navigation">
           11  +<div class="trail">
           12  +<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#extra" title="Additional features">Additional features</a> » </div>
           13  +<div class="trail">
           14  +<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#extra" title="Additional features">Additional features</a> » <a class="trail" href="pluginmanager2.html" title="Plugin Manager 2">Plugin Manager 2</a> » </div>
           15  +<div class="trail">
           16  +<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#extra" title="Additional features">Additional features</a> » <a class="trail" href="pluginmanager2.html" title="Plugin Manager 2">Plugin Manager 2</a> » <a class="trail" href="configuration.html#plugins" title="Channel and feature plugins and settings">Channel and feature plugins and settings</a> » </div>
           17  +</div></div>
           18  +<div class="body">
           19  +<div class="hgroup"><h1 class="title"><span class="title">→ Feature plugins</span></h1></div>
           20  +<div class="region">
           21  +<div class="contents"><p class="p">Extra functionality and behaviour changes are available in
           22  +the <span class="key"><kbd>🔌 Feature</kbd></span> <span class="link"><a href="configuration.html" title="Settings dialog">configuration</a></span>
           23  +section.</p></div>
           24  +<div id="" class="sect"><div class="inner">
           25  +<div class="hgroup"><h2 class="title"><span class="title">Filter Bitrate</span></h2></div>
           26  +<div class="region"><div class="contents">
           27  +<p class="p">Some channels provide lower-quality audio streams. In particular
           28  +Xiph lists some awful radio stations. And this plugin helps filtering
           29  +those out of station lists.</p>
           30  +<div class="list"><div class="inner"><div class="region"><ul class="list">
           31  +<li class="list"><p class="p">MP3 streams often start to sound okay at 96kbit/s.</p></li>
           32  +<li class="list"><p class="p">Whereas OGG Vorbis or AAC are sometimes acceptable at 64kbit/s already.</p></li>
           33  +</ul></div></div></div>
           34  +<div class="note note-warning" title="Warning"><div class="inner"><div class="region"><div class="contents"><p class="p">Note that you may end up with empty channel lists
           35  +altogether if you set these options too high. Some channels provide all
           36  +their streams with 64kbit/s only.</p></div></div></div></div>
           37  +</div></div>
           38  +</div></div>
           39  +<div id="" class="sect"><div class="inner">
           40  +<div class="hgroup"><h2 class="title"><span class="title">Channel toolbar link</span></h2></div>
           41  +<div class="region"><div class="contents">
           42  +<p class="p">Adds a toolbar entry which shows the current channel/directory
           43  +service title and its homepage link. Such as:</p>
           44  +<div class="code"><pre class="contents "><span class="span">Shoutcast</span>
           45  +<span class="link"><a href="http://shoutcast.com/" title="http://shoutcast.com/">//shoutcast.com/</a></span></pre></div>
           46  +<p class="p">It depends on the "update window title" option being enabled.</p>
           47  +</div></div>
           48  +</div></div>
           49  +<div id="" class="sect"><div class="inner">
           50  +<div class="hgroup"><h2 class="title"><span class="title">Export all stations</span></h2></div>
           51  +<div class="region"><div class="contents">
           52  +<p class="p">There's an "Export All" plugin available. It adds an entry under
           53  +<span class="guiseq"><span class="gui">Main menu</span> ▸ <span class="gui">Extensions</span> ▸ <span class="gui">Export all stations</span></span>.
           54  +Which allows to export all stations from the currently visible channel category.</p>
           55  +<div class="list"><div class="inner"><div class="region"><ul class="list">
           56  +<li class="list"><p class="p">This is of course intended primarily for saving your bookmarks.</p></li>
           57  +<li class="list"><p class="p">And it allows to import radio lists into any other music player  or playlist collection/management app (such as Rhythmbox).</p></li>
           58  +<li class="list"><p class="p">You can set the desired playlist format in the file saving dialog that pops up.</p></li>
           59  +</ul></div></div></div>
           60  +</div></div>
           61  +</div></div>
           62  +<div id="" class="sect"><div class="inner">
           63  +<div class="hgroup"><h2 class="title"><span class="title">RadioTray hook</span></h2></div>
           64  +<div class="region"><div class="contents">
           65  +<p class="p">This plugin enables an extra category in the <span class="key"><kbd>bookmarks</kbd></span> tab.
           66  +It shows bookmarked stations from the RadioTray application, if that's
           67  +installed. Additionally it adds an context option to save new stations
           68  +from Streamtuner2 to RadioTray. The mapping option influences if added
           69  +radios are recategorized in RadioTray.</p>
           70  +<div class="note" title="Note"><div class="inner"><div class="region"><div class="contents"><p class="p"> Please see the Wiki for further <span class="link"><a href="http://fossil.include-once.org/streamtuner2/wiki/radiotray" title="http://fossil.include-once.org/streamtuner2/wiki/radiotray">setup instructions</a></span>.</p></div></div></div></div>
           71  +</div></div>
           72  +</div></div>
           73  +<div id="" class="sect"><div class="inner">
           74  +<div class="hgroup"><h2 class="title"><span class="title">User Agent Switcher</span></h2></div>
           75  +<div class="region"><div class="contents">
           76  +<p class="p">This plugin merely masks Streamtuner2 as an ordinary web browser when retrieving station lists.</p>
           77  +<div class="list"><div class="inner"><div class="region"><ul class="list">
           78  +<li class="list"><p class="p"> It's technically unneeded, as ST2 isn't stressful to directory websites and not blocked anywhere. </p></li>
           79  +<li class="list"><p class="p">It's only useful as additional privacy feature really, but shouldn't be used habitually. </p></li>
           80  +</ul></div></div></div>
           81  +</div></div>
           82  +</div></div>
           83  +<div id="" class="sect"><div class="inner">
           84  +<div class="hgroup"><h2 class="title"><span class="title">Downloadable contrib/ feature plugins</span></h2></div>
           85  +<div class="region"><div class="contents">
           86  +<p class="p">The <span class="link"><a href="pluginmanager2.html" title="Plugin Manager 2">Plugin Manager</a></span> lists further
           87  +feature pluginsand in the <span class="key"><kbd>📦 Add</kbd></span> tab.</p>
           88  +<div class="terms"><div class="inner"><div class="region"><dl class="terms">
           89  +<dt class="terms">Soundcloud streaming</dt>
           90  +<dd class="terms"><p class="p">Enables playback of soundcloud.com links in the Reddit plugin.
           91  +    Homepage links are transformed into direct MP3 streaming addresses
           92  +    on playback. This plugin registers a "audio/soundcloud" pseudo
           93  +    type. Alternatively you could use <span class="link"><a href="http://github.com/rekado/soundCLI" title="http://github.com/rekado/soundCLI">soundcli</a></span> of course.</p></dd>
           94  +<dt class="terms">dev_faulthandler</dt>
           95  +<dd class="terms"><p class="p">This is a pure development plugin, meant to debug ST2 crashes.</p></dd>
           96  +</dl></div></div></div>
           97  +</div></div>
           98  +</div></div>
           99  +<div class="sect sect-links" role="navigation">
          100  +<div class="hgroup"></div>
          101  +<div class="contents"><div class="links guidelinks"><div class="inner">
          102  +<div class="title"><h2><span class="title">More Information</span></h2></div>
          103  +<div class="region"><ul>
          104  +<li class="links "><a href="index.html#extra" title="Additional features">Additional features</a></li>
          105  +<li class="links "><a href="configuration.html#plugins" title="Channel and feature plugins and settings">Channel and feature plugins and settings</a></li>
          106  +<li class="links ">
          107  +<a href="pluginmanager2.html" title="Plugin Manager 2">Plugin Manager 2</a><span class="desc"> — User plugin installation</span>
          108  +</li>
          109  +</ul></div>
          110  +</div></div></div>
          111  +</div>
          112  +</div>
          113  +<div class="clear"></div>
          114  +</div>
          115  +<div class="footer"></div>
          116  +</div></body>
          117  +</html>

Added help/html/exportcat.html version [b528a7d076].

            1  +<html>
            2  +<head>
            3  +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
            4  +<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
            5  +<title>Export all stations</title>
            6  +<link rel="stylesheet" type="text/css" href="C.css">
            7  +<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>
            8  +</head>
            9  +<body><div class="page" role="main">
           10  +<div class="header"><div class="trails" role="navigation">
           11  +<div class="trail">
           12  +<a class="trail" href="glossary.html" title="Glossary">Glossary</a> » <a class="trail" href="index.html#extra" title="Additional features">Additional features</a> » </div>
           13  +<div class="trail">
           14  +<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>
           15  +</div></div>
           16  +<div class="body">
           17  +<div class="hgroup"><h1 class="title"><span class="title">Export all stations</span></h1></div>
           18  +<div class="region">
           19  +<div class="contents">
           20  +<p class="p">There's an "Export All" plugin available. It adds an entry under
           21  +	<span class="guiseq"><span class="gui">Main menu</span> ▸ <span class="gui">Extensions</span> ▸ <span class="gui">Export all stations</span></span>.
           22  +	Which allows to export all stations from the currently visible channel category.</p>
           23  +<p class="p">This is of course intended primarily for saving your bookmarks.
           24  +	And it allows to import radio lists into any other music player
           25  +	or playlist collection/management app (such as Rhythmbox).</p>
           26  +</div>
           27  +<div id="configuration" class="sect"><div class="inner">
           28  +<div class="hgroup"><h2 class="title"><span class="title">Configuration option</span></h2></div>
           29  +<div class="region"><div class="contents">
           30  +<p class="p">You can set the default export format in the settings dialog
           31  +	<span class="key"><kbd>F12</kbd></span>.</p>
           32  +<p class="p">It supports all common export formats now, with .PLS being the
           33  +	default.</p>
           34  +</div></div>
           35  +</div></div>
           36  +<div class="sect sect-links" role="navigation">
           37  +<div class="hgroup"></div>
           38  +<div class="contents"><div class="links guidelinks"><div class="inner">
           39  +<div class="title"><h2><span class="title">More Information</span></h2></div>
           40  +<div class="region"><ul><li class="links "><a href="index.html#extra" title="Additional features">Additional features</a></li></ul></div>
           41  +</div></div></div>
           42  +</div>
           43  +</div>
           44  +<div class="clear"></div>
           45  +</div>
           46  +<div class="footer"></div>
           47  +</div></body>
           48  +</html>