JAWS Scripts For MicroSIP
Doug Lee
Last Revised February, 2024

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

These scripts work identically with the full and lite versions of MicroSIP. The difference between the two versions is that the lite version does not support video in calls. At this writing, video support has not been explicitly tested with these scripts.

Table of Contents

• Script Features In Brief
• System Requirements For JAWS Users
• Script Installation Instructions
• Tips, Tricks, and Methods
• Revision History

Script Features In Brief

These scripts provide the following commands and features from within any focused application:

• Automatic announcement of incoming calls. These scripts also add dashes to phone numbers when there is no caller ID name available for an incoming call, so the numbers are easier to understand via speech and read in Braille.
• A keystroke, Alt+Windows+M, for handling an incoming call.
• Another keystroke, Alt+Windows+H, to hang up any active calls.

In addition, these scripts provide the following commands and features when MicroSIP is in focus:

• Improved Tab, Shift+Tab, Ctrl+Tab, and Ctrl+Shift+Tab behavior within the application.
• Ctrl+` and Ctrl+Shift+` switch among top-level MicroSIP windows even when not in Alt+Tab order.
• Top-level dialogs such as Account receive focus on Alt+Tab though they otherwise would require the JAWS Task List or the above Ctrl+` command to find.
• Ctrl+F4 closes the active call tab in a call window (by clicking a red Close button on the tab control that JAWS normally doesn't see).
• Some fields are better named. This includes announcement of tooltip text when a field has this, a moment after the field takes focus.
• On focus and toggle with Space, the DND (do not disturb) and AA (auto-answer) buttons speak their checked or unchecked states.
• Status bar changes speak automatically so connection status updates will be spoken.
• Space on the "Display Password" link in the Account dialog works (and these scripts also put that link in tab order).
• JAWSKey+Q, along with announcing the active configuration name, will announce the revision number of these scripts.
• Ctrl+Shift+W launches the home page for these scripts in the default browser. This can be useful when checking for updates. Information regarding the user's script revision, JAWS version, and MicroSIP version is sent to the script author's web site by this command as well, so the author can keep track of what configurations to support with the scripts.
• If typed twice quickly, Insert+F1 launches the manual for these scripts in the default browser.

System Requirements For JAWS Users

There are no known system requirements for these scripts beyond those for MicroSIP itself. However, JAWS versions older than 15.0 have not been tested recently with these scripts. JAWS versions older than 14.0 will not work with these scripts. The scripts were written against MicroSIP versions 3.3.5 and 3.3.8 and updated under 3.21.3.

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 MicroSIP. 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.

Tips, Tricks, and Methods

When a call comes in, these scripts will announce the caller's name or number depending on what is available. To ignore the call, do nothing; nothing will steal focus from your current application. To answer the call or stop it from ringing, or to check more carefully who is calling, type Alt+Windows+M to pop up a JAWS listbox containing the same information that appears in the MicroSIP popup window. You may then navigate this box with arrows or by typing the first letter of a line, such as "a" for Answer. Pressing Enter on an action line such as "Answer" will activate that feature in MicroSIP. Pressing Enter on any other line or pressing Esc on any line will close the list without causing any MicroSIP action.

To hang up any active calls, type Alt+Windows+H. This command works regardless of which application is in focus.

To get to the configuration pages for MicroSIP (Account and Settings), press the Alt from within the main MicroSIP window to move to the Menu button, then Space to activate the menus. Alternatively, press the Applications key on the MicroSIP system tray icon if there is one.

To open MicroSIP when it has been minimized to the system tray, press Space, not Enter, on the icon.

If you use arrows to navigate among tabs in a tab control, you must press Space to switch to a tab. Arrows merely move focus among tabs in the tab control without changing which tab is active.

If you Alt+Tab out of a MicroSIP window, such as a call window, and you can't find it again in the Alt+Tab order, switch to any available MicroSIP window and then use the scripted Ctrl+` and Ctrl+Shift+` commands to find the window you want.

Revision History

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

Revision 92, released February 26, 2024, tested against application version 3.21.3

• The command for reading the status bar, JAWSKey+PgDn, works in Windows 10 and 11 with or without the JAWS legacy accessibility driver active.
• The automatic announcement of status bar changes, such as changes in connection status, occur identically regardless of Windows version and legacy accessibility driver state.

Revision 89, released October 16, 2023, tested against application version 3.21.3

• The global Alt+Windows+H command for hanging up any active calls actually works when MicroSIP is not in focus.

Revision 87, released October 7, 2023, tested against application version 3.21.3

• Alt+Windows+H hangs up any active calls regardless of which application is in focus.
• Field naming code is more efficient, and more fields are named.
• For fields with tooltips, JAWS will announce the tooltip shortly after the field takes focus. This is an experimental feature designed to improve identification of a few fields.
• On focus and toggle with Space, the DND (do not disturb) and AA (auto-answer) buttons speak their checked or unchecked states.
• 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.
• Fixed a bug that could cause some localized strings not to be spoken where expected.
• Some very old code for supporting JAWS 11 and 12 is removed.
• By popular vote, old history entries in this document section are now hidden inside a details tag that may be expanded to show them. Among the benefits of this, heading count is reduced and text searches won't match very old material.

Revision 70, released April 21, 2020

• 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.
• Handling of the Windows Menu or Application key may be improved.
• The script release notes, formerly kept in a separate document, are now part of this one.
• Screen readers respond better to activation of Table of Contents links in this document.