Index: PKG-INFO ================================================================== --- PKG-INFO +++ PKG-INFO @@ -1,10 +1,10 @@ Metadata-Version: 1.0 Name: streamtuner2 -Version: 2.0.9 +Version: 2.1.0 Summary: Streamtuner2 is an internet radio browser -Home-page: http://sourceforge.net/projects/streamtuner2/ +Home-page: http://fossil.include-once.org/streamtuner2/ Author: Mario Salzer Author-email: xmilky+st2@gmail.... License: Public Domain Description: Streamtuner2 lists radio directory services like Shoutcast, Xiph, Live365, MyOggRadio, Jamendo. It allows listening via any audio player, and recording of streams via streamripper. Platform: ALL Index: _package.epm ================================================================== --- _package.epm +++ _package.epm @@ -31,19 +31,19 @@ d 755 root root /usr/share/streamtuner2 - f 644 root root /usr/share/streamtuner2/streamtuner2.png ./streamtuner2.png f 644 root root /usr/share/pixmaps/streamtuner2.png ./logo.png f 644 root root /usr/share/streamtuner2/gtk2.xml ./gtk2.xml f 644 root root /usr/share/streamtuner2/gtk3.xml ./gtk3.xml -f 644 root root /usr/share/streamtuner2/pson.py ./pson.py +#f 644 root root /usr/share/streamtuner2/pson.py ./pson.py #f 644 root root /usr/share/streamtuner2/processing.py ./processing.py f 644 root root /usr/share/streamtuner2/action.py ./action.py f 644 root root /usr/share/streamtuner2/config.py ./config.py -f 644 root root /usr/share/streamtuner2/http.py ./http.py +f 644 root root /usr/share/streamtuner2/ahttp.py ./ahttp.py f 644 root root /usr/share/streamtuner2/cli.py ./cli.py f 644 root root /usr/share/streamtuner2/mygtk.py ./mygtk.py f 644 root root /usr/share/streamtuner2/favicon.py ./favicon.py -f 644 root root /usr/share/streamtuner2/kronos.py ./kronos.py +f 644 root root /usr/share/streamtuner2/bundle/kronos.py ./bundle/kronos.py f 644 root root /usr/share/streamtuner2/pq.py ./pq.py #-- channels d 755 root root /usr/share/streamtuner2/channels - f 644 root root /usr/share/streamtuner2/channels/__init__.py ./channels/__init__.py f 644 root root /usr/share/streamtuner2/channels/_generic.py ./channels/_generic.py Index: action.py ================================================================== --- action.py +++ action.py @@ -21,11 +21,11 @@ # import re import os -import http +import ahttp as http from config import conf, __print__, dbg import platform main = None @@ -45,22 +45,22 @@ # web @staticmethod def browser(url): - __print__( conf.browser ) + __print__( dbg.CONF, conf.browser ) action.run(conf.browser + " " + action.quote(url)) # os shell cmd escaping @staticmethod def quote(s): if conf.windows: - return s # should actually be "\\\"%s\\\"" % s + return str(s) # should actually be "\\\"%s\\\"" % s else: - return "%r" % s + return "%r" % str(s) # calls player for stream url and format @staticmethod def play(url, audioformat="audio/mp3", listformat="text/x-href"): @@ -68,11 +68,11 @@ url = action.url(url, listformat) if (audioformat): if audioformat == "audio/mpeg": audioformat = "audio/mp3" # internally we use the more user-friendly moniker cmd = conf.play.get(audioformat, conf.play.get("*/*", "vlc %u")) - __print__( "play", url, cmd ) + __print__( dbg.PROC,"play", url, cmd ) try: action.run( action.interpol(cmd, url) ) except: pass @@ -79,19 +79,19 @@ # exec wrapper @staticmethod def run(cmd): if conf.windows: - os.system("start \"%s\"") - else: + os.system("start \"%s\"") + else: os.system(cmd + " &") # streamripper @staticmethod def record(url, audioformat="audio/mp3", listformat="text/x-href", append="", row={}): - __print__( "record", url ) + __print__( dbg.PROC, "record", url ) cmd = conf.record.get(audioformat, conf.record.get("*/*", None)) try: action.run( action.interpol(cmd, url, row) + append ) except: pass @@ -189,11 +189,11 @@ # download a .pls resource and extract urls @staticmethod def pls(url): text = http.get(url) - __print__( "pls_text=", text ) + __print__( dbg.DATA, "pls_text=", text ) return re.findall("\s*File\d*\s*=\s*(\w+://[^\s]+)", text, re.I) # currently misses out on the titles # get a single direct ICY stream url (extract either from PLS or M3U) @staticmethod @@ -224,11 +224,11 @@ stream_id = stream_id and stream_id.group(1) or "XXXXXX" try: channelname = main.current_channel except: channelname = "unknown" - return (conf.tmp + os.sep + "streamtuner2."+channelname+"."+stream_id+".m3u", len(stream_id) > 3 and stream_id != "XXXXXX") + return (str(conf.tmp) + os.sep + "streamtuner2."+channelname+"."+stream_id+".m3u", len(stream_id) > 3 and stream_id != "XXXXXX") # check if there are any urls in a given file @staticmethod def has_urls(tmp_fn): if os.path.exists(tmp_fn): @@ -244,13 +244,13 @@ # does it already exist? if tmp_fn and unique and conf.reuse_m3u and action.has_urls(tmp_fn): return tmp_fn # download PLS - __print__( "pls=",pls ) + __print__( dbg.DATA, "pls=",pls ) url_list = action.extract_urls(pls) - __print__( "urls=", url_list ) + __print__( dbg.DATA, "urls=", url_list ) # output URL list to temporary .m3u file if (len(url_list)): #tmp_fn = f = open(tmp_fn, "w") @@ -258,11 +258,11 @@ f.write("\n".join(url_list) + "\n") f.close() # return path/name of temporary file return tmp_fn else: - __print__( "error, there were no URLs in ", pls ) + __print__( dbg.ERR, "error, there were no URLs in ", pls ) raise "Empty PLS" # open help browser @staticmethod def help(*args): ADDED ahttp.py Index: ahttp.py ================================================================== --- ahttp.py +++ ahttp.py @@ -0,0 +1,213 @@ +# +# encoding: UTF-8 +# api: streamtuner2 +# type: functions +# title: http download / methods +# description: http utility +# version: 1.4 +# +# Provides a http GET method with gtk.statusbar() callback. +# And a function to add trailings slashes on http URLs. +# +# + + +from compat2and3 import urllib2, urlencode, urlparse, cookielib, StringIO, xrange, PY3 +from gzip import GzipFile +from config import conf, __print__, dbg + + +#-- url download --------------------------------------------- + + + +#-- chains to progress meter and status bar in main window +feedback = None + +# sets either text or percentage, so may take two parameters +def progress_feedback(*args): + + # use reset values if none given + if not args: + args = ["", 1.0] + + # send to main win + if feedback: + try: [feedback(d) for d in args] + except: pass + + + + +#-- GET +def get(url, maxsize=1<<19, feedback="old"): + __print__( dbg.HTTP, "GET", url) + + # statusbar info + progress_feedback(url, 0.0) + + # read + content = "" + f = urllib2.urlopen(url) + max = 222000 # mostly it's 200K, but we don't get any real information + read_size = 1 + + # multiple steps + while (read_size and len(content) < maxsize): + + # partial read + add = f.read(8192) + content = content + add + read_size = len(add) + + # set progress meter + progress_feedback(float(len(content)) / float(max)) + + # done + + # clean statusbar + progress_feedback() + + # fin + __print__( dbg.INFO, "Content-Length", len(content) ) + return content + + + + + +#-- fix invalid URLs +def fix_url(url): + if url is None: + url = "" + if len(url): + # remove whitespace + url = url.strip() + # add scheme + if (url.find("://") < 0): + url = "http://" + url + # add mandatory path + if (url.find("/", 10) < 0): + url = url + "/" + return url + + + + +# default HTTP headers for AJAX/POST request +default_headers = { + "User-Agent": "streamtuner2/2.1 (X11; U; Linux AMD64; en; rv:1.5.0.1) like WinAmp/2.1 but not like Googlebot/2.1", #"Mozilla/5.0 (X11; U; Linux x86_64; de; rv:1.9.2.6) Gecko/20100628 Ubuntu/10.04 (lucid) Firefox/3.6.6", + "Accept": "*/*;q=0.5, audio/*, url/*", + "Accept-Language": "en-US,en,de,es,fr,it,*;q=0.1", + "Accept-Encoding": "gzip,deflate", + "Accept-Charset": "ISO-8859-1,utf-8;q=0.7,*;q=0.1", + "Keep-Alive": "115", + "Connection": "keep-alive", + #"Content-Length", "56", + #"Cookie": "s_pers=%20s_getnr%3D1278607170446-Repeat%7C1341679170446%3B%20s_nrgvo%3DRepeat%7C1341679170447%3B; s_sess=%20s_cc%3Dtrue%3B%20s_sq%3Daolshtcst%252Caolsvc%253D%252526pid%25253Dsht%25252520%2525253A%25252520SHOUTcast%25252520Radio%25252520%2525257C%25252520Search%25252520Results%252526pidt%25253D1%252526oid%25253Dfunctiononclick%25252528event%25252529%2525257BshowMoreGenre%25252528%25252529%2525253B%2525257D%252526oidt%25253D2%252526ot%25253DDIV%3B; aolDemoChecked=1.849061", + "Pragma": "no-cache", + "Cache-Control": "no-cache", +} + + + +# simulate ajax calls +def ajax(url, post, referer=""): + + # request + headers = default_headers + headers.update({ + "Content-Type": "application/x-www-form-urlencoded; charset=UTF-8", + "X-Requested-With": "XMLHttpRequest", + "Referer": (referer if referer else url), + }) + if type(post) == dict: + post = urlencode(post) + request = urllib2.Request(url, post, headers) + + # open url + __print__( dbg.INFO, vars(request) ) + progress_feedback(url, 0.2) + r = urllib2.urlopen(request) + + # get data + __print__( dbg.HTTP, r.info() ) + progress_feedback(0.5) + data = r.read() + progress_feedback() + return data + + + +# http://techknack.net/python-urllib2-handlers/ +class ContentEncodingProcessor(urllib2.BaseHandler): + """A handler to add gzip capabilities to urllib2 requests """ + + # add headers to requests + def http_request(self, req): + req.add_header("Accept-Encoding", "gzip, deflate") + return req + + # decode + def http_response(self, req, resp): + old_resp = resp + # gzip + if resp.headers.get("content-encoding") == "gzip": + gz = GzipFile( + fileobj=StringIO(resp.read()), + mode="r" + ) + resp = urllib2.addinfourl(gz, old_resp.headers, old_resp.url, old_resp.code) + resp.msg = old_resp.msg + # deflate + if resp.headers.get("content-encoding") == "deflate": + gz = StringIO( deflate(resp.read()) ) + resp = urllib2.addinfourl(gz, old_resp.headers, old_resp.url, old_resp.code) # 'class to add info() and geturl() methods to an open file.' + resp.msg = old_resp.msg + return resp + +# deflate support +import zlib +def deflate(data): # zlib only provides the zlib compress format, not the deflate format; + try: # so on top of all there's this workaround: + return zlib.decompress(data, -zlib.MAX_WBITS) + except zlib.error: + return zlib.decompress(data) + + + + + + + +#-- init for later use +if urllib2: + + # config 1 + handlers = [None, None, None] + + # base + handlers[0] = urllib2.HTTPHandler() + if conf.debug: + handlers[0].set_http_debuglevel(3) + + # content-encoding + handlers[1] = ContentEncodingProcessor() + + # store cookies at runtime + cj = cookielib.CookieJar() + handlers[2] = urllib2.HTTPCookieProcessor( cj ) + + # inject into urllib2 + urllib2.install_opener( urllib2.build_opener(*handlers) ) + + + + +# alternative function names +AJAX=ajax +POST=ajax +GET=get +URL=fix_url + + ADDED bundle/kronos.py Index: bundle/kronos.py ================================================================== --- bundle/kronos.py +++ bundle/kronos.py @@ -0,0 +1,578 @@ +"""Module that provides a cron-like task scheduler. + +This task scheduler is designed to be used from inside your own program. +You can schedule Python functions to be called at specific intervals or +days. It uses the standard 'sched' module for the actual task scheduling, +but provides much more: + +* repeated tasks (at intervals, or on specific days) +* error handling (exceptions in tasks don't kill the scheduler) +* optional to run scheduler in its own thread or separate process +* optional to run a task in its own thread or separate process + +If the threading module is available, you can use the various Threaded +variants of the scheduler and associated tasks. If threading is not +available, you could still use the forked variants. If fork is also +not available, all processing is done in a single process, sequentially. + +There are three Scheduler classes: + + Scheduler ThreadedScheduler ForkedScheduler + +You usually add new tasks to a scheduler using the add_interval_task or +add_daytime_task methods, with the appropriate processmethod argument +to select sequential, threaded or forked processing. NOTE: it is impossible +to add new tasks to a ForkedScheduler, after the scheduler has been started! +For more control you can use one of the following Task classes +and use schedule_task or schedule_task_abs: + + IntervalTask ThreadedIntervalTask ForkedIntervalTask + SingleTask ThreadedSingleTask ForkedSingleTask + WeekdayTask ThreadedWeekdayTask ForkedWeekdayTask + MonthdayTask ThreadedMonthdayTask ForkedMonthdayTask + +Kronos is the Greek God of Time. + +Kronos scheduler (c) Irmen de Jong. +This version has been extracted from the Turbogears source repository +and slightly changed to be completely stand-alone again. Also some fixes +have been made to make it work on Python 2.6 (sched module changes). +The version in Turbogears is based on the original stand-alone Kronos. +This is open-source software, released under the MIT Software License: +http://www.opensource.org/licenses/mit-license.php + +""" + +__version__="2.0" + +__all__ = [ + "DayTaskRescheduler", + "ForkedIntervalTask", + "ForkedMonthdayTask", + "ForkedScheduler", + "ForkedSingleTask", + "ForkedTaskMixin", + "ForkedWeekdayTask", + "IntervalTask", + "MonthdayTask", + "Scheduler", + "SingleTask", + "Task", + "ThreadedIntervalTask", + "ThreadedMonthdayTask", + "ThreadedScheduler", + "ThreadedSingleTask", + "ThreadedTaskMixin", + "ThreadedWeekdayTask", + "WeekdayTask", + "add_interval_task", + "add_monthday_task", + "add_single_task", + "add_weekday_task", + "cancel", + "method", +] + +import os +import sys +import sched +import time +import traceback +import weakref + +class method: + sequential="sequential" + forked="forked" + threaded="threaded" + +class Scheduler: + """The Scheduler itself.""" + + def __init__(self): + self.running=True + self.sched = sched.scheduler(time.time, self.__delayfunc) + + def __delayfunc(self, delay): + # This delay function is basically a time.sleep() that is + # divided up, so that we can check the self.running flag while delaying. + # there is an additional check in here to ensure that the top item of + # the queue hasn't changed + if delay<10: + time.sleep(delay) + else: + toptime = self._getqueuetoptime() + endtime = time.time() + delay + period = 5 + stoptime = endtime - period + while self.running and stoptime > time.time() and \ + self._getqueuetoptime() == toptime: + time.sleep(period) + if not self.running or self._getqueuetoptime() != toptime: + return + now = time.time() + if endtime > now: + time.sleep(endtime - now) + + def _acquire_lock(self): + pass + + def _release_lock(self): + pass + + def add_interval_task(self, action, taskname, initialdelay, interval, + processmethod, args, kw): + """Add a new Interval Task to the schedule. + + A very short initialdelay or one of zero cannot be honored, you will + see a slight delay before the task is first executed. This is because + the scheduler needs to pick it up in its loop. + + """ + if initialdelay < 0 or interval < 1: + raise ValueError("Delay or interval must be >0") + # Select the correct IntervalTask class. Not all types may be available! + if processmethod == method.sequential: + TaskClass = IntervalTask + elif processmethod == method.threaded: + TaskClass = ThreadedIntervalTask + elif processmethod == method.forked: + TaskClass = ForkedIntervalTask + else: + raise ValueError("Invalid processmethod") + if not args: + args = [] + if not kw: + kw = {} + task = TaskClass(taskname, interval, action, args, kw) + self.schedule_task(task, initialdelay) + return task + + def add_single_task(self, action, taskname, initialdelay, processmethod, + args, kw): + """Add a new task to the scheduler that will only be executed once.""" + if initialdelay < 0: + raise ValueError("Delay must be >0") + # Select the correct SingleTask class. Not all types may be available! + if processmethod == method.sequential: + TaskClass = SingleTask + elif processmethod == method.threaded: + TaskClass = ThreadedSingleTask + elif processmethod == method.forked: + TaskClass = ForkedSingleTask + else: + raise ValueError("Invalid processmethod") + if not args: + args = [] + if not kw: + kw = {} + task = TaskClass(taskname, action, args, kw) + self.schedule_task(task, initialdelay) + return task + + def add_daytime_task(self, action, taskname, weekdays, monthdays, timeonday, + processmethod, args, kw): + """Add a new Day Task (Weekday or Monthday) to the schedule.""" + if weekdays and monthdays: + raise ValueError("You can only specify weekdays or monthdays, " + "not both") + if not args: + args = [] + if not kw: + kw = {} + if weekdays: + # Select the correct WeekdayTask class. + # Not all types may be available! + if processmethod == method.sequential: + TaskClass = WeekdayTask + elif processmethod == method.threaded: + TaskClass = ThreadedWeekdayTask + elif processmethod == method.forked: + TaskClass = ForkedWeekdayTask + else: + raise ValueError("Invalid processmethod") + task=TaskClass(taskname, weekdays, timeonday, action, args, kw) + if monthdays: + # Select the correct MonthdayTask class. + # Not all types may be available! + if processmethod == method.sequential: + TaskClass = MonthdayTask + elif processmethod == method.threaded: + TaskClass = ThreadedMonthdayTask + elif processmethod == method.forked: + TaskClass = ForkedMonthdayTask + else: + raise ValueError("Invalid processmethod") + task=TaskClass(taskname, monthdays, timeonday, action, args, kw) + firsttime=task.get_schedule_time(True) + self.schedule_task_abs(task, firsttime) + return task + + def schedule_task(self, task, delay): + """Add a new task to the scheduler with the given delay (seconds). + + Low-level method for internal use. + + """ + if self.running: + # lock the sched queue, if needed + self._acquire_lock() + try: + task.event = self.sched.enter(delay, 0, task, + (weakref.ref(self),) ) + finally: + self._release_lock() + else: + task.event = self.sched.enter(delay, 0, task, + (weakref.ref(self),) ) + + def schedule_task_abs(self, task, abstime): + """Add a new task to the scheduler for the given absolute time value. + + Low-level method for internal use. + + """ + if self.running: + # lock the sched queue, if needed + self._acquire_lock() + try: + task.event = self.sched.enterabs(abstime, 0, task, + (weakref.ref(self),) ) + finally: + self._release_lock() + else: + task.event = self.sched.enterabs(abstime, 0, task, + (weakref.ref(self),) ) + + def start(self): + """Start the scheduler.""" + self._run() + + def stop(self): + """Remove all pending tasks and stop the Scheduler.""" + self.running = False + self._clearschedqueue() + + def cancel(self, task): + """Cancel given scheduled task.""" + self.sched.cancel(task.event) + + if sys.version_info>=(2,6): + # code for sched module of python 2.6+ + def _getqueuetoptime(self): + return self.sched._queue[0].time + def _clearschedqueue(self): + self.sched._queue[:] = [] + else: + # code for sched module of python 2.5 and older + def _getqueuetoptime(self): + return self.sched.queue[0][0] + def _clearschedqueue(self): + self.sched.queue[:] = [] + + def _run(self): + # Low-level run method to do the actual scheduling loop. + while self.running: + try: + self.sched.run() + except Exception as x: + print >>sys.stderr, "ERROR DURING SCHEDULER EXECUTION",x + print >>sys.stderr, "".join( + traceback.format_exception(*sys.exc_info())) + print >>sys.stderr, "-" * 20 + # queue is empty; sleep a short while before checking again + if self.running: + time.sleep(5) + + +class Task: + """Abstract base class of all scheduler tasks""" + + def __init__(self, name, action, args, kw): + """This is an abstract class!""" + self.name=name + self.action=action + self.args=args + self.kw=kw + + def __call__(self, schedulerref): + """Execute the task action in the scheduler's thread.""" + try: + self.execute() + except Exception as x: + self.handle_exception(x) + self.reschedule(schedulerref()) + + def reschedule(self, scheduler): + """This method should be defined in one of the sub classes!""" + raise NotImplementedError("You're using the abstract base class 'Task'," + " use a concrete class instead") + + def execute(self): + """Execute the actual task.""" + self.action(*self.args, **self.kw) + + def handle_exception(self, exc): + """Handle any exception that occured during task execution.""" + print >>sys.stderr, "ERROR DURING TASK EXECUTION", exc + print >>sys.stderr, "".join(traceback.format_exception(*sys.exc_info())) + print >>sys.stderr, "-" * 20 + + +class SingleTask(Task): + """A task that only runs once.""" + + def reschedule(self, scheduler): + pass + + +class IntervalTask(Task): + """A repeated task that occurs at certain intervals (in seconds).""" + + def __init__(self, name, interval, action, args=None, kw=None): + Task.__init__(self, name, action, args, kw) + self.interval = interval + + def reschedule(self, scheduler): + """Reschedule this task according to its interval (in seconds).""" + scheduler.schedule_task(self, self.interval) + + +class DayTaskRescheduler: + """A mixin class that contains the reschedule logic for the DayTasks.""" + + def __init__(self, timeonday): + self.timeonday = timeonday + + def get_schedule_time(self, today): + """Calculate the time value at which this task is to be scheduled.""" + now = list(time.localtime()) + if today: + # schedule for today. let's see if that is still possible + if (now[3], now[4]) >= self.timeonday: + # too bad, it will be tomorrow + now[2] += 1 + else: + # tomorrow + now[2] += 1 + # set new time on day (hour,minute) + now[3], now[4] = self.timeonday + # seconds + now[5] = 0 + return time.mktime(now) + + def reschedule(self, scheduler): + """Reschedule this task according to the daytime for the task. + + The task is scheduled for tomorrow, for the given daytime. + + """ + # (The execute method in the concrete Task classes will check + # if the current day is a day on which the task must run). + abstime = self.get_schedule_time(False) + scheduler.schedule_task_abs(self, abstime) + + +class WeekdayTask(DayTaskRescheduler, Task): + """A task that is called at specific days in a week (1-7), at a fixed time + on the day. + + """ + + def __init__(self, name, weekdays, timeonday, action, args=None, kw=None): + if type(timeonday) not in (list, tuple) or len(timeonday) != 2: + raise TypeError("timeonday must be a 2-tuple (hour,minute)") + if type(weekdays) not in (list, tuple): + raise TypeError("weekdays must be a sequence of weekday numbers " + "1-7 (1 is Monday)") + DayTaskRescheduler.__init__(self, timeonday) + Task.__init__(self, name, action, args, kw) + self.days = weekdays + + def execute(self): + # This is called every day, at the correct time. We only need to + # check if we should run this task today (this day of the week). + weekday = time.localtime().tm_wday + 1 + if weekday in self.days: + self.action(*self.args, **self.kw) + + +class MonthdayTask(DayTaskRescheduler, Task): + """A task that is called at specific days in a month (1-31), at a fixed + time on the day. + + """ + + def __init__(self, name, monthdays, timeonday, action, args=None, kw=None): + if type(timeonday) not in (list, tuple) or len(timeonday) != 2: + raise TypeError("timeonday must be a 2-tuple (hour,minute)") + if type(monthdays) not in (list, tuple): + raise TypeError("monthdays must be a sequence of monthdays numbers " + "1-31") + DayTaskRescheduler.__init__(self, timeonday) + Task.__init__(self, name, action, args, kw) + self.days = monthdays + + def execute(self): + # This is called every day, at the correct time. We only need to + # check if we should run this task today (this day of the month). + if time.localtime().tm_mday in self.days: + self.action(*self.args, **self.kw) + + +try: + import threading + + class ThreadedScheduler(Scheduler): + """A Scheduler that runs in its own thread.""" + + def __init__(self): + Scheduler.__init__(self) + # we require a lock around the task queue + self._lock = threading.Lock() + + def start(self): + """Splice off a thread in which the scheduler will run.""" + self.thread = threading.Thread(target=self._run) + self.thread.setDaemon(True) + self.thread.start() + + def stop(self): + """Stop the scheduler and wait for the thread to finish.""" + Scheduler.stop(self) + try: + self.thread.join() + except AttributeError: + pass + + def _acquire_lock(self): + """Lock the thread's task queue.""" + self._lock.acquire() + + def _release_lock(self): + """Release the lock on th ethread's task queue.""" + self._lock.release() + + + class ThreadedTaskMixin: + """A mixin class to make a Task execute in a separate thread.""" + + def __call__(self, schedulerref): + """Execute the task action in its own thread.""" + threading.Thread(target=self.threadedcall).start() + self.reschedule(schedulerref()) + + def threadedcall(self): + # This method is run within its own thread, so we have to + # do the execute() call and exception handling here. + try: + self.execute() + except Exception as x: + self.handle_exception(x) + + class ThreadedIntervalTask(ThreadedTaskMixin, IntervalTask): + """Interval Task that executes in its own thread.""" + pass + + class ThreadedSingleTask(ThreadedTaskMixin, SingleTask): + """Single Task that executes in its own thread.""" + pass + + class ThreadedWeekdayTask(ThreadedTaskMixin, WeekdayTask): + """Weekday Task that executes in its own thread.""" + pass + + class ThreadedMonthdayTask(ThreadedTaskMixin, MonthdayTask): + """Monthday Task that executes in its own thread.""" + pass + +except ImportError: + # threading is not available + pass + + +if hasattr(os, "fork"): + import signal + + class ForkedScheduler(Scheduler): + """A Scheduler that runs in its own forked process.""" + + def __del__(self): + if hasattr(self, "childpid"): + os.kill(self.childpid, signal.SIGKILL) + + def start(self): + """Fork off a new process in which the scheduler will run.""" + pid = os.fork() + if pid == 0: + # we are the child + signal.signal(signal.SIGUSR1, self.signalhandler) + self._run() + os._exit(0) + else: + # we are the parent + self.childpid = pid + # can no longer insert in the scheduler queue + del self.sched + + def stop(self): + """Stop the scheduler and wait for the process to finish.""" + os.kill(self.childpid, signal.SIGUSR1) + os.waitpid(self.childpid, 0) + + def signalhandler(self, sig, stack): + Scheduler.stop(self) + + + class ForkedTaskMixin: + """A mixin class to make a Task execute in a separate process.""" + + def __call__(self, schedulerref): + """Execute the task action in its own process.""" + pid = os.fork() + if pid == 0: + # we are the child + try: + self.execute() + except Exception as x: + self.handle_exception(x) + os._exit(0) + else: + # we are the parent + self.reschedule(schedulerref()) + + + class ForkedIntervalTask(ForkedTaskMixin, IntervalTask): + """Interval Task that executes in its own process.""" + pass + + class ForkedSingleTask(ForkedTaskMixin, SingleTask): + """Single Task that executes in its own process.""" + pass + + class ForkedWeekdayTask(ForkedTaskMixin, WeekdayTask): + """Weekday Task that executes in its own process.""" + pass + + class ForkedMonthdayTask(ForkedTaskMixin, MonthdayTask): + """Monthday Task that executes in its own process.""" + pass + + + +if __name__=="__main__": + def testaction(arg): + print ">>>TASK",arg,"sleeping 3 seconds" + time.sleep(3) + print "<< might be fixed now, 1.9.8 # state icon: bookmark star - if (conf.show_bookmarks and self.parent.channels.has_key("bookmarks") and self.parent.bookmarks.is_in(streams[i].get("url", "file:///tmp/none"))): + if (conf.show_bookmarks and "bookmarks" in self.parent.channels and self.parent.bookmarks.is_in(streams[i].get("url", "file:///tmp/none"))): streams[i]["favourite"] = 1 # state icon: INFO or DELETE if (not row.get("state")): if row.get("favourite"): @@ -309,15 +309,14 @@ # if category tree is empty, initialize it if not self.categories: __print__(dbg.PROC, "first_show: reload_categories"); #self.parent.thread(self.reload_categories) - print("reload categories"); self.reload_categories() self.display_categories() self.current = self.categories.keys()[0] - print self.current + __print__(dbg.STAT, self.current) self.load(self.current) # load current category else: __print__(dbg.STAT, "first_show: load current category"); DELETED channels/basicch.py Index: channels/basicch.py ================================================================== --- channels/basicch.py +++ channels/basicch.py @@ -1,305 +0,0 @@ - -# api: streamtuner2 -# title: basic.ch channel -# -# -# -# Porting ST1 plugin senseless, old parsing method wasn't working any longer. Static -# realaudio archive is not available anymore. -# -# Needs manual initialisation of categories first. -# - - -import re -import http -from config import conf -from channels import * -from xml.sax.saxutils import unescape - - - - - - - - - - - - - - -# basic.ch broadcast archive -class basicch (ChannelPlugin): - - # description - title = "basic.ch" - module = "basicch" - homepage = "http://www.basic.ch/" - version = 0.3 - base = "http://basic.ch/" - - # keeps category titles->urls - catmap = {} - categories = [] #"METAMIX", "reload category tree!", ["menu > channel > reload cat..."]] - #titles = dict(listeners=False, bitrate=False) - - - # read previous channel/stream data, if there is any - def cache(self): - ChannelPlugin.cache(self) - # catmap - cache = conf.load("cache/catmap_" + self.module) - if (cache): - self.catmap = cache - pass - - - # refresh category list - def update_categories(self): - - html = http.get(self.base + "shows.cfm") - - rx_current = re.compile(r""" - ([^<>]+) - \s*([^<>]+)
]+)">(METAMIX[^<]+) - \s+([^<>]+)
(http://[^<">]+)\s* - ([^<>]+)\s* - ([^<>]+) - """, re.S|re.X) - - entries = [] - - #-- update categories first - if not len(self.catmap): - self.update_categories() - - #-- frontpage mixes - if cat == "METAMIX": - for uu in rx_metamix.findall(http.get(self.base)): - (url, title, genre) = uu - entries.append({ - "genre": genre, - "title": title, - "url": url, - "format": "audio/mp3", - "homepage": self.homepage, - }) - - #-- pseudo entry - elif cat=="shows": - entries = [{"title":"shows","homepage":self.homepage+"shows.cfm"}] - - #-- fetch playlist.xml - else: - - # category name "Xsound & Ymusic" becomes "Xsoundandymusic" - id = cat.replace("&", "and").replace(" ", "") - id = id.lower().capitalize() - - catinfo = self.catmap.get(cat, {"id":"", "genre":""}) - - # extract - html = http.get(self.base + "playlist/" + id + ".xml") - for uu in rx_playlist.findall(html): # you know, we could parse this as proper xml - (url, artist, title) = uu # but hey, lazyness works too - entries.append({ - "url": url, - "title": artist, - "playing": title, - "genre": catinfo["genre"], - "format": "audio/mp3", - "homepage": self.base + "shows.cfm?showid=" + catinfo["id"], - }) - - # done - return entries - - - - - - - - - - - -# basic.ch broadcast archive -class basicch_old_static: #(ChannelPlugin): - - # description - title = "basic.ch" - module = "basicch" - homepage = "http://www.basic.ch/" - version = 0.2 - base = "http://basic.ch/" - - # keeps category titles->urls - catmap = {} - - - # read previous channel/stream data, if there is any - def cache(self): - ChannelPlugin.cache(self) - # catmap - cache = conf.load("cache/catmap_" + self.module) - if (cache): - self.catmap = cache - pass - - - # refresh category list - def update_categories(self): - - html = http.get(self.base + "downtest.cfm") - - rx_current = re.compile(""" - href="javascript:openWindow.'([\w.?=\d]+)'[^>]+> - (\w+[^<>]+)(\w+[^<>]+)]+)" - """, re.S|re.X) - - rx_archive = re.compile(""" - href="javascript:openWindow.'([\w.?=\d]+)'[^>]+>.+? - color="000000">(\w+[^<>]+)(\w+[^<>]+)(\d\d\.\d\d\.\d\d).+? - href="(http://[^">]+|/ram/\w+.ram)"[^>]*>([^<>]+) - .+? (>(\w+[^<]*)Radio Genres - rx = re.compile(r'[\w\s]+', re.S) + rx = re.compile(r'[\w\s]+', re.S) sub = [] for uu in rx.findall(html): __print__( dbg.DATA, uu ) - (main,name,id) = uu + (main,name,id) = uu name = urllib.unquote(name) # main category if main: if sub: Index: channels/timer.py ================================================================== --- channels/timer.py +++ channels/timer.py @@ -18,10 +18,11 @@ # are stored in the description field, and can thus be edited. However, after editing # times manually, streamtuner2 must be restarted for the changes to take effect. # +from config import __print__, dbg from channels import * import kronos from mygtk import mygtk from action import action import copy @@ -74,11 +75,11 @@ # prepare spool self.sched = kronos.ThreadedScheduler() for row in self.streams: try: self.queue(row) - except Exception,e: print("queuing error", e) + except Exception as e: __print__(dbg.ERR, "queuing error", e) self.sched.start() # display GUI for setting timespec def edit_timer(self, *w): DELETED channels/tv.py Index: channels/tv.py ================================================================== --- channels/tv.py +++ channels/tv.py @@ -1,123 +0,0 @@ -# -# api: streamtuner2 -# title: shoutcast TV -# description: TV listings from shoutcast -# version: 0.0 -# stolen-from: Tunapie.sf.net -# -# As seen in Tunapie, there are still TV listings on Shoutcast. This module -# adds a separate tab for them. Streamtuner2 is centrally and foremost about -# radio listings, so this plugin will remain one of the few exceptions. -# -# http://www.shoutcast.com/sbin/newtvlister.phtml?alltv=1 -# -# Pasing with lxml is dead simple in this case, so we use etree directly -# instead of PyQuery. Like with the Xiph plugin, downloaded streams are simply -# stored in .streams["all"] pseudo-category. -# -# icon: http://cemagraphics.deviantart.com/art/Little-Tv-Icon-96461135 - -from channels import * -import http -import lxml.etree - - - - -# TV listings from shoutcast.com -class tv(ChannelPlugin): - - # desc - api = "streamtuner2" - module = "tv" - title = "TV" - version = 0.1 - homepage = "http://www.shoutcast.com/" - base_url = "http://www.shoutcast.com/sbin/newtvlister.phtml?alltv=1" - play_url = "http://yp.shoutcast.com/sbin/tunein-station.pls?id=" - listformat = "audio/x-scpls" # video streams are NSV linked in PLS format - - # settings - config = [ - ] - - # categories - categories = ["all", "video"] - current = "" - default = "all" - empty = "" - - # redefine - streams = {} - - - # get complete list - def all(self): - r = [] - - # retrieve - xml = http.get(self.base_url) - - # split up entries - for station in lxml.etree.fromstring(xml): - - r.append({ - "title": station.get("name"), - "playing": station.get("ct"), - "id": station.get("id"), - "url": self.play_url + station.get("id"), - "format": "video/nsv", - "time": station.get("rt"), - "extra": station.get("load"), - "genre": station.get("genre"), - "bitrate": int(station.get("br")), - "listeners": int(station.get("lc")), - }) - - return r - - - # genre switch - def load(self, cat, force=False): - if force or not self.streams.get("all"): - self.streams["all"] = self.all() - ChannelPlugin.load(self, cat, force) - - - # update from the list - def update_categories(self): - - # update it always here: #if not self.streams.get("all"): - self.streams["all"] = self.all() - - # enumerate categories - c = {"all":100000} - for row in self.streams["all"]: - for genre in row["genre"].split(" "): - if len(genre)>2 and row["bitrate"]>=200: - c[genre] = c.get(genre, 0) + 1 - # append - self.categories = sorted(c, key=c.get, reverse=True) - - - - # extract from big list - def update_streams(self, cat, search=""): - - # autoload only if "all" category is missing - if not self.streams.get("all"): - self.streams["all"] = self.all() - - # return complete list as-is - if cat == "all": - return self.streams[cat] - - # search for category - else: - return [row for row in self.streams["all"] if row["genre"].find(cat)>=0] - - - - - - ADDED channels/xiph.png Index: channels/xiph.png ================================================================== --- channels/xiph.png +++ channels/xiph.png cannot compute difference between binary files Index: channels/xiph.py ================================================================== --- channels/xiph.py +++ channels/xiph.py @@ -17,11 +17,11 @@ # streamtuner2 modules from config import conf from mygtk import mygtk -import http +import ahttp as http from channels import * from config import __print__, dbg # python modules import re Index: cli.py ================================================================== --- cli.py +++ cli.py @@ -15,11 +15,11 @@ # import sys #from channels import * -import http +import ahttp import action from config import conf import json ADDED compat2and3.py Index: compat2and3.py ================================================================== --- compat2and3.py +++ compat2and3.py @@ -0,0 +1,60 @@ +# +# encoding: UTF-8 +# api: python +# type: functions +# title: Python2 and Python3 compatibility +# version: 0.1 +# +# Renames some Python3 modules into their Py2 equivalent. +# Slim local alternative to `six` module. +# + + +import sys + + +# Python 2 +if sys.version_info < (3,0): + + # version tags + PY2 = 1 + PY3 = 0 + + # basic functions + xrange = xrange + range = xrange + unicode = unicode + + # urllib modules + import urllib + import urllib2 + from urllib import urlencode + import urlparse + import cookielib + + # filesys + from StringIO import StringIO + + +# Python 3 +else: + + # version tags + PY2 = 0 + PY3 = 1 + + # basic functions + xrange = range + unicode = str + + # urllib modules + import urllib.request as urllib + import urllib.request as urllib2 + from urllib.parse import urlencode + import urllib.parse as urlparse + from http import cookiejar as cookielib + + # filesys + from io import StringIO + + Index: config.py ================================================================== --- config.py +++ config.py @@ -15,22 +15,24 @@ # import os import sys -import pson +import json import gzip import platform + + #-- create a single instance of config object conf = object() - #-- global configuration data --------------------------------------------- class ConfigDict(dict): + # start def __init__(self): # object==dict means conf.var is conf["var"] @@ -50,10 +52,11 @@ self.update(last) # store defaults in file else: self.save("settings") self.firstrun = 1 + # some defaults def defaults(self): self.browser = "sensible-browser" self.play = { @@ -87,10 +90,11 @@ self.debug = False self.channel_order = "shoutcast, xiph, internet_radio_org_uk, jamendo, myoggradio, .." self.reuse_m3u = 1 self.google_homepage = 1 self.windows = platform.system()=="Windows" + self.debug = 1 # each plugin has a .config dict list, we add defaults here def add_plugin_defaults(self, config, module=""): @@ -119,11 +123,11 @@ # store some configuration list/dict into a file def save(self, name="settings", data=None, gz=0, nice=0): name = name + ".json" - if (data == None): + if (data is None): data = dict(self.__dict__) # ANOTHER WORKAROUND: typecast to plain dict(), else json filter_data sees it as object and str()s it nice = 1 # check for subdir if (name.find("/") > 0): subdir = name[0:name.find("/")] @@ -139,11 +143,11 @@ if os.path.exists(file): os.unlink(file) else: f = open(file, "w") # encode - pson.dump(data, f, indent=(4 if nice else None)) + json.dump(data, f, indent=(4 if nice else None)) f.close() # retrieve data from config file def load(self, name): @@ -150,21 +154,21 @@ name = name + ".json" file = self.dir + "/" + name try: # .gz or normal file if os.path.exists(file + ".gz"): - f = gzip.open(file + ".gz", "r") + f = gzip.open(file + ".gz", "rt") elif os.path.exists(file): - f = open(file, "r") + f = open(file, "rt") else: return # file not found # decode - r = pson.load(f) + r = json.load(f) f.close() return r except Exception as e: - print("PSON parsing error (in "+name+")", e) + print(dbg.ERR, "PSON parsing error (in "+name+")", e) # recursive dict update def update(self, with_new_data): for key,value in with_new_data.items(): @@ -179,15 +183,10 @@ def find_in_dirs(self, dirs, file): for d in dirs: if os.path.exists(d+"/"+file): return d+"/"+file - - -#-- actually fill global conf instance -conf = ConfigDict() - # wrapper for all print statements def __print__(*args): @@ -205,7 +204,16 @@ "HTTP": "[HTTP]", # magenta HTTP REQUEST "DATA": "[DATA]", # cyan DATA "INFO": "[INFO]", # gray INFO "STAT": "[STATE]", # gray CONFIG STATE }) + + + +#-- actually fill global conf instance +conf = ConfigDict() +if conf: + __print__(dbg.PROC, "ConfigDict() initialized") + + Index: favicon.py ================================================================== --- favicon.py +++ favicon.py @@ -26,17 +26,16 @@ delete_google_stub = 1 # don't keep placeholder images google_placeholder_filesizes = (726,896) import os, os.path -import urllib +from compat2and3 import xrange, urllib import re -import urlparse from config import conf try: from processing import Process as Thread except: from threading import Thread -import http +import ahttp # ensure that we don't try to download a single favicon twice per session, # if it's not available the first time, we won't get it after switching stations back and forth @@ -87,16 +86,16 @@ title = rx_t.search(row["title"]) if title: title = title.group(0).replace(" ", "%20") # do a google search - html = http.ajax("http://www.google.de/search?hl=de&q="+title, None) + html = ahttp.ajax("http://www.google.de/search?hl=de&q="+title, None) # find first URL hit url = rx_u.search(html) if url: - row["homepage"] = http.fix_url(url.group(1)) + row["homepage"] = ahttp.fix_url(url.group(1)) pass #----------------- @@ -193,13 +192,13 @@ r = urllib.urlopen(favicon) headers = r.info() # abort on if r.getcode() >= 300: - raise "HTTP error", r.getcode() + raise Error("HTTP error" + r.getcode()) if not headers["Content-Type"].lower().find("image/"): - raise "can't use text/* content" + raise Error("can't use text/* content") # save file fn_tmp = fn+".tmp" f = open(fn_tmp, "wb") f.write(r.read(32768)) @@ -234,11 +233,11 @@ # url or if favicon.startswith("http://"): None # just /pathname else: - favicon = urlparse.urljoin(url, favicon) + favicon = ahttp.urlparse.urljoin(url, favicon) #favicon = "http://" + domain(url) + "/" + favicon # download direct_download(favicon, file(url)) @@ -264,11 +263,11 @@ import operator import struct try: from PIL import BmpImagePlugin, PngImagePlugin, Image -except Exception, e: +except Exception as e: print("no PIL", e) always_google = 1 only_google = 1 Index: gtk3.xml ================================================================== --- gtk3.xml +++ gtk3.xml @@ -1,17 +1,18 @@ + - + False + 0.95999999999999996 5 station search center-on-parent dialog False center - 0.95999999999999996 True @@ -27,11 +28,10 @@ cancel False True True True - False False False @@ -41,11 +41,10 @@ False True True - False False False 1 @@ -57,11 +56,10 @@ False True True True Instead of searching in the station list, just look up the above search term on google. - False half False @@ -75,11 +73,10 @@ False True False True Instead of doing a cache search, go through the search functions on the directory service homepages. (UNIMPLEMENTED) - False half False @@ -95,14 +92,13 @@ False True True True Start searching for above search term in the currently loaded station lists. Doesn't find *new* information, just looks through the known data. - False True - + False False 4 @@ -277,18 +273,152 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + all channels False True True False - False 0.5 True True @@ -363,11 +493,10 @@ False True True True - False none False False @@ -379,11 +508,10 @@ in title False True True False - False 0.5 True True @@ -397,11 +525,10 @@ in description False True True False - False 0.5 True True @@ -415,11 +542,10 @@ any fields False True True False - False 0.5 True True @@ -432,11 +558,10 @@ False True True True - False none False False @@ -462,11 +587,10 @@ False True True True - False none False False @@ -478,11 +602,10 @@ homepage url False True True False - False 0.5 True True @@ -496,11 +619,10 @@ extra info False True True False - False 0.5 True True @@ -513,11 +635,10 @@ and genre False True True False - False 0.5 True True @@ -530,11 +651,10 @@ False True True True - False none False False @@ -690,11 +810,10 @@ cancel False True True True - False False False @@ -706,11 +825,10 @@ ok False True True True - False False False @@ -783,10 +901,64 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + True True ● @@ -799,10 +971,19 @@ 2 1 2 + + + + + + + + + @@ -1010,11 +1191,10 @@ 200 20 True True ● - True False False 1 @@ -1028,11 +1208,10 @@ 200 20 True True ● - True False False 1 @@ -1046,11 +1225,10 @@ 200 20 True True ● - True False False 1 @@ -1064,11 +1242,10 @@ 200 20 True True ● - True False False 1 @@ -1112,11 +1289,10 @@ 200 20 True True ● - True False False 1 @@ -1168,11 +1344,10 @@ 200 20 True True ● - True False False 1 @@ -1186,11 +1361,10 @@ 200 20 True True ● - True False False 1 @@ -1215,11 +1389,10 @@ 200 20 True True ● - True False False 1 @@ -1367,18 +1540,53 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + show bookmark star for favourites in stream lists False True True False - False 0 True 1 @@ -1398,11 +1606,10 @@ 5 ● 4 120 out - True False False True @@ -1434,11 +1641,10 @@ retain deleted stations in list False True True False - False 0 True 1 @@ -1452,11 +1658,10 @@ display favicons for individual music stations False True True False - False 0 True 1 @@ -1470,11 +1675,10 @@ load favicon for played stations False True True False - False 0 True 1 @@ -1488,11 +1692,10 @@ update favorites from freshened stream urls False True True False - False 0 True 1 @@ -1506,11 +1709,10 @@ google for homepage URL if missing False True True False - False 0 True 1 @@ -1539,11 +1741,10 @@ True True ● - True False False True @@ -1564,11 +1765,10 @@ automatically save window state False True True False - False 0 True 1 @@ -1803,10 +2003,82 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + True False Directories @@ -1833,11 +2105,10 @@ 200 20 True True ● - True False False 1 @@ -1908,11 +2179,10 @@ 20 True True False ● - True False False 1 @@ -1926,11 +2196,10 @@ reuse temporary .m3u files False True True False - False 0.5 True 1 @@ -2244,11 +2513,10 @@ 100 35 True True True - False False True @@ -2262,11 +2530,10 @@ 100 35 True True True - False True True @@ -2293,16 +2560,16 @@ False + 0.94999999999999996 5 inspect/edit stream data center-on-parent True False - 0.94999999999999996 True False @@ -2492,11 +2759,10 @@ 100 25 True True True - False 100 10 @@ -2510,11 +2776,10 @@ 25 True True True Save changes. - False 210 10 @@ -2527,11 +2792,10 @@ 50 25 True True True - False 5 10 @@ -2631,15 +2895,10 @@ streamtuner2 980 775 /usr/share/pixmaps/streamtuner2.png applications-multimedia - - - streamtuner2 - - True False @@ -2674,13 +2933,13 @@ False True False bookmark True - + - + gtk-save-as @@ -2687,13 +2946,13 @@ False True False True True - + - + gtk-edit @@ -2700,14 +2959,14 @@ False True False True True - - + - + + False @@ -2741,12 +3000,12 @@ False True False True True - + @@ -2780,13 +3039,13 @@ False True False True True - + - + gtk-find @@ -2793,12 +3052,12 @@ False True False True True - + True @@ -2908,12 +3167,12 @@ False True False True True - + @@ -2944,12 +3203,12 @@ False True False Reload True - + False @@ -3058,11 +3317,10 @@ False True False - False play gtk-media-play @@ -3073,11 +3331,10 @@ False True False - False record gtk-media-record @@ -3088,11 +3345,10 @@ False True False - False station gtk-home @@ -3113,11 +3369,10 @@ False True False - False reload gtk-refresh @@ -3128,11 +3383,10 @@ False True False - False stop gtk-cancel @@ -3356,8 +3610,13 @@ end 2 + + + + streamtuner2 + Index: help/channel_internetradioorguk.page ================================================================== --- help/channel_internetradioorguk.page +++ help/channel_internetradioorguk.page @@ -9,12 +9,12 @@ Large radio directory from the UK. Internet-Radio.org.uk -

I-R.org.uk is a good alternative to Shoutcast. It also lacks channel homepage in most +

I-R.org.uk is a good alternative to Shoutcast. It also lacks a channel homepage in most cases, but is a likewise encyclopedical directory. Genres are similiar to Shoutcast.

Note that this plugin uses its own setting for how many links to retrieve. Instead of stream numbers, it only counts pages. This is a lazyness related bug.

 Index: help/channel_shoutcast.page ================================================================== --- help/channel_shoutcast.page +++ help/channel_shoutcast.page @@ -20,10 +20,13 @@

Stream links are plain PLS files.

Genres are subcategorized, so the main groups in the category list must often be expanded to see the interesting entries.

 +

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.

There are a few plugin options for this channel. <code>PyQuery parsing</code> @@ -30,10 +33,11 @@

Uses an XML parser to extract station data from within HTML <tags> of the shoutcast.com site. This is slower, but often more reliable than regular expressions, which look for plain text markers.

 <code>debug output</code> -

Prints verbose messages to the console. This option is used while developing extensions for Streamtuner2.

+

Prints verbose messages to the console. This option is used while developing extensions for Streamtuner2. + And it actually ought to be a global option by now.

 Index: help/channel_xiph.page ================================================================== --- help/channel_xiph.page +++ help/channel_xiph.page @@ -14,11 +14,11 @@

Xiph.org is a non-profit organization, which develops and promotes the OGG audio format. It also hosts a list of ICEcast streaming stations (ICEcast is the non-commercial pendant to the SHOUTcast server.)

This channel is especially easy to read by Streamtuner2, because the source data is already - provided as <XML> file. However, it lacks some essential informaitons like station + provided as <XML> file. However, it lacks some essential informations like station homepages and listener numbers.

Xiph also uses the .xspf format, instead of .pls stream links

@@ -27,10 +27,10 @@ <code>Filter by minimum bitrate</code>

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 set this option. OGG starts to sound good with 128 kbit/s (whereas - MP3 often needs 192 at least).

+ MP3 often requires 192 at least).

 Index: help/glossary_json.page ================================================================== --- help/glossary_json.page +++ help/glossary_json.page @@ -8,11 +8,11 @@ JSON files

