Read Me
# DESCRIPTION
# SlimServer plugin screensaver datetime replacement. Graphically displays current weather conditions and forecasts.
# Will also optionally display stock quotes and upcoming/current game information for MLB, NBA, NHL, NFL, and college
# football and basketball teams at user-configurable intervals.
#
# This version is modified from original SuperDateTime by "tcutting" to utilize
# data from Weather Underground (wunderground.com) using API.
# NOTE: Users must obtain API key from wunderground.com.
#
# VERSION HISTORY
# 5.10.16 09/21/15 Incorporated lasted BoomX2 fixes for College Football and NFL.
# Fixed College Football (CFB) parsing.
# Improved handling of NFL games that go into Over Time.
# 5.10.15 09/13/15 Incorporated latest BoomX2 fixes for NFL.
# Fixed NFL parsing. Scores are now pulled from NFL.com JSON
# data file.
# 5.10.14 08/09/15 Incorporated latest BoomX2 updates for MLB -
# Updated MLB parsing to handle All Star break and Post Season.
# i.e. - Days with no games or only a single game.
# Added MLB team logo png graphics for use with Custom Clock.
# Improved detection of Finished games in sub displayLines.
# 5.10.13 07/03/15 Added option to query weather by WU station ID, US Zip Code, and (NEW) Airport Code.
# 5.10.12 04/25/15 Fixed broken moonrise/moonset query (due to changes in aa.usno.navy.mil astronomy response format.
# 5.10.11 04/25/15 Incorporated additional fixes from BoomX2 (Don) for MLB scores.
# 5.10.10 04/16/15 Incorporated fixes from BoomX2 (Don) for MLB scores.
# 5.10.9 03/08/15 Fixed bug where it was querying wunderground 2x per refresh.
# 5.10.8 01/16/15 Incorporate updates to sports:Fixed NBA parsing. Updated logos to current ESPN png format;
# Added team logos for NFL and NCAA basketball. [Thanks BoomX2!].
# LongWeather data is now also stored in $wetData - should make cleaner way to access in CustomClock/CustomClockHelper:
# Use the “sdtweathertext” itemtype. The fields to use are %long_WeatherDay and %longWeather,
# and you can specify the periods to cycle through (I chose 0-4).
# Pressure Trend available for display as "%i".
# Also added station_id, windchill_c, windchill_f, wind_gust_kph, wind_gust_mph to $wetData.
# 5.10.7 12/28/14 Fixed bug in determining moonset/moonrise if no moonset or moonrise on given day.
# Modified rounding of windspeeds - standard windspeeds now rounded to integer (%W, %w, %q, %Q))
# wunderground windspeeds left to 1 digit past decimal(%j, %J, %k, %K).
# Additional re-formatting of data displayed in "Extras/SuperDateTime" menus:
# Additional information in Current Conditions. Now supports switch between wunderground
# and local icons.
## 5.10.6 12/26/14 Implemented moon information. Moon Phase description is provided in %G in current weather.
# Moon rise and set times in the -1, 0, 1 and 2 time-frames are %n and %N respectively.
# Moon phase icon is also available via 'moonphaseURL' - works via CustomClockHelper (itemtype: sdtweathericon, logotype: moonphaseURL)
# Fixed long weather implementation from 5.10.5 - now works with FWD and REW buttons on older SB's.
# Modified layout of the information displayed on Touch/Controller/Radio via the "Extras/SuperDateTime" menus to improve readability.
# Several minor formatting cleanups suggested - shortened wind direction, feels-like rounded to integer.
# Picked up some sports updates implemented by BoomX2.
# Added "DONATE" button for tcutting in settings screen :-)
# 5.10.5 12/14/14 Re-instated long weather forecasts which was not previously implemented in the 5.10.x versions (after
# implementation of the weatherunderground API. Also a few minor bug fixes.
# Modified by tcutting.
# 5.10.4 12/11/14 Significant modifications to the near-term forecasts - more like earlier versions of SDT
# which provides TODAY, TONIGHT, TOMORROW, TOMORROW NIGHT (particular ones depend on the current time of day).
# Added ability to get weather in various languages by providing "language code" in settings page. In addition,
# allow several abbreviation strings to be set in the setup page to both provide custom abbreviations and to
# change the language of these strings ("High", "Low", "TODAY", "TONIGHT", "THIS MORNING", "TOMORROW", "TOMORROW NIGHT",
# "Precipitation".
# Utilizes "day" and "night" local icons, and added some new local icons.
# Modified by tcutting.
# 5.10.3 12/05/14 Added ability to choose 12HR AM/PM vs 24HR time for certain weather strings (sunrise/sunset) and TOD returned
# in "near-term" forecasts (1, 2).
# Added ability to choose either "local" icons or particular set of wunderground icon (only applies to
# Touch, Radio, Controller.)
# Cleaned-up some formatting inconsistencies.
# Modified by tcutting.
# 5.10.2 12/02/14 Cleaned up several minor bugs introduced in 5.10.1.
# Improved number calls to wunderground to reduce chance of exceed maximum number of calls per day.
# Updated near-term forecasts (1, 2) to use "hourly" forecast information.
# 5.10.1 11/30/14 Major modification to weather updates - modified to use wunderground API.
# Requires user to get wunderground API key - free for developer for up to 500 requests/day.
# Modified plugin settings screen to eliminate separate weather underground and weather today identifiers
# as it now only uses weatherunderground, also added field for Weather Underground API Key.
# Modified by tcutting.
# 5.9.14 - 5.9.16 ????
# 5.9.13 03/14/12 Fixed NCAA basketball parsing. Thanks again BoomX2.
# 5.9.12 02/01/12 Fixed NCAA basketball parsing. Thanks BoomX2.
# 5.9.10 01/21/12 Added macro options to round WUnderground temperature data.
# 5.9.9 11/30/11 Moved to Google Code repository (Thanks Erland). Fixed wunderground (Thanks BoomX2). Changed plugin max version.
# 5.9.8 06/18/11 Fixed weather parsing. Thanks for everyone's patience.
# 5.9.7 04/16/11 Added stuck monitor.
# Fixed NCAA football showing games on non gamedays. Thanks BoomX2.
# Fixed weather.com and map parsing. Thanks Peter, BoomX2, and any ohters.
# Fixed HI/LO shortened text.
# For non graphical players will no longer crash attempting to call setCustomChar (I hope).
# Removed Amazon associate links from settings page as they no longer support Illinois associates. :(
# 5.9.5 10/02/10 Fixed weather parsing. Thanks Stubie.
# Fixed NCAA football parsing
# Fixed NHL parsing
# Fixed international precip parsing.
# Fixed weather alert parsing.
# Fixed bug relating to the display of long weather text items.
# Above thanks to BoomX2.
# Minor display tweaks.
# 5.9.3 07/31/10 Fixed weather.com parsing. Special thanks to Erland and BoomX2.
# Should handle HTML ISO 8859-1 characters better.
# 5.9.2 06/12/10 Fixed MLB parsing.
# 5.9.1 05/24/10 Fixed infinite '*' when there are no cycling display items to show.
# 5.9.0 05/22/10 Substantial external API enhancements to bring SuperDateTime content to Jive-based players (Touch, Controller, Radio)
# via the Custom Clock applet (special thanks to Erland and Dan for all their coordination efforts to make this happen).
# Updated weather icon images.
# Added support for weather map images by location.
# Added support for sport team logo images.
# Added support for daily stock chart images.
# All sorts of other minor tweaks and enhancements.
# 5.8.15 03/07/10 Improved reliablity for international weather identifiers.
# Updated weather periods logic to reflect weather.com's recent changes
# Updated MLB date range to include spring training.
# 5.8.14 02/06/10 Complete weather.com parsing fix. Added past 24-hr precip and snowfall. Weather alerts.
# NFL parsing fix (Thanks BoomX2). Added TV/Radio info for College BB and NBA.
# 5.8.12 01/15/10 Initial fixing of weather.com parsing
# 5.8.11 12/17/09 Fixed College Football to only display games on the day in which they are occuring based on Eastern timezone.
# Fixed NFL icons (only three supported, more welcome!).
# Added Dutch translations (thanks Willem)
# 5.8.10 12/10/09 Fixed NFL to only display games on they day in which they are occuring based on Eastern timezone.
# 5.8.9 11/13/09 Fixed NFL, College Football, and weather averages parsing and long forecast display (Thanks BoomX2).
# 5.8.8 08/07/09 Fixed SqueezeServer 7.4 compatibility issues. Fixed MLB/NBA refresh collision (Thanks Steve B and family.)
# 5.8.7 04/30/09 Fixed MLB icons and parsing for delayed/postponed games (Thanks Steve B and family).
# UV Rating now supported.
# 5.8.6 04/09/09 Fixed MLB parsing. (Thanks Steve B. and family)
# 5.8.5 03/13/09 Fixed NCAA CBB parsing. (Thanks Atslim)
# 5.8.4 02/11/09 Fixed NBA and NHL parsing. (Thanks Steve B. and family)
# 5.8.3 01/17/09 Fixed NBA parsing. (Thanks Steve B. and family)
# 5.8.2 12/06/08 Fixed date/time formatting to once again use regular Date/Time plugin format setting
# Updated WeatherUnderground parsing to handle stations that include Solar Radiation in their reading data
# 5.8.1 11/25/08 Switched to .par packaging to resolve installation issues (Thanks Steve B.)
# Switched to .png weather icons for clearer Duet display (Thanks Sue C)
# 5.8.0 11/22/08 Overhauled NBA parsing (Thanks Steve B, Sarah and Hannah).
# Stock information now viewable via Duet controller
# To support our international friends, stock display/refresh is now 24/7.
# Unit of measure for certain forecasts and Duet is not configurable
# German translations (Thanks Juergen)
# Misc bug fixes
# 5.7.0 09/10/08 Updated NFL parsing for new season.
# Resurrected automatic long weather forecast scrolling.
# Number of upcoming days worth of weather forecasts now configurable.
# Loads of bug fixes and performance enhancements.
# API now supports long text display items.
# 5.6.2 08/30/08 Alarm display support.
# Touched font files to resolve overlapping text issue caused by
# SqueezeCenter fontcache bug.
# SDT will refresh data when there are no players with displays (Duet only configurations)
# 5.6.0 08/28/08 BOOM Support. Player-specific configuration.
# 5.5.1 04/11/08 Fixed MLB parsing
# 5.5.0 Now offers API for other plugins to add display info.
# Added all remaing MLB icons. Thanks B. Yudichak!
# Added Minnesota and Tampa Bay MLB icons. Thanks M.Meyer!
# Major overhaul of display code for future expandability.
# Fuzzytime support http://www.tux.org/~peterw/slim/FuzzyTime.html
# Supports negative forecasts
# Save last viewing top item on restart
# Highly configurable display with smart spacing
# Up/down moves both screens for period.
# Holding down jumps to current conditions
# 10 day forecasts
# Data updates sequential and less prone to blocking
# *** SlimServer 7.0 or later is required. ***
# 5.0.5 04/02/07 Fixed ESPN MLB parsing to handle minor '07 season website changes.
# Divided up MLB processing to decrease HTML parsing hangs.
# Added a few additional MLB logos.
# 5.0.4 01/19/07 Fixed bug where Top-25 conference selection is overwritten on sever restart.
# *** Complete version history is available on the website listed above. ***