JAWS Scripts For TeamTalk 5 Classic
This page is laid out for easy navigation via JAWS:
- Use h to jump from section to section.
- Use Tab to move among links for
different script versions. JAWSKey+F7 should also provide
a list of these links.
This script version is aimed at TeamTalk 5.x.
Documentation of script usage and features can be viewed by typing
Insert+F1 twice in quick succession from within TeamTalk
while these scripts are running.
This script version is dynamic, meaning that updates to it will be made
"in place." Newer revisions will replace older ones, and I will add
change notes to this section as changes are made.
Here are the changes in this version, most recent first.
In JAWS, use the h or 3 keys to move through
changes by release date, or Tab to jump straight to the
Revision 253, released January 13, 2020
- The incremental search implemented in the previous release much more reliably updates other dialog fields during a search.
In the previous release, it was sometimes possible, for example, to end up on the wrong TeamTalk server after a multi-letter search because TeamTalk did not update other fields in the dialog when focus was moved by a script
in the server list.
- Better documented how the scripted multi-key search feature works in tandem with TeamTalk's built-in single-character searching in lists.
- Reduced the number of beeps caused by single-letter searching in a list. There will still be one beep when the user switches from multi-key searching to single-key searching, as now documented in the user guide.
- Due to the above problems and changes, the incremental-search feature is now disabled by default but may be enabled by the user through a new option in the JAWS Quick Settings dialog (JAWSKey+v).
Revision 250, released January 6, 2020
Incremental search works in list controls. This means, for example, that you can find a server in the F2 list by typing several characters of its name.
Similarly, you can find a user account in the User Accounts list (Ctrl+Shift+l) by typing the first few letters of the account name.
Revision 248, released January 4, 2020
During navigation through the list of accounts in the User Accounts dialog, JAWS will read not only the name of each account but also, in this order,
- The user type (administrator or default user).
- Any text that appears in the Note field.
- The Initial Channel value if one is set.
This significantly simplifies verification of the set of accounts on a server.
This extra information is only included if the focused Accounts list item is selected.
Note that when the User Accounts dialog first opens, no account is selected; use an arrow key or Space
to select an item.
Revision 243, released May 30, 2019
- The minimum supported JAWS version is 15 instead of 11.
Coincident to this, TeamTalk 4.x support files and pages are removed from this site.
This script version is also now called "current" instead of "4.6" on this site.
- Where applicable, the built-in JAWS language translation services are used in these scripts. This is normal for third-party scripts but was disabled for these in 2015.
- On navigation via the script commands that move directly among users in the channel tree, JAWS announces the channel path when it changes, but after rather than before the name of the newly focused user.
Users can still detect when focus has moved to a new channel without waiting for this announcement by listening for a reset in the position index.
This change is meant to speed finding specific people in TeamTalk.
- Ins+PgDn, the JAWS "read status line" command, announces per-second packet reception information when typed from within a User Information dialog such as produced by typing Ctrl+I on a user name in the
- Bug fix: Arrows speak normally again in a JAWS virtual view, such as Speech History.
- There is a new, sequence-based version of many existing script commands, for those accustomed to this interface and in case it becomes necessary to avoid conflicting with future native TeamTalk keystrokes. The new sequences
are as follows:
- [ s reads toolbar icon status information like Ctrl+Shift+s.
- [ Shift+s reads more verbose toolbar icon status information as is done by typing Ctrl+Shift+s twice in quick succession.
- [ c focuses the channel tree as does Ctrl+Shift+c.
- [ i and [ o focus the chat input and output/history boxes, respectively, as do Ctrl+Shift+e and Ctrl+Shift+h.
- [ n and [ p cycle forward and backward through available TeamTalk windows containing chats, as do Ctrl+` and Ctrl+Shift+`, respectively.
- [ followed by numbers from the number row duplicate Alt+1 through Alt+9 and Alt+0, reading the most recent chat messages.
- The chat navigation system consisting of Alt with arrows, Home, End, and NumPad5 (or Alt+Enter for those without a number pad) is duplicated as well:
Type [ and then keys from the right-hand home-row portion of the keyboard to navigate chats while remembering last-read location.
In this review mode, h and ; move to and read the first and last message, j and l the previous and next message, and k repeats the last-read message. Typing k
twice quickly in this mode will spell the last read message.
Press Esc to exit this navigation system.
- 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.
Revision 227, released May 18, 2018
- Users for whom channel tree navigation is slow may turn off a new Quick Settings / Verbosity Options option called "Analyze channel tree icons." This analysis has been present in the scripts for years and is responsible for
making JAWS report away, idle, sending, etc., statuses. However, this code is slow on some modern computers due to DPI scaling and other underlying Windows technology changes.
- Occasional duplicate speech during arrowing in the channel tree should no longer occur.
- Extra speech during channel tree navigation like "left," "right," and "scroll fail" is removed.
- Alt+Enter works as a laptop-friendly alternative to Alt+NumPad5 in private chats just as it does in the main window for channel chats.
- A possible lockup on the commands for cycling among TeamTalk windows, Ctrl+` and Ctrl+Shift+`, is fixed.
- The installer may work in a few rare cases where it failed before due to an inability to read the Windows registry.
Revision 220, released September 2, 2017
- Fixed a problem with the previous installer, caused by a change in how the NSIS
SetRegView command works, that caused the
installer not to find any JAWS versions on 32-bit Windows.
- Failure to find any JAWS versions results in a log display.
Revision 219, released August 31, 2017
This update adds support for JAWS 2018.
There is also a minor possible Braille speed increase.
Revision 218, released March 21, 2017
- Ctrl+Shift+E and Ctrl+Shift+H move focus to the input and message history controls in the main TeamTalk window and in private chat windows.
- Ctrl+Shift+C moves focus to the channel tree when typed in the main TeamTalk window.
- Alt+Enter duplicates Alt+NumPad5 in the main window for reading the current chat message.
This is for users without number pads (e.g., when using some laptops and Bluetooth keyboards).
- Timestamp reading works correctly if the jcf does not exist, as always; but it also shows up correctly as Checked in Quick Settings in JAWS 14 and later, which is a bug fix.
- The installer and uninstaller are more careful to avoid an apparent JAWS or Windows bug in the handling of .ini (and .jcf) files that could sometimes result in incomplete keystroke lists or configuration settings during
installation or removal of scripts.
- Other minor installer and uninstaller updates.
- Cleanup of some obsolete code.
Revision 206, released June 26, 2016
This revision streamlines support for the latest TeamTalk 5.1 releases that speak chat messages on arrival
natively and include proper names for more on-screen controls, such as volumes. As such, support for older
TeamTalk versions is reduced in this revision.
- Volume controls are named by TeamTalk itself when names are provided.
- Chats no longer automatically speak via scripts on arrival, so the native TeamTalk chat speaking does not
cause duplicate output.
- The "Speak Chat Messages" user option is removed.
There are also fixes for the commands for cycling among TeamTalk windows (Ctrl+` and Ctrl+Shift+`):
- Invisible TeamTalk windows no longer briefly freeze JAWS when encountered by these commands.
- If a TeamTalk window cannot be focused and activated, it is skipped and this fact is announced.
- The first and last windows in the cycle are no longer skipped under certain conditions.
- Various focus loss and silence issues are fixed.
Revision 197, released December 15, 2015
This revision fixes installer and compilation issues:
- The uninstaller will properly handle installs that cover multiple JAWS versions at once.
Note though that the uninstaller present before this update is installed may still produce error messages in
such a case. If you are simply removing old scripts to install the new ones, these errors are harmless.
- The installer should handle installation into non-English JAWS 17 folders without generating error
- Compilation under JAWS 17 during installation will use compatibility mode so that message files packaged
with these scripts will work as xpected in translated script versions.
Revision 195, released November 24, 2015
Chat timestamps always speak on Alt+NumPad5 regardless of verbosity
settings, to provide a quick way to check the timestamp on a particular
Attempted to fix the problem of Ctrl+Shift+S occasionally saying nothing when multiple instances of
TeamTalk are open at the same time.
Revision 192, released September 30, 2015
The main change in this revision is that the installer works in JAWS
17 public beta 2.
The change is necessary because of a change in script compiler flags
between public betas 1 and 2 of JAWS 17.
Revision 191, released September 16, 2015
This revision includes installer fixes only and supports JAWS 17
Revision 189, released June 15, 2015
Announcement of status information like who is sending sound, who is
idle or online, etc., during navigation through the channel tree
should be greatly improved on Windows 8/8.1 machines and high-DPI
laptops under JAWS 15 and later.
This enhancement may also apply on JAWS 14 but will not apply on older
JAWS versions and has not been tested in JAWS 14 or older.
These announcements may still fail to be completely accurate from time
to time due to scrolling problems.
In sufficiently new versions of TeamTalk 5, the new native
Ctrl+G command will announce some of this information as
well. (At this writing, Ctrl+G is only available in a beta
TeamTalk 5 client.)
Anyone who sometimes found Ctrl+Shift+S silent should find
this no longer to occur.
The standard JAWS Ctrl+JAWSKey+V command for reporting the
current application version now reports the full correct version
The special code for making Ctrl+Left and
Ctrl+Right navigate by word in a channel chat window is
removed, because it actually worsened the behavior of these commands
under recent JAWS versions.
The installer changed in this script version, with the following benefits:
- Ability to install into non-English JAWS folders (though not with
non-English language support built in).
- Ability to install into multiple JAWS versions at once.
- Addition of an uninstaller, which is also run automatically on
install if this installer was already used to install the scripts at
- Smaller installer size.
- The installer file can be opened directly with 7Zip or a
compatible archive manager, eliminating the need for a separate Zip
Note that because of the last item above, the zip file is removed from
this script version's distribution files. If you want to examine or manually
install these scripts without running the installer, use 7Zip or a
compatible application against the installer file to do so.
Revision 156, released December 2, 2014
This revision lets Ctrl+Alt+Left/Right raise and
lower voice volumes in TeamTalk 5 rather than saying "Not in a table"
and doing nothing.
This update also allows mostly silent installation via a
installer command-line option, and completely silent installation via
Revision 153, released September 22, 2014
TeamTalk 5 (alpha, at this writing) should work with these scripts. As
part of this, script files have been renamed. Anyone installing
the scripts manually, without running the installer, must edit
ConfigNames.ini in the JAWS user folder to link TeamTalk to
the renamed file set. The following should work:
Chat commands' no longer miss the first entry in a channel chat window.
(This bug may never have gone public.)
Blank participant names with no flags (like "Sending") in the channel tree no
longer get replaced by the next tree item. This was happening on at least
some Windows 8.1 machines with high-resolution displays.
TeamTalk window switching (Ctrl+`) works even when a subdialog,
like a volume control, is open over a TeamTalk main window.
When typed in a TeamTalk main window (as opposed to a private chat window)
or in a dialog descended from one, such as a volume dialog,
SayWindowTitle command (Ins+T) includes the
server name before the actual main window name.
This is useful when multiple TeamTalk instances are running at the
same time, because it helps identify which is which.
When a message arrives in a TeamTalk channel message window for a TeamTalk
instance with an empty channel tree, which generally means there is no
fully active server connection, and that TeamTalk instance is not in
focus, the server name on that window's status line is used to identify
the window to which the message is sent.
This situation often happens when a non-current TeamTalk instance's
connection breaks due to Internet issues and begins placing messages
about retries into its channel message window. This fix makes it
easier, when multiple TeamTalks are running, to figure out which one's
connection is breaking.
SayLine command (Insert+Up) twice
quickly should now spell the current line as it does in most
Radio buttons no longer announce count and position on up and down
arrows, for consistency with behavior in other applications.
Download: Version current executable installer (can also open with 7Zip)