JSON is a data representation format derived from Javascript (the browser embedded - programming language for websites). Streamtuner2 uses it to store it's configuration + programming language for websites). Streamtuner2 uses it to store its configuration and radio station data files.

The MIME type of these files is application/json and they often look like:

[ ADDED help/html/C.css Index: help/html/C.css ================================================================== --- help/html/C.css +++ help/html/C.css @@ -0,0 +1,1101 @@ + +html { height: 100%; } +body { + font-family: sans-serif; + margin: 0; padding: 0; + background-color: #ffffff; + color: #000000; + direction: ltr; +} +div.page { + margin: 1em auto 1em auto; + max-width: 60em; + border: solid 1px #babdb6; +} +div.body { + margin: 0; + padding-left: 1em; + padding-right: 1em; + padding-bottom: 1em; + min-height: 20em; + background-color: #ffffff; +} +div.header { margin: 0; } +div.footer { margin: 0; } +div.sect { + margin-top: 2.4em; + clear: both; +} +div.sect div.sect { + margin-top: 1.44em; + margin-left: 1.72em; +} +div.trails { + margin: 0; + padding: 0.5em 1em 0.5em 1em; + background-color: #f3f3f0; +} +div.trail { + margin: 0.2em 0 0 0; + padding: 0 1em 0 1em; + text-indent: -1em; + color: #2e3436; +} +a.trail { white-space: nowrap; } +div.hgroup { + margin: 1em 0 0.5em 0; + color: #2e3436; +} +div.sect div.hgroup { + margin-top: 0; + border-bottom: solid 1px #babdb6; +} +div.sect-links div.hgroup { + border-bottom: solid 2px #729fcf; +} +div.sect div.sect-links { + margin-left: 0; +} +div.sect div.sect-links div.hgroup { + border: none; +} +h1, h2, h3, h4, h5, h6, h7 { + margin: 0; padding: 0; + color: #2e3436; + font-weight: bold; +} +h1 { font-size: 2em; } +h2 { font-size: 1.44em; } +h3.title, h4.title, h5.title, h6.title, h7.title { font-size: 1.2em; } +h3, h4, h5, h6, h7 { font-size: 1em; } + +p { line-height: 1.72em; } +div, pre, p { margin: 1em 0 0 0; padding: 0; } +div.contents > *:first-child, +th > *:first-child, td > *:first-child, +dt > *:first-child, dd > *:first-child, +li > *:first-child { margin-top: 0; } +div.inner, div.region, div.contents, pre.contents { margin-top: 0; } +pre.contents div { margin-top: 0 !important; } +p img { vertical-align: middle; } +p.lead { font-size: 1.2em; } +div.clear { + margin: 0; padding: 0; + height: 0; line-height: 0; + clear: both; +} +.center { text-align: center; } + +div.about { + color: #2e3436; +} +div.about > div.inner > div.hgroup { + margin: 0; padding: 0; + text-align: center; + border: none; +} +div.about > div.inner > div.hgroup > h2 { + margin: 0; padding: 0.2em; + font-size: inherit; +} +div.about.ui-expander > div.inner > div.hgroup span.title:before { + content: ""; +} +div.copyrights { + margin: 1em; + text-align: center; +} +div.copyright { + margin: 0; +} +div.aboutblurb { + display: inline-block; + vertical-align: top; + text-align: left; + max-width: 18em; + margin: 0 1em 1em 1em; +} +ul.credits, ul.credits li { + margin: 0; padding: 0; + list-style-type: none; +} +ul.credits li { + margin-left: 1em; + text-indent: -1em; +} + +table { + border-collapse: collapse; + border-color: #2e3436; + border-width: 1px; +} +td, th { + padding: 0.5em; + vertical-align: top; + border-color: #2e3436; + border-width: 1px; +} +thead td, thead th, tfoot td, tfoot th { + font-weight: bold; + color: #2e3436; + background-color: #e5e5e3; +} +th { + text-align: left; + font-weight: bold; + color: #2e3436; +} + +ul, ol, dl { margin: 0; padding: 0; } +li { + margin: 1em 0 0 0; + margin-left: 2.4em; + padding: 0; +} +li:first-child { margin-top: 0; } +dt { margin-top: 1em; } +dt:first-child { margin-top: 0; } +dt + dt { margin-top: 0; } +dd { + margin: 0.2em 0 0 0; + margin-left: 1.44em; +} +dd + dd { margin-top: 1em; } +ol.compact li { margin-top: 0.2em; } +ul.compact li { margin-top: 0.2em; } +ol.compact li:first-child { margin-top: 0; } +ul.compact li:first-child { margin-top: 0; } +dl.compact dt { margin-top: 0.2em; } +dl.compact dt:first-child { margin-top: 0; } +dl.compact dt + dt { margin-top: 0; } + +a { + text-decoration: none; + color: #204a87; +} +a:visited { color: #5c3566; } +a:hover { + border-bottom: dotted 1px #729fcf; +} +p a { + border-bottom: dotted 1px #729fcf; +} +a img { border: none; } +@media only screen and (max-width: 400px) { + div.page { + margin: 0; + border: none; + } + div.body { + padding-left: 0; + padding-right: 0; + } + div.body > div.hgroup, + div.body > div.region > div.contents > *, + div.body > div.region > div.sect > div.inner > div.hgroup > *, + div.body > div.region > div.sect > div.inner > div.region > div.contents > * { + margin-left: 12px; + margin-right: 12px; + } + div.body > div.region > div.sect-links { + margin-left: 0; + margin-right: 0; + } + div.trails { + padding: 12px; + } + li { + margin-left: 1.44em; + } +} + +div.title { + margin: 0 0 0.2em 0; + font-weight: bold; + color: #2e3436; +} +div.title h1, div.title h2, div.title h3, div.title h4, div.title h5, div.title h6 { + margin: 0; + font-size: inherit; + font-weight: inherit; + color: inherit; +} +div.desc { margin: 0 0 0.2em 0; } +div.contents + div.desc { margin: 0.2em 0 0 0; } +pre.contents { + padding: 0.5em 1em 0.5em 1em; +} +div.links-center { text-align: center; } +div.links .desc { color: #2e3436; } +div.links > div.inner > div.region > div.desc { font-style: italic; } +div.links ul { margin: 0; padding: 0; } +div.links ul ul { + margin-left: 1em; +} +li.links { + margin: 0.5em 0 0.5em 0; + padding: 0; + padding-left: 1em; + list-style-type: none; +} +div.sectionlinks { + display: inline-block; + padding: 0 1em 0 1em; + background-color: #e6f2ff; + border: solid 1px #729fcf; +} +div.sectionlinks ul { margin: 0; } +div.sectionlinks li { padding: 0; } +div.sectionlinks div.title { margin: 0.5em 0 0.5em 0; } +div.sectionlinks div.sectionlinks { + display: block; + margin: 0.5em 0 0 0; + padding: 0; + border: none; +} +div.sectionlinks div.sectionlinks li { + padding-left: 1.44em; +} +div.nextlinks { + font-size: 1.2em; + margin-left: 1.2em; + float: right; + clear: both; +} +div.nextlinks a { + background-color: #f3f3f0; + display: inline-block; + position: relative; + height: 1.44em; + padding: 0.2em 0.83em; + margin-bottom: 1em; +} +a.nextlinks-prev { margin-left: 0.72em; } +a.nextlinks-next { margin-right: 0.72em; } +a.nextlinks-prev:after, a.nextlinks-next:after { + border: solid transparent; + content: " "; + position: absolute; + height: 0; width: 0; + border-width: 0.92em; + top: 50%; + margin-top: -0.92em; +} +a.nextlinks-prev:after { + right: 100%; + border-right-color: #f3f3f0; +} +a.nextlinks-next:after { + left: 100%; + border-left-color: #f3f3f0; +} +div.nextlinks a:hover { +border: none; + background: #e6f2ff +} +a.nextlinks-prev:hover:after { + border-right-color: #e6f2ff +} +a.nextlinks-next:hover:after { + border-left-color: #e6f2ff +} +div.serieslinks { + display: inline-block; + padding: 0 1em 0 1em; + background-color: #e6f2ff; + border: solid 1px #729fcf; +} +div.serieslinks ul { margin: 0; } +div.serieslinks li { padding: 0; } +div.serieslinks div.title { margin: 0.5em 0 0.5em 0; } +pre.numbered { + margin: 0; + padding: 0.5em; + float: left; + margin-right: 0.5em; + text-align: right; + color: #2e3436; + background-color: #fffacc; +} +div.code { + background: url('yelp-code.png') no-repeat top right; + border: solid 1px #babdb6; +} +div.example { + border-left: solid 4px #babdb6; + padding-left: 1em; +} +div.figure { + margin-left: 1.72em; + padding: 4px; + color: #2e3436; + border: solid 1px #babdb6; + background-color: #f3f3f0; +} +div.figure > div.inner > a.zoom { + float: right; +} +div.figure > div.inner > div.region > div.contents { + margin: 0; + padding: 0.5em 1em 0.5em 1em; + clear: both; + text-align: center; + color: #000000; + border: solid 1px #babdb6; + background-color: #ffffff; +} +div.list > div.inner > div.title { margin-bottom: 0.5em; } +div.listing > div.inner { margin: 0; padding: 0; } +div.listing > div.inner > div.region > div.desc { font-style: italic; } +div.note { + padding: 6px; + border: solid 1px #e5e5e3; + background-color: #f3f3f0; +} +div.note > div.inner > div.title { + margin-left: 30px; +} +div.note > div.inner > div.region > div.contents { + margin: 0; padding: 0; + margin-left: 30px; +} +div.note > div.inner { + margin: 0; padding: 0; + background-image: url("yelp-note.png"); + background-position: left top; + background-repeat: no-repeat; + min-height: 24px; +} +div.note-advanced > div.inner { } +div.note-bug > div.inner { background-image: url("yelp-note-bug.png"); } +div.note-important > div.inner { background-image: url("yelp-note-important.png"); } +div.note-tip > div.inner { background-image: url("yelp-note-tip.png"); } +div.note-warning > div.inner { background-image: url("yelp-note-warning.png"); } +div.note-sidebar { + float: right; + max-width: 40%; + margin-left: 6px; + padding: 6px; +} +div.note-sidebar > div.inner { background-image: none; } +div.note-sidebar > div.inner > div.title { margin-left: 0px; } +div.note-sidebar > div.inner > div.region > div.contents { margin-left: 0px; } +div.note-plain > div.inner { background-image: none; } +div.note-plain > div.inner > div.title { margin-left: 0px; } +div.note-plain > div.inner > div.region > div.contents { margin-left: 0px; } +div.quote { + padding: 0; + min-height: 48px; +} +div.quote > div.inner:before { + float: left; + content: '“'; + font-family: "Century Schoolbook L"; + font-size: 48px; + font-weight: bold; + line-height: 1em; + margin: 0; padding: 0; + height: 48px; + width: 48px; + text-align: center; + color: #e5e5e3; +} +div.quote > div.inner > div.title { + margin: 0; + margin-left: 48px; +} +blockquote { + margin: 0; padding: 0; + margin-left: 48px; +} +blockquote > *:first-child { margin-top: 0; } +div.quote > div.inner > div.region > div.cite { + margin-top: 0.5em; + margin-left: 48px; + color: #2e3436; +} +div.quote > div.inner > div.region > div.cite::before { + + content: '― '; + color: #2e3436; +} +div.screen { + background-color: #f3f3f0; + border: solid 1px #babdb6; +} +ol.steps, ul.steps { + margin: 0; + padding: 0.5em 1em 0.5em 1em; + border-left: solid 4px #edd400; + -moz-box-shadow: 0 1px 2px #babdb6; + -webkit-box-shadow: 0 1px 2px #babdb6; + box-shadow: 0 1px 2px #babdb6; +} +ol.steps .steps { + padding: 0; + border: none; + background-color: none; + -moz-box-shadow: none; + -webkit-box-shadow: none; + box-shadow: none; +} +li.steps { margin-left: 1.44em; } +li.steps li.steps { margin-left: 2.4em; } +div.synopsis > div.inner > div.region > div.contents, +div.synopsis > div.contents, div.synopsis > pre.contents { + padding: 0.5em 1em 0.5em 1em; + border-top: solid 1px; + border-bottom: solid 1px; + border-color: #729fcf; + background-color: #f3f3f0; +} +div.synopsis > div.inner > div.region > div.desc { font-style: italic; } +div.synopsis div.code { + background: none; + border: none; + padding: 0; +} +div.synopsis div.code > pre.contents { margin: 0; padding: 0; } +div.table > div.desc { font-style: italic; } +tr.shade { + background-color: #f3f3f0; +} +td.shade { + background-color: #f3f3f0; +} +tr.shade td.shade { + background-color: #e5e5e3; +} + +span.app { font-style: italic; } +span.cmd { + font-family: monospace; + background-color: #f3f3f0; + padding: 0 0.2em 0 0.2em; +} +span.cmd span.cmd { background-color: none; padding: 0; } +pre span.cmd { background-color: none; padding: 0; } +span.code { + font-family: monospace; + border-bottom: solid 1px #e5e5e3; +} +span.code span.code { border: none; } +pre span.code { border: none; } +span.em { font-style: italic; } +span.em-bold { + font-style: normal; font-weight: bold; + color: #2e3436; +} +pre span.error { + color: #a40000; +} +span.file { font-family: monospace; } +span.gui, span.guiseq { color: #2e3436; } +span.input { font-family: monospace; } +pre span.input { + font-weight: bold; + color: #2e3436; +} +kbd { + font-family: inherit; + font-size: inherit; + color: #2e3436; + background-color: #f3f3f0; + border: solid 1px #babdb6; + -moz-border-radius: 2px; + -webkit-border-radius: 2px; + border-radius: 2px; + -moz-box-shadow: 1px 1px 2px #babdb6; + -webkit-box-shadow: 1px 1px 2px #babdb6; + box-shadow: 1px 1px 2px #babdb6; + margin: 0 0.2em 0 0.2em; + padding: 0 0.5em 0 0.5em; + white-space: nowrap; +} +kbd.key-Fn { + font-weight: bold; + color: #729fcf; +} +span.key a { + border-bottom: none; +} +a > kbd { + color: #204a87; + border-color: #729fcf; +} +span.keyseq { + color: #2e3436; + white-space: nowrap +} +span.output { font-family: monospace; } +pre span.output { + color: #000000; +} +pre span.prompt { + color: #2e3436; +} +span.sys { font-family: monospace; } +span.var { font-style: italic; } + +.ui-tile-img .media-controls { display: none; } +span.media-audio, span.media-video { display: inline-block; } +audio, video { display: block; margin: 0; } +div.media > div.inner { display: inline-block; text-align: center; } +div.media-controls { + min-width: 24em; + height: 24px; + margin: 0; padding: 0; + border-left: solid 1px #000000;; + border-right: solid 1px #000000;; + border-bottom: solid 1px #000000;; + background-color: #2e3436; + color: #ffffff; + -moz-border-bottom-left-radius: 4px; + -moz-border-bottom-right-radius: 4px; + -webkit-border-bottom-left-radius: 4px; + -webkit-border-bottom-right-radius: 4px; + border-bottom-left-radius: 4px; + border-bottom-right-radius: 4px; +} +div.media-controls-audio { + border-top: solid 1px #000000;; + -moz-border-radius: 4px; + -webkit-border-radius: 4px; + border-radius: 4px; +} +button.media-play { + height: 24px; + padding: 0 2px 0 2px; line-height: 0; + float: left; + background-color: #2e3436; + border: none; + border-right: solid 1px #000000;; +} +button.media-play:hover, button.media-play:focus { + background-color: #729fcf; +} +button.media-play canvas { margin: 0; } +div.media-range { + display: inline-block; + margin: 2px 8px 0 8px; + padding: 0; + height: 20px; +} +div.media-time { + float: right; + margin: 0; + font-size: 16px; + height: 24px; + line-height: 24px; +} +div.media-time > span { + padding-right: 8px; +} +span.media-duration { + font-size: 12px; + color: #e5e5e3; + opacity: 0.8; +} +div.media-ttml { margin: 0; padding: 0; } +.media-ttml-pre { white-space: pre; } +.media-ttml-nopre { white-space: normal; } +div.media-ttml-div { + text-align: left; + display: none; + margin: 0; padding: 0; +} +div.media-ttml-p { + text-align: left; + display: none; + margin: 6px auto 0 auto; + padding: 6px; + max-width: 24em; + border: solid 1px #edd400; + background-color: #fffacc; + -moz-box-shadow: 2px 2px 4px #babdb6; + -webkit-box-shadow: 2px 2px 4px #babdb6; + box-shadow: 2px 2px 4px #babdb6; +} +div.yelp-data { display: none; } +div.ui-expander > div.inner > div.title span.title, +div.ui-expander > div.inner > div.hgroup span.title { + cursor: default; +} +div.ui-expander > div.inner > div.title span.title:before, +div.ui-expander > div.inner > div.hgroup span.title:before { + font-size: 2em; + font-weight: normal; + content: "⌃"; + display: inline-block; + line-height: 0.2em; + vertical-align: bottom; + color: #204a87; +} +div.ui-expander-c > div.inner > div.hgroup { border-bottom: none; } +div.ui-expander-e > div.inner > div.title span.title:before, +div.ui-expander-e > div.inner > div.hgroup span.title:before { + content: "⌄"; + vertical-align: top; +} +div.ui-expander > div.inner > div.title:hover, +div.ui-expander > div.inner > div.hgroup:hover * { + color: #204a87; +} +div.ui-expander > div.inner > div.hgroup > .subtitle { + margin-left: 2em; +} +@media only screen and (max-width: 400px) { + div.links { + margin-left: 12px; + margin-right: 12px; + } + li.links { padding: 0; } + div.body > div.region > div.contents > div.example, + div.body > div.region > div.contents > div.steps, + div.body > div.region > div.contents > div.note, + div.body > div.region > div.sect > div.inner > div.region > div.contents > div.example, + div.body > div.region > div.sect > div.inner > div.region > div.contents > div.steps, + div.body > div.region > div.sect > div.inner > div.region > div.contents > div.note { + margin-left: 0; + margin-right: 0; + } + div.steps > div.inner > div.title { + margin-left: 18px; + margin-right: 18px; + } + ol.steps, ul.steps { + -moz-box-shadow: none; + -webkit-box-shadow: none; + box-shadow: none; + } + div.note-sidebar { + float: none; + max-width: none; + margin-left: inherit; + margin-right: inherit; + padding-left: inherit; + padding-right: inherit; + } + div.note-sidebar > div.inner > div.title, + div.note-sidebar > div.inner > div.region > div.contents { + margin-left: 12px; + margin-right: 12px; + } +} + +pre.syntax span.function, pre.syntax span.keyword, pre.syntax span.tag { + color: #729fcf; +} +pre.syntax span.string, pre.syntax span.operator { + color: #2e3436; +} + +div.link-button { + font-size: 1.2em; + font-weight: bold; +} +.link-button a { + display: inline-block; + background-color: #729fcf; + color: #ffffff; + text-shadow: #204a87 1px 1px 0px; + border: solid 1px #204a87; + padding: 0.2em 0.5em 0.2em 0.5em; + -moz-border-radius: 2px; + -webkit-border-radius: 2px; + border-radius: 2px; +} +.link-button a:visited { + color: #ffffff; +} +.link-button a:hover { + text-decoration: none; + color: #ffffff; + box-shadow: 1px 1px 1px #729fcf; +} +div.link-button a .desc { + display: block; + font-weight: normal; + font-size: 0.83em; + color: #f3f3f0; +} +div.floatleft { + float: left; + margin-right: 1em; +} +div.floatright { + float: right; + margin-left: 1em; +} +div.floatstart { + float: left; + margin-right: 1em; +} +div.floatend { + float: right; + margin-left: 1em; +} + +div.title-heading h1, div.title-heading h2, div.title-heading h3, +div.title-heading h4, div.title-heading h5, div.title-heading h6 { + font-size: 1.72em; + font-weight: bold; +} +ul.links-heading > li { margin: 2em 0 2em 0; padding: 0; } +div.links-heading > a { font-size: 1.72em; font-weight: bold; } +ul.links-heading > li > div.desc { margin-top: 0.5em; } + +div.mouseovers { + width: 250px; + height: 200px; + text-align: center; + margin: 0; + float: left; +} +ul.mouseovers li { margin: 0; } +ul.mouseovers a { + display: inline-block; + padding: 4px 1.2em 4px 1.2em; + border-bottom: none; +} +ul.mouseovers a:hover { + text-decoration: none; + background: #e6f2ff; +} +ul.mouseovers a img { + display: none; + position: absolute; + margin: 0; padding: 0; +} +@media only screen and (max-width: 400px) { + ul.mouseovers a { + display: block; + padding: 12px; + margin-left: -12px; + margin-right: -12px; + } + div.mouseovers { display: none; } +} + +div.ui-screen { + display: none; + position: fixed; + margin: 0; + left: 0; top: 0; + width: 100%; height: 100%; + background: #2e3436; + opacity: 0.6; +} +div.ui-overlay { + display: none; + position: fixed; + text-align: center; + left: 0; + top: 20px; + width: 100%; + z-index: 10; +} +div.ui-overlay > div.inner { + display: inline-block; + padding: 8px; + background-color: #f3f3f0; + border: solid 1px #2e3436; + box-shadow: 0 2px 4px #2e3436; + -moz-border-radius: 6px; + -webkit-border-radius: 6px; + border-radius: 6px; + text-align: left; +} +div.ui-overlay > div.inner > div.title { margin-top: -4px; } +a.ui-overlay-close { + display: block; + float: right; + width: 23px; height: 23px; + font-size: 18px; line-height: 23px; + font-weight: bold; + margin-top: -28px; + margin-right: -24px; + padding: 1px 2px 3px 2px; + text-align: center; + border: none; + -moz-border-radius: 50%; + -webkit-border-radius: 50%; + border-radius: 50%; + background-color: #000000; + background-image: -moz-radial-gradient(50% 30%, circle farthest-corner, #2e3436, #000000); + background-image: radial-gradient(50% 30%, circle farthest-corner, #2e3436, #000000); + background-image: -webkit-radial-gradient(50% 30%, circle farthest-corner, #2e3436, #000000); + border: 3px solid #ffffff; + color: #ffffff; + box-shadow: 0 2px 2px #000000; + text-shadow: 0 2px 2px #000000; +} +a.ui-overlay-close:hover { +} + +div.ui-tile { + display: inline-block; + vertical-align: top; + clear: both +} +div.region > div.ui-tile { + margin-top: 0; + margin-bottom: 1em; +} +div.ui-tile:first-child { margin-top: 1em; } +div.ui-tile > a { + display: inline-block; + vertical-align: top; + margin: 0; + margin-right: 1em; + padding: 1em; + -moz-border-radius: 6px; + -webkit-border-radius: 6px; + border-radius: 6px; +} +div.ui-tile > a { + border: solid 1px #f3f3f0; +} +div.ui-tile > a:hover { + border: solid 1px #e6f2ff; + box-shadow: 0 1px 2px #729fcf; +} +div.ui-tile > a > * { display: block; } +div.ui-tile-side > a > * { + display: inline-block; + vertical-align: top; +} +div.ui-tile-side > a > span.ui-tile-text { + margin-left: 1em; +} +div.ui-tile > a > span.ui-tile-text > span.title { + display: block; + margin-top: 0.5em; + font-weight: bold; +} +div.ui-tile-side > a > span.ui-tile-text > span.title { margin-top: 0; } +div.ui-tile > a > span.ui-tile-text > span.desc { + display: block; + margin: 0.2em 0 0 0; + color: #2e3436; +} +span.ui-tile-img { text-align: center; } + +div.links-ui-hover { + text-align: center; + margin: 0; + float: left; + margin-right: 1.2em; + overflow: hidden; +} +ul.links-ui-hover li { margin: 0; } +ul.links-ui-hover a { + display: block; + padding: 4px 1.2em 4px 1.2em; + border-bottom: none; +} +ul.links-ui-hover a:hover { + text-decoration: none; + background: #e6f2ff; +} +span.links-ui-hover-img { + display: none; + position: absolute; + margin: 0; padding: 0; + overflow: hidden; + background: #e6f2ff; + text-align: center; +} +@media only screen and (max-width: 400px) { + ul.links-ui-hover a { + display: block; + padding: 12px; + margin-left: -12px; + margin-right: -12px; + } + div.links-ui-hover { display: none; } +} + +div.links-grid { + display: inline-block; + clear: both + margin-top: 1em; + width: 30%; + margin-right: 2%; + vertical-align: top; +} +div.links-grid-link { + margin: 0; + font-weight: bold; +} +div.links-grid > div.desc { + margin: 0; + color: #2e3436; +} +@media only screen and (max-width: 400px) { + div.links-grid { + width: 47%; + } +} + +div.links-twocolumn { + display: inline-block; + width: 48%; + margin-top: 0; + margin-right: 1%; + vertical-align: top; +} +@media only screen and (max-width: 400px) { + div.links-twocolumn { + width: 100%; + margin-right: 0; + } +} + +div.links .desc a { + color: inherit; +} +div.links .desc a:hover { + color: #204a87; +} +a.bold { font-weight: bold; } +div.linkdiv { margin: 0; padding: 0; } +a.linkdiv { + display: block; + margin: 0; + padding: 0.5em; + border-bottom: none; +} +a.linkdiv:hover { + text-decoration: none; + background-color: #e6f2ff; +} +a.linkdiv > span.title { + display: block; + margin: 0; + font-size: 1em; + font-weight: bold; + color: inherit; +} +a.linkdiv > span.desc { + display: block; + margin: 0.2em 0 0 0; + color: #2e3436; +} +span.linkdiv-dash { display: none; } +@media only screen and (max-width: 400px) { + div.linkdiv { + margin-left: -12px; + margin-right: -12px; + } + div.linkdiv a { + padding-left: 12px; + padding-right: 12px; + } +} + +div.comment { + padding: 0.5em; + border: solid 2px #ef2929; + background-color: #ffdede; +} +div.comment div.comment { + margin: 1em 1em 0 1em; +} +div.comment div.cite { + margin: 0 0 0.5em 0; + font-style: italic; +} + +div.tree > div.inner > div.title { margin-bottom: 0.5em; } +ul.tree { + margin: 0; padding: 0; + list-style-type: none; +} +li.tree { margin: -2px 0 0 0; padding: 0; } +li.tree div { margin: 0; padding: 0; } +ul.tree ul.tree { + margin-left: 1.44em; +} +div.tree-lines ul.tree { margin-left: 0; } + +span.hi { + background-color: #fffacc; +} + +div.facets { + display: inline-block; + padding: 6px; + background-color: #fffacc; + border: solid 1px #729fcf; +} +div.facet { + vertical-align: top; + display: inline-block; + margin-top: 0; + margin-bottom: 1em; + margin-right: 1em; +} +div.facet div.title { margin: 0; } +div.facet li { + margin: 0; padding: 0; + list-style-type: none; +} +div.facet input { + vertical-align: middle; + margin: 0; +} +dt.gloss-term { + margin-top: 1.2em; + font-weight: bold; + color: #2e3436; +} +dt.gloss-term:first-child, dt.gloss-term + dt.gloss-term { margin-top: 0; } +dt.gloss-term + dd { margin-top: 0.2em; } +dd.gloss-link { + margin: 0 0.2em 0 0.2em; + border-left: solid 4px #729fcf; + padding-left: 1em; +} +dd.gloss-def { + margin: 0 0.2em 1em 0.2em; + border-left: solid 4px #babdb6; + padding-left: 1em; +} +a.gloss-term { + tabindex: 0; + border-bottom: dashed 1px #729fcf; +} +a.gloss-term:hover { + text-decoration: none; + border-bottom-style: solid; +} +span.gloss-desc { + display: none; + position: absolute; + margin: 0; + padding: 0.2em 0.5em 0.2em 0.5em; + max-width: 24em; + color: #2e3436; + background-color: #fffacc; + border: solid 1px #edd400; + -moz-box-shadow: 2px 2px 4px #babdb6; + -webkit-box-shadow: 2px 2px 4px #babdb6; + box-shadow: 2px 2px 4px #babdb6; +} + +.if-if { display: none; } +.if-choose, .if-when, .if-else { margin: 0; padding: 0; } +.if-choose > .if-when { display: none; } +.if-choose > .if-else { display: block; } +.if-if.if__not-target-mobile { display: block; } +.if-choose.if__not-target-mobile > .if-when { display: block; } +.if-choose.if__not-target-mobile > .if-else { display: none; } +@media only screen and (max-width: 400px) { + .if-if.if__target-mobile { display: block; } + .if-if.if__not-target-mobile { display: none; } + .if-choose.if__target-mobile > .if-when { display: block; } + .if-choose.if__target-mobile > .if-else { display: none; } + .if-choose.if__not-target-mobile > .if-when { display: none; } + .if-choose.if__not-target-mobile > .if-else { display: block; } +} ADDED help/html/bookmarks.html Index: help/html/bookmarks.html ================================================================== --- help/html/bookmarks.html +++ help/html/bookmarks.html @@ -0,0 +1,66 @@ + + + + +Bookmarks + + + +

+
+
+

Bookmarks

+
+
+

It's easy to lose the overview when you browse through the various channel tabs, genres + and internet radio stations. Therefore streamtuner2 allows to create bookmarks. This way + you can collect favoured streams in a single place.

+

Just right click a station you want to bookmark, and choose bookmark in the context + menu. Alternatively you can use the Streams entry in the application menu. Once bookmarked + you can see the station entry in the (!) "bookmarks" tab, under "favourite". That's where + they all go.

+
+
+

Editing

+
+

Entries can be removed from the bookmark list again. Use the edit menu for that.

+

Bookmarked stations are shown with a star in all other channel tabs. If you delete the + entry there, it won't remove it from the real bookmarks list.

+
+
+
+

Subcategories

+
+

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.

+
+
Searching — Quicksearch field and Ctrl+F compound search window.
+
Timer — Programming recurring play and recording events.
+
+
+
+ +
+
+
+
+
+ ADDED help/html/channels.html Index: help/html/channels.html ================================================================== --- help/html/channels.html +++ help/html/channels.html @@ -0,0 +1,79 @@ + + + + +Channels + + + +
+
+
+

Channels

+
+
+

The tabs in the main window represent the music directory channels. Each lists + categories and streams from a specific radio directory.

+
+

If you first select a channel tab, the categories should appear or be loading. + Otherwise:

+
    +

  1. Select a channel tab

    2. +

  2. Choose Channel ▸ Reload categories...

    3. +

  3. Pick a category/genre from the overview, left.

    4. +
+

Individual channels provide different music/radio information. The table + views are however identical in each tab. You could modify the datamap[] + in the plugin files, if you want to adapt this.

+
+ +
+

Channel service homepage

+

You can dobule click the channel tab to view the website of a directory services. + Alternatively there is an entry in the Channel menu.

+
+
+

Channel menu options

+
+
+
Homepage of directory service
+

Opens a webbrowser with the current channels website.

+
Reload
+

Updates the current category and displays fresh station lists.

+
Update favicons...
+

Starts assembling favicons for the current list of stations in the background. + To actually display the freshly loaded favicons, reselect the current category.

+
Reload category tree
+

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 often only is used for initializing streamtuner2 + channels when the list is empty.

+
+

The channel menu also contains a list of available channels. Select an entry to switch + into that tab.

+
+
+ +
+
+
+
+
+ ADDED help/html/cli.html Index: help/html/cli.html ================================================================== --- help/html/cli.html +++ help/html/cli.html @@ -0,0 +1,55 @@ + + + + +CLI (command line interface) + + + +
+
+
+

CLI (command line interface)

+
+
+

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.

+

Open a terminal and call streamtuner2 help to get an overview over + available commands.

+
+

Examples

+
+
streamtuner2 play "station"
+

This command looks through all channel plugins, and finds a station containing the + mentioned title. In the shell you must put the station title in quotes, if it contains + e.g. spaces. You can optionally specify a channelname before the station title.

+
streamtuner2 url [channel] "station"
+

Just looks up the streaming URL for a given station. If no channel name is given, + ST2 searches through all available channel plugins again.

+
streamtuner2 stream shoutcast "station"
+

Prints available station data as JSON

+
streamtuner2 category internet_radio_org_uk "Pop"
+

Loads fresh data from the specified channel service, and prints out JSON data for + the whole category. Note that the category name must have the excact case.

+
streamtuner2 categories channel
+

Fetches the current list of available categories/genres for a channel service.

+
+
+

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.

+
+ +
+
+
+
+
+ ADDED help/html/config_apps.html Index: help/html/config_apps.html ================================================================== --- help/html/config_apps.html +++ help/html/config_apps.html @@ -0,0 +1,117 @@ + + + + +Audio players + + + +
+
+
+

Audio players

+
+
+

On BSD/Linux systems there are a plethora of audio players. In streamtuner2 you can + configure 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.

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+

Some audio players open a second instance when you actually want to switch radios. + In this case it's a common workaround to write pkill vlc ; vlc %u instead. + This ends the previous player and starts it anew.

+

Some applications, like Rhythmbox or Banshee, are pure GUI applications and cannot + be invoked with a play URL by other apps. This makes them unsuitable for use with + streamtuner2.

+
+
+

URL placeholders

+
+

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.

+
+ + + + + + + + + + + + + + + + + + + + +
+

You sould preferrably use the long forms. Most audio players like %m3u most, while + streamripper needs %srv for recording.

+
+
+ +
+
+
+
+
+ ADDED help/html/configuration.html Index: help/html/configuration.html ================================================================== --- help/html/configuration.html +++ help/html/configuration.html @@ -0,0 +1,112 @@ + + + + +Settings dialog + + + +
+
+
+

Settings dialog

+
+
+

There are many options in streamtuner2. You can find the settings dialog in the edit menu, + preferences (last entry).

+
+

It is separated into four main areas.

+
+
Player
+

Lists audio formats and the applications which shall be used for playing.

+
Display
+

Influences the display of all stream/station lists.

+
System
+

Filesystem and environment settings. Boring.

+
Channel Plugins
+

Every channel tab can have specific options. These are configured here. Also you can disable channels you don't need.

+
+
+
+
+

Player application settings

+
+

MIME types are elaborate identifiers for file types. audio/mp3 for example represents MP3 files, and audio/ogg + means just OGG.

+

The text entry fields can hold the application name of an audio player. Often the application name + is just a lower case version of the program title, but you might have to look it up.

+

Behind the application program name is a placeholder. If the audio player is invoked, this placeholder + gets replaces with an URL (a http://..-Link) of the selected radio stream.

+

It's introduced by percent sign, and followed by letters. %m3u for example generates a .m3u file. Most + audio players understand that. Otherwise try %pls, which might even be faster because streamtuner2 doesn't + have to download and preprocess it. %srv instead gives a direct stream link.

+

The entry for */* is a catch-all. If the audio format of a radio station isn't know, this application + gets called.

+

Recording

+

The last entry in the 'Apps' section specifies streamripper. It is used for recording stations. You + might want to add some commandline -arguments here.

+
+
Audio players — Common applications to use as players.
+
Recording — Save radio songs as MP3 files via streamripper.
+
+
+
+
+

Display/GUI options

+
+

Most options here a self-explanatory. 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.

+

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.

+

"Retain deleted stations" keeps old entries, when you reload a category/genre. Shoutcast often + forgets stations or throws them out. If you keep this option enabled, these entries are kept in + streamtuner2. Browse down in the stations list to still see them.

+

It's possible to select a Gtk+ theme. But not all themes work with all Gtk display engines, and + not all themes work with streamtuner2. You just have to try it.

+

Remembering window states makes streamtuner2 not forget which channel and category was last + selected. You can however disable this option, and instead manually save the window states/layout + in the edit menu, if you want.

+
+
+
+

System info

+
+

There are just a few options here, and some are hard-wired. Usually you don't want to change them.

+

Setting another temporary directory might be useful, if you want to keep the temporary .m3u cache + files. They are created whenever you hit play. For archival or speed-up porposes you might want to keep + them elsewhere. They don't take a lot of space.

+
+
+
+

Plugin and Channel settings

+
+

Each channel plugin can bring its own list of configuration settings. These are collected here.

+

The heading for each plugin is actually a button, which allows disabling the plugin. Alas the state + cannot be easily discerned with all themes.

+

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.

+
+
Internet-Radio.org.uk — Large radio directory from the UK.
+
MyOggRadio — Open source stream directory.
+
Shoutcast — One of the bigger radio station lists.
+
Xiph.org — ICEcast radio directory.
+
+
+
+ +
+
+
+
+
+ ADDED help/html/extending.html Index: help/html/extending.html ================================================================== --- help/html/extending.html +++ help/html/extending.html @@ -0,0 +1,69 @@ + + + + +Extension Howto + + + +
+
+
+

Extension Howto

+
+
+

Streamtuner2 is written in Python, a rather easy programming language. And it's also rather simple + to write a new channel plugin.

+

The basic layout of every channel plugin is as follows:

+

+ +from channels import * + +class myplugin (ChannelPlugin): + + title = "MyNewChannel" + module = "myplugin" + homepage = "http://www.mymusicstation.com/" + categories = [] + + + + def update_categories(self): + + self.categories = [] + + + + def update_streams(self, cat, force=0): + + entries = [] + + # ... + # get it from somewhere + # ... + + return entries + +

+

There are some self-explanatory description fields, and two important methods. Sometimes you + don't need categories even. The update_streams() function often downloads a website, parses it + with regular expressions or PyQuery / DOM methods, and packs into into a result list.

+

Here entries is a list of dictionaries, with standardized entry names like "title" and "playing" + for the description, and "homepage" for a browsable link, and most importantly "url" for the + actual streaming link. Often you want to add a "genre" and "format" and "bitrate" info. But this depends + on your plugins data source, really.

+
+ +
+
+
+
+
+ ADDED help/html/global_key.html Index: help/html/global_key.html ================================================================== --- help/html/global_key.html +++ help/html/global_key.html @@ -0,0 +1,70 @@ + + + + +Global_key + + + +
+
+
+

Global_key

+
+
+

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.

+

This is useful if you don't want to keep the streamtuner2 window in the foreground + all the time, but still want to switch radios easily.

+

Go into settings F12 for plugins to define a keyboard shortcut:

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+

To define another channel as source, enter its module name in the according field. Also + add a category separated by : colon here.

+

If the configured keyboard shortcut conflicts with another application, + 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.

+
+ +
+
+
+
+
+ ADDED help/html/glossary.html Index: help/html/glossary.html ================================================================== --- help/html/glossary.html +++ help/html/glossary.html @@ -0,0 +1,100 @@ + + + + +Glossary + + + +
+
+
+

Glossary

+
+
+
Channel
+

Each tab in the main window is a "channel". It represents one + music directory service.

+
Stream
+
+

"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).

+

In streamtuner2 we also use the terms "stream" and radio "station" interchangably.

+
+
Genre
+

Music genres are represented as "categories" in the left + pane. Every channel groups its music stations into some + structure.

+
URL
+

URL stands for "Uniform Resource Locator" and simply means + hyperlinks and web addresses like http://www.example.org/. + There is also the hipster term "URI", which is technically more + general (but superseeded by "IRI" and "IRL" anyway). In + streamtuner2 the audio streaming link often is an URL, as is the + radio station homepage of course.

+
Radio
+

Plays music. Sometimes interrupted by advertisements. +

+
Favicons
+

Favicons are small symbols for websites. Every website has one. + Or should have. As it makes it easier to associate content with + homepage addresses. (ST2 downloads favicons either per menu command + or automatically for the current station once you hit play.) +

+
Cache
+

Radio lists are kept in "cache" files for efficiency reasons. + To not redownload stream information on every category or channel + flip, streamtuner2 saves this data. This avoids time consuming + server requests. +

+
Python
+

Python is a programming language. It provides extensive constructs and + many functions, yet is easy to learn. See python.org and Google.

+
MP3
+

MP3 (MPEG Layer 3) is an audio file format, part of the wider MPEG (Motion Picture + Expert Group) video format. It's the most widespread format in use today, + however doesn't provide the highest audio quality..

+
OGG Vorbis
+

OGG is a multimedia file format. Vorbis is an audio compression format. + OGG Vorbis was developed as alternative to MP3. It's often of higher + quality at lower file sizes, and isn't encumbered by US software patents.

+
MIME
+

For classification of web and email content, two-factor descriptions like + "audio/ogg" are advised. These are called Multipurpose Internet Mail Extension + types, and are used on the web in lieu of file extensions (which URL resources don't have). + Note that ST2 uses the MP3 type wrong; it's officially audio/mpeg, and not audio/mp3 as shown in the settings window.

+
Bitrate
+

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 + for example 64 kbit/s. So while bitrate basically means file size per duration, + it's commonly used as quality indicator.

+
+
+

Filetypes

+
+

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.

+
+
.M3U files — MP3-URL playlist file.
+
.PLS files — Playlist file format.
+
JSON files — JavaScript Object Notation is a common data exchange format.
+
+
+
+ +
+
+
+
+
+ ADDED help/html/homepage.html Index: help/html/homepage.html ================================================================== --- help/html/homepage.html +++ help/html/homepage.html @@ -0,0 +1,47 @@ + + + + +Radio homepages + + + +
+
+
+

Radio homepages

+
+
+

Most radio stations are listed with a homepage URL. Use the house symbol in the + toolbar or right click ▸ homepage to open it in a web browser.

+

Some homepage links are guessed, because for example Shoutcast doesn't list them anymore. + And if you play a station without homepage URL, it automatically gets googled (but will not + be displayed until you reselect the category.) +

+
+
+

Channel service

+

You can also open channel homepages. Either from the Channel menu, or via + double clicking the channel tab.

+
+ +
+
+
+
+
+ ADDED help/html/img/channels.png Index: help/html/img/channels.png ================================================================== --- help/html/img/channels.png +++ help/html/img/channels.png cannot compute difference between binary files ADDED help/html/img/logo.png Index: help/html/img/logo.png ================================================================== --- help/html/img/logo.png +++ help/html/img/logo.png cannot compute difference between binary files ADDED help/html/img/mainwindow2.svg Index: help/html/img/mainwindow2.svg ================================================================== --- help/html/img/mainwindow2.svg +++ help/html/img/mainwindow2.svg @@ -0,0 +1,303 @@ + + + + + + + + + + + + + + + + + image/svg+xml + + + + + + + + + + + + streamtuner2 + + Station Edit Channel Help + + + + + + bookmarks Shoutcast Xiph Jamendo + + CategoryGenregenregenregenregenre + + Radio station 128 http://www.radiStation title ... 128 http://123.fm/Stream title .... 128 http://www............................... + + + ADDED help/html/img/streams.png Index: help/html/img/streams.png ================================================================== --- help/html/img/streams.png +++ help/html/img/streams.png cannot compute difference between binary files ADDED help/html/index.html Index: help/html/index.html ================================================================== --- help/html/index.html +++ help/html/index.html @@ -0,0 +1,100 @@ + + + + +♪ Streamtuner2 + + + +
+
+
+

♪ Streamtuner2

+
+
+

Streamtuner2 shows internet radio stations for easy browsing, playing, recording.

+
Introduction — Basic usage instructions. Selecting a channel, category, and playing a radio.
+
+ + + + + + +
+
+
+
+
+ ADDED help/html/internet_radio_org_uk.html Index: help/html/internet_radio_org_uk.html ================================================================== --- help/html/internet_radio_org_uk.html +++ help/html/internet_radio_org_uk.html @@ -0,0 +1,43 @@ + + + + +Internet-Radio.org.uk + + + +
+
+
+

Internet-Radio.org.uk

+
+
+

I-R.org.uk is a good alternative to Shoutcast. It also lacks channel homepage in most + cases, but is a likewise encyclopedical directory. Genres are similiar to Shoutcast.

+

Note that this plugin uses its own setting for how many links to retrieve. Instead + of stream numbers, it only counts pages. This is a lazyness related bug.

+
+ +
+
+
+
+
+ ADDED help/html/introduction.html Index: help/html/introduction.html ================================================================== --- help/html/introduction.html +++ help/html/introduction.html @@ -0,0 +1,105 @@ + + + + +Introduction + + + +
+
+
+

Introduction

+
+
+

Streamtuner2 is a simple browser for internet radios. It aquires its radio lists + from various directory services. These are represented as "channel" tabs in the main + window. Below are the category/genre lists (left) and the stations for a genre (right).

+
+
+
+

How to select and play a radio.

+
+
    +

  1. Select a channel tab, like Shoutcast.

    2. +

  2. Click one of the genres in the left pane. For example Classic.

    3. +

  3. Now the right pane loads a radio list.

    4. +

  4. Double click one of the radio streams or use the play toolbar button.

    5. +
+

Note that some categories can and should be exanded. In a few plugins (modarchive), + the expandable genre/category brings up no station list on its own, while in Shoutcast + and most others it's a valid genre in itself.

+

Some radio stations cannot be played, because they just have a homepage. (That's the + case for all listings in the Google Stations channel.)

+
+
+
+

What else can you do?

+
+

Double clicking an entry row in the radio list starts your audio player. But there are + other functions available. Either go to the  ▸ Station menu, + or access the context menu with a right click.

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+

Play, Record and Homepage also have buttons in the toolbar.

+
+
+
+

Radio lists get stale

+

After some time, stream informations become obsolete. Therefore you should regularily + refresh the lists. The Reload button in the toolbar (or F5) is your friend. You can + also update the category lists with Channel ▸ Reload Category Tree + and load favicons using Channel ▸ Update favicons...

+
+
+
+

You should only select radio stations and genres that you like.

+
+ +
+
+
+
+
+ ADDED help/html/jamendo.html Index: help/html/jamendo.html ================================================================== --- help/html/jamendo.html +++ help/html/jamendo.html @@ -0,0 +1,42 @@ + + + + +Jamendo + + + +
+
+
+

Jamendo

+
+
+

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.

+

The streamtuner2 plugin for Jamendo is pretty limited at the moment. It just provides + a quick overview over top artists and most listened albums from each genre. To browse + the whole collections, better go to the Jamendo homepage or use Rhythmbox.

+
+ +
+
+
+
+
+ ADDED help/html/jquery.js Index: help/html/jquery.js ================================================================== --- help/html/jquery.js +++ help/html/jquery.js @@ -0,0 +1,7179 @@ +/*! + * jQuery JavaScript Library v1.4.4 + * http://jquery.com/ + * + * Copyright 2010, John Resig + * Dual licensed under the MIT or GPL Version 2 licenses. + * http://jquery.org/license + * + * Includes Sizzle.js + * http://sizzlejs.com/ + * Copyright 2010, The Dojo Foundation + * Released under the MIT, BSD, and GPL Licenses. + * + * Date: Thu Nov 11 19:04:53 2010 -0500 + */ +(function( window, undefined ) { + +// Use the correct document accordingly with window argument (sandbox) +var document = window.document; +var jQuery = (function() { + +// Define a local copy of jQuery +var jQuery = function( selector, context ) { + // The jQuery object is actually just the init constructor 'enhanced' + return new jQuery.fn.init( selector, context ); + }, + + // Map over jQuery in case of overwrite + _jQuery = window.jQuery, + + // Map over the $ in case of overwrite + _$ = window.$, + + // A central reference to the root jQuery(document) + rootjQuery, + + // A simple way to check for HTML strings or ID strings + // (both of which we optimize for) + quickExpr = /^(?:[^<]*(<[\w\W]+>)[^>]*$|#([\w\-]+)$)/, + + // Is it a simple selector + isSimple = /^.[^:#\[\.,]*$/, + + // Check if a string has a non-whitespace character in it + rnotwhite = /\S/, + rwhite = /\s/, + + // Used for trimming whitespace + trimLeft = /^\s+/, + trimRight = /\s+$/, + + // Check for non-word characters + rnonword = /\W/, + + // Check for digits + rdigit = /\d/, + + // Match a standalone tag + rsingleTag = /^<(\w+)\s*\/?>(?:<\/\1>)?$/, + + // JSON RegExp + rvalidchars = /^[\],:{}\s]*$/, + rvalidescape = /\\(?:["\\\/bfnrt]|u[0-9a-fA-F]{4})/g, + rvalidtokens = /"[^"\\\n\r]*"|true|false|null|-?\d+(?:\.\d*)?(?:[eE][+\-]?\d+)?/g, + rvalidbraces = /(?:^|:|,)(?:\s*\[)+/g, + + // Useragent RegExp + rwebkit = /(webkit)[ \/]([\w.]+)/, + ropera = /(opera)(?:.*version)?[ \/]([\w.]+)/, + rmsie = /(msie) ([\w.]+)/, + rmozilla = /(mozilla)(?:.*? rv:([\w.]+))?/, + + // Keep a UserAgent string for use with jQuery.browser + userAgent = navigator.userAgent, + + // For matching the engine and version of the browser + browserMatch, + + // Has the ready events already been bound? + readyBound = false, + + // The functions to execute on DOM ready + readyList = [], + + // The ready event handler + DOMContentLoaded, + + // Save a reference to some core methods + toString = Object.prototype.toString, + hasOwn = Object.prototype.hasOwnProperty, + push = Array.prototype.push, + slice = Array.prototype.slice, + trim = String.prototype.trim, + indexOf = Array.prototype.indexOf, + + // [[Class]] -> type pairs + class2type = {}; + +jQuery.fn = jQuery.prototype = { + init: function( selector, context ) { + var match, elem, ret, doc; + + // Handle $(""), $(null), or $(undefined) + if ( !selector ) { + return this; + } + + // Handle $(DOMElement) + if ( selector.nodeType ) { + this.context = this[0] = selector; + this.length = 1; + return this; + } + + // The body element only exists once, optimize finding it + if ( selector === "body" && !context && document.body ) { + this.context = document; + this[0] = document.body; + this.selector = "body"; + this.length = 1; + return this; + } + + // Handle HTML strings + if ( typeof selector === "string" ) { + // Are we dealing with HTML string or an ID? + match = quickExpr.exec( selector ); + + // Verify a match, and that no context was specified for #id + if ( match && (match[1] || !context) ) { + + // HANDLE: $(html) -> $(array) + if ( match[1] ) { + doc = (context ? context.ownerDocument || context : document); + + // If a single string is passed in and it's a single tag + // just do a createElement and skip the rest + ret = rsingleTag.exec( selector ); + + if ( ret ) { + if ( jQuery.isPlainObject( context ) ) { + selector = [ document.createElement( ret[1] ) ]; + jQuery.fn.attr.call( selector, context, true ); + + } else { + selector = [ doc.createElement( ret[1] ) ]; + } + + } else { + ret = jQuery.buildFragment( [ match[1] ], [ doc ] ); + selector = (ret.cacheable ? ret.fragment.cloneNode(true) : ret.fragment).childNodes; + } + + return jQuery.merge( this, selector ); + + // HANDLE: $("#id") + } else { + elem = document.getElementById( match[2] ); + + // Check parentNode to catch when Blackberry 4.6 returns + // nodes that are no longer in the document #6963 + if ( elem && elem.parentNode ) { + // Handle the case where IE and Opera return items + // by name instead of ID + if ( elem.id !== match[2] ) { + return rootjQuery.find( selector ); + } + + // Otherwise, we inject the element directly into the jQuery object + this.length = 1; + this[0] = elem; + } + + this.context = document; + this.selector = selector; + return this; + } + + // HANDLE: $("TAG") + } else if ( !context && !rnonword.test( selector ) ) { + this.selector = selector; + this.context = document; + selector = document.getElementsByTagName( selector ); + return jQuery.merge( this, selector ); + + // HANDLE: $(expr, $(...)) + } else if ( !context || context.jquery ) { + return (context || rootjQuery).find( selector ); + + // HANDLE: $(expr, context) + // (which is just equivalent to: $(context).find(expr) + } else { + return jQuery( context ).find( selector ); + } + + // HANDLE: $(function) + // Shortcut for document ready + } else if ( jQuery.isFunction( selector ) ) { + return rootjQuery.ready( selector ); + } + + if (selector.selector !== undefined) { + this.selector = selector.selector; + this.context = selector.context; + } + + return jQuery.makeArray( selector, this ); + }, + + // Start with an empty selector + selector: "", + + // The current version of jQuery being used + jquery: "1.4.4", + + // The default length of a jQuery object is 0 + length: 0, + + // The number of elements contained in the matched element set + size: function() { + return this.length; + }, + + toArray: function() { + return slice.call( this, 0 ); + }, + + // Get the Nth element in the matched element set OR + // Get the whole matched element set as a clean array + get: function( num ) { + return num == null ? + + // Return a 'clean' array + this.toArray() : + + // Return just the object + ( num < 0 ? this.slice(num)[ 0 ] : this[ num ] ); + }, + + // Take an array of elements and push it onto the stack + // (returning the new matched element set) + pushStack: function( elems, name, selector ) { + // Build a new jQuery matched element set + var ret = jQuery(); + + if ( jQuery.isArray( elems ) ) { + push.apply( ret, elems ); + + } else { + jQuery.merge( ret, elems ); + } + + // Add the old object onto the stack (as a reference) + ret.prevObject = this; + + ret.context = this.context; + + if ( name === "find" ) { + ret.selector = this.selector + (this.selector ? " " : "") + selector; + } else if ( name ) { + ret.selector = this.selector + "." + name + "(" + selector + ")"; + } + + // Return the newly-formed element set + return ret; + }, + + // Execute a callback for every element in the matched set. + // (You can seed the arguments with an array of args, but this is + // only used internally.) + each: function( callback, args ) { + return jQuery.each( this, callback, args ); + }, + + ready: function( fn ) { + // Attach the listeners + jQuery.bindReady(); + + // If the DOM is already ready + if ( jQuery.isReady ) { + // Execute the function immediately + fn.call( document, jQuery ); + + // Otherwise, remember the function for later + } else if ( readyList ) { + // Add the function to the wait list + readyList.push( fn ); + } + + return this; + }, + + eq: function( i ) { + return i === -1 ? + this.slice( i ) : + this.slice( i, +i + 1 ); + }, + + first: function() { + return this.eq( 0 ); + }, + + last: function() { + return this.eq( -1 ); + }, + + slice: function() { + return this.pushStack( slice.apply( this, arguments ), + "slice", slice.call(arguments).join(",") ); + }, + + map: function( callback ) { + return this.pushStack( jQuery.map(this, function( elem, i ) { + return callback.call( elem, i, elem ); + })); + }, + + end: function() { + return this.prevObject || jQuery(null); + }, + + // For internal use only. + // Behaves like an Array's method, not like a jQuery method. + push: push, + sort: [].sort, + splice: [].splice +}; + +// Give the init function the jQuery prototype for later instantiation +jQuery.fn.init.prototype = jQuery.fn; + +jQuery.extend = jQuery.fn.extend = function() { + var options, name, src, copy, copyIsArray, clone, + target = arguments[0] || {}, + i = 1, + length = arguments.length, + deep = false; + + // Handle a deep copy situation + if ( typeof target === "boolean" ) { + deep = target; + target = arguments[1] || {}; + // skip the boolean and the target + i = 2; + } + + // Handle case when target is a string or something (possible in deep copy) + if ( typeof target !== "object" && !jQuery.isFunction(target) ) { + target = {}; + } + + // extend jQuery itself if only one argument is passed + if ( length === i ) { + target = this; + --i; + } + + for ( ; i < length; i++ ) { + // Only deal with non-null/undefined values + if ( (options = arguments[ i ]) != null ) { + // Extend the base object + for ( name in options ) { + src = target[ name ]; + copy = options[ name ]; + + // Prevent never-ending loop + if ( target === copy ) { + continue; + } + + // Recurse if we're merging plain objects or arrays + if ( deep && copy && ( jQuery.isPlainObject(copy) || (copyIsArray = jQuery.isArray(copy)) ) ) { + if ( copyIsArray ) { + copyIsArray = false; + clone = src && jQuery.isArray(src) ? src : []; + + } else { + clone = src && jQuery.isPlainObject(src) ? src : {}; + } + + // Never move original objects, clone them + target[ name ] = jQuery.extend( deep, clone, copy ); + + // Don't bring in undefined values + } else if ( copy !== undefined ) { + target[ name ] = copy; + } + } + } + } + + // Return the modified object + return target; +}; + +jQuery.extend({ + noConflict: function( deep ) { + window.$ = _$; + + if ( deep ) { + window.jQuery = _jQuery; + } + + return jQuery; + }, + + // Is the DOM ready to be used? Set to true once it occurs. + isReady: false, + + // A counter to track how many items to wait for before + // the ready event fires. See #6781 + readyWait: 1, + + // Handle when the DOM is ready + ready: function( wait ) { + // A third-party is pushing the ready event forwards + if ( wait === true ) { + jQuery.readyWait--; + } + + // Make sure that the DOM is not already loaded + if ( !jQuery.readyWait || (wait !== true && !jQuery.isReady) ) { + // Make sure body exists, at least, in case IE gets a little overzealous (ticket #5443). + if ( !document.body ) { + return setTimeout( jQuery.ready, 1 ); + } + + // Remember that the DOM is ready + jQuery.isReady = true; + + // If a normal DOM Ready event fired, decrement, and wait if need be + if ( wait !== true && --jQuery.readyWait > 0 ) { + return; + } + + // If there are functions bound, to execute + if ( readyList ) { + // Execute all of them + var fn, + i = 0, + ready = readyList; + + // Reset the list of functions + readyList = null; + + while ( (fn = ready[ i++ ]) ) { + fn.call( document, jQuery ); + } + + // Trigger any bound ready events + if ( jQuery.fn.trigger ) { + jQuery( document ).trigger( "ready" ).unbind( "ready" ); + } + } + } + }, + + bindReady: function() { + if ( readyBound ) { + return; + } + + readyBound = true; + + // Catch cases where $(document).ready() is called after the + // browser event has already occurred. + if ( document.readyState === "complete" ) { + // Handle it asynchronously to allow scripts the opportunity to delay ready + return setTimeout( jQuery.ready, 1 ); + } + + // Mozilla, Opera and webkit nightlies currently support this event + if ( document.addEventListener ) { + // Use the handy event callback + document.addEventListener( "DOMContentLoaded", DOMContentLoaded, false ); + + // A fallback to window.onload, that will always work + window.addEventListener( "load", jQuery.ready, false ); + + // If IE event model is used + } else if ( document.attachEvent ) { + // ensure firing before onload, + // maybe late but safe also for iframes + document.attachEvent("onreadystatechange", DOMContentLoaded); + + // A fallback to window.onload, that will always work + window.attachEvent( "onload", jQuery.ready ); + + // If IE and not a frame + // continually check to see if the document is ready + var toplevel = false; + + try { + toplevel = window.frameElement == null; + } catch(e) {} + + if ( document.documentElement.doScroll && toplevel ) { + doScrollCheck(); + } + } + }, + + // See test/unit/core.js for details concerning isFunction. + // Since version 1.3, DOM methods and functions like alert + // aren't supported. They return false on IE (#2968). + isFunction: function( obj ) { + return jQuery.type(obj) === "function"; + }, + + isArray: Array.isArray || function( obj ) { + return jQuery.type(obj) === "array"; + }, + + // A crude way of determining if an object is a window + isWindow: function( obj ) { + return obj && typeof obj === "object" && "setInterval" in obj; + }, + + isNaN: function( obj ) { + return obj == null || !rdigit.test( obj ) || isNaN( obj ); + }, + + type: function( obj ) { + return obj == null ? + String( obj ) : + class2type[ toString.call(obj) ] || "object"; + }, + + isPlainObject: function( obj ) { + // Must be an Object. + // Because of IE, we also have to check the presence of the constructor property. + // Make sure that DOM nodes and window objects don't pass through, as well + if ( !obj || jQuery.type(obj) !== "object" || obj.nodeType || jQuery.isWindow( obj ) ) { + return false; + } + + // Not own constructor property must be Object + if ( obj.constructor && + !hasOwn.call(obj, "constructor") && + !hasOwn.call(obj.constructor.prototype, "isPrototypeOf") ) { + return false; + } + + // Own properties are enumerated firstly, so to speed up, + // if last one is own, then all properties are own. + + var key; + for ( key in obj ) {} + + return key === undefined || hasOwn.call( obj, key ); + }, + + isEmptyObject: function( obj ) { + for ( var name in obj ) { + return false; + } + return true; + }, + + error: function( msg ) { + throw msg; + }, + + parseJSON: function( data ) { + if ( typeof data !== "string" || !data ) { + return null; + } + + // Make sure leading/trailing whitespace is removed (IE can't handle it) + data = jQuery.trim( data ); + + // Make sure the incoming data is actual JSON + // Logic borrowed from http://json.org/json2.js + if ( rvalidchars.test(data.replace(rvalidescape, "@") + .replace(rvalidtokens, "]") + .replace(rvalidbraces, "")) ) { + + // Try to use the native JSON parser first + return window.JSON && window.JSON.parse ? + window.JSON.parse( data ) : + (new Function("return " + data))(); + + } else { + jQuery.error( "Invalid JSON: " + data ); + } + }, + + noop: function() {}, + + // Evalulates a script in a global context + globalEval: function( data ) { + if ( data && rnotwhite.test(data) ) { + // Inspired by code by Andrea Giammarchi + // http://webreflection.blogspot.com/2007/08/global-scope-evaluation-and-dom.html + var head = document.getElementsByTagName("head")[0] || document.documentElement, + script = document.createElement("script"); + + script.type = "text/javascript"; + + if ( jQuery.support.scriptEval ) { + script.appendChild( document.createTextNode( data ) ); + } else { + script.text = data; + } + + // Use insertBefore instead of appendChild to circumvent an IE6 bug. + // This arises when a base node is used (#2709). + head.insertBefore( script, head.firstChild ); + head.removeChild( script ); + } + }, + + nodeName: function( elem, name ) { + return elem.nodeName && elem.nodeName.toUpperCase() === name.toUpperCase(); + }, + + // args is for internal usage only + each: function( object, callback, args ) { + var name, i = 0, + length = object.length, + isObj = length === undefined || jQuery.isFunction(object); + + if ( args ) { + if ( isObj ) { + for ( name in object ) { + if ( callback.apply( object[ name ], args ) === false ) { + break; + } + } + } else { + for ( ; i < length; ) { + if ( callback.apply( object[ i++ ], args ) === false ) { + break; + } + } + } + + // A special, fast, case for the most common use of each + } else { + if ( isObj ) { + for ( name in object ) { + if ( callback.call( object[ name ], name, object[ name ] ) === false ) { + break; + } + } + } else { + for ( var value = object[0]; + i < length && callback.call( value, i, value ) !== false; value = object[++i] ) {} + } + } + + return object; + }, + + // Use native String.trim function wherever possible + trim: trim ? + function( text ) { + return text == null ? + "" : + trim.call( text ); + } : + + // Otherwise use our own trimming functionality + function( text ) { + return text == null ? + "" : + text.toString().replace( trimLeft, "" ).replace( trimRight, "" ); + }, + + // results is for internal usage only + makeArray: function( array, results ) { + var ret = results || []; + + if ( array != null ) { + // The window, strings (and functions) also have 'length' + // The extra typeof function check is to prevent crashes + // in Safari 2 (See: #3039) + // Tweaked logic slightly to handle Blackberry 4.7 RegExp issues #6930 + var type = jQuery.type(array); + + if ( array.length == null || type === "string" || type === "function" || type === "regexp" || jQuery.isWindow( array ) ) { + push.call( ret, array ); + } else { + jQuery.merge( ret, array ); + } + } + + return ret; + }, + + inArray: function( elem, array ) { + if ( array.indexOf ) { + return array.indexOf( elem ); + } + + for ( var i = 0, length = array.length; i < length; i++ ) { + if ( array[ i ] === elem ) { + return i; + } + } + + return -1; + }, + + merge: function( first, second ) { + var i = first.length, + j = 0; + + if ( typeof second.length === "number" ) { + for ( var l = second.length; j < l; j++ ) { + first[ i++ ] = second[ j ]; + } + + } else { + while ( second[j] !== undefined ) { + first[ i++ ] = second[ j++ ]; + } + } + + first.length = i; + + return first; + }, + + grep: function( elems, callback, inv ) { + var ret = [], retVal; + inv = !!inv; + + // Go through the array, only saving the items + // that pass the validator function + for ( var i = 0, length = elems.length; i < length; i++ ) { + retVal = !!callback( elems[ i ], i ); + if ( inv !== retVal ) { + ret.push( elems[ i ] ); + } + } + + return ret; + }, + + // arg is for internal usage only + map: function( elems, callback, arg ) { + var ret = [], value; + + // Go through the array, translating each of the items to their + // new value (or values). + for ( var i = 0, length = elems.length; i < length; i++ ) { + value = callback( elems[ i ], i, arg ); + + if ( value != null ) { + ret[ ret.length ] = value; + } + } + + return ret.concat.apply( [], ret ); + }, + + // A global GUID counter for objects + guid: 1, + + proxy: function( fn, proxy, thisObject ) { + if ( arguments.length === 2 ) { + if ( typeof proxy === "string" ) { + thisObject = fn; + fn = thisObject[ proxy ]; + proxy = undefined; + + } else if ( proxy && !jQuery.isFunction( proxy ) ) { + thisObject = proxy; + proxy = undefined; + } + } + + if ( !proxy && fn ) { + proxy = function() { + return fn.apply( thisObject || this, arguments ); + }; + } + + // Set the guid of unique handler to the same of original handler, so it can be removed + if ( fn ) { + proxy.guid = fn.guid = fn.guid || proxy.guid || jQuery.guid++; + } + + // So proxy can be declared as an argument + return proxy; + }, + + // Mutifunctional method to get and set values to a collection + // The value/s can be optionally by executed if its a function + access: function( elems, key, value, exec, fn, pass ) { + var length = elems.length; + + // Setting many attributes + if ( typeof key === "object" ) { + for ( var k in key ) { + jQuery.access( elems, k, key[k], exec, fn, value ); + } + return elems; + } + + // Setting one attribute + if ( value !== undefined ) { + // Optionally, function values get executed if exec is true + exec = !pass && exec && jQuery.isFunction(value); + + for ( var i = 0; i < length; i++ ) { + fn( elems[i], key, exec ? value.call( elems[i], i, fn( elems[i], key ) ) : value, pass ); + } + + return elems; + } + + // Getting an attribute + return length ? fn( elems[0], key ) : undefined; + }, + + now: function() { + return (new Date()).getTime(); + }, + + // Use of jQuery.browser is frowned upon. + // More details: http://docs.jquery.com/Utilities/jQuery.browser + uaMatch: function( ua ) { + ua = ua.toLowerCase(); + + var match = rwebkit.exec( ua ) || + ropera.exec( ua ) || + rmsie.exec( ua ) || + ua.indexOf("compatible") < 0 && rmozilla.exec( ua ) || + []; + + return { browser: match[1] || "", version: match[2] || "0" }; + }, + + browser: {} +}); + +// Populate the class2type map +jQuery.each("Boolean Number String Function Array Date RegExp Object".split(" "), function(i, name) { + class2type[ "[object " + name + "]" ] = name.toLowerCase(); +}); + +browserMatch = jQuery.uaMatch( userAgent ); +if ( browserMatch.browser ) { + jQuery.browser[ browserMatch.browser ] = true; + jQuery.browser.version = browserMatch.version; +} + +// Deprecated, use jQuery.browser.webkit instead +if ( jQuery.browser.webkit ) { + jQuery.browser.safari = true; +} + +if ( indexOf ) { + jQuery.inArray = function( elem, array ) { + return indexOf.call( array, elem ); + }; +} + +// Verify that \s matches non-breaking spaces +// (IE fails on this test) +if ( !rwhite.test( "\xA0" ) ) { + trimLeft = /^[\s\xA0]+/; + trimRight = /[\s\xA0]+$/; +} + +// All jQuery objects should point back to these +rootjQuery = jQuery(document); + +// Cleanup functions for the document ready method +if ( document.addEventListener ) { + DOMContentLoaded = function() { + document.removeEventListener( "DOMContentLoaded", DOMContentLoaded, false ); + jQuery.ready(); + }; + +} else if ( document.attachEvent ) { + DOMContentLoaded = function() { + // Make sure body exists, at least, in case IE gets a little overzealous (ticket #5443). + if ( document.readyState === "complete" ) { + document.detachEvent( "onreadystatechange", DOMContentLoaded ); + jQuery.ready(); + } + }; +} + +// The DOM ready check for Internet Explorer +function doScrollCheck() { + if ( jQuery.isReady ) { + return; + } + + try { + // If IE is used, use the trick by Diego Perini + // http://javascript.nwbox.com/IEContentLoaded/ + document.documentElement.doScroll("left"); + } catch(e) { + setTimeout( doScrollCheck, 1 ); + return; + } + + // and execute any waiting functions + jQuery.ready(); +} + +// Expose jQuery to the global object +return (window.jQuery = window.$ = jQuery); + +})(); + + +(function() { + + jQuery.support = {}; + + var root = document.documentElement, + script = document.createElement("script"), + div = document.createElement("div"), + id = "script" + jQuery.now(); + + div.style.display = "none"; + div.innerHTML = "
a"; + + var all = div.getElementsByTagName("*"), + a = div.getElementsByTagName("a")[0], + select = document.createElement("select"), + opt = select.appendChild( document.createElement("option") ); + + // Can't get basic test support + if ( !all || !all.length || !a ) { + return; + } + + jQuery.support = { + // IE strips leading whitespace when .innerHTML is used + leadingWhitespace: div.firstChild.nodeType === 3, + + // Make sure that tbody elements aren't automatically inserted + // IE will insert them into empty tables + tbody: !div.getElementsByTagName("tbody").length, + + // Make sure that link elements get serialized correctly by innerHTML + // This requires a wrapper element in IE + htmlSerialize: !!div.getElementsByTagName("link").length, + + // Get the style information from getAttribute + // (IE uses .cssText insted) + style: /red/.test( a.getAttribute("style") ), + + // Make sure that URLs aren't manipulated + // (IE normalizes it by default) + hrefNormalized: a.getAttribute("href") === "/a", + + // Make sure that element opacity exists + // (IE uses filter instead) + // Use a regex to work around a WebKit issue. See #5145 + opacity: /^0.55$/.test( a.style.opacity ), + + // Verify style float existence + // (IE uses styleFloat instead of cssFloat) + cssFloat: !!a.style.cssFloat, + + // Make sure that if no value is specified for a checkbox + // that it defaults to "on". + // (WebKit defaults to "" instead) + checkOn: div.getElementsByTagName("input")[0].value === "on", + + // Make sure that a selected-by-default option has a working selected property. + // (WebKit defaults to false instead of true, IE too, if it's in an optgroup) + optSelected: opt.selected, + + // Will be defined later + deleteExpando: true, + optDisabled: false, + checkClone: false, + scriptEval: false, + noCloneEvent: true, + boxModel: null, + inlineBlockNeedsLayout: false, + shrinkWrapBlocks: false, + reliableHiddenOffsets: true + }; + + // Make sure that the options inside disabled selects aren't marked as disabled + // (WebKit marks them as diabled) + select.disabled = true; + jQuery.support.optDisabled = !opt.disabled; + + script.type = "text/javascript"; + try { + script.appendChild( document.createTextNode( "window." + id + "=1;" ) ); + } catch(e) {} + + root.insertBefore( script, root.firstChild ); + + // Make sure that the execution of code works by injecting a script + // tag with appendChild/createTextNode + // (IE doesn't support this, fails, and uses .text instead) + if ( window[ id ] ) { + jQuery.support.scriptEval = true; + delete window[ id ]; + } + + // Test to see if it's possible to delete an expando from an element + // Fails in Internet Explorer + try { + delete script.test; + + } catch(e) { + jQuery.support.deleteExpando = false; + } + + root.removeChild( script ); + + if ( div.attachEvent && div.fireEvent ) { + div.attachEvent("onclick", function click() { + // Cloning a node shouldn't copy over any + // bound event handlers (IE does this) + jQuery.support.noCloneEvent = false; + div.detachEvent("onclick", click); + }); + div.cloneNode(true).fireEvent("onclick"); + } + + div = document.createElement("div"); + div.innerHTML = ""; + + var fragment = document.createDocumentFragment(); + fragment.appendChild( div.firstChild ); + + // WebKit doesn't clone checked state correctly in fragments + jQuery.support.checkClone = fragment.cloneNode(true).cloneNode(true).lastChild.checked; + + // Figure out if the W3C box model works as expected + // document.body must exist before we can do this + jQuery(function() { + var div = document.createElement("div"); + div.style.width = div.style.paddingLeft = "1px"; + + document.body.appendChild( div ); + jQuery.boxModel = jQuery.support.boxModel = div.offsetWidth === 2; + + if ( "zoom" in div.style ) { + // Check if natively block-level elements act like inline-block + // elements when setting their display to 'inline' and giving + // them layout + // (IE < 8 does this) + div.style.display = "inline"; + div.style.zoom = 1; + jQuery.support.inlineBlockNeedsLayout = div.offsetWidth === 2; + + // Check if elements with layout shrink-wrap their children + // (IE 6 does this) + div.style.display = ""; + div.innerHTML = "
"; + jQuery.support.shrinkWrapBlocks = div.offsetWidth !== 2; + } + + div.innerHTML = "
t
"; + var tds = div.getElementsByTagName("td"); + + // Check if table cells still have offsetWidth/Height when they are set + // to display:none and there are still other visible table cells in a + // table row; if so, offsetWidth/Height are not reliable for use when + // determining if an element has been hidden directly using + // display:none (it is still safe to use offsets if a parent element is + // hidden; don safety goggles and see bug #4512 for more information). + // (only IE 8 fails this test) + jQuery.support.reliableHiddenOffsets = tds[0].offsetHeight === 0; + + tds[0].style.display = ""; + tds[1].style.display = "none"; + + // Check if empty table cells still have offsetWidth/Height + // (IE < 8 fail this test) + jQuery.support.reliableHiddenOffsets = jQuery.support.reliableHiddenOffsets && tds[0].offsetHeight === 0; + div.innerHTML = ""; + + document.body.removeChild( div ).style.display = "none"; + div = tds = null; + }); + + // Technique from Juriy Zaytsev + // http://thinkweb2.com/projects/prototype/detecting-event-support-without-browser-sniffing/ + var eventSupported = function( eventName ) { + var el = document.createElement("div"); + eventName = "on" + eventName; + + var isSupported = (eventName in el); + if ( !isSupported ) { + el.setAttribute(eventName, "return;"); + isSupported = typeof el[eventName] === "function"; + } + el = null; + + return isSupported; + }; + + jQuery.support.submitBubbles = eventSupported("submit"); + jQuery.support.changeBubbles = eventSupported("change"); + + // release memory in IE + root = script = div = all = a = null; +})(); + + + +var windowData = {}, + rbrace = /^(?:\{.*\}|\[.*\])$/; + +jQuery.extend({ + cache: {}, + + // Please use with caution + uuid: 0, + + // Unique for each copy of jQuery on the page + expando: "jQuery" + jQuery.now(), + + // The following elements throw uncatchable exceptions if you + // attempt to add expando properties to them. + noData: { + "embed": true, + // Ban all objects except for Flash (which handle expandos) + "object": "clsid:D27CDB6E-AE6D-11cf-96B8-444553540000", + "applet": true + }, + + data: function( elem, name, data ) { + if ( !jQuery.acceptData( elem ) ) { + return; + } + + elem = elem == window ? + windowData : + elem; + + var isNode = elem.nodeType, + id = isNode ? elem[ jQuery.expando ] : null, + cache = jQuery.cache, thisCache; + + if ( isNode && !id && typeof name === "string" && data === undefined ) { + return; + } + + // Get the data from the object directly + if ( !isNode ) { + cache = elem; + + // Compute a unique ID for the element + } else if ( !id ) { + elem[ jQuery.expando ] = id = ++jQuery.uuid; + } + + // Avoid generating a new cache unless none exists and we + // want to manipulate it. + if ( typeof name === "object" ) { + if ( isNode ) { + cache[ id ] = jQuery.extend(cache[ id ], name); + + } else { + jQuery.extend( cache, name ); + } + + } else if ( isNode && !cache[ id ] ) { + cache[ id ] = {}; + } + + thisCache = isNode ? cache[ id ] : cache; + + // Prevent overriding the named cache with undefined values + if ( data !== undefined ) { + thisCache[ name ] = data; + } + + return typeof name === "string" ? thisCache[ name ] : thisCache; + }, + + removeData: function( elem, name ) { + if ( !jQuery.acceptData( elem ) ) { + return; + } + + elem = elem == window ? + windowData : + elem; + + var isNode = elem.nodeType, + id = isNode ? elem[ jQuery.expando ] : elem, + cache = jQuery.cache, + thisCache = isNode ? cache[ id ] : id; + + // If we want to remove a specific section of the element's data + if ( name ) { + if ( thisCache ) { + // Remove the section of cache data + delete thisCache[ name ]; + + // If we've removed all the data, remove the element's cache + if ( isNode && jQuery.isEmptyObject(thisCache) ) { + jQuery.removeData( elem ); + } + } + + // Otherwise, we want to remove all of the element's data + } else { + if ( isNode && jQuery.support.deleteExpando ) { + delete elem[ jQuery.expando ]; + + } else if ( elem.removeAttribute ) { + elem.removeAttribute( jQuery.expando ); + + // Completely remove the data cache + } else if ( isNode ) { + delete cache[ id ]; + + // Remove all fields from the object + } else { + for ( var n in elem ) { + delete elem[ n ]; + } + } + } + }, + + // A method for determining if a DOM node can handle the data expando + acceptData: function( elem ) { + if ( elem.nodeName ) { + var match = jQuery.noData[ elem.nodeName.toLowerCase() ]; + + if ( match ) { + return !(match === true || elem.getAttribute("classid") !== match); + } + } + + return true; + } +}); + +jQuery.fn.extend({ + data: function( key, value ) { + var data = null; + + if ( typeof key === "undefined" ) { + if ( this.length ) { + var attr = this[0].attributes, name; + data = jQuery.data( this[0] ); + + for ( var i = 0, l = attr.length; i < l; i++ ) { + name = attr[i].name; + + if ( name.indexOf( "data-" ) === 0 ) { + name = name.substr( 5 ); + dataAttr( this[0], name, data[ name ] ); + } + } + } + + return data; + + } else if ( typeof key === "object" ) { + return this.each(function() { + jQuery.data( this, key ); + }); + } + + var parts = key.split("."); + parts[1] = parts[1] ? "." + parts[1] : ""; + + if ( value === undefined ) { + data = this.triggerHandler("getData" + parts[1] + "!", [parts[0]]); + + // Try to fetch any internally stored data first + if ( data === undefined && this.length ) { + data = jQuery.data( this[0], key ); + data = dataAttr( this[0], key, data ); + } + + return data === undefined && parts[1] ? + this.data( parts[0] ) : + data; + + } else { + return this.each(function() { + var $this = jQuery( this ), + args = [ parts[0], value ]; + + $this.triggerHandler( "setData" + parts[1] + "!", args ); + jQuery.data( this, key, value ); + $this.triggerHandler( "changeData" + parts[1] + "!", args ); + }); + } + }, + + removeData: function( key ) { + return this.each(function() { + jQuery.removeData( this, key ); + }); + } +}); + +function dataAttr( elem, key, data ) { + // If nothing was found internally, try to fetch any + // data from the HTML5 data-* attribute + if ( data === undefined && elem.nodeType === 1 ) { + data = elem.getAttribute( "data-" + key ); + + if ( typeof data === "string" ) { + try { + data = data === "true" ? true : + data === "false" ? false : + data === "null" ? null : + !jQuery.isNaN( data ) ? parseFloat( data ) : + rbrace.test( data ) ? jQuery.parseJSON( data ) : + data; + } catch( e ) {} + + // Make sure we set the data so it isn't changed later + jQuery.data( elem, key, data ); + + } else { + data = undefined; + } + } + + return data; +} + + + + +jQuery.extend({ + queue: function( elem, type, data ) { + if ( !elem ) { + return; + } + + type = (type || "fx") + "queue"; + var q = jQuery.data( elem, type ); + + // Speed up dequeue by getting out quickly if this is just a lookup + if ( !data ) { + return q || []; + } + + if ( !q || jQuery.isArray(data) ) { + q = jQuery.data( elem, type, jQuery.makeArray(data) ); + + } else { + q.push( data ); + } + + return q; + }, + + dequeue: function( elem, type ) { + type = type || "fx"; + + var queue = jQuery.queue( elem, type ), + fn = queue.shift(); + + // If the fx queue is dequeued, always remove the progress sentinel + if ( fn === "inprogress" ) { + fn = queue.shift(); + } + + if ( fn ) { + // Add a progress sentinel to prevent the fx queue from being + // automatically dequeued + if ( type === "fx" ) { + queue.unshift("inprogress"); + } + + fn.call(elem, function() { + jQuery.dequeue(elem, type); + }); + } + } +}); + +jQuery.fn.extend({ + queue: function( type, data ) { + if ( typeof type !== "string" ) { + data = type; + type = "fx"; + } + + if ( data === undefined ) { + return jQuery.queue( this[0], type ); + } + return this.each(function( i ) { + var queue = jQuery.queue( this, type, data ); + + if ( type === "fx" && queue[0] !== "inprogress" ) { + jQuery.dequeue( this, type ); + } + }); + }, + dequeue: function( type ) { + return this.each(function() { + jQuery.dequeue( this, type ); + }); + }, + + // Based off of the plugin by Clint Helfers, with permission. + // http://blindsignals.com/index.php/2009/07/jquery-delay/ + delay: function( time, type ) { + time = jQuery.fx ? jQuery.fx.speeds[time] || time : time; + type = type || "fx"; + + return this.queue( type, function() { + var elem = this; + setTimeout(function() { + jQuery.dequeue( elem, type ); + }, time ); + }); + }, + + clearQueue: function( type ) { + return this.queue( type || "fx", [] ); + } +}); + + + + +var rclass = /[\n\t]/g, + rspaces = /\s+/, + rreturn = /\r/g, + rspecialurl = /^(?:href|src|style)$/, + rtype = /^(?:button|input)$/i, + rfocusable = /^(?:button|input|object|select|textarea)$/i, + rclickable = /^a(?:rea)?$/i, + rradiocheck = /^(?:radio|checkbox)$/i; + +jQuery.props = { + "for": "htmlFor", + "class": "className", + readonly: "readOnly", + maxlength: "maxLength", + cellspacing: "cellSpacing", + rowspan: "rowSpan", + colspan: "colSpan", + tabindex: "tabIndex", + usemap: "useMap", + frameborder: "frameBorder" +}; + +jQuery.fn.extend({ + attr: function( name, value ) { + return jQuery.access( this, name, value, true, jQuery.attr ); + }, + + removeAttr: function( name, fn ) { + return this.each(function(){ + jQuery.attr( this, name, "" ); + if ( this.nodeType === 1 ) { + this.removeAttribute( name ); + } + }); + }, + + addClass: function( value ) { + if ( jQuery.isFunction(value) ) { + return this.each(function(i) { + var self = jQuery(this); + self.addClass( value.call(this, i, self.attr("class")) ); + }); + } + + if ( value && typeof value === "string" ) { + var classNames = (value || "").split( rspaces ); + + for ( var i = 0, l = this.length; i < l; i++ ) { + var elem = this[i]; + + if ( elem.nodeType === 1 ) { + if ( !elem.className ) { + elem.className = value; + + } else { + var className = " " + elem.className + " ", + setClass = elem.className; + + for ( var c = 0, cl = classNames.length; c < cl; c++ ) { + if ( className.indexOf( " " + classNames[c] + " " ) < 0 ) { + setClass += " " + classNames[c]; + } + } + elem.className = jQuery.trim( setClass ); + } + } + } + } + + return this; + }, + + removeClass: function( value ) { + if ( jQuery.isFunction(value) ) { + return this.each(function(i) { + var self = jQuery(this); + self.removeClass( value.call(this, i, self.attr("class")) ); + }); + } + + if ( (value && typeof value === "string") || value === undefined ) { + var classNames = (value || "").split( rspaces ); + + for ( var i = 0, l = this.length; i < l; i++ ) { + var elem = this[i]; + + if ( elem.nodeType === 1 && elem.className ) { + if ( value ) { + var className = (" " + elem.className + " ").replace(rclass, " "); + for ( var c = 0, cl = classNames.length; c < cl; c++ ) { + className = className.replace(" " + classNames[c] + " ", " "); + } + elem.className = jQuery.trim( className ); + + } else { + elem.className = ""; + } + } + } + } + + return this; + }, + + toggleClass: function( value, stateVal ) { + var type = typeof value, + isBool = typeof stateVal === "boolean"; + + if ( jQuery.isFunction( value ) ) { + return this.each(function(i) { + var self = jQuery(this); + self.toggleClass( value.call(this, i, self.attr("class"), stateVal), stateVal ); + }); + } + + return this.each(function() { + if ( type === "string" ) { + // toggle individual class names + var className, + i = 0, + self = jQuery( this ), + state = stateVal, + classNames = value.split( rspaces ); + + while ( (className = classNames[ i++ ]) ) { + // check each className given, space seperated list + state = isBool ? state : !self.hasClass( className ); + self[ state ? "addClass" : "removeClass" ]( className ); + } + + } else if ( type === "undefined" || type === "boolean" ) { + if ( this.className ) { + // store className if set + jQuery.data( this, "__className__", this.className ); + } + + // toggle whole className + this.className = this.className || value === false ? "" : jQuery.data( this, "__className__" ) || ""; + } + }); + }, + + hasClass: function( selector ) { + var className = " " + selector + " "; + for ( var i = 0, l = this.length; i < l; i++ ) { + if ( (" " + this[i].className + " ").replace(rclass, " ").indexOf( className ) > -1 ) { + return true; + } + } + + return false; + }, + + val: function( value ) { + if ( !arguments.length ) { + var elem = this[0]; + + if ( elem ) { + if ( jQuery.nodeName( elem, "option" ) ) { + // attributes.value is undefined in Blackberry 4.7 but + // uses .value. See #6932 + var val = elem.attributes.value; + return !val || val.specified ? elem.value : elem.text; + } + + // We need to handle select boxes special + if ( jQuery.nodeName( elem, "select" ) ) { + var index = elem.selectedIndex, + values = [], + options = elem.options, + one = elem.type === "select-one"; + + // Nothing was selected + if ( index < 0 ) { + return null; + } + + // Loop through all the selected options + for ( var i = one ? index : 0, max = one ? index + 1 : options.length; i < max; i++ ) { + var option = options[ i ]; + + // Don't return options that are disabled or in a disabled optgroup + if ( option.selected && (jQuery.support.optDisabled ? !option.disabled : option.getAttribute("disabled") === null) && + (!option.parentNode.disabled || !jQuery.nodeName( option.parentNode, "optgroup" )) ) { + + // Get the specific value for the option + value = jQuery(option).val(); + + // We don't need an array for one selects + if ( one ) { + return value; + } + + // Multi-Selects return an array + values.push( value ); + } + } + + return values; + } + + // Handle the case where in Webkit "" is returned instead of "on" if a value isn't specified + if ( rradiocheck.test( elem.type ) && !jQuery.support.checkOn ) { + return elem.getAttribute("value") === null ? "on" : elem.value; + } + + + // Everything else, we just grab the value + return (elem.value || "").replace(rreturn, ""); + + } + + return undefined; + } + + var isFunction = jQuery.isFunction(value); + + return this.each(function(i) { + var self = jQuery(this), val = value; + + if ( this.nodeType !== 1 ) { + return; + } + + if ( isFunction ) { + val = value.call(this, i, self.val()); + } + + // Treat null/undefined as ""; convert numbers to string + if ( val == null ) { + val = ""; + } else if ( typeof val === "number" ) { + val += ""; + } else if ( jQuery.isArray(val) ) { + val = jQuery.map(val, function (value) { + return value == null ? "" : value + ""; + }); + } + + if ( jQuery.isArray(val) && rradiocheck.test( this.type ) ) { + this.checked = jQuery.inArray( self.val(), val ) >= 0; + + } else if ( jQuery.nodeName( this, "select" ) ) { + var values = jQuery.makeArray(val); + + jQuery( "option", this ).each(function() { + this.selected = jQuery.inArray( jQuery(this).val(), values ) >= 0; + }); + + if ( !values.length ) { + this.selectedIndex = -1; + } + + } else { + this.value = val; + } + }); + } +}); + +jQuery.extend({ + attrFn: { + val: true, + css: true, + html: true, + text: true, + data: true, + width: true, + height: true, + offset: true + }, + + attr: function( elem, name, value, pass ) { + // don't set attributes on text and comment nodes + if ( !elem || elem.nodeType === 3 || elem.nodeType === 8 ) { + return undefined; + } + + if ( pass && name in jQuery.attrFn ) { + return jQuery(elem)[name](value); + } + + var notxml = elem.nodeType !== 1 || !jQuery.isXMLDoc( elem ), + // Whether we are setting (or getting) + set = value !== undefined; + + // Try to normalize/fix the name + name = notxml && jQuery.props[ name ] || name; + + // These attributes require special treatment + var special = rspecialurl.test( name ); + + // Safari mis-reports the default selected property of an option + // Accessing the parent's selectedIndex property fixes it + if ( name === "selected" && !jQuery.support.optSelected ) { + var parent = elem.parentNode; + if ( parent ) { + parent.selectedIndex; + + // Make sure that it also works with optgroups, see #5701 + if ( parent.parentNode ) { + parent.parentNode.selectedIndex; + } + } + } + + // If applicable, access the attribute via the DOM 0 way + // 'in' checks fail in Blackberry 4.7 #6931 + if ( (name in elem || elem[ name ] !== undefined) && notxml && !special ) { + if ( set ) { + // We can't allow the type property to be changed (since it causes problems in IE) + if ( name === "type" && rtype.test( elem.nodeName ) && elem.parentNode ) { + jQuery.error( "type property can't be changed" ); + } + + if ( value === null ) { + if ( elem.nodeType === 1 ) { + elem.removeAttribute( name ); + } + + } else { + elem[ name ] = value; + } + } + + // browsers index elements by id/name on forms, give priority to attributes. + if ( jQuery.nodeName( elem, "form" ) && elem.getAttributeNode(name) ) { + return elem.getAttributeNode( name ).nodeValue; + } + + // elem.tabIndex doesn't always return the correct value when it hasn't been explicitly set + // http://fluidproject.org/blog/2008/01/09/getting-setting-and-removing-tabindex-values-with-javascript/ + if ( name === "tabIndex" ) { + var attributeNode = elem.getAttributeNode( "tabIndex" ); + + return attributeNode && attributeNode.specified ? + attributeNode.value : + rfocusable.test( elem.nodeName ) || rclickable.test( elem.nodeName ) && elem.href ? + 0 : + undefined; + } + + return elem[ name ]; + } + + if ( !jQuery.support.style && notxml && name === "style" ) { + if ( set ) { + elem.style.cssText = "" + value; + } + + return elem.style.cssText; + } + + if ( set ) { + // convert the value to a string (all browsers do this but IE) see #1070 + elem.setAttribute( name, "" + value ); + } + + // Ensure that missing attributes return undefined + // Blackberry 4.7 returns "" from getAttribute #6938 + if ( !elem.attributes[ name ] && (elem.hasAttribute && !elem.hasAttribute( name )) ) { + return undefined; + } + + var attr = !jQuery.support.hrefNormalized && notxml && special ? + // Some attributes require a special call on IE + elem.getAttribute( name, 2 ) : + elem.getAttribute( name ); + + // Non-existent attributes return null, we normalize to undefined + return attr === null ? undefined : attr; + } +}); + + + + +var rnamespaces = /\.(.*)$/, + rformElems = /^(?:textarea|input|select)$/i, + rperiod = /\./g, + rspace = / /g, + rescape = /[^\w\s.|`]/g, + fcleanup = function( nm ) { + return nm.replace(rescape, "\\$&"); + }, + focusCounts = { focusin: 0, focusout: 0 }; + +/* + * A number of helper functions used for managing events. + * Many of the ideas behind this code originated from + * Dean Edwards' addEvent library. + */ +jQuery.event = { + + // Bind an event to an element + // Original by Dean Edwards + add: function( elem, types, handler, data ) { + if ( elem.nodeType === 3 || elem.nodeType === 8 ) { + return; + } + + // For whatever reason, IE has trouble passing the window object + // around, causing it to be cloned in the process + if ( jQuery.isWindow( elem ) && ( elem !== window && !elem.frameElement ) ) { + elem = window; + } + + if ( handler === false ) { + handler = returnFalse; + } else if ( !handler ) { + // Fixes bug #7229. Fix recommended by jdalton + return; + } + + var handleObjIn, handleObj; + + if ( handler.handler ) { + handleObjIn = handler; + handler = handleObjIn.handler; + } + + // Make sure that the function being executed has a unique ID + if ( !handler.guid ) { + handler.guid = jQuery.guid++; + } + + // Init the element's event structure + var elemData = jQuery.data( elem ); + + // If no elemData is found then we must be trying to bind to one of the + // banned noData elements + if ( !elemData ) { + return; + } + + // Use a key less likely to result in collisions for plain JS objects. + // Fixes bug #7150. + var eventKey = elem.nodeType ? "events" : "__events__", + events = elemData[ eventKey ], + eventHandle = elemData.handle; + + if ( typeof events === "function" ) { + // On plain objects events is a fn that holds the the data + // which prevents this data from being JSON serialized + // the function does not need to be called, it just contains the data + eventHandle = events.handle; + events = events.events; + + } else if ( !events ) { + if ( !elem.nodeType ) { + // On plain objects, create a fn that acts as the holder + // of the values to avoid JSON serialization of event data + elemData[ eventKey ] = elemData = function(){}; + } + + elemData.events = events = {}; + } + + if ( !eventHandle ) { + elemData.handle = eventHandle = function() { + // Handle the second event of a trigger and when + // an event is called after a page has unloaded + return typeof jQuery !== "undefined" && !jQuery.event.triggered ? + jQuery.event.handle.apply( eventHandle.elem, arguments ) : + undefined; + }; + } + + // Add elem as a property of the handle function + // This is to prevent a memory leak with non-native events in IE. + eventHandle.elem = elem; + + // Handle multiple events separated by a space + // jQuery(...).bind("mouseover mouseout", fn); + types = types.split(" "); + + var type, i = 0, namespaces; + + while ( (type = types[ i++ ]) ) { + handleObj = handleObjIn ? + jQuery.extend({}, handleObjIn) : + { handler: handler, data: data }; + + // Namespaced event handlers + if ( type.indexOf(".") > -1 ) { + namespaces = type.split("."); + type = namespaces.shift(); + handleObj.namespace = namespaces.slice(0).sort().join("."); + + } else { + namespaces = []; + handleObj.namespace = ""; + } + + handleObj.type = type; + if ( !handleObj.guid ) { + handleObj.guid = handler.guid; + } + + // Get the current list of functions bound to this event + var handlers = events[ type ], + special = jQuery.event.special[ type ] || {}; + + // Init the event handler queue + if ( !handlers ) { + handlers = events[ type ] = []; + + // Check for a special event handler + // Only use addEventListener/attachEvent if the special + // events handler returns false + if ( !special.setup || special.setup.call( elem, data, namespaces, eventHandle ) === false ) { + // Bind the global event handler to the element + if ( elem.addEventListener ) { + elem.addEventListener( type, eventHandle, false ); + + } else if ( elem.attachEvent ) { + elem.attachEvent( "on" + type, eventHandle ); + } + } + } + + if ( special.add ) { + special.add.call( elem, handleObj ); + + if ( !handleObj.handler.guid ) { + handleObj.handler.guid = handler.guid; + } + } + + // Add the function to the element's handler list + handlers.push( handleObj ); + + // Keep track of which events have been used, for global triggering + jQuery.event.global[ type ] = true; + } + + // Nullify elem to prevent memory leaks in IE + elem = null; + }, + + global: {}, + + // Detach an event or set of events from an element + remove: function( elem, types, handler, pos ) { + // don't do events on text and comment nodes + if ( elem.nodeType === 3 || elem.nodeType === 8 ) { + return; + } + + if ( handler === false ) { + handler = returnFalse; + } + + var ret, type, fn, j, i = 0, all, namespaces, namespace, special, eventType, handleObj, origType, + eventKey = elem.nodeType ? "events" : "__events__", + elemData = jQuery.data( elem ), + events = elemData && elemData[ eventKey ]; + + if ( !elemData || !events ) { + return; + } + + if ( typeof events === "function" ) { + elemData = events; + events = events.events; + } + + // types is actually an event object here + if ( types && types.type ) { + handler = types.handler; + types = types.type; + } + + // Unbind all events for the element + if ( !types || typeof types === "string" && types.charAt(0) === "." ) { + types = types || ""; + + for ( type in events ) { + jQuery.event.remove( elem, type + types ); + } + + return; + } + + // Handle multiple events separated by a space + // jQuery(...).unbind("mouseover mouseout", fn); + types = types.split(" "); + + while ( (type = types[ i++ ]) ) { + origType = type; + handleObj = null; + all = type.indexOf(".") < 0; + namespaces = []; + + if ( !all ) { + // Namespaced event handlers + namespaces = type.split("."); + type = namespaces.shift(); + + namespace = new RegExp("(^|\\.)" + + jQuery.map( namespaces.slice(0).sort(), fcleanup ).join("\\.(?:.*\\.)?") + "(\\.|$)"); + } + + eventType = events[ type ]; + + if ( !eventType ) { + continue; + } + + if ( !handler ) { + for ( j = 0; j < eventType.length; j++ ) { + handleObj = eventType[ j ]; + + if ( all || namespace.test( handleObj.namespace ) ) { + jQuery.event.remove( elem, origType, handleObj.handler, j ); + eventType.splice( j--, 1 ); + } + } + + continue; + } + + special = jQuery.event.special[ type ] || {}; + + for ( j = pos || 0; j < eventType.length; j++ ) { + handleObj = eventType[ j ]; + + if ( handler.guid === handleObj.guid ) { + // remove the given handler for the given type + if ( all || namespace.test( handleObj.namespace ) ) { + if ( pos == null ) { + eventType.splice( j--, 1 ); + } + + if ( special.remove ) { + special.remove.call( elem, handleObj ); + } + } + + if ( pos != null ) { + break; + } + } + } + + // remove generic event handler if no more handlers exist + if ( eventType.length === 0 || pos != null && eventType.length === 1 ) { + if ( !special.teardown || special.teardown.call( elem, namespaces ) === false ) { + jQuery.removeEvent( elem, type, elemData.handle ); + } + + ret = null; + delete events[ type ]; + } + } + + // Remove the expando if it's no longer used + if ( jQuery.isEmptyObject( events ) ) { + var handle = elemData.handle; + if ( handle ) { + handle.elem = null; + } + + delete elemData.events; + delete elemData.handle; + + if ( typeof elemData === "function" ) { + jQuery.removeData( elem, eventKey ); + + } else if ( jQuery.isEmptyObject( elemData ) ) { + jQuery.removeData( elem ); + } + } + }, + + // bubbling is internal + trigger: function( event, data, elem /*, bubbling */ ) { + // Event object or event type + var type = event.type || event, + bubbling = arguments[3]; + + if ( !bubbling ) { + event = typeof event === "object" ? + // jQuery.Event object + event[ jQuery.expando ] ? event : + // Object literal + jQuery.extend( jQuery.Event(type), event ) : + // Just the event type (string) + jQuery.Event(type); + + if ( type.indexOf("!") >= 0 ) { + event.type = type = type.slice(0, -1); + event.exclusive = true; + } + + // Handle a global trigger + if ( !elem ) { + // Don't bubble custom events when global (to avoid too much overhead) + event.stopPropagation(); + + // Only trigger if we've ever bound an event for it + if ( jQuery.event.global[ type ] ) { + jQuery.each( jQuery.cache, function() { + if ( this.events && this.events[type] ) { + jQuery.event.trigger( event, data, this.handle.elem ); + } + }); + } + } + + // Handle triggering a single element + + // don't do events on text and comment nodes + if ( !elem || elem.nodeType === 3 || elem.nodeType === 8 ) { + return undefined; + } + + // Clean up in case it is reused + event.result = undefined; + event.target = elem; + + // Clone the incoming data, if any + data = jQuery.makeArray( data ); + data.unshift( event ); + } + + event.currentTarget = elem; + + // Trigger the event, it is assumed that "handle" is a function + var handle = elem.nodeType ? + jQuery.data( elem, "handle" ) : + (jQuery.data( elem, "__events__" ) || {}).handle; + + if ( handle ) { + handle.apply( elem, data ); + } + + var parent = elem.parentNode || elem.ownerDocument; + + // Trigger an inline bound script + try { + if ( !(elem && elem.nodeName && jQuery.noData[elem.nodeName.toLowerCase()]) ) { + if ( elem[ "on" + type ] && elem[ "on" + type ].apply( elem, data ) === false ) { + event.result = false; + event.preventDefault(); + } + } + + // prevent IE from throwing an error for some elements with some event types, see #3533 + } catch (inlineError) {} + + if ( !event.isPropagationStopped() && parent ) { + jQuery.event.trigger( event, data, parent, true ); + + } else if ( !event.isDefaultPrevented() ) { + var old, + target = event.target, + targetType = type.replace( rnamespaces, "" ), + isClick = jQuery.nodeName( target, "a" ) && targetType === "click", + special = jQuery.event.special[ targetType ] || {}; + + if ( (!special._default || special._default.call( elem, event ) === false) && + !isClick && !(target && target.nodeName && jQuery.noData[target.nodeName.toLowerCase()]) ) { + + try { + if ( target[ targetType ] ) { + // Make sure that we don't accidentally re-trigger the onFOO events + old = target[ "on" + targetType ]; + + if ( old ) { + target[ "on" + targetType ] = null; + } + + jQuery.event.triggered = true; + target[ targetType ](); + } + + // prevent IE from throwing an error for some elements with some event types, see #3533 + } catch (triggerError) {} + + if ( old ) { + target[ "on" + targetType ] = old; + } + + jQuery.event.triggered = false; + } + } + }, + + handle: function( event ) { + var all, handlers, namespaces, namespace_re, events, + namespace_sort = [], + args = jQuery.makeArray( arguments ); + + event = args[0] = jQuery.event.fix( event || window.event ); + event.currentTarget = this; + + // Namespaced event handlers + all = event.type.indexOf(".") < 0 && !event.exclusive; + + if ( !all ) { + namespaces = event.type.split("."); + event.type = namespaces.shift(); + namespace_sort = namespaces.slice(0).sort(); + namespace_re = new RegExp("(^|\\.)" + namespace_sort.join("\\.(?:.*\\.)?") + "(\\.|$)"); + } + + event.namespace = event.namespace || namespace_sort.join("."); + + events = jQuery.data(this, this.nodeType ? "events" : "__events__"); + + if ( typeof events === "function" ) { + events = events.events; + } + + handlers = (events || {})[ event.type ]; + + if ( events && handlers ) { + // Clone the handlers to prevent manipulation + handlers = handlers.slice(0); + + for ( var j = 0, l = handlers.length; j < l; j++ ) { + var handleObj = handlers[ j ]; + + // Filter the functions by class + if ( all || namespace_re.test( handleObj.namespace ) ) { + // Pass in a reference to the handler function itself + // So that we can later remove it + event.handler = handleObj.handler; + event.data = handleObj.data; + event.handleObj = handleObj; + + var ret = handleObj.handler.apply( this, args ); + + if ( ret !== undefined ) { + event.result = ret; + if ( ret === false ) { + event.preventDefault(); + event.stopPropagation(); + } + } + + if ( event.isImmediatePropagationStopped() ) { + break; + } + } + } + } + + return event.result; + }, + + props: "altKey attrChange attrName bubbles button cancelable charCode clientX clientY ctrlKey currentTarget data detail eventPhase fromElement handler keyCode layerX layerY metaKey newValue offsetX offsetY pageX pageY prevValue relatedNode relatedTarget screenX screenY shiftKey srcElement target toElement view wheelDelta which".split(" "), + + fix: function( event ) { + if ( event[ jQuery.expando ] ) { + return event; + } + + // store a copy of the original event object + // and "clone" to set read-only properties + var originalEvent = event; + event = jQuery.Event( originalEvent ); + + for ( var i = this.props.length, prop; i; ) { + prop = this.props[ --i ]; + event[ prop ] = originalEvent[ prop ]; + } + + // Fix target property, if necessary + if ( !event.target ) { + // Fixes #1925 where srcElement might not be defined either + event.target = event.srcElement || document; + } + + // check if target is a textnode (safari) + if ( event.target.nodeType === 3 ) { + event.target = event.target.parentNode; + } + + // Add relatedTarget, if necessary + if ( !event.relatedTarget && event.fromElement ) { + event.relatedTarget = event.fromElement === event.target ? event.toElement : event.fromElement; + } + + // Calculate pageX/Y if missing and clientX/Y available + if ( event.pageX == null && event.clientX != null ) { + var doc = document.documentElement, + body = document.body; + + event.pageX = event.clientX + (doc && doc.scrollLeft || body && body.scrollLeft || 0) - (doc && doc.clientLeft || body && body.clientLeft || 0); + event.pageY = event.clientY + (doc && doc.scrollTop || body && body.scrollTop || 0) - (doc && doc.clientTop || body && body.clientTop || 0); + } + + // Add which for key events + if ( event.which == null && (event.charCode != null || event.keyCode != null) ) { + event.which = event.charCode != null ? event.charCode : event.keyCode; + } + + // Add metaKey to non-Mac browsers (use ctrl for PC's and Meta for Macs) + if ( !event.metaKey && event.ctrlKey ) { + event.metaKey = event.ctrlKey; + } + + // Add which for click: 1 === left; 2 === middle; 3 === right + // Note: button is not normalized, so don't use it + if ( !event.which && event.button !== undefined ) { + event.which = (event.button & 1 ? 1 : ( event.button & 2 ? 3 : ( event.button & 4 ? 2 : 0 ) )); + } + + return event; + }, + + // Deprecated, use jQuery.guid instead + guid: 1E8, + + // Deprecated, use jQuery.proxy instead + proxy: jQuery.proxy, + + special: { + ready: { + // Make sure the ready event is setup + setup: jQuery.bindReady, + teardown: jQuery.noop + }, + + live: { + add: function( handleObj ) { + jQuery.event.add( this, + liveConvert( handleObj.origType, handleObj.selector ), + jQuery.extend({}, handleObj, {handler: liveHandler, guid: handleObj.handler.guid}) ); + }, + + remove: function( handleObj ) { + jQuery.event.remove( this, liveConvert( handleObj.origType, handleObj.selector ), handleObj ); + } + }, + + beforeunload: { + setup: function( data, namespaces, eventHandle ) { + // We only want to do this special case on windows + if ( jQuery.isWindow( this ) ) { + this.onbeforeunload = eventHandle; + } + }, + + teardown: function( namespaces, eventHandle ) { + if ( this.onbeforeunload === eventHandle ) { + this.onbeforeunload = null; + } + } + } + } +}; + +jQuery.removeEvent = document.removeEventListener ? + function( elem, type, handle ) { + if ( elem.removeEventListener ) { + elem.removeEventListener( type, handle, false ); + } + } : + function( elem, type, handle ) { + if ( elem.detachEvent ) { + elem.detachEvent( "on" + type, handle ); + } + }; + +jQuery.Event = function( src ) { + // Allow instantiation without the 'new' keyword + if ( !this.preventDefault ) { + return new jQuery.Event( src ); + } + + // Event object + if ( src && src.type ) { + this.originalEvent = src; + this.type = src.type; + // Event type + } else { + this.type = src; + } + + // timeStamp is buggy for some events on Firefox(#3843) + // So we won't rely on the native value + this.timeStamp = jQuery.now(); + + // Mark it as fixed + this[ jQuery.expando ] = true; +}; + +function returnFalse() { + return false; +} +function returnTrue() { + return true; +} + +// jQuery.Event is based on DOM3 Events as specified by the ECMAScript Language Binding +// http://www.w3.org/TR/2003/WD-DOM-Level-3-Events-20030331/ecma-script-binding.html +jQuery.Event.prototype = { + preventDefault: function() { + this.isDefaultPrevented = returnTrue; + + var e = this.originalEvent; + if ( !e ) { + return; + } + + // if preventDefault exists run it on the original event + if ( e.preventDefault ) { + e.preventDefault(); + + // otherwise set the returnValue property of the original event to false (IE) + } else { + e.returnValue = false; + } + }, + stopPropagation: function() { + this.isPropagationStopped = returnTrue; + + var e = this.originalEvent; + if ( !e ) { + return; + } + // if stopPropagation exists run it on the original event + if ( e.stopPropagation ) { + e.stopPropagation(); + } + // otherwise set the cancelBubble property of the original event to true (IE) + e.cancelBubble = true; + }, + stopImmediatePropagation: function() { + this.isImmediatePropagationStopped = returnTrue; + this.stopPropagation(); + }, + isDefaultPrevented: returnFalse, + isPropagationStopped: returnFalse, + isImmediatePropagationStopped: returnFalse +}; + +// Checks if an event happened on an element within another element +// Used in jQuery.event.special.mouseenter and mouseleave handlers +var withinElement = function( event ) { + // Check if mouse(over|out) are still within the same parent element + var parent = event.relatedTarget; + + // Firefox sometimes assigns relatedTarget a XUL element + // which we cannot access the parentNode property of + try { + // Traverse up the tree + while ( parent && parent !== this ) { + parent = parent.parentNode; + } + + if ( parent !== this ) { + // set the correct event type + event.type = event.data; + + // handle event if we actually just moused on to a non sub-element + jQuery.event.handle.apply( this, arguments ); + } + + // assuming we've left the element since we most likely mousedover a xul element + } catch(e) { } +}, + +// In case of event delegation, we only need to rename the event.type, +// liveHandler will take care of the rest. +delegate = function( event ) { + event.type = event.data; + jQuery.event.handle.apply( this, arguments ); +}; + +// Create mouseenter and mouseleave events +jQuery.each({ + mouseenter: "mouseover", + mouseleave: "mouseout" +}, function( orig, fix ) { + jQuery.event.special[ orig ] = { + setup: function( data ) { + jQuery.event.add( this, fix, data && data.selector ? delegate : withinElement, orig ); + }, + teardown: function( data ) { + jQuery.event.remove( this, fix, data && data.selector ? delegate : withinElement ); + } + }; +}); + +// submit delegation +if ( !jQuery.support.submitBubbles ) { + + jQuery.event.special.submit = { + setup: function( data, namespaces ) { + if ( this.nodeName.toLowerCase() !== "form" ) { + jQuery.event.add(this, "click.specialSubmit", function( e ) { + var elem = e.target, + type = elem.type; + + if ( (type === "submit" || type === "image") && jQuery( elem ).closest("form").length ) { + e.liveFired = undefined; + return trigger( "submit", this, arguments ); + } + }); + + jQuery.event.add(this, "keypress.specialSubmit", function( e ) { + var elem = e.target, + type = elem.type; + + if ( (type === "text" || type === "password") && jQuery( elem ).closest("form").length && e.keyCode === 13 ) { + e.liveFired = undefined; + return trigger( "submit", this, arguments ); + } + }); + + } else { + return false; + } + }, + + teardown: function( namespaces ) { + jQuery.event.remove( this, ".specialSubmit" ); + } + }; + +} + +// change delegation, happens here so we have bind. +if ( !jQuery.support.changeBubbles ) { + + var changeFilters, + + getVal = function( elem ) { + var type = elem.type, val = elem.value; + + if ( type === "radio" || type === "checkbox" ) { + val = elem.checked; + + } else if ( type === "select-multiple" ) { + val = elem.selectedIndex > -1 ? + jQuery.map( elem.options, function( elem ) { + return elem.selected; + }).join("-") : + ""; + + } else if ( elem.nodeName.toLowerCase() === "select" ) { + val = elem.selectedIndex; + } + + return val; + }, + + testChange = function testChange( e ) { + var elem = e.target, data, val; + + if ( !rformElems.test( elem.nodeName ) || elem.readOnly ) { + return; + } + + data = jQuery.data( elem, "_change_data" ); + val = getVal(elem); + + // the current data will be also retrieved by beforeactivate + if ( e.type !== "focusout" || elem.type !== "radio" ) { + jQuery.data( elem, "_change_data", val ); + } + + if ( data === undefined || val === data ) { + return; + } + + if ( data != null || val ) { + e.type = "change"; + e.liveFired = undefined; + return jQuery.event.trigger( e, arguments[1], elem ); + } + }; + + jQuery.event.special.change = { + filters: { + focusout: testChange, + + beforedeactivate: testChange, + + click: function( e ) { + var elem = e.target, type = elem.type; + + if ( type === "radio" || type === "checkbox" || elem.nodeName.toLowerCase() === "select" ) { + return testChange.call( this, e ); + } + }, + + // Change has to be called before submit + // Keydown will be called before keypress, which is used in submit-event delegation + keydown: function( e ) { + var elem = e.target, type = elem.type; + + if ( (e.keyCode === 13 && elem.nodeName.toLowerCase() !== "textarea") || + (e.keyCode === 32 && (type === "checkbox" || type === "radio")) || + type === "select-multiple" ) { + return testChange.call( this, e ); + } + }, + + // Beforeactivate happens also before the previous element is blurred + // with this event you can't trigger a change event, but you can store + // information + beforeactivate: function( e ) { + var elem = e.target; + jQuery.data( elem, "_change_data", getVal(elem) ); + } + }, + + setup: function( data, namespaces ) { + if ( this.type === "file" ) { + return false; + } + + for ( var type in changeFilters ) { + jQuery.event.add( this, type + ".specialChange", changeFilters[type] ); + } + + return rformElems.test( this.nodeName ); + }, + + teardown: function( namespaces ) { + jQuery.event.remove( this, ".specialChange" ); + + return rformElems.test( this.nodeName ); + } + }; + + changeFilters = jQuery.event.special.change.filters; + + // Handle when the input is .focus()'d + changeFilters.focus = changeFilters.beforeactivate; +} + +function trigger( type, elem, args ) { + args[0].type = type; + return jQuery.event.handle.apply( elem, args ); +} + +// Create "bubbling" focus and blur events +if ( document.addEventListener ) { + jQuery.each({ focus: "focusin", blur: "focusout" }, function( orig, fix ) { + jQuery.event.special[ fix ] = { + setup: function() { + if ( focusCounts[fix]++ === 0 ) { + document.addEventListener( orig, handler, true ); + } + }, + teardown: function() { + if ( --focusCounts[fix] === 0 ) { + document.removeEventListener( orig, handler, true ); + } + } + }; + + function handler( e ) { + e = jQuery.event.fix( e ); + e.type = fix; + return jQuery.event.trigger( e, null, e.target ); + } + }); +} + +jQuery.each(["bind", "one"], function( i, name ) { + jQuery.fn[ name ] = function( type, data, fn ) { + // Handle object literals + if ( typeof type === "object" ) { + for ( var key in type ) { + this[ name ](key, data, type[key], fn); + } + return this; + } + + if ( jQuery.isFunction( data ) || data === false ) { + fn = data; + data = undefined; + } + + var handler = name === "one" ? jQuery.proxy( fn, function( event ) { + jQuery( this ).unbind( event, handler ); + return fn.apply( this, arguments ); + }) : fn; + + if ( type === "unload" && name !== "one" ) { + this.one( type, data, fn ); + + } else { + for ( var i = 0, l = this.length; i < l; i++ ) { + jQuery.event.add( this[i], type, handler, data ); + } + } + + return this; + }; +}); + +jQuery.fn.extend({ + unbind: function( type, fn ) { + // Handle object literals + if ( typeof type === "object" && !type.preventDefault ) { + for ( var key in type ) { + this.unbind(key, type[key]); + } + + } else { + for ( var i = 0, l = this.length; i < l; i++ ) { + jQuery.event.remove( this[i], type, fn ); + } + } + + return this; + }, + + delegate: function( selector, types, data, fn ) { + return this.live( types, data, fn, selector ); + }, + + undelegate: function( selector, types, fn ) { + if ( arguments.length === 0 ) { + return this.unbind( "live" ); + + } else { + return this.die( types, null, fn, selector ); + } + }, + + trigger: function( type, data ) { + return this.each(function() { + jQuery.event.trigger( type, data, this ); + }); + }, + + triggerHandler: function( type, data ) { + if ( this[0] ) { + var event = jQuery.Event( type ); + event.preventDefault(); + event.stopPropagation(); + jQuery.event.trigger( event, data, this[0] ); + return event.result; + } + }, + + toggle: function( fn ) { + // Save reference to arguments for access in closure + var args = arguments, + i = 1; + + // link all the functions, so any of them can unbind this click handler + while ( i < args.length ) { + jQuery.proxy( fn, args[ i++ ] ); + } + + return this.click( jQuery.proxy( fn, function( event ) { + // Figure out which function to execute + var lastToggle = ( jQuery.data( this, "lastToggle" + fn.guid ) || 0 ) % i; + jQuery.data( this, "lastToggle" + fn.guid, lastToggle + 1 ); + + // Make sure that clicks stop + event.preventDefault(); + + // and execute the function + return args[ lastToggle ].apply( this, arguments ) || false; + })); + }, + + hover: function( fnOver, fnOut ) { + return this.mouseenter( fnOver ).mouseleave( fnOut || fnOver ); + } +}); + +var liveMap = { + focus: "focusin", + blur: "focusout", + mouseenter: "mouseover", + mouseleave: "mouseout" +}; + +jQuery.each(["live", "die"], function( i, name ) { + jQuery.fn[ name ] = function( types, data, fn, origSelector /* Internal Use Only */ ) { + var type, i = 0, match, namespaces, preType, + selector = origSelector || this.selector, + context = origSelector ? this : jQuery( this.context ); + + if ( typeof types === "object" && !types.preventDefault ) { + for ( var key in types ) { + context[ name ]( key, data, types[key], selector ); + } + + return this; + } + + if ( jQuery.isFunction( data ) ) { + fn = data; + data = undefined; + } + + types = (types || "").split(" "); + + while ( (type = types[ i++ ]) != null ) { + match = rnamespaces.exec( type ); + namespaces = ""; + + if ( match ) { + namespaces = match[0]; + type = type.replace( rnamespaces, "" ); + } + + if ( type === "hover" ) { + types.push( "mouseenter" + namespaces, "mouseleave" + namespaces ); + continue; + } + + preType = type; + + if ( type === "focus" || type === "blur" ) { + types.push( liveMap[ type ] + namespaces ); + type = type + namespaces; + + } else { + type = (liveMap[ type ] || type) + namespaces; + } + + if ( name === "live" ) { + // bind live handler + for ( var j = 0, l = context.length; j < l; j++ ) { + jQuery.event.add( context[j], "live." + liveConvert( type, selector ), + { data: data, selector: selector, handler: fn, origType: type, origHandler: fn, preType: preType } ); + } + + } else { + // unbind live handler + context.unbind( "live." + liveConvert( type, selector ), fn ); + } + } + + return this; + }; +}); + +function liveHandler( event ) { + var stop, maxLevel, related, match, handleObj, elem, j, i, l, data, close, namespace, ret, + elems = [], + selectors = [], + events = jQuery.data( this, this.nodeType ? "events" : "__events__" ); + + if ( typeof events === "function" ) { + events = events.events; + } + + // Make sure we avoid non-left-click bubbling in Firefox (#3861) + if ( event.liveFired === this || !events || !events.live || event.button && event.type === "click" ) { + return; + } + + if ( event.namespace ) { + namespace = new RegExp("(^|\\.)" + event.namespace.split(".").join("\\.(?:.*\\.)?") + "(\\.|$)"); + } + + event.liveFired = this; + + var live = events.live.slice(0); + + for ( j = 0; j < live.length; j++ ) { + handleObj = live[j]; + + if ( handleObj.origType.replace( rnamespaces, "" ) === event.type ) { + selectors.push( handleObj.selector ); + + } else { + live.splice( j--, 1 ); + } + } + + match = jQuery( event.target ).closest( selectors, event.currentTarget ); + + for ( i = 0, l = match.length; i < l; i++ ) { + close = match[i]; + + for ( j = 0; j < live.length; j++ ) { + handleObj = live[j]; + + if ( close.selector === handleObj.selector && (!namespace || namespace.test( handleObj.namespace )) ) { + elem = close.elem; + related = null; + + // Those two events require additional checking + if ( handleObj.preType === "mouseenter" || handleObj.preType === "mouseleave" ) { + event.type = handleObj.preType; + related = jQuery( event.relatedTarget ).closest( handleObj.selector )[0]; + } + + if ( !related || related !== elem ) { + elems.push({ elem: elem, handleObj: handleObj, level: close.level }); + } + } + } + } + + for ( i = 0, l = elems.length; i < l; i++ ) { + match = elems[i]; + + if ( maxLevel && match.level > maxLevel ) { + break; + } + + event.currentTarget = match.elem; + event.data = match.handleObj.data; + event.handleObj = match.handleObj; + + ret = match.handleObj.origHandler.apply( match.elem, arguments ); + + if ( ret === false || event.isPropagationStopped() ) { + maxLevel = match.level; + + if ( ret === false ) { + stop = false; + } + if ( event.isImmediatePropagationStopped() ) { + break; + } + } + } + + return stop; +} + +function liveConvert( type, selector ) { + return (type && type !== "*" ? type + "." : "") + selector.replace(rperiod, "`").replace(rspace, "&"); +} + +jQuery.each( ("blur focus focusin focusout load resize scroll unload click dblclick " + + "mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave " + + "change select submit keydown keypress keyup error").split(" "), function( i, name ) { + + // Handle event binding + jQuery.fn[ name ] = function( data, fn ) { + if ( fn == null ) { + fn = data; + data = null; + } + + return arguments.length > 0 ? + this.bind( name, data, fn ) : + this.trigger( name ); + }; + + if ( jQuery.attrFn ) { + jQuery.attrFn[ name ] = true; + } +}); + +// Prevent memory leaks in IE +// Window isn't included so as not to unbind existing unload events +// More info: +// - http://isaacschlueter.com/2006/10/msie-memory-leaks/ +if ( window.attachEvent && !window.addEventListener ) { + jQuery(window).bind("unload", function() { + for ( var id in jQuery.cache ) { + if ( jQuery.cache[ id ].handle ) { + // Try/Catch is to handle iframes being unloaded, see #4280 + try { + jQuery.event.remove( jQuery.cache[ id ].handle.elem ); + } catch(e) {} + } + } + }); +} + + +/*! + * Sizzle CSS Selector Engine - v1.0 + * Copyright 2009, The Dojo Foundation + * Released under the MIT, BSD, and GPL Licenses. + * More information: http://sizzlejs.com/ + */ +(function(){ + +var chunker = /((?:\((?:\([^()]+\)|[^()]+)+\)|\[(?:\[[^\[\]]*\]|['"][^'"]*['"]|[^\[\]'"]+)+\]|\\.|[^ >+~,(\[\\]+)+|[>+~])(\s*,\s*)?((?:.|\r|\n)*)/g, + done = 0, + toString = Object.prototype.toString, + hasDuplicate = false, + baseHasDuplicate = true; + +// Here we check if the JavaScript engine is using some sort of +// optimization where it does not always call our comparision +// function. If that is the case, discard the hasDuplicate value. +// Thus far that includes Google Chrome. +[0, 0].sort(function() { + baseHasDuplicate = false; + return 0; +}); + +var Sizzle = function( selector, context, results, seed ) { + results = results || []; + context = context || document; + + var origContext = context; + + if ( context.nodeType !== 1 && context.nodeType !== 9 ) { + return []; + } + + if ( !selector || typeof selector !== "string" ) { + return results; + } + + var m, set, checkSet, extra, ret, cur, pop, i, + prune = true, + contextXML = Sizzle.isXML( context ), + parts = [], + soFar = selector; + + // Reset the position of the chunker regexp (start from head) + do { + chunker.exec( "" ); + m = chunker.exec( soFar ); + + if ( m ) { + soFar = m[3]; + + parts.push( m[1] ); + + if ( m[2] ) { + extra = m[3]; + break; + } + } + } while ( m ); + + if ( parts.length > 1 && origPOS.exec( selector ) ) { + + if ( parts.length === 2 && Expr.relative[ parts[0] ] ) { + set = posProcess( parts[0] + parts[1], context ); + + } else { + set = Expr.relative[ parts[0] ] ? + [ context ] : + Sizzle( parts.shift(), context ); + + while ( parts.length ) { + selector = parts.shift(); + + if ( Expr.relative[ selector ] ) { + selector += parts.shift(); + } + + set = posProcess( selector, set ); + } + } + + } else { + // Take a shortcut and set the context if the root selector is an ID + // (but not if it'll be faster if the inner selector is an ID) + if ( !seed && parts.length > 1 && context.nodeType === 9 && !contextXML && + Expr.match.ID.test(parts[0]) && !Expr.match.ID.test(parts[parts.length - 1]) ) { + + ret = Sizzle.find( parts.shift(), context, contextXML ); + context = ret.expr ? + Sizzle.filter( ret.expr, ret.set )[0] : + ret.set[0]; + } + + if ( context ) { + ret = seed ? + { expr: parts.pop(), set: makeArray(seed) } : + Sizzle.find( parts.pop(), parts.length === 1 && (parts[0] === "~" || parts[0] === "+") && context.parentNode ? context.parentNode : context, contextXML ); + + set = ret.expr ? + Sizzle.filter( ret.expr, ret.set ) : + ret.set; + + if ( parts.length > 0 ) { + checkSet = makeArray( set ); + + } else { + prune = false; + } + + while ( parts.length ) { + cur = parts.pop(); + pop = cur; + + if ( !Expr.relative[ cur ] ) { + cur = ""; + } else { + pop = parts.pop(); + } + + if ( pop == null ) { + pop = context; + } + + Expr.relative[ cur ]( checkSet, pop, contextXML ); + } + + } else { + checkSet = parts = []; + } + } + + if ( !checkSet ) { + checkSet = set; + } + + if ( !checkSet ) { + Sizzle.error( cur || selector ); + } + + if ( toString.call(checkSet) === "[object Array]" ) { + if ( !prune ) { + results.push.apply( results, checkSet ); + + } else if ( context && context.nodeType === 1 ) { + for ( i = 0; checkSet[i] != null; i++ ) { + if ( checkSet[i] && (checkSet[i] === true || checkSet[i].nodeType === 1 && Sizzle.contains(context, checkSet[i])) ) { + results.push( set[i] ); + } + } + + } else { + for ( i = 0; checkSet[i] != null; i++ ) { + if ( checkSet[i] && checkSet[i].nodeType === 1 ) { + results.push( set[i] ); + } + } + } + + } else { + makeArray( checkSet, results ); + } + + if ( extra ) { + Sizzle( extra, origContext, results, seed ); + Sizzle.uniqueSort( results ); + } + + return results; +}; + +Sizzle.uniqueSort = function( results ) { + if ( sortOrder ) { + hasDuplicate = baseHasDuplicate; + results.sort( sortOrder ); + + if ( hasDuplicate ) { + for ( var i = 1; i < results.length; i++ ) { + if ( results[i] === results[ i - 1 ] ) { + results.splice( i--, 1 ); + } + } + } + } + + return results; +}; + +Sizzle.matches = function( expr, set ) { + return Sizzle( expr, null, null, set ); +}; + +Sizzle.matchesSelector = function( node, expr ) { + return Sizzle( expr, null, null, [node] ).length > 0; +}; + +Sizzle.find = function( expr, context, isXML ) { + var set; + + if ( !expr ) { + return []; + } + + for ( var i = 0, l = Expr.order.length; i < l; i++ ) { + var match, + type = Expr.order[i]; + + if ( (match = Expr.leftMatch[ type ].exec( expr )) ) { + var left = match[1]; + match.splice( 1, 1 ); + + if ( left.substr( left.length - 1 ) !== "\\" ) { + match[1] = (match[1] || "").replace(/\\/g, ""); + set = Expr.find[ type ]( match, context, isXML ); + + if ( set != null ) { + expr = expr.replace( Expr.match[ type ], "" ); + break; + } + } + } + } + + if ( !set ) { + set = context.getElementsByTagName( "*" ); + } + + return { set: set, expr: expr }; +}; + +Sizzle.filter = function( expr, set, inplace, not ) { + var match, anyFound, + old = expr, + result = [], + curLoop = set, + isXMLFilter = set && set[0] && Sizzle.isXML( set[0] ); + + while ( expr && set.length ) { + for ( var type in Expr.filter ) { + if ( (match = Expr.leftMatch[ type ].exec( expr )) != null && match[2] ) { + var found, item, + filter = Expr.filter[ type ], + left = match[1]; + + anyFound = false; + + match.splice(1,1); + + if ( left.substr( left.length - 1 ) === "\\" ) { + continue; + } + + if ( curLoop === result ) { + result = []; + } + + if ( Expr.preFilter[ type ] ) { + match = Expr.preFilter[ type ]( match, curLoop, inplace, result, not, isXMLFilter ); + + if ( !match ) { + anyFound = found = true; + + } else if ( match === true ) { + continue; + } + } + + if ( match ) { + for ( var i = 0; (item = curLoop[i]) != null; i++ ) { + if ( item ) { + found = filter( item, match, i, curLoop ); + var pass = not ^ !!found; + + if ( inplace && found != null ) { + if ( pass ) { + anyFound = true; + + } else { + curLoop[i] = false; + } + + } else if ( pass ) { + result.push( item ); + anyFound = true; + } + } + } + } + + if ( found !== undefined ) { + if ( !inplace ) { + curLoop = result; + } + + expr = expr.replace( Expr.match[ type ], "" ); + + if ( !anyFound ) { + return []; + } + + break; + } + } + } + + // Improper expression + if ( expr === old ) { + if ( anyFound == null ) { + Sizzle.error( expr ); + + } else { + break; + } + } + + old = expr; + } + + return curLoop; +}; + +Sizzle.error = function( msg ) { + throw "Syntax error, unrecognized expression: " + msg; +}; + +var Expr = Sizzle.selectors = { + order: [ "ID", "NAME", "TAG" ], + + match: { + ID: /#((?:[\w\u00c0-\uFFFF\-]|\\.)+)/, + CLASS: /\.((?:[\w\u00c0-\uFFFF\-]|\\.)+)/, + NAME: /\[name=['"]*((?:[\w\u00c0-\uFFFF\-]|\\.)+)['"]*\]/, + ATTR: /\[\s*((?:[\w\u00c0-\uFFFF\-]|\\.)+)\s*(?:(\S?=)\s*(['"]*)(.*?)\3|)\s*\]/, + TAG: /^((?:[\w\u00c0-\uFFFF\*\-]|\\.)+)/, + CHILD: /:(only|nth|last|first)-child(?:\((even|odd|[\dn+\-]*)\))?/, + POS: /:(nth|eq|gt|lt|first|last|even|odd)(?:\((\d*)\))?(?=[^\-]|$)/, + PSEUDO: /:((?:[\w\u00c0-\uFFFF\-]|\\.)+)(?:\((['"]?)((?:\([^\)]+\)|[^\(\)]*)+)\2\))?/ + }, + + leftMatch: {}, + + attrMap: { + "class": "className", + "for": "htmlFor" + }, + + attrHandle: { + href: function( elem ) { + return elem.getAttribute( "href" ); + } + }, + + relative: { + "+": function(checkSet, part){ + var isPartStr = typeof part === "string", + isTag = isPartStr && !/\W/.test( part ), + isPartStrNotTag = isPartStr && !isTag; + + if ( isTag ) { + part = part.toLowerCase(); + } + + for ( var i = 0, l = checkSet.length, elem; i < l; i++ ) { + if ( (elem = checkSet[i]) ) { + while ( (elem = elem.previousSibling) && elem.nodeType !== 1 ) {} + + checkSet[i] = isPartStrNotTag || elem && elem.nodeName.toLowerCase() === part ? + elem || false : + elem === part; + } + } + + if ( isPartStrNotTag ) { + Sizzle.filter( part, checkSet, true ); + } + }, + + ">": function( checkSet, part ) { + var elem, + isPartStr = typeof part === "string", + i = 0, + l = checkSet.length; + + if ( isPartStr && !/\W/.test( part ) ) { + part = part.toLowerCase(); + + for ( ; i < l; i++ ) { + elem = checkSet[i]; + + if ( elem ) { + var parent = elem.parentNode; + checkSet[i] = parent.nodeName.toLowerCase() === part ? parent : false; + } + } + + } else { + for ( ; i < l; i++ ) { + elem = checkSet[i]; + + if ( elem ) { + checkSet[i] = isPartStr ? + elem.parentNode : + elem.parentNode === part; + } + } + + if ( isPartStr ) { + Sizzle.filter( part, checkSet, true ); + } + } + }, + + "": function(checkSet, part, isXML){ + var nodeCheck, + doneName = done++, + checkFn = dirCheck; + + if ( typeof part === "string" && !/\W/.test(part) ) { + part = part.toLowerCase(); + nodeCheck = part; + checkFn = dirNodeCheck; + } + + checkFn( "parentNode", part, doneName, checkSet, nodeCheck, isXML ); + }, + + "~": function( checkSet, part, isXML ) { + var nodeCheck, + doneName = done++, + checkFn = dirCheck; + + if ( typeof part === "string" && !/\W/.test( part ) ) { + part = part.toLowerCase(); + nodeCheck = part; + checkFn = dirNodeCheck; + } + + checkFn( "previousSibling", part, doneName, checkSet, nodeCheck, isXML ); + } + }, + + find: { + ID: function( match, context, isXML ) { + if ( typeof context.getElementById !== "undefined" && !isXML ) { + var m = context.getElementById(match[1]); + // Check parentNode to catch when Blackberry 4.6 returns + // nodes that are no longer in the document #6963 + return m && m.parentNode ? [m] : []; + } + }, + + NAME: function( match, context ) { + if ( typeof context.getElementsByName !== "undefined" ) { + var ret = [], + results = context.getElementsByName( match[1] ); + + for ( var i = 0, l = results.length; i < l; i++ ) { + if ( results[i].getAttribute("name") === match[1] ) { + ret.push( results[i] ); + } + } + + return ret.length === 0 ? null : ret; + } + }, + + TAG: function( match, context ) { + return context.getElementsByTagName( match[1] ); + } + }, + preFilter: { + CLASS: function( match, curLoop, inplace, result, not, isXML ) { + match = " " + match[1].replace(/\\/g, "") + " "; + + if ( isXML ) { + return match; + } + + for ( var i = 0, elem; (elem = curLoop[i]) != null; i++ ) { + if ( elem ) { + if ( not ^ (elem.className && (" " + elem.className + " ").replace(/[\t\n]/g, " ").indexOf(match) >= 0) ) { + if ( !inplace ) { + result.push( elem ); + } + + } else if ( inplace ) { + curLoop[i] = false; + } + } + } + + return false; + }, + + ID: function( match ) { + return match[1].replace(/\\/g, ""); + }, + + TAG: function( match, curLoop ) { + return match[1].toLowerCase(); + }, + + CHILD: function( match ) { + if ( match[1] === "nth" ) { + // parse equations like 'even', 'odd', '5', '2n', '3n+2', '4n-1', '-n+6' + var test = /(-?)(\d*)n((?:\+|-)?\d*)/.exec( + match[2] === "even" && "2n" || match[2] === "odd" && "2n+1" || + !/\D/.test( match[2] ) && "0n+" + match[2] || match[2]); + + // calculate the numbers (first)n+(last) including if they are negative + match[2] = (test[1] + (test[2] || 1)) - 0; + match[3] = test[3] - 0; + } + + // TODO: Move to normal caching system + match[0] = done++; + + return match; + }, + + ATTR: function( match, curLoop, inplace, result, not, isXML ) { + var name = match[1].replace(/\\/g, ""); + + if ( !isXML && Expr.attrMap[name] ) { + match[1] = Expr.attrMap[name]; + } + + if ( match[2] === "~=" ) { + match[4] = " " + match[4] + " "; + } + + return match; + }, + + PSEUDO: function( match, curLoop, inplace, result, not ) { + if ( match[1] === "not" ) { + // If we're dealing with a complex expression, or a simple one + if ( ( chunker.exec(match[3]) || "" ).length > 1 || /^\w/.test(match[3]) ) { + match[3] = Sizzle(match[3], null, null, curLoop); + + } else { + var ret = Sizzle.filter(match[3], curLoop, inplace, true ^ not); + + if ( !inplace ) { + result.push.apply( result, ret ); + } + + return false; + } + + } else if ( Expr.match.POS.test( match[0] ) || Expr.match.CHILD.test( match[0] ) ) { + return true; + } + + return match; + }, + + POS: function( match ) { + match.unshift( true ); + + return match; + } + }, + + filters: { + enabled: function( elem ) { + return elem.disabled === false && elem.type !== "hidden"; + }, + + disabled: function( elem ) { + return elem.disabled === true; + }, + + checked: function( elem ) { + return elem.checked === true; + }, + + selected: function( elem ) { + // Accessing this property makes selected-by-default + // options in Safari work properly + elem.parentNode.selectedIndex; + + return elem.selected === true; + }, + + parent: function( elem ) { + return !!elem.firstChild; + }, + + empty: function( elem ) { + return !elem.firstChild; + }, + + has: function( elem, i, match ) { + return !!Sizzle( match[3], elem ).length; + }, + + header: function( elem ) { + return (/h\d/i).test( elem.nodeName ); + }, + + text: function( elem ) { + return "text" === elem.type; + }, + radio: function( elem ) { + return "radio" === elem.type; + }, + + checkbox: function( elem ) { + return "checkbox" === elem.type; + }, + + file: function( elem ) { + return "file" === elem.type; + }, + password: function( elem ) { + return "password" === elem.type; + }, + + submit: function( elem ) { + return "submit" === elem.type; + }, + + image: function( elem ) { + return "image" === elem.type; + }, + + reset: function( elem ) { + return "reset" === elem.type; + }, + + button: function( elem ) { + return "button" === elem.type || elem.nodeName.toLowerCase() === "button"; + }, + + input: function( elem ) { + return (/input|select|textarea|button/i).test( elem.nodeName ); + } + }, + setFilters: { + first: function( elem, i ) { + return i === 0; + }, + + last: function( elem, i, match, array ) { + return i === array.length - 1; + }, + + even: function( elem, i ) { + return i % 2 === 0; + }, + + odd: function( elem, i ) { + return i % 2 === 1; + }, + + lt: function( elem, i, match ) { + return i < match[3] - 0; + }, + + gt: function( elem, i, match ) { + return i > match[3] - 0; + }, + + nth: function( elem, i, match ) { + return match[3] - 0 === i; + }, + + eq: function( elem, i, match ) { + return match[3] - 0 === i; + } + }, + filter: { + PSEUDO: function( elem, match, i, array ) { + var name = match[1], + filter = Expr.filters[ name ]; + + if ( filter ) { + return filter( elem, i, match, array ); + + } else if ( name === "contains" ) { + return (elem.textContent || elem.innerText || Sizzle.getText([ elem ]) || "").indexOf(match[3]) >= 0; + + } else if ( name === "not" ) { + var not = match[3]; + + for ( var j = 0, l = not.length; j < l; j++ ) { + if ( not[j] === elem ) { + return false; + } + } + + return true; + + } else { + Sizzle.error( "Syntax error, unrecognized expression: " + name ); + } + }, + + CHILD: function( elem, match ) { + var type = match[1], + node = elem; + + switch ( type ) { + case "only": + case "first": + while ( (node = node.previousSibling) ) { + if ( node.nodeType === 1 ) { + return false; + } + } + + if ( type === "first" ) { + return true; + } + + node = elem; + + case "last": + while ( (node = node.nextSibling) ) { + if ( node.nodeType === 1 ) { + return false; + } + } + + return true; + + case "nth": + var first = match[2], + last = match[3]; + + if ( first === 1 && last === 0 ) { + return true; + } + + var doneName = match[0], + parent = elem.parentNode; + + if ( parent && (parent.sizcache !== doneName || !elem.nodeIndex) ) { + var count = 0; + + for ( node = parent.firstChild; node; node = node.nextSibling ) { + if ( node.nodeType === 1 ) { + node.nodeIndex = ++count; + } + } + + parent.sizcache = doneName; + } + + var diff = elem.nodeIndex - last; + + if ( first === 0 ) { + return diff === 0; + + } else { + return ( diff % first === 0 && diff / first >= 0 ); + } + } + }, + + ID: function( elem, match ) { + return elem.nodeType === 1 && elem.getAttribute("id") === match; + }, + + TAG: function( elem, match ) { + return (match === "*" && elem.nodeType === 1) || elem.nodeName.toLowerCase() === match; + }, + + CLASS: function( elem, match ) { + return (" " + (elem.className || elem.getAttribute("class")) + " ") + .indexOf( match ) > -1; + }, + + ATTR: function( elem, match ) { + var name = match[1], + result = Expr.attrHandle[ name ] ? + Expr.attrHandle[ name ]( elem ) : + elem[ name ] != null ? + elem[ name ] : + elem.getAttribute( name ), + value = result + "", + type = match[2], + check = match[4]; + + return result == null ? + type === "!=" : + type === "=" ? + value === check : + type === "*=" ? + value.indexOf(check) >= 0 : + type === "~=" ? + (" " + value + " ").indexOf(check) >= 0 : + !check ? + value && result !== false : + type === "!=" ? + value !== check : + type === "^=" ? + value.indexOf(check) === 0 : + type === "$=" ? + value.substr(value.length - check.length) === check : + type === "|=" ? + value === check || value.substr(0, check.length + 1) === check + "-" : + false; + }, + + POS: function( elem, match, i, array ) { + var name = match[2], + filter = Expr.setFilters[ name ]; + + if ( filter ) { + return filter( elem, i, match, array ); + } + } + } +}; + +var origPOS = Expr.match.POS, + fescape = function(all, num){ + return "\\" + (num - 0 + 1); + }; + +for ( var type in Expr.match ) { + Expr.match[ type ] = new RegExp( Expr.match[ type ].source + (/(?![^\[]*\])(?![^\(]*\))/.source) ); + Expr.leftMatch[ type ] = new RegExp( /(^(?:.|\r|\n)*?)/.source + Expr.match[ type ].source.replace(/\\(\d+)/g, fescape) ); +} + +var makeArray = function( array, results ) { + array = Array.prototype.slice.call( array, 0 ); + + if ( results ) { + results.push.apply( results, array ); + return results; + } + + return array; +}; + +// Perform a simple check to determine if the browser is capable of +// converting a NodeList to an array using builtin methods. +// Also verifies that the returned array holds DOM nodes +// (which is not the case in the Blackberry browser) +try { + Array.prototype.slice.call( document.documentElement.childNodes, 0 )[0].nodeType; + +// Provide a fallback method if it does not work +} catch( e ) { + makeArray = function( array, results ) { + var i = 0, + ret = results || []; + + if ( toString.call(array) === "[object Array]" ) { + Array.prototype.push.apply( ret, array ); + + } else { + if ( typeof array.length === "number" ) { + for ( var l = array.length; i < l; i++ ) { + ret.push( array[i] ); + } + + } else { + for ( ; array[i]; i++ ) { + ret.push( array[i] ); + } + } + } + + return ret; + }; +} + +var sortOrder, siblingCheck; + +if ( document.documentElement.compareDocumentPosition ) { + sortOrder = function( a, b ) { + if ( a === b ) { + hasDuplicate = true; + return 0; + } + + if ( !a.compareDocumentPosition || !b.compareDocumentPosition ) { + return a.compareDocumentPosition ? -1 : 1; + } + + return a.compareDocumentPosition(b) & 4 ? -1 : 1; + }; + +} else { + sortOrder = function( a, b ) { + var al, bl, + ap = [], + bp = [], + aup = a.parentNode, + bup = b.parentNode, + cur = aup; + + // The nodes are identical, we can exit early + if ( a === b ) { + hasDuplicate = true; + return 0; + + // If the nodes are siblings (or identical) we can do a quick check + } else if ( aup === bup ) { + return siblingCheck( a, b ); + + // If no parents were found then the nodes are disconnected + } else if ( !aup ) { + return -1; + + } else if ( !bup ) { + return 1; + } + + // Otherwise they're somewhere else in the tree so we need + // to build up a full list of the parentNodes for comparison + while ( cur ) { + ap.unshift( cur ); + cur = cur.parentNode; + } + + cur = bup; + + while ( cur ) { + bp.unshift( cur ); + cur = cur.parentNode; + } + + al = ap.length; + bl = bp.length; + + // Start walking down the tree looking for a discrepancy + for ( var i = 0; i < al && i < bl; i++ ) { + if ( ap[i] !== bp[i] ) { + return siblingCheck( ap[i], bp[i] ); + } + } + + // We ended someplace up the tree so do a sibling check + return i === al ? + siblingCheck( a, bp[i], -1 ) : + siblingCheck( ap[i], b, 1 ); + }; + + siblingCheck = function( a, b, ret ) { + if ( a === b ) { + return ret; + } + + var cur = a.nextSibling; + + while ( cur ) { + if ( cur === b ) { + return -1; + } + + cur = cur.nextSibling; + } + + return 1; + }; +} + +// Utility function for retreiving the text value of an array of DOM nodes +Sizzle.getText = function( elems ) { + var ret = "", elem; + + for ( var i = 0; elems[i]; i++ ) { + elem = elems[i]; + + // Get the text from text nodes and CDATA nodes + if ( elem.nodeType === 3 || elem.nodeType === 4 ) { + ret += elem.nodeValue; + + // Traverse everything else, except comment nodes + } else if ( elem.nodeType !== 8 ) { + ret += Sizzle.getText( elem.childNodes ); + } + } + + return ret; +}; + +// Check to see if the browser returns elements by name when +// querying by getElementById (and provide a workaround) +(function(){ + // We're going to inject a fake input element with a specified name + var form = document.createElement("div"), + id = "script" + (new Date()).getTime(), + root = document.documentElement; + + form.innerHTML = ""; + + // Inject it into the root element, check its status, and remove it quickly + root.insertBefore( form, root.firstChild ); + + // The workaround has to do additional checks after a getElementById + // Which slows things down for other browsers (hence the branching) + if ( document.getElementById( id ) ) { + Expr.find.ID = function( match, context, isXML ) { + if ( typeof context.getElementById !== "undefined" && !isXML ) { + var m = context.getElementById(match[1]); + + return m ? + m.id === match[1] || typeof m.getAttributeNode !== "undefined" && m.getAttributeNode("id").nodeValue === match[1] ? + [m] : + undefined : + []; + } + }; + + Expr.filter.ID = function( elem, match ) { + var node = typeof elem.getAttributeNode !== "undefined" && elem.getAttributeNode("id"); + + return elem.nodeType === 1 && node && node.nodeValue === match; + }; + } + + root.removeChild( form ); + + // release memory in IE + root = form = null; +})(); + +(function(){ + // Check to see if the browser returns only elements + // when doing getElementsByTagName("*") + + // Create a fake element + var div = document.createElement("div"); + div.appendChild( document.createComment("") ); + + // Make sure no comments are found + if ( div.getElementsByTagName("*").length > 0 ) { + Expr.find.TAG = function( match, context ) { + var results = context.getElementsByTagName( match[1] ); + + // Filter out possible comments + if ( match[1] === "*" ) { + var tmp = []; + + for ( var i = 0; results[i]; i++ ) { + if ( results[i].nodeType === 1 ) { + tmp.push( results[i] ); + } + } + + results = tmp; + } + + return results; + }; + } + + // Check to see if an attribute returns normalized href attributes + div.innerHTML = ""; + + if ( div.firstChild && typeof div.firstChild.getAttribute !== "undefined" && + div.firstChild.getAttribute("href") !== "#" ) { + + Expr.attrHandle.href = function( elem ) { + return elem.getAttribute( "href", 2 ); + }; + } + + // release memory in IE + div = null; +})(); + +if ( document.querySelectorAll ) { + (function(){ + var oldSizzle = Sizzle, + div = document.createElement("div"), + id = "__sizzle__"; + + div.innerHTML = "

"; + + // Safari can't handle uppercase or unicode characters when + // in quirks mode. + if ( div.querySelectorAll && div.querySelectorAll(".TEST").length === 0 ) { + return; + } + + Sizzle = function( query, context, extra, seed ) { + context = context || document; + + // Make sure that attribute selectors are quoted + query = query.replace(/\=\s*([^'"\]]*)\s*\]/g, "='$1']"); + + // Only use querySelectorAll on non-XML documents + // (ID selectors don't work in non-HTML documents) + if ( !seed && !Sizzle.isXML(context) ) { + if ( context.nodeType === 9 ) { + try { + return makeArray( context.querySelectorAll(query), extra ); + } catch(qsaError) {} + + // qSA works strangely on Element-rooted queries + // We can work around this by specifying an extra ID on the root + // and working up from there (Thanks to Andrew Dupont for the technique) + // IE 8 doesn't work on object elements + } else if ( context.nodeType === 1 && context.nodeName.toLowerCase() !== "object" ) { + var old = context.getAttribute( "id" ), + nid = old || id; + + if ( !old ) { + context.setAttribute( "id", nid ); + } + + try { + return makeArray( context.querySelectorAll( "#" + nid + " " + query ), extra ); + + } catch(pseudoError) { + } finally { + if ( !old ) { + context.removeAttribute( "id" ); + } + } + } + } + + return oldSizzle(query, context, extra, seed); + }; + + for ( var prop in oldSizzle ) { + Sizzle[ prop ] = oldSizzle[ prop ]; + } + + // release memory in IE + div = null; + })(); +} + +(function(){ + var html = document.documentElement, + matches = html.matchesSelector || html.mozMatchesSelector || html.webkitMatchesSelector || html.msMatchesSelector, + pseudoWorks = false; + + try { + // This should fail with an exception + // Gecko does not error, returns false instead + matches.call( document.documentElement, "[test!='']:sizzle" ); + + } catch( pseudoError ) { + pseudoWorks = true; + } + + if ( matches ) { + Sizzle.matchesSelector = function( node, expr ) { + // Make sure that attribute selectors are quoted + expr = expr.replace(/\=\s*([^'"\]]*)\s*\]/g, "='$1']"); + + if ( !Sizzle.isXML( node ) ) { + try { + if ( pseudoWorks || !Expr.match.PSEUDO.test( expr ) && !/!=/.test( expr ) ) { + return matches.call( node, expr ); + } + } catch(e) {} + } + + return Sizzle(expr, null, null, [node]).length > 0; + }; + } +})(); + +(function(){ + var div = document.createElement("div"); + + div.innerHTML = "
"; + + // Opera can't find a second classname (in 9.6) + // Also, make sure that getElementsByClassName actually exists + if ( !div.getElementsByClassName || div.getElementsByClassName("e").length === 0 ) { + return; + } + + // Safari caches class attributes, doesn't catch changes (in 3.2) + div.lastChild.className = "e"; + + if ( div.getElementsByClassName("e").length === 1 ) { + return; + } + + Expr.order.splice(1, 0, "CLASS"); + Expr.find.CLASS = function( match, context, isXML ) { + if ( typeof context.getElementsByClassName !== "undefined" && !isXML ) { + return context.getElementsByClassName(match[1]); + } + }; + + // release memory in IE + div = null; +})(); + +function dirNodeCheck( dir, cur, doneName, checkSet, nodeCheck, isXML ) { + for ( var i = 0, l = checkSet.length; i < l; i++ ) { + var elem = checkSet[i]; + + if ( elem ) { + var match = false; + + elem = elem[dir]; + + while ( elem ) { + if ( elem.sizcache === doneName ) { + match = checkSet[elem.sizset]; + break; + } + + if ( elem.nodeType === 1 && !isXML ){ + elem.sizcache = doneName; + elem.sizset = i; + } + + if ( elem.nodeName.toLowerCase() === cur ) { + match = elem; + break; + } + + elem = elem[dir]; + } + + checkSet[i] = match; + } + } +} + +function dirCheck( dir, cur, doneName, checkSet, nodeCheck, isXML ) { + for ( var i = 0, l = checkSet.length; i < l; i++ ) { + var elem = checkSet[i]; + + if ( elem ) { + var match = false; + + elem = elem[dir]; + + while ( elem ) { + if ( elem.sizcache === doneName ) { + match = checkSet[elem.sizset]; + break; + } + + if ( elem.nodeType === 1 ) { + if ( !isXML ) { + elem.sizcache = doneName; + elem.sizset = i; + } + + if ( typeof cur !== "string" ) { + if ( elem === cur ) { + match = true; + break; + } + + } else if ( Sizzle.filter( cur, [elem] ).length > 0 ) { + match = elem; + break; + } + } + + elem = elem[dir]; + } + + checkSet[i] = match; + } + } +} + +if ( document.documentElement.contains ) { + Sizzle.contains = function( a, b ) { + return a !== b && (a.contains ? a.contains(b) : true); + }; + +} else if ( document.documentElement.compareDocumentPosition ) { + Sizzle.contains = function( a, b ) { + return !!(a.compareDocumentPosition(b) & 16); + }; + +} else { + Sizzle.contains = function() { + return false; + }; +} + +Sizzle.isXML = function( elem ) { + // documentElement is verified for cases where it doesn't yet exist + // (such as loading iframes in IE - #4833) + var documentElement = (elem ? elem.ownerDocument || elem : 0).documentElement; + + return documentElement ? documentElement.nodeName !== "HTML" : false; +}; + +var posProcess = function( selector, context ) { + var match, + tmpSet = [], + later = "", + root = context.nodeType ? [context] : context; + + // Position selectors must be done after the filter + // And so must :not(positional) so we move all PSEUDOs to the end + while ( (match = Expr.match.PSEUDO.exec( selector )) ) { + later += match[0]; + selector = selector.replace( Expr.match.PSEUDO, "" ); + } + + selector = Expr.relative[selector] ? selector + "*" : selector; + + for ( var i = 0, l = root.length; i < l; i++ ) { + Sizzle( selector, root[i], tmpSet ); + } + + return Sizzle.filter( later, tmpSet ); +}; + +// EXPOSE +jQuery.find = Sizzle; +jQuery.expr = Sizzle.selectors; +jQuery.expr[":"] = jQuery.expr.filters; +jQuery.unique = Sizzle.uniqueSort; +jQuery.text = Sizzle.getText; +jQuery.isXMLDoc = Sizzle.isXML; +jQuery.contains = Sizzle.contains; + + +})(); + + +var runtil = /Until$/, + rparentsprev = /^(?:parents|prevUntil|prevAll)/, + // Note: This RegExp should be improved, or likely pulled from Sizzle + rmultiselector = /,/, + isSimple = /^.[^:#\[\.,]*$/, + slice = Array.prototype.slice, + POS = jQuery.expr.match.POS; + +jQuery.fn.extend({ + find: function( selector ) { + var ret = this.pushStack( "", "find", selector ), + length = 0; + + for ( var i = 0, l = this.length; i < l; i++ ) { + length = ret.length; + jQuery.find( selector, this[i], ret ); + + if ( i > 0 ) { + // Make sure that the results are unique + for ( var n = length; n < ret.length; n++ ) { + for ( var r = 0; r < length; r++ ) { + if ( ret[r] === ret[n] ) { + ret.splice(n--, 1); + break; + } + } + } + } + } + + return ret; + }, + + has: function( target ) { + var targets = jQuery( target ); + return this.filter(function() { + for ( var i = 0, l = targets.length; i < l; i++ ) { + if ( jQuery.contains( this, targets[i] ) ) { + return true; + } + } + }); + }, + + not: function( selector ) { + return this.pushStack( winnow(this, selector, false), "not", selector); + }, + + filter: function( selector ) { + return this.pushStack( winnow(this, selector, true), "filter", selector ); + }, + + is: function( selector ) { + return !!selector && jQuery.filter( selector, this ).length > 0; + }, + + closest: function( selectors, context ) { + var ret = [], i, l, cur = this[0]; + + if ( jQuery.isArray( selectors ) ) { + var match, selector, + matches = {}, + level = 1; + + if ( cur && selectors.length ) { + for ( i = 0, l = selectors.length; i < l; i++ ) { + selector = selectors[i]; + + if ( !matches[selector] ) { + matches[selector] = jQuery.expr.match.POS.test( selector ) ? + jQuery( selector, context || this.context ) : + selector; + } + } + + while ( cur && cur.ownerDocument && cur !== context ) { + for ( selector in matches ) { + match = matches[selector]; + + if ( match.jquery ? match.index(cur) > -1 : jQuery(cur).is(match) ) { + ret.push({ selector: selector, elem: cur, level: level }); + } + } + + cur = cur.parentNode; + level++; + } + } + + return ret; + } + + var pos = POS.test( selectors ) ? + jQuery( selectors, context || this.context ) : null; + + for ( i = 0, l = this.length; i < l; i++ ) { + cur = this[i]; + + while ( cur ) { + if ( pos ? pos.index(cur) > -1 : jQuery.find.matchesSelector(cur, selectors) ) { + ret.push( cur ); + break; + + } else { + cur = cur.parentNode; + if ( !cur || !cur.ownerDocument || cur === context ) { + break; + } + } + } + } + + ret = ret.length > 1 ? jQuery.unique(ret) : ret; + + return this.pushStack( ret, "closest", selectors ); + }, + + // Determine the position of an element within + // the matched set of elements + index: function( elem ) { + if ( !elem || typeof elem === "string" ) { + return jQuery.inArray( this[0], + // If it receives a string, the selector is used + // If it receives nothing, the siblings are used + elem ? jQuery( elem ) : this.parent().children() ); + } + // Locate the position of the desired element + return jQuery.inArray( + // If it receives a jQuery object, the first element is used + elem.jquery ? elem[0] : elem, this ); + }, + + add: function( selector, context ) { + var set = typeof selector === "string" ? + jQuery( selector, context || this.context ) : + jQuery.makeArray( selector ), + all = jQuery.merge( this.get(), set ); + + return this.pushStack( isDisconnected( set[0] ) || isDisconnected( all[0] ) ? + all : + jQuery.unique( all ) ); + }, + + andSelf: function() { + return this.add( this.prevObject ); + } +}); + +// A painfully simple check to see if an element is disconnected +// from a document (should be improved, where feasible). +function isDisconnected( node ) { + return !node || !node.parentNode || node.parentNode.nodeType === 11; +} + +jQuery.each({ + parent: function( elem ) { + var parent = elem.parentNode; + return parent && parent.nodeType !== 11 ? parent : null; + }, + parents: function( elem ) { + return jQuery.dir( elem, "parentNode" ); + }, + parentsUntil: function( elem, i, until ) { + return jQuery.dir( elem, "parentNode", until ); + }, + next: function( elem ) { + return jQuery.nth( elem, 2, "nextSibling" ); + }, + prev: function( elem ) { + return jQuery.nth( elem, 2, "previousSibling" ); + }, + nextAll: function( elem ) { + return jQuery.dir( elem, "nextSibling" ); + }, + prevAll: function( elem ) { + return jQuery.dir( elem, "previousSibling" ); + }, + nextUntil: function( elem, i, until ) { + return jQuery.dir( elem, "nextSibling", until ); + }, + prevUntil: function( elem, i, until ) { + return jQuery.dir( elem, "previousSibling", until ); + }, + siblings: function( elem ) { + return jQuery.sibling( elem.parentNode.firstChild, elem ); + }, + children: function( elem ) { + return jQuery.sibling( elem.firstChild ); + }, + contents: function( elem ) { + return jQuery.nodeName( elem, "iframe" ) ? + elem.contentDocument || elem.contentWindow.document : + jQuery.makeArray( elem.childNodes ); + } +}, function( name, fn ) { + jQuery.fn[ name ] = function( until, selector ) { + var ret = jQuery.map( this, fn, until ); + + if ( !runtil.test( name ) ) { + selector = until; + } + + if ( selector && typeof selector === "string" ) { + ret = jQuery.filter( selector, ret ); + } + + ret = this.length > 1 ? jQuery.unique( ret ) : ret; + + if ( (this.length > 1 || rmultiselector.test( selector )) && rparentsprev.test( name ) ) { + ret = ret.reverse(); + } + + return this.pushStack( ret, name, slice.call(arguments).join(",") ); + }; +}); + +jQuery.extend({ + filter: function( expr, elems, not ) { + if ( not ) { + expr = ":not(" + expr + ")"; + } + + return elems.length === 1 ? + jQuery.find.matchesSelector(elems[0], expr) ? [ elems[0] ] : [] : + jQuery.find.matches(expr, elems); + }, + + dir: function( elem, dir, until ) { + var matched = [], + cur = elem[ dir ]; + + while ( cur && cur.nodeType !== 9 && (until === undefined || cur.nodeType !== 1 || !jQuery( cur ).is( until )) ) { + if ( cur.nodeType === 1 ) { + matched.push( cur ); + } + cur = cur[dir]; + } + return matched; + }, + + nth: function( cur, result, dir, elem ) { + result = result || 1; + var num = 0; + + for ( ; cur; cur = cur[dir] ) { + if ( cur.nodeType === 1 && ++num === result ) { + break; + } + } + + return cur; + }, + + sibling: function( n, elem ) { + var r = []; + + for ( ; n; n = n.nextSibling ) { + if ( n.nodeType === 1 && n !== elem ) { + r.push( n ); + } + } + + return r; + } +}); + +// Implement the identical functionality for filter and not +function winnow( elements, qualifier, keep ) { + if ( jQuery.isFunction( qualifier ) ) { + return jQuery.grep(elements, function( elem, i ) { + var retVal = !!qualifier.call( elem, i, elem ); + return retVal === keep; + }); + + } else if ( qualifier.nodeType ) { + return jQuery.grep(elements, function( elem, i ) { + return (elem === qualifier) === keep; + }); + + } else if ( typeof qualifier === "string" ) { + var filtered = jQuery.grep(elements, function( elem ) { + return elem.nodeType === 1; + }); + + if ( isSimple.test( qualifier ) ) { + return jQuery.filter(qualifier, filtered, !keep); + } else { + qualifier = jQuery.filter( qualifier, filtered ); + } + } + + return jQuery.grep(elements, function( elem, i ) { + return (jQuery.inArray( elem, qualifier ) >= 0) === keep; + }); +} + + + + +var rinlinejQuery = / jQuery\d+="(?:\d+|null)"/g, + rleadingWhitespace = /^\s+/, + rxhtmlTag = /<(?!area|br|col|embed|hr|img|input|link|meta|param)(([\w:]+)[^>]*)\/>/ig, + rtagName = /<([\w:]+)/, + rtbody = /\s]+\/)>/g, + wrapMap = { + option: [ 1, "" ], + legend: [ 1, "
", "
" ], + thead: [ 1, "", "
" ], + tr: [ 2, "", "
" ], + td: [ 3, "", "
" ], + col: [ 2, "", "
" ], + area: [ 1, "", "" ], + _default: [ 0, "", "" ] + }; + +wrapMap.optgroup = wrapMap.option; +wrapMap.tbody = wrapMap.tfoot = wrapMap.colgroup = wrapMap.caption = wrapMap.thead; +wrapMap.th = wrapMap.td; + +// IE can't serialize and + +
+
+
+

JSON files

+
+
+

JSON is a data representation format derived from Javascript (the browser embedded + programming language for websites). Streamtuner2 uses it to store it's configuration + and radio station data files.

+

The MIME type of these files is application/json and they often look like:

+

+[ + { + "title": "Station title..", + "url": "http://1.2.3.4:8000/", + "homepage": "http://radio.org/", + }, + { "title": "second" } +] +

+
+ +
+
+
+
+
+ ADDED help/html/m3u.html Index: help/html/m3u.html ================================================================== --- help/html/m3u.html +++ help/html/m3u.html @@ -0,0 +1,36 @@ + + + + +.M3U files + + + +
+
+
+

.M3U files

+
+
+

M3U files also contain playlists, like .pls files. But they are often used by locally installed audio players.

+

The MIME type of these files is audio/x-mpegurl and they often look like:

+

+#M3U +http://123.45.67.189:8222/ +http://123.45.67.222:7555/ +

+
+ +
+
+
+
+
+ ADDED help/html/myoggradio.html Index: help/html/myoggradio.html ================================================================== --- help/html/myoggradio.html +++ help/html/myoggradio.html @@ -0,0 +1,60 @@ + + + + +MyOggRadio + + + +
+
+
+

MyOggRadio

+
+
+

MyOggRadio is an open + source internet radio directory project. Since it provides its station list as + JSON it is very well supported.

+

Because the directory is currently still rather small, streamtuner2 provides the + option to share radion station links. Use the Station ▸ Extensions ▸ Share... + menu entry to upload the currently selected radio (from your favourite bookmarks).

+

The personal section is empty, unless you specify an user account in the settings + and actually bookmarks stations on the MyOggRadio web site. Shared entries are not + automatically in the MOR favorite list.

+
+

Channel options.

+
+
Login settings
+

If you want to upload station infos to MyOggRadio, you need an account there. Registration + is free and doesn't require personal information nor email address. Specify username and + password separated with a : colon in this field.

+
stream URL format
+

When uploading stations, the streaming URL can be converted into RAW format. You + can however leave it as .PLS link file.

+
+
+
+ +
+
+
+
+
+ ADDED help/html/playing.html Index: help/html/playing.html ================================================================== --- help/html/playing.html +++ help/html/playing.html @@ -0,0 +1,48 @@ + + + + +Playing + + + +
+
+
+

Playing

+
+
+

Simply double click a station to start it with your audio player.

+

In streamtuner2 you can configure different audio players for different audio + formats. In the 'Apps' section of the settings dialog, there is one application associated + with each audio file (MIME) type. Per default this is audacious, but you can certainly use + any other application.

+

Note however, that some audio players will start twice and won't + allow easy station switching. In these circumstance it might be sensible to write + a wrapper script, or configure special commandline arguments to your favoured audio + player.

+

It's also possible to save a station entry as .m3u or .pls file, and load this manually + in your player. You might even want to collect such .m3u files for archival / backup + purposes.

+
+ +
+
+
+
+
+ ADDED help/html/pls.html Index: help/html/pls.html ================================================================== --- help/html/pls.html +++ help/html/pls.html @@ -0,0 +1,39 @@ + + + + +.PLS files + + + +
+
+
+

.PLS files

+
+
+

Playlist files often have the extension .pls

+

It's the primary station stream link format of SHOUTcast.

+

The MIME type of these files is audio/x-scpls and they often look like:

+

+[playlist] +numberofentries=1 +File1=http://123.45.67.189:8222 +Title1=(#1 - 555/2000) radio station Xyz - top 100 - all the hitzez +Length1=-1 +

+
+ +
+
+
+
+
+ ADDED help/html/recording.html Index: help/html/recording.html ================================================================== --- help/html/recording.html +++ help/html/recording.html @@ -0,0 +1,50 @@ + + + + +Recording + + + +
+
+
+

Recording

+
+
+

Most stations that stream MP3 or OGG music can be recorded. This is accomplished by + the commandline tool "streamripper". If you select a station a press the [record] button, + a console window should appear. Within that streamripper outputs its current activity.

+

Per default recorded streams are written into the current directory. Often this is your + home directory. And streamripper automatically creates a directory with the recorded + radio station title as name. Within that directory the individual music titles are split + into separate .mp3 files.

+

You can influence all these behaviours with -arguments to the streamripper program. + Please refer to the manpage of streamripper. The options are too various to list here. + You can set default arguments (e.g. another default save directory) in the 'Apps' section of + the streamtuner2 configuration dialog.

+
+ +
+
+
+
+
+ ADDED help/html/reloading.html Index: help/html/reloading.html ================================================================== --- help/html/reloading.html +++ help/html/reloading.html @@ -0,0 +1,35 @@ + + + + +Reloading + + + +
+
+
+

Reloading

+
+
+

Station information can get stale. Especially Shoutcast invalidates old information + frequently. Therefore you have to [reload] the lists. There is an action button below + the menu bar for this. It retrieves the current data from the directory service.

+

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.

+
+ +
+
+
+
+
+ ADDED help/html/saving.html Index: help/html/saving.html ================================================================== --- help/html/saving.html +++ help/html/saving.html @@ -0,0 +1,43 @@ + + + + +Saving + + + +
+
+
+

Saving

+
+
+

You can export the currently selected stream using Station ▸ Save. A file + dialog opens, where you can adapt the title. The extension of the filename decides on + the saved link format. Per default a .m3u file is created, because most audio players + understand this format.

+

But you can also save in .pls + or .xspf or .asx or .smil format. Note that the lower right dropdown + has no effect, you must edit the filename field.

+
+ +
+
+
+
+
+ ADDED help/html/search.html Index: help/html/search.html ================================================================== --- help/html/search.html +++ help/html/search.html @@ -0,0 +1,73 @@ + + + + +Searching + + + +
+
+
+

Searching

+
+

There are two search functions. The quick search field is in the toolbar, and allows + to highlight search terms in the current station list. The cache search is available + through the Edit ▸ Search menu instead and provides more details.

+
+

Dialog options

+
+

You can get to the search dialog via Edit ▸ Find or Ctrl+F. Centrally to this dialog is the + text field, where you can specify the phrase to scan for.

+

Above you can check which channel plugins to inspect for the search term. Using this + allows to limit the search to specific radio station directories, but usually you want + to search them all.

+

Below the search phrase text box, you can specifiy which station fields to look + into. Often you just want to search the titles of radio stations. But you can also + have the search occour in the description/playing fields. Alternatively you could + just search the homepage links.

+
+
+
+

Search methods

+
+

Lastly, there are three search methods. You mostly want to use the cache search, + which just scans through the station lists streamtuner2 has downloaded. Since you are mostly + looking for something you had already seen, this will give you the desired results.

+

The server search would try to do a live search on the directory servers, + providing you with the most recent data. However, it's not implemented for all channel + plugins, and therefore brings limited output.

+

Use the button google it as last resort, if streamtuner2 didn't find anything.

+
+
+
+

Quick search

+

Just enter text into the quick search box. Streamtuner2 will instantly highlight + any matches in the current stations view. If you switch tabs, just click the glass icon + to reapply the highlighting.

+
+ +
+
+
+
+
+ ADDED help/html/shoutcast.html Index: help/html/shoutcast.html ================================================================== --- help/html/shoutcast.html +++ help/html/shoutcast.html @@ -0,0 +1,58 @@ + + + + +Shoutcast + + + +
+
+
+

Shoutcast

+
+
+

SHOUTcast is the name of a MP3 streaming server software. It automatically collects all + station lists on shoutcast.com. +

+
    +

  • Station entries usually provide current playing information.

    • +

  • Stream links are plain PLS files.

    • +

  • Genres are subcategorized, so the main groups in the category + list must often be expanded to see the interesting entries.

    • +
+
+

There are a few plugin options for this channel.

+
+
PyQuery parsing
+

Uses an XML parser to extract station data from within HTML <tags> of the shoutcast.com site. This is + slower, but often more reliable than regular expressions, which look for plain text markers.

+
debug output
+

Prints verbose messages to the console. This option is used while developing extensions for Streamtuner2.

+
+
+
+ +
+
+
+
+
+ ADDED help/html/streams.html Index: help/html/streams.html ================================================================== --- help/html/streams.html +++ help/html/streams.html @@ -0,0 +1,60 @@ + + + + +Streams / Stations + + + +
+
+
+

Streams / Stations

+
+
+

Radio stations are listed in the right pane. Usually they have a title and a + description. The description is often the last played song. (This isn't updated + automatically to conserve bandwidth and because live information is seldomly available.)

+
+

You can double click a station line to get it to play. Alternatively there are the + play and record buttons in the menubar. You can also invoke a stations homepage, if it + has one.

+
+ +
+

Context menu

+
+

Additionally most actions are available in a context menu. Right click + a station entry to display it.

+

Reshuffling of station entries in the list is possible by dragging them. But + this is only a visual effect and will confuse the internal ordering of entries. Don't + do it.

+

You can always click the current category in the left list, to have the current + station list redisplayed. Which is useful after updating favicons, or accidental + dragging of entries.

+
+
+ +
+
+
+
+
+ ADDED help/html/technical.html Index: help/html/technical.html ================================================================== --- help/html/technical.html +++ help/html/technical.html @@ -0,0 +1,83 @@ + + + + +Technical information + + + +
+
+
+

Technical information

+
+
+
+

Dependencies

+
+
+

Python 2.7 or 3.x

+

PyGtk or PyGI

+

Gtk2 or Gtk3

+
+
+

Soft dependencies

+
+

Python-LXML

+

Python-PyQuery

+

Python-Kronos

+

Audacious

+
+
+
+
+
+

Configuration files

+
+
/home/$USER/.config/streamtuner2/
+

Corresponds to the XDG_CONFIG_HOME setting. All ST2 configuration settings + are contained within here and are in JSON format.

+
~/.config/streamtuner2/settings.json
+

General runtime options, plugin settings, and configured audio players.

+
~/.config/streamtuner2/window.json
+

Saved window sizes, list widths.

+
~/.config/streamtuner2/state.json
+

Last category in each channel tab.

+
~/.config/streamtuner2/bookmarks.json
+

Is a separate cahce file for your bookmarked/favourite radio stations.

+
~/.config/streamtuner2/cache/***.json
+

JSON files for stream lists in each channel.

+
~/.config/streamtuner2/icons/*.png
+

Holds downloaded favicons for station homepages.

+
+
+
+

Installation spread

+
+
/usr/bin/streamtuner2
+

Is the main binary.

+
/usr/share/streamtuner2/
+

Contains the individual ST2 python modules, and plugins in channels/. Also packages in pyquery/, but which is only used if the according modules aren't installed by the distribution.

+
/usr/share/doc/streamtuner2/
+

Contains the README, and Mallard/gnome-help/yelp files under help/.

+
+
+
+

Public Domain

+

There is no licensing requirement with this application. All code can be copied, modified + and distributed unrestrictively.

+
+ +
+
+
+
+
+ ADDED help/html/timer.html Index: help/html/timer.html ================================================================== --- help/html/timer.html +++ help/html/timer.html @@ -0,0 +1,72 @@ + + + + +Timer + + + +
+
+
+

Timer

+
+
+

You can programm play/recording events with the timer plugin. Simply select a station + and choose Station ▸ Extensions ▸ Add timer.... + A small popup will ask for a data/time string. If you press OK the station + and the programmed time + will be stored in the bookmarks channel in the "timer" category.

+

Note that streamtuner2 must be running for the programmed timer events to work. + (In a future version there might be the option to have it handled by the system cron + daemon.)

+
+
+

Time specification strings

+
+

The time and date specificators follow a simple scheme. It's always one or more day names + followed by a clock range, and finally the action.

+

For example "Mon,Tue,Wed" will make the event occour on the first + three days of each week, while just "Fri" would limit it to Fridays.

+

A clock range of "18:00-20:00" + would start the event at 18 o'clock and last it two hours. Note that for "play" events, the end + time is irrelevant, since streamtuner2 can't kill your audio player anyway.

+

The end time is only important, if you replace "play" with the word "record" + in the timer event string. This runs streamripper instead and limits the recording time.

+
+
+
+

Editing events

+
+

You can remove entries from the "timer" list again. Use the normal Edit ▸ Delete for + that. It's also possible to modify the date+time strings by editing the stream info and + the specification in the "playing" field.

+

However, such changes don't take effect until you restart streamtuner2. The timer + events are only scheduled when adding a new event, or on starting streamtuner2.

+
+
+ +
+
+
+
+
+ ADDED help/html/xiph.html Index: help/html/xiph.html ================================================================== --- help/html/xiph.html +++ help/html/xiph.html @@ -0,0 +1,56 @@ + + + + +Xiph.org + + + +
+
+
+

Xiph.org

+
+
+

Xiph.org is a non-profit organization, which develops and promotes the OGG audio format. + It also hosts a list of ICEcast streaming stations (ICEcast is the non-commercial pendant + to the SHOUTcast server.)

+

This channel is especially easy to read by Streamtuner2, because the source data is already + provided as <XML> file. However, it lacks some essential informaitons like station + homepages and listener numbers.

+

Xiph also uses the .xspf format, instead of .pls stream links

+
+

Channel options.

+
+
Filter by minimum bitrate
+

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 set this option. OGG starts to sound good with 128 kbit/s (whereas + MP3 often needs 192 at least).

+
+
+
+ +
+
+
+
+
+ ADDED help/html/yelp-note-tip.png Index: help/html/yelp-note-tip.png ================================================================== --- help/html/yelp-note-tip.png +++ help/html/yelp-note-tip.png cannot compute difference between binary files ADDED help/html/yelp-note-warning.png Index: help/html/yelp-note-warning.png ================================================================== --- help/html/yelp-note-warning.png +++ help/html/yelp-note-warning.png cannot compute difference between binary files ADDED help/html/yelp-note.png Index: help/html/yelp-note.png ================================================================== --- help/html/yelp-note.png +++ help/html/yelp-note.png cannot compute difference between binary files ADDED help/html/yelp.js Index: help/html/yelp.js ================================================================== --- help/html/yelp.js +++ help/html/yelp.js @@ -0,0 +1,518 @@ + +var __yelp_generate_id_counter__ = 0; +function yelp_generate_id () { + var ret = 'yelp--' + (++__yelp_generate_id_counter__).toString(); + if ($('#' + ret).length != 0) + return yelp_generate_id(); + else + return ret; +}; +$(document).ready (function () { + var highlight_hash = function () { + if (location.hash != '') { + var sect = $(location.hash); + sect.css('background-color', '#fffacc'); + window.setTimeout(function () { + sect.css({ + '-webkit-transition': 'background-color 2s linear', + '-moz-transition': 'background-color 2s linear', + 'transition': 'background-color 2s linear', + 'background-color': 'rgba(1, 1, 1, 0)' + }); + }, 200); + } + }; + $(window).bind('hashchange', highlight_hash); + highlight_hash(); +}); + +$.fn.yelp_ui_expander_toggle = function (onlyopen, callback) { + var expander = $(this); + var region = expander.children('.inner').children('.region'); + var yelpdata = expander.children('div.yelp-data-ui-expander'); + var compfunc = function () { + if (expander.is('div.figure')) { expander.yelp_auto_resize(); } + if (callback) { callback(); } + return true; + }; + var title = expander.children('.inner').children('.title'); + if (title.length == 0) + title = expander.children('.inner').children('.hgroup'); + var title = title.find('span.title:first'); + if (expander.is('.ui-expander-e')) { + if (!onlyopen) { + expander.removeClass('ui-expander-e').addClass('ui-expander-c'); + region.attr('aria-expanded', 'false').slideUp('fast', compfunc); + title.html(yelpdata.children('div.yelp-title-collapsed').html()); + } + } + else { + expander.removeClass('ui-expander-c').addClass('ui-expander-e'); + region.attr('aria-expanded', 'true').slideDown('fast', compfunc); + title.html(yelpdata.children('div.yelp-title-expanded').html()); + } +}; +$(document).ready(function () { + $('.ui-expander').each(function () { + var expander = $(this); + var yelpdata = expander.children('div.yelp-data-ui-expander'); + var region = expander.children('.inner').children('.region'); + var title = expander.children('.inner').children('.title'); + var issect = false; + if (title.length == 0) { + title = expander.children('.inner').children('.hgroup'); + issect = true; + } + if (title.length == 0) { + return; + } + if (region.attr('id') == '') + region.attr('id', yelp_generate_id()); + title.attr('role', 'button').attr('aria-controls', region.attr('id')); + var titlespan = title.find('span.title:first'); + var title_e = yelpdata.children('div.yelp-title-expanded'); + var title_c = yelpdata.children('div.yelp-title-collapsed'); + if (title_e.length == 0) + yelpdata.append($('
').html(titlespan.html())); + if (title_c.length == 0) + yelpdata.append($('
').html(titlespan.html())); + if (yelpdata.attr('data-yelp-expanded') == 'false') { + expander.addClass('ui-expander-c'); + region.attr('aria-expanded', 'false').hide(); + if (title_c.length != 0) + titlespan.html(title_c.html()); + } else { + expander.addClass('ui-expander-e'); + region.attr('aria-expanded', 'true'); + if (title_e.length != 0) + titlespan.html(title_e.html()); + } + title.click(function () { + expander.yelp_ui_expander_toggle(false); + }); + }); +}); +$(document).ready(function () { + var expand_hash = function () { + if (location.hash != '') { + var target = $(location.hash); + var parents = target.parents('div.ui-expander'); + if (target.is('div.ui-expander')) + parents = parents.andSelf(); + parents.each(function () { + $(this).yelp_ui_expander_toggle(true, function () { + window.scrollTo(0, $(target).offset().top); + }); + }); + } + }; + $(window).bind('hashchange', expand_hash); + expand_hash(); +}); + +yelp_color_text_light = '#2e3436'; +yelp_color_gray_background = '#f3f3f0'; +yelp_color_gray_border = '#babdb6'; +yelp_paint_zoom = function (zoom, zoomed) { + var ctxt = zoom.children('canvas')[0].getContext('2d'); + ctxt.strokeStyle = ctxt.fillStyle = yelp_color_text_light; + ctxt.clearRect(0, 0, 10, 10); + ctxt.strokeRect(0.5, 0.5, 9, 9); + if (zoomed) { + ctxt.fillRect(1, 1, 9, 4); + ctxt.fillRect(5, 5, 4, 4); + zoom.attr('title', zoom.attr('data-zoom-out-title')); + } + else { + ctxt.fillRect(1, 5, 4, 4); + zoom.attr('title', zoom.attr('data-zoom-in-title')); + } +} +$.fn.yelp_auto_resize = function () { + var fig = $(this); + if (fig.is('img')) + fig = fig.parents('div.figure').eq(0); + if (fig.data('yelp-zoom-timeout') != undefined) { + clearInterval(fig.data('yelp-zoom-timeout')); + fig.removeData('yelp-zoom-timeout'); + } + var imgs = fig.find('img'); + for (var i = 0; i < imgs.length; i++) { + var img = $(imgs[i]); + if (img.data('yelp-load-bound') == true) + img.unbind('load', fig.yelp_auto_resize); + if (!imgs[i].complete) { + img.data('yelp-load-bound', true); + img.bind('load', fig.yelp_auto_resize); + return false; + } + } + $(window).unbind('resize', yelp_resize_imgs); + var zoom = fig.children('div.inner').children('a.zoom'); + if (fig.find('div.contents:first').is(':hidden')) { + zoom.hide(); + return; + } + for (var i = 0; i < imgs.length; i++) { + var img = $(imgs[i]); + if (img.data('yelp-original-width') == undefined) { + var iwidth = parseInt(img.attr('width')); + if (!iwidth) + iwidth = img[0].width; + img.data('yelp-original-width', iwidth); + var iheight = parseInt(img.attr('height')); + if (!iheight) + iheight = img[0].height * (iwidth / img[0].width); + img.data('yelp-original-height', iheight); + } + if (img.data('yelp-original-width') > img.parent().width()) { + if (img.data('yelp-zoomed') != true) { + img[0].width = img.parent().width(); + img[0].height = (parseInt(img.data('yelp-original-height')) * + img.width() / parseInt(img.data('yelp-original-width'))); + } + zoom.show(); + } + else { + img[0].width = img.data('yelp-original-width'); + img[0].height = img.data('yelp-original-height'); + zoom.hide(); + } + } + /* The image scaling above can cause the window to resize if it causes + * scrollbars to disappear or reapper. Unbind the resize handler before + * scaling the image. Don't rebind immediately, because we'll still get + * that resize event in an idle. Rebind on the callback instead. + */ + var reresize = function () { + $(window).unbind('resize', reresize); + $(window).bind('resize', yelp_resize_imgs); + } + $(window).bind('resize', reresize); + return false; +}; +yelp_resize_imgs = function () { + $('div.figure img').parents('div.figure').each(function () { + var div = $(this); + if (div.data('yelp-zoom-timeout') == undefined) + div.data('yelp-zoom-timeout', setTimeout(function () { div.yelp_auto_resize() }, 1)); + }); + return false; +}; +$(document).ready(function () { + $('div.figure img').parents('div.figure').each(function () { + var fig = $(this); + var zoom = fig.children('div.inner').children('a.zoom'); + zoom.append($('')); + yelp_paint_zoom(zoom, false); + zoom.data('yelp-zoomed', false); + zoom.click(function () { + var zoomed = !zoom.data('yelp-zoomed'); + zoom.data('yelp-zoomed', zoomed); + zoom.parent().find('img').each(function () { + var zimg = $(this); + zimg.data('yelp-zoomed', zoomed); + if (zoomed) { + zimg[0].width = zimg.data('yelp-original-width'); + zimg[0].height = zimg.data('yelp-original-height'); + } else { + zimg[0].width = zimg.parent().width(); + zimg[0].height = (parseInt(zimg.data('yelp-original-height')) * + zimg.width() / parseInt(zimg.data('yelp-original-width'))); + } + yelp_paint_zoom(zoom, zoomed); + }); + return false; + }); + }); + yelp_resize_imgs(); + $(window).bind('resize', yelp_resize_imgs); +}); +function yelp_init_video (element) { + var video = $(element); + video.removeAttr('controls'); + + var controls = $('
'); + var playControl = $('').attr({ + 'data-play-label': video.attr('data-play-label'), + 'data-pause-label': video.attr('data-pause-label'), + 'value': video.attr('data-play-label') + }); + var playCanvas = $(''); + playControl.append(playCanvas); + var rangeCanvas = $(''); + var rangeCanvasCtxt = rangeCanvas[0].getContext('2d'); + rangeCanvasCtxt.strokeStyle = yelp_color_gray_border; + rangeCanvasCtxt.strokeWidth = 1; + rangeCanvasCtxt.strokeRect(0.5, 0.5, 103, 19); + var currentSpan = $('0:00'); + var durationSpan = $('-:--'); + controls.append(playControl, + $('
').append(rangeCanvas), + $('
').append(currentSpan, durationSpan)); + video.after(controls); + + var playCanvasCtxt = playCanvas[0].getContext('2d'); + var paintPlayButton = function () { + playCanvasCtxt.fillStyle = yelp_color_gray_background; + playCanvasCtxt.clearRect(0, 0, 20, 20); + playCanvasCtxt.beginPath(); + playCanvasCtxt.moveTo(5, 5); playCanvasCtxt.lineTo(5, 15); + playCanvasCtxt.lineTo(15, 10); playCanvasCtxt.lineTo(5, 5); + playCanvasCtxt.fill(); + } + var paintPauseButton = function () { + playCanvasCtxt.fillStyle = yelp_color_gray_background; + playCanvasCtxt.clearRect(0, 0, 20, 20); + playCanvasCtxt.beginPath(); + playCanvasCtxt.moveTo(5, 5); playCanvasCtxt.lineTo(9, 5); + playCanvasCtxt.lineTo(9, 15); playCanvasCtxt.lineTo(5, 15); + playCanvasCtxt.lineTo(5, 5); playCanvasCtxt.fill(); + playCanvasCtxt.beginPath(); + playCanvasCtxt.moveTo(11, 5); playCanvasCtxt.lineTo(15, 5); + playCanvasCtxt.lineTo(15, 15); playCanvasCtxt.lineTo(11, 15); + playCanvasCtxt.lineTo(11, 5); playCanvasCtxt.fill(); + } + paintPlayButton(); + + var video_el = video[0]; + var mediaChange = function () { + if (video_el.ended) + video_el.pause() + if (video_el.paused) { + playControl.attr('value', playControl.attr('data-play-label')); + paintPlayButton(); + } + else { + playControl.attr('value', playControl.attr('data-pause-label')); + paintPauseButton(); + } + } + video_el.addEventListener('play', mediaChange, false); + video_el.addEventListener('pause', mediaChange, false); + video_el.addEventListener('ended', mediaChange, false); + + var playClick = function () { + if (video_el.paused || video_el.ended) + video_el.play(); + else + video_el.pause(); + }; + playControl.click(playClick); + + var ttmlDiv = video.parent().children('div.media-ttml'); + var ttmlNodes = ttmlDiv.find('.media-ttml-node'); + + var timeUpdate = function () { + var pct = (element.currentTime / element.duration) * 100; + rangeCanvasCtxt.fillStyle = yelp_color_gray_border; + rangeCanvasCtxt.clearRect(2, 2, 100, 16); + rangeCanvasCtxt.fillRect(2, 2, pct, 16); + var mins = parseInt(element.currentTime / 60); + var secs = parseInt(element.currentTime - (60 * mins)) + currentSpan.text(mins + (secs < 10 ? ':0' : ':') + secs); + ttmlNodes.each(function () { + var ttml = this; + if (element.currentTime >= parseFloat(ttml.getAttribute('data-ttml-begin')) && + (!ttml.hasAttribute('data-ttml-end') || + element.currentTime < parseFloat(ttml.getAttribute('data-ttml-end')) )) { + if (ttml.tagName == 'span') + ttml.style.display = 'inline'; + else + ttml.style.display = 'block'; + } + else { + ttml.style.display = 'none'; + } + }); + }; + element.addEventListener('timeupdate', timeUpdate, false); + var durationUpdate = function () { + if (!isNaN(element.duration)) { + mins = parseInt(element.duration / 60); + secs = parseInt(element.duration - (60 * mins)); + durationSpan.text(mins + (secs < 10 ? ':0' : ':') + secs); + } + }; + element.addEventListener('durationchange', durationUpdate, false); + + rangeCanvas.click(function (event) { + var pct = event.clientX - Math.floor(rangeCanvas.offset().left); + if (pct < 0) + pct = 0; + if (pct > 100) + pct = 100; + element.currentTime = (pct / 100.0) * element.duration; + }); +}; +$(document).ready(function () { + $('video, audio').each(function () { yelp_init_video(this) });; +}); + +$(document).ready( function () { jQuery.syntax({root: '', blockLayout: 'yelp', +theme: false, linkify: false}); }); + +$(document).ready(function () { + $('input.facet').change(function () { + var control = $(this); + var content = control.closest('div.body,div.sect'); + content.find('.facet-link').each(function () { + var link = $(this); + var facets = link.parents('div.body,div.sect').children('div.region').children('div.contents').children('div.facets').children('div.facet'); + var visible = true; + for (var i = 0; i < facets.length; i++) { + var facet = facets.slice(i, i + 1); + var facetvis = false; + var inputs = facet.find('input.facet:checked'); + for (var j = 0; j < inputs.length; j++) { + var input = inputs.slice(j, j + 1); + var inputvis = false; + var key = input.attr('data-facet-key'); + var values = input.attr('data-facet-values').split(' '); + for (var k = 0; k < values.length; k++) { + if (link.is('*[data-facet-' + key + ' ~= "' + values[k] + '"]')) { + inputvis = true; + break; + } + } + if (inputvis) { + facetvis = true; + break; + } + } + if (!facetvis) { + visible = false; + break; + } + } + if (!visible) + link.hide('fast'); + else + link.show('fast'); + }); + }); +}); + +$(document).ready(function () { + $('a.gloss-term').each(function () { + if ($(this).attr('href') == '#') { + $(this).click(function () { return false; }); + } + var showtip = function () { + var desc = $(this).children('span.gloss-desc'); + if (desc.is(':visible')) + return; + var top = $(this).offset().top + $(this).height() + 1; + var left = $(this).offset().left; + var cnt = $(this).closest('div.contents'); + var diff = cnt.offset().left + cnt.width() - desc.width() - 4; + if (left > diff) + left = diff; + desc.css({'top': top + 'px', 'left': left + 'px'}).fadeIn('slow'); + }; + var hidetip = function () { + if ($(this).is(':focus')) + return; + $(this).children('span.gloss-desc').fadeOut('fast'); + }; + $(this).hover(showtip, hidetip); + $(this).focus(showtip); + $(this).blur(hidetip); + }); +}); + +$(document).ready(function () { + $('div.mouseovers').each(function () { + var contdiv = $(this); + var width = 0; + var height = 0; + contdiv.find('img').each(function () { + if ($(this).attr('data-yelp-match') == '') + $(this).show(); + }); + contdiv.next('ul').find('a').each(function () { + var mlink = $(this); + mlink.hover( + function () { + if (contdiv.is(':visible')) { + var offset = contdiv.offset(); + mlink.find('img').css({left: offset.left, top: offset.top, zIndex: 10}); + mlink.find('img').fadeIn('fast'); + } + }, + function () { + mlink.find('img').fadeOut('fast'); + } + ); + }); + }); + $('div.links-ui-hover').each(function () { + var contdiv = $(this); + var width = 0; + var height = 0; + contdiv.next('ul').find('a').each(function () { + var mlink = $(this); + mlink.hover( + function () { + if (contdiv.is(':visible')) { + var offset = contdiv.offset(); + mlink.find('img').parent('span').css({left: offset.left, top: offset.top, zIndex: 10}); + mlink.find('img').parent('span').show(); + } + }, + function () { + mlink.find('img').parent('span').hide(); + } + ); + }); + }); + $('a.ui-overlay').each(function () { + $(this).click(function () { + var overlay = $(this).parent('div').children('div.ui-overlay'); + var inner = overlay.children('div.inner'); + var close = inner.children('a.ui-overlay-close'); + var media = inner.find('audio, video'); + var screen = $('div.ui-screen'); + if (screen.length == 0) { + screen = $('
'); + $('body').append(screen); + } + var hideoverlay = function () { + if (media.length > 0) + media[0].pause(); + $(document).unbind('keydown.yelp-ui-overlay'); + close.unbind('click'); + screen.unbind('click'); + screen.fadeOut('slow'); + overlay.unbind('click'); + overlay.slideUp('fast'); + return false; + }; + screen.click(hideoverlay); + close.click(hideoverlay); + $(document).bind('keydown.yelp-ui-overlay', function (event) { + if (event.which == 27) { + hideoverlay(); + } + }); + overlay.click(function (event) { + var target = event.target; + do { + if (target == inner[0]) { + break; + } + } while (target = target.parentNode); + if (target != inner[0]) { + hideoverlay(); + return false; + } + }); + screen.fadeIn('slow'); + overlay.slideDown('fast', function () { + if (media.length > 0) + media[0].play(); + }); + return false; + }); + }); +}); Index: help/streamtuner2.1 ================================================================== --- help/streamtuner2.1 +++ help/streamtuner2.1 @@ -1,6 +1,5 @@ -.\" this is one of the nanoweb man pages .\" (many thanks to the manpage howto!) .\" .TH streamtuner2 "January 2014" "BSD/Linux" "User Manuals" .SH NAME streamtuner2 \- Browser for internet radio stations @@ -58,14 +57,23 @@ returns all info about the first match as JSON output. .TP .BI streamtuner2 " play frequence3" Looks for the first occourence, and starts the audio player for FREQUENCE3. + +.SH GRAPHICAL MODE + +There's only one option for the graphical UI mode: +.TP +.BI --gtk3 +Loads Gtk3 via PyGI instead of Gtk2. This is implicit when running on Python3 +anyway. + .SH FILES .IR /home/ $USER /.config/streamtuner2/settings.json .SH "SEE ALSO" .BR streamripper (1) .BR audacious (1) .BR json (5) .BR m3u (5) .BR pls (5) Index: help/technical.page ================================================================== --- help/technical.page +++ help/technical.page @@ -11,18 +11,19 @@
Dependencies -

Python 2.5

 -

PyGtk

 -

Gtk+ 2.12

 +

Python 2.7 or 3.x

 +

PyGtk or PyGI

 +

Gtk2 or Gtk3

 Soft dependencies

Python-LXML

Python-PyQuery

 +

Python-Kronos

Audacious
@@ -46,11 +47,11 @@ ~/.config/streamtuner2/state.json

Last category in each channel tab.

~/.config/streamtuner2/bookmarks.json -

Is a separate cahce file for your bookmarked/favourite radio stations.

+

Is a separate cache file for your bookmarked/favourite radio stations.

 ~/.config/streamtuner2/cache/***.json

JSON files for stream lists in each channel.

 @@ -81,11 +82,13 @@
Public Domain -

There is no licensing requirement with this application. All code can be copied, modified +

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.

+

The bundled kronos.py and requests/ library are NOT however.

DELETED http.py Index: http.py ================================================================== --- http.py +++ http.py @@ -1,224 +0,0 @@ -# -# encoding: UTF-8 -# api: streamtuner2 -# type: functions -# title: http download / methods -# description: http utility -# version: 1.3 -# -# Provides a http GET method with gtk.statusbar() callback. -# And a function to add trailings slashes on http URLs. -# -# The latter code is pretty much unreadable. But let's put the -# blame on urllib2, the most braindamaged code in the Python -# standard library. -# - -try: - import urllib2 - from urllib import urlencode -except: - import urllib.request as urllib2 - import urllib.parse.urlencode as urlencode -import config -from config import __print__, dbg - - - -#-- url download --------------------------------------------- - - - -#-- chains to progress meter and status bar in main window -feedback = None - -# sets either text or percentage, so may take two parameters -def progress_feedback(*args): - - # use reset values if none given - if not args: - args = ["", 1.0] - - # send to main win - if feedback: - try: [feedback(d) for d in args] - except: pass - - - - -#-- GET -def get(url, maxsize=1<<19, feedback="old"): - __print__("GET", url) - - # statusbar info - progress_feedback(url, 0.0) - - # read - content = "" - f = urllib2.urlopen(url) - max = 222000 # mostly it's 200K, but we don't get any real information - read_size = 1 - - # multiple steps - while (read_size and len(content) < maxsize): - - # partial read - add = f.read(8192) - content = content + add - read_size = len(add) - - # set progress meter - progress_feedback(float(len(content)) / float(max)) - - # done - - # clean statusbar - progress_feedback() - - # fin - __print__(len(content)) - return content - - - - - -#-- fix invalid URLs -def fix_url(url): - if url is None: - url = "" - if len(url): - # remove whitespace - url = url.strip() - # add scheme - if (url.find("://") < 0): - url = "http://" + url - # add mandatory path - if (url.find("/", 10) < 0): - url = url + "/" - return url - - - - -# default HTTP headers for AJAX/POST request -default_headers = { - "User-Agent": "streamtuner2/2.1 (X11; U; Linux AMD64; en; rv:1.5.0.1) like WinAmp/2.1 but not like Googlebot/2.1", #"Mozilla/5.0 (X11; U; Linux x86_64; de; rv:1.9.2.6) Gecko/20100628 Ubuntu/10.04 (lucid) Firefox/3.6.6", - "Accept": "*/*;q=0.5, audio/*, url/*", - "Accept-Language": "en-US,en,de,es,fr,it,*;q=0.1", - "Accept-Encoding": "gzip,deflate", - "Accept-Charset": "ISO-8859-1,utf-8;q=0.7,*;q=0.1", - "Keep-Alive": "115", - "Connection": "keep-alive", - #"Content-Length", "56", - #"Cookie": "s_pers=%20s_getnr%3D1278607170446-Repeat%7C1341679170446%3B%20s_nrgvo%3DRepeat%7C1341679170447%3B; s_sess=%20s_cc%3Dtrue%3B%20s_sq%3Daolshtcst%252Caolsvc%253D%252526pid%25253Dsht%25252520%2525253A%25252520SHOUTcast%25252520Radio%25252520%2525257C%25252520Search%25252520Results%252526pidt%25253D1%252526oid%25253Dfunctiononclick%25252528event%25252529%2525257BshowMoreGenre%25252528%25252529%2525253B%2525257D%252526oidt%25253D2%252526ot%25253DDIV%3B; aolDemoChecked=1.849061", - "Pragma": "no-cache", - "Cache-Control": "no-cache", -} - - - -# simulate ajax calls -def ajax(url, post, referer=""): - - # request - headers = default_headers - headers.update({ - "Content-Type": "application/x-www-form-urlencoded; charset=UTF-8", - "X-Requested-With": "XMLHttpRequest", - "Referer": (referer if referer else url), - }) - if type(post) == dict: - post = urlencode(post) - request = urllib2.Request(url, post, headers) - - # open url - __print__( vars(request) ) - progress_feedback(url, 0.2) - r = urllib2.urlopen(request) - - # get data - __print__( r.info() ) - progress_feedback(0.5) - data = r.read() - progress_feedback() - return data - - - -# http://techknack.net/python-urllib2-handlers/ -from gzip import GzipFile -from StringIO import StringIO -class ContentEncodingProcessor(urllib2.BaseHandler): - """A handler to add gzip capabilities to urllib2 requests """ - - # add headers to requests - def http_request(self, req): - req.add_header("Accept-Encoding", "gzip, deflate") - return req - - # decode - def http_response(self, req, resp): - old_resp = resp - # gzip - if resp.headers.get("content-encoding") == "gzip": - gz = GzipFile( - fileobj=StringIO(resp.read()), - mode="r" - ) - resp = urllib2.addinfourl(gz, old_resp.headers, old_resp.url, old_resp.code) - resp.msg = old_resp.msg - # deflate - if resp.headers.get("content-encoding") == "deflate": - gz = StringIO( deflate(resp.read()) ) - resp = urllib2.addinfourl(gz, old_resp.headers, old_resp.url, old_resp.code) # 'class to add info() and geturl() methods to an open file.' - resp.msg = old_resp.msg - return resp - -# deflate support -import zlib -def deflate(data): # zlib only provides the zlib compress format, not the deflate format; - try: # so on top of all there's this workaround: - return zlib.decompress(data, -zlib.MAX_WBITS) - except zlib.error: - return zlib.decompress(data) - - - - - - - -#-- init for later use -if urllib2: - - # config 1 - handlers = [None, None, None] - - # base - handlers[0] = urllib2.HTTPHandler() - if config.conf.debug: - handlers[0].set_http_debuglevel(3) - - # content-encoding - handlers[1] = ContentEncodingProcessor() - - # store cookies at runtime - import cookielib - cj = cookielib.CookieJar() - handlers[2] = urllib2.HTTPCookieProcessor( cj ) - - # inject into urllib2 - urllib2.install_opener( urllib2.build_opener(*handlers) ) - - - - -# alternative function names -AJAX=ajax -POST=ajax -GET=get -URL=fix_url - - DELETED kronos.py Index: kronos.py ================================================================== --- kronos.py +++ kronos.py @@ -1,578 +0,0 @@ -"""Module that provides a cron-like task scheduler. - -This task scheduler is designed to be used from inside your own program. -You can schedule Python functions to be called at specific intervals or -days. It uses the standard 'sched' module for the actual task scheduling, -but provides much more: - -* repeated tasks (at intervals, or on specific days) -* error handling (exceptions in tasks don't kill the scheduler) -* optional to run scheduler in its own thread or separate process -* optional to run a task in its own thread or separate process - -If the threading module is available, you can use the various Threaded -variants of the scheduler and associated tasks. If threading is not -available, you could still use the forked variants. If fork is also -not available, all processing is done in a single process, sequentially. - -There are three Scheduler classes: - - Scheduler ThreadedScheduler ForkedScheduler - -You usually add new tasks to a scheduler using the add_interval_task or -add_daytime_task methods, with the appropriate processmethod argument -to select sequential, threaded or forked processing. NOTE: it is impossible -to add new tasks to a ForkedScheduler, after the scheduler has been started! -For more control you can use one of the following Task classes -and use schedule_task or schedule_task_abs: - - IntervalTask ThreadedIntervalTask ForkedIntervalTask - SingleTask ThreadedSingleTask ForkedSingleTask - WeekdayTask ThreadedWeekdayTask ForkedWeekdayTask - MonthdayTask ThreadedMonthdayTask ForkedMonthdayTask - -Kronos is the Greek God of Time. - -Kronos scheduler (c) Irmen de Jong. -This version has been extracted from the Turbogears source repository -and slightly changed to be completely stand-alone again. Also some fixes -have been made to make it work on Python 2.6 (sched module changes). -The version in Turbogears is based on the original stand-alone Kronos. -This is open-source software, released under the MIT Software License: -http://www.opensource.org/licenses/mit-license.php - -""" - -__version__="2.0" - -__all__ = [ - "DayTaskRescheduler", - "ForkedIntervalTask", - "ForkedMonthdayTask", - "ForkedScheduler", - "ForkedSingleTask", - "ForkedTaskMixin", - "ForkedWeekdayTask", - "IntervalTask", - "MonthdayTask", - "Scheduler", - "SingleTask", - "Task", - "ThreadedIntervalTask", - "ThreadedMonthdayTask", - "ThreadedScheduler", - "ThreadedSingleTask", - "ThreadedTaskMixin", - "ThreadedWeekdayTask", - "WeekdayTask", - "add_interval_task", - "add_monthday_task", - "add_single_task", - "add_weekday_task", - "cancel", - "method", -] - -import os -import sys -import sched -import time -import traceback -import weakref - -class method: - sequential="sequential" - forked="forked" - threaded="threaded" - -class Scheduler: - """The Scheduler itself.""" - - def __init__(self): - self.running=True - self.sched = sched.scheduler(time.time, self.__delayfunc) - - def __delayfunc(self, delay): - # This delay function is basically a time.sleep() that is - # divided up, so that we can check the self.running flag while delaying. - # there is an additional check in here to ensure that the top item of - # the queue hasn't changed - if delay<10: - time.sleep(delay) - else: - toptime = self._getqueuetoptime() - endtime = time.time() + delay - period = 5 - stoptime = endtime - period - while self.running and stoptime > time.time() and \ - self._getqueuetoptime() == toptime: - time.sleep(period) - if not self.running or self._getqueuetoptime() != toptime: - return - now = time.time() - if endtime > now: - time.sleep(endtime - now) - - def _acquire_lock(self): - pass - - def _release_lock(self): - pass - - def add_interval_task(self, action, taskname, initialdelay, interval, - processmethod, args, kw): - """Add a new Interval Task to the schedule. - - A very short initialdelay or one of zero cannot be honored, you will - see a slight delay before the task is first executed. This is because - the scheduler needs to pick it up in its loop. - - """ - if initialdelay < 0 or interval < 1: - raise ValueError("Delay or interval must be >0") - # Select the correct IntervalTask class. Not all types may be available! - if processmethod == method.sequential: - TaskClass = IntervalTask - elif processmethod == method.threaded: - TaskClass = ThreadedIntervalTask - elif processmethod == method.forked: - TaskClass = ForkedIntervalTask - else: - raise ValueError("Invalid processmethod") - if not args: - args = [] - if not kw: - kw = {} - task = TaskClass(taskname, interval, action, args, kw) - self.schedule_task(task, initialdelay) - return task - - def add_single_task(self, action, taskname, initialdelay, processmethod, - args, kw): - """Add a new task to the scheduler that will only be executed once.""" - if initialdelay < 0: - raise ValueError("Delay must be >0") - # Select the correct SingleTask class. Not all types may be available! - if processmethod == method.sequential: - TaskClass = SingleTask - elif processmethod == method.threaded: - TaskClass = ThreadedSingleTask - elif processmethod == method.forked: - TaskClass = ForkedSingleTask - else: - raise ValueError("Invalid processmethod") - if not args: - args = [] - if not kw: - kw = {} - task = TaskClass(taskname, action, args, kw) - self.schedule_task(task, initialdelay) - return task - - def add_daytime_task(self, action, taskname, weekdays, monthdays, timeonday, - processmethod, args, kw): - """Add a new Day Task (Weekday or Monthday) to the schedule.""" - if weekdays and monthdays: - raise ValueError("You can only specify weekdays or monthdays, " - "not both") - if not args: - args = [] - if not kw: - kw = {} - if weekdays: - # Select the correct WeekdayTask class. - # Not all types may be available! - if processmethod == method.sequential: - TaskClass = WeekdayTask - elif processmethod == method.threaded: - TaskClass = ThreadedWeekdayTask - elif processmethod == method.forked: - TaskClass = ForkedWeekdayTask - else: - raise ValueError("Invalid processmethod") - task=TaskClass(taskname, weekdays, timeonday, action, args, kw) - if monthdays: - # Select the correct MonthdayTask class. - # Not all types may be available! - if processmethod == method.sequential: - TaskClass = MonthdayTask - elif processmethod == method.threaded: - TaskClass = ThreadedMonthdayTask - elif processmethod == method.forked: - TaskClass = ForkedMonthdayTask - else: - raise ValueError("Invalid processmethod") - task=TaskClass(taskname, monthdays, timeonday, action, args, kw) - firsttime=task.get_schedule_time(True) - self.schedule_task_abs(task, firsttime) - return task - - def schedule_task(self, task, delay): - """Add a new task to the scheduler with the given delay (seconds). - - Low-level method for internal use. - - """ - if self.running: - # lock the sched queue, if needed - self._acquire_lock() - try: - task.event = self.sched.enter(delay, 0, task, - (weakref.ref(self),) ) - finally: - self._release_lock() - else: - task.event = self.sched.enter(delay, 0, task, - (weakref.ref(self),) ) - - def schedule_task_abs(self, task, abstime): - """Add a new task to the scheduler for the given absolute time value. - - Low-level method for internal use. - - """ - if self.running: - # lock the sched queue, if needed - self._acquire_lock() - try: - task.event = self.sched.enterabs(abstime, 0, task, - (weakref.ref(self),) ) - finally: - self._release_lock() - else: - task.event = self.sched.enterabs(abstime, 0, task, - (weakref.ref(self),) ) - - def start(self): - """Start the scheduler.""" - self._run() - - def stop(self): - """Remove all pending tasks and stop the Scheduler.""" - self.running = False - self._clearschedqueue() - - def cancel(self, task): - """Cancel given scheduled task.""" - self.sched.cancel(task.event) - - if sys.version_info>=(2,6): - # code for sched module of python 2.6+ - def _getqueuetoptime(self): - return self.sched._queue[0].time - def _clearschedqueue(self): - self.sched._queue[:] = [] - else: - # code for sched module of python 2.5 and older - def _getqueuetoptime(self): - return self.sched.queue[0][0] - def _clearschedqueue(self): - self.sched.queue[:] = [] - - def _run(self): - # Low-level run method to do the actual scheduling loop. - while self.running: - try: - self.sched.run() - except Exception,x: - print >>sys.stderr, "ERROR DURING SCHEDULER EXECUTION",x - print >>sys.stderr, "".join( - traceback.format_exception(*sys.exc_info())) - print >>sys.stderr, "-" * 20 - # queue is empty; sleep a short while before checking again - if self.running: - time.sleep(5) - - -class Task: - """Abstract base class of all scheduler tasks""" - - def __init__(self, name, action, args, kw): - """This is an abstract class!""" - self.name=name - self.action=action - self.args=args - self.kw=kw - - def __call__(self, schedulerref): - """Execute the task action in the scheduler's thread.""" - try: - self.execute() - except Exception,x: - self.handle_exception(x) - self.reschedule(schedulerref()) - - def reschedule(self, scheduler): - """This method should be defined in one of the sub classes!""" - raise NotImplementedError("You're using the abstract base class 'Task'," - " use a concrete class instead") - - def execute(self): - """Execute the actual task.""" - self.action(*self.args, **self.kw) - - def handle_exception(self, exc): - """Handle any exception that occured during task execution.""" - print >>sys.stderr, "ERROR DURING TASK EXECUTION", exc - print >>sys.stderr, "".join(traceback.format_exception(*sys.exc_info())) - print >>sys.stderr, "-" * 20 - - -class SingleTask(Task): - """A task that only runs once.""" - - def reschedule(self, scheduler): - pass - - -class IntervalTask(Task): - """A repeated task that occurs at certain intervals (in seconds).""" - - def __init__(self, name, interval, action, args=None, kw=None): - Task.__init__(self, name, action, args, kw) - self.interval = interval - - def reschedule(self, scheduler): - """Reschedule this task according to its interval (in seconds).""" - scheduler.schedule_task(self, self.interval) - - -class DayTaskRescheduler: - """A mixin class that contains the reschedule logic for the DayTasks.""" - - def __init__(self, timeonday): - self.timeonday = timeonday - - def get_schedule_time(self, today): - """Calculate the time value at which this task is to be scheduled.""" - now = list(time.localtime()) - if today: - # schedule for today. let's see if that is still possible - if (now[3], now[4]) >= self.timeonday: - # too bad, it will be tomorrow - now[2] += 1 - else: - # tomorrow - now[2] += 1 - # set new time on day (hour,minute) - now[3], now[4] = self.timeonday - # seconds - now[5] = 0 - return time.mktime(now) - - def reschedule(self, scheduler): - """Reschedule this task according to the daytime for the task. - - The task is scheduled for tomorrow, for the given daytime. - - """ - # (The execute method in the concrete Task classes will check - # if the current day is a day on which the task must run). - abstime = self.get_schedule_time(False) - scheduler.schedule_task_abs(self, abstime) - - -class WeekdayTask(DayTaskRescheduler, Task): - """A task that is called at specific days in a week (1-7), at a fixed time - on the day. - - """ - - def __init__(self, name, weekdays, timeonday, action, args=None, kw=None): - if type(timeonday) not in (list, tuple) or len(timeonday) != 2: - raise TypeError("timeonday must be a 2-tuple (hour,minute)") - if type(weekdays) not in (list, tuple): - raise TypeError("weekdays must be a sequence of weekday numbers " - "1-7 (1 is Monday)") - DayTaskRescheduler.__init__(self, timeonday) - Task.__init__(self, name, action, args, kw) - self.days = weekdays - - def execute(self): - # This is called every day, at the correct time. We only need to - # check if we should run this task today (this day of the week). - weekday = time.localtime().tm_wday + 1 - if weekday in self.days: - self.action(*self.args, **self.kw) - - -class MonthdayTask(DayTaskRescheduler, Task): - """A task that is called at specific days in a month (1-31), at a fixed - time on the day. - - """ - - def __init__(self, name, monthdays, timeonday, action, args=None, kw=None): - if type(timeonday) not in (list, tuple) or len(timeonday) != 2: - raise TypeError("timeonday must be a 2-tuple (hour,minute)") - if type(monthdays) not in (list, tuple): - raise TypeError("monthdays must be a sequence of monthdays numbers " - "1-31") - DayTaskRescheduler.__init__(self, timeonday) - Task.__init__(self, name, action, args, kw) - self.days = monthdays - - def execute(self): - # This is called every day, at the correct time. We only need to - # check if we should run this task today (this day of the month). - if time.localtime().tm_mday in self.days: - self.action(*self.args, **self.kw) - - -try: - import threading - - class ThreadedScheduler(Scheduler): - """A Scheduler that runs in its own thread.""" - - def __init__(self): - Scheduler.__init__(self) - # we require a lock around the task queue - self._lock = threading.Lock() - - def start(self): - """Splice off a thread in which the scheduler will run.""" - self.thread = threading.Thread(target=self._run) - self.thread.setDaemon(True) - self.thread.start() - - def stop(self): - """Stop the scheduler and wait for the thread to finish.""" - Scheduler.stop(self) - try: - self.thread.join() - except AttributeError: - pass - - def _acquire_lock(self): - """Lock the thread's task queue.""" - self._lock.acquire() - - def _release_lock(self): - """Release the lock on th ethread's task queue.""" - self._lock.release() - - - class ThreadedTaskMixin: - """A mixin class to make a Task execute in a separate thread.""" - - def __call__(self, schedulerref): - """Execute the task action in its own thread.""" - threading.Thread(target=self.threadedcall).start() - self.reschedule(schedulerref()) - - def threadedcall(self): - # This method is run within its own thread, so we have to - # do the execute() call and exception handling here. - try: - self.execute() - except Exception,x: - self.handle_exception(x) - - class ThreadedIntervalTask(ThreadedTaskMixin, IntervalTask): - """Interval Task that executes in its own thread.""" - pass - - class ThreadedSingleTask(ThreadedTaskMixin, SingleTask): - """Single Task that executes in its own thread.""" - pass - - class ThreadedWeekdayTask(ThreadedTaskMixin, WeekdayTask): - """Weekday Task that executes in its own thread.""" - pass - - class ThreadedMonthdayTask(ThreadedTaskMixin, MonthdayTask): - """Monthday Task that executes in its own thread.""" - pass - -except ImportError: - # threading is not available - pass - - -if hasattr(os, "fork"): - import signal - - class ForkedScheduler(Scheduler): - """A Scheduler that runs in its own forked process.""" - - def __del__(self): - if hasattr(self, "childpid"): - os.kill(self.childpid, signal.SIGKILL) - - def start(self): - """Fork off a new process in which the scheduler will run.""" - pid = os.fork() - if pid == 0: - # we are the child - signal.signal(signal.SIGUSR1, self.signalhandler) - self._run() - os._exit(0) - else: - # we are the parent - self.childpid = pid - # can no longer insert in the scheduler queue - del self.sched - - def stop(self): - """Stop the scheduler and wait for the process to finish.""" - os.kill(self.childpid, signal.SIGUSR1) - os.waitpid(self.childpid, 0) - - def signalhandler(self, sig, stack): - Scheduler.stop(self) - - - class ForkedTaskMixin: - """A mixin class to make a Task execute in a separate process.""" - - def __call__(self, schedulerref): - """Execute the task action in its own process.""" - pid = os.fork() - if pid == 0: - # we are the child - try: - self.execute() - except Exception,x: - self.handle_exception(x) - os._exit(0) - else: - # we are the parent - self.reschedule(schedulerref()) - - - class ForkedIntervalTask(ForkedTaskMixin, IntervalTask): - """Interval Task that executes in its own process.""" - pass - - class ForkedSingleTask(ForkedTaskMixin, SingleTask): - """Single Task that executes in its own process.""" - pass - - class ForkedWeekdayTask(ForkedTaskMixin, WeekdayTask): - """Weekday Task that executes in its own process.""" - pass - - class ForkedMonthdayTask(ForkedTaskMixin, MonthdayTask): - """Monthday Task that executes in its own process.""" - pass - - - -if __name__=="__main__": - def testaction(arg): - print ">>>TASK",arg,"sleeping 3 seconds" - time.sleep(3) - print "<< gtk image object if (pix_entry and type(row[pix_entry]) == str): row[pix_entry] = ( gtk.gdk.pixbuf_new_from_file(row[pix_entry]) if os.path.exists(row[pix_entry]) else defaults[gtk.gdk.Pixbuf] ) try: @@ -184,11 +195,11 @@ ls.append(row) # had to be adapted for real TreeStore (would require additional input for grouping/level/parents) except: # brute-force typecast ls.append( [va if ty==gtk.gdk.Pixbuf else ty(va) for va,ty in zip(row,vartypes)] ) - __print__(row) + __print__("→", row, len(row)) # apply array to widget widget.set_model(ls) return ls @@ -205,18 +216,19 @@ @staticmethod def tree(widget, entries, title="category", icon=gtk.STOCK_DIRECTORY): # list types ls = gtk.TreeStore(str, str) + print(entries) # add entries for entry in entries: - if (type(entry) == str): - main = ls.append(None, [entry, icon]) + if isinstance(entry, (str,unicode)): + main = ls.append(None, [str(entry), icon]) else: for sub_title in entry: - ls.append(main, [sub_title, icon]) + ls.append(main, [str(sub_title), icon]) # just one column tvcolumn = gtk.TreeViewColumn(title); widget.append_column(tvcolumn) @@ -300,11 +312,11 @@ for wn in r.keys(): # widgetnames w = wTree.get_widget(wn) if (not w): continue t = type(w) - for method,args in r[wn].iteritems(): + for method,args in r[wn].items(): # gtk.Window if method == "size": w.resize(args[0], args[1]) # gtk.TreeView if method == "columns:width": Index: pq.py ================================================================== --- pq.py +++ pq.py @@ -17,11 +17,11 @@ from pyquery import PyQuery as pq # pq.each_pq = lambda self,func: self.each( lambda i,html: func( pq(html, parser="html") ) ) -except Exception, e: +except Exception as e: # disable use pq = None config.conf.pyquery = False DELETED pson.py Index: pson.py ================================================================== --- pson.py +++ pson.py @@ -1,100 +0,0 @@ -# -# encoding: UTF-8 -# api: python -# type: functions -# title: json emulation -# description: simplify usage of some gtk widgets -# version: 1.7 -# author: mario -# license: public domain -# -# -# This module provides the JSON api. If the python 2.6 module -# isn't available, it provides an emulation using str() and -# eval() and Python notation. (The representations are close.) -# -# Additionally it filters out any left-over objects. Sometimes -# pygtk-objects crawled into the streams[] lists, because rows -# might have been queried from the widgets. -# - - -#-- reading and writing json (for the config module) ---------------------------------- - -import sys -if sys.version_info > (2, 9): - unicode = str - #dict.iteritems = dict.items - -# try to load the system module first -try: - from json import dump as json_dump, load as json_load -except: - print("no native Python JSON module") - - -#except: - # pseudo-JSON implementation - # - the basic python data types dict,list,str,int are mostly identical to json - # - therefore a basic str() conversion is enough for writing - # - for reading the more bothersome eval() is used - # - it's however no severe security problem here, because we're just reading - # local config files (written by us) and accept no data from outside / web - # NOTE: This code is only used, if the Python json module (since 2.6) isn't there. - - -# store object in string representation into filepointer -def dump(obj, fp, indent=0): - - obj = filter_data(obj) - - try: - return json_dump(obj, fp, indent=indent, sort_keys=(indent and indent>0)) - except: - return fp.write(str(obj)) - # .replace("'}, ", "'},\n ") # add whitespace - # .replace("', ", "',\n ")) - # .replace("': [{'", "':\n[\n{'") - pass - - -# load from filepointer, decode string into dicts/list -def load(fp): - try: - #print("try json") - r = json_load(fp) - r = filter_data(r) # turn unicode() strings back into str() - pygtk does not accept u"strings" - except: - #print("fall back on pson") - fp.seek(0) - r = eval(fp.read(1<<27)) # max 128 MB - # print("fake json module: in python variable dump notation") - - if r == None: - r = {} - return r - - -# removes any objects, turns unicode back into str -def filter_data(obj): - if type(obj) in (int, float, bool, str): - return obj -# elif type(obj) == str: #->str->utf8->str -# return str(unicode(obj)) - elif type(obj) == unicode: - return str(obj) - elif type(obj) in (list, tuple, set): - obj = list(obj) - for i,v in enumerate(obj): - obj[i] = filter_data(v) - elif type(obj) == dict: - for i,v in list(obj.items()): - i = filter_data(i) - obj[i] = filter_data(v) - else: - print("invalid object in data, converting to string: ", type(obj), obj) - obj = str(obj) - return obj - - - Index: st2.py ================================================================== --- st2.py +++ st2.py @@ -2,12 +2,12 @@ # encoding: UTF-8 # api: python # type: application # title: streamtuner2 # description: directory browser for internet radio / audio streams -# depends: gtk, pygtk, xml.dom.minidom, threading, lxml, pyquery, kronos -# version: 2.0.9.5 +# depends: pygtk | pygi, threading, pyquery, kronos, requests +# version: 2.0.9.7 # author: mario salzer # license: public domain # url: http://freshmeat.net/projects/streamtuner2 # config: # category: multimedia @@ -30,24 +30,17 @@ """ project status """ # # The application runs mostly stable. The GUI interfaces are workable. +# It's supposed to run on Gtk2 and Gtk3. Python3 support is still WIP. # There haven't been any optimizations regarding memory usage and -# performance. The current internal API is acceptable. Documentation is -# coming up. +# performance. The current internal API is vastly undocumented. # # current bugs: # - audio- and list-format support is not very robust / needs better API -# - lots of GtkWarning messages # - not all keyboard shortcuts work -# - in-list search doesn't work in our treeviews (???) -# - JSON files are only trouble: loading of data files might lead to more -# errors now, even if pson module still falls back on old method -# (unicode strings from json.load are useless to us, require typecasts) -# (nonsupport of tuples led to regression in mygtk.app_restore) -# (sometimes we receive 8bit-content, which the json module can't save) # # features: # - treeview lists are created from datamap[] structure and stream{} dicts # - channel categories are built-in defaults (can be freshened up however) # - config vars and cache data get stored as JSON in ~/.config/streamtuner2/ @@ -66,24 +59,17 @@ # as they are passed to gtk.gdk.Pixbuf (OTOH data pre-filtered by Google) # - MEDIUM: audio players / decoders are easily affected by buffer overflows # from corrupt mp3/stream data, and streamtuner2 executes them # - but since that's the purpose -> no workaround # -# still help wanted on: -# - any of the above -# - new plugins (local file viewer) -# - nicer logo (or donations accepted to consult graphics designer) -# # standard modules import sys import os, os.path import re -import copy -import urllib # threading or processing module try: from processing import Process as Thread except: @@ -90,23 +76,23 @@ from threading import Thread Thread.stop = lambda self: None # add library path sys.path.insert(0, "/usr/share/streamtuner2") # pre-defined directory for modules -sys.path.insert(0, ".") # pre-defined directory for modules +sys.path.insert(0, "/usr/share/streamtuner2/bundle") # external libraries +sys.path.insert(0, ".") # development module path # gtk modules -from mygtk import pygtk, gtk, gobject, ui_file, mygtk +from mygtk import pygtk, gtk, gobject, ui_file, mygtk, ver as GTK_VER # custom modules from config import conf # initializes itself, so all conf.vars are available right away from config import __print__, dbg -import http +import ahttp import action # needs workaround... (action.main=main) from channels import * import favicon -#from pq import pq # this represents the main window # and also contains most application behaviour @@ -168,11 +154,11 @@ except: __print__(dbg.INIT, "main.__init__: current_channel.first_show() initialization error") # bind gtk/glade event names to functions gui_startup(19/20.0) - self.connect_signals(dict( { + self.connect_signals(dict( list({ "gtk_main_quit" : self.gtk_main_quit, # close window # treeviews / notebook "on_stream_row_activated" : self.on_play_clicked, # double click in a streams list "on_category_clicked": self.on_category_clicked, # new selection in category list "on_notebook_channels_switch_page": self.channel_switch, # channel notebook tab changed @@ -218,11 +204,11 @@ "true": lambda w,*args: True, "streamedit_open": streamedit.open, "streamedit_save": streamedit.save, "streamedit_new": streamedit.new, "streamedit_cancel": streamedit.cancel, - }.items() + self.add_signals.items() )) + }.items() ) + list( self.add_signals.items() ) )) # actually display main window gui_startup(99/100.0) self.win_streamtuner2.show() @@ -235,19 +221,19 @@ #-- Shortcut for glade.get_widget() # Allows access to widgets as direct attributes instead of using .get_widget() # Also looks in self.channels[] for the named channel plugins def __getattr__(self, name): - if (self.channels.has_key(name)): + if (name in self.channels): return self.channels[name] # like self.shoutcast else: return self.get_object(name) # or gives an error if neither exists # custom-named widgets are available from .widgets{} not via .get_widget() def get_widget(self, name): - if self.widgets.has_key(name): + if name in self.widgets: return self.widgets[name] else: return gtk.Builder.get_object(self, name) @@ -523,11 +509,14 @@ # end application and gtk+ main loop def gtk_main_quit(self, widget, *x): if conf.auto_save_appstate: - self.app_state(widget) + try: # doesn't work with gtk3 yet (probably just hooking at the wrong time) + self.app_state(widget) + except: + None gtk.main_quit() @@ -558,11 +547,15 @@ # right-click ? if event.button >= 3: path = treeview.get_path_at_pos(int(event.x), int(event.y))[0] treeview.grab_focus() treeview.set_cursor(path, None, False) - main.streamactions.popup(None, None, None, event.button, event.time) + main.streamactions.popup( + parent_menu_shell=None, parent_menu_item=None, func=None, + button=event.button, activate_time=event.time, + data=None + ) return None # we need to pass on to normal left-button signal handler else: return False # this works better as callback function than as class - because of False/Object result for event trigger @@ -571,13 +564,13 @@ # encapsulates references to gtk objects AND properties in main window class auxiliary_window(object): def __getattr__(self, name): - if main.__dict__.has_key(name): + if name in main.__dict__: return main.__dict__[name] - elif StreamTunerTwo.__dict__.has_key(name): + elif name in StreamTunerTwo.__dict__: return StreamTunerTwo.__dict__[name] else: return main.get_widget(name) """ allows to use self. and main. almost interchangably """ @@ -770,11 +763,11 @@ return True # set/load values between gtk window and conf. dict def apply(self, config, prefix="config_", save=0): - for key,val in config.iteritems(): + for key,val in config.items(): # map non-alphanumeric chars from config{} to underscores in according gtk widget names id = re.sub("[^\w]", "_", key) w = main.get_widget(prefix + id) __print__(dbg.CONF, "config", ("save" if save else "load"), prefix+id, w, val) # recurse into dictionaries, transform: conf.play.audio/mp3 => conf.play_audio_mp3 @@ -826,11 +819,11 @@ once = 0 def add_plugins(self): if self.once: return - for name,enabled in conf.plugins.iteritems(): + for name,enabled in conf.plugins.items(): # add plugin load entry if name: label = ("enable ⎗ %s channel" if self.channels.get(name) else "use ⎗ %s plugin") cb = gtk.ToggleButton(label=label % name) @@ -1045,12 +1038,12 @@ # This step is most likely redundant, but prevents accidently re-rewriting # stations that are in two channels (=duplicates with different PLS urls). check = {"http//": "[row]"} check = dict((row["url"],row) for row in fav) # walk through all channels/streams - for chname,channel in main.channels.iteritems(): - for cat,streams in channel.streams.iteritems(): + for chname,channel in main.channels.items(): + for cat,streams in channel.streams.items(): # keep the potentially changed rows if (chname == updated_channel) and (cat == updated_category): freshened_streams = streams @@ -1151,11 +1144,11 @@ #-- global configuration settings "conf = Config()" # already happened with "from config import conf" # graphical - if len(sys.argv) < 2: + if len(sys.argv) < 2 or "--gtk3" in sys.argv: # prepare for threading in Gtk+ callbacks gobject.threads_init() gui_startup(1/100.0) @@ -1164,11 +1157,11 @@ main = StreamTunerTwo() # module coupling action.main = main # action (play/record) module needs a reference to main window for gtk interaction and some URL/URI callbacks action = action.action # shorter name - http.feedback = main.status # http module gives status feedbacks too + ahttp.feedback = main.status # http module gives status feedbacks too # first invocation if (conf.get("firstrun")): config_dialog.open(None) del conf.firstrun