JAWS Scripts For Ramblio
Doug Lee
Last Revised June, 2026
This document describes the JAWS scripts for Ramblio and provides
tips for using this web 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
In addition to any system requirements for the application, the following
apply for JAWS users:
- The computer should be running Windows 10 or later.
Older Windows versions may also work but have not been tested.
- JAWS 2019 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:
- Install 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.
Key Sequences
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 keystroke 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 keystroke, 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 JAWS and the application:
- The key sequence [ R announces three numbers: The number
of unread notifications, the number of unread private messages, and the
number of active hangouts.
For example: "1 0 3" means one unread notification, no new messages, and three active hangouts.
If this Ramblio instance is not logged in, this sequence will instead say "no counts."
- There are several sequences for manipulating a playing ramble or
comment. All of these stay in the key layer, which means that the leading
[ is only required once. After that, type any of these commands,
and use Esc to exit the key layer when done:
- P pauses or resumes the playback.
- T announces the total length of the playing ramble or comment.
- E announces the elapsed time so far played.
Note that this works perfectly in Firefox but does not stay up to date in Chrome-based browsers.
In Chrome-based browsers, pausing, resuming, or skipping will update the elapsed time indicator.
- The digits 1 through 9 and 0 will
jump to a percentage through the ramble or comment:
0 jumps to the beginning, 5 jumps to the halfway point (50%), etc.
Unfortunately, these command sequences do not currently work in Firefox,
because no way to implement them was found.
- The Left and Right arrows skip backward and forward through the playing ramble or comment
by skipping over five seconds of content.
There may sometimes be a bit of speech during these navigations,
because the scripts must move focus around to make the commands work.
These commands do not work in Firefox, though directly focusing the position slider
and then using Left and Right arrows does work there.
These script command sequences may be fixed for Firefox users if there is demand for this feature.
- V reports the volume level, and the Up and Down arrows change it up and down.
The volume level may report as a percentage like 90% or as a decimal between 0 and 1 like 0.9.
The arrows are meant to avoid speaking so as not to interrupt the playing ramble or comment.
However, speech may still occur in Firefox during volume changing.
- C closes the audio player control.
- 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.
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 and is likely incomplete.
Revision History
This is the revision history of these scripts, most recent revision first:
Revision 24, released September 3, 2026, tested against application version xx