JAWS Scripts For Wireshark
Last Revised May, 2020
This document describes the JAWS scripts for Wireshark 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
- Key Sequences
- 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 10. Other Windows versions may work but were not tested.
- JAWS 2018 or later should be used. The scripts will not work with or install into older JAWS versions.
- Application version 3.2.3 should be used. Later versions may work as may earlier; but neither have been tested.
Script Installation Instructions
To install these scripts on a new system:
- Load JAWS if this has not already been done. This will require administrative privileges on the computer.
- 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.
- 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.
- 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.
These scripts incorporate commands that consist of sequences of keystrokes, all beginning with a common prefix, or "command keystroke." This approach allows many script commands without the risk of conflicting with application keystrokes. See the "Multi-Key Command Sequences" section of the "Common Script Elements" document for further details, including how to explore the available script commands (similar to exploring a menu system), and how to change the Command key if necessary.
By default, the Command keystroke for these scripts is [. This document may refer to this keystroke as [ or Command; so, for example, [ Tab and Command Tab both refer to typing the prefix key, then separately the Tab key. Some sequences may consist of more than two keystrokes, or "levels"; for example, [ d r would refer to typing [, then d, then finally r.
Script Commands and Features
These scripts provide the following commands beyond those provided by the application itself:
- [ b, or alternatively JAWSKey+F8, brings up a list of toolbar icons for review and selection.
- Typing [ t brings up a list of tabs in screens containing tab controls. Press Enter on a tab's name to activate it.
- JAWSKey+q, along with announcing the active configuration name, will announce the revision number of these scripts.
- Insert+F1, typed twice in quick succession, opens this document in the default browser.
These scripts also provide the following features:
- Prevents the Tab from stalling at one point in the main capture analysis screen.
- Speaking of entire rows in tree grid controls.
- Better naming of some fields, sometimes including evasion of the double-speaking of a field name.
- Some fields that have extra descriptive information speak that information after the normal JAWS speech for the field.
- JAWSKey+B, the normal command for reading an entire dialog box in tab order, is scripted to read some screens and dialogs more intelligently.
- The standard command for reading the status line, JAWSKey+PgDn, works as expected.
- The commands for clicking with the left and right mouse buttons, when pressed while the PC cursor is active, will click at the current PC cursor location. This may be useful if the Applications or Menu key does not work in a particular situation.
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.
During script testing, typing Ctrl+Shift+o to open a packet data window from the Data line in the Packet Details tree sometimes crashed the application. This seemed to occur on the third or a subsequent invocation of this command within one capture session.
Sometimes, JAWS is overzealous at field naming, including the names of all fields in a screen region as the "name" of a single field. This occurs with and without scripts, though the scripts reduce the frequency of this issue.
Braille support is not well tested and is likely incomplete.
This is the revision history of these scripts, most recent revision first:
- Revision 14, released May 18, 2020, tested against application version 3.2.3
- Initial script release.