SwitchingFromJawsToNVDA - nvaccess/nvda GitHub Wiki

Switching From JAWS To NVDA

Introduction

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.

Strengths And Weaknesses

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's Desktop and Laptop Keyboard Layouts

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.

Getting Started With NVDA

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). Refer to Quick Navigation below for more.

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.

Note On The Insert Key.

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).

Quick Navigation

NVDA includes many "Single Letter Navigation" keys. These include H for the next heading, T for the next Table, D for the next Landmark (what Jaws calls a "Region"). Hold SHIFT with the letter to jump back to the previous element of that type. Note that NVDA stops when it gets to the last element of a given type on the page, and reports, for instance, "No next heading". To make these single letter commands "Wrap" similar to Jaws, use the "Screen Wrapping for NVDA" add-on, available in the NVDA add-on store. See the section titled "Scripts" for information about NVDA add-ons.

Keyboard Manager / Navigation Quick Key Manager / Input Gestures

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.

Alternative Synthesizers

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.

Eloquence

Code Factory used to sell an Eloquence and Vocalizer bundle for NVDA, however they have stopped selling this. Tiflotechnia have updated their Vocalizer add-ons and offer this at a discount to former Code Factory customers. Please visit Tiflotechnia for more information

See the section titled "Scripts" for information about NVDA add-ons.

Even more voices

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.

Choosing a sound card, setting volume and sound balance.

Similar to JAWS, NVDA allows you to set various audio setting such as the sound card being used (which NVDA calls the Audio Output Device), as well as sound balance (known as sound split) and the volume of NVDA's speech and sounds.

You select the audio output device you want to use in the settings dialog in the audio category. Pressing NVDA+CTRL+u puts you directly in this category with the focus on the audio output device combo box.

A few presses of the tab key will move you to the Sound split mode combo box where you can select the one you'd like to use. You can also cycle through a selection of the various modes by pressing NVDA+ALT+s. See the user guide for details on how to change the modes this keystroke toggles through.

NVDA's volume can be adjusted using the synth settings ring. By default, the volume of NVDA's sounds will match the speech volume. see the User Guide for details. By default, there are no NVDA commands to change your system's audio output. Either use the windows volume mixer or the volume keys on your keyboard if present.
alternatively, at time of writing there is an add-on in the add-on store called Audio Manager that can add this functionality to NVDA. See the scripts section for info about the store.

Terminology

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.

Cursors

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.

Accessing the notification area (system tray)

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-on store.

Accessing the ribbon

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.

Progress bar announcement

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.

Accessing characters and emoji

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.

Touch cursor

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

Virtual Cursor

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.

Forms Mode

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.

the Speech dictionary

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.

Scripts

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 in NVDA's Add-on Store. Press NVDA+n to open the NVDA menu, then t for tools, then a to open the "Add-on Store".

These add-ons 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.

Screen Shade

From version 2019.3, NVDA includes an equivalent to JAWS' Screen Shade feature called Screen Curtain, which will blacken the screen. By default, this is accessed by pressing NVDA+CTRL+Escape.

pressing this keystroke 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.

Remote access

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.

Application-specific settings

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.

Alternate say all

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.

  1. Open the configurations profile from the main NVDA menu. Press NVDA, N, then arrow down to configuration profiles.
  2. Create a new profile by tabbing to the new button or press alt, N.
  3. 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.

Common Problems and their Solutions

You may encounter some issues when using NVDA for the first few times because of the differences in how JAWS and NVDA operate. This section discusses how to address them.

Browse Mode Issues

Why Is Everything On One Line?

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.

NVDA also has these modes but rather than each mode being given it's own name, you have the option to turn screen layout on or off. By default, screen layout is switched on. With screen layout off, NVDA will display the document similar to JAWS' simple layout. To toggle this on the fly when in browse mode, use NVDA+V. Be sure to save your configuration after making this change with NVDA+CTRL+c.

It Keeps Saying Clickable Clickable Clickable.

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.

Searching (or "Find" doesn't work on the web).

While JAWS is loaded, pressing ctrl+f on a webpage or other document using browse mode brings up the JAWS Find dialogue rather than activating the built-in find command of the program you are using. 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 dialogue similar to JAWS' to search in browse mode. However, it has not been tied to CTRL+F, leaving that shortcut key for the browser or other program's find command. This is why find may not work 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.

No commands to view forms and headings?

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.

General Problems

NVDA talks too much.

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.

Missing Info

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.