Index: channels/search.py
==================================================================
--- channels/search.py
+++ channels/search.py
@@ -1,21 +1,23 @@
+# encoding: utf-8
 # api: streamtuner2
 # title: Search feature
 # description: Provides the quick search box, and server/cache search window.
 # version: 0.9
 # type: feature
 # category: ui
 # config: -
 # priority: core
-# 
-# Configuration dialog for audio applications,
-# general settings, and plugin activation and
-# associated options.
-#
-# Some plugins hook into the saving method. Most
-# require a restart of streamtuner2 for changes
-# to take effect.
+#
+# The search dialog implementes a "cache" and a live
+# "server" search (only some plugins). It scans through
+# all available, or just the last active channel tab.
+# Found entries are displayed in „bookmarks›search“.
+#
+# With the little search box atop the main window, you
+# can alternatively highlight entries in the currently
+# selected category.
 
 
 from uikit import *
 import channels
 from config import *

Index: channels/shoutcast.py
==================================================================
--- channels/shoutcast.py
+++ channels/shoutcast.py
@@ -15,14 +15,16 @@
 #   f46cLIKu61yJXufr5VO0voyzEZ/k8sI4s9ns0RFarRZjL56inIshekWGenYS6IzhR9PCntRBIBCw8XsiFItFNLMxPJgfwVjDi4Y8g2b9DILaMKZGd2Ca5tEGiqJg2xjF200H6J+AvKtjeG8T3998xW5nAk6n08bviSBJEqhewLlpN4bMHfwxfuH5J8J98SGerS/B4XDY
 #   d+FwQ6rVKm8vXeP++6vku2lu3FEZubFIXdc5qNm2x93ILZobszRfaYwuaIzH4wOFfafwt7CFb59/Y0uYx8rLR1BVtXd1u2AzCMwsQg6cx+O5uWOFBxAGnfNJ8Q/z/DNTtgbnsgAAAABJRU5ErkJggg==
 # depends: re, ahttp
 #
 # Shoutcast is a server software for audio streaming. It automatically spools
-# station information on shoutcast.com
+# station information on shoutcast.com, which today lists over 60000 radios.
 #
-# It has been aquired by Radionomy in 2014, since then significant changes
-# took place. The former yellow pages API got deprecated.
+# It has been aquired by Radionomy in 2014. Since then significant changes
+# took place. The former yellow pages API got deprecated. Streamtuner2 now
+# utilizes the AJAX interface for speedy playlist discovery
+#
 
 
 import ahttp
 from json import loads as json_decode
 import re

Index: channels/useragentswitcher.py
==================================================================
--- channels/useragentswitcher.py
+++ channels/useragentswitcher.py
@@ -8,16 +8,20 @@
 # priority: rare
 # config:
 #   { type=select, name=useragent, value=Streamtuner2, select="Streamtuner2|VLC|Firefox|Chrome|Android|MSIE|iTunes", description=Which browser string to use for HTTP requests. }
 # hooks: config_save
 #
-# This is currently unneeded.
+# This is currently unneeded / only for privacy.
+# Allows to masquerade streamtuner2 as different
+# audio player or just as web browser for station
+# or playlist fetching.
 
 
 from config import *
 from channels import *
 import ahttp
+
 
 # override ahttp.session headers, hooks into config dialog
 class useragentswitcher():
 
     module = "useragentswitcher"