<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>Station favicons</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#extra" title="Additional features">Additional features</a> » </div></div></div>
<div class="body">
<div class="hgroup"><h1 class="title"><span class="title">Station favicons</span></h1></div>
<div class="region">
<div class="contents">
<p class="p">Per default you'll get a small logo / icon for any station
with a homepage link. They're automatically fetched and displayed
as soon as you play a radio entry.</p>
<div class="list"><div class="inner"><div class="region"><ul class="list">
<li class="list"><p class="p">This functionality meanwhile resides in a plugin.</p></li>
<li class="list"><p class="p">It's available in the <span class="key"><kbd>🔌 Features</kbd></span> <span class="link"><a href="configuration.html" title="Configuration / Settings dialog">configuration</a></span> tab.</p></li>
<li class="list"><p class="p">Most configuration options are now collected there.</p></li>
</ul></div></div></div>
<p class="p">Some channels (Jamendo or Radionomy) provide small album previews
or banners even. Whereas normal favicons are just 16x16 pixel images.</p>
<div class="note" title="Note"><div class="inner"><div class="region"><div class="contents"><p class="p">Downloaded image files are meanwhile all sanitized (internally
converted to ensure they're really image files).
Albeit that's not strictly necessary for modern Gtk versions. (But
better safe than sorry).
Images are kept in the <span class="file">~/.config/streamtuner2/icons</span> directory.
</p></div></div></div></div>
</div>
<div id="configuration" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Configuration options</span></h2></div>
<div class="region"><div class="contents"><div class="terms"><div class="inner"><div class="region"><dl class="terms">
<dt class="terms">Load favicons on playing</dt>
<dd class="terms"><p class="p">When starting to play a station, its homepage favicon is automatically downloaded
    in the background. It's even displayed right away as soon as it's there. You can
    also have a whole category/genre list updated right away per menu command
    <span class="guiseq"><span class="gui">Channel</span> ▸ <span class="gui">Update favicons...</span></span>.</p></dd>
<dt class="terms">Homepage googling</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.
    This isn't super exact however, so you might end up with homepages and icons
    from Wikipedia, Twitter, Facebook or something for generic radio station names.
    (Btw, station titles like www.mymusicstation.com are automatically mapped to
    homepage URLs already.)</p></dd>
<dt class="terms">Use Google favicon service</dt>
<dd class="terms"><p class="p">Downloading favicons directly from station homepages can sometimes be
    a little slow. Which is because it requires to inspect the homepage
    itself first, and then uncovering an image resource. The Google method
    instead uses <span class="cmd">http://www.google.com/s2/favicons?domain=www.example.com</span>
    to fetch a PNG icon right away. Which is often faster. You might want to
    disable this for privacy reasons though.</p></dd>
<dt class="terms">Omit placeholders</dt>
<dd class="terms"><p class="p">Oftentimes the Google favicon service sends back a placeholder icon
    (a blue mini globe), which doesn't look very interesting. So you might
    want to disable those. (They're still downloaded, but just not saved in
    the cache directory.)</p></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="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>
