This plug-in shows current weather conditions, forecasts, radar maps (US/Canada only), satellite maps, and active alerts (US only).

Downloading and Installing

The latest version of the Weather plugin is v1.0.1.0 (09 November 2010)
Download:Weather.zip (4026 downloads)

Requirements

.NET V2.0.50727 or greater required.
All required DLLs are included in the installer package.

Configuration

Weather has a configuration frame within the NPVR settings. The config has 3 tabs, "Profile", "General", and "About".

Profile Tab

The Profile tab sets profile settings for the Weather plug-in. A different profile is needed for each location you want to access.

General Tab

The General tab sets general settings for the Weather plug-in.

  1. Update Frequency - The update frequency is the rate the plug-in will download new weather information and maps.
    • Note: 15 minutes is the minimum update frequency.
  2. Update at Startup - If checked, this will begin the download of weather information at NPVR startup, not startup of the plugin.
    • Note: It will only update at startup of NPVR/plugin if the current weather data stored locally is older than the 'Update Frequency' value.
    • Note2: "Update at Startup" is only used when being executed on a NPVR Server or Client. MVP/NMT users have to enter Weather in order to update weather information.
  3. Update during video playback - If checked, this will allow the plugin to download weather information when a video is being played. (If your CPU is running high when showing video, it's probably best to uncheck this box).
  4. Max. Forecast Days - Number of days to show on the forecast screen list.
    • Note: 9 days is the maximum. At least 5 days is recommended.

Custom Plugin Name and Description

Weather supports a custom plugin name and description. This is not available to change via the config GUI. You need to manually update NPVR's config.xml. Please make sure NPVR is closed before editing the config.xml file. **Please backup BEFORE making any changes to the config.xml file!**

For example, within the <PluginSettings> XML element, add the following:

    <Weather>
        <Name>MyWeather</Name>
        <Description>My custom weather description</Description>
    </Weather>

Using the Plugin

After installing the plug-in, the first thing to do is configure the plug-in via the NPVR configuration settings.

Once the plug-in has been configured, select the plug-in from the main menu. An information screen will appear that is showing that the plug-in is downloading the latest weather information and the applicable maps to the configured location(s). Once this is complete, the current condition screen will be displayed for the default profile.

Menu items

There are 2 menus used with Weather.

The Top menu contains the following buttons:

Main Menu

This will return you to the main NPVR menu.

Current

This shows the current condition information.

Forecast

This shows the extended forecast information.

Images

This will display the Image menu, described below.

The Image menu may contain the following buttons:

Main Menu

This will return you to the main NPVR menu.

Back

This will return the display to the Top menu.

Radar

This shows the radar images. If multiple radar images exist, a left/right button will appear next to the image title. You can scroll through the radar images using the left/right buttons on your remote or keyboard.

Satellite

This shows the satellite images. If multiple satellite images exist, a left/right button will appear next to the image title. You can scroll through the satellite images using the left/right buttons on your remote or keyboard.

Maps

This shows the map images. If multiple map images exist, a left/right button will appear next to the image title. You can scroll through the map images using the left/right buttons on your remote or keyboard.

Buttons

The following table is a list of actions, and the different ways to invoke these actions using a keyboard, mouse, and remote control.

ActionKeyboardRemoteMouse
Previous ProfileCTRL-YYellowYellow button (upper-right corner)
Next ProfileCTRL-BBlueBlue button (upper-right corner)
Previous ForecastDay/Image/AlertLeft arrowLeftLeft arrow button (upper-right corner)
Next ForecastDay/Image/AlertRight arrowRightRight arrow button (upper-right corner)
Refresh weather dataCTRL-RRedRefresh button (lower-right corner)
Show alert screenCTRL-GGreenAlert button (upper-left corner)
Play animated imageCTRL-PPlayPlay button (right of paused animated image)
Pause animated imageCTRL-QPausePause button (right of animated image)
Previous animated image frameCTRL-DRewRewind button (right of paused animated image)
Next animated image frameCTRL-FFFwdFast Forward button (right of paused animated image)

The selected (highlighted) button can also be changed using the Up/Down arrows on the keyboard, or the Up/Down buttons on the remote. Pressing "ENTER" or "OK" on remote will select these buttons.

Forecast Information

The Forecast screen displays up to 5 forecast days at one time. If more than 5 days were set in the General tab, then you can scroll to the right to get to those forecast days. The each day's forecast contains the day, date, icon, short description (16x9 skins only), high temp, and low temp. By selecting different days, the information below the list changes, with the day's forecast on the left side, and the night's forecast on the right side. After 3:00PM (15:00), the "Today" forecast item will change to "Tonight" and display only the night's information.

Multiple Profiles

If you have setup multiple profiles, Yellow and Blue buttons will appear to the right of the location text in the upper-right corner of the screen. Yellow will switch to the previous profile, while Blue will switch to the next profile. Switching profiles will attempt to remain at the current screen for the next profile, but if that screen does not exist, it will default back to the Current conditions screen.

Alerts (US locations only)

If an alert is active, an alert icon will appear in the upper-left corner of the screen, below the menu bar. If there are multiple alerts, the left/right scroll buttons will be visible. Use the buttons listed in the Button header above to move between the alerts. Once the alert is inactive, the icon will disappear.

Weather Icons

Weather comes with the Stardock icons as the default icons. If you want to use your own icons, the following file is the legend between icon number and the picture associated with it.
Download:Weather_iconcodes.txt

Here are the default Stardock weather icons:
Download:Weather_Stardock_icons.zip

Here are the default pressure arrow icons:
Download:Weather_Pressure_arrows.zip

Support

This plugin is discussed in the Weather/Weather2 Plugin Support Sub-Forum

Source Code

Known Limitations

To-Do

Author(s)

scb147

History

2010-11-09 : V1.0.1.0

2010-09-28 : V1.0.0.2


Categories:Plugin Internet