<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="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">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>
<p class="p">This functionality meanwhile resides in a plugin. It's available in the
<span class="key"><kbd>🔌 Features</kbd></span> <span class="link"><a href="configuration.html" title="Settings dialog">configuration</a></span> tab.
You can disable it as whole if unneeded. Most configuration options are now
collected there.</p>
<p class="p">Some channels (Jamendo or Radionomy) provide small album previews
or banners (Punkcast) even. Whereas normal favicons are just 16x16
pixel images.</p>
<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 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>