-
-
Notifications
You must be signed in to change notification settings - Fork 646
SwitchingFromJawsToNVDA
The purpose of this guide is to assist users of JAWS (Job Access With Speech), a commercial screen reader by Freedom Scientific to switch to the open-source screen reader NVDA (NonVisual Desktop Access) with ease. It assumes prior knowledge of JAWS and that you are proficient in its use.
It is not intended to be a replacement of the included user guide, rather as a means to make NVDA seem less daunting.
The intent of this guide is not to be a comparison of JAWS and NVDA, but it is necessary to mention some things that work differently. In most daily situations, NVDA works just as well as JAWS, if not better in some cases.
NVDA uses "Desktop" keyboard layout by default. This layout uses the number pad (with Num Lock off) for review cursor and object navigation commands (more on those further down). Laptop Keyboard layout is designed for keyboards without a number pad. Those commands are moved to other keys, as are a number of other commands.
Selecting the laptop keyboard layout does not automatically set the Caps Lock key to act as the NVDA modifier key. Keyboard layout and NVDA key can be set independently from NVDA's keyboard settings. Checkboxes are provided to select caps lock, numpad insert, or extended insert. Any combination of these keys can be selected regardless of the keyboard layout selected. Press NVDA+control+k to open NVDA's keyboard layout settings.
The NVDA User Guide contains all NVDA commands. Here are some basic commands which are used frequently. All commands are configurable, so these are the default keystrokes for these functions. As noted previously, your NVDA key can be either insert or caps lock.
Most NVDA functions can be enabled or changed via the NVDA settings. Settings, and other options, are available via NVDA's menu. To open NVDA's menu, press NVDA+n. To open NVDA's settings dialog directly, press NVDA+control+g. Many settings screens have keystrokes to open them directly, such as NVDA+control+s for synthesizer, or NVDA+control+v for other voice options.
- Start NVDA: Press control+alt+n
- Exit NVDA: NVDA+Q, then enter.
- Pause or restart speech: shift
- Stop speech: control
- Report window title: NVDA+t
- Report current focus: NVDA+tab
- Report time: NVDA+f12 (press twice quickly for date)
- Toggle speak typed characters: NVDA+2
- Toggle speak typed words: NVDA+3
- Toggle speak command keys: NVDA+4
- Report battery: NVDA+Shift+b
- Toggle input help mode (read each key without performing an action): NVDA+1
- Report status bar: NVDA+end (desktop layout) / NVDA+shift+end (laptop layout)
- Read the current line: NVDA+up arrow (desktop keyboard layout) / NVDA+l (laptop keyboard layout)
- Say all (Read from the current point onwards): NVDA+down arrow (desktop layout) / NVDA+a (laptop layout)
- Report clipboard: NVDA+c
- Read selected text: NVDA+shift+up arrow (desktop layout) / NVDA+shift+s (laptop layout)
- Report text formatting: NVDA+f
- Adjust speech options: NVDA+control+arrows (desktop layout) / NVDA+shift+control+arrows (laptop layout) - refer to the Synth Settings Ring in the User Guide for more information
- Open Elements list (similar to Jaws' links list): NVDA+f7 (Note that many single letter navigation keys such as H for heading, N for non-linked text or F for form field, are the same as used in Jaws).
To get help for NVDA, press NVDA+n to open the menu, then H for help. From this submenu you can access the User Guide, a quick reference of commands, history of new features and more. These first three options open in the default web browser. There is also more comprehensive Training Material available in the NV Access Shop.
As you may be aware, both JAWS and NVDA can use the insert key for its modifier key. Both screen readers treat it slightly differently, which could lead to some confusion if you are used to one or the other.
With JAWS loaded, the insert key is solely for its use. This means that, in order to use the original function assigned to it (such as switching between insert and overwrite modes in a text editor or word processor), you first have to activate JAWS's pass key through command.
NVDA, on the other hand, allows you to carry out the insert key's original function by pressing it twice quickly. Keep this in mind the next time you're editing text while using NVDA and find yourself erasing what you've already written by typing over it. This also works for caps lock when it is assigned as the NVDA modifier key (press it twice to toggle caps lock).
NVDA has one feature to edit keystrokes, called Input Gestures. Input Gestures is found on NVDA's "Preferences menu". Any feature can use keystrokes, touch gestures or Braille display buttons. When Input Gestures is loaded, the focus starts in a tree view. Use the arrows or first letter navigation to locate categories and options inside categories. Alternatively, press SHIFT+TAB or ALT+F to move to the filter edit field and type the name of the feature to find. Any feature can have multiple gestures defined, or none. When adding a gesture, you can add the gesture for the current keyboard layout only, or all layouts.
Windows OneCore voices, included in Windows 10, is used by NVDA as the default synthesizer in Windows 10. Windows OneCore voices are responsive, natural-sounding and available in many languages. To add extra voices, install a new language in Windows 10 itself, including the language pack. Variants of a language, such as "English (United Kingdom)" and "English (United States)" each include different voices.
The eSpeak NG synthesizer is also included with NVDA. It is used as the default in Windows 8.1 and earlier. Like NVDA itself, eSpeak NG is also free and open source, which is one of the reasons for its inclusion. Another being the sheer number of languages it can speak.
Both Windows OneCore Voices, and eSpeak NG, have access to features such as "rate boost", enabling the speech rate to effectively be doubled. You can also press SHIFT to pause, and continue, speaking, instead of CONTROL which simply stops speech.
To change synthesizer, press NVDA+control+s. To set other voice options, press NVDA+control+v.
However, you may find that, for whatever reason, neither Windows OneCore, nor eSpeak NG is right for you. If this is the case you will be glad to know that there are alternatives, which will be discussed in the following sections.
Code Factory has released a version of eloquence as an NVDA add-on which can be purchased from this link.. A license to use Nuance's Vocalizer synthesizer is also included in the price.
See the section entitled "Scripts" for information about NVDA add-ons.
If you still cannot find the perfect voice for you, the Extra Voices page lists several other speech synthesizers (both free and paid you can use instead.
Jaws has a "Sound cards" option in its utilities, which allows setting which audio device speech comes through. NVDA has a similar option in the Synthesizer dialog. Press NVDA+control+s to open the dialog directly, TAB to the second option which is "Audio Output Device". This is a drop-down list with the audio devices available. Select the desired device with the arrow keys. The third option in this dialog box is "Ducking". This controls whether NVDA lowers ("Ducks") the volume of sounds from other programs (e.g., music or YouTube videos). Ducking can be "Always" (while NVDA is running), only while NVDA is outputting speech and sounds, or never.
Most of the time, both NVDA and JAWS share a lot of the same terminology to describe controls e.g., radio buttons, combo boxes, checkboxes etc.
One notable difference is that NVDA differentiates between single and multi-line edit fields and will also tell you if a field is "protected" (anything you type will be replaced by asterisks). It will also alert you if text is selected in a field when you tab over to it. If so, typing will replace the highlighted text.
NVDA refers to the different languages a speech synthesizer can speak as voices, and the different voices supported by your synthesizer as variants.
NVDA has various cursors to aid in navigating Windows and applications, similar to JAWS. The terminology is slightly different as described below.
The PC cursor in NVDA's documentation is referred to as the system focus and system caret.
The equivalent to the JAWS cursor is a combination of object navigation, the review cursor and the various review modes, such as Document review, object review and Screen Review. The Screen Review function is the one perhaps most similar to the JAWS cursor. However, it is beneficial to become familiar with all of these. You will find thorough, easy to understand instructions in the user guide, or the Basic Training for NVDA ($30 AUD).
Unlike JAWS, you don't have to switch between the PC and JAWS cursor equivalents as the numpad is reserved exclusively for working with the JAWS cursor like functions.
It is worth noting that when you use object navigation or the review cursor, the mouse does not, by default, move in sync. You have to press a command to move the mouse to the location of the review cursor, which is similar to how JAWS' "invisible cursor" works. There are also commands to simulate clicking or locking both mouse buttons.
However, if you simply want to activate the current object you are focused on when using object navigation, there is a command to do this without having to move the mouse cursor to it first.
NVDA does not provide a dialog to access the notification area, as this is accessible natively. Press WINDOWS+B to access the notification area. To move between notification area items, either use the arrow keys or press the first letter of an item. Pressing the spacebar on an icon is the same as left-clicking the mouse. Pressing enter is the same as double-clicking the left mouse button (there is no distinction between these in Windows 10). Pressing the applications key or shift+f10 to open the context menu for an item.
If the first item in the notification area is "Notification chevron button", Windows is not set to show all icons. Press ENTER or spacebar to open this and then arrow through the items. To set Windows to always show all notification area icons, open "notification area" windows settings, or "select which icons appear on the taskbar” and ensure "Always show all icons in the notification area" is checked.
If you prefer to have a dialog you can access with NVDA+F11, there is a "SysTrayList" add-on available in the Add-ons website.
Microsoft Office 2007 replaced the menu and toolbars with a "ribbon". Like the notification area, these are accessible, so NVDA does not provide a "virtual ribbon" replacement. Microsoft has a page on Using the keyboard to work with the ribbon. Essentially press ALT or ALT+letter to access individual ribbons. Press CONTROL+LEFT and RIGHT ARROWS to move between groups within the current ribbon (e.g., Clipboard, font, paragraph, etc in Word's Home ribbon). Press TAB to move between individual items in each ribbon and spacebar or enter to activate the current ribbon item. The Ribbon also includes "tell me". Press alt+q, type the command or feature you would like to access, use the arrow keys to select it from the list and enter to activate it.
JAWS has only single type of progress bar announcement E.G speaking the percentage as it changes. In NVDA, This can be done verbally ("5%", "6%", "23%", etc), as beeps, increasing in pitch, or both. To adjust this, press NVDA+U. Alternatively, it is available from the Object Presentation settings. Press NVDA+control+o to open these settings.
Jaws has a command INSERT+4 to select symbols. In NVDA INSERT+4 (assuming INSERT is your NVDA modifier key) toggle speak command keys, which reports when non-alphanumeric keys, such as spacebar or arrows are pressed. To select special characters can be done in different ways in many programs. For instance, press CONTROL+ALT+E to type a Euro symbol in Word. The insert symbol functionality in Word (ALT+N, then U) is accessible, although some of the symbols listed in the "more symbols" dialog are not read correctly in all versions of Word. Similarly, the "Character Map" program in Windows itself allows any symbol from any font to be inserted. Again, not all characters are completely described.
The Windows 10 Emoji window is accessible. Press WINDOWS+. (WINDOWS+full stop). Press TAB to move to the categories, select a category then press enter. Press SHIFT+TAB to move to the list of emoji for that category, use the arrows to move between the available emoji and enter to insert the current emoji into text. Press escape when done.
In JAWS 15 or later, you can use numpad keys to navigate apps using a tree-like structure, similar to how users of smartphone screen readers such as VoiceOver would navigate touchscreens. in NVDA, object navigation and object mode touch commands can be used for this purpose
The virtual cursor in NVDA is known as browse mode. It functions in much the same way as JAWS, giving you access to navigation quick keys, or in NVDA speak, single letter navigation. Browse mode is used for reading text. Focus mode is used when entering text, filling in forms on the web or typing a document in Word, for instance. On the web, NVDA automatically switches between browse and focus mode as needed. You can force NVDA to switch between focus and browse mode by pressing NVDA+spacebar. In Browse mode in Word, single letter navigation keys (like "quick keys" in Jaws) can be used to navigate between elements. Press H to jump to the next heading, A to jump to the next annotation (comment or tracked change), etc. The elements list (like Jaws' links list) also works in Word in Browse mode.
Following are some common issues you may encounter when browsing the web with NVDA for the first time, and how to address them.
In case you are unaware, JAWS has two modes for displaying webpages or other documents using the virtual cursor: simple layout and screen layout. Simple layout is the default, which displays content in a linear fashion - putting each link or control on its own line. Screen layout formats the content similar to how it's displayed on screen.
The default in NVDA is screen layout, but you can easily switch to its version of simple layout by pressing NVDA+V while in browse mode. This will turn Screen layout off. Be sure to save your configuration after making this change with NVDA+CTRL+c.
While reading webpages, you might notice sometimes that NVDA says "clickable", even multiple times on the same link or control.
As of version 2018.4 and later, NVDA will now only say clickable once, so if you experience this issue, please upgrade your copy. Because there is no cost associated with upgrading, NV Access recommends always using the latest stable release of NVDA.
You can also turn off the announcement of clickable elements entirely by going to document formatting in settings (NVDA+control+d) and unchecking "clickable" in the elements group.
While JAWS is loaded, pressing ctrl+f in Internet Explorer or Firefox brings up the JAWS Find dialogue rather than activating the browser's built-in find command. This is to allow you to search for text using the virtual cursor. The regular find command will search for the next occurrence of the entered text but will not move the virtual cursor to that location. This is due to how screen readers interact with web pages.
NVDA has its own find command to search in browse mode, but it has not been tied to CTRL+F, so pressing that shortcut key calls up the browser's find command, hence find not working as expected.
To bring up NVDA's find dialogue, press NVDA+control+F. Type in what you wish to find then press enter.
NVDA's find next command is NVDA+f3. NVDA's find previous command is NVDA+shift+f3.
In JAWS, you can press JAWS+F5 to list forms, JAWS+F6 to list headings and JAWS+F7 to list links. In NVDA, the latter two have been combined into an elements list dialog, and you can access it by pressing NVDA+F7. You can then press ALT+H to select Headings (the default), ALT+F for form field, ALT+B for buttons and ALT+D for landmarks.
The equivalent of forms mode in NVDA is focus mode, and it behaves very similar to JAWS, Even switching modes automatically when navigating through a webpage. It will play a sound alerting you to which mode you are in. If desired, NVDA can speak the mode change rather than use a sound.
Details about Focus Mode can be found in the user guide.
Sometimes you may find that NVDA can seem overly verbose, particularly in some list views. This is because as far as NVDA is concerned, list views are tables. NVDA is configured by default to announce each column or row header.
To turn that option off, uncheck "Report table row/column headers" in the "Document Formatting" screen of NVDA's settings dialogue. Press NVDA+control+d to open this setting screen.
NVDA has always included a function to edit "Speech Dictionaries", which are similar to JAWS' dictionary manager files. There is a group of radio buttons in the Add/edit dictionary entry labelled type, which determines how the text in the pattern, (NVDA speak for actual word), box will be treated.
- anywhere, which is the default behavior.
- Whole word, which is how JAWS handles dictionary entries.
- Regular Expression, which is complicated.
You will also find a case sensitive checkbox.
Access the speech dictionaries with NVDA+n (to open the NVDA menu), then P for preferences, then D for dictionaries. There are three options. Default dictionary works across the board, Voice dictionary works only for the current voice, and temporary works only for the current session. Unless you know you want one of the other two, most of the time "default dictionary" is the desired dictionary to edit.
Like JAWS, scripts can be added to NVDA to provide support for other applications or to add new features that can be accessed from anywhere. These script packages are called NVDA Add-ons. You can find add-ons on the NVDA Community Add-ons page.
These include a few that emulate JAWS features not currently present in NVDA such as a system tray list, virtualise window function and ability to append text to clipboard. Scripts for popular applications such as GoldWave are also available. The user guide has details on installing add-ons, and you can read help documentation that comes with each add-on to learn more about how to use the add-on.
There is an NVDA Developer Guide with information on how to create add-ons.
From version 2019.3, NVDA includes an equivalent to JAWS' Screen Shade feature called Screen Curtain, which will blacken the screen. By default, it is not assigned to a keystroke, but you can assign one from the input gestures dialogue. See the user guide for details on how to do this.
Activating the command once will enable or disable the screen curtain until you restart your computer, whereas doing so twice quickly will enable it permanently until you disable it. You can also toggle it in the vision category in Settings.
In 2015, Christopher Toth and Tyler Spivey released a free add-on to allow NVDA users to provide remote support, similar to JAWS Tandem. To learn more about this add-on, go to the NVDA Remote site.
NVDA can use configuration profiles, which make it possible to configure certain settings to be applied only when using a program. This is done by creating an app-specific configuration profile. To create an app-specific profile, open the Configuration Profiles dialogue while using the app in question. To open the dialogue, hit NVDA+N, to bring up the NVDA menu. arrow down until you hear configuration profiles and press enter, or press NVDA+control+P.
When the dialogue opens, select New, and select "current application" when asked when to use this profile. Any changes made to NVDA settings (e.g., synthesizer, speech rate or punctuation level) are applied to this profile.
In recent versions of JAWS, you can configure a different speech synthesizer to be used when say all is active. You can do this in NVDA by creating a say all profile in the configuration profiles menu.
Here are the steps.
- Open the configurations profile from the main NVDA menu. Press NVDA, N, then arrow down to configuration profiles.
- Create a new profile by tabbing to the new button or press alt, N.
- After you name your profile, tab to the profile usage radio buttons. arrow down until you hear "say all". Hit OK
while this profile is active, you need to complete the process by configuring the synthesizer while the say all profile is active.
This guide is a community driven project and is ever expanding. If you have some experience of both JAWS and NVDA and think something's missing, feel free to add a section or revise out of date info. Spelling and grammar corrections are of course welcome. Please note that a GitHub account is required.
After Editing, please preview your changes and fill in the edit summary box before submitting.
- FAQ
- Application Support
- Connect
- Guides
- Extra Voices
- Log Files And Crash Dumps
- Log Levels (move to userguide / delete?)
This section will be moved to the NVDA repository as a priority
- Internals
- Notes Adding support for aria attributes to browsers
- Using COM with NVDA and Microsoft Word