Using the JAWS Scripts For Youtube
Last Revised March, 2017
This Guide provides tips for using Youtube with JAWS For Windows and these scripts.
When the scripts are installed and Youtube is open and focused in a supported browser, this document can be
opened via a double press of JAWSKey+F1 (or Insert+F1).
Note that Youtube provides many keystrokes that do not require scripts, though they usually do require forms
mode, pass-key-through, or disabling of the virtual cursor. These scripts simplify using some native commands
while providing a few other shortcuts not provided by Youtube itself.
Table of Contents
These scripts require the following for correct operation with the Youtube web site:
- JAWS 17.0.1806 or greater. (JAWS versions prior to 17.0 do not support web site specific scripts.)
The original JAWS 17.0 release did not include the
GetElementXML() function that was added in the
JAWS 17.0.1806 release in April, 2016.
- A browser supported by JAWS 17.0 or later. At this writing, these are
Internet Explorer, Firefox, and Google Chrome.
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.
- Run 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 Ins+Q while
Youtube is in focus in a supported browser. 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.
Note to users of the original Youtube scripts:
As of March, 2017, all Youtube script commands are key sequences rather than Ctrl+Shift combinations. This is because of several collisions between the original script commands and native browser keystrokes.
All of the original Ctrl+Shift commands are now changed to a left bracket ([) followed separately by the same letter used in the original command. For example, the original Ctrl+Shift+S command
to skip ads is now [ s.
The scripts provide the following commands:
- [ S
- Skip Ad. If a video ad is playing and a Skip button is present, this command will click it to make Youtube
start playing the actual video requested.
- [ Space
- Press the Play/Pause button if present. This works in both virtual cursor mode and forms mode.
- [ T
- Say Time. This command will speak the current time position in the playing video as well as the video's length.
If a video ad is playing, the times will relate to the ad rather than to the requested video.
Note: The current time position is not always kept up to date by Youtube itself but will be
updated if the video is paused and restarted or the play position is changed by the user.
Typing [ Space twice will force such an update.
- [ N and [ P
- Move to the next or previous search results page or video. This works in search results, playlists, and
wherever a Next and Previous button can be found.
- [ V
- Move focus to the volume slider for the currently playing video. This also switches JAWS into forms mode and causes
a number of native Youtube keystrokes to become usable.
The following Youtube-native keystrokes work as indicated when JAWS is in forms mode or if the keystrokes are
passed through JAWS directly to Youtube, such as with the JAWS "pass next key through" command, Ins+3.
As noted in the below list, some Youtube keystrokes require focus to be on the video's volume slider.
This list applies at least to the HTML 5 video player and possibly also to
the Flash player.
- Space (slider focus required) or K
- Pause, resume, or play the current video.
- j or l
- Rewind or fast-forward the video by a few seconds.
- Digits 1 through 9 and 0 (slider focus required)
- Jump to a percentage through the video. 0 jumps to the beginning, 1 to 10% through,
2 to 20% through, etc., and 9 to 90% through.
- , (comma) or . (period)
- Slow down or speed up the video without changing its pitch. This amounts to simple compression or
expansion of the audio and video. Slowing down far enough may stop playback.
- Up or Down arrows (slider focus required)
- Turn up or down the volume of the video by increments of 5%.
Right and Left arrows, respectively, perform the same actions and also require focus to
be on the volume slider.
The volume usually defaults to 100%.
- Mute or unmute the sound of the video. Beware that the occasional video defaults to muted on starting,
though this seems rare.
- Home (slider focus required)
- Mute the audio. This is not a toggle like m.
- End (slider focus required)
- Unmute the audio and move the volume to 100%. This is not a toggle like m.
- Toggle between full screen and normal video size.
- / (slash)
- Move focus to the Youtube search box.
- ' (apostrophe)
- Pop open and move focus to the Find bar for about four seconds.
Issues shown in this section may be fixed in future script
revisions but are not addressed as of this writing.
Sometimes, [ V may announce the volume slider incorrectly. In this script author's
experience, this only occurs after a great number of videos, such as 50, have been played without a browser
As mentioned earlier, Youtube provides many keystrokes natively. However, most are blocked by JAWS' virtual
mode (true for other screen readers as well), making them inconvenient to use in some situations.
I wrote these scripts for the following reasons, not necessarily in order of precedence:
- Personal convenience (ok, that one was probably at the top).
- Potential usefulness to other JAWS users.
- A demonstration of the new power in JAWS 17+ for scripting web sites in a browser-independent manner.
- A way to make more people aware of the keyboard support built into Youtube itself.
- In the words of a coworker and good friend, why not?