JAWS Scripts For Weather Watcher Live
Doug Lee
Last Revised June, 2022

This document describes the custom scripts for Weather Watcher Live and provides tips for using this application with JAWS. This document can be opened from within the application via a double press of JAWSKey+F1 (or Insert+F1) when the scripts are running.

Table of Contents

• System Requirements For JAWS Users
• Script Installation Instructions
• Script Commands and Features
• Known Issues
• Revision History

System Requirements For JAWS Users

In addition to any system requirements for the application, the following apply for JAWS users:

• The computer should be running Windows 7 or 10.
• JAWS 14.0 or later should be used. The scripts will not work with or install into older JAWS versions.

Script Installation Instructions

To install these scripts on a new system:

1. Load JAWS if this has not already been done. This will require administrative privileges on the computer.
2. Run JAWS as the user for whom the scripts are to be installed. This and the following steps must be performed for each user of the computer who will be using JAWS with these scripts.
3. Download and run, or run directly, the installer for these scripts; and follow the on-screen directions. Be sure to install the scripts in the currently running JAWS version if a JAWS version list is presented.
4. To verify successful installation, type Insert+Q from within the application. Part of the JAWS spoken response should be a revision number. If you do not hear a revision number, the scripts are not correctly loaded. In some cases, restarting JAWS may fix this issue.

Script Commands and Features

These scripts provide the following commands beyond those provided by the application itself:

• From within any application, JAWSKey+Ctrl+Shift+W or Insert+Ctrl+Shift+W will read the text from the Weather Watcher Live systray icon.
• From within the application, JAWSKey+Q, along with announcing the active configuration name, will announce the revision number of these scripts. This command will not work from outside of the application.
• Insert+F1, typed twice in quick succession from within this application, opens this document in the default browser. This command will not work from outside of the application.

These scripts also provide the following features:

• Better announcement of list items.

Known Issues

The following issues are known and may be encountered during use of the application with these JAWS scripts. These issues may be fixed in a future update to the scripts or to the application itself.

Braille support is not well tested.

Revision History

This is the revision history of these scripts, most recent revision first:

Revision 33, June 12, 2022

Note that this revision is the first officially posted since December, 2015. A less formally announced update was made available in April, 2021 containing most of the below features. This author has not personally tested this update against the application and thus relies on user feedback.

• JAWS 2022 is supported.
• The minimum supported JAWS version is increased from 11.0 to 14.0.
• This documentation file and revision history is added.
• JAWS versions through 2022 are supported by the scripts and installer. There are also many updates to the code that announces control information.
• The installer guards against installing when creating a script chain would wipe out a jsb file without a corresponding jss file. This change was inspired by third-party scripts that are distributed without source and that include default.jsb without including default.jss.
• The keystrokes for reading the Weather Watcher Live systray icon text, JAWSKey+Ctrl+Shift+W and Insert+Ctrl+Shift+W, are set up by the installer and removed by the uninstaller. Previously, they were set up by the scripts on first run but never removed even if the scripts were uninstalled.
• Fixed a very rarely triggered cross-project bug that could cause JAWS to speak or Braille out-of-date information about the current screen. For technical details on the bug and fix, refer to The JAWS Script Cache Life Cycle (CLC) Bug and Resolution.
• The installer contains version and product information visible from the Details tab in Windows Explorer, to better identify its contents.
• A "directives" text file is included that provides information on how to install this set of scripts manually. See "Handling Directives Files" in the "Common Script Elements" document for further information.
• Source code to the scripts is no longer included. See my Script Distribution Policy document for details. As one side effect, this will cause installation to run much faster.
• The messages for these scripts are now distributed in XML rather than jsm files so that translators can create translations with no need for script source recompilation. See the Script Translation Procedure document for details on how to translate these scripts, including how to update the XML message file.

Revision 10, December 15, 2015

• JAWS 17.0 is supported.
• Numerous internal code updates to conform to current coding standards and methods.

Revision 9, June 22, 2014

• Initial script release: Special support for list controls and a command for reading the Weather Watcher Live systray icon text from within any application.