JAWS Scripts For TeamSpeak
Doug Lee
Last Revised June, 2019

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

This document is laid out for easy navigation using JAWS HTML heading navigation commands: H will move through all headings, 2 through major sections, and 3 and 4 through any subsections or subsubsections.

Table of Contents

Why Scripts For TeamSpeak?

TeamSpeak includes a number of accessibility features, but JAWS natively does not interpret much of TeamSpeak's accessibility information in a useful way for JAWS users. These scripts aim to fill the gap between TeamSpeak's accessibility support and JAWS' expectations. The scripts also provide several useful commands for retrieving information and accessing TeamSpeak features.

System Requirements For JAWS Users

There are no known system requirements for these scripts beyond those for TeamSpeak itself. The scripts were written and tested against the following software versions:

Later versions of TeamSpeak may also work with these scripts, but older TeamSpeak versions will not. Both 32-bit and 64-bit versions of TeamSpeak are supported. JAWS 15.0 or higher is required, as older JAWS versions are unable to access much of the information provided by TeamSpeak. JAWS versions older than 2019 have not been tested carefully.

Script Installation Instructions

To install these scripts on a new system:

  1. Install 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. Run the script installer and follow its instructions. 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 Ins+Q from within TeamSpeak. 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.

Commands and Features

This section and its subsections describe the commands and features provided by these scripts.

As of August, 2018, most TeamSpeak script commands are key sequences rather than multi-key combinations. This is to avoid collisions between script commands and native application keystrokes. All such key sequences start with a common prefix key, a left bracket ([) by default. Users can change the prefix key if necessary by typing [ followed by JAWSKey+C or Ins+C. The change will survive across script and JAWS updates. In this document, the prefix key will be called Command; thus, by default, Command c means type [ followed by c. Users can explore all commands available in this system by using Tab after typing the prefix key, by default [.

Summary of Features

Title Announcement Enhancements

Ins+T, the JAWS SayWindowTitle command, includes a number of enhancements beyond saying just the title of the active window. The items included are, in this order and as applicable:

Tips , Tricks, and Caveats

This section and its subsections provide useful tips and information for performing various tasks in TeamSpeak.

General Information

Pressing the Applications key on the menu bar (after pressing Alt to activate the menu bar) will present a menu of options allowing parts of the TeamSpeak display to be made visible or invisible. Of particular interest is the Master Volume control, which allows adjustment of the overall TeamSpeak volume. The default value for this slider is 0, and it can be moved with arrows to become positive or negative. This is also how users can customize the TeamSpeak toolbar to make frequent actions easier.

Unfortunately, as of QT 5.12.3, assistive technology such as JAWS has no reliable way to determine which items in menus are checked and which are not.

When using the RightMouseButton command on a tab control, arrow left and right before clicking to make sure JAWS knows which tab is active. Otherwise, the click may be applied to the first visible tab regardless of which one is active.

Creating and Editing Hotkeys In Options

The following procedures should help with creating and editing hotkeys in TeamSpeak:

To edit or create a hotkey, go to the Hotkey Setup screen as just described, then follow these steps:

  1. Tab several times, past the key definition box, until JAWS says "Show Advanced Actions." Depending on the action you want to assign to a key, you may need to check this box. When in doubt, check it, so all possible actions can be found below.
  2. Shift+Tab once to the previous control, which is the tree of available actions.
  3. Using the four arrows, Right arrow in particular to expand tree nodes, locate the action you want. Toggling the aforementioned "Show Advanced Actions" checkbox may help here. Make sure, before attempting to assign a key to an action below, that the action you are choosing is an actual action, not a tree node with further descendants. For example, when Advanced Actions is checked, "Toggle Playback Profile" (under "Playback Profile") has a descendant for each available playback profile.
  4. To choose the action and move to the key assignment stage, press the JAWS LeftMouseButton command twice in quick succession. This will effect an actual double click on the selected action. Focus will automatically move to a control that allows you to type the keystroke you wish to use. If this does not happen immediately, try the double click again. If this still does not happen, you probably selected an item with subactions, in which case the clicks only expand or collapse the list of them.
  5. Type the keystroke just as if you were using it; e.g., type Ctrl+Shift+O if you want to make Ctrl+Shift+O execute the action you selected earlier. Focus will return to the action you selected in the Actions list.
  6. To save the keystroke, press Enter, which presses the OK button. Focus will now return to the table of key assignments.
  7. To close the Options screen, press Enter and then Esc. The Enter actually opens an edit screen on the currently highlighted key assignment, and the Esc closes both that and the Options screen.

Customizing the TeamSpeak Toolbar

The TeamSpeak toolbar can be customized to contain frequently accessed features. In some cases, doing this can simplify or even improve the accessibility of frequent operations. To customize the TeamSpeak toolbar:

Once the toolbar consists of your preferred set of actions, access any of them using JAWSKey+F8.

Advanced Information

The below information is likely to be of use only to advanced users of TeamSpeak.

Right-clicking on a bookmark in the Bookmarks menu, then pressing the Down arrow once, will open a context menu allowing you to edit the bookmark, connect to it normally, or connect to it by creating a new tab. The final of these options is a way to make multiple simultaneous connections to different servers.

Once multiple connections exist at once, it may help to make TeamSpeak activate the microphone in the current tab every time you navigate among server tabs. Do this in Preferences > Application.

When multiple server tabs are showing, the JAWS SayWindowTitle command, Ins+T, will name the active server and indicate its position among the tabs and the number of tabs showing. Close the active tab with Ctrl+W or via right-clicking and choosing the appropriate Close option.

If you have connected to one server multiple times simultaneously using different tabs, use the status line reading command, JAWSKey+PgDn, to identify which of your nicknames is active in the current tab.

When there are multiple server tabs open and a hot key is assigned to toggle microphone mute, the announcements "Microphone muted" and "Microphone activated" can be incorrect with respect to the active server tab. Use arrows to find your name in the active tab to see whether "Microphone muted" speaks after the name. (This issue was verified on March 18, 2015, in TeamSpeak for Windows version 3.0.16.