diff --git a/.github/workflows/regenerate_english_userDocs_translation_source.yml b/.github/workflows/regenerate_english_userDocs_translation_source.yml new file mode 100644 index 00000000000..2bdd678b4fe --- /dev/null +++ b/.github/workflows/regenerate_english_userDocs_translation_source.yml @@ -0,0 +1,94 @@ +name: Rebuild English User Documentation for Translation + +on: + push: + branches: + - beta + paths: + - 'user_docs/en/*.md' + +jobs: + rebuild-translation-source: + runs-on: windows-latest + + steps: + - name: Checkout repository + uses: actions/checkout@v3 + with: + fetch-depth: 0 + + - name: Set up Python + uses: actions/setup-python@v4 + with: + python-version: '3.11' + + - name: Install dependencies + run: | + python -m pip install --upgrade pip + pip install lxml requests + + - name: update xliff files + shell: pwsh + run: | + # for any English markdown files changed within the commits of this push, + # update the corresponding xliff file (if one exists) to reflect the current markdown file, + # keeping existing translation IDs in tact. + $ErrorActionPreference = 'Stop' + $changedFiles = git diff --name-only ${{github.event.before}}.. -- user_docs/en/*.md + foreach ($file in $changedFiles) { + Write-Host "$file has changed" + $baseName = [System.IO.Path]::GetFileNameWithoutExtension($file) + $xliff = "user_docs/en/$baseName.xliff" + $tempXliff = "user_docs/en/$baseName.xliff.temp" + $markdown = $file + if (Test-Path $xliff) { + Write-Host "Updating $xliff with changes from $markdown" + python user_docs/markdownTranslate.py updateXliff -x $xliff -m $file -o $tempXliff + Write-Host "Renaming $tempXliff to $xliff" + move-item -Path $tempXliff -Destination $xliff -Force + } else { + Write-Host "Ignoring $markdown as it does not have a corresponding xliff file" + } + } + if: success() + + - name: Commit and Push changes + env: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} + run: | + $ErrorActionPreference = 'Stop' + git config --local user.name "GitHub Actions" + git config --local user.email "actions@github.com" + git remote set-url origin https://x-access-token:${GITHUB_TOKEN}@github.com/${{ github.repository }}.git + $filesChanged = git diff --name-only -- *.xliff + if ($filesChanged) { + Write-Host "xliff files were changed. Committing and pushing changes." + foreach ($file in $filesChanged) { + git add $file + git commit -m "Update $file" + } + git push origin HEAD + } else { + Write-Host "No xliff files were changed. Skipping commit and push." + } + if: success() + + - name: Crowdin upload + # This step must only be run after successfully pushing changes to the repository. + # Otherwise if the push fails, subsequent runs may cause new translation IDs to be created, + # which will cause needless retranslation of existing strings. + env: + crowdinProjectID: ${{ vars.CROWDIN_PROJECT_ID }} + crowdinAuthToken: ${{ secrets.CROWDIN_AUTH_TOKEN }} + run: | + # Check if we changed userGuide.xliff in this action. + # If we did, upload it to Crowdin. + $ErrorActionPreference = 'Stop' + $changed = git diff --name-only ${{GITHUB.SHA}}.. -- user_docs/en/userGuide.xliff + if ($changed) { + Write-Host "Uploading userGuide.xliff to Crowdin" + # 18 is the file ID for userGuide.xliff in Crowdin. + python appVeyor/crowdinSync.py uploadSourceFile 18 user_docs/en/userguide.xliff + } else { + Write-Host "Not uploading userGuide.xliff to Crowdin as it has not changed" + } diff --git a/sconstruct b/sconstruct index 2bcfd0a77cf..0b9c6a401b2 100755 --- a/sconstruct +++ b/sconstruct @@ -333,6 +333,17 @@ for po in env.Glob(sourceDir.path + "/locale/*/lc_messages/*.po"): styles = os.path.join(userDocsDir.path, "styles.css") numberedHeadingsStyle = os.path.join(userDocsDir.path, "numberedHeadings.css") +# Create Non-english md files in user_docs from localized xliff and English skel files +for xliffFile in env.Glob(os.path.join(userDocsDir.path, "*", "*.xliff")): + lang = os.path.basename(xliffFile.path).split(".")[0] + if lang == "en": + continue + mdFile = os.path.splitext(xliffFile.path)[0] + ".md" + env.Command( + mdFile, + xliffFile, + [f'@{sys.executable} user_docs/markdownTranslate.py generateMarkdown -x "{xliffFile}" -o "{mdFile}"'], + ) # Allow all markdown files to be converted to html in user_docs for mdFile in env.Glob(os.path.join(userDocsDir.path, "*", "*.md")): htmlFile = env.md2html(mdFile) diff --git a/tests/markdownTranslate/en_2024.2_userGuide.md b/tests/markdownTranslate/en_2024.2_userGuide.md new file mode 100644 index 00000000000..f3f4e9658f2 --- /dev/null +++ b/tests/markdownTranslate/en_2024.2_userGuide.md @@ -0,0 +1,5022 @@ +# NVDA NVDA_VERSION User Guide + +[TOC] + + + + + +## Introduction {#Introduction} + +Welcome to NVDA! + +NonVisual Desktop Access (NVDA) is a free and open source screen reader for the Microsoft Windows operating system. +Providing feedback via synthetic speech and Braille, it enables blind or vision impaired people to access computers running Windows for no more cost than a sighted person. +NVDA is developed by [NV Access](https://www.nvaccess.org/), with contributions from the community. + +### General Features {#GeneralFeatures} + +NVDA allows blind and vision impaired people to access and interact with the Windows operating system and many third party applications. + +A short video demonstration, ["What is NVDA?"](https://www.youtube.com/watch?v=tCFyyqy9mqo) is available from the NV Access YouTube channel. + +Major highlights include: + +* Support for popular applications including web browsers, email clients, internet chat programs and office suites +* Built-in speech synthesizer supporting over 80 languages +* Reporting of textual formatting where available such as font name and size, style and spelling errors +* Automatic announcement of text under the mouse and optional audible indication of the mouse position +* Support for many refreshable braille displays, including the ability to detect many of them automatically as well as braille input on braille displays with a braille keyboard +* Ability to run entirely from a USB flash drive or other portable media without the need for installation +* Easy to use talking installer +* Translated into 54 languages +* Support for modern Windows Operating Systems including both 32 and 64 bit variants +* Ability to run during Windows sign-in and [other secure screens](#SecureScreens). +* Announcing controls and text while using touch gestures +* Support for common accessibility interfaces such as Microsoft Active Accessibility, Java Access Bridge, IAccessible2 and UI Automation +* Support for Windows Command Prompt and console applications +* The ability to highlight the system focus + +### System Requirements {#SystemRequirements} + +* Operating Systems: all 32-bit and 64-bit editions of Windows 8.1, Windows 10, Windows 11, and all Server Operating Systems starting from Windows Server 2012 R2. + * both AMD64 and ARM64 variants of Windows are supported. +* at least 150 MB of storage space. + +### Internationalization {#Internationalization} + +It is important that people anywhere in the world, no matter what language they speak, get equal access to technology. +Besides English, NVDA has been translated into 54 languages including: Afrikaans, Albanian, Amharic, Arabic, Aragonese, Bulgarian, Burmese, Catalan, Chinese (simplified and traditional), Croatian, Czech, Danish, Dutch, Farsi, Finnish, French, Galician, Georgian, German (Germany and Switzerland), Greek, Hebrew, Hindi, Hungarian, Icelandic, Irish, Italian, Japanese, Kannada, Korean, Kyrgyz, Lithuanian, Macedonian, Mongolian, Nepali, Norwegian, Polish, Portuguese (Brazil and Portugal), Punjabi, Romanian, Russian, Serbian, Slovak, Slovenian, Spanish (Colombia and Spain), Swedish, Tamil, Thai, Turkish, Ukrainian and Vietnamese. + +### Speech Synthesizer Support {#SpeechSynthesizerSupport} + +Apart from providing its messages and interface in several languages, NVDA can also enable the user to read content in any language, as long as they have a speech synthesizer that can speak that language. + +NVDA is bundled with [eSpeak NG](https://github.com/espeak-ng/espeak-ng), a free, open-source, multi-lingual speech synthesizer. + +Information about other speech synthesizers that NVDA supports can be found in the [Supported Speech Synthesizers](#SupportedSpeechSynths) section. + +### Braille support {#BrailleSupport} + +For users that own a refreshable braille display, NVDA can output its information in braille. +NVDA uses the open source braille translator [LibLouis](https://liblouis.io/) to generate braille sequences from text. +Both uncontracted and contracted braille input via a braille keyboard is also supported. +Furthermore, NVDA will detect many braille displays automatically by default. +Please see the [Supported Braille Displays](#SupportedBrailleDisplays) section for information about the supported braille displays. + +NVDA supports braille codes for many languages, including contracted, uncontracted and computer braille codes. + +### License and Copyright {#LicenseAndCopyright} + +NVDA is copyright NVDA_COPYRIGHT_YEARS NVDA contributors. + +NVDA is available under the GNU General Public License version 2, with two special exceptions. +The exceptions are outlined in the license document under the sections "Non-GPL Components in Plugins and Drivers" and "Microsoft Distributable Code". +NVDA also includes and uses components which are made available under different free and open source licenses. +You are free to share or change this software in any way you like as long as it is accompanied by the license and you make all source code available to anyone who wants it. +This applies to both original and modified copies of this software, plus any derivative works. + +For further details, you can [view the full license.](https://www.gnu.org/licenses/old-licenses/gpl-2.0.html) +For details regarding exceptions, access the license document from the NVDA menu under the "help" section. + +## NVDA Quick Start Guide {#NVDAQuickStartGuide} + +This quick start guide contains three main sections: downloading, initial setup, and running NVDA. +These are followed by information on adjusting preferences, using add-ons, participating in the community and getting help. +The information in this guide is condensed from other parts of the NVDA User Guide. +Please refer to the full User Guide for more detailed information on each topic. + +### Downloading NVDA {#GettingAndSettingUpNVDA} + +NVDA is completely free for anyone to use. +There is no license key to worry about or expensive subscription to pay. +NVDA is updated, on average, four times per year. +The latest version of NVDA is always available from the "Download" page of the [NV Access website](NVDA_URL). + +NVDA works with all recent versions of Microsoft Windows. +Check the [System Requirements](#SystemRequirements) for full details. + +#### Steps for Downloading NVDA {#StepsForDownloadingNVDA} + +These steps assume some familiarity with navigating a web page. + +* Open your web browser (Press the `Windows` key, type the word "internet" without quotes, and press `enter`) +* Load the NV Access download page (Press `alt+d`, type the following address and press `enter`): +https://www.nvaccess.org/download +* Activate the "download" button +* The browser may or may not prompt for an action after downloading, and then start the download +* Depending on the browser, the file may run automatically after it downloads +* If the file needs to be manually launched, press `alt+n` to move to the notification area, then `alt+r` to run the file (or the steps for your browser) + +### Setting up NVDA {#SettingUpNVDA} + +Running the file you have just downloaded will start a temporary copy of NVDA. +You will then be asked if you want to install NVDA, create a portable copy or just continue using the temporary copy. + +NVDA does not need access to the Internet to run or install once the launcher is downloaded. +If available, an internet connection does enable NVDA to check for updates periodically. + +#### Steps for running the downloaded launcher {#StepsForRunningTheDownloadLauncher} + +The setup file is named "nvda_2022.1.exe" or similar. +The year and version changes between updates to reflect the current release. + +1. Run the downloaded file. +Music plays while a temporary copy of NVDA loads. +Once loaded, NVDA will speak throughout the rest of the process. +1. The NVDA Launcher window appears with the license agreement. +Press `downArrow` to read the license agreement if desired. +1. Press `tab` to move to the "I agree" checkbox, then press the `spacebar` to check it. +1. Press `tab` to move through the options, then press `enter` on the desired option. + +The options are: + +* "Install NVDA on this computer": This is the main option most users want for easy use of NVDA. +* "Create portable copy": This allows NVDA to be setup in any folder without installing. +This is useful on computers without admin rights, or on a memory stick to carry with you. +When selected, NVDA walks through the steps to create a portable copy. +The main thing NVDA needs to know is the folder to setup the portable copy in. +* "Continue running": This keeps the temporary copy of NVDA running. +This is useful for testing features in a new version before installing it. +When selected, the launcher window closes and the temporary copy of NVDA continues running until it is exited or the PC is shut down. +Note that changes to settings are not saved. +* "Cancel": This closes NVDA without performing any action. + +If you plan to always use NVDA on this computer, you will want to choose to install NVDA. +Installing NVDA will allow for additional functionality such as automatic starting after sign-in, the ability to read the Windows sign-in and [secure screens](#SecureScreens). +These cannot be done with portable and temporary copies. +For full details of the limitations when running a portable or temporary copy of NVDA, please see [Portable and temporary copy restrictions](#PortableAndTemporaryCopyRestrictions). + +Installing also offers to create Start Menu and desktop shortcuts, and allow NVDA to be started with `control+alt+n`. + +#### Steps for installing NVDA from the launcher {#StepsForInstallingNVDAFromTheLauncher} + +These steps walk through the most common setup options. +For more details on the options available, please see [Installation options](#InstallingNVDA). + +1. From the launcher, ensure the checkbox to agree to the license is checked. +1. `Tab` to, and activate the "Install NVDA on this computer" button. +1. Next, are options to use NVDA during Windows sign-in and to create a desktop shortcut. +These are checked by default. +If desired, press `tab` and `spaceBar` to change any of these options, or leave them at the default. +1. Press `enter` to continue. +1. A Windows "User Account Control (UAC)" dialog appears asking "Do you want to allow this app to make changes to your PC?". +1. Press `alt+y` to accept the UAC prompt. +1. A progress bar fills up as NVDA installs. +During this process NVDA sounds an increasingly higher pitched beep. +This process is often fast and may not be noticed. +1. A dialog box appears confirm that the install of NVDA has been successful. +The message advises to "Press OK to start the installed copy". +Press `enter` to start the installed copy. +1. The "Welcome to NVDA" dialog appears, and NVDA reads a welcome message. +The focus is on the "Keyboard Layout" drop-down. +By default, "Desktop" keyboard layout uses the number pad for some function. +If desired, press `downArrow` to choose "Laptop" keyboard layout to reassign number pad functions to other keys. +1. Press `tab` to move to "Use `capsLock` as an NVDA modifier key". +`Insert` is set as the NVDA modifier key by default. +Press `spaceBar` to select `capsLock` as an alternate modifier key. +Note that the keyboard layout is set separately from the NVDA modifier key. +The NVDA key and keyboard layout can be changed later from the Keyboard Settings. +1. Use `tab` and `spaceBar` to adjust the other options on this screen. +These set whether NVDA starts automatically. +1. Press `enter` to close the dialog box with NVDA now running. + +### Running NVDA {#RunningNVDA} + +The full NVDA user guide has all the NVDA commands, split up into different sections for reference. +The tables of commands are also available in the "Commands Quick Reference". +The "Basic Training for NVDA" NVDA training module has each command in more depth with step-by-step activities. +"Basic Training for NVDA" is available from the [NV Access Shop](http://www.nvaccess.org/shop). + +Here are some basic commands which are used frequently. +All commands are configurable, so these are the default keystrokes for these functions. + +#### The NVDA Modifier Key {#NVDAModifierKey} + +The default NVDA modifier key is either the `numpadZero`, (with `numLock` off), or the `insert` key, near the `delete`, `home` and `end` keys. +The NVDA modifier key can also be set to the `capsLock` key. + +#### Input Help {#InputHelp} + +To learn and practice the location of keys, press `NVDA+1` to turn Input help on. +While in input help mode, performing any input gesture (such as pressing a key or performing a touch gesture) will report the action and describe what it does (if anything). +The actual commands will not execute while in input help mode. + +#### Starting and stopping NVDA {#StartingAndStoppingNVDA} + +| Name |Desktop key |Laptop key |Description| +|---|---|---|---| +|Start NVDA |`control+alt+n` |`control+alt+n` |Starts or restarts NVDA| +|Exit NVDA |`NVDA+q`, then `enter` |`NVDA+q`, then `enter` |Exits NVDA| +|Pause or restart speech |`shift` |`shift` |Instantly pauses speech. Pressing it again will continue speaking where it left off| +|Stop speech |`control` |`control` |Instantly stops speaking| + +#### Reading text {#ReadingText} + +| Name |Desktop key |Laptop key |Description| +|---|---|---|---| +|Say all |`NVDA+downArrow` |`NVDA+a` |Starts reading from the current position, moving it along as it goes| +|Read current line |`NVDA+upArrow` |`NVDA+l` |Reads the line. Pressing twice spells the line. Pressing three times spells the line using character descriptions (Alpha, Bravo, Charlie, etc)| +|Read selection |`NVDA+shift+upArrow` |`NVDA+shift+s` |Reads any selected text. Pressing twice will spell the information. Pressing three times will spell it using character description| +|Read clipboard text |`NVDA+c` |`NVDA+c` |Reads any text on the clipboard. Pressing twice will spell the information. Pressing three times will spell it using character description| + +#### Reporting location and other information {#ReportingLocation} + +| Name |Desktop key |Laptop key |Description| +|---|---|---|---| +|Window title |`NVDA+t` |`NVDA+t` |Reports the title of the currently active window. Pressing twice will spell the information. Pressing three times will copy it to the clipboard| +|Report focus |`NVDA+tab` |`NVDA+tab` |Reports the current control which has focus. Pressing twice will spell the information. Pressing three times will spell it using character description| +|Read window |`NVDA+b` |`NVDA+b` |Reads the entire current window (useful for dialogs)| +|Read status bar |`NVDA+end` |`NVDA+shift+end` |Reports the Status Bar if NVDA finds one. Pressing twice will spell the information. Pressing three times will copy it to the clipboard| +|Read time |`NVDA+f12` |`NVDA+f12` |Pressing once reports the current time, pressing twice reports the date. The time and date are reported in the format specified in Windows settings for the system tray clock.| +|Report text formatting |`NVDA+f` |`NVDA+f` |Reports text formatting. Pressing twice shows the information in a window| +|Report link destination |`NVDA+k` |`NVDA+k` |Pressing once speaks the destination URL of the link at the current caret or focus position. Pressing twice shows it in a window for more careful review| + +#### Toggle which information NVDA reads {#ToggleWhichInformationNVDAReads} + +| Name |Desktop key |Laptop key |Description| +|---|---|---|---| +|Speak typed characters |`NVDA+2` |`NVDA+2` |When enabled, NVDA will announce all characters you type on the keyboard.| +|Speak typed words |`NVDA+3` |`NVDA+3` |When enabled, NVDA will announce word you type on the keyboard.| +|Speak command keys |`NVDA+4` |`NVDA+4` |When enabled, NVDA will announce all non-character keys you type on the keyboard. This includes key combinations such as control plus another letter.| +|Enable mouse tracking |`NVDA+m` |`NVDA+m` |When enabled, NVDA will announce the text currently under the mouse pointer, as you move it around the screen. This allows you to find things on the screen, by physically moving the mouse, rather than trying to find them through object navigation.| + +#### The synth settings ring {#TheSynthSettingsRing} + +| Name |Desktop key |Laptop key |Description| +|---|---|---|---| +|Move to next synth setting |`NVDA+control+rightArrow` |`NVDA+shift+control+rightArrow` |Moves to the next available speech setting after the current, wrapping around to the first setting again after the last| +|Move to previous synth setting |`NVDA+control+leftArrow` |`NVDA+shift+control+leftArrow` |Moves to the next available speech setting before the current, wrapping around to the last setting after the first| +|Increment current synth setting |`NVDA+control+upArrow` |`NVDA+shift+control+upArrow` |increases the current speech setting you are on. E.g. increases the rate, chooses the next voice, increases the volume| +|Increment the current synth setting in larger steps |`NVDA+control+pageUp` |`NVDA+shift+control+pageUp` |Increases the value of the current speech setting you're on in larger steps. e.g. when you're on a voice setting, it will jump forward every 20 voices; when you're on slider settings (rate, pitch, etc) it will jump forward the value up to 20%| +|Decrement current synth setting |`NVDA+control+downArrow` |`NVDA+shift+control+downArrow` |decreases the current speech setting you are on. E.g. decreases the rate, chooses the previous voice, decreases the volume| +|Decrement the current synth setting in larger steps |`NVDA+control+pageDown` |`NVDA+shift+control+pageDown` |Decreases the value of the current speech setting you're on in larger steps. e.g. when you're on a voice setting, it will jump backward every 20 voices; when you're on a slider setting, it will jump backward the value up to 20%.| + +It is also possible to set the first or last value of the current synth setting by assign custom gestures in [Input Gestures dialog](#InputGestures), under the speech category. +This means, for example, when you're on a rate setting, it will set the rate to 0 or 100. +When you're on a voice setting, it will set the first or last voice. + +#### Web navigation {#WebNavigation} + +The full list of Single Letter Navigation keys is in the [Browse Mode](#BrowseMode) section of the user guide. + +| Command |Keystroke |Description| +|---|---|---| +|Heading |`h` |Move to the next heading| +|Heading level 1, 2, or 3 |`1`, `2`, `3` |Move to the next heading at the specified level| +|Form field |`f` |Move to the next form field (edit box, button, etc)| +|Link |`k` |Move to the next link| +|Landmark |`d` |Move to the next landmark| +|List |`l` |Move to the next list| +|Table |`t` |Move to the next table| +|Move backwards |`shift+letter` |Press `shift` and any of the above letters to move to the previous element of that type| +|Elements list |`NVDA+f7` |Lists various types of elements, such as links and headings| + +### Preferences {#Preferences} + +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 general 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. + +### Add-ons {#Addons} +Add-ons are programs which provide new or changed functionality for NVDA. +Add-ons are developed by the NVDA community, or external companies and are unaffiliated with NV Access. +As with any software, it is important to trust the developer of an add-on before using it. +Please refer to [Installing Add-ons](#AddonStoreInstalling) for ways to verify add-ons prior to installation. + +The first time the Add-on Store is opened, NVDA displays a warning about add-ons. +Add-ons are not vetted by NV Access and may have unrestricted functionality and access to information. +Press `spacebar` if you have read the warning and do not need to see it next time. +Press `tab` to reach the "OK" button, then `enter` to accept the warning and proceed to the Add-on Store. +The "[Add-ons and the Add-on Store](#AddonsManager)" section of the User Guide contains information about every feature of the Add-on Store. + +The Add-on Store is available from the Tools menu. +Press `NVDA+n` to open the NVDA menu, then `t` for tools, then `a` for Add-on Store. +When the Add-on Store opens, it shows "Available add-ons" if no add-ons are installed. +When add-ons are installed, the Add-on Store opens to the "Installed add-ons" tab. + +#### Available add-ons {#AvailableAddons} +When the window first opens, add-ons may take a few seconds to load. +NVDA will read the name of the first add-on once the list of add-ons finishes loading. +Available add-ons are listed alphabetically in a multi-column list. +To browse the list and find out about a specific add-on: + +1. Use the arrow keys or press the first letter of an add-on name to move around the list. +1. Press `tab` once to move to a description of the currently selected add-on. +1. Use the [reading keys](#ReadingText) or arrow keys to read the full description. +1. Press `tab` to the "Actions" button, which can be used to install the add-on, among other actions. +1. Press `tab` to "Other Details", which lists details such as the publisher, version and homepage. +1. To return to the list of add-ons, press `alt+a`, or `shift+tab` until reaching the list. + +#### Searching for add-ons {#SearchingForAddons} +As well as browsing all available add-ons, it is possible to filter the add-ons shown. +To search, press `alt+s` to jump to the "Search" field and type the text to search for. +Searching checks for matches in the add-on ID, display name, publisher, author and description fields. +The list updates while typing the search terms. +Once done, press `tab` to go to the filtered list of add-ons and browse the results. + +#### Installing add-ons {#InstallingAddons} + +To install an add-on: + +1. With the focus on an add-on you would like to install, press `enter`. +1. The actions menu opens with a list of actions; the first action is "Install". +1. To install the add-on, press `i` or `downArrow` to "Install" and press `enter`. +1. The focus returns to the add-on in the list and NVDA will read the details about the add-on. +1. The "Status" information reported by NVDA changes from "Available" to "Downloading". +1. Once the add-on has finished downloading, it will change to "Downloaded. Pending install". +1. Repeat with any other add-ons you would like to install at the same time. +1. Once finished, press `tab` until the focus is on the "Close" button, then press `enter`. +1. The downloaded add-ons will start the installation process once the Add-on Store is closed. +During the installation process, add-ons may display dialogs that you will need to respond to. +1. When the add-ons have been installed, a dialog appears advising that changes were made, and you must restart NVDA for the add-on installation to complete. +1. Press `enter` to restart NVDA. + +#### Managing installed add-ons {#ManagingInstalledAddons} +Press `control+tab` to move between the tabs of the Add-on Store. +The tabs include: "Installed add-ons", "Updatable add-ons", "Available add-ons" and "Installed incompatible add-ons". +Each of the tabs are set out similar to each other, as a list of add-ons, a panel for more details on the selected add-on, and a button to perform actions for the selected add-on. +The actions menu of installed add-ons includes "Disable" and "Remove" rather than "Install". +Disabling an add-on stops NVDA from loading it, but leaves it installed. +To re-enable a disabled add-on, activate "Enable" from the actions menu. +After enabling, disabling, or removing add-ons, you will be prompted to restart NVDA when closing the Add-on Store. +These changes will only take effect once NVDA is restarted. +Note that in the Add-on Store window `escape` works the same as the Close button. + +#### Updating add-ons {#UpdatingAddons} +When an update to an add-on you have installed is available, it will be listed in the "Updatable add-ons" tab. +Press `control+tab` to get to this tab from anywhere in the Add-on Store. +The status of the add-on will be listed as "Update available". +The list will display the currently installed version and the available version. +Press `enter` on the add-on to open the actions list; choose "Update". + +### Community {#Community} + +NVDA has a vibrant user community. +There is a main [English language email list](https://nvda.groups.io/g/nvda) and a page full of [local language groups](https://github.com/nvaccess/nvda/wiki/Connect). +NV Access, makers of NVDA, are active on [Twitter](https://twitter.com/nvaccess) and [Facebook](https://www.facebook.com/NVAccess). +NV Access also have a regular [In-Process blog](https://www.nvaccess.org/category/in-process/). + +There is also an [NVDA Certified Expert](https://certification.nvaccess.org/) program. +This is an online exam you can complete to demonstrate your skills in NVDA. +[NVDA Certified Experts](https://certification.nvaccess.org/) can list their contact and relevant business details. + +### Getting help {#GettingHelp} + +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](https://www.nvaccess.org/shop). + +We recommend starting with the "Basic Training for NVDA module". +This module covers concepts from getting started up to browsing the web and using object navigation. +It is available in: + +* [Electronic text](https://www.nvaccess.org/product/basic-training-for-nvda-ebook/), which includes Word DOCX, Web page HTML, eBook ePub and Kindle KFX formats. +* [Human-read, MP3 audio](https://www.nvaccess.org/product/basic-training-for-nvda-downloadable-audio/) +* [Hard-copy UEB Braille](https://www.nvaccess.org/product/basic-training-for-nvda-braille-hard-copy/) with delivery included anywhere in the world. + +Other modules, and the discounted [NVDA Productivity Bundle](https://www.nvaccess.org/product/nvda-productivity-bundle/), are available in the [NV Access Shop](https://www.nvaccess.org/shop/). + +NV Access also sells [telephone support](https://www.nvaccess.org/product/nvda-telephone-support/), either in blocks, or as part of the [NVDA Productivity Bundle](https://www.nvaccess.org/product/nvda-productivity-bundle/). +Telephone support includes local numbers in Australia and the USA. + +The [email user groups](https://github.com/nvaccess/nvda/wiki/Connect) are a great source of community help, as are [certified NVDA experts](https://certification.nvaccess.org/). + +You can make bug reports or feature requests via [GitHub](https://github.com/nvaccess/nvda/blob/master/projectDocs/issues/readme.md). +The [contribution guidelines](https://github.com/nvaccess/nvda/blob/master/.github/CONTRIBUTING.md) contain valuable information for contributing to the community. + +## More Setup Options {#MoreSetupOptions} +### Installation Options {#InstallingNVDA} + +If installing NVDA directly from the downloaded NVDA launcher, press the Install NVDA button. +If you have already closed this dialog or are wanting to install from a portable copy, please choose the Install NVDA menu item found under Tools in the NVDA menu. + +The installation dialog that appears will confirm whether you wish to install NVDA and will also tell you whether this installation will be updating a previous install. +Pressing the Continue button will start installing NVDA. +There are also a few options in this dialog which are explained below. +Once the installation has completed, a message will appear telling you that it was successful. +Pressing OK at this point will restart the newly installed copy of NVDA. + +#### Incompatible add-ons warning {#InstallWithIncompatibleAddons} + +If you have add-ons already installed there may also be a warning that incompatible add-ons will be disabled. +Before you're able to press the Continue button you will have to use the checkbox to confirm that you understand that these add-ons will be disabled. +There will also be a button present to review the add-ons that will be disabled. +Refer to the [incompatible add-ons dialog section](#incompatibleAddonsManager) for more help on this button. +After installation, you are able to re-enable incompatible add-ons at your own risk from within the [Add-on Store](#AddonsManager). + +#### Use NVDA during sign-in {#StartAtWindowsLogon} + +This option allows you to choose whether or not NVDA should automatically start while at the Windows sign-in screen, before you have entered a password. +This also includes User Account Control and [other secure screens](#SecureScreens). +This option is enabled by default for fresh installations. + +#### Create Desktop Shortcut (ctrl+alt+n) {#CreateDesktopShortcut} + +This option allows you to choose whether or not NVDA should create a shortcut on the desktop to start NVDA. +If created, this shortcut will also be assigned a shortcut key of `control+alt+n`, allowing you to start NVDA at any time with this keystroke. + +#### Copy Portable Configuration to Current User Account {#CopyPortableConfigurationToCurrentUserAccount} + +This option allows you to choose whether or not NVDA should copy the user configuration from the currently running NVDA into the configuration for the currently logged on user, for the installed copy of NVDA. +This will not copy the configuration for any other users of this system nor to the system configuration for use during Windows sign-in and [other secure screens](#SecureScreens). +This option is only available when installing from a portable copy, not when installing directly from the downloaded Launcher package. + +### Creating a Portable Copy {#CreatingAPortableCopy} + +If creating a portable copy directly from the NVDA download package, press the Create Portable Copy button. +If you have already closed this dialog or you are running an installed copy of NVDA, choose the Create Portable copy menu item found under Tools in the NVDA menu. + +The Dialog that appears allows you to choose where the portable copy should be created. +This can be a directory on your hard drive or a location on a USB thumb drive or other portable media. +There is also an option to choose whether NVDA should copy the logged on user's current NVDA configuration for use with the newly created portable copy. +This option is only available when creating a portable copy from an installed copy, not when creating from the download package. +Pressing Continue will create the portable copy. +Once creation is complete, a message will appear telling you it was successful. +Press OK to dismiss this dialog. + +### Portable and Temporary Copy Restrictions {#PortableAndTemporaryCopyRestrictions} + +If you want to take NVDA with you on a USB thumb drive or other writable media, then you should choose to create a portable copy. +The installed copy is also able to create a portable copy of itself at any time. +The portable copy also has the ability to install itself on any computer at a later time. +However, if you wish to copy NVDA onto read-only media such as a CD, you should just copy the download package. +Running the portable version directly from read-only media is not supported at this time. + +The [NVDA installer](#StepsForRunningTheDownloadLauncher) can be used as a temporary copy of NVDA. +Temporary copies prevent saving NVDA settings. +This includes disabling usage of the [Add-on Store](#AddonsManager). + +Portable and temporary copies of NVDA have the following restrictions: + +* The inability to automatically start during and/or after log-on. +* The inability to interact with applications running with administrative privileges, unless of course NVDA itself has been run also with these privileges (not recommended). +* The inability to read User Account Control (UAC) screens when trying to start an application with administrative privileges. +* The inability to support input from a touchscreen. +* The inability to provide features such as browse mode and speaking of typed characters in Windows Store apps. +* Audio ducking is not supported. + +## Using NVDA {#GettingStartedWithNVDA} +### Launching NVDA {#LaunchingNVDA} + +If you have installed NVDA with the installer, then starting NVDA is as simple as either pressing control+alt+n, or choosing NVDA from the NVDA menu under Programs on the Start Menu. +Additionally you can type NVDA into the Run dialog and press Enter. +If NVDA is already running, it will be restarted. +You can also pass some [command line options](#CommandLineOptions) which allows you to quit (-q), disable add-ons (--disable-addons), etc. + +For installed copies, NVDA stores the configuration in the roaming application data folder of the current user by default (e.g. "`C:\Users\\AppData\Roaming`"). +It is possible to change this in a way that NVDA loads its configuration from the local application data folder instead. +Consult the section about [system wide parameters](#SystemWideParameters) for more details. + +To start the portable version, go to the directory you unpacked NVDA to, and press enter or double click on nvda.exe. +If NVDA was already running, it will automatically stop before starting the portable version. + +As NVDA starts, you will first hear an ascending set of tones (telling you that NVDA is loading). +Depending on how fast your computer is, or if you are running NVDA off a USB key or other slow media, it may take a little while to start. +If it is taking an extra-long time to start, NVDA should say "Loading NVDA. Please wait..." + +If you don't hear any of this, or you hear the Windows error sound, or a descending set of tones, then this means that NVDA has an error, and you will need to possibly report a bug to the developers. +Please check out the NVDA website for how to do this. + +#### Welcome Dialog {#WelcomeDialog} + +When NVDA starts for the first time, you will be greeted by a dialog box which provides you with some basic information about the NVDA modifier key and the NVDA menu. +(Please see further sections about these topics.) +The dialog box also contains a combo box and three checkboxes. +The combo box lets you select the keyboard layout. +The first checkbox lets you control if NVDA should use the Caps Lock as an NVDA modifier key. +The second specifies whether NVDA should start automatically after you log on to Windows and is only available for installed copies of NVDA. +The third lets you control if this Welcome dialog should appear each time NVDA starts. + +#### Data usage statistics dialog {#UsageStatsDialog} + +Starting from NVDA 2018.3, the user is asked if they want to allow usage data to be sent to NV Access in order to help improve NVDA in the future. +When starting NVDA for the first time, a dialog will appear which will ask you if you want to accept sending data to NV Access while using NVDA. +You can read more info about the data gathered by NV Access in the general settings section, [Allow NV Access to gather NVDA usage statistics](#GeneralSettingsGatherUsageStats). +Note: pressing on "yes" or "no" will save this setting and the dialog will never appear again unless you reinstall NVDA. +However, you can enable or disable the data gathering process manually in NVDA's general settings panel. For changing this setting manually, you can check or uncheck the checkbox called [Allow the NVDA project to gather NVDA usage statistics](#GeneralSettingsGatherUsageStats). + +### About NVDA keyboard commands {#AboutNVDAKeyboardCommands} +#### The NVDA Modifier Key {#TheNVDAModifierKey} + +Most NVDA-specific keyboard commands consist of pressing a particular key called the NVDA modifier key in conjunction with one or more other keys. +Notable exceptions to this are the text review commands for the desktop keyboard layout which just use the numpad keys by themselves, but there are some other exceptions as well. + +NVDA can be configured so that the numpad Insert, Extended Insert and/or Caps Lock key can be used as the NVDA modifier key. +By default, both the numpad Insert and Extended Insert keys are set as NVDA modifier keys. + +If you wish to cause one of the NVDA modifier keys to behave as it usually would if NVDA were not running (e.g. you wish to turn Caps Lock on when you have set Caps Lock to be an NVDA modifier key), you can press the key twice in quick succession. + +#### Keyboard Layouts {#KeyboardLayouts} + +NVDA currently comes with two sets of key commands (known as keyboard layouts): the desktop layout and the laptop layout. +By default, NVDA is set to use the Desktop layout, though you can switch to the Laptop layout in the Keyboard category of the [NVDA Settings](#NVDASettings) dialog, found under Preferences in the NVDA menu. + +The Desktop layout makes heavy use of the numpad (with Num Lock off). +Although most laptops do not have a physical numpad, some laptops can emulate one by holding down the FN key and pressing letters and numbers on the right-hand side of the keyboard (7, 8, 9, u, i, o, j, k, l, etc.). +If your laptop cannot do this or does not allow you to turn Num Lock off, you may want to switch to the Laptop layout instead. + +### NVDA Touch Gestures {#NVDATouchGestures} + +If you are running NVDA on a device with a touchscreen, you can also control NVDA directly via touch commands. +While NVDA is running, unless touch interaction support is disabled, all touch input will go directly to NVDA. +Therefore, actions that can be performed normally without NVDA will not work. + +To toggle touch interaction support, press NVDA+control+alt+t. + +You can also enable or disable [touch interaction support](#TouchSupportEnable) from the Touch Interaction category of the NVDA settings. + +#### Exploring the Screen {#ExploringTheScreen} + +The most basic action you can perform with the touch screen is to announce the control or text at any point on the screen. +To do this, place one finger anywhere on the screen. +You can also keep your finger on the screen and move it around to read other controls and text that your finger moves over. + +#### Touch Gestures {#TouchGestures} + +When NVDA commands are described later in this user guide, they may list a touch gesture which can be used to activate that command with the touchscreen. +Following are some instructions on how to perform the various touch gestures. + +##### Taps {#Taps} + +Tap the screen quickly with one or more fingers. + +Tapping once with one finger is simply known as a tap. +Tapping with 2 fingers at the same time is a 2-finger tap and so on. + +If the same tap is performed one or more times again in quick succession, NVDA will instead treat this as a multi-tap gesture. +Tapping twice will result in a double-tap. +Tapping 3 times will result in a triple-tap and so on. +Of course, these multi-tap gestures also recognize how many fingers were used, so it's possible to have gestures like a 2-finger triple-tap, a 4-finger tap, etc. + +##### Flicks {#Flicks} + +Quickly swipe your finger across the screen. + +There are 4 possible flick gestures depending on the direction: flick left, flick right, flick up and flick down. + +Just like taps, more than one finger can be used to perform the gesture. +Therefore, gestures such as 2-finger flick up and 4-finger flick left are all possible. + +#### Touch Modes {#TouchModes} + +As there are many more NVDA commands than possible touch gestures, NVDA has several touch modes you can switch between which make certain subsets of commands available. +The two modes are text mode and object mode. +Certain NVDA commands listed in this document may have a touch mode listed in brackets after the touch gesture. +For example, flick up (text mode) means that the command will be performed if you flick up, but only while in text mode. +If the command does not have a mode listed, it will work in any mode. + + +To toggle touch modes, perform a 3-finger tap. + + +#### Touch keyboard {#TouchKeyboard} + +The touch keyboard is used to enter text and commands from a touchscreen. +When focused on an edit field, you can bring up the touch keyboard by double-tapping the touch keyboard icon on the bottom of the screen. +For tablets such as Microsoft Surface Pro, the touch keyboard is always available when the keyboard is undocked. +To dismiss the touch keyboard, double-tap the touch keyboard icon or move away from the edit field. + +While the touch keyboard is active, to locate keys on the touch keyboard, move your finger to where the touch keyboard is located (typically at the bottom of the screen), then move around the keyboard with one finger. +When you find the key you wish to press, double-tap the key or lift your finger, depending on options chosen from the [Touch Interaction Settings category](#TouchInteraction) of the NVDA Settings. + +### Input Help Mode {#InputHelpMode} + +Many NVDA commands are mentioned throughout the rest of this user guide, but an easy way to explore all the different commands is to turn on input help. + +To turn on input help, press NVDA+1. +To turn it off, press NVDA+1 again. +While in input help, performing any input gesture (such as pressing a key or performing a touch gesture) will report the action and describe what it does (if anything). +The actual commands will not execute while in input help mode. + +### The NVDA menu {#TheNVDAMenu} + +The NVDA menu allows you to control NVDA's settings, access help, save/revert your configuration, Modify speech dictionaries, access additional tools and exit NVDA. + +To get to the NVDA menu from anywhere in Windows while NVDA is running, you may do any of the following: + +* press `NVDA+n` on the keyboard. +* Perform a 2-finger double-tap on the touch screen. +* Access the system tray by pressing `Windows+b`, `downArrow` to the NVDA icon, and press `enter`. +* Alternatively, access the system tray by pressing `Windows+b`, `downArrow` to the NVDA icon, and open the context menu by pressing the `applications` key located next to the right control key on most keyboards. +On a keyboard without an `applications` key, press `shift+f10` instead. +* Right-click on the NVDA icon located in the Windows system tray + +When the menu comes up, You can use the arrow keys to navigate the menu, and the `enter` key to activate an item. + +### Basic NVDA commands {#BasicNVDACommands} + + + +| Name |Desktop key |Laptop key |Touch |Description| +|---|---|---|---|---| +|Starts or restarts NVDA |Control+alt+n |Control+alt+n |none |Starts or restarts NVDA from the Desktop, if this Windows shortcut is enabled during NVDA's installation process. This is a Windows specific shortcut and therefore it cannot be reassigned in the input gestures dialog.| +|Stop speech |Control |control |2-finger tap |Instantly stops speaking| +|Pause Speech |shift |shift |none |Instantly pauses speech. Pressing it again will continue speaking where it left off (if pausing is supported by the current synthesizer)| +|NVDA Menu |NVDA+n |NVDA+n |2-finger double-tap |Pops up the NVDA menu to allow you to access preferences, tools, help, etc.| +|Toggle Input Help Mode |NVDA+1 |NVDA+1 |none |Pressing any key in this mode will report the key, and the description of any NVDA command associated with it| +|Quit NVDA |NVDA+q |NVDA+q |none |Exits NVDA| +|Pass next key through |NVDA+f2 |NVDA+f2 |none |Tells NVDA to pass the next key press straight through to the active application - even if it is normally treated as an NVDA key command| +|Toggle application sleep mode on and off |NVDA+shift+s |NVDA+shift+z |none |sleep mode disables all NVDA commands and speech/braille output for the current application. This is most useful in applications that provide their own speech or screen reading features. Press this command again to disable sleep mode - note that NVDA will only retain the Sleep Mode setting until it is restarted.| + + + +### Reporting System Information {#ReportingSystemInformation} + + + +| Name |key |Description| +|---|---|---| +|Report date/time |NVDA+f12 |Pressing once reports the current time, pressing twice reports the date| +|Report battery status |NVDA+shift+b |Reports the battery status i.e. whether AC power is in use or the current charge percentage.| +|Report clipboard text |NVDA+c |Reports the Text on the clipboard if there is any.| + + + +### Speech modes {#SpeechModes} + +The speech mode governs how screen content, notifications, responses to commands, and other output is spoken during operation of NVDA. +The default mode is "talk", which speaks in situations that are expected when using a screen reader. +However, under certain circumstances, or when running particular programs, you may find one of the other speech modes valuable. + +The four available speech modes are: + +* Talk (Default): NVDA will speak normally in reaction to screen changes, notifications, and actions such as moving the focus, or issuing commands. +* On-demand: NVDA will only speak when you use commands with a reporting function (e.g. report the title of the window); but it will not speak in reaction to actions such as moving the focus or the cursor. +* Off: NVDA will not speak anything, however unlike sleep mode, it will silently react to commands. +* Beeps: NVDA will replace normal speech with short beeps. + +The Beeps mode may be useful when some very verbose output is scrolling in a terminal window, but you don't care what it is, only that it is continuing to scroll; or in other circumstances when the fact that there is output is more relevant than the output itself. + +The On-demand mode may be valuable when you don't need constant feedback about what is happening on screen or on the computer, but you periodically need to check particular things using review commands, etc. +Examples include while recording audio, when using screen magnification, during a meeting or a call, or as an alternative to beeps mode. + +A gesture allows cycling through the various speech modes: + + +| Name |Key |Description| +|---|---|---| +|Cycle Speech Mode |`NVDA+s` |Cycles between speech modes.| + + + +If you only need to switch between a limited subset of speech modes, see [Modes available in the Cycle speech mode command](#SpeechModesDisabling) for a way to disable unwanted modes. + +## Navigating with NVDA {#NavigatingWithNVDA} + +NVDA allows you to explore and navigate the system in several ways, including both normal interaction and review. + +### Objects {#Objects} + +Each Application and the operating system itself consist of many objects. +An object is a single item such as a piece of text, button, checkbox, slider, list or editable text field. + +### Navigating with the System Focus {#SystemFocus} + +The system focus, also known simply as the focus, is the [object](#Objects) which receives keys typed on the keyboard. +For example, if you are typing into an editable text field, the editable text field has the focus. + +The most common way of navigating around Windows with NVDA is to simply move the system focus using standard Windows keyboard commands, such as pressing tab and shift+tab to move forward and back between controls, pressing alt to get to the menu bar and then using the arrows to navigate menus, and using alt+tab to move between running applications. +As you do this, NVDA will report information about the object with focus, such as its name, type, value, state, description, keyboard shortcut and positional information. +When [Visual Highlight](#VisionFocusHighlight) is enabled, the location of the current system focus is also exposed visually. + +There are some key commands that are useful when moving with the System focus: + + +| Name |Desktop key |Laptop key |Description| +|---|---|---|---| +|Report current focus |NVDA+tab |NVDA+tab |announces the current object or control that has the System focus. Pressing twice will spell the information| +|Report title |NVDA+t |NVDA+t |Reports the title of the currently active window. Pressing twice will spell the information. Pressing three times will copy it to the clipboard| +|Read active window |NVDA+b |NVDA+b |reads all the controls in the currently active window (useful for dialogs)| +|Report Status Bar |NVDA+end |NVDA+shift+end |Reports the Status Bar if NVDA finds one. Pressing twice will spell the information. Pressing three times will copy it to the clipboard| +|Report Shortcut Key |`shift+numpad2` |`NVDA+control+shift+.` |Reports the shortcut (accelerator) key of the currently focused object| + + + +### Navigating with the System Caret {#SystemCaret} + +When an [object](#Objects) that allows navigation and/or editing of text is [focused](#SystemFocus), you can move through the text using the system caret, also known as the edit cursor. + +When the focus is on an object that has the system caret, you can use the arrow keys, page up, page down, home, end, etc. to move through the text. +You can also change the text if the control supports editing. +NVDA will announce as you move by character, word and line, and will also announce as you select and unselect text. + +NVDA provides the following key commands in relation to the system caret: + + +| Name |Desktop key |Laptop key |Description| +|---|---|---|---| +|Say all |NVDA+downArrow |NVDA+a |Starts reading from the current position of the system caret, moving it along as it goes| +|Read current line |NVDA+upArrow |NVDA+l |Reads the line where the system caret is currently situated. Pressing twice spells the line. Pressing three times spells the line using character descriptions.| +|Read current text selection |NVDA+Shift+upArrow |NVDA+shift+s |Reads any currently selected text| +|Report text formatting |NVDA+f |NVDA+f |Reports the formatting of the text where the caret is currently situated. Pressing twice shows the information in browse mode| +|Report link destination |`NVDA+k` |`NVDA+k` |Pressing once speaks the destination URL of the link at the current caret or focus position. Pressing twice shows it in a window for more careful review| +|Report caret location |NVDA+numpadDelete |NVDA+delete |Reports information about the location of the text or object at the position of system caret. For example, this might include the percentage through the document, the distance from the edge of the page or the exact screen position. Pressing twice may provide further detail.| +|Next sentence |alt+downArrow |alt+downArrow |Moves the caret to the next sentence and announces it. (only supported in Microsoft Word and Outlook)| +|Previous sentence |alt+upArrow |alt+upArrow |Moves the caret to the previous sentence and announces it. (only supported in Microsoft Word and Outlook)| + +When within a table, the following key commands are also available: + +| Name |Key |Description| +|---|---|---| +|Move to previous column |control+alt+leftArrow |Moves the system caret to the previous column (staying in the same row)| +|Move to next column |control+alt+rightArrow |Moves the system caret to the next column (staying in the same row)| +|Move to previous row |control+alt+upArrow |Moves the system caret to the previous row (staying in the same column)| +|Move to next row |control+alt+downArrow |Moves the system caret to the next row (staying in the same column)| +|Move to first column |control+alt+home |Moves the system caret to the first column (staying in the same row)| +|Move to last column |control+alt+end |Moves the system caret to the last column (staying in the same row)| +|Move to first row |control+alt+pageUp |Moves the system caret to the first row (staying in the same column)| +|Move to last row |control+alt+pageDown |Moves the system caret to the last row (staying in the same column)| +|Say all in column |`NVDA+control+alt+downArrow` |Reads the column vertically from the current cell downwards to the last cell in the column.| +|Say all in row |`NVDA+control+alt+rightArrow` |Reads the row horizontally from the current cell rightwards to the last cell in the row.| +|Read entire column |`NVDA+control+alt+upArrow` |Reads the current column vertically from top to bottom without moving the system caret.| +|Read entire row |`NVDA+control+alt+leftArrow` |Reads the current row horizontally from left to right without moving the system caret.| + + + +### Object Navigation {#ObjectNavigation} + +Most of the time, you will work with applications using commands which move the [focus](#SystemFocus) and the [caret](#SystemCaret). +However, sometimes, you may wish to explore the current application or the Operating System without moving the focus or caret. +You may also wish to work with [objects](#Objects) that cannot be accessed normally using the keyboard. +In these cases, you can use object navigation. + +Object navigation allows you to move between and obtain information about individual [objects](#Objects). +When you move to an object, NVDA will report it similarly to the way it reports the system focus. +For a way to review all text as it appears on the screen, you can instead use [screen review](#ScreenReview). + +Rather than having to move back and forth between every single object on the system, the objects are organized hierarchically. +This means that some objects contain other objects and you must move inside them to access the objects they contain. +For example, a list contains list items, so you must move inside the list in order to access its items. +If you have moved to a list item, moving next and previous will take you to other list items in the same list. +Moving to a list item's containing object will take you back to the list. +You can then move past the list if you wish to access other objects. +Similarly, a toolbar contains controls, so you must move inside the toolbar to access the controls in the toolbar. + +If you yet prefer to move back and forth between every single object on the system, you can use commands to move to the previous/next object in a flattened view. +For example, if you move to the next object in this flattened view and the current object contains other objects, NVDA will automatically move to the first object that it contains. +Alternatively, if the current object doesn't contain any objects, NVDA will move to the next object at the current level of the hierarchy. +If there is no such next object, NVDA will try to find the next object in the hierarchy based on containing objects until there are no more objects to move to. +The same rules apply to moving backwards in the hierarchy. + +The object currently being reviewed is called the navigator object. +Once you navigate to an object, you can review its content using the [text review commands](#ReviewingText) while in [Object review mode](#ObjectReview). +When [Visual Highlight](#VisionFocusHighlight) is enabled, the location of the current navigator object is also exposed visually. +By default, the navigator object moves along with the System focus, though this behaviour can be toggled on and off. + +Note: Braille following Object Navigation can be configured via [Braille Tether](#BrailleTether). + +To navigate by object, use the following commands: + + + +| Name |Desktop key |Laptop key |Touch |Description| +|---|---|---|---|---| +|Report current object |NVDA+numpad5 |NVDA+shift+o |none |Reports the current navigator object. Pressing twice spells the information, and pressing 3 times copies this object's name and value to the clipboard.| +|Move to containing object |NVDA+numpad8 |NVDA+shift+upArrow |flick up (object mode) |Moves to the object containing the current navigator object| +|Move to previous object |NVDA+numpad4 |NVDA+shift+leftArrow |none |Moves to the object before the current navigator object| +|Move to previous object in flattened view |NVDA+numpad9 |NVDA+shift+[ |flick left (object mode) |Moves to the previous object in a flattened view of the object navigation hierarchy| +|Move to next object |NVDA+numpad6 |NVDA+shift+rightArrow |none |Moves to the object after the current navigator object| +|Move to next object in flattened view |NVDA+numpad3 |NVDA+shift+] |flick right (object mode) |Moves to the next object in a flattened view of the object navigation hierarchy| +|Move to first contained object |NVDA+numpad2 |NVDA+shift+downArrow |flick down (object mode) |Moves to the first object contained by the current navigator object| +|Move to focus object |NVDA+numpadMinus |NVDA+backspace |none |Moves to the object that currently has the system focus, and also places the review cursor at the position of the System caret, if it is showing| +|Activate current navigator object |NVDA+numpadEnter |NVDA+enter |double-tap |Activates the current navigator object (similar to clicking with the mouse or pressing space when it has the system focus)| +|Move System focus or caret to current review position |NVDA+shift+numpadMinus |NVDA+shift+backspace |none |pressed once Moves the System focus to the current navigator object, pressed twice moves the system caret to the position of the review cursor| +|Report review cursor location |NVDA+shift+numpadDelete |NVDA+shift+delete |none |Reports information about the location of the text or object at the review cursor. For example, this might include the percentage through the document, the distance from the edge of the page or the exact screen position. Pressing twice may provide further detail.| +|Move review cursor to status bar |none |none |none |Reports the Status Bar if NVDA finds one. It also moves the navigator object to this location.| + + + +Note: numpad keys require the Num Lock to be turned off to work properly. + +### Reviewing Text {#ReviewingText} + +NVDA allows you to read the contents of the [screen](#ScreenReview), current [document](#DocumentReview) or current [object](#ObjectReview) by character, word or line. +This is mostly useful in places (including Windows command consoles) where there is no [system caret](#SystemCaret). +For example, you might use it to review the text of a long information message in a dialog. + +When moving the review cursor, the System caret does not follow along, so you can review text without losing your editing position. +However, by default, when the System caret moves, the review cursor follows along. +This can be toggled on and off. + +Note: Braille following the review cursor can be configured via [Braille Tether](#BrailleTether). + +The following commands are available for reviewing text: + + +| Name |Desktop key |Laptop key |Touch |Description| +|---|---|---|---|---| +|Move to top line in review |shift+numpad7 |NVDA+control+home |none |Moves the review cursor to the top line of the text| +|Move to previous line in review |numpad7 |NVDA+upArrow |flick up (text mode) |Moves the review cursor to the previous line of text| +|Report current line in review |numpad8 |NVDA+shift+. |none |Announces the current line of text where the review cursor is positioned. Pressing twice spells the line. Pressing three times spells the line using character descriptions.| +|Move to next line in review |numpad9 |NVDA+downArrow |flick down (text mode) |Move the review cursor to the next line of text| +|Move to bottom line in review |shift+numpad9 |NVDA+control+end |none |Moves the review cursor to the bottom line of text| +|Move to previous word in review |numpad4 |NVDA+control+leftArrow |2-finger flick left (text mode) |Moves the review cursor to the previous word in the text| +|Report current word in review |numpad5 |NVDA+control+. |none |Announces the current word in the text where the review cursor is positioned. Pressing twice spells the word. Pressing three times spells the word using character descriptions.| +|Move to next word in review |numpad6 |NVDA+control+rightArrow |2-finger flick right (text mode) |Move the review cursor to the next word in the text| +|Move to start of line in review |shift+numpad1 |NVDA+home |none |Moves the review cursor to the start of the current line in the text| +|Move to previous character in review |numpad1 |NVDA+leftArrow |flick left (text mode) |Moves the review cursor to the previous character on the current line in the text| +|Report current character in review |numpad2 |NVDA+. |none |Announces the current character on the line of text where the review cursor is positioned. Pressing twice reports a description or example of that character. Pressing three times reports the numeric value of the character in decimal and hexadecimal.| +|Move to next character in review |numpad3 |NVDA+rightArrow |flick right (text mode) |Move the review cursor to the next character on the current line of text| +|Move to end of line in review |shift+numpad3 |NVDA+end |none |Moves the review cursor to the end of the current line of text| +|Move to previous page in review |`NVDA+pageUp` |`NVDA+shift+pageUp` |none |Moves the review cursor to the previous page of text if supported by the application| +|Move to next page in review |`NVDA+pageDown` |`NVDA+shift+pageDown` |none |Moves the review cursor to the next page of text if supported by the application| +|Say all with review |numpadPlus |NVDA+shift+a |3-finger flick down (text mode) |Reads from the current position of the review cursor, moving it as it goes| +|Select then Copy from review cursor |NVDA+f9 |NVDA+f9 |none |Starts the select then copy process from the current position of the review cursor. The actual action is not performed until you tell NVDA where the end of the text range is| +|Select then Copy to review cursor |NVDA+f10 |NVDA+f10 |none |On the first press, text is selected from the position previously set as start marker up to and including the review cursor's current position. If the system caret can reach the text, it will be moved to the selected text. After pressing this key stroke a second time, the text will be copied to the Windows clipboard| +|Move to marked start for copy in review |NVDA+shift+f9 |NVDA+shift+f9 |none |Moves the review cursor to the position previously set start marker for copy| +|Report text formatting |NVDA+shift+f |NVDA+shift+f |none |Reports the formatting of the text where the review cursor is currently situated. Pressing twice shows the information in browse mode| +|Report current symbol replacement |None |None |none |Speaks the symbol where the review cursor is positioned. Pressed twice, shows the symbol and the text used to speak it in browse mode.| + + + +Note: numpad keys require the Num Lock to be turned off to work properly. + +A good way to remember the basic text review commands when using the Desktop layout is to think of them as being in a grid of three by three, with top to bottom being line, word and character and left to right being previous, current and next. +The layout is illustrated as follows: + +| . {.hideHeaderRow} |. |.| +|---|---|---| +|Previous line |Current line |Next line| +|Previous word |Current word |Next word| +|Previous character |Current character |Next character| + +### Review Modes {#ReviewModes} + +NVDA's [text review commands](#ReviewingText) can review content within the current navigator object, current document or screen, depending on the review mode selected. + +The following commands switch between review modes: + + +| Name |Desktop key |Laptop key |Touch |Description| +|---|---|---|---|---| +|Switch to next review mode |NVDA+numpad7 |NVDA+pageUp |2-finger flick up |switches to the next available review mode| +|Switch to previous review mode |NVDA+numpad1 |NVDA+pageDown |2-finger flick down |switches to the previous available review mode| + + + +#### Object Review {#ObjectReview} + +While in object review mode, you are able to only review the content of the current [navigator object](#ObjectNavigation). +For objects such as editable text fields or other basic text controls, this will generally be the text content. +For other objects, this may be the name and/or value. + +#### Document Review {#DocumentReview} + +When the [navigator object](#ObjectNavigation) is within a browse mode document (e.g. web page) or other complex document (e.g. a Lotus Symphony document), it is possible to switch to the document review mode. +The document review mode allows you to review the text of the entire document. + +When switching from object review to document review, the review cursor is placed in the document at the position of the navigator object. +When moving around the document with review commands, the navigator object is automatically updated to the object found at the current review cursor position. + +Note that NVDA will switch to document review from object review automatically when moving around browse mode documents. + +#### Screen Review {#ScreenReview} + +The screen review mode allows you to review the text of the screen as it appears visually within the current application. +This is similar to the screen review or mouse cursor functionality in many other Windows screen readers. + +When switching to screen review mode, the review cursor is placed at the screen position of the current [navigator object](#ObjectNavigation). +When moving around the screen with review commands, the navigator object is automatically updated to the object found at the screen position of the review cursor. + +Note that in some newer applications, NVDA may not see some or all text displayed on the screen due to the use of newer screen drawing technologies which are impossible to support at this time. + +### Navigating with the Mouse {#NavigatingWithTheMouse} + +When you move the mouse, NVDA by default reports the text that is directly under the mouse pointer as the pointer moves over it. +Where supported, NVDA will read the surrounding paragraph of text, though some controls may only read by line. + +NVDA can be configured to also announce the type of [object](#Objects) under the mouse as it moves (e.g. list, button, etc.). +This may be useful for totally blind users, as sometimes, the text isn't enough. + +NVDA provides a way for users to understand where the mouse is located relative to the dimensions of the screen by playing the current mouse coordinates as audio beeps. +The higher the mouse is on the screen, the higher the pitch of the beeps. +The further left or right the mouse is located on the screen, the further left or right the sound will be played (assuming the user has stereo speakers or headphones). + +These extra mouse features are not turned on by default in NVDA. +If you wish to take advantage of them, you can configure them from the [Mouse settings](#MouseSettings) category of the [NVDA Settings](#NVDASettings) dialog, found in the NVDA Preferences menu. + +Although a physical mouse or trackpad should be used to navigate with the mouse, NVDA provides some commands related to the mouse: + + +| Name |Desktop key |Laptop key |Touch |Description| +|---|---|---|---|---| +|Left mouse button click |numpadDivide |NVDA+[ |none |Clicks the left mouse button once. The common double click can be performed by pressing this key twice in quick succession| +|Left mouse button lock |shift+numpadDivide |NVDA+control+[ |none |Locks the left mouse button down. Press again to release it. To drag the mouse, press this key to lock the left button down and then move the mouse either physically or use one of the other mouse routing commands| +|Right mouse click |numpadMultiply |NVDA+] |tap and hold |Clicks the right mouse button once, mostly used to open context menu at the location of the mouse.| +|Right mouse button lock |shift+numpadMultiply |NVDA+control+] |none |Locks the right mouse button down. Press again to release it. To drag the mouse, press this key to lock the right button down and then move the mouse either physically or use one of the other mouse routing commands| +|Move mouse to current navigator object |NVDA+numpadDivide |NVDA+shift+m |none |Moves the mouse to the location of the current navigator object and review cursor| +|Navigate to the object under the mouse |NVDA+numpadMultiply |NVDA+shift+n |none |Set the navigator object to the object located at the position of the mouse| + + + +## Browse Mode {#BrowseMode} + +Complex read-only documents such as web pages are browsed in NVDA using browse mode. +This includes documents in the following applications: + +* Mozilla Firefox +* Microsoft Internet Explorer +* Mozilla Thunderbird +* HTML messages in Microsoft Outlook +* Google Chrome +* Microsoft Edge +* Adobe Reader +* Foxit Reader +* Supported books in Amazon Kindle for PC + +Browse mode is also optionally available for Microsoft Word documents. + +In browse mode, the content of the document is made available in a flat representation that can be navigated with the cursor keys as if it were a normal text document. +All of NVDA's [system caret](#SystemCaret) key commands will work in this mode; e.g. say all, report formatting, table navigation commands, etc. +When [Visual Highlight](#VisionFocusHighlight) is enabled, the location of the virtual browse mode caret is also exposed visually. +Information such as whether text is a link, heading, etc. is reported along with the text as you move. + +Sometimes, you will need to interact directly with controls in these documents. +For example, you will need to do this for editable text fields and lists so that you can type characters and use the cursor keys to work with the control. +You do this by switching to focus mode, where almost all keys are passed to the control. +When in Browse mode, by default, NVDA will automatically switch to focus mode if you tab to or click on a particular control that requires it. +Conversely, tabbing to or clicking on a control that does not require focus mode will switch back to browse mode. +You can also press enter or space to switch to focus mode on controls that require it. +Pressing escape will switch back to browse mode. +In addition, you can manually force focus mode, after which it will remain in effect until you choose to disable it. + + + +| Name |Key |Description| +|---|---|---| +|Toggle browse/focus modes |NVDA+space |Toggles between focus mode and browse mode| +|Exit focus mode |escape |Switches back to browse mode if focus mode was previously switched to automatically| +|Refresh browse mode document |NVDA+f5 |Reloads the current document content (useful if certain content seems to be missing from the document. Not available in Microsoft Word and Outlook.)| +|Find |NVDA+control+f |Pops up a dialog in which you can type some text to find in the current document. See [searching for text](#SearchingForText) for more information.| +|Find next |NVDA+f3 |Finds the next occurrence of the text in the document that you previously searched for| +|Find previous |NVDA+shift+f3 |Finds the previous occurrence of the text in the document you previously searched for| + + + +### Single Letter Navigation {#SingleLetterNavigation} + +While in browse mode, for quicker navigation, NVDA also provides single character keys to jump to certain fields in the document. +Note that not all of these commands are supported in every type of document. + + +The following keys by themselves jump to the next available element, while adding the shift key causes them to jump to the previous element: + +* h: heading +* l: list +* i: list item +* t: table +* k: link +* n: nonLinked text +* f: form field +* u: unvisited link +* v: visited link +* e: edit field +* b: button +* x: checkbox +* c: combo box +* r: radio button +* q: block quote +* s: separator +* m: frame +* g: graphic +* d: landmark +* o: embedded object (audio and video player, application, dialog, etc.) +* 1 to 6: headings at levels 1 to 6 respectively +* a: annotation (comment, editor revision, etc.) +* `p`: text paragraph +* w: spelling error + +To move to the beginning or end of containing elements such as lists and tables: + +| Name |Key |Description| +|---|---|---| +|Move to start of container |shift+comma |Moves to the start of the container (list, table, etc.) where the caret is positioned| +|Move past end of container |comma |Moves past the end of the container (list, table, etc.) where the caret is positioned| + + + +Some web applications such as Gmail, Twitter and Facebook use single letters as shortcut keys. +If you want to use these while still being able to use your cursor keys to read in browse mode, you can temporarily disable NVDA's single letter navigation keys. + +To toggle single letter navigation on and off for the current document, press NVDA+shift+space. + + +#### Text paragraph navigation command {#TextNavigationCommand} + +You can jump to the next or previous text paragraph by pressing `p` or `shift+p`. +Text paragraphs are defined by a group of text that appears to be written in complete sentences. +This can be useful to find the beginning of readable content on various webpages, such as: + +* News websites +* Forums +* Blog posts + +These commands can also be helpful for skipping certain kinds of clutter, such as: + +* Ads +* Menus +* Headers + +Please note, however, that while NVDA tries its best to identify text paragraphs, the algorithm is not perfect and at times can make mistakes. +Additionally, this command is different from paragraph navigation commands `control+downArrow/upArrow`. +Text paragraph navigation only jumps between text paragraphs, while paragraph navigation commands take the cursor to the previous/next paragraphs regardless of whether they contain text or not. + +#### Other navigation commands {#OtherNavigationCommands} + +In addition to the quick navigation commands listed above, NVDA has commands that have no default keys assigned. +To use these commands, you first need to assign gestures to them using the [Input Gestures dialog](#InputGestures). +Here is a list of available commands: + +* Article +* Figure +* Grouping +* Tab +* Menu item +* Toggle button +* Progress bar +* Math formula +* Vertically aligned paragraph +* Same style text +* Different style text + +Keep in mind that there are two commands for each type of element, for moving forward in the document and backward in the document, and you must assign gestures to both commands in order to be able to quickly navigate in both directions. +For example, if you want to use the `y` / `shift+y` keys to quickly navigate through tabs, you would do the following: + +1. Open input gestures dialog from browse mode. +1. Find "moves to the next tab" item in the Browse mode section. +1. Assign `y` key for found gesture. +1. Find "moves to the previous tab" item. +1. Assign `shift+y` for found gesture. + +### The Elements List {#ElementsList} + +The elements list provides access to a list of various types of elements in the document as appropriate for the application. +For example, in web browsers, the elements list can list links, headings, form fields, buttons or landmarks. +Radio buttons allow you to switch between the different types of elements. +An edit field is also provided in the dialog which allows you to filter the list to help you search for a particular item on the page. +Once you have chosen an item, you can use the provided buttons in the dialog to move to or activate that item. + + +| Name |Key |Description| +|---|---|---| +|Browse mode elements list |NVDA+f7 |Lists various types of elements in the current document| + + + +### Searching for text {#SearchingForText} + +This dialog allows you to search for terms in the current document. +In the "Type the text you wish to find" field, the text to be found can be entered. +The "Case sensitive" checkbox makes the search consider uppercase and lowercase letters differently. +For example, with "Case sensitive" selected you can find "NV Access" but not "nv access". +Use the following keys for performing searches: + + +| Name |Key |Description| +|---|---|---| +|Find text |NVDA+control+f |Opens the search dialog| +|Find next |NVDA+f3 |searches the next occurrence of the current search term| +|Find previous |NVDA+shift+f3 |searches the previous occurrence of the current search term| + + + +### Embedded Objects {#ImbeddedObjects} + +Pages can include rich content using technologies such as Oracle Java and HTML5, as well as applications and dialogs. +Where these are encountered in browse mode, NVDA will report "embedded object", "application" or "dialog", respectively. +You can quickly move to them using the o and shift+o embedded object single letter navigation keys. +To interact with these objects, you can press enter on them. +If it is accessible, you can then tab around it and interact with it like any other application. +A key command is provided to return to the original page containing the embedded object: + + +| Name |Key |Description| +|---|---|---| +|Move to containing browse mode document |NVDA+control+space |Moves the focus out of the current embedded object and into the document that contains it| + + + +### Native Selection Mode {#NativeSelectionMode} + +By default when selecting text with the `shift+arrow` keys in Browse Mode, a selection is only made within NVDA's Browse Mode representation of the document, and not within the application itself. +This means that the selection is not visible on screen, and copying text with `control+c` will only copy NVDA's plain text representation of the content. i.e. formatting of tables, or whether something is a link will not be copied. +However, NVDA has a Native Selection Mode which can be turned on in particular Browse Mode documents (so far only Mozilla Firefox) which causes the document's native selection to follow NVDA's Browse Mode selection. + + + +| Name |Key |Description| +|---|---|---| +|Toggle Native Selection Mode on and off |`NVDA+shift+f10` |Toggles native selection mode on and off| + + + +When Native Selection Mode is turned on, copying the selection with `control+c` will also use the application's own copy functionality, meaning that rich content will be copied to the clipboard, rather than plain text. +This means that pasting this content into a program such as Microsoft Word or Excel, formatting such as tables, or whether something is a link will be included. +Please note however that in native selection mode, some accessible labels or other information that NVDA generates in Browse Mode will not be included. +Also, although the application will try its best to match the native selection to NVDA's Browse Mode selection, it may not always be completely accurate. +However, for scenarios where you wish to copy an entire table or paragraph of rich content, this feature should prove useful. + +## Reading Mathematical Content {#ReadingMath} + +NVDA can read and navigate mathematical content on the web and in other applications, providing access in both speech and braille. +However, in order for NVDA to read and interact with mathematical content, you will first need to install a Math component for NvDA. +There are several NVDA add-ons available in the NVDA Add-on Store that provide support for math, including the [MathCAT NVDA add-on](https://nsoiffer.github.io/MathCAT/) and [Access8Math](https://github.com/tsengwoody/Access8Math). +Please refer to the [Add-on Store section](#AddonsManager) to learn how to browse and install available add-ons in NVDA. +NVDA also can make use of the older [MathPlayer](https://info.wiris.com/mathplayer-info) software from Wiris if found on your system, though this software is no longer maintained. + +### Supported math content {#SupportedMathContent} + +With an appropriate math component installed, NVDA supports the following types of mathematical content: + +* MathML in Mozilla Firefox, Microsoft Internet Explorer and Google Chrome. +* Microsoft Word 365 Modern Math Equations via UI automation: +NVDA is able to read and interact with math equations in Microsoft Word 365/2016 build 14326 and higher. +Note however that any previously created MathType equations must be first converted to Office Math. +This can be done by selecting each and choosing "Equation Options", then "Convert to Office Math" in the context menu. +Ensure your version of MathType is the latest version before doing this. +Microsoft Word provides linear symbol-based navigation through the equations itself and supports inputting math using several syntaxes, including LateX. +For further details, please see [Linear format equations using UnicodeMath and LaTeX in Word](https://support.microsoft.com/en-us/office/linear-format-equations-using-unicodemath-and-latex-in-word-2e00618d-b1fd-49d8-8cb4-8d17f25754f8) +* Microsoft Powerpoint, and older versions of Microsoft Word: +NVDA can read and navigate MathType equations in both Microsoft Powerpoint and Microsoft word. +MathType needs to be installed in order for this to work. +The trial version is sufficient. +It can be downloaded from the [MathType presentation page](https://www.wiris.com/en/mathtype/). +* Adobe Reader: +Note that this is not an official standard yet, so there is currently no publicly available software that can produce this content. +* Kindle Reader for PC: +NVDA can read and navigate Math in Kindle for PC for books with accessible math. + +When reading a document, NVDA will speak any supported mathematical content where it occurs. +If you are using a braille display, it will also be displayed in braille. + +### Interactive Navigation {#InteractiveNavigation} + +If you are working primarily with speech, in most cases, you will probably wish to examine the expression in smaller segments, rather than hearing the entire expression at once. + +If you are in browse mode, you can do this by moving the cursor to the mathematical content and pressing enter. + +If you are not in browse mode: + +1. move the review cursor to the mathematical content. +By default, the review cursor follows the system caret, so you can usually use the system caret to move to the desired content. +1. Then, activate the following command: + + + +| Name |Key |Description| +|---|---|---| +|Interact with math content |NVDA+alt+m |Begins interaction with math content.| + + + +At this point, NVDA will enter Math mode, where you can use commands such as the arrow keys to explore the expression. +For example, you can move through the expression with the left and right arrow keys and zoom into a portion of the expression such as a fraction using the down arrow key. + +When you wish to return to the document, simply press the escape key. + +For more information on available commands and preferences for reading and navigating within math content, please refer to the documentation for your particular math component you have installed. + +* [MathCAT documentation](https://nsoiffer.github.io/MathCAT/users.html) +* [Access8Math documentation](https://github.com/tsengwoody/Access8Math) +* [MathPlayer documentation](https://docs.wiris.com/mathplayer/en/mathplayer-user-manual.html) + +Sometimes mathematical content might be displayed as a button or other type of element which, when activated, can display a dialog or more information related to the formula. +To activate the button or the element containing the formula, press ctrl+enter. + +### Installing MathPlayer {#InstallingMathPlayer} + +Although it is generally recommended to use one of the newer NVDA add-ons to support math in NVDA, in certain limited scenarios MathPlayer may still be a more suitable choice. +E.g. MathPlayer may support a particular language or Braille code that is unsupported in newer add-ons. +MathPlayer is available for free from the Wiris website. +[Download MathPlayer](https://downloads.wiris.com/mathplayer/MathPlayerSetup.exe). +After installing MathPlayer, you will need to restart NVDA. +Please note that information about MathPlayer may state that it is only for older browsers such as Internet Explorer 8. +This is only referring to using MathPlayer to display mathematical content visually, and can be ignored by those using it to read or navigate math with NVDA. + +## Braille {#Braille} + +If you own a braille display, NVDA can display information in braille. +If your braille display has a Perkins-style keyboard, you can also enter contracted or uncontracted braille. +Braille can also be displayed on screen using the [Braille Viewer](#BrailleViewer) instead of, or at the same time as, using a physical braille display. + +Please see the [Supported Braille Displays](#SupportedBrailleDisplays) section for information about the supported braille displays. +This section also contains information about what displays support NVDA's automatic background braille display detection functionality. +You can configure braille using the [Braille category](#BrailleSettings) of the [NVDA Settings](#NVDASettings) dialog. + +### Control Type, State and Landmark abbreviations {#BrailleAbbreviations} + +In order to fit as much information as possible on a braille display, the following abbreviations have been defined to indicate control type and state as well as landmarks. + +| Abbreviation |Control type| +|---|---| +|app |application| +|art |article| +|bqt |block quote| +|btn |button| +|drbtn |drop down button| +|spnbtn |spin button| +|splbtn |split button| +|tgbtn |toggle button| +|cap |caption| +|cbo |combo box| +|chk |checkbox| +|dlg |dialog| +|doc |document| +|edt |editable text field| +|pwdedt |password edit| +|embedded |embedded object| +|enote |end note| +|fig |figure| +|fnote |foot note| +|gra |graphic| +|grp |grouping| +|hN |heading at level n, e.g. h1, h2.| +|hlp |help balloon| +|lmk |landmark| +|lnk |link| +|vlnk |visited link| +|lst |list| +|mnu |menu| +|mnubar |menu bar| +|mnubtn |menu button| +|mnuitem |menu item| +|pnl |panel| +|prgbar |progress bar| +|bsyind |busy indicator| +|rbtn |radio button| +|scrlbar |scroll bar| +|sect |section| +|stbar |status bar| +|tabctl |tab control| +|tbl |table| +|cN |table column number n, e.g. c1, c2.| +|rN |table row number n, e.g. r1, r2.| +|term |terminal| +|tlbar |tool bar| +|tltip |tool tip| +|tv |tree view| +|tvbtn |tree view button| +|tvitem |tree view item| +|lv N |a tree view item has a hierarchical level N| +|wnd |window| +|⠤⠤⠤⠤⠤ |separator| +|mrkd |marked content| + +The following state indicators are also defined: + +| Abbreviation |Control state| +|---|---| +|... |displayed when an object supports autocompletion| +|⢎⣿⡱ |displayed when an object (e.g. a toggle button) is pressed| +|⢎⣀⡱ |displayed when an object (e.g. a toggle button) is not pressed| +|⣏⣿⣹ |displayed when an object (e.g. a checkbox) is checked| +|⣏⣸⣹ |displayed when an object (e.g. a checkbox) is half checked| +|⣏⣀⣹ |displayed when an object (e.g. a checkbox) is not checked| +|- |displayed when an object (e.g. a tree view item) is collapsible| +|+ |displayed when an object (e.g. a tree view item) is Expandable| +|*** |displayed when a protected control or document is encountered| +|clk |displayed when an object is clickable| +|cmnt |displayed when there is a comment for a spreadsheet cell or piece of text in a document| +|frml |displayed when there is a formula on a spreadsheet cell| +|invalid |displayed when an invalid entry has been made| +|ldesc |displayed when an object (usually a graphic) has a long description| +|mln |displayed when an edit field allows typing multiple lines of text such as comment fields on websites| +|req |displayed when a required form field is encountered| +|ro |displayed when an object (e.g. an editable text field) is read-only| +|sel |displayed when an object is selected| +|nsel |displayed when an object is not selected| +|sorted asc |displayed when an object is sorted ascending| +|sorted desc |displayed when an object is sorted descending| +|submnu |displayed when an object has a popup (usually a sub-menu)| + +Finally, the following abbreviations for landmarks are defined: + +| Abbreviation |Landmark| +|---|---| +|bnnr |banner| +|cinf |content info| +|cmpl |complementary| +|form |form| +|main |main| +|navi |navigation| +|srch |search| +|rgn |region| + +### Braille Input {#BrailleInput} + +NVDA supports entry of both uncontracted and contracted braille via a braille keyboard. +You can select the translation table used to translate braille into text using the [Input table](#BrailleSettingsInputTable) setting in the Braille category of the [NVDA Settings](#NVDASettings) dialog. + +When uncontracted braille is being used, text is inserted as soon as it is entered. +When using contracted braille, text is inserted when you press space or enter at the end of a word. +Note that translation can only reflect the braille word you are typing and cannot consider existing text. +For example, if you are using a braille code that begins numbers with a number sign and you press backspace to move to the end of a number, you will need to type the number sign again to enter additional numbers. + + +Pressing dot 7 erases the last entered braille cell or character. +Dot 8 translates any braille input and presses the enter key. +Pressing dot 7 + dot 8 translates any braille input, but without adding a space or pressing enter. + + +#### Inputting keyboard shortcuts {#BrailleKeyboardShortcuts} + +NVDA supports inputting keyboard shortcuts and emulating keypresses using the braille display. +This emulation comes in two forms: assigning a Braille input directly to some key press and using the virtual modifier keys. + +Commonly-used keys, such as the arrow keys or pressing Alt to reach menus, can be mapped directly to Braille inputs. +The driver for each Braille display comes pre-equipped with some of these assignments. +You can change these assignments or add new emulated keys from the [Input Gestures dialog](#InputGestures). + +While this approach is useful for commonly-pressed or unique keys (such as Tab), you may not want to assign a unique set of keys to each keyboard shortcut. +To allow emulating keypresses where modifier keys are held down, NVDA provides commands to toggle the control, alt, shift, windows, and NVDA keys, along with commands for some combinations of those keys. +To use these toggles, first press the command (or sequence of commands) for the modifier keys you want pressed. +Then input the character that's part of the keyboard shortcut you want to input. +For example, to produce control+f, use the "Toggle control key" command and then type an f, +and to input control+alt+t, use either the "Toggle control key" and "Toggle alt key" commands, in either order, or the "Toggle control and alt keys" command, followed by typing a t. + +If you accidentally toggle modifier keys, running the toggle command again will remove the modifier. + +When typing in contracted Braille, using the modifier toggle keys will cause your input to be translated just as if you had pressed dots 7+8. +In addition, the emulated keypress cannot reflect Braille typed before the modifier key was pressed. +This means that, to type alt+2 with a Braille code that uses a number sign, you must first toggle Alt and then type a number sign. + +## Vision {#Vision} + +While NVDA is primarily aimed at blind or vision impaired people who primarily use speech and/or braille to operate a computer, it also provides built-in facilities to change the contents of the screen. +Within NVDA, such a visual aid is called a vision enhancement provider. + +NVDA offers several built-in vision enhancement providers which are described below. +Additional vision enhancement providers can be provided in [NVDA add-ons](#AddonsManager). + +NVDA's vision settings can be changed in the [vision category](#VisionSettings) of the [NVDA Settings](#NVDASettings) dialog. + +### Visual Highlight {#VisionFocusHighlight} + +Visual Highlight can help to identify the [system focus](#SystemFocus), [navigator object](#ObjectNavigation) and [browse mode](#BrowseMode) positions. +These positions are highlighted with a coloured rectangle outline. + +* Solid blue highlights a combined navigator object and system focus location (e.g. because [the navigator object follows the system focus](#ReviewCursorFollowFocus)). +* Dashed blue highlights just the system focus object. +* Solid pink highlights just the navigator object. +* Solid yellow highlights the virtual caret used in browse mode (where there is no physical caret such as in web browsers). + +When Visual Highlight is enabled in the [vision category](#VisionSettings) of the [NVDA Settings](#NVDASettings) dialog, you can [change whether or not to highlight the focus, navigator object or browse mode caret](#VisionSettingsFocusHighlight). + +### Screen Curtain {#VisionScreenCurtain} + +As a blind or vision impaired user, it is often not possible or necessary to see the contents of the screen. +Furthermore, it might be hard to ensure that there isn't someone looking over your shoulder. +For this situation, NVDA contains a feature called "Screen Curtain" which can be enabled to make the screen black. + +You can enable the Screen Curtain in the [vision category](#VisionSettings) of the [NVDA Settings](#NVDASettings) dialog. + + + +| Name |Key |Description| +|---|---|---| +|Toggles the state of the screen curtain |`NVDA+control+escape` |Enable to make the screen black or disable to show the contents of the screen. Pressed once, screen curtain is enabled until you restart NVDA. Pressed twice, screen curtain is enabled until you disable it.| + + + +When the Screen Curtain is active some tasks directly based on what appears on the screen such as performing [OCR](#Win10Ocr) or taking a screenshot cannot be achieved. + +Due to a change in the Windows Magnification API, Screen Curtain had to be updated to support the newest versions of Windows. +Use NVDA 2021.2 to activate Screen Curtain with Windows 10 21H2 (10.0.19044) or later. +For security purposes, when using a new version of Windows, get visual confirmation that the Screen Curtain makes the screen entirely black. + +Please note that while Windows Magnifier is running and inverted screen colors are being used, the screen curtain cannot be enabled. + +## Content Recognition {#ContentRecognition} + +When authors don't provide sufficient information for a screen reader user to determine the content of something, various tools can be used to attempt to recognize the content from an image. +NVDA supports the optical character recognition (OCR) functionality built into Windows 10 and later to recognize text from images. +Additional content recognizers can be provided in NVDA add-ons. + +When you use a content recognition command, NVDA recognizes content from the current [navigator object](#ObjectNavigation). +By default, the navigator object follows the system focus or browse mode cursor, so you can usually just move the focus or browse mode cursor where desired. +For example, if you move the browse mode cursor to a graphic, recognition will recognize content from the graphic by default. +However, you may wish to use object navigation directly to, for example, recognize the content of an entire application window. + +Once recognition is complete, the result will be presented in a document similar to browse mode, allowing you to read the information with cursor keys, etc. +Pressing enter or space will activate (normally click) the text at the cursor if possible. +Pressing escape dismisses the recognition result. + +### Windows OCR {#Win10Ocr} + +Windows 10 and later includes OCR for many languages. +NVDA can use this to recognize text from images or inaccessible applications. + +You can set the language to use for text recognition in the [Windows OCR category](#Win10OcrSettings) of the [NVDA Settings](#NVDASettings) dialog. +Additional languages can be installed by opening the Start menu, choosing Settings, selecting Time & Language -> Region & Language and then choosing Add a language. + +When you want to monitor constantly changing content, such as when watching a video with subtitles, you can optionally enable automatic refresh of the recognized content. +This can also be done in the [Windows OCR category](#Win10OcrSettings) of the [NVDA Settings](#NVDASettings) dialog. + +Windows OCR may be partially or fully incompatible with [NVDA vision enhancements](#Vision) or other external visual aids. You will need to disable these aids before proceeding to a recognition. + + +To recognize the text in the current navigator object using Windows OCR, press NVDA+r. + + +## Application Specific Features {#ApplicationSpecificFeatures} + +NVDA provides its own extra features for some applications to make certain tasks easier or to provide access to functionality which is not otherwise accessible to screen reader users. + +### Microsoft Word {#MicrosoftWord} +#### Automatic Column and Row Header Reading {#WordAutomaticColumnAndRowHeaderReading} + +NVDA is able to automatically announce appropriate row and column headers when navigating around tables in Microsoft Word. +This requires that the Report Table row / column headers option in NVDA's Document Formatting settings, found in the [NVDA Settings](#NVDASettings) dialog, be turned on. + +If you use [UIA to access Word documents](#MSWordUIA), which is default in recent versions of Word and Windows, the cells of the first row will automatically be considered as column headers; similarly, the cells of the first column will automatically be considered as row headers. + +On the contrary, if you do not use [UIA to access Word documents](#MSWordUIA), you will have to indicate to NVDA which row or column contains the headers in any given table. +After moving to the first cell in the column or row containing the headers, use one of the following commands: + + +| Name |Key |Description| +|---|---|---| +|Set column headers |NVDA+shift+c |Pressing this once tells NVDA this is the first header cell in the row that contains column headers, which should be automatically announced when moving between columns below this row. Pressing twice will clear the setting.| +|Set row headers |NVDA+shift+r |Pressing this once tells NVDA this is the first header cell in the column that contains row headers, which should be automatically announced when moving between rows after this column. Pressing twice will clear the setting.| + + +These settings will be stored in the document as bookmarks compatible with other screen readers such as JAWS. +This means that users of other screen readers who open this document at a later date will automatically have the row and column headers already set. + +#### Browse Mode in Microsoft Word {#BrowseModeInMicrosoftWord} + +Similar to the web, Browse mode can be used in Microsoft Word to allow you to use features such as Quick navigation and the Elements List. + +To toggle Browse mode on and off in Microsoft Word, press NVDA+space. + +For further information about Browse mode and Quick Navigation, see the [Browse Mode section](#BrowseMode). + +##### The Elements List {#WordElementsList} + + +While in Browse mode in Microsoft Word, you can access the Elements List by pressing NVDA+f7. + +The Elements List can list headings, links, annotations (which includes comments and track changes) and errors (currently limited to spelling errors). + +#### Reporting Comments {#WordReportingComments} + + +To report any comments at the current caret position, press NVDA+alt+c. + +All comments for the document, along with other tracked changes, can also be listed in the NVDA Elements List when selecting Annotations as the type. + +### Microsoft Excel {#MicrosoftExcel} +#### Automatic Column and Row Header Reading {#ExcelAutomaticColumnAndRowHeaderReading} + +NVDA is able to automatically announce appropriate row and column headers when navigating around Excel worksheets. +This firstly requires that the Report Table row / column headers option in NVDA's Document Formatting settings, found in the [NVDA Settings](#NVDASettings) dialog, be turned on. +Secondly, NVDA needs to know which row or column contains the headers. +After moving to the first cell in the column or row containing the headers, use one of the following commands: + + +| Name |Key |Description| +|---|---|---| +|Set column headers |NVDA+shift+c |Pressing this once tells NVDA this is the first header cell in the row that contains column headers, which should be automatically announced when moving between columns below this row. Pressing twice will clear the setting.| +|Set row headers |NVDA+shift+r |Pressing this once tells NVDA this is the first header cell in the column that contains row headers, which should be automatically announced when moving between rows after this column. Pressing twice will clear the setting.| + + +These settings will be stored in the workbook as defined name ranges compatible with other screen readers such as JAWS. +This means that users of other screen readers who open this workbook at a later date will automatically have the row and column headers already set. + +#### The Elements List {#ExcelElementsList} + +Similar to the web, NVDA has an Elements List for Microsoft Excel that allows you to list and access several different types of information. + +To access the Elements List in Excel, press NVDA+f7. + +The various types of information available in the Elements List are: + +* Charts: This lists all charts in the active worksheet. +Selecting a chart and pressing enter or the Move to button focuses the chart for navigating and reading with the arrow keys. +* Comments: This lists all cells in the active worksheet containing comments. +The cell address along with its comments are shown for each cell. +Pressing enter or the Move To button when on a listed comment will move directly to that cell. +* Formulas: This lists all cells in the worksheet containing a formula. +The cell address along with its formula are shown for each cell. +Pressing enter or the Move To button on a listed formula will move directly to that cell. +* Sheets: This lists all sheets in the workbook. +Pressing f2 when on a listed sheet allows you to rename the sheet. +Pressing enter or the Move To button while on the listed sheet will switch to that sheet. +* Form fields: This lists all form fields in the active worksheet. +For each form field, the Elements List shows the alternative text of the field along with the addresses of the cells it covers. +Selecting a form field and pressing enter or the Move to button moves to that field in browse mode. + +#### Reporting Notes {#ExcelReportingComments} + + +To report any notes for the currently focused cell, press NVDA+alt+c. +In Microsoft 2016, 365 and newer, the classic comments in Microsoft Excel have been renamed to "notes". + +All notes for the worksheet can also be listed in the NVDA Elements List after pressing NVDA+f7. + +NVDA can also display a specific dialog for adding or editing a certain note. +NVDA overrides the native MS Excel notes editing region due to accessibility constraints, but the key stroke for displaying the dialog is inherited from MS Excel and therefore works also without NVDA running. + +To add or edit a certain note, in a focused cell, press shift+f2. + + +This key stroke does not appear and cannot be changed in NVDA's input gesture dialog. + +Note: it is possible to open the note editing region in MS Excel also from the context menu of any cell of the work sheet. +However, this will open the inaccessible note editing region and not the NVDA specific note editing dialog. + +In Microsoft Office 2016, 365 and newer, a new style comment dialog has been added. +This dialog is accessible and provides more features such as replying to comments, etc. +It can also be opened from the context menu of a certain cell. +The comments added to the cells via the new style comment dialog are not related to "notes". + +#### Reading Protected Cells {#ExcelReadingProtectedCells} + +If a workbook has been protected, it may not be possible to move focus to particular cells that have been locked for editing. + +To allow moving to locked cells, switch to Browse Mode by pressing NVDA+space, and then use standard Excel movement commands such as the arrow keys to move around all cells on the current worksheet. + + +#### Form Fields {#ExcelFormFields} + +Excel worksheets can include form fields. +You can access these using the Elements List or the f and shift+f form field single letter navigation keys. +Once you move to a form field in browse mode, you can press enter or space to either activate it or switch to focus mode so you can interact with it, depending on the control. +For further information about Browse mode and single letter navigation, see the [Browse Mode section](#BrowseMode). + +### Microsoft PowerPoint {#MicrosoftPowerPoint} + + + +| Name |Key |Description| +|---|---|---| +|Toggle speaker notes reading |control+shift+s |When in a running slide show, this command will toggle between the speaker notes for the slide and the content for the slide. This only affects what NVDA reads, not what is displayed on screen.| + + + +### foobar2000 {#Foobar2000} + + + +| Name |Key |Description| +|---|---|---| +|Report remaining time |control+shift+r |Reports the remaining time of the currently playing track, if any.| +|Report elapsed time |control+shift+e |Reports the elapsed time of the currently playing track, if any.| +|Report track length |control+shift+t |Reports the length of the currently playing track, if any.| + + + +Note: The above shortcuts work only with the default formatting string for foobar's status line. + +### Miranda IM {#MirandaIM} + + + +| Name |Key |Description| +|---|---|---| +|Report recent message |NVDA+control+1-4 |Reports one of the recent messages, depending on the number pressed; e.g. NVDA+control+2 reads the second most recent message.| + + + +### Poedit {#Poedit} + +NVDA offers enhanced support for Poedit 3.4 or newer. + + + +| Name |Key |Description| +|---|---|---| +|Report notes for translators |`control+shift+a` |Reports any notes for translators. If pressed twice, presents the notes in browse mode| +|Report Comment |`control+shift+c` |Reports any comment in the comments window. If pressed twice, presents the comment in browse mode| +|Report Old Source Text |`control+shift+o` |Reports the old source text, if any. If pressed twice, presents the text in browse mode| +|Report Translation Warning |`control+shift+w` |Reports a translation warning, if any. If pressed twice, presents the warning in browse mode| + + + +### Kindle for PC {#Kindle} + +NVDA supports reading and navigating books in Amazon Kindle for PC. +This functionality is only available in Kindle books designated with "Screen Reader: Supported" which you can check on the details page for the book. + +Browse mode is used to read books. +It is enabled automatically when you open a book or focus the book area. +The page will be turned automatically as appropriate when you move the cursor or use the say all command. + +You can manually turn to the next page with the pageDown key and turn to the previous page with the pageUp key. + + +Single letter navigation is supported for links and graphics, but only within the current page. +Navigating by link also includes footnotes. + +NVDA provides early support for reading and interactive navigation of mathematical content for books with accessible math. +Please see the [Reading Mathematical Content](#ReadingMath) section for further information. + +#### Text Selection {#KindleTextSelection} + +Kindle allows you to perform various functions on selected text, including obtaining a dictionary definition, adding notes and highlights, copying the text to the clipboard and searching the web. +To do this, first select text as you normally would in browse mode; e.g. by using shift and the cursor keys. + +Once you have selected text, press the applications key or shift+f10 to show the available options for working with the selection. + +If you do this with no text selected, options will be shown for the word at the cursor. + +#### User Notes {#KindleUserNotes} + +You can add a note regarding a word or passage of text. +To do this, first select the relevant text and access the selection options as described above. +Then, choose Add Note. + +When reading in browse mode, NVDA refers to these notes as comments. + +To view, edit or delete a note: + +1. Move the cursor to the text containing the note. +1. Access the options for the selection as described above. +1. Choose Edit Note. + +### Azardi {#Azardi} + + +When in the table view of added books: + +| Name |Key |Description| +|---|---|---| +|Enter |enter |Opens the selected book.| +|Context menu |applications |Opens the context menu for the selected book.| + + + +### Windows Console {#WinConsole} + +NVDA provides support for the Windows command console used by Command Prompt, PowerShell, and the Windows Subsystem for Linux. +The console window is of fixed size, typically much smaller than the buffer that holds the output. +As new text is written, the content scroll upwards and previous text is no longer visible. +On Windows versions before Windows 11 22H2, text in the console that is not visibly displayed in the window is not accessible with NVDA's text review commands. +Therefore, it is necessary to scroll the console window to read earlier text. +In newer versions of the console and in Windows Terminal, it is possible to review the entire text buffer freely without the need to scroll the window. + +The following built-in Windows Console keyboard shortcuts may be useful when [reviewing text](#ReviewingText) with NVDA in older versions of Windows Console: + +| Name |Key |Description| +|---|---|---| +|Scroll up |control+upArrow |Scrolls the console window up, so earlier text can be read.| +|Scroll down |control+downArrow |Scrolls the console window down, so later text can be read.| +|Scroll to start |control+home |Scrolls the console window to the beginning of the buffer.| +|Scroll to end |control+end |Scrolls the console window to the end of the buffer.| + + + +## Configuring NVDA {#ConfiguringNVDA} + +Most configuration can be performed using dialog boxes accessed through the Preferences sub-menu of the NVDA menu. +Many of these settings can be found in the multi-page [NVDA Settings dialog](#NVDASettings). +In all dialog boxes, press the OK button to accept any changes you have made. +To cancel any changes, press the Cancel button or the escape key. +For certain dialogs, you can press the Apply button to let the settings take effect immediately without closing the dialog. +Most NVDA dialogs support context help. + +When in a dialog, pressing `f1` opens the User Guide at the paragraph related to the focused setting or the current dialog. + +Some settings can also be changed using shortcut keys, which are listed where relevant in the sections below. + +### NVDA Settings {#NVDASettings} + + +NVDA provides many configuration parameters that can be changed using the settings dialog. +To make it easier to find the kind of settings you want to change, the dialog displays a list of configuration categories to choose from. +When you select a category, all of the settings related to it will be shown in the dialog. +To move between categories, use `tab` or `shift+tab` to reach the list of categories, and then use the up and down arrow keys to navigate the list. +From anywhere in the dialog, you may also move forward one category by pressing `ctrl+tab`, or back one category by pressing `shift+ctrl+tab`. + +Once you change one or more settings, the settings can be applied using the apply button, in which case the dialog will stay open, allowing you to change more settings or choose another category. +If you want to save your settings and close the NVDA Settings dialog, you can use the OK button. + +Some settings categories have dedicated shortcut keys. +If pressed, the shortcut key will open the NVDA Settings dialog directly to that particular category. +By default, not all categories can be accessed with keyboard commands. +If you frequently access categories that do not have dedicated shortcut keys, you may wish to use the [Input Gestures dialog](#InputGestures) to add a custom gesture such as a keyboard command or touch gesture for that category. + +The settings categories found in the NVDA Settings dialog will be outlined below. + +#### General {#GeneralSettings} + + + +##### Open General settings {#OpenGeneralSettings} + +Key: `NVDA+control+g` + +The General category of the NVDA Settings dialog sets NVDA's overall behaviour such as interface language and whether or not it should check for updates. +This category contains the following options: + +##### Language {#GeneralSettingsLanguage} + +This is a combo box which allows you to select the language that NVDA's user interface and messages should be shown in. +There are many languages, however the default option is "User Default, Windows". +This option tells NVDA to use the language that Windows is currently set to. + +Please note that NVDA must be restarted when changing the language. +When the confirmation dialog appears, select "restart now" or "restart later" if you wish to use the new language now or at a later time, respectively. If "restart later" is selected, the configuration must be saved (either manually or using the save on exit functionality). + +##### Save configuration on exit {#GeneralSettingsSaveConfig} + +This option is a checkbox that, when checked, tells NVDA to automatically save the current configuration when you exit NVDA. + +##### Show exit options when exiting NVDA {#GeneralSettingsShowExitOptions} + +This option is a checkbox that allows you to choose whether or not a dialog appears when you exit NVDA that asks what action you want to perform. +When checked, a dialog will appear when you attempt to exit NVDA asking whether you want to exit, restart, restart with add-ons disabled or install pending updates (if any). +When unchecked, NVDA will exit immediately. + +##### Play sounds when starting or exiting NVDA {#GeneralSettingsPlaySounds} + +This option is a checkbox that, when checked, tells NVDA to play sounds when it starts or exits. + +##### Logging level {#GeneralSettingsLogLevel} + +This is a combo box that lets you choose how much NVDA will log as it's running. +Generally users should not need to touch this as not too much is logged. +However, if you wish to provide information in a bug report, or enable or disable logging altogether, then it may be a useful option. + +The available logging levels are: + +* Disabled: Apart from a brief startup message, NVDA will not log anything while it runs. +* Info: NVDA will log basic information such as startup messages and information useful for developers. +* Debug warning: Warning messages that are not caused by severe errors will be logged. +* Input/output: Input from keyboard and braille displays, as well as speech and braille output will be logged. +If you are concerned about privacy, do not set the logging level to this option. +* Debug: In addition to info, warning, and input/output messages, additional debug messages will be logged. +Just like input/output, if you are concerned about privacy, you should not set the logging level to this option. + +##### Start NVDA after I sign in {#GeneralSettingsStartAfterLogOn} + +If this option is enabled, NVDA will start automatically as soon as you sign in to Windows. +This option is only available for installed copies of NVDA. + +##### Use NVDA during sign-in (requires administrator privileges) {#GeneralSettingsStartOnLogOnScreen} + +If you sign in to Windows by providing a user name and password, then enabling this option will make NVDA start automatically at the sign-in screen when Windows starts. +This option is only available for installed copies of NVDA. + +##### Use currently saved settings during sign-in and on secure screens (requires administrator privileges) {#GeneralSettingsCopySettings} + +Pressing this button copies your currently saved NVDA user configuration to NVDA's system configuration directory, so that NVDA will use it during sign-in and when running on User Account Control (UAC) and other [secure screens](#SecureScreens). +To make sure that all your settings are transferred, make sure to save your configuration first with control+NVDA+c or Save configuration in the NVDA menu. +This option is only available for installed copies of NVDA. + +##### Automatically check for updates to NVDA {#GeneralSettingsCheckForUpdates} + +If this is enabled, NVDA will automatically check for updated versions and inform you when an update is available. +You can also manually check for updates by selecting Check for updates under Help in the NVDA menu. +When manually or automatically checking for updates, it is necessary for NVDA to send some information to the update server in order to receive the correct update for your system. +The following information is always sent: + +* Current NVDA version +* Operating System version +* Whether the Operating System is 64 or 32 bit + +##### Allow NV Access to gather NVDA usage statistics {#GeneralSettingsGatherUsageStats} + +If this is enabled, NV Access will use the information from update checks in order to track the number of NVDA users including particular demographics such as Operating system and country of origin. +Note that although your IP address will be used to calculate your country during the update check, the IP address is never kept. +Apart from the mandatory information required to check for updates, the following extra information is also currently sent: + +* NVDA interface language +* Whether this copy of NVDA is portable or installed +* Name of the current speech synthesizer in use (including the name of the add-on the driver comes from) +* Name of the current Braille display in use (including the name of the add-on the driver comes from) +* The current output Braille table (if Braille is in use) + +This information greatly aides NV Access to prioritize future development of NVDA. + +##### Notify for pending updates on startup {#GeneralSettingsNotifyPendingUpdates} + +If this is enabled, NVDA will inform you when there is a pending update on startup, offering you the possibility to install it. +You can also manually install the pending update from the Exit NVDA dialog (if enabled), from the NVDA menu, or when you perform a new check from the Help menu. + +#### Speech Settings {#SpeechSettings} + + + +##### Open Speech settings {#OpenSpeechSettings} + +Key: `NVDA+control+v` + +The Speech category in the NVDA Settings dialog contains options that lets you change the speech synthesizer as well as voice characteristics for the chosen synthesizer. +For a quicker alternative way of controlling speech parameters from anywhere, please see the [Synth Settings Ring](#SynthSettingsRing) section. + +The Speech Settings category contains the following options: + +##### Change synthesizer {#SpeechSettingsChange} + +The first option in the Speech Settings category is the Change... button. This button activates the [Select Synthesizer](#SelectSynthesizer) dialog, which allows you to select the active speech synthesizer and output device. +This dialog opens on top of the NVDA Settings dialog. +Saving or dismissing the settings in the Select Synthesizer dialog will return you to the NVDA Settings dialog. + +##### Voice {#SpeechSettingsVoice} + +The Voice option is a combo box listing all the voices of the current synthesizer that you have installed. +You can use the arrow keys to listen to all the various choices. +Left and Up arrow take you up in the list, while right and down arrow move you down in the list. + +##### Variant {#SpeechSettingsVariant} + +If you are using the Espeak NG synthesizer which is packaged with NVDA, this is a combo box that allows you to select the Variant the synthesizer should speak with. +ESpeak NG's Variants are rather like voices, as they provide slightly different attributes to the eSpeak NG voice. +Some variants will sound like a male, some like a female, and some even like a frog. +If using a third-party synthesizer, you may also be able to change this value if your chosen voice supports it. + +##### Rate {#SpeechSettingsRate} + +This option allows you to change the rate of your voice. +This is a slider that goes from 0 to 100 - 0 being the slowest, 100 being the fastest. + +##### Rate boost {#SpeechSettingsRateBoost} + +Enabling this option will significantly increase the speech rate, if supported by the current synthesizer. + +##### Pitch {#SpeechSettingsPitch} + +This option allows you to change the pitch of the current voice. +It is a slider which goes from 0 to 100 - 0 being the lowest pitch and 100 being the highest. + +##### Volume {#SpeechSettingsVolume} + +This option is a slider which goes from 0 to 100 - 0 being the lowest volume and 100 being the highest. + +##### Inflection {#SpeechSettingsInflection} + +This option is a slider that lets you choose how much inflection (rise and fall in pitch) the synthesizer should use to speak with. + +##### Automatic Language switching {#SpeechSettingsLanguageSwitching} + +This checkbox allows you to toggle whether NVDA should switch speech synthesizer languages automatically if the text being read specifies its language. +This option is enabled by default. + +##### Automatic Dialect switching {#SpeechSettingsDialectSwitching} + +This checkbox allows you to toggle whether or not dialect changes should be made, rather than just actual language changes. +For example, if reading in an English U.S. voice but a document specifies that some text is in English U.K., then the synthesizer will switch accents if this option is enabled. +This option is disabled by default. + + + +##### Punctuation/Symbol Level {#SpeechSettingsSymbolLevel} + +Key: NVDA+p + +This allows you to choose the amount of punctuation and other symbols that should be spoken as words. +For example, when set to all, all symbols will be spoken as words. +This option applies to all synthesizers, not just the currently active synthesizer. + +##### Trust voice's language when processing characters and symbols {#SpeechSettingsTrust} + +On by default, this option tells NVDA if the current voice's language can be trusted when processing symbols and characters. +If you find that NVDA is reading punctuation in the wrong language for a particular synthesizer or voice, you may wish to turn this off to force NVDA to use its global language setting instead. + +##### Include Unicode Consortium data (including emoji) when processing characters and symbols {#SpeechSettingsCLDR} + +When this checkbox is checked, NVDA will include additional symbol pronunciation dictionaries when pronouncing characters and symbols. +These dictionaries contain descriptions for symbols (particularly emoji) that are provided by the [Unicode Consortium](https://www.unicode.org/consortium/) as part of their [Common Locale Data Repository](http://cldr.unicode.org/). +If you want NVDA to speak descriptions of emoji characters based on this data, you should enable this option. +However, if you are using a speech synthesizer that supports speaking emoji descriptions natively, you may wish to turn this off. + +Note that manually added or edited character descriptions are saved as part of your user settings. +Therefore, if you change the description of a particular emoji, your custom description will be spoken for that emoji regardless of whether this option is enabled. +You can add, edit or remove symbol descriptions in NVDA's [punctuation/symbol pronunciation dialog](#SymbolPronunciation). + +To toggle Unicode Consortium data inclusion from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + +##### Capital pitch change percentage {#SpeechSettingsCapPitchChange} + +This edit field allows you to type the amount that the pitch of the voice will change when speaking a capital letter. +This value is a percentage, where a negative value lowers the pitch and a positive value raises it. +For no pitch change you would use 0. +Usually, NVDA raises the pitch slightly for any capital letter, but some synthesizers may not support this well. +In case pitch change for capitals is not supported, consider [Say "cap" before capitals](#SpeechSettingsSayCapBefore) and/or [ Beep for capitals](#SpeechSettingsBeepForCaps) instead. + +##### Say "cap" before capitals {#SpeechSettingsSayCapBefore} + +This setting is a checkbox that, when checked, tells NVDA to say the word "cap" before any capital letter when spoken as an individual character such as when spelling. + +##### Beep for capitals {#SpeechSettingsBeepForCaps} + +If this checkbox is checked, NVDA will make a small beep each time it encounters a capitalized character by itself. + +##### Use spelling functionality if supported {#SpeechSettingsUseSpelling} + +Some words consist of only one character, but the pronunciation is different depending on whether the character is being spoken as an individual character (such as when spelling) or a word. +For example, in English, "a" is both a letter and a word and is pronounced differently in each case. +This option allows the synthesizer to differentiate between these two cases if the synthesizer supports this. +Most synthesizers do support it. + +This option should generally be enabled. +However, some Microsoft Speech API synthesizers do not implement this correctly and behave strangely when it is enabled. +If you are having problems with the pronunciation of individual characters, try disabling this option. + +##### Delayed descriptions for characters on cursor movement {#delayedCharacterDescriptions} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Enabled, Disabled| +|Default |Disabled| + +When this setting is checked, NVDA will say the character description when you move by characters. + +For example, while reviewing a line by characters, when the letter "b" is read NVDA will say "Bravo" after a 1 second delay. +This can be useful if it is hard to distinguish between pronunciation of symbols, or for hearing impaired users. + +The delayed character description will be cancelled if other text is spoken during that time, or if you press the `control` key. + +##### Modes available in the Cycle speech mode command {#SpeechModesDisabling} + +This checkable list allows selecting which [speech modes](#SpeechModes) are included when cycling between them using `NVDA+s`. +Modes which are unchecked are excluded. +By default all modes are included. + +For example if you do not need to use "beeps" and "off" mode you should uncheck these two, and keep both "talk" and "on-demand" checked. +Note that it is necessary to check at least two modes. + +#### Select Synthesizer {#SelectSynthesizer} + + + +##### Open Select Synthesizer dialog {#OpenSelectSynthesizer} + +Key: `NVDA+control+s` + +The Synthesizer dialog, which can be opened by activating the Change... button in the speech category of the NVDA settings dialog, allows you to select which Synthesizer NVDA should use to speak with. +Once you have selected your synthesizer of choice, you can press Ok and NVDA will load the selected Synthesizer. +If there is an error loading the synthesizer, NVDA will notify you with a message, and continue using the previous synthesizer. + +##### Synthesizer {#SelectSynthesizerSynthesizer} + +This option allows you to choose the synthesizer you wish NVDA to use for speech output. + +For a list of the Synthesizers that NVDA supports, please see the [Supported Speech Synthesizers](#SupportedSpeechSynths) section. + +One special item that will always appear in this list is "No speech", which allows you to use NVDA with no speech output whatsoever. +This may be useful for someone who wishes to only use NVDA with braille, or perhaps to sighted developers who only wish to use the Speech Viewer. + +#### Synth settings ring {#SynthSettingsRing} + +If you wish to quickly change speech settings without going to the Speech category of the NVDA settings dialog, there are some NVDA key commands that allow you to move through the most common speech settings from anywhere while running NVDA: + + +| Name |Desktop key |Laptop key |Description| +|---|---|---|---| +|Move to next synth setting |NVDA+control+rightArrow |NVDA+shift+control+rightArrow |Moves to the next available speech setting after the current, wrapping around to the first setting again after the last| +|Move to previous synth setting |NVDA+control+leftArrow |NVDA+shift+control+leftArrow |Moves to the next available speech setting before the current, wrapping around to the last setting after the first| +|Increment current synth setting |NVDA+control+upArrow |NVDA+shift+control+upArrow |increases the current speech setting you are on. E.g. increases the rate, chooses the next voice, increases the volume| +|Increment the current synth setting in a larger step |`NVDA+control+pageUp` |`NVDA+shift+control+pageUp` |Increases the value of the current speech setting you're on in larger steps. e.g. when you're on a voice setting, it will jump forward every 20 voices; when you're on slider settings (rate, pitch, etc) it will jump forward the value up to 20%| +|Decrement current synth setting |NVDA+control+downArrow |NVDA+shift+control+downArrow |decreases the current speech setting you are on. E.g. decreases the rate, chooses the previous voice, decreases the volume| +|Decrement the current synth setting in a larger step |`NVDA+control+pageDown` |`NVDA+shift+control+pageDown` |Decreases the value of the current speech setting you're on in larger steps. e.g. when you're on a voice setting, it will jump backward every 20 voices; when you're on a slider setting, it will jump backward the value up to 20%| + + + +#### Braille {#BrailleSettings} + +The Braille category in the NVDA Settings dialog contains options that let you change several aspects of braille input and output. +This category contains the following options: + +##### Change braille display {#BrailleSettingsChange} + +The Change... button in the Braille category of the NVDA Settings dialog activates the [Select Braille Display](#SelectBrailleDisplay) dialog, which allows you to select the active braille display. +This dialog opens on top of the NVDA Settings dialog. +Saving or dismissing the settings in the Select Braille Display dialog will return you to the NVDA Settings dialog. + +##### Output Table {#BrailleSettingsOutputTable} + +The next option you will come to in this category is the braille output table combo box. +In this combo box, you will find braille tables for different languages, braille standards and grades. +The chosen table will be used to translate text into braille to be presented on your braille display. +You can move from braille table to braille table in the list by using the arrow keys. + +##### Input Table {#BrailleSettingsInputTable} + +Complementary to the previous option, the next setting you will find is the braille input table combo box. +The chosen table will be used to translate braille entered on your braille display's Perkins-style keyboard into text. +You can move from braille table to braille table in the list by using the arrow keys. + +Note that this option is only useful if your braille display has a Perkins-style keyboard and this feature is supported by the braille display driver. +If input is not supported on a display which does have a braille keyboard, this will be noted in the [Supported Braille Displays](#SupportedBrailleDisplays) section. + + + +##### Braille mode {#BrailleMode} + +Key: `NVDA+alt+t` + +This option allows you to select between the available braille modes. + +Currently, two braille modes are supported, "follow cursors" and "display speech output". + +When follow cursors is selected, the braille display will follow either the system focus/caret or the navigator object/review cursor, depending on what braille is tethered to. + +When display speech output is selected, the braille display will show what NVDA speaks, or would have spoken if speech mode was set to "talk". + +##### Expand to computer braille for the word at the cursor {#BrailleSettingsExpandToComputerBraille} + +This option allows the word that is under the cursor to be displayed in non-contracted computer braille. + +##### Show Cursor {#BrailleSettingsShowCursor} + +This option allows the braille cursor to be turned on and off. +It applies to the system caret and review cursor, but not to the selection indicator. + +##### Blink Cursor {#BrailleSettingsBlinkCursor} + +This option allows the braille cursor to blink. +If blinking is turned off, the braille cursor will constantly be in the "up" position. +The selection indicator is not affected by this option, it is always dots 7 and 8 without blinking. + +##### Cursor Blink Rate (ms) {#BrailleSettingsBlinkRate} + +This option is a numerical field that allows you to change the blink rate of the cursor in milliseconds. + +##### Cursor Shape for Focus {#BrailleSettingsCursorShapeForFocus} + +This option allows you to choose the shape (dot pattern) of the braille cursor when braille is tethered to focus. +The selection indicator is not affected by this option, it is always dots 7 and 8 without blinking. + +##### Cursor Shape for Review {#BrailleSettingsCursorShapeForReview} + +This option allows you to choose the shape (dot pattern) of the braille cursor when braille is tethered to review. +The selection indicator is not affected by this option, it is always dots 7 and 8 without blinking. + +##### Show Messages {#BrailleSettingsShowMessages} + +This is a combobox that allows you to select if NVDA should display braille messages and when they should disappear automatically. + +To toggle show messages from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + +##### Message Timeout (sec) {#BrailleSettingsMessageTimeout} + +This option is a numerical field that controls how long NVDA messages are displayed on the braille display. +The NVDA message is immediately dismissed when pressing a routing key on the braille display, but appears again when pressing a corresponding key which triggers the message. +This option is shown only if "Show Messages" is set to "Use timeout". + + + +##### Tether Braille {#BrailleTether} + +Key: NVDA+control+t + +This option allows you to choose whether the braille display will follow the system focus / caret, the navigator object / review cursor, or both. +When "automatically" is selected, NVDA will follow the system focus and caret by default. +In this case, when the navigator object or the review cursor position is changed by means of explicit user interaction, NVDA will tether to review temporarily, until the focus or the caret changes. +If you want it to follow the focus and caret only, you need to configure braille to be tethered to focus. +In this case, braille will not follow the NVDA navigator during object navigation or the review cursor during review. +If you want braille to follow object navigation and text review instead, you need to configure braille to be tethered to review. +In this case, Braille will not follow system focus and system caret. + +##### Move system caret when routing review cursor {#BrailleSettingsReviewRoutingMovesSystemCaret} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Default (Never), Never, Only when tethered automatically, Always| +|Default |Never| + +This setting determines if the system caret should also be moved with a routing button press. +This option is set to Never by default, meaning that routing will never move the caret when routing the review cursor. + +When this option is set to Always, and [braille tethering](#BrailleTether) is set to "automatically" or "to review", pressing a cursor routing key will also move the system caret or focus when supported. +When the current review mode is [Screen Review](#ScreenReview), there is no physical caret. +In this case, NVDA tries to focus the object under the text you're routing to. +The same applies to [object review](#ObjectReview). + +You can also set this option to only move the caret when tethered automatically. +In that case, pressing a cursor routing key will only move the system caret or focus when NVDA is tethered to the review cursor automatically, whereas no movement will occur when manually tethered to the review cursor. + +This option is shown only if "[tether braille](#BrailleTether)" is set to "automatically" or "to review". + +To toggle move system caret when routing review cursor from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + +##### Read by Paragraph {#BrailleSettingsReadByParagraph} + +If enabled, braille will be displayed by paragraphs instead of lines. +Also, the next and previous line commands will move by paragraph accordingly. +This means that you do not have to scroll the display at the end of each line even where more text would fit on the display. +This may allow for more fluent reading of large amounts of text. +It is disabled by default. + +##### Avoid splitting words when possible {#BrailleSettingsWordWrap} + +If this is enabled, a word which is too large to fit at the end of the braille display will not be split. +Instead, there will be some blank space at the end of the display. +When you scroll the display, you will be able to read the entire word. +This is sometimes called "word wrap". +Note that if the word is too large to fit on the display even by itself, the word must still be split. + +If this is disabled, as much of the word as possible will be displayed, but the rest will be cut off. +When you scroll the display, you will then be able to read the rest of the word. + +Enabling this may allow for more fluent reading, but generally requires you to scroll the display more. + +##### Focus context presentation {#BrailleSettingsFocusContextPresentation} + +This option allows you to choose what context information NVDA will show on the braille display when an object gets focus. +Context information refers to the hierarchy of objects containing the focus. +For example, when you focus a list item, this list item is part of a list. +This list might be contained by a dialog, etc. +Please consult the section about [object navigation](#ObjectNavigation) for more information about the hierarchy that applies to objects in NVDA. + +When set to fill display for context changes, NVDA will try to display as much context information as possible on the braille display, but only for the parts of the context that have changed. +For the example above, this means that when changing focus to the list, NVDA will show the list item on the braille display. +Furthermore, if there is enough space left on the braille display, NVDA will try to show that the list item is part of a list. +If you then start moving through the list with your arrow keys, it is assumed that you are aware that you are still in the list. +Thus, for the remaining list items you focus, NVDA will only show the focused list item on the display. +In order for you to read the context again (i.e. that you are in a list and that the list is part of a dialog), you will have to scroll your braille display back. + +When this option is set to always fill the display, NVDA will try to show as much context information as possible on the braille display, regardless of whether you have seen the same context information before. +This has the advantage that NVDA will fit as much information as possible on the display. +However, the downside is that there is always a difference in the position where the focus starts on the braille display. +This can make it difficult to skim a long list of items, for example, as you will need to continually move your finger to find the start of the item. +This was the default behaviour for NVDA 2017.2 and before. + +When you set the focus context presentation option to only show the context information when scrolling back, NVDA never shows context information on your braille display by default. +Thus, in the example above, NVDA will display that you focused a list item. +However, in order for you to read the context (i.e. that you are in a list and that the list is part of a dialog), you will have to scroll your braille display back. + +To toggle focus context presentation from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + +##### Interrupt speech while scrolling {#BrailleSettingsInterruptSpeech} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Default (Enabled), Enabled, Disabled| +|Default |Enabled| + +This setting determines if speech should be interrupted when the Braille display is scrolled backwards/forwards. +Previous/next line commands always interrupt speech. + +On-going speech might be a distraction while reading Braille. +For this reason the option is enabled by default, interrupting speech when scrolling braille. + +Disabling this option allows speech to be heard while simultaneously reading Braille. + +##### Show selection {#BrailleSettingsShowSelection} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Default (Enabled), Enabled, Disabled| +|Default |Enabled| + +This setting determines if selection indicator (dots 7 and 8) is shown by the braille display. +The option is enabled by default so the selection indicator is shown. +The selection indicator might be a distraction while reading. +Disabling this option may improve readability. + +To toggle show selection from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + +#### Select Braille Display {#SelectBrailleDisplay} + + + +##### Open Select Braille Display dialog {#OpenSelectBrailleDisplay} + +Key: `NVDA+control+a` + +The Select Braille Display dialog, which can be opened by activating the Change... button in the Braille category of the NVDA settings dialog, allows you to select which Braille display NVDA should use for braille output. +Once you have selected your braille display of choice, you can press Ok and NVDA will load the selected display. +If there is an error loading the display driver, NVDA will notify you with a message, and continue using the previous display, if any. + +##### Braille Display {#SelectBrailleDisplayDisplay} + +This combo box presents you with several options depending on what braille display drivers are available on your system. +Move between these options with the arrow keys. + +The automatic option will allow NVDA to search for many supported braille displays in the background. +When this feature is enabled and you connect a supported display using USB or bluetooth, NVDA will automatically connect with this display. + +No braille means that you are not using braille. + +Please see the [Supported Braille Displays](#SupportedBrailleDisplays) section for more information about supported braille displays and which of these support automatic detection in the background. + +##### Displays to detect automatically {#SelectBrailleDisplayAutoDetect} + +When braille display is set to "Automatic", the check boxes in this list control allows you to enable and disable display drivers that will be involved in the automatic detection process. +This allows you to exclude braille display drivers you do not use on a regular basis. +For example, if you only own a display that requires the Baum driver to function, you may leave the Baum driver enabled whereas the other drivers can be disabled. + +By default, all drivers that support automatic detection are enabled. +Any driver added, for example in a future version of NVDA or in an add-on, will also be enabled by default. + +You may consult the documentation for your braille display in the section [Supported Braille Displays](#SupportedBrailleDisplays) to check whether the driver supports automatic detection of displays. + +##### Port {#SelectBrailleDisplayPort} + +This option, if available, allows you to choose what port or type of connection will be used to communicate with the braille display you have selected. +It is a combo box containing the possible choices for your braille display. + +By default, NVDA employs automatic port detection, which means the connection with the braille device will be established automatically by scanning for available USB and bluetooth devices on your system. +However, for some braille displays, you may be able to explicitly choose what port should be used. +Common options are "Automatic" (which tells NVDA to employ the default automatic port selection procedure), "USB", "Bluetooth" and legacy serial communication ports if your braille display supports this type of communication. + +This option won't be available if your braille display only supports automatic port detection. + +You may consult the documentation for your braille display in the section [Supported Braille Displays](#SupportedBrailleDisplays) to check for more details on the supported types of communication and available ports. + +Please note: If you connect multiple Braille Displays to your machine at the same time which use the same driver (E.g. connecting two Seika displays), +it is currently impossible to tell NVDA which display to use. +Therefore it is recommended to only connect one Braille Display of a given type / manufacturer to your machine at a time. + +#### Audio {#AudioSettings} + + + +##### Open Audio settings {#OpenAudioSettings} + +Key: `NVDA+control+u` + +The Audio category in the NVDA Settings dialog contains options that let you change several aspects of audio output. + +##### Output device {#SelectSynthesizerOutputDevice} + +This option allows you to choose the audio device that NVDA should instruct the selected synthesizer to speak through. + + + +##### Audio Ducking Mode {#SelectSynthesizerDuckingMode} + +Key: `NVDA+shift+d` + +This option allows you to choose if NVDA should lower the volume of other applications while NVDA is speaking, or all the time while NVDA is running. + +* No Ducking: NVDA will never lower the volume of other audio. +* Duck when outputting speech and sounds: NVDA will only lower the volume of other audio when NVDA is speaking or playing sounds. This may not work for all synthesizers. +* Always duck: NVDA will keep the volume of other audio lower the whole time NVDA is running. + +This option is only available if NVDA has been installed. +It is not possible to support audio ducking for portable and temporary copies of NVDA. + +##### Volume of NVDA sounds follows voice volume {#SoundVolumeFollowsVoice} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Disabled, Enabled| +|Default |Disabled| + +When this option is enabled, the volume of NVDA sounds and beeps will follow the volume setting of the voice you are using. +If you decrease the volume of the voice, the volume of sounds will decrease. +Similarly, if you increase the volume of the voice, the volume of sounds will increase. +This option is not available if you have started NVDA with [WASAPI disabled for audio output](#WASAPI) in Advanced Settings. + +##### Volume of NVDA sounds {#SoundVolume} + +This slider allows you to set the volume of NVDA sounds and beeps. +This setting only takes effect when "Volume of NVDA sounds follows voice volume" is disabled. +This option is not available if you have started NVDA with [WASAPI disabled for audio output](#WASAPI) in Advanced Settings. + +##### Sound split {#SelectSoundSplitMode} + +The sound split feature allows users to make use of their stereo output devices, such as headphones and speakers. +Sound split makes it possible to have NVDA speech in one channel (e.g. left) and have all other applications play their sounds in the other channel (e.g. right). +By default sound split is disabled. +A gesture allows cycling through the various sound split modes: + + +| Name |Key |Description| +|---|---|---| +|Cycle Sound Split Mode |`NVDA+alt+s` |Cycles between sound split modes.| + + + +By default this command will cycle between the following modes: + +* Sound split disabled: NVDA does not apply any sound split processing. +* NVDA on the left and applications on the right: NVDA will speak in the left channel, while other applications will play sounds in the right channel. +* NVDA on the left and applications in both channels: NVDA will speak in the left channel, while other applications will play sounds in both left and right channels. + +There are more advanced sound split modes available in NVDA setting combo box. +Among these modes, "NVDA in both channels and applications in both channels" forces all the sounds to be directed in both channels. +This mode may differ from "Sound split disabled" mode in case other audio processing interfers with channel volumes. + +Please note, that sound split doesn't work as a mixer. +For example, if an application is playing a stereo sound track while sound split is set to "NVDA on the left and applications on the right", then you will only hear the right channel of the sound track, while the left channel of the sound track will be muted. + +This option is not available if you have started NVDA with [WASAPI disabled for audio output](#WASAPI) in Advanced Settings. + +Please note, that if NVDA crashes, then it won't be able to restore application sounds volume, and those applications might still output sound only in one channel after NVDA crash. +In order to mitigate this, please restart NVDA and select the mode "NVDA in both channels and applications in both channels". + +##### Customizing Sound split modes {#CustomizeSoundSplitModes} + +This checkable list allows selecting which sound split modes are included when cycling between them using `NVDA+alt+s`. +Modes which are unchecked are excluded. +By default only three modes are included. + +* Sound split disabled. +* NVDA on the left and applications on the right. +* NVDA on the left and applications in both channels. + +Note that it is necessary to check at least one mode. +This option is not available if you have started NVDA with [WASAPI disabled for audio output](#WASAPI) in Advanced Settings. + +##### Time to keep audio device awake after speech {#AudioAwakeTime} + +This edit box specifies how long NVDA keeps the audio device awake after speech ends. +This allows NVDA to avoid certain speech glitches like dropped parts of words. +This can happen due to audio devices (especially Bluetooth and wireless devices) entering standby mode. +This might also be helpful in other use cases, such as when running NVDA inside a virtual machine (e.g. Citrix Virtual Desktop), or on certain laptops. + +Lower values may allow audio to be cut-off more often, as a device may enter standby mode too soon, causing the start of the following speech to be clipped. +Setting the value too high may cause the battery of the sound output device to discharge faster, as it stays active for longer while no sound is being sent. + +You can set the time to zero in order to disable this feature. + +#### Vision {#VisionSettings} + +The Vision category in the NVDA Settings dialog allows you to enable, disable and configure [visual aids](#Vision). + +Note that the available options in this category could be extended by [NVDA add-ons](#AddonsManager). +By default, this settings category contains the following options: + +##### Visual Highlight {#VisionSettingsFocusHighlight} + +The check boxes in the Visual Highlight grouping control the behaviour of NVDA's built-in [Visual Highlight](#VisionFocusHighlight) facility. + +* Enable Highlighting: Toggles Visual Highlight on and off. +* Highlight system focus: toggles whether the [system focus](#SystemFocus) will be highlighted. +* Highlight navigator object: toggles whether the [navigator object](#ObjectNavigation) will be highlighted. +* Highlight browse mode cursor: Toggles whether the [virtual browse mode cursor](#BrowseMode) will be highlighted. + +Note that checking and unchecking the "Enable Highlighting" check box wil also change the state of the tree other check boxes accordingly. +Therefore, if "Enable Highlighting" is off and you check this check box, the other tree check boxes will also be checked automatically. +If you only want to highlight the focus and leave the navigator object and browse mode check boxes unchecked, the state of the "Enable Highlighting" check box will be half checked. + +##### Screen Curtain {#VisionSettingsScreenCurtain} + +You can enable the [Screen Curtain](#VisionScreenCurtain) by checking the "Make screen black (immediate effect)" check box. +A warning that your screen will become black after activation will be displayed. +Before continuing (selecting "Yes"), ensure you have enabled speech / braille and will be able to control your computer without the use of the screen. +Select "No" if you no longer wish to enable the Screen Curtain. +If you are sure, you can choose the Yes button to enable the screen curtain. +If you no longer want to see this warning message every time, you can change this behaviour in the dialog that displays the message. +You can always restore the warning by checking the "Always show a warning when loading Screen Curtain" check box next to the "Make screen black" check box. + +By default, sounds are played when the Screen Curtain is toggled. +When you want to change this behaviour, you can uncheck the "Play sound when toggling Screen Curtain" check box. + +##### Settings for third party visual aids {#VisionSettingsThirdPartyVisualAids} + +Additional vision enhancement providers can be provided in [NVDA add-ons](#AddonsManager). +When these providers have adjustable settings, they will be shown in this settings category in separate groupings. +For the supported settings per provider, please refer to the documentation for that provider. + +#### Keyboard {#KeyboardSettings} + + + +##### Open Keyboard settings {#OpenKeyboardSettings} + +Key: `NVDA+control+k` + +The Keyboard category in the NVDA Settings dialog contains options that set how NVDA behaves as you use and type on your keyboard. +This settings category contains the following options: + +##### Keyboard layout {#KeyboardSettingsLayout} + +This combo box lets you choose what type of keyboard layout NVDA should use. Currently the two that come with NVDA are Desktop and Laptop. + +##### Select NVDA Modifier Keys {#KeyboardSettingsModifiers} + +The checkboxes in this list control what keys can be used as [NVDA modifier keys](#TheNVDAModifierKey). The following keys are available to choose from: + +* The Caps Lock key +* The insert key on the number pad +* The extended insert key (usually found above the arrow keys, near home and end) + +If no key is chosen as the NVDA key it may be impossible to access many NVDA commands, therefore you are required to check at least one of the modifiers. + + + +##### Speak Typed Characters {#KeyboardSettingsSpeakTypedCharacters} + +Key: NVDA+2 + +When enabled, NVDA will announce all characters you type on the keyboard. + + + +##### Speak Typed Words {#KeyboardSettingsSpeakTypedWords} + +Key: NVDA+3 + +When enabled, NVDA will announce all words you type on the keyboard. + +##### Speech interrupt for typed characters {#KeyboardSettingsSpeechInteruptForCharacters} + +If on, this option will cause speech to be interrupted each time a character is typed. This is on by default. + +##### Speech interrupt for Enter key {#KeyboardSettingsSpeechInteruptForEnter} + +If on, this option will cause speech to be interrupted each time the Enter key is pressed. This is on by default. + +##### Allow skim reading in Say All {#KeyboardSettingsSkimReading} + +If on, certain navigation commands (such as quick navigation in browse mode or moving by line or paragraph) do not stop Say All, rather Say All jumps to the new position and continues reading. + +##### Beep if Typing Lowercase Letters when Caps Lock is On {#KeyboardSettingsBeepLowercase} + +When enabled, a warning beep will be heard if a letter is typed with the shift key while Caps Lock is on. +Generally, typing shifted letters with Caps Lock is unintentional and is usually due to not realizing that Caps Lock is enabled. +Therefore, it can be quite helpful to be warned about this. + + + +##### Speak Command Keys {#KeyboardSettingsSpeakCommandKeys} + +Key: NVDA+4 + +When enabled, NVDA will announce all non-character keys you type on the keyboard. This includes key combinations such as control plus another letter. + +##### Play sound for spelling errors while typing {#KeyboardSettingsAlertForSpellingErrors} + +When enabled, a short buzzer sound will be played when a word you type contains a spelling error. +This option is only available if reporting of spelling errors is enabled in NVDA's [Document Formatting Settings](#DocumentFormattingSettings), found in the NVDA Settings dialog. + +##### Handle keys from other applications {#KeyboardSettingsHandleKeys} + +This option allows the user to control if key presses generated by applications such as on-screen keyboards and speech recognition software should be processed by NVDA. +This option is on by default, though certain users may wish to turn this off, such as those typing Vietnamese with the UniKey typing software as it will cause incorrect character input. + +#### Mouse {#MouseSettings} + + + +##### Open Mouse settings {#OpenMouseSettings} + +Key: `NVDA+control+m` + +The Mouse category in the NVDA Settings dialog allows NVDA to track the mouse, play mouse coordinate beeps and sets other mouse usage options. +This category contains the following options: + +##### Report Mouse Shape Changes {#MouseSettingsShape} + +A checkbox, that when checked means that NVDA will announce the shape of the mouse pointer each time it changes. +The mouse pointer in Windows changes shape to convey certain information such as when something is editable, or when something is loading etc. + + + +##### Enable mouse tracking {#MouseSettingsTracking} + +Key: NVDA+m + +When enabled, NVDA will announce the text currently under the mouse pointer, as you move it around the screen. This allows you to find things on the screen, by physically moving the mouse, rather than trying to find them through object navigation. + +##### Text unit resolution {#MouseSettingsTextUnit} + +If NVDA is set to announce the text under the mouse as you move it, this option allows you to choose exactly how much text will be spoken. +The options are character, word, line and paragraph. + +To toggle text unit resolution from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + +##### Report object when mouse enters it {#MouseSettingsRole} + +If this checkbox is checked, NVDA will announce information about objects as the mouse moves inside them. +This includes the role (type) of the object as well as states (checked/pressed), cell coordinates in tables, etc. +Note that the announcement of some object details might be dependent on how other settings are set, such as in the [object presentation](#ObjectPresentationSettings) or [Document Formatting](#DocumentFormattingSettings) categories. + +##### Play audio coordinates when mouse moves {#MouseSettingsAudio} + +Checking this checkbox makes NVDA play beeps as the mouse moves, so that the user can work out where the mouse is in regards to the dimensions of the screen. +The higher the mouse is on the screen, the higher the pitch of the beeps. +The further left or right the mouse is located on the screen, the further left or right the sound will be played (assuming the user has stereo speakers or headphones). + +##### Brightness controls audio coordinates volume {#MouseSettingsBrightness} + +If the "play audio coordinates when mouse moves" checkbox is checked, then checking this checkbox means that the volume of the audio coordinates beeps is controlled by how bright the screen is under the mouse. +This setting is unchecked by default. + +##### Ignore mouse input from other applications {#MouseSettingsHandleMouseControl} + +This option allows the user to ignore mouse events (including mouse movement and button presses) generated by other applications such as TeamViewer and other remote control software. +This option is unchecked by default. +If you check this option and you have the "Enable mouse tracking" option enabled, NVDA will not announce what is under the mouse if the mouse is moved by another application. + +#### Touch Interaction {#TouchInteraction} + +This settings category, only available on computers with touch capabilities, allows you to configure how NVDA interacts with touchscreens. +This category contains the following options: + +##### Enable touch interaction support {#TouchSupportEnable} + +This checkbox enables NVDA's touch interaction support. +If enabled, you can use your fingers to navigate and interact with items on screen using a touchscreen device. +If disabled, touchscreen support will be disabled as though NVDA is not running. +This setting can also be toggled using NVDA+control+alt+t. + +##### Touch typing mode {#TouchTypingMode} + +This checkbox allows you to specify the method you wish to use when entering text using the touch keyboard. +If this checkbox is checked, when you locate a key on the touch keyboard, you can lift your finger and the selected key will be pressed. +If this is unchecked, you need to double-tap on the key of the touch keyboard to press the key. + +#### Review Cursor {#ReviewCursorSettings} + +The Review Cursor category in the NVDA Settings dialog is used to configure NVDA's review cursor behaviour. +This category contains the following options: + + + +##### Follow System Focus {#ReviewCursorFollowFocus} + +Key: NVDA+7 + +When enabled, The review cursor will always be placed in the same object as the current system focus whenever the focus changes. + + + +##### Follow System Caret {#ReviewCursorFollowCaret} + +Key: NVDA+6 + +When enabled, the review cursor will automatically be moved to the position of the System caret each time it moves. + +##### Follow mouse cursor {#ReviewCursorFollowMouse} + +When enabled, the review cursor will follow the mouse as it moves. + +##### Simple Review mode {#ReviewCursorSimple} + +When enabled, NVDA will filter the hierarchy of objects that can be navigated to exclude objects that aren't of interest to the user; e.g. invisible objects and objects used only for layout purposes. + +To toggle simple review mode from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + +#### Object Presentation {#ObjectPresentationSettings} + + + +##### Open Object Presentation settings {#OpenObjectPresentationSettings} + +Key: `NVDA+control+o` + +The Object Presentation category in the NVDA Settings dialog is used to set how much information NVDA will present about controls such as description, position information and so on. +These options don't typically apply to browse mode. +These options typically apply to focus reporting and NVDA object navigation, but not reading text content e.g. browse mode. + +##### Report tooltips {#ObjectPresentationReportToolTips} + +A checkbox that when checked tells NVDA to report tooltips as they appear. +Many Windows and controls show a small message (or tooltip) when you move the mouse pointer over them, or sometimes when you move the focus to them. + +##### Report notifications {#ObjectPresentationReportNotifications} + +This checkbox, when checked, tells NVDA to report help balloons and toast notifications as they appear. + +* Help Balloons are like tooltips, but are usually larger in size, and are associated with system events such as a network cable being unplugged, or perhaps to alert you about Windows security issues. +* Toast notifications have been introduced in Windows 10 and appear in the notification centre in the system tray, informing about several events (i.e. if an update has been downloaded, a new e-mail arrived in your inbox, etc.). + +##### Report Object Shortcut Keys {#ObjectPresentationShortcutKeys} + +When this checkbox is checked, NVDA will include the shortcut key that is associated with a certain object or control when it is reported. +For example the File menu on a menu bar may have a shortcut key of alt+f. + +##### Report object position information {#ObjectPresentationPositionInfo} + +This option lets you choose whether you wish to have an object's position (e.g. 1 of 4) reported when moving to the object with the focus or object navigation. + +##### Guess Object Position Information when unavailable {#ObjectPresentationGuessPositionInfo} + +If reporting of object position information is turned on, this option allows NVDA to guess object position information when it is otherwise unavailable for a particular control. + +When on, NVDA will report position information for more controls such as menus and toolbars, however this information may be slightly inaccurate. + +##### Report Object descriptions {#ObjectPresentationReportDescriptions} + +Uncheck this checkbox if you don't wish to have the description reported along with objects (i.e. search suggestions, reporting of whole dialog window right after the dialog opens, etc.). + + + +##### Progress bar output {#ObjectPresentationProgressBarOutput} + +Key: NVDA+u + +This option controls how NVDA reports progress bar updates to you. + +It has the following options: + +* Off: Progress bars will not be reported as they change. +* Speak: This option tells NVDA to speak the progress bar in percentages. Each time the progress bar changes, NVDA will speak the new value. +* Beep: This tells NVDA to beep each time the progress bar changes. The higher the beep, the closer the progress bar is to completion. +* Beep and speak: This option tells NVDA to both beep and speak when a progress bar updates. + +##### Report background progress bars {#ObjectPresentationReportBackgroundProgressBars} + +This is an option that, when checked, tells NVDA to keep reporting a progress bar, even if it is not physically in the foreground. +If you minimize or switch away from a window that contains a progress bar, NVDA will keep track of it, allowing you to do other things while NVDA tracks the progress bar. + + + +##### Report dynamic content changes {#ObjectPresentationReportDynamicContent} + +Key: NVDA+5 + +Toggles the announcement of new content in particular objects such as terminals and the history control in chat programs. + +##### Play a sound when auto-suggestions appear {#ObjectPresentationSuggestionSounds} + +Toggles announcement of appearance of auto-suggestions, and if enabled, NVDA will play a sound to indicate this. +Auto-suggestions are lists of suggested entries based on text entered into certain edit fields and documents. +For example, when you enter text into the search box in Start menu in Windows Vista and later, Windows displays a list of suggestions based on what you typed. +For some edit fields such as search fields in various Windows 10 apps, NVDA can notify you that a list of suggestions has appeared when you type text. +The auto-suggestions list will close once you move away from the edit field, and for some fields, NVDA can notify you of this when this happens. + +#### Input Composition {#InputCompositionSettings} + +The Input Composition category allows you to control how NVDA reports the input of Asian characters, such as with IME or Text Service input methods. +Note that due to the fact that input methods vary greatly by available features and by how they convey information, it will most likely be necessary to configure these options differently for each input method to get the most efficient typing experience. + +##### Automatically report all available candidates {#InputCompositionReportAllCandidates} + +This option, which is on by default, allows you to choose whether or not all visible candidates should be reported automatically when a candidate list appears or its page is changed. +Having this option on for pictographic input methods such as Chinese New ChangJie or Boshiami is useful, as you can automatically hear all symbols and their numbers and you can choose one right away. +However, for phonetic input methods such as Chinese New Phonetic, it may be more useful to turn this option off, as all the symbols will sound the same and you will have to use the arrow keys to navigate the list items individually to gain more information from the character descriptions for each candidate. + +##### Announce Selected Candidate {#InputCompositionAnnounceSelectedCandidate} + +This option, which is on by default, allows you to choose whether NVDA should announce the selected candidate when a candidate list appears or when the selection is changed. +For input methods where the selection can be changed with the arrow keys (such as Chinese New Phonetic) this is necessary, but for some input methods it may be more efficient typing with this option turned off. +Note that even with this option off, the review cursor will still be placed on the selected candidate allowing you to use object navigation / review to manually read this or other candidates. + +##### Always include short character descriptions for candidates {#InputCompositionCandidateIncludesShortCharacterDescription} + +This option, which is on by default, allows you to choose whether or not NVDA should provide a short description for each character in a candidate, either when it's selected or when it's automatically read when the candidate list appears. +Note that for locales such as Chinese, the announcement of extra character descriptions for the selected candidate is not affected by this option. +This option may be useful for Korean and Japanese input methods. + +##### Report changes to the reading string {#InputCompositionReadingStringChanges} + +Some input methods such as Chinese New Phonetic and New ChangJie have a reading string (sometimes known as a precomposition string). +You can choose whether or not NVDA should announce new characters being typed into this reading string with this option. +This option is on by default. +Note some older input methods such as Chinese ChangJie may not use the reading string to hold precomposition characters, but instead use the composition string directly. Please see the next option for configuring reporting of the composition string. + +##### Report changes to the composition string {#InputCompositionCompositionStringChanges} + +After reading or precomposition data has been combined into a valid pictographic symbol, most input methods place this symbol into a composition string for temporary storage along with other combined symbols before they are finally inserted into the document. +This option allows you to choose whether or not NVDA should report new symbols as they appear in the composition string. +This option is on by default. + +#### Browse Mode {#BrowseModeSettings} + + + +##### Open Browse Mode settings {#OpenBrowseModeSettings} + +Key: `NVDA+control+b` + +The Browse Mode category in the NVDA Settings dialog is used to configure NVDA's behaviour when you read and navigate complex documents such as web pages. +This category contains the following options: + +##### Maximum Number of Characters on One Line {#BrowseModeSettingsMaxLength} + +This field sets the maximum length of a line in browse mode (in characters). + +##### Maximum Lines Per Page {#BrowseModeSettingsPageLines} + +This field sets the amount of lines you will move by when pressing page up or page down while in browse mode. + + + +##### Use screen layout {#BrowseModeSettingsScreenLayout} + +Key: NVDA+v + +This option allows you to specify whether browse mode should place clickable content (links, buttons and fields) on its own line, or if it should keep it in the flow of text as it is visually shown. +Note that this option doesn't apply to Microsoft Office apps such as Outlook and Word, which always use screen layout. +When screen layout is enabled, page elements will stay as they are visually shown. +For example, a visual line of multiple links will be presented in speech and braille as multiple links on the same line. +If it is disabled, then page elements will be placed on their own lines. +This may be easier to understand during line by line page navigation and make items easier to interact with for some users. + +##### Enable browse mode on page load {#BrowseModeSettingsEnableOnPageLoad} + +This checkbox toggles whether browse mode should be automatically enabled when loading a page. +When this option is disabled, browse mode can still be manually activated on pages or in documents where browse mode is supported. +See the [Browse Mode section](#BrowseMode) for a list of applications supported by browse mode. +Note that this option does not apply to situations where browse mode is always optional, e.g. in Microsoft Word. +This option is enabled by default. + +##### Automatic Say All on page load {#BrowseModeSettingsAutoSayAll} + +This checkbox toggles the automatic reading of a page after it loads in browse mode. +This option is enabled by default. + +##### Include layout tables {#BrowseModeSettingsIncludeLayoutTables} + +This option affects how NVDA handles tables used purely for layout purposes. +When on, NVDA will treat these as normal tables, reporting them based on [Document Formatting Settings](#DocumentFormattingSettings) and locating them with quick navigation commands. +When off, they will not be reported nor found with quick navigation. +However, the content of the tables will still be included as normal text. +This option is turned off by default. + +To toggle inclusion of layout tables from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + +##### Configuring reporting of fields such as links and headings {#BrowseModeLinksAndHeadings} + +Please see the options in the [Document Formatting category](#DocumentFormattingSettings) of the [NVDA Settings](#NVDASettings) dialog to configure the fields that are reported when navigating, such as links, headings and tables. + +##### Automatic focus mode for focus changes {#BrowseModeSettingsAutoPassThroughOnFocusChange} + +This option allows focus mode to be invoked if focus changes. +For example, when on a web page, if you press tab and you land on a form, if this option is checked, focus mode will automatically be invoked. + +##### Automatic focus mode for caret movement {#BrowseModeSettingsAutoPassThroughOnCaretMove} + +This option, when checked, allows NVDA to enter and leave focus mode when using arrow keys. +For example, if arrowing down a web page and you land on an edit box, NVDA will automatically bring you into focus mode. +If you arrow out of the edit box, NVDA will put you back in browse mode. + +##### Audio indication of Focus and Browse modes {#BrowseModeSettingsPassThroughAudioIndication} + +If this option is enabled, NVDA will play special sounds when it switches between browse mode and focus mode, rather than speaking the change. + +##### Trap non-command gestures from reaching the document {#BrowseModeSettingsTrapNonCommandGestures} + +Enabled by default, this option allows you to choose if gestures (such as key presses) that do not result in an NVDA command and are not considered to be a command key in general, should be trapped from going through to the document you are currently focused on. +As an example, if enabled and the letter j was pressed, it would be trapped from reaching the document, even though it is not a quick navigation command nor is it likely to be a command in the application itself. +In this case NVDA will tell Windows to play a default sound whenever a key which gets trapped is pressed. + + + +##### Automatically set system focus to focusable elements {#BrowseModeSettingsAutoFocusFocusableElements} + +Key: NVDA+8 + +Disabled by default, this option allows you to choose if the system focus should automatically be set to elements that can take the system focus (links, form fields, etc.) when navigating content with the browse mode caret. +Leaving this option disabled will not automatically focus focusable elements when they are selected with the browse mode caret. +This might result in faster browsing experience and better responsiveness in browse mode. +The focus will yet be updated to the particular element when interacting with it (e.g. pressing a button, checking a check box). +Enabling this option may improve support for some websites at the cost of performance and stability. + +#### Document Formatting {#DocumentFormattingSettings} + + + +##### Open Document Formatting settings {#OpenDocumentFormattingSettings} + +Key: `NVDA+control+d` + +Most of the options in this category are for configuring what type of formatting you wish to have reported as you move the cursor around documents. +For example, if you check the report font name checkbox, each time you arrow onto text with a different font, the name of the font will be announced. + +The document formatting options are organized into groups. +You can configure reporting of: + +* Font + * Font name + * Font size + * Font attributes + * Superscripts and subscripts + * Emphasis + * Highlighted (Marked) text + * Style + * Colours +* Document information + * Comments + * Bookmarks + * Editor revisions + * Spelling errors +* Pages and spacing + * Page numbers + * Line numbers + * Line indentation reporting [(Off, Speech, Tones, Both Speech and Tones)](#DocumentFormattingSettingsLineIndentation) + * Ignore blank lines for line indentation reporting + * Paragraph indentation (e.g. hanging indent, first line indent) + * Line spacing (single, double, etc.) + * Alignment +* Table information + * Tables + * Row/column headers (Off, Rows, Columns, Rows and columns) + * Cell coordinates + * Cell borders (Off, Styles, Both Colours and Styles) +* Elements + * Headings + * Links + * Graphics + * Lists + * Block quotes + * Groupings + * Landmarks + * Articles + * Frames + * Figures and captions + * Clickable + +To toggle these settings from anywhere, please assign custom gestures using the [Input Gestures dialog](#InputGestures). + +##### Report formatting changes after the cursor {#DocumentFormattingDetectFormatAfterCursor} + +If enabled, this setting tells NVDA to try and detect all the formatting changes on a line as it reports it, even if doing this may slow down NVDA's performance. + +By default, NVDA will detect the formatting at the position of the System caret / Review Cursor, and in some instances may detect formatting on the rest of the line, only if it is not going to cause a performance decrease. + +Enable this option while proof reading documents in applications such as WordPad, where formatting is important. + +##### Line indentation reporting {#DocumentFormattingSettingsLineIndentation} + +This option allows you to configure how indentation at the beginning of lines is reported. +The Report line indentation with combo box has four options. + +* Off: NVDA will not treat indentation specially. +* Speech: If speech is selected, when the amount of indentation changes, NVDA will say something like "twelve space" or "four tab." +* Tones: If Tones is selected, when the amount of indentation changes, tones indicate the amount of change in indent. +The tone will increase in pitch every space, and for a tab, it will increase in pitch the equivalent of 4 spaces. +* Both Speech and Tones: This option reads indentation using both of the above methods. + +If you tick the "Ignore blank lines for line indentation reporting" checkbox, then indentation changes won't be reported for blank lines. +This may be useful when reading a document where blank lines are used to separate indented bloks of text, such as in programming source code. + +#### Document Navigation {#DocumentNavigation} + +This category allows you to adjust various aspects of document navigation. + +##### Paragraph Style {#ParagraphStyle} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Default (Handled by application), Handled by application, Single line break, Multi line break| +|Default |Handled by application| + +This combo box allows you to select the paragraph style to be used when navigating by paragraphs with `control+upArrow` and `control+downArrow`. +The available paragraph styles are: + +* Handled by application: NVDA will let the application determine the previous or next paragraph, and NVDA will read the new paragraph when navigating. +This style works best when the application supports paragraph navigation natively, and is the default. +* Single line break: NVDA will attempt to determine the previous or next paragraph using a single line break as the paragraph indicator. +This style works best when reading documents in an application which does not natively support paragraph navigation, and paragraphs in the document are marked by a single press of the `enter` key. +* Multi line break: NVDA will attempt to determine the previous or next paragraph using at least one blank line (two presses of the `enter` key) as the paragraph indicator. +This style works best when working with documents which use block paragraphs. +Note that this paragraph style cannot be used in Microsoft Word or Microsoft Outlook, unless you are using UIA to access Microsoft Word controls. + +You may toggle through the available paragraph styles from anywhere by assigning a key in the [Input Gestures dialog](#InputGestures). + +#### Windows OCR Settings {#Win10OcrSettings} + +The settings in this category allow you to configure [Windows OCR](#Win10Ocr). +This category contains the following options: + +##### Recognition language {#Win10OcrSettingsRecognitionLanguage} + +This combo box allows you to choose the language to be used for text recognition. +To cycle through available languages from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + +##### Periodically refresh recognized content {#Win10OcrSettingsAutoRefresh} + +When this checkbox is enabled, NVDA will automatically refresh the recognized content when a recognition result has focus. +This can be very useful when you want to monitor constantly changing content, such as when watching a video with subtitles. +The refresh takes place every one and a half seconds. +This option is disabled by default. + +#### Advanced Settings {#AdvancedSettings} + +Warning! The settings in this category are for advanced users and may cause NVDA to not function correctly if configured in the wrong way. +Only make changes to these settings if you are sure you know what you are doing or if you have been specifically instructed to by an NVDA developer. + +##### Making changes to advanced settings {#AdvancedSettingsMakingChanges} + +In order to make changes to the advanced settings, the controls must be enabled by confirming, with the checkbox, that you understand the risks of modifying these settings + +##### Restoring the default settings {#AdvancedSettingsRestoringDefaults} + +The button restores the default values for the settings, even if the confirmation checkbox is not ticked. +After changing settings you may wish to revert to the default values. +This may also be the case if you are unsure if the settings have been changed. + +##### Enable loading custom code from Developer Scratchpad Directory {#AdvancedSettingsEnableScratchpad} + +When developing add-ons for NVDA, it is useful to be able to test code as you are writing it. +This option when enabled, allows NVDA to load custom appModules, globalPlugins, brailleDisplayDrivers, synthDrivers and vision enhancement providers, from a special developer scratchpad directory in your NVDA user configuration directory. +As their equivalents in add-ons, these modules are loaded when starting NVDA or, in the case of appModules and globalPlugins, when [reloading plugins](#ReloadPlugins). +This option is off by default, ensuring that no untested code is ever run in NVDA with out the user's explicit knowledge. +If you wish to distribute custom code to others, you should package it as an NVDA add-on. + +##### Open Developer Scratchpad Directory {#AdvancedSettingsOpenScratchpadDir} + +This button opens the directory where you can place custom code while developing it. +This button is only enabled if NVDA is configured to enable loading custom code from the Developer Scratchpad Directory. + +##### Registration for UI Automation events and property changes {#AdvancedSettingsSelectiveUIAEventRegistration} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Automatic, Selective, Global| +|Default |Automatic| + +This option changes how NVDA registers for events fired by the Microsoft UI Automation accessibility API. +The registration for UI Automation events and property changes combo box has three options: + +* Automatic: "selective" on Windows 11 Sun Valley 2 (version 22H2) and later, "global" otherwise. +* Selective: NVDA will limit event registration to the system focus for most events. +If you suffer from performance issues in one or more applications, We recommend you to try this functionality to see whether performance improves. +However, on older versions of Windows, NVDA may have trouble tracking focus in some controls (such as the task manager and emoji panel). +* Global: NVDA registers for many UIA events that are processed and discarded within NVDA itself. +While focus tracking is more reliable in more situations, performance is significantly degraded, especially in applications like Microsoft Visual Studio. + +##### Use UI automation to access Microsoft Word document controls {#MSWordUIA} + +Configures whether or not NVDA should use the UI Automation accessibility API to access Microsoft Word documents, rather than the older Microsoft Word object model. +This applies to documents in Microsoft word itself, plus messages in Microsoft Outlook. +This setting contains the following values: + +* Default (where suitable) +* Only where necessary: where the Microsoft Word object model is not available at all +* Where suitable: Microsoft Word version 16.0.15000 or higher, or where the Microsoft Word object model is unavailable +* Always: where ever UI automation is available in Microsoft word (no matter how complete). + +##### Use UI automation to access Microsoft Excel spreadsheet controls when available {#UseUiaForExcel} + +When this option is enabled, NVDA will try to use the Microsoft UI Automation accessibility API in order to fetch information from Microsoft Excel Spreadsheet controls. +This is an experimental feature, and some features of Microsoft Excel may not be available in this mode. +For instance, NVDA's Elements List for listing formulas and comments, and Browse mode quick navigation to jump to form fields on a spreadsheet features are not available. +However, for basic spreadsheet navigating / editing, this option may provide a vast performance improvement. +We still do not recommend that the majority of users turn this on by default, though we do welcome users of Microsoft Excel build 16.0.13522.10000 or higher to test this feature and provide feedback. +Microsoft Excel's UI automation implementation is ever changing, and versions of Microsoft Office older than 16.0.13522.10000 may not expose enough information for this option to be of any use. + +##### Use enhanced event processing {#UIAEnhancedEventProcessing} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Default (Enabled), Disabled, Enabled| +|Default |Enabled| + +When this option is enabled, NVDA should remain responsive when being flooded with many UI Automation events, e.g. large amounts of text in a terminal. +After changing this option, you will need to restart NVDA for the change to take effect. + +##### Windows Console support {#AdvancedSettingsConsoleUIA} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Automatic, UIA when available, Legacy| +|Default |Automatic| + +This option selects how NVDA interacts with the Windows Console used by command prompt, PowerShell, and the Windows Subsystem for Linux. +It does not affect the modern Windows Terminal. +In Windows 10 version 1709, Microsoft [added support for its UI Automation API to the console](https://devblogs.microsoft.com/commandline/whats-new-in-windows-console-in-windows-10-fall-creators-update/), bringing vastly improved performance and stability for screen readers that support it. +In situations where UI Automation is unavailable or known to result in an inferior user experience, NVDA's legacy console support is available as a fallback. +The Windows Console support combo box has three options: + +* Automatic: Uses UI Automation in the version of Windows Console included with Windows 11 version 22H2 and later. +This option is recommended and set by default. +* UIA when available: Uses UI Automation in consoles if available, even for versions with incomplete or buggy implementations. +While this limited functionality may be useful (and even sufficient for your usage), use of this option is entirely at your own risk and no support for it will be provided. +* Legacy: UI Automation in the Windows Console will be completely disabled. +The legacy fallback will always be used even in situations where UI Automation would provide a superior user experience. +Therefore, selecting this option is not recommended unless you know what you are doing. + +##### Use UIA with Microsoft Edge and other Chromium based browsers when available {#ChromiumUIA} + +Allows specifying when UIA will be used when it is available in Chromium based browsers such as Microsoft Edge. +UIA support for Chromium based browsers is early in development and may not provide the same level of access as IA2. +The combo box has the following options: + +* Default (Only when necessary): The NVDA default, currently this is "Only when necessary". This default may change in the future as the technology matures. +* Only when necessary: When NVDA is unable to inject into the browser process in order to use IA2 and UIA is available, then NVDA will fall back to using UIA. +* Yes: If the browser makes UIA available, NVDA will use it. +* No: Don't use UIA, even if NVDA is unable to inject in process. This may be useful for developers debugging issues with IA2 and want to ensure that NVDA does not fall back to UIA. + +##### Annotations {#Annotations} + +This group of options is used to enable features which add experimental support for ARIA annotations. +Some of these features may be incomplete. + + +To "Report summary of any annotation details at the system caret", press NVDA+d. + + +The following options exist: + +* "Report 'has details' for structured annotations": enables reporting if the text or control has further details. +* "Report aria-description always": + When the source of `accDescription` is aria-description, the description is reported. + This is useful for annotations on the web. + Note: + * There are many sources for `accDescription` several have mixed or unreliable semantics. + Historically AT has not been able to differentiate sources of `accDescription` typically it wasn't spoken due to the mixed semantics. + * This option is in very early development, it relies on browser features not yet widely available. + * Expected to work with Chromium 92.0.4479.0+ + +##### Report live regions {#BrailleLiveRegions} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Default (Enabled), Disabled, Enabled| +|Default |Enabled| + +This option selects whether NVDA reports changes in some dynamic web content in Braille. +Disabling this option is equivalent to NVDA's behaviour in versions 2023.1 and earlier, which only reported these content changes in speech. + +##### Speak passwords in all enhanced terminals {#AdvancedSettingsWinConsoleSpeakPasswords} + +This setting controls whether characters are spoken by [speak typed characters](#KeyboardSettingsSpeakTypedCharacters) or [speak typed words](#KeyboardSettingsSpeakTypedWords) in situations where the screen does not update (such as password entry) in some terminal programs, such as the Windows Console with UI automation support enabled and Mintty. +For security purposes, this setting should be left disabled. +However, you may wish to enable it if you experience performance issues or instability with typed character and/or word reporting in consoles, or work in trusted environments and prefer password announcement. + +##### Use enhanced typed character support in legacy Windows Console when available {#AdvancedSettingsKeyboardSupportInLegacy} + +This option enables an alternative method for detecting typed characters in legacy Windows consoles. +While it improves performance and prevents some console output from being spelled out, it may be incompatible with some terminal programs. +This feature is available and enabled by default on Windows 10 versions 1607 and later when UI Automation is unavailable or disabled. +Warning: with this option enabled, typed characters that do not appear onscreen, such as passwords, will not be suppressed. +In untrusted environments, you may temporarily disable [speak typed characters](#KeyboardSettingsSpeakTypedCharacters) and [speak typed words](#KeyboardSettingsSpeakTypedWords) when entering passwords. + +##### Diff algorithm {#DiffAlgo} + +This setting controls how NVDA determines the new text to speak in terminals. +The diff algorithm combo box has three options: + +* Automatic: This option causes NVDA to prefer Diff Match Patch in most situations, but fall back to Difflib in problematic applications, such as older versions of the Windows Console and Mintty. +* Diff Match Patch: This option causes NVDA to calculate changes to terminal text by character, even in situations where it is not recommended. +It may improve performance when large volumes of text are written to the console and allow more accurate reporting of changes made in the middle of lines. +However, in some applications, reading of new text may be choppy or inconsistent. +* Difflib: this option causes NVDA to calculate changes to terminal text by line, even in situations where it is not recommended. +It is identical to NVDA's behaviour in versions 2020.4 and earlier. +This setting may stabilize reading of incoming text in some applications. +However, in terminals, when inserting or deleting a character in the middle of a line, the text after the caret will be read out. + +##### Speak new text in Windows Terminal via {#WtStrategy} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Default (Diffing), Diffing, UIA notifications| +|Default |Diffing| + +This option selects how NVDA determines what text is "new" (and thus what to speak when "report dynamic content changes" is enabled) in Windows Terminal and the WPF Windows Terminal control used in Visual Studio 2022. +It does not affect the Windows Console (`conhost.exe`). +The Speak new text in Windows Terminal combo box has three options: + +* Default: This option is currently equivalent to "diffing", but it is anticipated to change once support for UIA notifications is further developed. +* Diffing: This option uses the selected diff algorithm to calculate changes each time the terminal renders new text. +This is identical to NVDA's behaviour in versions 2022.4 and earlier. +* UIA notifications: This option defers the responsibility of determining what text to speak to Windows Terminal itself, meanning that NVDA no longer has to determine what text currently on-screen is "new". +This should markedly improve performance and stability of Windows Terminal, but this feature is not yet complete. +In particular, typed characters that are not displayed on-screen, such as passwords, are reported when this option is selected. +Additionally, contiguous spans of output of over 1,000 characters may not be reported accurately. + +##### Attempt to cancel speech for expired focus events {#CancelExpiredFocusSpeech} + +This option enables behaviour which attempts to cancel speech for expired focus events. +In particular moving quickly through messages in Gmail with Chrome can cause NVDA to speak outdated information. +This functionality is enabled by default as of NVDA 2021.1. + +##### Caret move timeout (in MS) {#AdvancedSettingsCaretMoveTimeout} + +This option allows you to configure the number of milliseconds NVDA will wait for the caret (insertion point) to move in editable text controls. +If you find that NVDA seems to be incorrectly tracking the caret E.g. it seems to be always one character behind or is repeating lines, then you may wish to try increasing this value. + +##### Report transparency for colors {#ReportTransparentColors} + +This option enables reporting when colors are transparent, useful for addon/appModule developers gathering information to improve user experience with a 3rd party application. +Some GDI applications will highlight text with a background color, NVDA (via display model) attempts to report this color. +In some situations, the text background may be entirely transparent, with the text layered on some other GUI element. +With several historically popular GUI APIs, the text may be rendered with a transparent background, but visually the background color is accurate. + +##### Use WASAPI for audio output {#WASAPI} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Default (Enabled), Disabled, Enabled| +|Default |Enabled| + +This option enables audio output via the Windows Audio Session API (WASAPI). +WASAPI is a more modern audio framework which may improve the responsiveness, performance and stability of NVDA audio output, including both speech and sounds. +After changing this option, you will need to restart NVDA for the change to take effect. +Disabling WASAPI will disable the following options: + +* [Volume of NVDA sounds follows voice volume](#SoundVolumeFollowsVoice) +* [Volume of NVDA sounds](#SoundVolume) + +##### Debug logging categories {#AdvancedSettingsDebugLoggingCategories} + +The checkboxes in this list allow you to enable specific categories of debug messages in NVDA's log. +Logging these messages can result in decreased performance and large log files. +Only turn one of these on if specifically instructed to by an NVDA developer e.g. when debugging why a braille display driver is not functioning correctly. + +##### Play a sound for logged errors {#PlayErrorSound} + +This option allows you to specify if NVDA will play an error sound in case an error is logged. +Choosing Only in test versions (default) makes NVDA play error sounds only if the current NVDA version is a test version (alpha, beta or run from source). +Choosing Yes allows to enable error sounds whatever your current NVDA version is. + +##### Regular expression for text paragraph quick navigation commands {#TextParagraphRegexEdit} + +This field allows users to customize regular expression for detecting text paragraphs in browse mode. +The [text paragraph navigation command](#TextNavigationCommand) searches for paragraphs matched by this regular expression. + +### miscellaneous Settings {#MiscSettings} + +Besides the [NVDA Settings](#NVDASettings) dialog, The Preferences sub-menu of the NVDA Menu contains several other items which are outlined below. + +#### Speech dictionaries {#SpeechDictionaries} + +The speech dictionaries menu (found in the Preferences menu) contains dialogs that allow you to manage the way NVDA pronounces particular words or phrases. +There are currently three different types of speech dictionaries. +They are: + +* Default: rules in this dictionary affect all speech in NVDA. +* Voice: rules in this dictionary affect speech for the synthesizer voice currently being used. +* Temporary: rules in this dictionary affect all speech in NVDA, but only for the current session. These rules are temporary and will be lost if NVDA is restarted. + +You need to assign custom gestures using the [Input Gestures dialog](#InputGestures) if you wish to open any of these dictionary dialogs from anywhere. + +All dictionary dialogs contain a list of rules which will be used for processing the speech. +The dialog also contains Add, Edit, Remove and Remove all buttons. + +To add a new rule to the dictionary, press the Add button, and fill in the fields in the dialog box that appears and then press Ok. +You will then see your new rule in the list of rules. +However, to make sure your rule is actually saved, make sure to press Ok to exit the dictionary dialog completely once you have finished adding/editing rules. + +The rules for NVDA's speech dictionaries allow you to change one string of characters into another. +For example, you could create a rule which causes NVDA to say the word "frog" instead of "bird" whenever the word "bird" is encountered. +In the Add rule dialog, the easiest way to do this is to type the word bird in the Pattern field, and the word frog in the Replacement field. +You may also want to type a description of the rule in the Comment field (something like: changes bird to frog). + +NVDA's speech dictionaries however are much more powerful than simple word replacement. +The Add rule dialog also contains a checkbox to say whether or not you want the rule to be case sensitive (meaning that NVDA should care whether the characters are uppercase or lowercase. +NVDA ignores case by default). + +Finally, a set of radio buttons allows you to tell NVDA whether your pattern should match anywhere, should only match if it is a complete word or should be treated as a "Regular expression". +Setting the pattern to match as a whole word means that the replacement will only be made if the pattern does not occur as part of a larger word. +This condition is met if the characters immediately before and after the word are anything other than a letter, a number, or an underscore, or if there are no characters at all. +Thus, using the earlier example of replacing the word "bird" with "frog", if you were to make this a whole word replacement, it would not match "birds" or "bluebird". + +A regular expression is a pattern containing special symbols that allow you to match on more than one character at a time, or match on just numbers, or just letters, as a few examples. +Regular expressions are not covered in this user guide. +For an introductory tutorial, please refer to [Python's Regular Expression Guide](https://docs.python.org/3.11/howto/regex.html). + +#### Punctuation/symbol pronunciation {#SymbolPronunciation} + +This dialog allows you to change the way punctuation and other symbols are pronounced, as well as the symbol level at which they are spoken. + +The language for which symbol pronunciation is being edited will be shown in the dialog's title. +Note that this dialog respects the "Trust voice's language for processing symbols and characters" option found in the [Speech category](#SpeechSettings) of the [NVDA Settings](#NVDASettings) dialog; i.e. it uses the voice language rather than the NVDA global language setting when this option is enabled. + +To change a symbol, first select it in the Symbols list. +You can filter the symbols by entering the symbol or a part of the symbol's replacement into the Filter by edit box. + +* The Replacement field allows you to change the text that should be spoken in place of this symbol. +* Using the Level field, you can adjust the lowest symbol level at which this symbol should be spoken (none, some, most or all). +You can also set the level to character; in this case the symbol will not be spoken regardless of the symbol level in use, with the following two exceptions: + * When navigating character by character. + * When NVDA is spelling any text containing that symbol. +* The Send actual symbol to synthesizer field specifies when the symbol itself (in contrast to its replacement) should be sent to the synthesizer. +This is useful if the symbol causes the synthesizer to pause or change the inflection of the voice. +For example, a comma causes the synthesizer to pause. +There are three options: + * never: Never send the actual symbol to the synthesizer. + * always: Always send the actual symbol to the synthesizer. + * only below symbols' level: Send the actual symbol only if the configured speech symbol level is lower than the level set for this symbol. + For example, you might use this so that a symbol will have its replacement spoken at higher levels without pausing, while still being indicated with a pause at lower levels. + +You can add new symbols by pressing the Add button. +In the dialog that appears, enter the symbol and press the OK button. +Then, change the fields for the new symbol as you would for other symbols. + +You can remove a symbol you previously added by pressing the Remove button. + +When you are finished, press the OK button to save your changes or the Cancel button to discard them. + +In the case of complex symbols, the Replacement field may have to include some group references of the matched text. For instance, for a pattern matching a whole date, \1, \2, and \3 would need to appear in the field, to be replaced by the corresponding parts of the date. +Normal backslashes in the Replacement field should thus be doubled, e.g. "a\\b" should be typed in order to get the "a\b" replacement. + +#### Input Gestures {#InputGestures} + +In this dialog, you can customize the input gestures (keys on the keyboard, buttons on a braille display, etc.) for NVDA commands. + +Only commands that are applicable immediately before the dialog is opened are shown. +For example, if you want to customize commands related to browse mode, you should open the Input Gestures dialog while you are in browse mode. + +The tree in this dialog lists all of the applicable NVDA commands grouped by category. +You can filter them by entering one or more words from the command's name into the Filter by edit box in any order. +Any gestures associated with a command are listed beneath the command. + +To add an input gesture to a command, select the command and press the Add button. +Then, perform the input gesture you wish to associate; e.g. press a key on the keyboard or a button on a braille display. +Often, a gesture can be interpreted in more than one way. +For example, if you pressed a key on the keyboard, you may wish it to be specific to the current keyboard layout (e.g. desktop or laptop) or you may wish it to apply for all layouts. +In this case, a menu will appear allowing you to select the desired option. + +To remove a gesture from a command, select the gesture and press the Remove button. + +The Emulated system keyboard keys category contains NVDA commands that emulate keys on the system keyboard. +These emulated system keyboard keys can be used to control a system keyboard right from your braille display. +To add an emulated input gesture, select the Emulated system keyboard keys category and press the Add button. +Then, press the key on the keyboard you wish to emulate. +After that, the key will be available from the Emulated system keyboard keys category and you will be able to assign an input gesture to it as described above. + +Note: + +* Emulated keys must have gestures assigned in order to persist when saving / closing the dialog. +* An input gesture with modifier keys may not be able to be mapped to an emulated gesture without modifier keys. +For instance, setting the emulated input `a` and configuring an input gesture of `ctrl+m`, may result in the application receiving `ctrl+a`. + +When you are finished making changes, press the OK button to save them or the Cancel button to discard them. + +### Saving and Reloading the configuration {#SavingAndReloading} + +By default NVDA will automatically save your settings on exit. +Note, however, that this option can be changed under the general options in the preferences menu. +To save the settings manually at any time, choose the Save configuration item in the NVDA menu. + +If you ever make a mistake with your settings and need to revert back to the saved settings, choose the "revert to saved configuration" item in the NVDA menu. +You can also reset your settings to their original factory defaults by choosing Reset Configuration To Factory Defaults, which is also found in the NVDA menu. + +The following NVDA key commands are also useful: + + +| Name |Desktop key |Laptop key |Description| +|---|---|---|---| +|Save configuration |NVDA+control+c |NVDA+control+c |Saves your current configuration so that it is not lost when you exit NVDA| +|Revert configuration |NVDA+control+r |NVDA+control+r |Pressing once resets your configuration to when you last saved it. Pressing three times will reset it back to factory defaults.| + + + +### Configuration Profiles {#ConfigurationProfiles} + +Sometimes, you may wish to have different settings for different situations. +For example, you may wish to have reporting of indentation enabled while you are editing or reporting of font attributes enabled while you are proofreading. +NVDA allows you to do this using configuration profiles. + +A configuration profile contains only those settings which are changed while the profile is being edited. +Most settings can be changed in configuration profiles except for those in the General category of the [NVDA Settings](#NVDASettings) dialog, which apply to the entirety of NVDA. + +Configuration profiles can be manually activated either from a dialog or using custom added gestures. +They can also be activated automatically due to triggers such as switching to a particular application. + +#### Basic Management {#ProfilesBasicManagement} + +You manage configuration profiles by selecting "Configuration profiles" in the NVDA menu. +You can also do this using a key command: + + +* NVDA+control+p: Show the Configuration Profiles dialog. + + + +The first control in this dialog is the profile list from which you can select one of the available profiles. +When you open the dialog, the profile you are currently editing is selected. +Additional information is also shown for active profiles, indicating whether they are manually activated, triggered and/or being edited. + +To rename or delete a profile, press the Rename or Delete buttons, respectively. + +Press the Close button to close the dialog. + +#### Creating a Profile {#ProfilesCreating} + +To create a profile, press the New button. + +In the New Profile dialog, you can enter a name for the profile. +You can also select how this profile should be used. +If you only want to use this profile manually, select Manual activation, which is the default. +Otherwise, select a trigger which should automatically activate this profile. +For convenience, if you haven't entered a name for the profile, selecting a trigger will fill in the name accordingly. +See [below](#ConfigProfileTriggers) for more information about triggers. + +Pressing OK will create the profile and close the Configuration Profiles dialog so you can edit it. + +#### Manual Activation {#ConfigProfileManual} + +You can manually activate a profile by selecting a profile and pressing the Manual activate button. +Once activated, other profiles can still be activated due to triggers, but any settings in the manually activated profile will override them. +For example, if a profile is triggered for the current application and reporting of links is enabled in that profile but disabled it in the manually activated profile, links will not be reported. +However, if you have changed the voice in the triggered profile but have never changed it in the manually activated profile, the voice from the triggered profile will be used. +Any settings you change will be saved in the manually activated profile. +To deactivate a manually activated profile, select it in the Configuration Profiles dialog and press the Manual deactivate button. + +#### Triggers {#ConfigProfileTriggers} + +Pressing the Triggers button in the Configuration Profiles dialog allows you to change the profiles which should be automatically activated for various triggers. + +The Triggers list shows the available triggers, which are as follows: + +* Current application: Triggered when you switch to the current application. +* Say all: Triggered while reading with the say all command. + +To change the profile which should be automatically activated for a trigger, select the trigger and then select the desired profile from the Profile list. +You can select "(normal configuration)" if you don't want a profile to be used. + +Press the Close button to return to the Configuration Profiles dialog. + +#### Editing a Profile {#ConfigProfileEditing} + +If you have manually activated a profile, any settings you change will be saved to that profile. +Otherwise, any settings you change will be saved to the most recently triggered profile. +For example, if you have associated a profile with the Notepad application and you switch to Notepad, any changed settings will be saved to that profile. +Finally, if there is neither a manually activated nor a triggered profile, any settings you change will be saved to your normal configuration. + +To edit the profile associated with say all, you must [manually activate](#ConfigProfileManual) that profile. + +#### Temporarily Disabling Triggers {#ConfigProfileDisablingTriggers} + +Sometimes, it is useful to temporarily disable all triggers. +For example, you might wish to edit a manually activated profile or your normal configuration without triggered profiles interfering. +You can do this by checking the Temporarily disable all triggers checkbox in the Configuration Profiles dialog. + +To toggle disabling triggers from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + +#### Activating a profile using input gestures {#ConfigProfileGestures} + +For every profile you add, you are able to assign one or more input gestures to activate it. +By default, configuration profiles do not have input gestures assigned. +You can add gestures to activate a profile using the [Input Gestures dialog](#InputGestures). +Every profile has its own entry under the configuration profiles category. +When you rename a profile, any gesture you added previously will still be available. +Removing a profile will automatically delete the gestures associated with it. + +### Location of Configuration files {#LocationOfConfigurationFiles} + +Portable versions of NVDA store all settings and add-ons in a directory called userConfig, found in the NVDA directory. + +Installed versions of NVDA store all settings and add-ons in a special NVDA directory located in your Windows user profile. +This means that each user on the system can have their own NVDA settings. +To open your settings directory from anywhere you can use [Input Gestures dialog](#InputGestures) to add a custom gesture. +In addition for an installed version of NVDA, on the start menu you can go to programs -> NVDA -> explore user configuration directory. + +Settings for NVDA when running during sign-in or on UAC screens are stored in the systemConfig directory in NVDA's installation directory. +Usually, this configuration should not be touched. +To change NVDA's configuration during sign-in or on UAC screens, configure NVDA as you wish while signed into Windows, save the configuration, and then press the "use currently saved settings during sign-in and on secure screens" button in the General category of the [NVDA Settings](#NVDASettings) dialog. + +## Add-ons and the Add-on Store {#AddonsManager} + +Add-ons are software packages which provide new or altered functionality for NVDA. +They are developed by the NVDA community, and external organisations such as commercial vendors. +Add-ons may do any of the following: + +* Add or enhance support for certain applications. +* Provide support for extra Braille displays or speech synthesizers. +* Add or change features in NVDA. + +NVDA's Add-on Store allows you to browse and manage add-on packages. +All add-ons that are available in the Add-on Store can be downloaded for free. +However, some of them may require users to pay for a license or additional software before they can be used. +Commercial speech synthesizers are an example of this type of add-on. +If you install an add-on with paid components and change your mind about using it, the add-on can be easily removed. + +The Add-on Store is accessed from the Tools submenu of the NVDA menu. +To access the Add-on Store from anywhere, assign a custom gesture using the [Input Gestures dialog](#InputGestures). + +### Browsing add-ons {#AddonStoreBrowsing} + +When opened, the Add-on Store displays a list of add-ons. +If you have not installed an add-on before, the Add-on Store will open to a list of add-ons available to install. +If you have installed add-ons, the list will display currently installed add-ons. + +Selecting an add-on, by moving to it with the up and down arrow keys, will display the details for the add-on. +Add-ons have associated actions that you can access through an [actions menu](#AddonStoreActions), such as install, help, disable, and remove. +Available actions will change based on whether the add-on is installed or not, and whether it is enabled or disabled. + +#### Add-on list views {#AddonStoreFilterStatus} + +There are different views for installed, updatable, available and incompatible add-ons. +To change the view of add-ons, change the active tab of the add-ons list using `ctrl+tab`. +You can also `tab` to the list of views, and move through them with the `leftArrow` and `rightArrow` keys. + +#### Filtering for enabled or disabled add-ons {#AddonStoreFilterEnabled} + +Normally, an installed add-on is "enabled", meaning that it is running and available within NVDA. +However, some of your installed add-ons may be set to the "disabled" state. +This means that they will not be used, and their functions won't be available during your current NVDA session. +You may have disabled an add-on because it conflicted with another add-on, or with a certain application. +NVDA may also disable certain add-ons, if they are found to be incompatible during an NVDA upgrade; though you will be warned if this is going to happen. +Add-ons can also be disabled if you simply don't need them for a prolonged period, but don't want to uninstall them because you expect to want them again in the future. + +The lists of installed and incompatible add-ons can be filtered by their enabled or disabled state. +The default shows both enabled and disabled add-ons. + +#### Include incompatible add-ons {#AddonStoreFilterIncompatible} + +Available and updatable add-ons can be filtered to include [incompatible add-ons](#incompatibleAddonsManager) that are available to install. + +#### Filter add-ons by channel {#AddonStoreFilterChannel} + +Add-ons can be distributed through up to four channels: + +* Stable: The developer has released this as a tested add-on with a released version of NVDA. +* Beta: This add-on may need further testing, but is released for user feedback. +Suggested for early adopters. +* Dev: This channel is suggested to be used by add-on developers to test unreleased API changes. +NVDA alpha testers may need to use a "Dev" version of their add-ons. +* External: Add-ons installed from external sources, outside of the Add-on Store. + +To list add-ons only for specific channels, change the "Channel" filter selection. + +#### Searching for add-ons {#AddonStoreFilterSearch} + +To search add-ons, use the "Search" text box. +You can reach it by pressing `shift+tab` from the list of add-ons. +Type a keyword or two for the kind of add-on you're looking for, then `tab` to the list of add-ons. +Add-ons will be listed if the search text can be found in the add-on ID, display name, publisher, author or description. + +### Add-on actions {#AddonStoreActions} + +Add-ons have associated actions, such as install, help, disable, and remove. +For an add-on in the add-on list, these actions can be accessed through a menu opened by pressing the `applications` key, `enter`, right clicking or double clicking the add-on. +This menu can also be accessed through an Actions button in the selected add-on's details. + +#### Installing add-ons {#AddonStoreInstalling} + +Just because an add-on is available in the NVDA Add-on Store, does not mean that it has been approved or vetted by NV Access or anyone else. +It is very important to only install add-ons from sources you trust. +The functionality of add-ons is unrestricted inside NVDA. +This could include accessing your personal data or even the entire system. + +You can install and update add-ons by [browsing Available add-ons](#AddonStoreBrowsing). +Select an add-on from the "Available add-ons" or "Updatable add-ons" tab. +Then use the update, install, or replace action to start the installation. + +You can also install multiple add-ons at once. +This can be done by selecting multiple add-ons in the available add-ons tab, then activating the context menu on the selection and choosing the "Install selected add-ons" action. + +To install an add-on you have obtained outside of the Add-on Store, press the "Install from external source" button. +This will allow you to browse for an add-on package (`.nvda-addon` file) somewhere on your computer or on a network. +Once you open the add-on package, the installation process will begin. + +If NVDA is installed and running on your system, you can also open an add-on file directly from the browser or file system to begin the installation process. + +When an add-on is being installed from an external source, NVDA will ask you to confirm the installation. +Once the add-on is installed, NVDA must be restarted for the add-on to start running, although you may postpone restarting NVDA if you have other add-ons to install or update. + +#### Removing Add-ons {#AddonStoreRemoving} + +To remove an add-on, select the add-on from the list and use the Remove action. +NVDA will ask you to confirm removal. +As with installing, NVDA must be restarted for the add-on to be fully removed. +Until you do, a status of "Pending removal" will be shown for that add-on in the list. +As with installing, you can also remove multiple add-ons at once. + +#### Disabling and Enabling Add-ons {#AddonStoreDisablingEnabling} + +To disable an add-on, use the "disable" action. +To enable a previously disabled add-on, use the "enable" action. +You can disable an add-on if the add-on status indicates it is "enabled", or enable it if the add-on is "disabled". +For each use of the enable/disable action, add-on status changes to indicate what will happen when NVDA restarts. +If the add-on was previously "disabled", the status will show "enabled after restart". +If the add-on was previously "enabled", the status will show "disabled after restart". +Just like when you install or remove add-ons, you need to restart NVDA in order for changes to take effect. +You can also enable or disable multiple add-ons at once by selecting multiple add-ons in the available add-ons tab, then activating the context menu on the selection and choosing the appropriate action. + +#### Reviewing add-ons and reading reviews {#AddonStoreReviews} + +You may want to read reviews by other users who have experienced an add-on, for example before you install it, or as you are learning to use it. +Also, it is helpful to other users to provide feedback about add-ons you have tried. +To read reviews for an add-on, select it, and use the "Community reviews" action. +This links to a GitHub Discussion webpage, where you will be able to read and write reviews for the add-on. +Please be aware that this doesn't replace direct communication with add-on developers. +Instead, the purpose of this feature is to share feedback to help users decide if an add-on may be useful for them. + +### Incompatible Add-ons {#incompatibleAddonsManager} + +Some older add-ons may no longer be compatible with the version of NVDA that you have. +If you are using an older version of NVDA, some newer add-ons may not be compatible either. +Attempting to install an incompatible add-on will result in an error explaining why the add-on is considered incompatible. + +For older add-ons, you can override the incompatibility at your own risk. +Incompatible add-ons may not work with your version of NVDA, and can cause unstable or unexpected behaviour including crashing. +You can override compatibility when enabling or installing an add-on. +If the incompatible add-on causes issues later, you can disable or remove it. + +If you are having trouble running NVDA, and you have recently updated or installed an add-on, especially if it is an incompatible add-on, you may want to try running NVDA temporarily with all add-ons disabled. +To restart NVDA with all add-ons disabled, choose the appropriate option when quitting NVDA. +Alternatively, use the [command line option](#CommandLineOptions) `--disable-addons`. + +You can browse available incompatible add-ons using the [available and updatable add-ons tabs](#AddonStoreFilterStatus). +You can browse installed incompatible add-ons using the [incompatible add-ons tab](#AddonStoreFilterStatus). + +## Extra Tools {#ExtraTools} +### Log Viewer {#LogViewer} + +The log viewer, found under Tools in the NVDA menu, allows you to view the logging output that has occurred since the latest session of NVDA was started. + +Apart from reading the content, you can also Save a copy of the log file, or refresh the viewer so that it loads new log output generated after the Log viewer was opened. +These actions are available under the Log menu in the log viewer. + +The file which is displayed when you open the log viewer is saved on your computer at the file location `%temp%\nvda.log`. +A new log file is created each time NVDA is started. +When this happens, the previous NVDA session's log file is moved to `%temp%\nvda-old.log`. + +You can also copy a fragment of the current log file to the clipboard without opening the log viewer. + + +| Name |Key |Description| +|---|---|---| +|Open log viewer |`NVDA+f1` |Opens the log viewer and displays developer information about the current navigator object.| +|Copy a fragment of the log to the clipboard |`NVDA+control+shift+f1` |When this command is pressed once, it sets a starting point for the log content that should be captured. When pressed a second time, it copies the log content since the start point to your clipboard.| + + + +### Speech Viewer {#SpeechViewer} + +For sighted software developers or people demoing NVDA to sighted audiences, a floating window is available that allows you to view all the text that NVDA is currently speaking. + +To enable the speech viewer, check the "Speech Viewer" menu item under Tools in the NVDA menu. +Uncheck the menu item to disable it. + +The speech viewer window contains a check box labelled "Show speech viewer on startup". +If this is checked, the speech viewer will open when NVDA is started. +The speech viewer window will always attempt to re-open with the same dimensions and location as when it was closed. + +While the speech viewer is enabled, it constantly updates to show you the most current text being spoken. +However, if you hover your mouse over or focus inside the viewer, NVDA will temporarily stop updating the text, so that you are able to easily select or copy the existing content. + +To toggle the speech viewer from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + +### Braille Viewer {#BrailleViewer} + +For sighted software developers or people demoing NVDA to sighted audiences, a floating window is available that allows you to view braille output, and the text equivalent for each braille character. +The braille viewer can be used at the same time as a physical braille display, it will match the number of cells on the physical device. +While the braille viewer is enabled, it constantly updates to show you the braille that would be displayed on a physical braille display. + +To enable the braille viewer, check the "Braille Viewer" menu item under Tools in the NVDA menu. +Uncheck the menu item to disable it. + +Physical braille displays typically have buttons to scroll forwards or backwards, to enable scrolling with the braille viewer tool use the [Input Gestures dialog](#InputGestures) to assign keyboard shortcuts which "Scrolls the braille display back" and "Scrolls the braille display forward" + +The braille viewer window contains a check box labelled "Show braille viewer on startup". +If this is checked, the braille viewer will open when NVDA is started. +The braille viewer window will always attempt to re-open with the same dimensions and location as when it was closed. + +The braille viewer window contains a check box labeled "Hover for cell routing", the default is unchecked. +If checked, hovering the mouse over a braille cell will enable trigger the "route to braille cell" command for that cell. +This is often used to move the caret or trigger the action for a control. +This can be useful for testing NVDA is able to correctly reverse map a from braille cell. +To prevent unintentionally routing to cells, the command is delayed. +The mouse must hover until the cell turns green. +The cell will start as a light yellow colour, transition to orange, then suddenly become green. + +To toggle the braille viewer from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + +### Python Console {#PythonConsole} + +The NVDA Python console, found under Tools in the NVDA menu, is a development tool which is useful for debugging, general inspection of NVDA internals or inspection of the accessibility hierarchy of an application. +For more information, please see the [NVDA Developer Guide](https://www.nvaccess.org/files/nvda/documentation/developerGuide.html). + +### Add-on Store {#AddonStoreMenuItem} + +This will open the [NVDA Add-on Store](#AddonsManager). +For more information, read the in-depth section: [Add-ons and the Add-on Store](#AddonsManager). + +### Create portable copy {#CreatePortableCopy} + +This will open a dialog which allows you to create a portable copy of NVDA out of the installed version. +Either way, when running a portable copy of NVDA, in the extra tool sub menu the menu item will be called "install NVDA on this PC" instead of "create portable copy). + +The dialog to create a portable copy of NVDA or to install NVDA on this PC will prompt you to choose a folder path in which NVDA should create the portable copy or in which NVDA should be installed. + +In this dialog you can enable or disable the following: + +* Copy current user configuration (this includes the files in %appdata%\roaming\NVDA or in the user configuration of your portable copy and also includes add-ons and other modules) +* Start the new portable copy after creation or start NVDA after installation (starts NVDA automatically after the portable copy creation or the installation) + +### Run COM registration fixing tool... {#RunCOMRegistrationFixingTool} + +Installing and uninstalling programs on a computer can, in certain cases, cause COM DLL files to get unregistered. +As COM Interfaces such as IAccessible depend on correct COM DLL registrations, issues can appear in case the correct registration is missing. + +This can happen i.e. after installing and uninstalling Adobe Reader, Math Player and other programs. + +The missing registration can cause issues in browsers, desktop apps, task bar and other interfaces. + +Specifically, following issues can be solved by running this tool: + +* NVDA reports "unknown" when navigating in browsers such as Firefox, Thunderbird etc. +* NVDA fails to switch between focus mode and browse mode +* NVDA is very slow when navigating in browsers while using browse mode +* And possibly other issues. + +### Reload plugins {#ReloadPlugins} + +This item, once activated, reloads app modules and global plugins without restarting NVDA, which can be useful for developers. +App modules manage how NVDA interacts with specific applications. +Global plugins manage how NVDA interacts with all applications. + +The following NVDA key commands may also be useful: + + +| Name |Key |Description| +|---|---|---| +|Reload plugins |`NVDA+control+f3` |Reloads NVDA's global plugins and app modules.| +|Report loaded app module and executable |`NVDA+control+f1` |Report the name of the app module, if any, and the name of the executable associated with the application which has the keyboard focus.| + + + +## Supported Speech Synthesizers {#SupportedSpeechSynths} + +This section contains information about the speech synthesizers supported by NVDA. +For an even more extensive list of free and commercial synthesizers that you can purchase and download for use with NVDA, please see the [extra voices page](https://github.com/nvaccess/nvda/wiki/ExtraVoices). + +### eSpeak NG {#eSpeakNG} + +The [eSpeak NG](https://github.com/espeak-ng/espeak-ng) synthesizer is built directly into NVDA and does not require any other special drivers or components to be installed. +On Windows 8.1 NVDA uses eSpeak NG by default ([Windows OneCore](#OneCore) is used in Windows 10 and later by default). +As this synthesizer is built into NVDA, this is a great choice for when running NVDA off a USB thumb drive on other systems. + +Each voice that comes with eSpeak NG speaks a different language. +There are over 43 different languages supported by eSpeak NG. + +There are also many variants which can be chosen to alter the sound of the voice. + +### Microsoft Speech API version 4 (SAPI 4) {#SAPI4} + +SAPI 4 is an older Microsoft standard for software speech synthesizers. +NVDA still supports this for users who already have SAPI 4 synthesizers installed. +However, Microsoft no longer support this and needed components are no longer available from Microsoft. + +When using this synthesizer with NVDA, the available voices (accessed from the [Speech category](#SpeechSettings) of the [NVDA Settings](#NVDASettings) dialog or by the [Synth Settings Ring](#SynthSettingsRing)) will contain all the voices from all the installed SAPI 4 engines found on your system. + +### Microsoft Speech API version 5 (SAPI 5) {#SAPI5} + +SAPI 5 is a Microsoft standard for software speech synthesizers. +Many speech synthesizers that comply with this standard may be purchased or downloaded for free from various companies and websites, though your system will probably already come with at least one SAPI 5 voice preinstalled. +When using this synthesizer with NVDA, the available voices (accessed from the [Speech category](#SpeechSettings) of the [NVDA Settings](#NVDASettings) dialog or by the [Synth Settings Ring](#SynthSettingsRing)) will contain all the voices from all the installed SAPI 5 engines found on your system. + +### Microsoft Speech Platform {#MicrosoftSpeechPlatform} + +The Microsoft Speech Platform provides voices for many languages which are normally used in the development of server-based speech applications. +These voices can also be used with NVDA. + +To use these voices, you will need to install two components: + +* [Microsoft Speech Platform - Runtime (Version 11), x86](https://www.microsoft.com/download/en/details.aspx?id=27225) +* [Microsoft Speech Platform - Runtime Languages (Version 11)](https://www.microsoft.com/download/en/details.aspx?id=27224) + * This page includes many files for both speech recognition and text-to-speech. + Choose the files containing the TTS data for the desired languages/voices. + For example, the file MSSpeech_TTS_en-US_ZiraPro.msi is a U.S. English voice. + +### Windows OneCore Voices {#OneCore} + +Windows 10 and later includes voices known as "OneCore" or "mobile" voices. +Voices are provided for many languages, and they are more responsive than the Microsoft voices available using Microsoft Speech API version 5. +On Windows 10 and later, NVDA uses Windows OneCore voices by default ([eSpeak NG](#eSpeakNG) is used in other releases). + +To add new Windows OneCore voices, go to "Speech Settings", within Windows system settings. +Use the "Add voices" option and search for the desired language. +Many languages include multiple variants. +"United Kingdom" and "Australia" are two of the English variants. +"France", "Canada" and "Switzerland" are French variants available. +Search for the broader language (such as English or French), then locate the variant in the list. +Select any languages desired and use the "add" button to add them. +Once added, restart NVDA. + +Please see [Supported languages and voices](https://support.microsoft.com/en-us/windows/appendix-a-supported-languages-and-voices-4486e345-7730-53da-fcfe-55cc64300f01) for a list of available voices. + +## Supported Braille Displays {#SupportedBrailleDisplays} + +This section contains information about the Braille displays supported by NVDA. + +### Displays supporting automatic detection in the background {#AutomaticDetection} + +NVDA has the ability to detect many braille displays in the background automatically, either via USB or bluetooth. +This behaviour is achieved by selecting the Automatic option as the preferred braille display from NVDA's [Braille Settings dialog](#BrailleSettings). +This option is selected by default. + +The following displays support this automatic detection functionality. + +* Handy Tech displays +* Baum/Humanware/APH/Orbit braille displays +* HumanWare Brailliant BI/B series +* HumanWare BrailleNote +* SuperBraille +* Optelec ALVA 6 series +* HIMS Braille Sense/Braille EDGE/Smart Beetle/Sync Braille Series +* Eurobraille Esys/Esytime/Iris displays +* Nattiq nBraille displays +* Seika Notetaker: MiniSeika (16, 24 cells), V6, and V6Pro (40 cells) +* Tivomatic Caiku Albatross 46/80 displays +* Any Display that supports the Standard HID Braille protocol + +### Freedom Scientific Focus/PAC Mate Series {#FreedomScientificFocus} + +All Focus and PAC Mate displays from [Freedom Scientific](https://www.freedomscientific.com/) are supported when connected via USB or bluetooth. +You will need the Freedom Scientific braille display drivers installed on your system. +If you do not have them already, you can obtain them from the [Focus Blue Braille Display Driver page](https://support.freedomscientific.com/Downloads/Focus/FocusBlueBrailleDisplayDriver). +Although this page only mentions the Focus Blue display, the drivers support all Freedom Scientific Focus and Pacmate displays. + +By default, NVDA can automatically detect and connect to these displays either via USB or bluetooth. +However, when configuring the display, you can explicitly select "USB" or "Bluetooth" ports to restrict the connection type to be used. +This might be useful if you want to connect the focus display to NVDA using bluetooth, but still be able to charge it using USB power from your computer. +NVDA's automatic braille display detection will also recognize the display on USB or Bluetooth. + +Following are the key assignments for this display with NVDA. +Please see the display's documentation for descriptions of where these keys can be found. + + +| Name |Key| +|---|---| +|Scroll braille display back |topRouting1 (first cell on display)| +|Scroll braille display forward |topRouting20/40/80 (last cell on display)| +|Scroll braille display back |leftAdvanceBar| +|Scroll braille display forward |rightAdvanceBar| +|Toggle braille tethered to |leftGDFButton+rightGDFButton| +|Toggle left wiz wheel action |leftWizWheelPress| +|Move back using left wiz wheel action |leftWizWheelUp| +|Move forward using left wiz wheel action |leftWizWheelDown| +|Toggle right wiz wheel action |rightWizWheelPress| +|Move back using right wiz wheel action |rightWizWheelUp| +|Move forward using right wiz wheel action |rightWizWheelDown| +|Route to braille cell |routing| +|shift+tab key |brailleSpaceBar+dot1+dot2| +|tab key |brailleSpaceBar+dot4+dot5| +|upArrow key |brailleSpaceBar+dot1| +|downArrow key |brailleSpaceBar+dot4| +|control+leftArrow key |brailleSpaceBar+dot2| +|control+rightArrow key |brailleSpaceBar+dot5| +|leftArrow |brailleSpaceBar+dot3| +|rightArrow key |brailleSpaceBar+dot6| +|home key |brailleSpaceBar+dot1+dot3| +|end key |brailleSpaceBar+dot4+dot6| +|control+home key |brailleSpaceBar+dot1+dot2+dot3| +|control+end key |brailleSpaceBar+dot4+dot5+dot6| +|alt key |brailleSpaceBar+dot1+dot3+dot4| +|alt+tab key |brailleSpaceBar+dot2+dot3+dot4+dot5| +|alt+shift+tab key |brailleSpaceBar+dot1+dot2+dot5+dot6| +|windows+tab key |brailleSpaceBar+dot2+dot3+dot4| +|escape key |brailleSpaceBar+dot1+dot5| +|windows key |brailleSpaceBar+dot2+dot4+dot5+dot6| +|space key |brailleSpaceBar| +|Toggle control key |brailleSpaceBar+dot3+dot8| +|Toggle alt key |brailleSpaceBar+dot6+dot8| +|Toggle windows key |brailleSpaceBar+dot4+dot8| +|Toggle NVDA key |brailleSpaceBar+dot5+dot8| +|Toggle shift key |brailleSpaceBar+dot7+dot8| +|Toggle control and shift keys |brailleSpaceBar+dot3+dot7+dot8| +|Toggle alt and shift keys |brailleSpaceBar+dot6+dot7+dot8| +|Toggle windows and shift keys |brailleSpaceBar+dot4+dot7+dot8| +|Toggle NVDA and shift keys |brailleSpaceBar+dot5+dot7+dot8| +|Toggle control and alt keys |brailleSpaceBar+dot3+dot6+dot8| +|Toggle control, alt, and shift keys |brailleSpaceBar+dot3+dot6+dot7+dot8| +|windows+d key (minimize all applications) |brailleSpaceBar+dot1+dot2+dot3+dot4+dot5+dot6| +|Report Current Line |brailleSpaceBar+dot1+dot4| +|NVDA menu |brailleSpaceBar+dot1+dot3+dot4+dot5| + +For newer Focus models that contain rocker bar keys (focus 40, focus 80 and focus blue): + +| Name |Key| +|---|---| +|Move braille display to previous line |leftRockerBarUp, rightRockerBarUp| +|Move braille display to next line |leftRockerBarDown, rightRockerBarDown| + +For Focus 80 only: + +| Name |Key| +|---|---| +|Scroll braille display back |leftBumperBarUp, rightBumperBarUp| +|Scroll braille display forward |leftBumperBarDown, rightBumperBarDown| + + + +### Optelec ALVA 6 series/protocol converter {#OptelecALVA} + +Both the ALVA BC640 and BC680 displays from [Optelec](https://www.optelec.com/) are supported when connected via USB or bluetooth. +Alternatively, you can connect an older Optelec display, such as a Braille Voyager, using a protocol converter supplied by Optelec. +You do not need any specific drivers to be installed to use these displays. +Just plug in the display and configure NVDA to use it. + +Note: NVDA might be unable to use an ALVA BC6 display over Bluetooth when it is paired using the ALVA Bluetooth utility. +When you have paired your device using this utility and NVDA is unable to detect your device, we recommend you to pair your ALVA display the regular way using the Windows Bluetooth settings. + +Note: while some of these displays do have a braille keyboard, they handle translation from braille to text themselves by default. +This means that NVDA's braille input system is not in use in the default situation (i.e. the input braille table setting has no effect). +For ALVA displays with recent firmware, it is possible to disable this HID keyboard simulation using an input gesture. + +Following are key assignments for this display with NVDA. +Please see the display's documentation for descriptions of where these keys can be found. + + +| Name |Key| +|---|---| +|Scroll braille display back |t1, etouch1| +|Move braille display to previous line |t2| +|Move to current focus |t3| +|Move braille display to next line |t4| +|Scroll braille display forward |t5, etouch3| +|Route to braille cell |routing| +|Report text formatting under braille cell |secondary routing| +|Toggle HID keyboard simulation |t1+spEnter| +|Move to top line in review |t1+t2| +|Move to bottom line in review |t4+t5| +|Toggle braille tethered to |t1+t3| +|Report title |etouch2| +|Report status bar |etouch4| +|shift+tab key |sp1| +|alt key |sp2, alt| +|escape key |sp3| +|tab key |sp4| +|upArrow key |spUp| +|downArrow key |spDown| +|leftArrow key |spLeft| +|rightArrow key |spRight| +|enter key |spEnter, enter| +|Report date/time |sp2+sp3| +|NVDA Menu |sp1+sp3| +|windows+d key (minimize all applications) |sp1+sp4| +|windows+b key (focus system tray) |sp3+sp4| +|windows key |sp1+sp2, windows| +|alt+tab key |sp2+sp4| +|control+home key |t3+spUp| +|control+end key |t3+spDown| +|home key |t3+spLeft| +|end key |t3+spRight| +|control key |control| + + + +### Handy Tech Displays {#HandyTech} + +NVDA supports most displays from [Handy Tech](https://www.handytech.de/) when connected via USB, serial port or bluetooth. +For older USB displays, you will need to install the USB drivers from Handy Tech on your system. + +The following displays are not supported out of the box, but can be used via [Handy Tech's universal driver](https://handytech.de/en/service/downloads-and-manuals/handy-tech-software/braille-display-drivers) and NVDA add-on: + +* Braillino +* Bookworm +* Modular displays with firmware version 1.13 or lower. Please note that the firmware of this displays can be updated. + +Following are the key assignments for Handy Tech displays with NVDA. +Please see the display's documentation for descriptions of where these keys can be found. + + +| Name |Key| +|---|---| +|Scroll braille display back |left, up, b3| +|Scroll braille display forward |right, down, b6| +|Move braille display to previous line |b4| +|Move braille display to next line |b5| +|Route to braille cell |routing| +|shift+tab key |esc, left triple action key up+down| +|alt key |b2+b4+b5| +|escape key |b4+b6| +|tab key |enter, right triple action key up+down| +|enter key |esc+enter, left+right triple action key up+down, joystickAction| +|upArrow key |joystickUp| +|downArrow key |joystickDown| +|leftArrow key |joystickLeft| +|rightArrow key |joystickRight| +|NVDA Menu |b2+b4+b5+b6| +|Toggle braille tethered to |b2| +|Toggle the braille cursor |b1| +|Toggle focus context presentation |b7| +|Toggle braille input |space+b1+b3+b4 (space+capital B)| + + + +### MDV Lilli {#MDVLilli} + +The Lilli braille display available from [MDV](https://www.mdvbologna.it/) is supported. +You do not need any specific drivers to be installed to use this display. +Just plug in the display and configure NVDA to use it. + +This display does not support NVDA's automatic background braille display detection functionality. + +Following are the key assignments for this display with NVDA. +Please see the display's documentation for descriptions of where these keys can be found. + + +| Name |Key| +|---|---| +|Scroll braille display backward |LF| +|Scroll braille display forward |RG| +|Move braille display to previous line |UP| +|Move braille display to next line |DN| +|Route to braille cell |route| +|shift+tab key |SLF| +|tab key |SRG| +|alt+tab key |SDN| +|alt+shift+tab key |SUP| + + + +### Baum/Humanware/APH/Orbit Braille Displays {#Baum} + +Several [Baum](https://www.visiobraille.de/index.php?article_id=1&clang=2), [HumanWare](https://www.humanware.com/), [APH](https://www.aph.org/) and [Orbit](https://www.orbitresearch.com/) displays are supported when connected via USB, bluetooth or serial. +These include: + +* Baum: SuperVario, PocketVario, VarioUltra, Pronto!, SuperVario2, Vario 340 +* HumanWare: Brailliant, BrailleConnect, Brailliant2 +* APH: Refreshabraille +* Orbit: Orbit Reader 20 + +Some other displays manufactured by Baum may also work, though this has not been tested. + +If connecting via USB to displays which do not use HID, you must first install the USB drivers provided by the manufacturer. +The VarioUltra and Pronto! use HID. +The Refreshabraille and Orbit Reader 20 can use HID if configured appropriately. + +The USB serial mode of the Orbit Reader 20 is currently only supported in Windows 10 and later. +USB HID should generally be used instead. + +Following are the key assignments for these displays with NVDA. +Please see your display's documentation for descriptions of where these keys can be found. + + +| Name |Key| +|---|---| +|Scroll braille display back |`d2`| +|Scroll braille display forward |`d5`| +|Move braille display to previous line |`d1`| +|Move braille display to next line |`d3`| +|Route to braille cell |`routing`| +|`shift+tab` key |`space+dot1+dot3`| +|`tab` key |`space+dot4+dot6`| +|`alt` key |`space+dot1+dot3+dot4` (`space+m`)| +|`escape` key |`space+dot1+dot5` (`space+e`)| +|`windows` key |`space+dot3+dot4`| +|`alt+tab` key |`space+dot2+dot3+dot4+dot5` (`space+t`)| +|NVDA Menu |`space+dot1+dot3+dot4+dot5` (`space+n`)| +|`windows+d` key (minimize all applications) |`space+dot1+dot4+dot5` (`space+d`)| +|Say all |`space+dot1+dot2+dot3+dot4+dot5+dot6`| + +For displays which have a joystick: + +| Name |Key| +|---|---| +|upArrow key |up| +|downArrow key |down| +|leftArrow key |left| +|rightArrow key |right| +|enter key |select| + + + +### hedo ProfiLine USB {#HedoProfiLine} + +The hedo ProfiLine USB from [hedo Reha-Technik](https://www.hedo.de/) is supported. +You must first install the USB drivers provided by the manufacturer. + +This display does not yet support NVDA's automatic background braille display detection functionality. + +Following are the key assignments for this display with NVDA. +Please see the display's documentation for descriptions of where these keys can be found. + + +| Name |Key| +|---|---| +|Scroll braille display back |K1| +|Scroll braille display forward |K3| +|Move braille display to previous line |B2| +|Move braille display to next line |B5| +|Route to braille cell |routing| +|Toggle braille tethered to |K2| +|Say all |B6| + + + +### hedo MobilLine USB {#HedoMobilLine} + +The hedo MobilLine USB from [hedo Reha-Technik](https://www.hedo.de/) is supported. +You must first install the USB drivers provided by the manufacturer. + +This display does not yet support NVDA's automatic background braille display detection functionality. + +Following are the key assignments for this display with NVDA. +Please see the display's documentation for descriptions of where these keys can be found. + + +| Name |Key| +|---|---| +|Scroll braille display back |K1| +|Scroll braille display forward |K3| +|Move braille display to previous line |B2| +|Move braille display to next line |B5| +|Route to braille cell |routing| +|Toggle braille tethered to |K2| +|Say all |B6| + + + +### HumanWare Brailliant BI/B Series / BrailleNote Touch {#HumanWareBrailliant} + +The Brailliant BI and B series of displays from [HumanWare](https://www.humanware.com/), including the BI 14, BI 32, BI 20X, BI 40, BI 40X and B 80, are supported when connected via USB or bluetooth. +If connecting via USB with the protocol set to HumanWare, you must first install the USB drivers provided by the manufacturer. +USB drivers are not required if the protocol is set to OpenBraille. + +The following extra devices are also supported (and do not require any special drivers to be installed): + +* APH Mantis Q40 +* APH Chameleon 20 +* Humanware BrailleOne +* NLS eReader + +Following are the key assignments for the Brailliant BI/B and BrailleNote touch displays with NVDA. +Please see the display's documentation for descriptions of where these keys can be found. + +#### Key assignments for All models {#HumanWareBrailliantKeyAssignmentForAllModels} + + + +| Name |Key| +|---|---| +|Scroll braille display back |left| +|Scroll braille display forward |right| +|Move braille display to previous line |up| +|Move braille display to next line |down| +|Route to braille cell |routing| +|Toggle braille tethered to |up+down| +|upArrow key |space+dot1| +|downArrow key |space+dot4| +|leftArrow key |space+dot3| +|rightArrow key |space+dot6| +|shift+tab key |space+dot1+dot3| +|tab key |space+dot4+dot6| +|alt key |space+dot1+dot3+dot4 (space+m)| +|escape key |space+dot1+dot5 (space+e)| +|enter key |dot8| +|windows key |space+dot3+dot4| +|alt+tab key |space+dot2+dot3+dot4+dot5 (space+t)| +|NVDA Menu |space+dot1+dot3+dot4+dot5 (space+n)| +|windows+d key (minimize all applications) |space+dot1+dot4+dot5 (space+d)| +|Say all |space+dot1+dot2+dot3+dot4+dot5+dot6| + + + +#### Key assignments for Brailliant BI 32, BI 40 and B 80 {#HumanWareBrailliantKeyAssignmentForBI32BI40AndB80} + + + +| Name |Key| +|---|---| +|NVDA Menu |c1+c3+c4+c5 (command n)| +|windows+d key (minimize all applications) |c1+c4+c5 (command d)| +|Say all |c1+c2+c3+c4+c5+c6| + + + +#### Key assignments for Brailliant BI 14 {#HumanWareBrailliantKeyAssignmentForBI14} + + + +| Name |Key| +|---|---| +|up arrow key |joystick up| +|down arrow key |joystick down| +|left arrow key |joystick left| +|right arrow key |joystick right| +|enter key |joystick action| + + + +### HIMS Braille Sense/Braille EDGE/Smart Beetle/Sync Braille Series {#Hims} + +NVDA supports Braille Sense, Braille EDGE, Smart Beetle and Sync Braille displays from [Hims](https://www.hims-inc.com/) when connected via USB or bluetooth. +If connecting via USB, you will need to install the [USB drivers from HIMS](http://www.himsintl.com/upload/HIMS_USB_Driver_v25.zip) on your system. + +Following are the key assignments for these displays with NVDA. +Please see the display's documentation for descriptions of where these keys can be found. + + +| Name |Key| +|---|---| +|Route to braille cell |routing| +|Scroll braille display back |leftSideScrollUp, rightSideScrollUp, leftSideScroll| +|Scroll braille display forward |leftSideScrollDown, rightSideScrollDown, rightSideScroll| +|Move braille display to previous line |leftSideScrollUp+rightSideScrollUp| +|Move braille display to next line |leftSideScrollDown+rightSideScrollDown| +|Move to previous line in review |rightSideUpArrow| +|Move to next line in review |rightSideDownArrow| +|Move to previous character in review |rightSideLeftArrow| +|Move to next character in review |rightSideRightArrow| +|Move to current focus |leftSideScrollUp+leftSideScrollDown, rightSideScrollUp+rightSideScrollDown, leftSideScroll+rightSideScroll| +|control key |smartbeetle:f1, brailleedge:f3| +|windows key |f7, smartbeetle:f2| +|alt key |dot1+dot3+dot4+space, f2, smartbeetle:f3, brailleedge:f4| +|shift key |f5| +|insert key |dot2+dot4+space, f6| +|applications key |dot1+dot2+dot3+dot4+space, f8| +|Caps Lock key |dot1+dot3+dot6+space| +|tab key |dot4+dot5+space, f3, brailleedge:f2| +|shift+alt+tab key |f2+f3+f1| +|alt+tab key |f2+f3| +|shift+tab key |dot1+dot2+space| +|end key |dot4+dot6+space| +|control+end key |dot4+dot5+dot6+space| +|home key |dot1+dot3+space, smartbeetle:f4| +|control+home key |dot1+dot2+dot3+space| +|alt+f4 key |dot1+dot3+dot5+dot6+space| +|leftArrow key |dot3+space, leftSideLeftArrow| +|control+shift+leftArrow key |dot2+dot8+space+f1| +|control+leftArrow key |dot2+space| +|shift+alt+leftArrow key |dot2+dot7+f1| +|`alt+leftArrow` |`dot2+dot7+space`| +|rightArrow key |dot6+space, leftSideRightArrow| +|control+shift+rightArrow key |dot5+dot8+space+f1| +|control+rightArrow key |dot5+space| +|shift+alt+rightArrow key |dot5+dot7+f1| +|`alt+rightArrow` |`dot5+dot7+space`| +|pageUp key |dot1+dot2+dot6+space| +|control+pageUp key |dot1+dot2+dot6+dot8+space| +|upArrow key |dot1+space, leftSideUpArrow| +|control+shift+upArrow key |dot2+dot3+dot8+space+f1| +|control+upArrow key |dot2+dot3+space| +|shift+alt+upArrow key |dot2+dot3+dot7+f1| +|`alt+upArrow` |`dot2+dot3+dot7+space`| +|shift+upArrow key |leftSideScrollDown+space| +|pageDown key |dot3+dot4+dot5+space| +|control+pageDown key |dot3+dot4+dot5+dot8+space| +|downArrow key |dot4+space, leftSideDownArrow| +|control+shift+downArrow key |dot5+dot6+dot8+space+f1| +|control+downArrow key |dot5+dot6+space| +|shift+alt+downArrow key |dot5+dot6+dot7+f1| +|`alt+downArrow` |`dot5+dot6+dot7+space`| +|shift+downArrow key |space+rightSideScrollDown| +|escape key |dot1+dot5+space, f4, brailleedge:f1| +|delete key |dot1+dot3+dot5+space, dot1+dot4+dot5+space| +|f1 key |dot1+dot2+dot5+space| +|f3 key |dot1+dot4+dot8+space| +|f4 key |dot7+f3| +|windows+b key |dot1+dot2+f1| +|windows+d key |dot1+dot4+dot5+f1| +|control+insert key |smartbeetle:f1+rightSideScroll| +|alt+insert key |smartbeetle:f3+rightSideScroll| + + + +### Seika Braille Displays {#Seika} + +The following Seika Braille displays from Nippon Telesoft are supported in two groups with different functionality: + +* [Seika Version 3, 4, and 5 (40 cells), Seika80 (80 cells)](#SeikaBrailleDisplays) +* [MiniSeika (16, 24 cells), V6, and V6Pro (40 cells)](#SeikaNotetaker) + +You can find more information about the displays on their [Demo and Driver Download page](https://en.seika-braille.com/down/index.html). + +#### Seika Version 3, 4, and 5 (40 cells), Seika80 (80 cells) {#SeikaBrailleDisplays} + +* These displays do not yet support NVDA's automatic background braille display detection functionality. +* Select "Seika Braille Displays" to manually configure +* A device drivers must be installed before using Seika v3/4/5/80. +The drivers are [provided by the manufacturer](https://en.seika-braille.com/down/index.html). + +The Seika Braille Display key assignments follow. +Please see the display's documentation for descriptions of where these keys can be found. + + +| Name |Key| +|---|---| +|Scroll braille display back |left| +|Scroll braille display forward |right| +|Move braille display to previous line |b3| +|Move braille display to next line |b4| +|Toggle braille tethered to |b5| +|Say all |b6| +|tab |b1| +|shift+tab |b2| +|alt+tab |b1+b2| +|NVDA Menu |left+right| +|Route to braille cell |routing| + + + +#### MiniSeika (16, 24 cells), V6, and V6Pro (40 cells) {#SeikaNotetaker} + +* NVDA's automatic background braille display detection functionality is supported via USB and Bluetooth. +* Select "Seika Notetaker" or "auto" to configure. +* No extra drivers are required when using a Seika Notetaker braille display. + +The Seika Notetaker key assignments follow. +Please see the display's documentation for descriptions of where these keys can be found. + + +| Name |Key| +|---|---| +|Scroll braille display back |left| +|Scroll braille display forward |right| +|Say all |space+Backspace| +|NVDA Menu |Left+Right| +|Move braille display to previous line |LJ up| +|Move braille display to next line |LJ down| +|Toggle braille tethered to |LJ center| +|tab |LJ right| +|shift+tab |LJ left| +|upArrow key |RJ up| +|downArrow key |RJ down| +|leftArrow key |RJ left| +|rightArrow key |RJ right| +|Route to braille cell |routing| +|shift+upArrow key |Space+RJ up, Backspace+RJ up| +|shift+downArrow key |Space+RJ down, Backspace+RJ down| +|shift+leftArrow key |Space+RJ left, Backspace+RJ left| +|shift+rightArrow key |Space+RJ right, Backspace+RJ right| +|enter key |RJ center, dot8| +|escape key |Space+RJ center| +|windows key |Backspace+RJ center| +|space key |Space, Backspace| +|backspace key |dot7| +|pageup key |space+LJ right| +|pagedown key |space+LJ left| +|home key |space+LJ up| +|end key |space+LJ down| +|control+home key |backspace+LJ up| +|control+end key |backspace+LJ down| + +### Papenmeier BRAILLEX Newer Models {#Papenmeier} + +The following Braille displays are supported: + +* BRAILLEX EL 40c, EL 80c, EL 20c, EL 60c (USB) +* BRAILLEX EL 40s, EL 80s, EL 2d80s, EL 70s, EL 66s (USB) +* BRAILLEX Trio (USB and bluetooth) +* BRAILLEX Live 20, BRAILLEX Live and BRAILLEX Live Plus (USB and bluetooth) + +These displays do not support NVDA's automatic background braille display detection functionality. +There is an option in the display's USB driver which can cause an issue with loading the display. +Please try the following: + +1. Please make sure that you have installed the [latest driver](https://www.papenmeier-rehatechnik.de/en/service/downloadcenter/software/articles/software-braille-devices.html). +1. Open the Windows Device Manager. +1. Scroll down the list to "USB Controllers" or "USB Devices". +1. Select "Papenmeier Braillex USB Device". +1. Open the properties and switch to the "Advanced" tab. +Sometimes the "Advanced" tab doesn't appear. +If this is the case, disconnect the braille display from the computer, exit NVDA, wait a moment and reconnect the braille display. +Repeat this 4 to 5 times if necessary. +If the "Advanced" tab is still not displayed, please restart the computer. +1. Disable the "Load VCP" option. + +Most devices have an Easy Access Bar (EAB) that allows intuitive and fast operation. +The EAB can be moved in four directions where generally each direction has two switches. +The C and Live series are the only exceptions to this rule. + +The c-series and some other displays have two routing rows whereby the upper row is used to report formatting information. +Holding one of the upper routing keys and pressing the EAB on c-series devices emulates the second switch state. +The live series displays have one routing row only and the EAB has one step per direction. +The second step may be emulated by pressing one of the routing keys and pressing the EAB in the corresponding direction. +Pressing and holding the up, down, right and left keys (or EAB) causes the corresponding action to be repeated. + +Generally, the following keys are available on these braille displays: + +| Name |Key| +|---|---| +|l1 |Left front key| +|l2 |Left rear key| +|r1 |Right front key| +|r2 |Right rear key| +|up |1 Step up| +|up2 |2 Steps up| +|left |1 Step left| +|left2 |2 Steps left| +|right |1 Step right| +|right2 |2 Steps right| +|dn |1 Step down| +|dn2 |2 Steps down| + +Following are the Papenmeier command assignments for NVDA: + + +| Name |Key| +|---|---| +|Scroll braille display back |left| +|Scroll braille display forward |right| +|Move braille display to previous line |up| +|Move braille display to next line |dn| +|Route to braille cell |routing| +|Report current character in review |l1| +|Activate current navigator object |l2| +|Toggle braille tethered to |r2| +|Report title |l1+up| +|Report Status Bar |l2+down| +|Move to containing object |up2| +|Move to first contained object |dn2| +|Move to previous object |left2| +|Move to next object |right2| +|Report text formatting under braille cell |upper routing row| + + + +The Trio model has four additional keys which are in front of the braille keyboard. +These are (ordered from left to right): + +* left thumb key (lt) +* space +* space +* right thumb key (rt) + +Currently, the right thumb key is not in use. +The inner keys are both mapped to space. + + + +| Name |Key| +|---|---| +|escape key |space with dot 7| +|upArrow key |space with dot 2| +|leftArrow key |space with dot 1| +|rightArrow key |space with dot 4| +|downArrow |space with dot 5| +|control key |lt+dot2| +|alt key |lt+dot3| +|control+escape key |space with dot 1 2 3 4 5 6| +|tab key |space with dot 3 7| + + + +### Papenmeier Braille BRAILLEX Older Models {#PapenmeierOld} + +The following Braille displays are supported: + +* BRAILLEX EL 80, EL 2D-80, EL 40 P +* BRAILLEX Tiny, 2D Screen + +Note that these displays can only be connected via a serial port. +Due to this, these displays do not support NVDA's automatic background braille display detection functionality. +You should select the port to which the display is connected after you have chosen this driver in the [Select Braille Display](#SelectBrailleDisplay) dialog. + +Some of these devices have an Easy Access Bar (EAB) that allows intuitive and fast operation. +The EAB can be moved in four directions where generally each direction has two switches. +Pressing and holding the up, down, right and left keys (or EAB) causes the corresponding action to be repeated. +Older devices do not have an EAB; front keys are used instead. + +Generally, the following keys are available on braille displays: + +| Name |Key| +|---|---| +|l1 |Left front key| +|l2 |Left rear key| +|r1 |Right front key| +|r2 |Right rear key| +|up |1 Step up| +|up2 |2 Steps up| +|left |1 Step left| +|left2 |2 Steps left| +|right |1 Step right| +|right2 |2 Steps right| +|dn |1 Step down| +|dn2 |2 Steps down| + +Following are the Papenmeier command assignments for NVDA: + + +Devices with EAB: + +| Name |Key| +|---|---| +|Scroll braille display back |left| +|Scroll braille display forward |right| +|Move braille display to previous line |up| +|Move braille display to next line |dn| +|Route to braille cell |routing| +|Report current character in review |l1| +|Activate current navigator object |l2| +|Report title |l1up| +|Report Status Bar |l2down| +|Move to containing object |up2| +|Move to first contained object |dn2| +|Move to next object |right2| +|Move to previous object |left2| +|Report text formatting under braille cell |upper routing strip| + +BRAILLEX Tiny: + +| Name |Key| +|---|---| +|Report current character in review |l1| +|Activate current navigator object |l2| +|Scroll braille display back |left| +|Scroll braille display forward |right| +|Move braille display to previous line |up| +|Move braille display to next line |dn| +|Toggle braille tethered to |r2| +|Move to containing object |r1+up| +|Move to first contained object |r1+dn| +|Move to previous object |r1+left| +|Move to next object |r1+right| +|Report text formatting under braille cell |upper routing strip| +|Report title |l1+up| +|Report status bar |l2+down| + +BRAILLEX 2D Screen: + +| Name |Key| +|---|---| +|Report current character in review |l1| +|Activate current navigator object |l2| +|Toggle braille tethered to |r2| +|Report text formatting under braille cell |upper routing strip| +|Move braille display to previous line |up| +|Scroll braille display back |left| +|Scroll braille display forward |right| +|Move braille display to next line |dn| +|Move to next object |left2| +|Move to containing object |up2| +|Move to first contained object |dn2| +|Move to previous object |right2| + + + +### HumanWare BrailleNote {#HumanWareBrailleNote} + +NVDA supports the BrailleNote notetakers from [Humanware](https://www.humanware.com) when acting as a display terminal for a screen reader. +The following models are supported: + +* BrailleNote Classic (serial connection only) +* BrailleNote PK (Serial and bluetooth connections) +* BrailleNote MPower (Serial and bluetooth connections) +* BrailleNote Apex (USB and Bluetooth connections) + +For BrailleNote Touch, please refer to the [Brailliant BI Series / BrailleNote Touch](#HumanWareBrailliant) section. + +Except for BrailleNote PK, both braille (BT) and QWERTY (QT) keyboards are supported. +For BrailleNote QT, PC keyboard emulation isn't supported. +You can also enter braille dots using the QT keyboard. +Please check the braille terminal section of the BrailleNote manual guide for details. + +If your device supports more than one type of connection, when connecting your BrailleNote to NVDA, you must set the braille terminal port in braille terminal options. +Please check the BrailleNote manual for details. +In NVDA, you may also need to set the port in the [Select Braille Display](#SelectBrailleDisplay) dialog. +If you are connecting via USB or bluetooth, you can set the port to "Automatic", "USB" or "Bluetooth", depending on the available choices. +If connecting using a legacy serial port (or a USB to serial converter) or if none of the previous options appear, you must explicitly choose the communication port to be used from the list of hardware ports. + +Before connecting your BrailleNote Apex using its USB client interface, you must install the drivers provided by HumanWare. + +On the BrailleNote Apex BT, you can use the scroll wheel located between dots 1 and 4 for various NVDA commands. +The wheel consists of four directional dots, a centre click button, and a wheel that spins clockwise or counterclockwise. + +Following are the BrailleNote command assignments for NVDA. +Please check your BrailleNote's documentation to find where these keys are located. + + + +| Name |Key| +|---|---| +|Scroll braille display back |back| +|Scroll braille display forward |advance| +|Move braille display to previous line |previous| +|Move braille display to next line |next| +|Route to braille cell |routing| +|NVDA menu |space+dot1+dot3+dot4+dot5 (space+n)| +|Toggle braille tethered to |previous+next| +|Up arrow key |space+dot1| +|Down arrow key |space+dot4| +|Left Arrow key |space+dot3| +|Right arrow key |space+dot6| +|Page up key |space+dot1+dot3| +|Page down key |space+dot4+dot6| +|Home key |space+dot1+dot2| +|End key |space+dot4+dot5| +|Control+home keys |space+dot1+dot2+dot3| +|Control+end keys |space+dot4+dot5+dot6| +|Space key |space| +|Enter |space+dot8| +|Backspace |space+dot7| +|Tab key |space+dot2+dot3+dot4+dot5 (space+t)| +|Shift+tab keys |space+dot1+dot2+dot5+dot6| +|Windows key |space+dot2+dot4+dot5+dot6 (space+w)| +|Alt key |space+dot1+dot3+dot4 (space+m)| +|Toggle input help |space+dot2+dot3+dot6 (space+lower h)| + +Following are commands assigned to BrailleNote QT when it is not in braille input mode. + +| Name |Key| +|---|---| +|NVDA menu |read+n| +|Up arrow key |upArrow| +|Down arrow key |downArrow| +|Left Arrow key |leftArrow| +|Right arrow key |rightArrow| +|Page up key |function+upArrow| +|Page down key |function+downArrow| +|Home key |function+leftArrow| +|End key |function+rightArrow| +|Control+home keys |read+t| +|Control+end keys |read+b| +|Enter key |enter| +|Backspace key |backspace| +|Tab key |tab| +|Shift+tab keys |shift+tab| +|Windows key |read+w| +|Alt key |read+m| +|Toggle input help |read+1| + +Following are commands assigned to the scroll wheel: + +| Name |Key| +|---|---| +|Up arrow key |upArrow| +|Down arrow key |downArrow| +|Left Arrow key |leftArrow| +|Right arrow key |rightArrow| +|Enter key |centre button| +|Tab key |scroll wheel clockwise| +|Shift+tab keys |scroll wheel counterclockwise| + + + +### EcoBraille {#EcoBraille} + +NVDA supports EcoBraille displays from [ONCE](https://www.once.es/). +The following models are supported: + +* EcoBraille 20 +* EcoBraille 40 +* EcoBraille 80 +* EcoBraille Plus + +In NVDA, you can set the serial port to which the display is connected in the [Select Braille Display](#SelectBrailleDisplay) dialog. +These displays do not support NVDA's automatic background braille display detection functionality. + +Following are the key assignments for EcoBraille displays. +Please see the [EcoBraille documentation](ftp://ftp.once.es/pub/utt/bibliotecnia/Lineas_Braille/ECO/) for descriptions of where these keys can be found. + + + +| Name |Key| +|---|---| +|Scroll braille display back |T2| +|Scroll braille display forward |T4| +|Move braille display to previous line |T1| +|Move braille display to next line |T5| +|Route to braille cell |Routing| +|Activate current navigator object |T3| +|Switch to next review mode |F1| +|Move to containing object |F2| +|Switch to previous review mode |F3| +|Move to previous object |F4| +|Report current object |F5| +|Move to next object |F6| +|Move to focus object |F7| +|Move to first contained object |F8| +|Move System focus or caret to current review position |F9| +|Report review cursor location |F0| +|Toggle braille tethered to |A| + + + +### SuperBraille {#SuperBraille} + +The SuperBraille device, mostly available in Taiwan, can be connected to by either USB or serial. +As the SuperBraille does not have any physical typing keys or scrolling buttons, all input must be performed via a standard computer keyboard. +Due to this, and to maintain compatibility with other screen readers in Taiwan, two key bindings for scrolling the braille display have been provided: + + +| Name |Key| +|---|---| +|Scroll braille display back |numpadMinus| +|Scroll braille display forward |numpadPlus| + + + +### Eurobraille displays {#Eurobraille} + +The b.book, b.note, Esys, Esytime and Iris displays from Eurobraille are supported by NVDA. +These devices have a braille keyboard with 10 keys. +Please refer to the display's documentation for descriptions of these keys. +Of the two keys placed like a space bar, the left key is corresponding to the backspace key and the right key to the space key. + +These devices are connected via USB and have one stand-alone USB keyboard. +It is possible to enable/disable this keyboard by toggling "HID Keyboard simulation" using an input gesture. +The braille keyboard functions described directly below is when "HID Keyboard simulation" is disabled. + +#### Braille keyboard functions {#EurobrailleBraille} + + + +| Name |Key| +|---|---| +|Erase the last entered braille cell or character |`backspace`| +|Translate any braille input and press the enter key |`backspace+space`| +|Toggle `NVDA` key |`dot3+dot5+space`| +|`insert` key |`dot1+dot3+dot5+space`, `dot3+dot4+dot5+space`| +|`delete` key |`dot3+dot6+space`| +|`home` key |`dot1+dot2+dot3+space`| +|`end` key |`dot4+dot5+dot6+space`| +|`leftArrow` key |`dot2+space`| +|`rightArrow` key |`dot5+space`| +|`upArrow` key |`dot1+space`| +|`downArrow` key |`dot6+space`| +|`pageUp` key |`dot1+dot3+space`| +|`pageDown` key |`dot4+dot6+space`| +|`numpad1` key |`dot1+dot6+backspace`| +|`numpad2` key |`dot1+dot2+dot6+backspace`| +|`numpad3` key |`dot1+dot4+dot6+backspace`| +|`numpad4` key |`dot1+dot4+dot5+dot6+backspace`| +|`numpad5` key |`dot1+dot5+dot6+backspace`| +|`numpad6` key |`dot1+dot2+dot4+dot6+backspace`| +|`numpad7` key |`dot1+dot2+dot4+dot5+dot6+backspace`| +|`numpad8` key |`dot1+dot2+dot5+dot6+backspace`| +|`numpad9` key |`dot2+dot4+dot6+backspace`| +|`numpadInsert` key |`dot3+dot4+dot5+dot6+backspace`| +|`numpadDecimal` key |`dot2+backspace`| +|`numpadDivide` key |`dot3+dot4+backspace`| +|`numpadMultiply` key |`dot3+dot5+backspace`| +|`numpadMinus` key |`dot3+dot6+backspace`| +|`numpadPlus` key |`dot2+dot3+dot5+backspace`| +|`numpadEnter` key |`dot3+dot4+dot5+backspace`| +|`escape` key |`dot1+dot2+dot4+dot5+space`, `l2`| +|`tab` key |`dot2+dot5+dot6+space`, `l3`| +|`shift+tab` keys |`dot2+dot3+dot5+space`| +|`printScreen` key |`dot1+dot3+dot4+dot6+space`| +|`pause` key |`dot1+dot4+space`| +|`applications` key |`dot5+dot6+backspace`| +|`f1` key |`dot1+backspace`| +|`f2` key |`dot1+dot2+backspace`| +|`f3` key |`dot1+dot4+backspace`| +|`f4` key |`dot1+dot4+dot5+backspace`| +|`f5` key |`dot1+dot5+backspace`| +|`f6` key |`dot1+dot2+dot4+backspace`| +|`f7` key |`dot1+dot2+dot4+dot5+backspace`| +|`f8` key |`dot1+dot2+dot5+backspace`| +|`f9` key |`dot2+dot4+backspace`| +|`f10` key |`dot2+dot4+dot5+backspace`| +|`f11` key |`dot1+dot3+backspace`| +|`f12` key |`dot1+dot2+dot3+backspace`| +|`windows` key |`dot1+dot2+dot4+dot5+dot6+space`| +|Toggle `windows` key |`dot1+dot2+dot3+dot4+backspace`, `dot2+dot4+dot5+dot6+space`| +|`capsLock` key |`dot7+backspace`, `dot8+backspace`| +|`numLock` key |`dot3+backspace`, `dot6+backspace`| +|`shift` key |`dot7+space`| +|Toggle `shift` key |`dot1+dot7+space`, `dot4+dot7+space`| +|`control` key |`dot7+dot8+space`| +|Toggle `control` key |`dot1+dot7+dot8+space`, `dot4+dot7+dot8+space`| +|`alt` key |`dot8+space`| +|Toggle `alt` key |`dot1+dot8+space`, `dot4+dot8+space`| +|Toggle HID Keyboard simulation |`switch1Left+joystick1Down`, `switch1Right+joystick1Down`| + + + +#### b.book keyboard commands {#Eurobraillebbook} + + + +| Name |Key| +|---|---| +|Scroll braille display back |`backward`| +|Scroll braille display forward |`forward`| +|Move to current focus |`backward+forward`| +|Route to braille cell |`routing`| +|`leftArrow` key |`joystick2Left`| +|`rightArrow` key |`joystick2Right`| +|`upArrow` key |`joystick2Up`| +|`downArrow` key |`joystick2Down`| +|`enter` key |`joystick2Center`| +|`escape` key |`c1`| +|`tab` key |`c2`| +|Toggle `shift` key |`c3`| +|Toggle `control` key |`c4`| +|Toggle `alt` key |`c5`| +|Toggle `NVDA` key |`c6`| +|`control+Home` key |`c1+c2+c3`| +|`control+End` key |`c4+c5+c6`| + + + +#### b.note keyboard commands {#Eurobraillebnote} + + + +| Name |Key| +|---|---| +|Scroll braille display back |`leftKeypadLeft`| +|Scroll braille display forward |`leftKeypadRight`| +|Route to braille cell |`routing`| +|Report text formatting under braille cell |`doubleRouting`| +|Move to next line in review |`leftKeypadDown`| +|Switch to previous review mode |`leftKeypadLeft+leftKeypadUp`| +|Switch to next review mode |`leftKeypadRight+leftKeypadDown`| +|`leftArrow` key |`rightKeypadLeft`| +|`rightArrow` key |`rightKeypadRight`| +|`upArrow` key |`rightKeypadUp`| +|`downArrow` key |`rightKeypadDown`| +|`control+home` key |`rightKeypadLeft+rightKeypadUp`| +|`control+end` key |`rightKeypadLeft+rightKeypadUp`| + + + +#### Esys keyboard commands {#Eurobrailleesys} + + + +| Name |Key| +|---|---| +|Scroll braille display back |`switch1Left`| +|Scroll braille display forward |`switch1Right`| +|Move to current focus |`switch1Center`| +|Route to braille cell |`routing`| +|Report text formatting under braille cell |`doubleRouting`| +|Move to previous line in review |`joystick1Up`| +|Move to next line in review |`joystick1Down`| +|Move to previous character in review |`joystick1Left`| +|Move to next character in review |`joystick1Right`| +|`leftArrow` key |`joystick2Left`| +|`rightArrow` key |`joystick2Right`| +|`upArrow` key |`joystick2Up`| +|`downArrow` key |`joystick2Down`| +|`enter` key |`joystick2Center`| + + + +#### Esytime keyboard commands {#EurobrailleEsytime} + + + +| Name |Key| +|---|---| +|Scroll braille display back |`l1`| +|Scroll braille display forward |`l8`| +|Move to current focus |`l1+l8`| +|Route to braille cell |`routing`| +|Report text formatting under braille cell |`doubleRouting`| +|Move to previous line in review |`joystick1Up`| +|Move to next line in review |`joystick1Down`| +|Move to previous character in review |`joystick1Left`| +|Move to next character in review |`joystick1Right`| +|`leftArrow` key |`joystick2Left`| +|`rightArrow` key |`joystick2Right`| +|`upArrow` key |`joystick2Up`| +|`downArrow` key |`joystick2Down`| +|`enter` key |`joystick2Center`| +|`escape` key |`l2`| +|`tab` key |`l3`| +|Toggle `shift` key |`l4`| +|Toggle `control` key |`l5`| +|Toggle `alt` key |`l6`| +|Toggle `NVDA` key |`l7`| +|`control+home` key |`l1+l2+l3`, `l2+l3+l4`| +|`control+end` key |`l6+l7+l8`, `l5+l6+l7`| +|Toggle HID Keyboard simulation |`l1+joystick1Down`, `l8+joystick1Down`| + + + +### Nattiq nBraille Displays {#NattiqTechnologies} + +NVDA supports displays from [Nattiq Technologies](https://www.nattiq.com/) when connected via USB. +Windows 10 and later detects the Braille Displays once connected, you may need to install USB drivers if using older versions of Windows (below Win10). +You can get them from the manufacturer's website. + +Following are the key assignments for Nattiq Technologies displays with NVDA. +Please see the display's documentation for descriptions of where these keys can be found. + + +| Name |Key| +|---|---| +|Scroll braille display back |up| +|Scroll braille display forward |down| +|Move braille display to previous line |left| +|Move braille display to next line |right| +|Route to braille cell |routing| + + + +### BRLTTY {#BRLTTY} + +[BRLTTY](https://www.brltty.app/) is a separate program which can be used to support many more braille displays. +In order to use this, you need to install [BRLTTY for Windows](https://www.brltty.app/download.html). +You should download and install the latest installer package, which will be named, for example, brltty-win-4.2-2.exe. +When configuring the display and port to use, be sure to pay close attention to the instructions, especially if you are using a USB display and already have the manufacturer's drivers installed. + +For displays which have a braille keyboard, BRLTTY currently handles braille input itself. +Therefore, NVDA's braille input table setting is not relevant. + +BRLTTY is not involved in NVDA's automatic background braille display detection functionality. + +Following are the BRLTTY command assignments for NVDA. +Please see the [BRLTTY key binding lists](https://brltty.app/doc/KeyBindings/) for information about how BRLTTY commands are mapped to controls on braille displays. + + +| Name |BRLTTY command| +|---|---| +|Scroll braille display back |`fwinlt` (go left one window)| +|Scroll braille display forward |`fwinrt` (go right one window)| +|Move braille display to previous line |`lnup` (go up one line)| +|Move braille display to next line |`lndn` (go down one line)| +|Route to braille cell |`route` (bring cursor to character)| +|Toggle input help |`learn` (enter/leave command learn mode)| +|Open the NVDA menu |`prefmenu` (enter/leave preferences menu)| +|Revert configuration |`prefload` (restore preferences from disk)| +|Save configuration |`prefsave` (save preferences to disk)| +|Report time |`time` (show current date and time)| +|Speak the line where the review cursor is located |`say_line` (speak current line)| +|Say all using review cursor |`say_below` (speak from current line through bottom of screen)| + + + +### Tivomatic Caiku Albatross 46/80 {#Albatross} + +The Caiku Albatross devices, which were manufactured by Tivomatic and available in Finland, can be connected to by either USB or serial. +You do not need any specific drivers to be installed to use these displays. +Just plug in the display and configure NVDA to use it. + +Note: Baud rate 19200 is strongly recommended. +If required, switch Baud rate setting value to 19200 from the braille device's menu. +Although the driver supports 9600 baud rate, it has no way to control what baud rate the display uses. +Because 19200 is the display default baud rate, the driver tries it at first. +If baud rates are not the same, the driver may behave unexpectedly. + +Following are key assignments for these displays with NVDA. +Please see the display's documentation for descriptions of where these keys can be found. + + +| Name |Key| +|---|---| +|Move to top line in review |`home1`, `home2`| +|Move to bottom line in review |`end1`, `end2`| +|Sets the navigator object to the current focus |`eCursor1`, `eCursor2`| +|Move to current focus |`cursor1`, `cursor2`| +|Moves the mouse pointer to the current navigator object |`home1+home2`| +|Sets the navigator object to the current object under the mouse pointer and speaks it |`end1+end2`| +|Moves focus to current navigator object |`eCursor1+eCursor2`| +|Toggle braille tethered to |`cursor1+cursor2`| +|Move braille display to previous line |`up1`, `up2`, `up3`| +|Move braille display to next line |`down1`, `down2`, `down3`| +|Scroll braille display back |`left`, `lWheelLeft`, `rWheelLeft`| +|Scroll braille display forward |`right`, `lWheelRight`, `rWheelRight`| +|Route to braille cell |`routing`| +|Report text formatting under braille cell |`secondary routing`| +|Toggle the way context information is presented in braille |`attribute1+attribute3`| +|Cycles between speech modes |`attribute2+attribute4`| +|Switches to the previous review mode (e.g. object, document or screen) |`f1`| +|Switches to the next review mode (e.g. object, document or screen) |`f2`| +|Moves the navigator object to the object containing it |`f3`| +|Moves the navigator object to the first object inside it |`f4`| +|Moves the navigator object to the previous object |`f5`| +|Moves the navigator object to the next object |`f6`| +|Reports the current navigator object |`f7`| +|Reports information about the location of the text or object at the review cursor |`f8`| +|Shows braille settings |`f1+home1`, `f9+home2`| +|Reads status bar and moves navigator object into it |`f1+end1`, `f9+end2`| +|Cycle the braille cursor shape |`f1+eCursor1`, `f9+eCursor2`| +|Toggle the braille cursor |`f1+cursor1`, `f9+cursor2`| +|Cycle the braille show messages mode |`f1+f2`, `f9+f10`| +|Cycle the braille show selection state |`f1+f5`, `f9+f14`| +|Cycle the "braille move system caret when routing review cursor" states |`f1+f3`, `f9+f11`| +|Performs the default action on the current navigator object |`f7+f8`| +|Reports date/time |`f9`| +|Reports battery status and time remaining if AC is not plugged in |`f10`| +|Reports title |`f11`| +|Reports status bar |`f12`| +|Reports the current line under the application cursor |`f13`| +|Say all |`f14`| +|Reports current character under review cursor |`f15`| +|Reports the line of the current navigator object where the review cursor is situated |`f16`| +|Speaks the word of the current navigator object where the review cursor is situated |`f15+f16`| +|Moves the review cursor to the previous line of the current navigator object and speaks it |`lWheelUp`, `rWheelUp`| +|Moves the review cursor to the next line of the current navigator object and speaks it |`lWheelDown`, `rWheelDown`| +|`Windows+d` key (minimize all applications) |`attribute1`| +|`Windows+e` key (this computer) |`attribute2`| +|`Windows+b` key (focus system tray) |`attribute3`| +|`Windows+i` key (Windows settings) |`attribute4`| + + + +### Standard HID Braille displays {#HIDBraille} + +This is an experimental driver for the new Standard HID Braille Specification, agreed upon in 2018 by Microsoft, Google, Apple and several assistive technology companies including NV Access. +The hope is that all future Braille Display models created by any manufacturer, will use this standard protocol which will remove the need for manufacturer-specific Braille drivers. + +NVDA's automatic braille display detection will also recognize any display that supports this protocol. + +Following are the current key assignments for these displays. + + +| Name |Key| +|---|---| +|Scroll braille display back |pan left or rocker up| +|Scroll braille display forward |pan right or rocker down| +|Route to braille cell |routing set 1| +|Toggle braille tethered to |up+down| +|upArrow key |joystick up, dpad up or space+dot1| +|downArrow key |joystick down, dpad down or space+dot4| +|leftArrow key |space+dot3, joystick left or dpad left| +|rightArrow key |space+dot6, joystick right or dpad right| +|shift+tab key |space+dot1+dot3| +|tab key |space+dot4+dot6| +|alt key |space+dot1+dot3+dot4 (space+m)| +|escape key |space+dot1+dot5 (space+e)| +|enter key |dot8, joystick center or dpad center| +|windows key |space+dot3+dot4| +|alt+tab key |space+dot2+dot3+dot4+dot5 (space+t)| +|NVDA Menu |space+dot1+dot3+dot4+dot5 (space+n)| +|windows+d key (minimize all applications) |space+dot1+dot4+dot5 (space+d)| +|Say all |space+dot1+dot2+dot3+dot4+dot5+dot6| + + + +## Advanced Topics {#AdvancedTopics} +### Secure Mode {#SecureMode} + +System administrators may wish to configure NVDA to restrict unauthorized system access. +NVDA allows the installation of custom add-ons, which can execute arbitrary code, including when NVDA is elevated to administrator privileges. +NVDA also allows users to execute arbitrary code through the NVDA Python Console. +NVDA secure mode prevents users from modifying their NVDA configuration, and otherwise limits unauthorized system access. + +NVDA runs in secure mode when executed on [secure screens](#SecureScreens), unless the `serviceDebug` [system wide parameter](#SystemWideParameters) is enabled. +To force NVDA to always start in secure mode, set the `forceSecureMode` [system wide parameter](#SystemWideParameters). +NVDA can also be started in secure mode with the `-s` [command line option](#CommandLineOptions). + +Secure mode disables: + +* Saving configuration and other settings to disk +* Saving the gesture map to disk +* [Configuration Profile](#ConfigurationProfiles) features such as creation, deletion, renaming profiles etc. +* Loading custom configuration folders using [the `-c` command line option](#CommandLineOptions) +* Updating NVDA and creating portable copies +* The [Add-on Store](#AddonsManager) +* The [NVDA Python console](#PythonConsole) +* The [Log Viewer](#LogViewer) and logging +* The [Braille Viewer](#BrailleViewer) and [Speech Viewer](#SpeechViewer) +* Opening external documents from the NVDA menu, such as the user guide or contributors file. + +Installed copies of NVDA store their configuration including add-ons in `%APPDATA%\nvda`. +To prevent NVDA users from modifying their configuration or add-ons directly, user access to this folder must also be restricted. + +Secure mode is ineffective for portable copies of NVDA. +This limitation also applies to the temporary copy of NVDA which runs when launching the installer. +In secure environments, a user being able to run a portable executable is the same security risk regardless of secure mode. +It is expected that system administrators restrict unauthorized software from running on their systems, including portable copies of NVDA. + +NVDA users often rely on configuring their NVDA profile to suit their needs. +This may include installing and configuring custom add-ons, which should be vetted independently to NVDA. +Secure mode freezes changes to NVDA configuration, so please ensure that NVDA is configured appropriately before forcing secure mode. + +### Secure Screens {#SecureScreens} + +NVDA runs in [secure mode](#SecureMode) when executed on secure screens unless the `serviceDebug` [system wide parameter](#SystemWideParameters) is enabled. + +When running from a secure screen, NVDA uses a system profile for preferences. +NVDA user preferences can be copied [for use in secure screens](#GeneralSettingsCopySettings). + +Secure screens include: + +* The Windows sign-in screen +* The User Access Control dialog, active when performing an action as an administrator + * This includes installing programs + +### Command Line Options {#CommandLineOptions} + +NVDA can accept one or more additional options when it starts which alter its behaviour. +You can pass as many options as you need. +These options can be passed when starting from a shortcut (in the shortcut properties), from the Run dialog (Start Menu -> Run or Windows+r) or from a Windows command console. +Options should be separated from the name of NVDA's executable file and from other options by spaces. +For example, a useful option is `--disable-addons`, which tells NVDA to suspend all running add-ons. +This allows you to determine whether a problem is caused by an add-on and to recover from serious problems caused by add-ons. + +As an example, you can exit the currently running copy of NVDA by entering the following in the Run dialog: + + nvda -q + +Some of the command line options have a short and a long version, while some of them have only a long version. +For those which have a short version, you can combine them like this: + +| . {.hideHeaderRow} |.| +|---|---| +|`nvda -mc CONFIGPATH` |This will start NVDA with startup sounds and message disabled, and the specified configuration| +|`nvda -mc CONFIGPATH --disable-addons` |Same as above, but with add-ons disabled| + +Some of the command line options accept additional parameters; e.g. how detailed the logging should be or the path to the user configuration directory. +Those parameters should be placed after the option, separated from the option by a space when using the short version or an equals sign (`=`) when using the long version; e.g.: + +| . {.hideHeaderRow} |.| +|---|---| +|`nvda -l 10` |Tells NVDA to start with log level set to debug| +|`nvda --log-file=c:\nvda.log` |Tells NVDA to write its log to `c:\nvda.log`| +|`nvda --log-level=20 -f c:\nvda.log` |Tells NVDA to start with log level set to info and to write its log to `c:\nvda.log`| + +Following are the command line options for NVDA: + +| Short |Long |Description| +|---|---|---| +|`-h` |`--help` |show command line help and exit| +|`-q` |`--quit` |Quit already running copy of NVDA| +|`-k` |`--check-running` |Report whether NVDA is running via the exit code; 0 if running, 1 if not running| +|`-f LOGFILENAME` |`--log-file=LOGFILENAME` |The file where log messages should be written to. Logging is always disabled if secure mode is enabled.| +|`-l LOGLEVEL` |`--log-level=LOGLEVEL` |The lowest level of message logged (debug 10, input/output 12, debug warning 15, info 20, disabled 100). Logging is always disabled if secure mode is enabled.| +|`-c CONFIGPATH` |`--config-path=CONFIGPATH` |The path where all settings for NVDA are stored. The default value is forced if secure mode is enabled.| +|None |`--lang=LANGUAGE` |Override the configured NVDA language. Set to "Windows" for current user default, "en" for English, etc.| +|`-m` |`--minimal` |No sounds, no interface, no start message, etc.| +|`-s` |`--secure` |Starts NVDA in [Secure Mode](#SecureMode)| +|None |`--disable-addons` |Add-ons will have no effect| +|None |`--debug-logging` |Enable debug level logging just for this run. This setting will override any other log level ( `--loglevel`, `-l`) argument given, including no logging option.| +|None |`--no-logging` |Disable logging altogether while using NVDA. This setting can be overridden if a log level (`--loglevel`, `-l`) is specified from command line or if debug logging is turned on.| +|None |`--no-sr-flag` |Don't change the global system screen reader flag| +|None |`--install` |Installs NVDA (starting the newly installed copy)| +|None |`--install-silent` |Silently installs NVDA (does not start the newly installed copy)| +|None |`--enable-start-on-logon=True|False` |When installing, enable NVDA's [Use NVDA during Windows sign-in](#StartAtWindowsLogon)| +|None |`--copy-portable-config` |When installing, copy the portable configuration from the provided path (`--config-path`, `-c`) to the current user account| +|None |`--create-portable` |Creates a portable copy of NVDA (starting the newly created copy). Requires `--portable-path` to be specified| +|None |`--create-portable-silent` |Creates a portable copy of NVDA (does not start the newly installed copy). Requires `--portable-path` to be specified| +|None |`--portable-path=PORTABLEPATH` |The path where a portable copy will be created| + +### System Wide Parameters {#SystemWideParameters} + +NVDA allows some values to be set in the system registry which alter the system wide behaviour of NVDA. +These values are stored in the registry under one of the following keys: + +* 32-bit system: `HKEY_LOCAL_MACHINE\SOFTWARE\nvda` +* 64-bit system: `HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\nvda` + +The following values can be set under this registry key: + +| Name |Type |Possible values |Description| +|---|---|---|---| +|`configInLocalAppData` |DWORD |0 (default) to disable, 1 to enable |If enabled, stores the NVDA user configuration in the local application data instead of the roaming application data| +|`serviceDebug` |DWORD |0 (default) to disable, 1 to enable |If enabled, disables [Secure Mode](#SecureMode) on [secure screens](#SecureScreens). Due to several major security implications, the use of this option is strongly discouraged| +|`forceSecureMode` |DWORD |0 (default) to disable, 1 to enable |If enabled, forces [Secure Mode](#SecureMode) to be enabled when running NVDA.| + +## Further Information {#FurtherInformation} + +If you require further information or assistance regarding NVDA, please visit the [NVDA web site](NVDA_URL). +Here, you can find additional documentation, as well as technical support and community resources. +This site also provides information and resources concerning NVDA development. diff --git a/tests/markdownTranslate/en_2024.3beta6_userGuide.md b/tests/markdownTranslate/en_2024.3beta6_userGuide.md new file mode 100644 index 00000000000..22c73eb4e8d --- /dev/null +++ b/tests/markdownTranslate/en_2024.3beta6_userGuide.md @@ -0,0 +1,5110 @@ +# NVDA NVDA_VERSION User Guide + +[TOC] + + + + + +## Introduction {#Introduction} + +Welcome to NVDA! + +NonVisual Desktop Access (NVDA) is a free and open source screen reader for the Microsoft Windows operating system. +Providing feedback via synthetic speech and Braille, it enables blind or vision impaired people to access computers running Windows for no more cost than a sighted person. +NVDA is developed by [NV Access](https://www.nvaccess.org/), with contributions from the community. + +### General Features {#GeneralFeatures} + +NVDA allows blind and vision impaired people to access and interact with the Windows operating system and many third party applications. + +A short video demonstration, ["What is NVDA?"](https://www.youtube.com/watch?v=tCFyyqy9mqo) is available from the NV Access YouTube channel. + +Major highlights include: + +* Support for popular applications including web browsers, email clients, internet chat programs and office suites +* Built-in speech synthesizer supporting over 80 languages +* Reporting of textual formatting where available such as font name and size, style and spelling errors +* Automatic announcement of text under the mouse and optional audible indication of the mouse position +* Support for many refreshable braille displays, including the ability to detect many of them automatically as well as braille input on braille displays with a braille keyboard +* Ability to run entirely from a USB flash drive or other portable media without the need for installation +* Easy to use talking installer +* Translated into 54 languages +* Support for modern Windows Operating Systems including both 32 and 64 bit variants +* Ability to run during Windows sign-in and [other secure screens](#SecureScreens). +* Announcing controls and text while using touch gestures +* Support for common accessibility interfaces such as Microsoft Active Accessibility, Java Access Bridge, IAccessible2 and UI Automation +* Support for Windows Command Prompt and console applications +* The ability to highlight the system focus + +### System Requirements {#SystemRequirements} + +#### Recommended System Requirements {#MinimumSystemRequirements} +* Operating Systems: 64-bit editions of Windows 10, Windows 11, and Window Server 2022 + * both AMD64 and ARM64 variants of Windows are supported. +* at least 150 MB of storage space. +* at least 4 GB of RAM. + +#### Minimum System Requirements {#MinimumSystemRequirements} +* Operating Systems: all 32-bit and 64-bit editions of Windows 8.1, Windows 10, Windows 11, and all Server Operating Systems starting from Windows Server 2012 R2. + * both AMD64 and ARM64 variants of Windows are supported. + * Note 32-bit operating systems are no longer under active support. + * Note that Windows 8.1 and Windows Server versions older than 2022 are no longer under active support. +* at least 150 MB of storage space. + +### Internationalization {#Internationalization} + +It is important that people anywhere in the world, no matter what language they speak, get equal access to technology. +Besides English, NVDA has been translated into 54 languages including: Afrikaans, Albanian, Amharic, Arabic, Aragonese, Bulgarian, Burmese, Catalan, Chinese (simplified and traditional), Croatian, Czech, Danish, Dutch, Farsi, Finnish, French, Galician, Georgian, German (Germany and Switzerland), Greek, Hebrew, Hindi, Hungarian, Icelandic, Irish, Italian, Japanese, Kannada, Korean, Kyrgyz, Lithuanian, Macedonian, Mongolian, Nepali, Norwegian, Polish, Portuguese (Brazil and Portugal), Punjabi, Romanian, Russian, Serbian, Slovak, Slovenian, Spanish (Colombia and Spain), Swedish, Tamil, Thai, Turkish, Ukrainian and Vietnamese. + +### Speech Synthesizer Support {#SpeechSynthesizerSupport} + +Apart from providing its messages and interface in several languages, NVDA can also enable the user to read content in any language, as long as they have a speech synthesizer that can speak that language. + +NVDA is bundled with [eSpeak NG](https://github.com/espeak-ng/espeak-ng), a free, open-source, multi-lingual speech synthesizer. + +Information about other speech synthesizers that NVDA supports can be found in the [Supported Speech Synthesizers](#SupportedSpeechSynths) section. + +### Braille support {#BrailleSupport} + +For users that own a refreshable braille display, NVDA can output its information in braille. +NVDA uses the open source braille translator [LibLouis](https://liblouis.io/) to generate braille sequences from text. +Both uncontracted and contracted braille input via a braille keyboard is also supported. +Furthermore, NVDA will detect many braille displays automatically by default. +Please see the [Supported Braille Displays](#SupportedBrailleDisplays) section for information about the supported braille displays. + +NVDA supports braille codes for many languages, including contracted, uncontracted and computer braille codes. + +### License and Copyright {#LicenseAndCopyright} + +NVDA is copyright NVDA_COPYRIGHT_YEARS NVDA contributors. + +NVDA is available under the GNU General Public License version 2, with two special exceptions. +The exceptions are outlined in the license document under the sections "Non-GPL Components in Plugins and Drivers" and "Microsoft Distributable Code". +NVDA also includes and uses components which are made available under different free and open source licenses. +You are free to share or change this software in any way you like as long as it is accompanied by the license and you make all source code available to anyone who wants it. +This applies to both original and modified copies of this software, plus any derivative works. + +For further details, you can [view the full license.](https://www.gnu.org/licenses/old-licenses/gpl-2.0.html) +For details regarding exceptions, access the license document from the NVDA menu under the "help" section. + +## NVDA Quick Start Guide {#NVDAQuickStartGuide} + +This quick start guide contains three main sections: downloading, initial setup, and running NVDA. +These are followed by information on adjusting preferences, using add-ons, participating in the community and getting help. +The information in this guide is condensed from other parts of the NVDA User Guide. +Please refer to the full User Guide for more detailed information on each topic. + +### Downloading NVDA {#GettingAndSettingUpNVDA} + +NVDA is completely free for anyone to use. +There is no license key to worry about or expensive subscription to pay. +NVDA is updated, on average, four times per year. +The latest version of NVDA is always available from the "Download" page of the [NV Access website](NVDA_URL). + +NVDA works with all recent versions of Microsoft Windows. +Check the [System Requirements](#SystemRequirements) for full details. + +#### Steps for Downloading NVDA {#StepsForDownloadingNVDA} + +These steps assume some familiarity with navigating a web page. + +* Open your web browser (Press the `Windows` key, type the word "internet" without quotes, and press `enter`) +* Load the NV Access download page (Press `alt+d`, type the following address and press `enter`): +https://www.nvaccess.org/download +* Activate the "download" button +* The browser may or may not prompt for an action after downloading, and then start the download +* Depending on the browser, the file may run automatically after it downloads +* If the file needs to be manually launched, press `alt+n` to move to the notification area, then `alt+r` to run the file (or the steps for your browser) + +### Setting up NVDA {#SettingUpNVDA} + +Running the file you have just downloaded will start a temporary copy of NVDA. +You will then be asked if you want to install NVDA, create a portable copy or just continue using the temporary copy. + +NVDA does not need access to the Internet to run or install once the launcher is downloaded. +If available, an internet connection does enable NVDA to check for updates periodically. + +#### Steps for running the downloaded launcher {#StepsForRunningTheDownloadLauncher} + +The setup file is named "nvda_2022.1.exe" or similar. +The year and version changes between updates to reflect the current release. + +1. Run the downloaded file. +Music plays while a temporary copy of NVDA loads. +Once loaded, NVDA will speak throughout the rest of the process. +1. The NVDA Launcher window appears with the license agreement. +Press `downArrow` to read the license agreement if desired. +1. Press `tab` to move to the "I agree" checkbox, then press the `spacebar` to check it. +1. Press `tab` to move through the options, then press `enter` on the desired option. + +The options are: + +* "Install NVDA on this computer": This is the main option most users want for easy use of NVDA. +* "Create portable copy": This allows NVDA to be setup in any folder without installing. +This is useful on computers without admin rights, or on a memory stick to carry with you. +When selected, NVDA walks through the steps to create a portable copy. +The main thing NVDA needs to know is the folder to setup the portable copy in. +* "Continue running": This keeps the temporary copy of NVDA running. +This is useful for testing features in a new version before installing it. +When selected, the launcher window closes and the temporary copy of NVDA continues running until it is exited or the PC is shut down. +Note that changes to settings are not saved. +* "Cancel": This closes NVDA without performing any action. + +If you plan to always use NVDA on this computer, you will want to choose to install NVDA. +Installing NVDA will allow for additional functionality such as automatic starting after sign-in, the ability to read the Windows sign-in and [secure screens](#SecureScreens). +These cannot be done with portable and temporary copies. +For full details of the limitations when running a portable or temporary copy of NVDA, please see [Portable and temporary copy restrictions](#PortableAndTemporaryCopyRestrictions). + +Installing also offers to create Start Menu and desktop shortcuts, and allow NVDA to be started with `control+alt+n`. + +#### Steps for installing NVDA from the launcher {#StepsForInstallingNVDAFromTheLauncher} + +These steps walk through the most common setup options. +For more details on the options available, please see [Installation options](#InstallingNVDA). + +1. From the launcher, ensure the checkbox to agree to the license is checked. +1. `Tab` to, and activate the "Install NVDA on this computer" button. +1. Next, are options to use NVDA during Windows sign-in and to create a desktop shortcut. +These are checked by default. +If desired, press `tab` and `spaceBar` to change any of these options, or leave them at the default. +1. Press `enter` to continue. +1. A Windows "User Account Control (UAC)" dialog appears asking "Do you want to allow this app to make changes to your PC?". +1. Press `alt+y` to accept the UAC prompt. +1. A progress bar fills up as NVDA installs. +During this process NVDA sounds an increasingly higher pitched beep. +This process is often fast and may not be noticed. +1. A dialog box appears confirm that the install of NVDA has been successful. +The message advises to "Press OK to start the installed copy". +Press `enter` to start the installed copy. +1. The "Welcome to NVDA" dialog appears, and NVDA reads a welcome message. +The focus is on the "Keyboard Layout" drop-down. +By default, "Desktop" keyboard layout uses the number pad for some function. +If desired, press `downArrow` to choose "Laptop" keyboard layout to reassign number pad functions to other keys. +1. Press `tab` to move to "Use `capsLock` as an NVDA modifier key". +`Insert` is set as the NVDA modifier key by default. +Press `spaceBar` to select `capsLock` as an alternate modifier key. +Note that the keyboard layout is set separately from the NVDA modifier key. +The NVDA key and keyboard layout can be changed later from the Keyboard Settings. +1. Use `tab` and `spaceBar` to adjust the other options on this screen. +These set whether NVDA starts automatically. +1. Press `enter` to close the dialog box with NVDA now running. + +### Running NVDA {#RunningNVDA} + +The full NVDA user guide has all the NVDA commands, split up into different sections for reference. +The tables of commands are also available in the "Commands Quick Reference". +The "Basic Training for NVDA" NVDA training module has each command in more depth with step-by-step activities. +"Basic Training for NVDA" is available from the [NV Access Shop](http://www.nvaccess.org/shop). + +Here are some basic commands which are used frequently. +All commands are configurable, so these are the default keystrokes for these functions. + +#### The NVDA Modifier Key {#NVDAModifierKey} + +The default NVDA modifier key is either the `numpadZero`, (with `numLock` off), or the `insert` key, near the `delete`, `home` and `end` keys. +The NVDA modifier key can also be set to the `capsLock` key. + +#### Input Help {#InputHelp} + +To learn and practice the location of keys, press `NVDA+1` to turn Input help on. +While in input help mode, performing any input gesture (such as pressing a key or performing a touch gesture) will report the action and describe what it does (if anything). +The actual commands will not execute while in input help mode. + +#### Starting and stopping NVDA {#StartingAndStoppingNVDA} + +| Name |Desktop key |Laptop key |Description| +|---|---|---|---| +|Start NVDA |`control+alt+n` |`control+alt+n` |Starts or restarts NVDA| +|Exit NVDA |`NVDA+q`, then `enter` |`NVDA+q`, then `enter` |Exits NVDA| +|Pause or restart speech |`shift` |`shift` |Instantly pauses speech. Pressing it again will continue speaking where it left off| +|Stop speech |`control` |`control` |Instantly stops speaking| + +#### Reading text {#ReadingText} + +| Name |Desktop key |Laptop key |Description| +|---|---|---|---| +|Say all |`NVDA+downArrow` |`NVDA+a` |Starts reading from the current position, moving it along as it goes| +|Read current line |`NVDA+upArrow` |`NVDA+l` |Reads the line. Pressing twice spells the line. Pressing three times spells the line using character descriptions (Alpha, Bravo, Charlie, etc)| +|Read selection |`NVDA+shift+upArrow` |`NVDA+shift+s` |Reads any selected text. Pressing twice will spell the information. Pressing three times will spell it using character description| +|Read clipboard text |`NVDA+c` |`NVDA+c` |Reads any text on the clipboard. Pressing twice will spell the information. Pressing three times will spell it using character description| + +#### Reporting location and other information {#ReportingLocation} + +| Name |Desktop key |Laptop key |Description| +|---|---|---|---| +|Window title |`NVDA+t` |`NVDA+t` |Reports the title of the currently active window. Pressing twice will spell the information. Pressing three times will copy it to the clipboard| +|Report focus |`NVDA+tab` |`NVDA+tab` |Reports the current control which has focus. Pressing twice will spell the information. Pressing three times will spell it using character description| +|Read window |`NVDA+b` |`NVDA+b` |Reads the entire current window (useful for dialogs)| +|Read status bar |`NVDA+end` |`NVDA+shift+end` |Reports the Status Bar if NVDA finds one. Pressing twice will spell the information. Pressing three times will copy it to the clipboard| +|Read time |`NVDA+f12` |`NVDA+f12` |Pressing once reports the current time, pressing twice reports the date. The time and date are reported in the format specified in Windows settings for the system tray clock.| +|Report text formatting |`NVDA+f` |`NVDA+f` |Reports text formatting. Pressing twice shows the information in a window| +|Report link destination |`NVDA+k` |`NVDA+k` |Pressing once speaks the destination URL of the link at the current caret or focus position. Pressing twice shows it in a window for more careful review| + +#### Toggle which information NVDA reads {#ToggleWhichInformationNVDAReads} + +| Name |Desktop key |Laptop key |Description| +|---|---|---|---| +|Speak typed characters |`NVDA+2` |`NVDA+2` |When enabled, NVDA will announce all characters you type on the keyboard.| +|Speak typed words |`NVDA+3` |`NVDA+3` |When enabled, NVDA will announce word you type on the keyboard.| +|Speak command keys |`NVDA+4` |`NVDA+4` |When enabled, NVDA will announce all non-character keys you type on the keyboard. This includes key combinations such as control plus another letter.| +|Enable mouse tracking |`NVDA+m` |`NVDA+m` |When enabled, NVDA will announce the text currently under the mouse pointer, as you move it around the screen. This allows you to find things on the screen, by physically moving the mouse, rather than trying to find them through object navigation.| + +#### The synth settings ring {#TheSynthSettingsRing} + +| Name |Desktop key |Laptop key |Description| +|---|---|---|---| +|Move to next synth setting |`NVDA+control+rightArrow` |`NVDA+shift+control+rightArrow` |Moves to the next available speech setting after the current, wrapping around to the first setting again after the last| +|Move to previous synth setting |`NVDA+control+leftArrow` |`NVDA+shift+control+leftArrow` |Moves to the next available speech setting before the current, wrapping around to the last setting after the first| +|Increment current synth setting |`NVDA+control+upArrow` |`NVDA+shift+control+upArrow` |increases the current speech setting you are on. E.g. increases the rate, chooses the next voice, increases the volume| +|Increment the current synth setting in larger steps |`NVDA+control+pageUp` |`NVDA+shift+control+pageUp` |Increases the value of the current speech setting you're on in larger steps. e.g. when you're on a voice setting, it will jump forward every 20 voices; when you're on slider settings (rate, pitch, etc) it will jump forward the value up to 20%| +|Decrement current synth setting |`NVDA+control+downArrow` |`NVDA+shift+control+downArrow` |decreases the current speech setting you are on. E.g. decreases the rate, chooses the previous voice, decreases the volume| +|Decrement the current synth setting in larger steps |`NVDA+control+pageDown` |`NVDA+shift+control+pageDown` |Decreases the value of the current speech setting you're on in larger steps. e.g. when you're on a voice setting, it will jump backward every 20 voices; when you're on a slider setting, it will jump backward the value up to 20%.| + +It is also possible to set the first or last value of the current synth setting by assign custom gestures in [Input Gestures dialog](#InputGestures), under the speech category. +This means, for example, when you're on a rate setting, it will set the rate to 0 or 100. +When you're on a voice setting, it will set the first or last voice. + +#### Web navigation {#WebNavigation} + +The full list of Single Letter Navigation keys is in the [Browse Mode](#BrowseMode) section of the user guide. + +| Command |Keystroke |Description| +|---|---|---| +|Heading |`h` |Move to the next heading| +|Heading level 1, 2, or 3 |`1`, `2`, `3` |Move to the next heading at the specified level| +|Form field |`f` |Move to the next form field (edit box, button, etc)| +|Link |`k` |Move to the next link| +|Landmark |`d` |Move to the next landmark| +|List |`l` |Move to the next list| +|Table |`t` |Move to the next table| +|Move backwards |`shift+letter` |Press `shift` and any of the above letters to move to the previous element of that type| +|Elements list |`NVDA+f7` |Lists various types of elements, such as links and headings| + +### Preferences {#Preferences} + +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 general 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. + +### Add-ons {#Addons} +Add-ons are programs which provide new or changed functionality for NVDA. +Add-ons are developed by the NVDA community, or external companies and are unaffiliated with NV Access. +As with any software, it is important to trust the developer of an add-on before using it. +Please refer to [Installing Add-ons](#AddonStoreInstalling) for ways to verify add-ons prior to installation. + +The first time the Add-on Store is opened, NVDA displays a warning about add-ons. +Add-ons are not vetted by NV Access and may have unrestricted functionality and access to information. +Press `spacebar` if you have read the warning and do not need to see it next time. +Press `tab` to reach the "OK" button, then `enter` to accept the warning and proceed to the Add-on Store. +The "[Add-ons and the Add-on Store](#AddonsManager)" section of the User Guide contains information about every feature of the Add-on Store. + +The Add-on Store is available from the Tools menu. +Press `NVDA+n` to open the NVDA menu, then `t` for tools, then `a` for Add-on Store. +When the Add-on Store opens, it shows "Available add-ons" if no add-ons are installed. +When add-ons are installed, the Add-on Store opens to the "Installed add-ons" tab. + +#### Available add-ons {#AvailableAddons} +When the window first opens, add-ons may take a few seconds to load. +NVDA will read the name of the first add-on once the list of add-ons finishes loading. +Available add-ons are listed alphabetically in a multi-column list. +To browse the list and find out about a specific add-on: + +1. Use the arrow keys or press the first letter of an add-on name to move around the list. +1. Press `tab` once to move to a description of the currently selected add-on. +1. Use the [reading keys](#ReadingText) or arrow keys to read the full description. +1. Press `tab` to the "Actions" button, which can be used to install the add-on, among other actions. +1. Press `tab` to "Other Details", which lists details such as the publisher, version and homepage. +1. To return to the list of add-ons, press `alt+a`, or `shift+tab` until reaching the list. + +#### Searching for add-ons {#SearchingForAddons} +As well as browsing all available add-ons, it is possible to filter the add-ons shown. +To search, press `alt+s` to jump to the "Search" field and type the text to search for. +Searching checks for matches in the add-on ID, display name, publisher, author and description fields. +The list updates while typing the search terms. +Once done, press `tab` to go to the filtered list of add-ons and browse the results. + +#### Installing add-ons {#InstallingAddons} + +To install an add-on: + +1. With the focus on an add-on you would like to install, press `enter`. +1. The actions menu opens with a list of actions; the first action is "Install". +1. To install the add-on, press `i` or `downArrow` to "Install" and press `enter`. +1. The focus returns to the add-on in the list and NVDA will read the details about the add-on. +1. The "Status" information reported by NVDA changes from "Available" to "Downloading". +1. Once the add-on has finished downloading, it will change to "Downloaded. Pending install". +1. Repeat with any other add-ons you would like to install at the same time. +1. Once finished, press `tab` until the focus is on the "Close" button, then press `enter`. +1. The downloaded add-ons will start the installation process once the Add-on Store is closed. +During the installation process, add-ons may display dialogs that you will need to respond to. +1. When the add-ons have been installed, a dialog appears advising that changes were made, and you must restart NVDA for the add-on installation to complete. +1. Press `enter` to restart NVDA. + +#### Managing installed add-ons {#ManagingInstalledAddons} +Press `control+tab` to move between the tabs of the Add-on Store. +The tabs include: "Installed add-ons", "Updatable add-ons", "Available add-ons" and "Installed incompatible add-ons". +Each of the tabs are set out similar to each other, as a list of add-ons, a panel for more details on the selected add-on, and a button to perform actions for the selected add-on. +The actions menu of installed add-ons includes "Disable" and "Remove" rather than "Install". +Disabling an add-on stops NVDA from loading it, but leaves it installed. +To re-enable a disabled add-on, activate "Enable" from the actions menu. +After enabling, disabling, or removing add-ons, you will be prompted to restart NVDA when closing the Add-on Store. +These changes will only take effect once NVDA is restarted. +Note that in the Add-on Store window `escape` works the same as the Close button. + +#### Updating add-ons {#UpdatingAddons} +When an update to an add-on you have installed is available, it will be listed in the "Updatable add-ons" tab. +Press `control+tab` to get to this tab from anywhere in the Add-on Store. +The status of the add-on will be listed as "Update available". +The list will display the currently installed version and the available version. +Press `enter` on the add-on to open the actions list; choose "Update". + +By default, after NVDA startup, you will be notified if any add-on updates are available. +To learn more about and configure this behaviour, refer to ["Update Notifications"](#AutomaticAddonUpdates). + +### Community {#Community} + +NVDA has a vibrant user community. +There is a main [English language email list](https://nvda.groups.io/g/nvda) and a page full of [local language groups](https://github.com/nvaccess/nvda/wiki/Connect). +NV Access, makers of NVDA, are active on [Twitter](https://twitter.com/nvaccess) and [Facebook](https://www.facebook.com/NVAccess). +NV Access also have a regular [In-Process blog](https://www.nvaccess.org/category/in-process/). + +There is also an [NVDA Certified Expert](https://certification.nvaccess.org/) program. +This is an online exam you can complete to demonstrate your skills in NVDA. +[NVDA Certified Experts](https://certification.nvaccess.org/) can list their contact and relevant business details. + +### Getting help {#GettingHelp} + +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](https://www.nvaccess.org/shop). + +We recommend starting with the "Basic Training for NVDA module". +This module covers concepts from getting started up to browsing the web and using object navigation. +It is available in: + +* [Electronic text](https://www.nvaccess.org/product/basic-training-for-nvda-ebook/), which includes Word DOCX, Web page HTML, eBook ePub and Kindle KFX formats. +* [Human-read, MP3 audio](https://www.nvaccess.org/product/basic-training-for-nvda-downloadable-audio/) +* [Hard-copy UEB Braille](https://www.nvaccess.org/product/basic-training-for-nvda-braille-hard-copy/) with delivery included anywhere in the world. + +Other modules, and the discounted [NVDA Productivity Bundle](https://www.nvaccess.org/product/nvda-productivity-bundle/), are available in the [NV Access Shop](https://www.nvaccess.org/shop/). + +NV Access also sells [telephone support](https://www.nvaccess.org/product/nvda-telephone-support/), either in blocks, or as part of the [NVDA Productivity Bundle](https://www.nvaccess.org/product/nvda-productivity-bundle/). +Telephone support includes local numbers in Australia and the USA. + +The [email user groups](https://github.com/nvaccess/nvda/wiki/Connect) are a great source of community help, as are [certified NVDA experts](https://certification.nvaccess.org/). + +You can make bug reports or feature requests via [GitHub](https://github.com/nvaccess/nvda/blob/master/projectDocs/issues/readme.md). +The [contribution guidelines](https://github.com/nvaccess/nvda/blob/master/.github/CONTRIBUTING.md) contain valuable information for contributing to the community. + +## More Setup Options {#MoreSetupOptions} +### Installation Options {#InstallingNVDA} + +If installing NVDA directly from the downloaded NVDA launcher, press the Install NVDA button. +If you have already closed this dialog or are wanting to install from a portable copy, please choose the Install NVDA menu item found under Tools in the NVDA menu. + +The installation dialog that appears will confirm whether you wish to install NVDA and will also tell you whether this installation will be updating a previous install. +Pressing the Continue button will start installing NVDA. +There are also a few options in this dialog which are explained below. +Once the installation has completed, a message will appear telling you that it was successful. +Pressing OK at this point will restart the newly installed copy of NVDA. + +#### Incompatible add-ons warning {#InstallWithIncompatibleAddons} + +If you have add-ons already installed there may also be a warning that incompatible add-ons will be disabled. +Before you're able to press the Continue button you will have to use the checkbox to confirm that you understand that these add-ons will be disabled. +There will also be a button present to review the add-ons that will be disabled. +Refer to the [incompatible add-ons dialog section](#incompatibleAddonsManager) for more help on this button. +After installation, you are able to re-enable incompatible add-ons at your own risk from within the [Add-on Store](#AddonsManager). + +#### Use NVDA during sign-in {#StartAtWindowsLogon} + +This option allows you to choose whether or not NVDA should automatically start while at the Windows sign-in screen, before you have entered a password. +This also includes User Account Control and [other secure screens](#SecureScreens). +This option is enabled by default for fresh installations. + +#### Create Desktop Shortcut (ctrl+alt+n) {#CreateDesktopShortcut} + +This option allows you to choose whether or not NVDA should create a shortcut on the desktop to start NVDA. +If created, this shortcut will also be assigned a shortcut key of `control+alt+n`, allowing you to start NVDA at any time with this keystroke. + +#### Copy Portable Configuration to Current User Account {#CopyPortableConfigurationToCurrentUserAccount} + +This option allows you to choose whether or not NVDA should copy the user configuration from the currently running NVDA into the configuration for the currently logged on user, for the installed copy of NVDA. +This will not copy the configuration for any other users of this system nor to the system configuration for use during Windows sign-in and [other secure screens](#SecureScreens). +This option is only available when installing from a portable copy, not when installing directly from the downloaded Launcher package. + +### Creating a Portable Copy {#CreatingAPortableCopy} + +If creating a portable copy directly from the NVDA download package, press the Create Portable Copy button. +If you have already closed this dialog or you are running an installed copy of NVDA, choose the Create Portable copy menu item found under Tools in the NVDA menu. + +The dialog that appears allows you to choose where the portable copy should be created. +This can be a directory on your hard drive or a location on a USB thumb drive or other portable media. +By default, a new directory is created for the portable copy. +You can also choose to use an existing directory, this will overwrite files in the directory. +If the existing directory is a portable copy of NVDA, that copy will be updated. + +There is also an option to choose whether NVDA should copy the logged on user's current NVDA configuration for use with the newly created portable copy. +This also includes add-ons. +This option is only available when creating a portable copy from an installed copy, not when creating from the download package. + +Pressing Continue will create the portable copy. +Once creation is complete, a message will appear telling you it was successful. +Press OK to dismiss this dialog. + +### Portable and Temporary Copy Restrictions {#PortableAndTemporaryCopyRestrictions} + +If you want to take NVDA with you on a USB thumb drive or other writable media, then you should choose to create a portable copy. +The installed copy is also able to create a portable copy of itself at any time. +The portable copy also has the ability to install itself on any computer at a later time. +However, if you wish to copy NVDA onto read-only media such as a CD, you should just copy the download package. +Running the portable version directly from read-only media is not supported at this time. + +The [NVDA installer](#StepsForRunningTheDownloadLauncher) can be used as a temporary copy of NVDA. +Temporary copies prevent saving NVDA settings. +This includes disabling usage of the [Add-on Store](#AddonsManager). + +Portable and temporary copies of NVDA have the following restrictions: + +* The inability to automatically start during and/or after log-on. +* The inability to interact with applications running with administrative privileges, unless of course NVDA itself has been run also with these privileges (not recommended). +* The inability to read User Account Control (UAC) screens when trying to start an application with administrative privileges. +* The inability to support input from a touchscreen. +* The inability to provide features such as browse mode and speaking of typed characters in Windows Store apps. +* Audio ducking is not supported. + +## Using NVDA {#GettingStartedWithNVDA} +### Launching NVDA {#LaunchingNVDA} + +If you have installed NVDA with the installer, then starting NVDA is as simple as either pressing control+alt+n, or choosing NVDA from the NVDA menu under Programs on the Start Menu. +Additionally you can type NVDA into the Run dialog and press Enter. +If NVDA is already running, it will be restarted. +You can also pass some [command line options](#CommandLineOptions) which allows you to quit (-q), disable add-ons (--disable-addons), etc. + +For installed copies, NVDA stores the configuration in the roaming application data folder of the current user by default (e.g. "`C:\Users\\AppData\Roaming`"). +It is possible to change this in a way that NVDA loads its configuration from the local application data folder instead. +Consult the section about [system wide parameters](#SystemWideParameters) for more details. + +To start the portable version, go to the directory you unpacked NVDA to, and press enter or double click on nvda.exe. +If NVDA was already running, it will automatically stop before starting the portable version. + +As NVDA starts, you will first hear an ascending set of tones (telling you that NVDA is loading). +Depending on how fast your computer is, or if you are running NVDA off a USB key or other slow media, it may take a little while to start. +If it is taking an extra-long time to start, NVDA should say "Loading NVDA. Please wait..." + +If you don't hear any of this, or you hear the Windows error sound, or a descending set of tones, then this means that NVDA has an error, and you will need to possibly report a bug to the developers. +Please check out the NVDA website for how to do this. + +#### Welcome Dialog {#WelcomeDialog} + +When NVDA starts for the first time, you will be greeted by a dialog box which provides you with some basic information about the NVDA modifier key and the NVDA menu. +(Please see further sections about these topics.) +The dialog box also contains a combo box and three checkboxes. +The combo box lets you select the keyboard layout. +The first checkbox lets you control if NVDA should use the Caps Lock as an NVDA modifier key. +The second specifies whether NVDA should start automatically after you log on to Windows and is only available for installed copies of NVDA. +The third lets you control if this Welcome dialog should appear each time NVDA starts. + +#### Data usage statistics dialog {#UsageStatsDialog} + +When starting NVDA for the first time, a dialog will appear which will ask you if you want to accept sending data to NV Access while using NVDA, in order to help improve NVDA in the future. +You can read more info about the data gathered by NV Access in the general settings section, [Allow NV Access to gather NVDA usage statistics](#GeneralSettingsGatherUsageStats). +Note: pressing on "yes" or "no" will save this setting and the dialog will never appear again unless you reinstall NVDA. +However, you can enable or disable the data gathering process manually in NVDA's general settings panel. For changing this setting manually, you can check or uncheck the checkbox called [Allow the NVDA project to gather NVDA usage statistics](#GeneralSettingsGatherUsageStats). + +### About NVDA keyboard commands {#AboutNVDAKeyboardCommands} +#### The NVDA Modifier Key {#TheNVDAModifierKey} + +Most NVDA-specific keyboard commands consist of pressing a particular key called the NVDA modifier key in conjunction with one or more other keys. +Notable exceptions to this are the text review commands for the desktop keyboard layout which just use the numpad keys by themselves, but there are some other exceptions as well. + +NVDA can be configured so that the `insert`, `numpadInsert`, and/or `capsLock` key can be used as the `NVDA` modifier key. +By default, both the `insert` and `numpadInsert` keys are set as NVDA modifier keys. + +If you wish to cause one of the NVDA modifier keys to behave as it usually would if NVDA were not running (e.g. you wish to turn Caps Lock on when you have set Caps Lock to be an NVDA modifier key), you can press the key twice in quick succession. + +#### Keyboard Layouts {#KeyboardLayouts} + +NVDA currently comes with two sets of key commands (known as keyboard layouts): the desktop layout and the laptop layout. +By default, NVDA is set to use the Desktop layout, though you can switch to the Laptop layout in the Keyboard category of the [NVDA Settings](#NVDASettings) dialog, found under Preferences in the NVDA menu. + +The Desktop layout makes heavy use of the numpad (with Num Lock off). +Although most laptops do not have a physical numpad, some laptops can emulate one by holding down the FN key and pressing letters and numbers on the right-hand side of the keyboard (7, 8, 9, u, i, o, j, k, l, etc.). +If your laptop cannot do this or does not allow you to turn Num Lock off, you may want to switch to the Laptop layout instead. + +### NVDA Touch Gestures {#NVDATouchGestures} + +If you are running NVDA on a device with a touchscreen, you can also control NVDA directly via touch commands. +While NVDA is running, unless touch interaction support is disabled, all touch input will go directly to NVDA. +Therefore, actions that can be performed normally without NVDA will not work. + +To toggle touch interaction support, press NVDA+control+alt+t. + +You can also enable or disable [touch interaction support](#TouchSupportEnable) from the Touch Interaction category of the NVDA settings. + +#### Exploring the Screen {#ExploringTheScreen} + +The most basic action you can perform with the touch screen is to announce the control or text at any point on the screen. +To do this, place one finger anywhere on the screen. +You can also keep your finger on the screen and move it around to read other controls and text that your finger moves over. + +#### Touch Gestures {#TouchGestures} + +When NVDA commands are described later in this user guide, they may list a touch gesture which can be used to activate that command with the touchscreen. +Following are some instructions on how to perform the various touch gestures. + +##### Taps {#Taps} + +Tap the screen quickly with one or more fingers. + +Tapping once with one finger is simply known as a tap. +Tapping with 2 fingers at the same time is a 2-finger tap and so on. + +If the same tap is performed one or more times again in quick succession, NVDA will instead treat this as a multi-tap gesture. +Tapping twice will result in a double-tap. +Tapping 3 times will result in a triple-tap and so on. +Of course, these multi-tap gestures also recognize how many fingers were used, so it's possible to have gestures like a 2-finger triple-tap, a 4-finger tap, etc. + +##### Flicks {#Flicks} + +Quickly swipe your finger across the screen. + +There are 4 possible flick gestures depending on the direction: flick left, flick right, flick up and flick down. + +Just like taps, more than one finger can be used to perform the gesture. +Therefore, gestures such as 2-finger flick up and 4-finger flick left are all possible. + +#### Touch Modes {#TouchModes} + +As there are many more NVDA commands than possible touch gestures, NVDA has several touch modes you can switch between which make certain subsets of commands available. +The two modes are text mode and object mode. +Certain NVDA commands listed in this document may have a touch mode listed in brackets after the touch gesture. +For example, flick up (text mode) means that the command will be performed if you flick up, but only while in text mode. +If the command does not have a mode listed, it will work in any mode. + + +To toggle touch modes, perform a 3-finger tap. + + +#### Touch keyboard {#TouchKeyboard} + +The touch keyboard is used to enter text and commands from a touchscreen. +When focused on an edit field, you can bring up the touch keyboard by double-tapping the touch keyboard icon on the bottom of the screen. +For tablets such as Microsoft Surface Pro, the touch keyboard is always available when the keyboard is undocked. +To dismiss the touch keyboard, double-tap the touch keyboard icon or move away from the edit field. + +While the touch keyboard is active, to locate keys on the touch keyboard, move your finger to where the touch keyboard is located (typically at the bottom of the screen), then move around the keyboard with one finger. +When you find the key you wish to press, double-tap the key or lift your finger, depending on options chosen from the [Touch Interaction Settings category](#TouchInteraction) of the NVDA Settings. + +### Input Help Mode {#InputHelpMode} + +Many NVDA commands are mentioned throughout the rest of this user guide, but an easy way to explore all the different commands is to turn on input help. + +To turn on input help, press NVDA+1. +To turn it off, press NVDA+1 again. +While in input help, performing any input gesture (such as pressing a key or performing a touch gesture) will report the action and describe what it does (if anything). +The actual commands will not execute while in input help mode. + +### The NVDA menu {#TheNVDAMenu} + +The NVDA menu allows you to control NVDA's settings, access help, save/revert your configuration, Modify speech dictionaries, access additional tools and exit NVDA. + +To get to the NVDA menu from anywhere in Windows while NVDA is running, you may do any of the following: + +* press `NVDA+n` on the keyboard. +* Perform a 2-finger double-tap on the touch screen. +* Access the system tray by pressing `Windows+b`, `downArrow` to the NVDA icon, and press `enter`. +* Alternatively, access the system tray by pressing `Windows+b`, `downArrow` to the NVDA icon, and open the context menu by pressing the `applications` key located next to the right control key on most keyboards. +On a keyboard without an `applications` key, press `shift+f10` instead. +* Right-click on the NVDA icon located in the Windows system tray + +When the menu comes up, You can use the arrow keys to navigate the menu, and the `enter` key to activate an item. + +### Basic NVDA commands {#BasicNVDACommands} + + + +| Name |Desktop key |Laptop key |Touch |Description| +|---|---|---|---|---| +|Starts or restarts NVDA |Control+alt+n |Control+alt+n |none |Starts or restarts NVDA from the Desktop, if this Windows shortcut is enabled during NVDA's installation process. This is a Windows specific shortcut and therefore it cannot be reassigned in the input gestures dialog.| +|Stop speech |Control |control |2-finger tap |Instantly stops speaking| +|Pause Speech |shift |shift |none |Instantly pauses speech. Pressing it again will continue speaking where it left off (if pausing is supported by the current synthesizer)| +|NVDA Menu |NVDA+n |NVDA+n |2-finger double-tap |Pops up the NVDA menu to allow you to access preferences, tools, help, etc.| +|Toggle Input Help Mode |NVDA+1 |NVDA+1 |none |Pressing any key in this mode will report the key, and the description of any NVDA command associated with it| +|Quit NVDA |NVDA+q |NVDA+q |none |Exits NVDA| +|Pass next key through |NVDA+f2 |NVDA+f2 |none |Tells NVDA to pass the next key press straight through to the active application - even if it is normally treated as an NVDA key command| +|Toggle application sleep mode on and off |NVDA+shift+s |NVDA+shift+z |none |sleep mode disables all NVDA commands and speech/braille output for the current application. This is most useful in applications that provide their own speech or screen reading features. Press this command again to disable sleep mode - note that NVDA will only retain the Sleep Mode setting until it is restarted.| + + + +### Reporting System Information {#ReportingSystemInformation} + + + +| Name |key |Description| +|---|---|---| +|Report date/time |NVDA+f12 |Pressing once reports the current time, pressing twice reports the date| +|Report battery status |NVDA+shift+b |Reports the battery status i.e. whether AC power is in use or the current charge percentage.| +|Report clipboard text |NVDA+c |Reports the Text on the clipboard if there is any.| + + + +### Speech modes {#SpeechModes} + +The speech mode governs how screen content, notifications, responses to commands, and other output is spoken during operation of NVDA. +The default mode is "talk", which speaks in situations that are expected when using a screen reader. +However, under certain circumstances, or when running particular programs, you may find one of the other speech modes valuable. + +The four available speech modes are: + +* Talk (Default): NVDA will speak normally in reaction to screen changes, notifications, and actions such as moving the focus, or issuing commands. +* On-demand: NVDA will only speak when you use commands with a reporting function (e.g. report the title of the window); but it will not speak in reaction to actions such as moving the focus or the cursor. +* Off: NVDA will not speak anything, however unlike sleep mode, it will silently react to commands. +* Beeps: NVDA will replace normal speech with short beeps. + +The Beeps mode may be useful when some very verbose output is scrolling in a terminal window, but you don't care what it is, only that it is continuing to scroll; or in other circumstances when the fact that there is output is more relevant than the output itself. + +The On-demand mode may be valuable when you don't need constant feedback about what is happening on screen or on the computer, but you periodically need to check particular things using review commands, etc. +Examples include while recording audio, when using screen magnification, during a meeting or a call, or as an alternative to beeps mode. + +A gesture allows cycling through the various speech modes: + + +| Name |Key |Description| +|---|---|---| +|Cycle Speech Mode |`NVDA+s` |Cycles between speech modes.| + + + +If you only need to switch between a limited subset of speech modes, see [Modes available in the Cycle speech mode command](#SpeechModesDisabling) for a way to disable unwanted modes. + +## Navigating with NVDA {#NavigatingWithNVDA} + +NVDA allows you to explore and navigate the system in several ways, including both normal interaction and review. + +### Objects {#Objects} + +Each Application and the operating system itself consist of many objects. +An object is a single item such as a piece of text, button, checkbox, slider, list or editable text field. + +### Navigating with the System Focus {#SystemFocus} + +The system focus, also known simply as the focus, is the [object](#Objects) which receives keys typed on the keyboard. +For example, if you are typing into an editable text field, the editable text field has the focus. + +The most common way of navigating around Windows with NVDA is to simply move the system focus using standard Windows keyboard commands, such as pressing tab and shift+tab to move forward and back between controls, pressing alt to get to the menu bar and then using the arrows to navigate menus, and using alt+tab to move between running applications. +As you do this, NVDA will report information about the object with focus, such as its name, type, value, state, description, keyboard shortcut and positional information. +When [Visual Highlight](#VisionFocusHighlight) is enabled, the location of the current system focus is also exposed visually. + +There are some key commands that are useful when moving with the System focus: + + +| Name |Desktop key |Laptop key |Description| +|---|---|---|---| +|Report current focus |NVDA+tab |NVDA+tab |announces the current object or control that has the System focus. Pressing twice will spell the information| +|Report title |NVDA+t |NVDA+t |Reports the title of the currently active window. Pressing twice will spell the information. Pressing three times will copy it to the clipboard| +|Read active window |NVDA+b |NVDA+b |reads all the controls in the currently active window (useful for dialogs)| +|Report Status Bar |NVDA+end |NVDA+shift+end |Reports the Status Bar if NVDA finds one. Pressing twice will spell the information. Pressing three times will copy it to the clipboard| +|Report Shortcut Key |`shift+numpad2` |`NVDA+control+shift+.` |Reports the shortcut (accelerator) key of the currently focused object| + + + +### Navigating with the System Caret {#SystemCaret} + +When an [object](#Objects) that allows navigation and/or editing of text is [focused](#SystemFocus), you can move through the text using the system caret, also known as the edit cursor. + +When the focus is on an object that has the system caret, you can use the arrow keys, page up, page down, home, end, etc. to move through the text. +You can also change the text if the control supports editing. +NVDA will announce as you move by character, word and line, and will also announce as you select and unselect text. + +NVDA provides the following key commands in relation to the system caret: + + +| Name |Desktop key |Laptop key |Description| +|---|---|---|---| +|Say all |NVDA+downArrow |NVDA+a |Starts reading from the current position of the system caret, moving it along as it goes| +|Read current line |NVDA+upArrow |NVDA+l |Reads the line where the system caret is currently situated. Pressing twice spells the line. Pressing three times spells the line using character descriptions.| +|Read current text selection |NVDA+Shift+upArrow |NVDA+shift+s |Reads any currently selected text| +|Report text formatting |NVDA+f |NVDA+f |Reports the formatting of the text where the caret is currently situated. Pressing twice shows the information in browse mode| +|Report link destination |`NVDA+k` |`NVDA+k` |Pressing once speaks the destination URL of the link at the current caret or focus position. Pressing twice shows it in a window for more careful review| +|Report caret location |NVDA+numpadDelete |NVDA+delete |Reports information about the location of the text or object at the position of system caret. For example, this might include the percentage through the document, the distance from the edge of the page or the exact screen position. Pressing twice may provide further detail.| +|Next sentence |alt+downArrow |alt+downArrow |Moves the caret to the next sentence and announces it. (only supported in Microsoft Word and Outlook)| +|Previous sentence |alt+upArrow |alt+upArrow |Moves the caret to the previous sentence and announces it. (only supported in Microsoft Word and Outlook)| + +When within a table, the following key commands are also available: + +| Name |Key |Description| +|---|---|---| +|Move to previous column |control+alt+leftArrow |Moves the system caret to the previous column (staying in the same row)| +|Move to next column |control+alt+rightArrow |Moves the system caret to the next column (staying in the same row)| +|Move to previous row |control+alt+upArrow |Moves the system caret to the previous row (staying in the same column)| +|Move to next row |control+alt+downArrow |Moves the system caret to the next row (staying in the same column)| +|Move to first column |control+alt+home |Moves the system caret to the first column (staying in the same row)| +|Move to last column |control+alt+end |Moves the system caret to the last column (staying in the same row)| +|Move to first row |control+alt+pageUp |Moves the system caret to the first row (staying in the same column)| +|Move to last row |control+alt+pageDown |Moves the system caret to the last row (staying in the same column)| +|Say all in column |`NVDA+control+alt+downArrow` |Reads the column vertically from the current cell downwards to the last cell in the column.| +|Say all in row |`NVDA+control+alt+rightArrow` |Reads the row horizontally from the current cell rightwards to the last cell in the row.| +|Read entire column |`NVDA+control+alt+upArrow` |Reads the current column vertically from top to bottom without moving the system caret.| +|Read entire row |`NVDA+control+alt+leftArrow` |Reads the current row horizontally from left to right without moving the system caret.| + + + +### Object Navigation {#ObjectNavigation} + +Most of the time, you will work with applications using commands which move the [focus](#SystemFocus) and the [caret](#SystemCaret). +However, sometimes, you may wish to explore the current application or the Operating System without moving the focus or caret. +You may also wish to work with [objects](#Objects) that cannot be accessed normally using the keyboard. +In these cases, you can use object navigation. + +Object navigation allows you to move between and obtain information about individual [objects](#Objects). +When you move to an object, NVDA will report it similarly to the way it reports the system focus. +For a way to review all text as it appears on the screen, you can instead use [screen review](#ScreenReview). + +Rather than having to move back and forth between every single object on the system, the objects are organized hierarchically. +This means that some objects contain other objects and you must move inside them to access the objects they contain. +For example, a list contains list items, so you must move inside the list in order to access its items. +If you have moved to a list item, moving next and previous will take you to other list items in the same list. +Moving to a list item's containing object will take you back to the list. +You can then move past the list if you wish to access other objects. +Similarly, a toolbar contains controls, so you must move inside the toolbar to access the controls in the toolbar. + +If you yet prefer to move back and forth between every single object on the system, you can use commands to move to the previous/next object in a flattened view. +For example, if you move to the next object in this flattened view and the current object contains other objects, NVDA will automatically move to the first object that it contains. +Alternatively, if the current object doesn't contain any objects, NVDA will move to the next object at the current level of the hierarchy. +If there is no such next object, NVDA will try to find the next object in the hierarchy based on containing objects until there are no more objects to move to. +The same rules apply to moving backwards in the hierarchy. + +The object currently being reviewed is called the navigator object. +Once you navigate to an object, you can review its content using the [text review commands](#ReviewingText) while in [Object review mode](#ObjectReview). +When [Visual Highlight](#VisionFocusHighlight) is enabled, the location of the current navigator object is also exposed visually. +By default, the navigator object moves along with the System focus, though this behaviour can be toggled on and off. + +Note: Braille following Object Navigation can be configured via [Braille Tether](#BrailleTether). + +To navigate by object, use the following commands: + + + +| Name |Desktop key |Laptop key |Touch |Description| +|---|---|---|---|---| +|Report current object |NVDA+numpad5 |NVDA+shift+o |none |Reports the current navigator object. Pressing twice spells the information, and pressing 3 times copies this object's name and value to the clipboard.| +|Move to containing object |NVDA+numpad8 |NVDA+shift+upArrow |flick up (object mode) |Moves to the object containing the current navigator object| +|Move to previous object |NVDA+numpad4 |NVDA+shift+leftArrow |none |Moves to the object before the current navigator object| +|Move to previous object in flattened view |NVDA+numpad9 |NVDA+shift+[ |flick left (object mode) |Moves to the previous object in a flattened view of the object navigation hierarchy| +|Move to next object |NVDA+numpad6 |NVDA+shift+rightArrow |none |Moves to the object after the current navigator object| +|Move to next object in flattened view |NVDA+numpad3 |NVDA+shift+] |flick right (object mode) |Moves to the next object in a flattened view of the object navigation hierarchy| +|Move to first contained object |NVDA+numpad2 |NVDA+shift+downArrow |flick down (object mode) |Moves to the first object contained by the current navigator object| +|Move to focus object |NVDA+numpadMinus |NVDA+backspace |none |Moves to the object that currently has the system focus, and also places the review cursor at the position of the System caret, if it is showing| +|Activate current navigator object |NVDA+numpadEnter |NVDA+enter |double-tap |Activates the current navigator object (similar to clicking with the mouse or pressing space when it has the system focus)| +|Move System focus or caret to current review position |NVDA+shift+numpadMinus |NVDA+shift+backspace |none |pressed once Moves the System focus to the current navigator object, pressed twice moves the system caret to the position of the review cursor| +|Report review cursor location |NVDA+shift+numpadDelete |NVDA+shift+delete |none |Reports information about the location of the text or object at the review cursor. For example, this might include the percentage through the document, the distance from the edge of the page or the exact screen position. Pressing twice may provide further detail.| +|Move review cursor to status bar |none |none |none |Reports the Status Bar if NVDA finds one. It also moves the navigator object to this location.| + + + +Note: numpad keys require the Num Lock to be turned off to work properly. + +### Reviewing Text {#ReviewingText} + +NVDA allows you to read the contents of the [screen](#ScreenReview), current [document](#DocumentReview) or current [object](#ObjectReview) by character, word or line. +This is mostly useful in places (including Windows command consoles) where there is no [system caret](#SystemCaret). +For example, you might use it to review the text of a long information message in a dialog. + +When moving the review cursor, the System caret does not follow along, so you can review text without losing your editing position. +However, by default, when the System caret moves, the review cursor follows along. +This can be toggled on and off. + +Note: Braille following the review cursor can be configured via [Braille Tether](#BrailleTether). + +The following commands are available for reviewing text: + + +| Name |Desktop key |Laptop key |Touch |Description| +|---|---|---|---|---| +|Move to top line in review |shift+numpad7 |NVDA+control+home |none |Moves the review cursor to the top line of the text| +|Move to previous line in review |numpad7 |NVDA+upArrow |flick up (text mode) |Moves the review cursor to the previous line of text| +|Report current line in review |numpad8 |NVDA+shift+. |none |Announces the current line of text where the review cursor is positioned. Pressing twice spells the line. Pressing three times spells the line using character descriptions.| +|Move to next line in review |numpad9 |NVDA+downArrow |flick down (text mode) |Move the review cursor to the next line of text| +|Move to bottom line in review |shift+numpad9 |NVDA+control+end |none |Moves the review cursor to the bottom line of text| +|Move to previous word in review |numpad4 |NVDA+control+leftArrow |2-finger flick left (text mode) |Moves the review cursor to the previous word in the text| +|Report current word in review |numpad5 |NVDA+control+. |none |Announces the current word in the text where the review cursor is positioned. Pressing twice spells the word. Pressing three times spells the word using character descriptions.| +|Move to next word in review |numpad6 |NVDA+control+rightArrow |2-finger flick right (text mode) |Move the review cursor to the next word in the text| +|Move to start of line in review |shift+numpad1 |NVDA+home |none |Moves the review cursor to the start of the current line in the text| +|Move to previous character in review |numpad1 |NVDA+leftArrow |flick left (text mode) |Moves the review cursor to the previous character on the current line in the text| +|Report current character in review |numpad2 |NVDA+. |none |Announces the current character on the line of text where the review cursor is positioned. Pressing twice reports a description or example of that character. Pressing three times reports the numeric value of the character in decimal and hexadecimal.| +|Move to next character in review |numpad3 |NVDA+rightArrow |flick right (text mode) |Move the review cursor to the next character on the current line of text| +|Move to end of line in review |shift+numpad3 |NVDA+end |none |Moves the review cursor to the end of the current line of text| +|Move to previous page in review |`NVDA+pageUp` |`NVDA+shift+pageUp` |none |Moves the review cursor to the previous page of text if supported by the application| +|Move to next page in review |`NVDA+pageDown` |`NVDA+shift+pageDown` |none |Moves the review cursor to the next page of text if supported by the application| +|Say all with review |numpadPlus |NVDA+shift+a |3-finger flick down (text mode) |Reads from the current position of the review cursor, moving it as it goes| +|Select then Copy from review cursor |NVDA+f9 |NVDA+f9 |none |Starts the select then copy process from the current position of the review cursor. The actual action is not performed until you tell NVDA where the end of the text range is| +|Select then Copy to review cursor |NVDA+f10 |NVDA+f10 |none |On the first press, text is selected from the position previously set as start marker up to and including the review cursor's current position. If the system caret can reach the text, it will be moved to the selected text. After pressing this key stroke a second time, the text will be copied to the Windows clipboard| +|Move to marked start for copy in review |NVDA+shift+f9 |NVDA+shift+f9 |none |Moves the review cursor to the position previously set start marker for copy| +|Report text formatting |NVDA+shift+f |NVDA+shift+f |none |Reports the formatting of the text where the review cursor is currently situated. Pressing twice shows the information in browse mode| +|Report current symbol replacement |None |None |none |Speaks the symbol where the review cursor is positioned. Pressed twice, shows the symbol and the text used to speak it in browse mode.| + + + +Note: numpad keys require the Num Lock to be turned off to work properly. + +A good way to remember the basic text review commands when using the Desktop layout is to think of them as being in a grid of three by three, with top to bottom being line, word and character and left to right being previous, current and next. +The layout is illustrated as follows: + +| . {.hideHeaderRow} |. |.| +|---|---|---| +|Previous line |Current line |Next line| +|Previous word |Current word |Next word| +|Previous character |Current character |Next character| + +### Review Modes {#ReviewModes} + +NVDA's [text review commands](#ReviewingText) can review content within the current navigator object, current document or screen, depending on the review mode selected. + +The following commands switch between review modes: + + +| Name |Desktop key |Laptop key |Touch |Description| +|---|---|---|---|---| +|Switch to next review mode |NVDA+numpad7 |NVDA+pageUp |2-finger flick up |switches to the next available review mode| +|Switch to previous review mode |NVDA+numpad1 |NVDA+pageDown |2-finger flick down |switches to the previous available review mode| + + + +#### Object Review {#ObjectReview} + +While in object review mode, you are able to only review the content of the current [navigator object](#ObjectNavigation). +For objects such as editable text fields or other basic text controls, this will generally be the text content. +For other objects, this may be the name and/or value. + +#### Document Review {#DocumentReview} + +When the [navigator object](#ObjectNavigation) is within a browse mode document (e.g. web page) or other complex document (e.g. a Lotus Symphony document), it is possible to switch to the document review mode. +The document review mode allows you to review the text of the entire document. + +When switching from object review to document review, the review cursor is placed in the document at the position of the navigator object. +When moving around the document with review commands, the navigator object is automatically updated to the object found at the current review cursor position. + +Note that NVDA will switch to document review from object review automatically when moving around browse mode documents. + +#### Screen Review {#ScreenReview} + +The screen review mode allows you to review the text of the screen as it appears visually within the current application. +This is similar to the screen review or mouse cursor functionality in many other Windows screen readers. + +When switching to screen review mode, the review cursor is placed at the screen position of the current [navigator object](#ObjectNavigation). +When moving around the screen with review commands, the navigator object is automatically updated to the object found at the screen position of the review cursor. + +Note that in some newer applications, NVDA may not see some or all text displayed on the screen due to the use of newer screen drawing technologies which are impossible to support at this time. + +### Navigating with the Mouse {#NavigatingWithTheMouse} + +When you move the mouse, NVDA by default reports the text that is directly under the mouse pointer as the pointer moves over it. +Where supported, NVDA will read the surrounding paragraph of text, though some controls may only read by line. + +NVDA can be configured to also announce the type of [object](#Objects) under the mouse as it moves (e.g. list, button, etc.). +This may be useful for totally blind users, as sometimes, the text isn't enough. + +NVDA provides a way for users to understand where the mouse is located relative to the dimensions of the screen by playing the current mouse coordinates as audio beeps. +The higher the mouse is on the screen, the higher the pitch of the beeps. +The further left or right the mouse is located on the screen, the further left or right the sound will be played (assuming the user has stereo speakers or headphones). + +These extra mouse features are not turned on by default in NVDA. +If you wish to take advantage of them, you can configure them from the [Mouse settings](#MouseSettings) category of the [NVDA Settings](#NVDASettings) dialog, found in the NVDA Preferences menu. + +Although a physical mouse or trackpad should be used to navigate with the mouse, NVDA provides some commands related to the mouse: + + + +| Name |Desktop key |Laptop key |Touch |Description| +|---|---|---|---|---| +|Left mouse button click |numpadDivide |NVDA+[ |none |Clicks the left mouse button once. The common double click can be performed by pressing this key twice in quick succession| +|Left mouse button lock |shift+numpadDivide |NVDA+control+[ |none |Locks the left mouse button down. Press again to release it. To drag the mouse, press this key to lock the left button down and then move the mouse either physically or use one of the other mouse routing commands| +|Right mouse click |numpadMultiply |NVDA+] |tap and hold |Clicks the right mouse button once, mostly used to open context menu at the location of the mouse.| +|Right mouse button lock |shift+numpadMultiply |NVDA+control+] |none |Locks the right mouse button down. Press again to release it. To drag the mouse, press this key to lock the right button down and then move the mouse either physically or use one of the other mouse routing commands| +|Scroll up at the mouse position |none |none |none |Scrolls the mouse wheel up at the current mouse position| +|Scroll down at the mouse position|none |none |none |Scrolls the mouse wheel down at the current mouse position| +|Scroll left at the mouse position |none |none |none |Scrolls the mouse wheel left at the current mouse position| +|Scroll right at the mouse position |none |none |none |Scrolls the mouse wheel right at the current mouse position| +|Move mouse to current navigator object |NVDA+numpadDivide |NVDA+shift+m |none |Moves the mouse to the location of the current navigator object and review cursor| +|Navigate to the object under the mouse |NVDA+numpadMultiply |NVDA+shift+n |none |Set the navigator object to the object located at the position of the mouse| + + + +## Browse Mode {#BrowseMode} + +Complex read-only documents such as web pages are browsed in NVDA using browse mode. +This includes documents in the following applications: + +* Mozilla Firefox +* Microsoft Internet Explorer +* Mozilla Thunderbird +* HTML messages in Microsoft Outlook +* Google Chrome +* Microsoft Edge +* Adobe Reader +* Foxit Reader +* Supported books in Amazon Kindle for PC + +Browse mode is also optionally available for Microsoft Word documents. + +In browse mode, the content of the document is made available in a flat representation that can be navigated with the cursor keys as if it were a normal text document. +All of NVDA's [system caret](#SystemCaret) key commands will work in this mode; e.g. say all, report formatting, table navigation commands, etc. +When [Visual Highlight](#VisionFocusHighlight) is enabled, the location of the virtual browse mode caret is also exposed visually. +Information such as whether text is a link, heading, etc. is reported along with the text as you move. + +Sometimes, you will need to interact directly with controls in these documents. +For example, you will need to do this for editable text fields and lists so that you can type characters and use the cursor keys to work with the control. +You do this by switching to focus mode, where almost all keys are passed to the control. +When in Browse mode, by default, NVDA will automatically switch to focus mode if you tab to or click on a particular control that requires it. +Conversely, tabbing to or clicking on a control that does not require focus mode will switch back to browse mode. +You can also press enter or space to switch to focus mode on controls that require it. +Pressing escape will switch back to browse mode. +In addition, you can manually force focus mode, after which it will remain in effect until you choose to disable it. + + + +| Name |Key |Description| +|---|---|---| +|Toggle browse/focus modes |NVDA+space |Toggles between focus mode and browse mode| +|Exit focus mode |escape |Switches back to browse mode if focus mode was previously switched to automatically| +|Refresh browse mode document |NVDA+f5 |Reloads the current document content (useful if certain content seems to be missing from the document. Not available in Microsoft Word and Outlook.)| +|Find |NVDA+control+f |Pops up a dialog in which you can type some text to find in the current document. See [searching for text](#SearchingForText) for more information.| +|Find next |NVDA+f3 |Finds the next occurrence of the text in the document that you previously searched for| +|Find previous |NVDA+shift+f3 |Finds the previous occurrence of the text in the document you previously searched for| + + + +### Single Letter Navigation {#SingleLetterNavigation} + +While in browse mode, for quicker navigation, NVDA also provides single character keys to jump to certain fields in the document. +Note that not all of these commands are supported in every type of document. + + +The following keys by themselves jump to the next available element, while adding the shift key causes them to jump to the previous element: + +* h: heading +* l: list +* i: list item +* t: table +* k: link +* n: nonLinked text +* f: form field +* u: unvisited link +* v: visited link +* e: edit field +* b: button +* x: checkbox +* c: combo box +* r: radio button +* q: block quote +* s: separator +* m: frame +* g: graphic +* d: landmark +* o: embedded object (audio and video player, application, dialog, etc.) +* 1 to 6: headings at levels 1 to 6 respectively +* a: annotation (comment, editor revision, etc.) +* `p`: text paragraph +* w: spelling error + +To move to the beginning or end of containing elements such as lists and tables: + +| Name |Key |Description| +|---|---|---| +|Move to start of container |shift+comma |Moves to the start of the container (list, table, etc.) where the caret is positioned| +|Move past end of container |comma |Moves past the end of the container (list, table, etc.) where the caret is positioned| + + + +Some web applications such as Gmail, Twitter and Facebook use single letters as shortcut keys. +If you want to use these while still being able to use your cursor keys to read in browse mode, you can temporarily disable NVDA's single letter navigation keys. + +To toggle single letter navigation on and off for the current document, press NVDA+shift+space. + + +#### Text paragraph navigation command {#TextNavigationCommand} + +You can jump to the next or previous text paragraph by pressing `p` or `shift+p`. +Text paragraphs are defined by a group of text that appears to be written in complete sentences. +This can be useful to find the beginning of readable content on various webpages, such as: + +* News websites +* Forums +* Blog posts + +These commands can also be helpful for skipping certain kinds of clutter, such as: + +* Ads +* Menus +* Headers + +Please note, however, that while NVDA tries its best to identify text paragraphs, the algorithm is not perfect and at times can make mistakes. +Additionally, this command is different from paragraph navigation commands `control+downArrow/upArrow`. +Text paragraph navigation only jumps between text paragraphs, while paragraph navigation commands take the cursor to the previous/next paragraphs regardless of whether they contain text or not. + +#### Other navigation commands {#OtherNavigationCommands} + +In addition to the quick navigation commands listed above, NVDA has commands that have no default keys assigned. +To use these commands, you first need to assign gestures to them using the [Input Gestures dialog](#InputGestures). +Here is a list of available commands: + +* Article +* Figure +* Grouping +* Tab +* Menu item +* Toggle button +* Progress bar +* Math formula +* Vertically aligned paragraph +* Same style text +* Different style text + +Keep in mind that there are two commands for each type of element, for moving forward in the document and backward in the document, and you must assign gestures to both commands in order to be able to quickly navigate in both directions. +For example, if you want to use the `y` / `shift+y` keys to quickly navigate through tabs, you would do the following: + +1. Open input gestures dialog from browse mode. +1. Find "moves to the next tab" item in the Browse mode section. +1. Assign `y` key for found gesture. +1. Find "moves to the previous tab" item. +1. Assign `shift+y` for found gesture. + +### The Elements List {#ElementsList} + +The elements list provides access to a list of various types of elements in the document as appropriate for the application. +For example, in web browsers, the elements list can list links, headings, form fields, buttons or landmarks. +Radio buttons allow you to switch between the different types of elements. +An edit field is also provided in the dialog which allows you to filter the list to help you search for a particular item on the page. +Once you have chosen an item, you can use the provided buttons in the dialog to move to or activate that item. + + +| Name |Key |Description| +|---|---|---| +|Browse mode elements list |NVDA+f7 |Lists various types of elements in the current document| + + + +### Searching for text {#SearchingForText} + +This dialog allows you to search for terms in the current document. +In the "Type the text you wish to find" field, the text to be found can be entered. +The "Case sensitive" checkbox makes the search consider uppercase and lowercase letters differently. +For example, with "Case sensitive" selected you can find "NV Access" but not "nv access". +Use the following keys for performing searches: + + +| Name |Key |Description| +|---|---|---| +|Find text |NVDA+control+f |Opens the search dialog| +|Find next |NVDA+f3 |searches the next occurrence of the current search term| +|Find previous |NVDA+shift+f3 |searches the previous occurrence of the current search term| + + + +### Embedded Objects {#ImbeddedObjects} + +Pages can include rich content using technologies such as Oracle Java and HTML5, as well as applications and dialogs. +Where these are encountered in browse mode, NVDA will report "embedded object", "application" or "dialog", respectively. +You can quickly move to them using the o and shift+o embedded object single letter navigation keys. +To interact with these objects, you can press enter on them. +If it is accessible, you can then tab around it and interact with it like any other application. +A key command is provided to return to the original page containing the embedded object: + + +| Name |Key |Description| +|---|---|---| +|Move to containing browse mode document |NVDA+control+space |Moves the focus out of the current embedded object and into the document that contains it| + + + +### Native Selection Mode {#NativeSelectionMode} + +By default when selecting text with the `shift+arrow` keys in Browse Mode, a selection is only made within NVDA's Browse Mode representation of the document, and not within the application itself. +This means that the selection is not visible on screen, and copying text with `control+c` will only copy NVDA's plain text representation of the content. i.e. formatting of tables, or whether something is a link will not be copied. +However, NVDA has a Native Selection Mode which can be turned on in particular Browse Mode documents (so far only Mozilla Firefox) which causes the document's native selection to follow NVDA's Browse Mode selection. + + + +| Name |Key |Description| +|---|---|---| +|Toggle Native Selection Mode on and off |`NVDA+shift+f10` |Toggles native selection mode on and off| + + + +When Native Selection Mode is turned on, copying the selection with `control+c` will also use the application's own copy functionality, meaning that rich content will be copied to the clipboard, rather than plain text. +This means that pasting this content into a program such as Microsoft Word or Excel, formatting such as tables, or whether something is a link will be included. +Please note however that in native selection mode, some accessible labels or other information that NVDA generates in Browse Mode will not be included. +Also, although the application will try its best to match the native selection to NVDA's Browse Mode selection, it may not always be completely accurate. +However, for scenarios where you wish to copy an entire table or paragraph of rich content, this feature should prove useful. + +## Reading Mathematical Content {#ReadingMath} + +NVDA can read and navigate mathematical content on the web and in other applications, providing access in both speech and braille. +However, in order for NVDA to read and interact with mathematical content, you will first need to install a Math component for NvDA. +There are several NVDA add-ons available in the NVDA Add-on Store that provide support for math, including the [MathCAT NVDA add-on](https://nsoiffer.github.io/MathCAT/) and [Access8Math](https://github.com/tsengwoody/Access8Math). +Please refer to the [Add-on Store section](#AddonsManager) to learn how to browse and install available add-ons in NVDA. +NVDA also can make use of the older [MathPlayer](https://info.wiris.com/mathplayer-info) software from Wiris if found on your system, though this software is no longer maintained. + +### Supported math content {#SupportedMathContent} + +With an appropriate math component installed, NVDA supports the following types of mathematical content: + +* MathML in Mozilla Firefox, Microsoft Internet Explorer and Google Chrome. +* Microsoft Word 365 Modern Math Equations via UI automation: +NVDA is able to read and interact with math equations in Microsoft Word 365/2016 build 14326 and higher. +Note however that any previously created MathType equations must be first converted to Office Math. +This can be done by selecting each and choosing "Equation Options", then "Convert to Office Math" in the context menu. +Ensure your version of MathType is the latest version before doing this. +Microsoft Word provides linear symbol-based navigation through the equations itself and supports inputting math using several syntaxes, including LateX. +For further details, please see [Linear format equations using UnicodeMath and LaTeX in Word](https://support.microsoft.com/en-us/office/linear-format-equations-using-unicodemath-and-latex-in-word-2e00618d-b1fd-49d8-8cb4-8d17f25754f8) +* Microsoft Powerpoint, and older versions of Microsoft Word: +NVDA can read and navigate MathType equations in both Microsoft Powerpoint and Microsoft word. +MathType needs to be installed in order for this to work. +The trial version is sufficient. +It can be downloaded from the [MathType presentation page](https://www.wiris.com/en/mathtype/). +* Adobe Reader: +Note that this is not an official standard yet, so there is currently no publicly available software that can produce this content. +* Kindle Reader for PC: +NVDA can read and navigate Math in Kindle for PC for books with accessible math. + +When reading a document, NVDA will speak any supported mathematical content where it occurs. +If you are using a braille display, it will also be displayed in braille. + +### Interactive Navigation {#InteractiveNavigation} + +If you are working primarily with speech, in most cases, you will probably wish to examine the expression in smaller segments, rather than hearing the entire expression at once. + +If you are in browse mode, you can do this by moving the cursor to the mathematical content and pressing enter. + +If you are not in browse mode: + +1. move the review cursor to the mathematical content. +By default, the review cursor follows the system caret, so you can usually use the system caret to move to the desired content. +1. Then, activate the following command: + + + +| Name |Key |Description| +|---|---|---| +|Interact with math content |NVDA+alt+m |Begins interaction with math content.| + + + +At this point, NVDA will enter Math mode, where you can use commands such as the arrow keys to explore the expression. +For example, you can move through the expression with the left and right arrow keys and zoom into a portion of the expression such as a fraction using the down arrow key. + +When you wish to return to the document, simply press the escape key. + +For more information on available commands and preferences for reading and navigating within math content, please refer to the documentation for your particular math component you have installed. + +* [MathCAT documentation](https://nsoiffer.github.io/MathCAT/users.html) +* [Access8Math documentation](https://github.com/tsengwoody/Access8Math) +* [MathPlayer documentation](https://docs.wiris.com/mathplayer/en/mathplayer-user-manual.html) + +Sometimes mathematical content might be displayed as a button or other type of element which, when activated, can display a dialog or more information related to the formula. +To activate the button or the element containing the formula, press ctrl+enter. + +### Installing MathPlayer {#InstallingMathPlayer} + +Although it is generally recommended to use one of the newer NVDA add-ons to support math in NVDA, in certain limited scenarios MathPlayer may still be a more suitable choice. +E.g. MathPlayer may support a particular language or Braille code that is unsupported in newer add-ons. +MathPlayer is available for free from the Wiris website. +[Download MathPlayer](https://downloads.wiris.com/mathplayer/MathPlayerSetup.exe). +After installing MathPlayer, you will need to restart NVDA. +Please note that information about MathPlayer may state that it is only for older browsers such as Internet Explorer 8. +This is only referring to using MathPlayer to display mathematical content visually, and can be ignored by those using it to read or navigate math with NVDA. + +## Braille {#Braille} + +If you own a braille display, NVDA can display information in braille. +If your braille display has a Perkins-style keyboard, you can also enter contracted or uncontracted braille. +Braille can also be displayed on screen using the [Braille Viewer](#BrailleViewer) instead of, or at the same time as, using a physical braille display. + +Please see the [Supported Braille Displays](#SupportedBrailleDisplays) section for information about the supported braille displays. +This section also contains information about what displays support NVDA's automatic background braille display detection functionality. +You can configure braille using the [Braille category](#BrailleSettings) of the [NVDA Settings](#NVDASettings) dialog. + +### Control Type, State and Landmark abbreviations {#BrailleAbbreviations} + +In order to fit as much information as possible on a braille display, the following abbreviations have been defined to indicate control type and state as well as landmarks. + +| Abbreviation |Control type| +|---|---| +|app |application| +|art |article| +|bqt |block quote| +|btn |button| +|drbtn |drop down button| +|spnbtn |spin button| +|splbtn |split button| +|tgbtn |toggle button| +|cap |caption| +|cbo |combo box| +|chk |checkbox| +|dlg |dialog| +|doc |document| +|edt |editable text field| +|pwdedt |password edit| +|embedded |embedded object| +|enote |end note| +|fig |figure| +|fnote |foot note| +|gra |graphic| +|grp |grouping| +|hN |heading at level n, e.g. h1, h2.| +|hlp |help balloon| +|lmk |landmark| +|lnk |link| +|vlnk |visited link| +|lst |list| +|mnu |menu| +|mnubar |menu bar| +|mnubtn |menu button| +|mnuitem |menu item| +|pnl |panel| +|prgbar |progress bar| +|bsyind |busy indicator| +|rbtn |radio button| +|scrlbar |scroll bar| +|sect |section| +|stbar |status bar| +|tabctl |tab control| +|tbl |table| +|cN |table column number n, e.g. c1, c2.| +|rN |table row number n, e.g. r1, r2.| +|term |terminal| +|tlbar |tool bar| +|tltip |tool tip| +|tv |tree view| +|tvbtn |tree view button| +|tvitem |tree view item| +|lv N |a tree view item has a hierarchical level N| +|wnd |window| +|⠤⠤⠤⠤⠤ |separator| +|mrkd |marked content| + +The following state indicators are also defined: + +| Abbreviation |Control state| +|---|---| +|... |displayed when an object supports autocompletion| +|⢎⣿⡱ |displayed when an object (e.g. a toggle button) is pressed| +|⢎⣀⡱ |displayed when an object (e.g. a toggle button) is not pressed| +|⣏⣿⣹ |displayed when an object (e.g. a checkbox) is checked| +|⣏⣸⣹ |displayed when an object (e.g. a checkbox) is half checked| +|⣏⣀⣹ |displayed when an object (e.g. a checkbox) is not checked| +|- |displayed when an object (e.g. a tree view item) is collapsible| +|+ |displayed when an object (e.g. a tree view item) is Expandable| +|*** |displayed when a protected control or document is encountered| +|clk |displayed when an object is clickable| +|cmnt |displayed when there is a comment for a spreadsheet cell or piece of text in a document| +|frml |displayed when there is a formula on a spreadsheet cell| +|invalid |displayed when an invalid entry has been made| +|ldesc |displayed when an object (usually a graphic) has a long description| +|mln |displayed when an edit field allows typing multiple lines of text such as comment fields on websites| +|req |displayed when a required form field is encountered| +|ro |displayed when an object (e.g. an editable text field) is read-only| +|sel |displayed when an object is selected| +|nsel |displayed when an object is not selected| +|sorted asc |displayed when an object is sorted ascending| +|sorted desc |displayed when an object is sorted descending| +|submnu |displayed when an object has a popup (usually a sub-menu)| + +Finally, the following abbreviations for landmarks are defined: + +| Abbreviation |Landmark| +|---|---| +|bnnr |banner| +|cinf |content info| +|cmpl |complementary| +|form |form| +|main |main| +|navi |navigation| +|srch |search| +|rgn |region| + +### Braille Input {#BrailleInput} + +NVDA supports entry of both uncontracted and contracted braille via a braille keyboard. +You can select the translation table used to translate braille into text using the [Input table](#BrailleSettingsInputTable) setting in the Braille category of the [NVDA Settings](#NVDASettings) dialog. + +When uncontracted braille is being used, text is inserted as soon as it is entered. +When using contracted braille, text is inserted when you press space or enter at the end of a word. +Note that translation can only reflect the braille word you are typing and cannot consider existing text. +For example, if you are using a braille code that begins numbers with a number sign and you press backspace to move to the end of a number, you will need to type the number sign again to enter additional numbers. + + +Pressing dot 7 erases the last entered braille cell or character. +Dot 8 translates any braille input and presses the enter key. +Pressing dot 7 + dot 8 translates any braille input, but without adding a space or pressing enter. + + +#### Inputting keyboard shortcuts {#BrailleKeyboardShortcuts} + +NVDA supports inputting keyboard shortcuts and emulating keypresses using the braille display. +This emulation comes in two forms: assigning a Braille input directly to some key press and using the virtual modifier keys. + +Commonly-used keys, such as the arrow keys or pressing Alt to reach menus, can be mapped directly to Braille inputs. +The driver for each Braille display comes pre-equipped with some of these assignments. +You can change these assignments or add new emulated keys from the [Input Gestures dialog](#InputGestures). + +While this approach is useful for commonly-pressed or unique keys (such as Tab), you may not want to assign a unique set of keys to each keyboard shortcut. +To allow emulating keypresses where modifier keys are held down, NVDA provides commands to toggle the control, alt, shift, windows, and NVDA keys, along with commands for some combinations of those keys. +To use these toggles, first press the command (or sequence of commands) for the modifier keys you want pressed. +Then input the character that's part of the keyboard shortcut you want to input. +For example, to produce control+f, use the "Toggle control key" command and then type an f, +and to input control+alt+t, use either the "Toggle control key" and "Toggle alt key" commands, in either order, or the "Toggle control and alt keys" command, followed by typing a t. + +If you accidentally toggle modifier keys, running the toggle command again will remove the modifier. + +When typing in contracted Braille, using the modifier toggle keys will cause your input to be translated just as if you had pressed dots 7+8. +In addition, the emulated keypress cannot reflect Braille typed before the modifier key was pressed. +This means that, to type alt+2 with a Braille code that uses a number sign, you must first toggle Alt and then type a number sign. + +## Vision {#Vision} + +While NVDA is primarily aimed at blind or vision impaired people who primarily use speech and/or braille to operate a computer, it also provides built-in facilities to change the contents of the screen. +Within NVDA, such a visual aid is called a vision enhancement provider. + +NVDA offers several built-in vision enhancement providers which are described below. +Additional vision enhancement providers can be provided in [NVDA add-ons](#AddonsManager). + +NVDA's vision settings can be changed in the [vision category](#VisionSettings) of the [NVDA Settings](#NVDASettings) dialog. + +### Visual Highlight {#VisionFocusHighlight} + +Visual Highlight can help to identify the [system focus](#SystemFocus), [navigator object](#ObjectNavigation) and [browse mode](#BrowseMode) positions. +These positions are highlighted with a coloured rectangle outline. + +* Solid blue highlights a combined navigator object and system focus location (e.g. because [the navigator object follows the system focus](#ReviewCursorFollowFocus)). +* Dashed blue highlights just the system focus object. +* Solid pink highlights just the navigator object. +* Solid yellow highlights the virtual caret used in browse mode (where there is no physical caret such as in web browsers). + +When Visual Highlight is enabled in the [vision category](#VisionSettings) of the [NVDA Settings](#NVDASettings) dialog, you can [change whether or not to highlight the focus, navigator object or browse mode caret](#VisionSettingsFocusHighlight). + +### Screen Curtain {#VisionScreenCurtain} + +As a blind or vision impaired user, it is often not possible or necessary to see the contents of the screen. +Furthermore, it might be hard to ensure that there isn't someone looking over your shoulder. +For this situation, NVDA contains a feature called "Screen Curtain" which can be enabled to make the screen black. + +You can enable the Screen Curtain in the [vision category](#VisionSettings) of the [NVDA Settings](#NVDASettings) dialog. + + + +| Name |Key |Description| +|---|---|---| +|Toggles the state of the screen curtain |`NVDA+control+escape` |Enable to make the screen black or disable to show the contents of the screen. Pressed once, screen curtain is enabled until you restart NVDA. Pressed twice, screen curtain is enabled until you disable it.| + + + +When the Screen Curtain is active some tasks directly based on what appears on the screen such as performing [OCR](#Win10Ocr) or taking a screenshot cannot be achieved. + +Due to a change in the Windows Magnification API, Screen Curtain had to be updated to support the newest versions of Windows. +Use NVDA 2021.2 to activate Screen Curtain with Windows 10 21H2 (10.0.19044) or later. +For security purposes, when using a new version of Windows, get visual confirmation that the Screen Curtain makes the screen entirely black. + +Please note that while Windows Magnifier is running and inverted screen colors are being used, the screen curtain cannot be enabled. + +## Content Recognition {#ContentRecognition} + +When authors don't provide sufficient information for a screen reader user to determine the content of something, various tools can be used to attempt to recognize the content from an image. +NVDA supports the optical character recognition (OCR) functionality built into Windows 10 and later to recognize text from images. +Additional content recognizers can be provided in NVDA add-ons. + +When you use a content recognition command, NVDA recognizes content from the current [navigator object](#ObjectNavigation). +By default, the navigator object follows the system focus or browse mode cursor, so you can usually just move the focus or browse mode cursor where desired. +For example, if you move the browse mode cursor to a graphic, recognition will recognize content from the graphic by default. +However, you may wish to use object navigation directly to, for example, recognize the content of an entire application window. + +Once recognition is complete, the result will be presented in a document similar to browse mode, allowing you to read the information with cursor keys, etc. +Pressing enter or space will activate (normally click) the text at the cursor if possible. +Pressing escape dismisses the recognition result. + +### Windows OCR {#Win10Ocr} + +Windows 10 and later includes OCR for many languages. +NVDA can use this to recognize text from images or inaccessible applications. + +You can set the language to use for text recognition in the [Windows OCR category](#Win10OcrSettings) of the [NVDA Settings](#NVDASettings) dialog. +Additional languages can be installed by opening the Start menu, choosing Settings, selecting Time & Language -> Region & Language and then choosing Add a language. + +When you want to monitor constantly changing content, such as when watching a video with subtitles, you can optionally enable automatic refresh of the recognized content. +This can also be done in the [Windows OCR category](#Win10OcrSettings) of the [NVDA Settings](#NVDASettings) dialog. + +Windows OCR may be partially or fully incompatible with [NVDA vision enhancements](#Vision) or other external visual aids. You will need to disable these aids before proceeding to a recognition. + + +To recognize the text in the current navigator object using Windows OCR, press NVDA+r. + + +## Application Specific Features {#ApplicationSpecificFeatures} + +NVDA provides its own extra features for some applications to make certain tasks easier or to provide access to functionality which is not otherwise accessible to screen reader users. + +### Microsoft Word {#MicrosoftWord} +#### Automatic Column and Row Header Reading {#WordAutomaticColumnAndRowHeaderReading} + +NVDA is able to automatically announce appropriate row and column headers when navigating around tables in Microsoft Word. +This requires that the Report Table row / column headers option in NVDA's Document Formatting settings, found in the [NVDA Settings](#NVDASettings) dialog, be turned on. + +If you use [UIA to access Word documents](#MSWordUIA), which is default in recent versions of Word and Windows, the cells of the first row will automatically be considered as column headers; similarly, the cells of the first column will automatically be considered as row headers. + +On the contrary, if you do not use [UIA to access Word documents](#MSWordUIA), you will have to indicate to NVDA which row or column contains the headers in any given table. +After moving to the first cell in the column or row containing the headers, use one of the following commands: + + +| Name |Key |Description| +|---|---|---| +|Set column headers |NVDA+shift+c |Pressing this once tells NVDA this is the first header cell in the row that contains column headers, which should be automatically announced when moving between columns below this row. Pressing twice will clear the setting.| +|Set row headers |NVDA+shift+r |Pressing this once tells NVDA this is the first header cell in the column that contains row headers, which should be automatically announced when moving between rows after this column. Pressing twice will clear the setting.| + + +These settings will be stored in the document as bookmarks compatible with other screen readers such as JAWS. +This means that users of other screen readers who open this document at a later date will automatically have the row and column headers already set. + +#### Browse Mode in Microsoft Word {#BrowseModeInMicrosoftWord} + +Similar to the web, Browse mode can be used in Microsoft Word to allow you to use features such as Quick navigation and the Elements List. + +To toggle Browse mode on and off in Microsoft Word, press NVDA+space. + +For further information about Browse mode and Quick Navigation, see the [Browse Mode section](#BrowseMode). + +##### The Elements List {#WordElementsList} + + +While in Browse mode in Microsoft Word, you can access the Elements List by pressing NVDA+f7. + +The Elements List can list headings, links, annotations (which includes comments and track changes) and errors (currently limited to spelling errors). + +#### Reporting Comments {#WordReportingComments} + + +To report any comments at the current caret position, press NVDA+alt+c. + +All comments for the document, along with other tracked changes, can also be listed in the NVDA Elements List when selecting Annotations as the type. + +### Microsoft Excel {#MicrosoftExcel} +#### Automatic Column and Row Header Reading {#ExcelAutomaticColumnAndRowHeaderReading} + +NVDA is able to automatically announce appropriate row and column headers when navigating around Excel worksheets. +This firstly requires that the Report Table row / column headers option in NVDA's Document Formatting settings, found in the [NVDA Settings](#NVDASettings) dialog, be turned on. +Secondly, NVDA needs to know which row or column contains the headers. +After moving to the first cell in the column or row containing the headers, use one of the following commands: + + +| Name |Key |Description| +|---|---|---| +|Set column headers |NVDA+shift+c |Pressing this once tells NVDA this is the first header cell in the row that contains column headers, which should be automatically announced when moving between columns below this row. Pressing twice will clear the setting.| +|Set row headers |NVDA+shift+r |Pressing this once tells NVDA this is the first header cell in the column that contains row headers, which should be automatically announced when moving between rows after this column. Pressing twice will clear the setting.| + + +These settings will be stored in the workbook as defined name ranges compatible with other screen readers such as JAWS. +This means that users of other screen readers who open this workbook at a later date will automatically have the row and column headers already set. + +#### The Elements List {#ExcelElementsList} + +Similar to the web, NVDA has an Elements List for Microsoft Excel that allows you to list and access several different types of information. + +To access the Elements List in Excel, press NVDA+f7. + +The various types of information available in the Elements List are: + +* Charts: This lists all charts in the active worksheet. +Selecting a chart and pressing enter or the Move to button focuses the chart for navigating and reading with the arrow keys. +* Comments: This lists all cells in the active worksheet containing comments. +The cell address along with its comments are shown for each cell. +Pressing enter or the Move To button when on a listed comment will move directly to that cell. +* Formulas: This lists all cells in the worksheet containing a formula. +The cell address along with its formula are shown for each cell. +Pressing enter or the Move To button on a listed formula will move directly to that cell. +* Sheets: This lists all sheets in the workbook. +Pressing f2 when on a listed sheet allows you to rename the sheet. +Pressing enter or the Move To button while on the listed sheet will switch to that sheet. +* Form fields: This lists all form fields in the active worksheet. +For each form field, the Elements List shows the alternative text of the field along with the addresses of the cells it covers. +Selecting a form field and pressing enter or the Move to button moves to that field in browse mode. + +#### Reporting Notes {#ExcelReportingComments} + + +To report any notes for the currently focused cell, press NVDA+alt+c. +In Microsoft 2016, 365 and newer, the classic comments in Microsoft Excel have been renamed to "notes". + +All notes for the worksheet can also be listed in the NVDA Elements List after pressing NVDA+f7. + +NVDA can also display a specific dialog for adding or editing a certain note. +NVDA overrides the native MS Excel notes editing region due to accessibility constraints, but the key stroke for displaying the dialog is inherited from MS Excel and therefore works also without NVDA running. + +To add or edit a certain note, in a focused cell, press shift+f2. + + +This key stroke does not appear and cannot be changed in NVDA's input gesture dialog. + +Note: it is possible to open the note editing region in MS Excel also from the context menu of any cell of the work sheet. +However, this will open the inaccessible note editing region and not the NVDA specific note editing dialog. + +In Microsoft Office 2016, 365 and newer, a new style comment dialog has been added. +This dialog is accessible and provides more features such as replying to comments, etc. +It can also be opened from the context menu of a certain cell. +The comments added to the cells via the new style comment dialog are not related to "notes". + +#### Reading Protected Cells {#ExcelReadingProtectedCells} + +If a workbook has been protected, it may not be possible to move focus to particular cells that have been locked for editing. + +To allow moving to locked cells, switch to Browse Mode by pressing NVDA+space, and then use standard Excel movement commands such as the arrow keys to move around all cells on the current worksheet. + + +#### Form Fields {#ExcelFormFields} + +Excel worksheets can include form fields. +You can access these using the Elements List or the f and shift+f form field single letter navigation keys. +Once you move to a form field in browse mode, you can press enter or space to either activate it or switch to focus mode so you can interact with it, depending on the control. +For further information about Browse mode and single letter navigation, see the [Browse Mode section](#BrowseMode). + +### Microsoft PowerPoint {#MicrosoftPowerPoint} + + + +| Name |Key |Description| +|---|---|---| +|Toggle speaker notes reading |control+shift+s |When in a running slide show, this command will toggle between the speaker notes for the slide and the content for the slide. This only affects what NVDA reads, not what is displayed on screen.| + + + +### foobar2000 {#Foobar2000} + + + +| Name |Key |Description| +|---|---|---| +|Report remaining time |control+shift+r |Reports the remaining time of the currently playing track, if any.| +|Report elapsed time |control+shift+e |Reports the elapsed time of the currently playing track, if any.| +|Report track length |control+shift+t |Reports the length of the currently playing track, if any.| + + + +Note: The above shortcuts work only with the default formatting string for foobar's status line. + +### Miranda IM {#MirandaIM} + + + +| Name |Key |Description| +|---|---|---| +|Report recent message |NVDA+control+1-4 |Reports one of the recent messages, depending on the number pressed; e.g. NVDA+control+2 reads the second most recent message.| + + + +### Poedit {#Poedit} + +NVDA offers enhanced support for Poedit 3.4 or newer. + + + +| Name |Key |Description| +|---|---|---| +|Report notes for translators |`control+shift+a` |Reports any notes for translators. If pressed twice, presents the notes in browse mode| +|Report Comment |`control+shift+c` |Reports any comment in the comments window. If pressed twice, presents the comment in browse mode| +|Report Old Source Text |`control+shift+o` |Reports the old source text, if any. If pressed twice, presents the text in browse mode| +|Report Translation Warning |`control+shift+w` |Reports a translation warning, if any. If pressed twice, presents the warning in browse mode| + + + +### Kindle for PC {#Kindle} + +NVDA supports reading and navigating books in Amazon Kindle for PC. +This functionality is only available in Kindle books designated with "Screen Reader: Supported" which you can check on the details page for the book. + +Browse mode is used to read books. +It is enabled automatically when you open a book or focus the book area. +The page will be turned automatically as appropriate when you move the cursor or use the say all command. + +You can manually turn to the next page with the pageDown key and turn to the previous page with the pageUp key. + + +Single letter navigation is supported for links and graphics, but only within the current page. +Navigating by link also includes footnotes. + +NVDA provides early support for reading and interactive navigation of mathematical content for books with accessible math. +Please see the [Reading Mathematical Content](#ReadingMath) section for further information. + +#### Text Selection {#KindleTextSelection} + +Kindle allows you to perform various functions on selected text, including obtaining a dictionary definition, adding notes and highlights, copying the text to the clipboard and searching the web. +To do this, first select text as you normally would in browse mode; e.g. by using shift and the cursor keys. + +Once you have selected text, press the applications key or shift+f10 to show the available options for working with the selection. + +If you do this with no text selected, options will be shown for the word at the cursor. + +#### User Notes {#KindleUserNotes} + +You can add a note regarding a word or passage of text. +To do this, first select the relevant text and access the selection options as described above. +Then, choose Add Note. + +When reading in browse mode, NVDA refers to these notes as comments. + +To view, edit or delete a note: + +1. Move the cursor to the text containing the note. +1. Access the options for the selection as described above. +1. Choose Edit Note. + +### Azardi {#Azardi} + + +When in the table view of added books: + +| Name |Key |Description| +|---|---|---| +|Enter |enter |Opens the selected book.| +|Context menu |applications |Opens the context menu for the selected book.| + + + +### Windows Console {#WinConsole} + +NVDA provides support for the Windows command console used by Command Prompt, PowerShell, and the Windows Subsystem for Linux. +The console window is of fixed size, typically much smaller than the buffer that holds the output. +As new text is written, the content scroll upwards and previous text is no longer visible. +On Windows versions before Windows 11 22H2, text in the console that is not visibly displayed in the window is not accessible with NVDA's text review commands. +Therefore, it is necessary to scroll the console window to read earlier text. +In newer versions of the console and in Windows Terminal, it is possible to review the entire text buffer freely without the need to scroll the window. + +The following built-in Windows Console keyboard shortcuts may be useful when [reviewing text](#ReviewingText) with NVDA in older versions of Windows Console: + +| Name |Key |Description| +|---|---|---| +|Scroll up |control+upArrow |Scrolls the console window up, so earlier text can be read.| +|Scroll down |control+downArrow |Scrolls the console window down, so later text can be read.| +|Scroll to start |control+home |Scrolls the console window to the beginning of the buffer.| +|Scroll to end |control+end |Scrolls the console window to the end of the buffer.| + + + +## Configuring NVDA {#ConfiguringNVDA} + +Most configuration can be performed using dialog boxes accessed through the Preferences sub-menu of the NVDA menu. +Many of these settings can be found in the multi-page [NVDA Settings dialog](#NVDASettings). +In all dialog boxes, press the OK button to accept any changes you have made. +To cancel any changes, press the Cancel button or the escape key. +For certain dialogs, you can press the Apply button to let the settings take effect immediately without closing the dialog. +Most NVDA dialogs support context help. + +When in a dialog, pressing `f1` opens the User Guide at the paragraph related to the focused setting or the current dialog. + +Some settings can also be changed using shortcut keys, which are listed where relevant in the sections below. + +### NVDA Settings {#NVDASettings} + + +NVDA provides many configuration parameters that can be changed using the settings dialog. +To make it easier to find the kind of settings you want to change, the dialog displays a list of configuration categories to choose from. +When you select a category, all of the settings related to it will be shown in the dialog. +To move between categories, use `tab` or `shift+tab` to reach the list of categories, and then use the up and down arrow keys to navigate the list. +From anywhere in the dialog, you may also move forward one category by pressing `ctrl+tab`, or back one category by pressing `shift+ctrl+tab`. + +Once you change one or more settings, the settings can be applied using the apply button, in which case the dialog will stay open, allowing you to change more settings or choose another category. +If you want to save your settings and close the NVDA Settings dialog, you can use the OK button. + +Some settings categories have dedicated shortcut keys. +If pressed, the shortcut key will open the NVDA Settings dialog directly to that particular category. +By default, not all categories can be accessed with keyboard commands. +If you frequently access categories that do not have dedicated shortcut keys, you may wish to use the [Input Gestures dialog](#InputGestures) to add a custom gesture such as a keyboard command or touch gesture for that category. + +The settings categories found in the NVDA Settings dialog will be outlined below. + +#### General {#GeneralSettings} + + + +##### Open General settings {#OpenGeneralSettings} + +Key: `NVDA+control+g` + +The General category of the NVDA Settings dialog sets NVDA's overall behaviour such as interface language and whether or not it should check for updates. +This category contains the following options: + +##### Language {#GeneralSettingsLanguage} + +This is a combo box which allows you to select the language that NVDA's user interface and messages should be shown in. +There are many languages, however the default option is "User Default, Windows". +This option tells NVDA to use the language that Windows is currently set to. + +Please note that NVDA must be restarted when changing the language. +When the confirmation dialog appears, select "restart now" or "restart later" if you wish to use the new language now or at a later time, respectively. If "restart later" is selected, the configuration must be saved (either manually or using the save on exit functionality). + +##### Save configuration on exit {#GeneralSettingsSaveConfig} + +This option is a checkbox that, when checked, tells NVDA to automatically save the current configuration when you exit NVDA. + +##### Show exit options when exiting NVDA {#GeneralSettingsShowExitOptions} + +This option is a checkbox that allows you to choose whether or not a dialog appears when you exit NVDA that asks what action you want to perform. +When checked, a dialog will appear when you attempt to exit NVDA asking whether you want to exit, restart, restart with add-ons disabled or install pending updates (if any). +When unchecked, NVDA will exit immediately. + +##### Play sounds when starting or exiting NVDA {#GeneralSettingsPlaySounds} + +This option is a checkbox that, when checked, tells NVDA to play sounds when it starts or exits. + +##### Logging level {#GeneralSettingsLogLevel} + +This is a combo box that lets you choose how much NVDA will log as it's running. +Generally users should not need to touch this as not too much is logged. +However, if you wish to provide information in a bug report, or enable or disable logging altogether, then it may be a useful option. + +The available logging levels are: + +* Disabled: Apart from a brief startup message, NVDA will not log anything while it runs. +* Info: NVDA will log basic information such as startup messages and information useful for developers. +* Debug warning: Warning messages that are not caused by severe errors will be logged. +* Input/output: Input from keyboard and braille displays, as well as speech and braille output will be logged. +If you are concerned about privacy, do not set the logging level to this option. +* Debug: In addition to info, warning, and input/output messages, additional debug messages will be logged. +Just like input/output, if you are concerned about privacy, you should not set the logging level to this option. + +##### Start NVDA after I sign in {#GeneralSettingsStartAfterLogOn} + +If this option is enabled, NVDA will start automatically as soon as you sign in to Windows. +This option is only available for installed copies of NVDA. + +##### Use NVDA during sign-in (requires administrator privileges) {#GeneralSettingsStartOnLogOnScreen} + +If you sign in to Windows by providing a user name and password, then enabling this option will make NVDA start automatically at the sign-in screen when Windows starts. +This option is only available for installed copies of NVDA. + +##### Use currently saved settings during sign-in and on secure screens (requires administrator privileges) {#GeneralSettingsCopySettings} + +Pressing this button copies your currently saved NVDA user configuration to NVDA's system configuration directory, so that NVDA will use it during sign-in and when running on User Account Control (UAC) and other [secure screens](#SecureScreens). +To make sure that all your settings are transferred, make sure to save your configuration first with control+NVDA+c or Save configuration in the NVDA menu. +This option is only available for installed copies of NVDA. + +##### Automatically check for updates to NVDA {#GeneralSettingsCheckForUpdates} + +If this is enabled, NVDA will automatically check for updated versions and inform you when an update is available. +You can also manually check for updates by selecting Check for updates under Help in the NVDA menu. +When manually or automatically checking for updates, it is necessary for NVDA to send some information to the update server in order to receive the correct update for your system. +The following information is always sent: + +* Current NVDA version +* Operating System version +* Whether the Operating System is 64 or 32 bit + +##### Allow NV Access to gather NVDA usage statistics {#GeneralSettingsGatherUsageStats} + +If this is enabled, NV Access will use the information from update checks in order to track the number of NVDA users including particular demographics such as the operating system and country of origin. +Note that although your IP address will be used to calculate your country during the update check, the IP address is never kept. +Apart from the mandatory information required to check for updates, the following extra information is also currently sent: + +* A unique ID for the current NVDA user, this changes once a month +* NVDA interface language +* Whether this copy of NVDA is portable or installed +* Name of the current speech synthesizer in use (including the name of the add-on the driver comes from) +* Name of the current Braille display in use (including the name of the add-on the driver comes from) +* The current output Braille table (if Braille is in use) + +This information greatly aides NV Access to prioritize future development of NVDA. + +##### Notify for pending updates on startup {#GeneralSettingsNotifyPendingUpdates} + +If this is enabled, NVDA will inform you when there is a pending update on startup, offering you the possibility to install it. +You can also manually install the pending update from the Exit NVDA dialog (if enabled), from the NVDA menu, or when you perform a new check from the Help menu. + +#### Speech Settings {#SpeechSettings} + + + +##### Open Speech settings {#OpenSpeechSettings} + +Key: `NVDA+control+v` + +The Speech category in the NVDA Settings dialog contains options that lets you change the speech synthesizer as well as voice characteristics for the chosen synthesizer. +For a quicker alternative way of controlling speech parameters from anywhere, please see the [Synth Settings Ring](#SynthSettingsRing) section. + +The Speech Settings category contains the following options: + +##### Change synthesizer {#SpeechSettingsChange} + +The first option in the Speech Settings category is the Change... button. This button activates the [Select Synthesizer](#SelectSynthesizer) dialog, which allows you to select the active speech synthesizer and output device. +This dialog opens on top of the NVDA Settings dialog. +Saving or dismissing the settings in the Select Synthesizer dialog will return you to the NVDA Settings dialog. + +##### Voice {#SpeechSettingsVoice} + +The Voice option is a combo box listing all the voices of the current synthesizer that you have installed. +You can use the arrow keys to listen to all the various choices. +Left and Up arrow take you up in the list, while right and down arrow move you down in the list. + +##### Variant {#SpeechSettingsVariant} + +If you are using the Espeak NG synthesizer which is packaged with NVDA, this is a combo box that allows you to select the Variant the synthesizer should speak with. +ESpeak NG's Variants are rather like voices, as they provide slightly different attributes to the eSpeak NG voice. +Some variants will sound like a male, some like a female, and some even like a frog. +If using a third-party synthesizer, you may also be able to change this value if your chosen voice supports it. + +##### Rate {#SpeechSettingsRate} + +This option allows you to change the rate of your voice. +This is a slider that goes from 0 to 100 - 0 being the slowest, 100 being the fastest. + +##### Rate boost {#SpeechSettingsRateBoost} + +Enabling this option will significantly increase the speech rate, if supported by the current synthesizer. + +##### Pitch {#SpeechSettingsPitch} + +This option allows you to change the pitch of the current voice. +It is a slider which goes from 0 to 100 - 0 being the lowest pitch and 100 being the highest. + +##### Volume {#SpeechSettingsVolume} + +This option is a slider which goes from 0 to 100 - 0 being the lowest volume and 100 being the highest. + +##### Inflection {#SpeechSettingsInflection} + +This option is a slider that lets you choose how much inflection (rise and fall in pitch) the synthesizer should use to speak with. + +##### Automatic Language switching {#SpeechSettingsLanguageSwitching} + +This checkbox allows you to toggle whether NVDA should switch speech synthesizer languages automatically if the text being read specifies its language. +This option is enabled by default. + +##### Automatic Dialect switching {#SpeechSettingsDialectSwitching} + +This checkbox allows you to toggle whether or not dialect changes should be made, rather than just actual language changes. +For example, if reading in an English U.S. voice but a document specifies that some text is in English U.K., then the synthesizer will switch accents if this option is enabled. +This option is disabled by default. + + + +##### Punctuation/Symbol Level {#SpeechSettingsSymbolLevel} + +Key: NVDA+p + +This allows you to choose the amount of punctuation and other symbols that should be spoken as words. +For example, when set to all, all symbols will be spoken as words. +This option applies to all synthesizers, not just the currently active synthesizer. + +##### Trust voice's language when processing characters and symbols {#SpeechSettingsTrust} + +On by default, this option tells NVDA if the current voice's language can be trusted when processing symbols and characters. +If you find that NVDA is reading punctuation in the wrong language for a particular synthesizer or voice, you may wish to turn this off to force NVDA to use its global language setting instead. + +##### Unicode normalization {#SpeechUnicodeNormalization} +| . {.hideHeaderRow} |.| +|---|---| +|Options |Default (Disabled), Enabled, Disabled| +|Default |Disabled| + +When this option is enabled, unicode normalization is performed on the text that is spoken by NVDA. +This is beneficial when speaking characters that can be represented in several forms. +NVDA uses the NFKC (Normalization Form Compatibility Composition) algorithm, which provides the following benefits, among others: + +1. The bold and italic versions of characters that are part of the unicode standard and are commonly used on social media are normalized to their most common compatible equivalent. +For example, the latin letter "h" can also be presented as "𝐡" (bold), "ℎ" (itallic), etc. but will always be spoken as "h" when normalization is enabled. +This aspect of normalization also aids in reading equations in the Microsoft Word equation editor. + +1. Normalization to composed characters. +For example, the character "ü" (u with umlaut/diaeresis), a common character in languages like German and Turkish can be represented in two forms: + 1. One stand alone unicode character (ü) + 1. A decomposition into two characters (ü), namely the normal latin letter u and a diaeresis modifier + Unicode normalization ensures that only one form will be used throughout all speech output, which is the one character variant. + +1. Decomposition of some ligatures, Including "ij" (ligature ij) to their two letter form ("ij"). + +1. Stable ordering of modifiers in composite characters, for example in ancient Hebrew. + +To toggle Unicode normalization from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + +##### Report "Normalized" when navigating by character {#SpeechReportNormalizedForCharacterNavigation} + +This setting is a checkbox that, when checked, tells NVDA to explicitly report that a character is normalized when spoken as an individual character such as when spelling. +For example, when this option is enabled, spelling the character "ij" will pronounce it as "i j normalized". + +Note that this setting is only available when "[Unicode normalization](#SpeechUnicodeNormalization)" is enabled. + +##### Include Unicode Consortium data (including emoji) when processing characters and symbols {#SpeechSettingsCLDR} + +When this checkbox is checked, NVDA will include additional symbol pronunciation dictionaries when pronouncing characters and symbols. +These dictionaries contain descriptions for symbols (particularly emoji) that are provided by the [Unicode Consortium](https://www.unicode.org/consortium/) as part of their [Common Locale Data Repository](http://cldr.unicode.org/). +If you want NVDA to speak descriptions of emoji characters based on this data, you should enable this option. +However, if you are using a speech synthesizer that supports speaking emoji descriptions natively, you may wish to turn this off. + +Note that manually added or edited character descriptions are saved as part of your user settings. +Therefore, if you change the description of a particular emoji, your custom description will be spoken for that emoji regardless of whether this option is enabled. +You can add, edit or remove symbol descriptions in NVDA's [punctuation/symbol pronunciation dialog](#SymbolPronunciation). + +To toggle Unicode Consortium data inclusion from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + +##### Capital pitch change percentage {#SpeechSettingsCapPitchChange} + +This edit field allows you to type the amount that the pitch of the voice will change when speaking a capital letter. +This value is a percentage, where a negative value lowers the pitch and a positive value raises it. +For no pitch change you would use 0. +Usually, NVDA raises the pitch slightly for any capital letter, but some synthesizers may not support this well. +In case pitch change for capitals is not supported, consider [Say "cap" before capitals](#SpeechSettingsSayCapBefore) and/or [ Beep for capitals](#SpeechSettingsBeepForCaps) instead. + +##### Say "cap" before capitals {#SpeechSettingsSayCapBefore} + +This setting is a checkbox that, when checked, tells NVDA to say the word "cap" before any capital letter when spoken as an individual character such as when spelling. + +##### Beep for capitals {#SpeechSettingsBeepForCaps} + +If this checkbox is checked, NVDA will make a small beep each time it encounters a capitalized character by itself. + +##### Use spelling functionality if supported {#SpeechSettingsUseSpelling} + +Some words consist of only one character, but the pronunciation is different depending on whether the character is being spoken as an individual character (such as when spelling) or a word. +For example, in English, "a" is both a letter and a word and is pronounced differently in each case. +This option allows the synthesizer to differentiate between these two cases if the synthesizer supports this. +Most synthesizers do support it. + +This option should generally be enabled. +However, some Microsoft Speech API synthesizers do not implement this correctly and behave strangely when it is enabled. +Synthesizers from Code Factory, both the add-on and the SAPI application, do not implement it correctly either and cause unwanted spelling of the spoken text (e.g. in NVDA menu or dialogs). +If you are having problems with the pronunciation of individual characters, try disabling this option. + +##### Delayed descriptions for characters on cursor movement {#delayedCharacterDescriptions} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Enabled, Disabled| +|Default |Disabled| + +When this setting is checked, NVDA will say the character description when you move by characters. + +For example, while reviewing a line by characters, when the letter "b" is read NVDA will say "Bravo" after a 1 second delay. +This can be useful if it is hard to distinguish between pronunciation of symbols, or for hearing impaired users. + +The delayed character description will be cancelled if other text is spoken during that time, or if you press the `control` key. + +##### Modes available in the Cycle speech mode command {#SpeechModesDisabling} + +This checkable list allows selecting which [speech modes](#SpeechModes) are included when cycling between them using `NVDA+s`. +Modes which are unchecked are excluded. +By default all modes are included. + +For example if you do not need to use "beeps" and "off" mode you should uncheck these two, and keep both "talk" and "on-demand" checked. +Note that it is necessary to check at least two modes. + +#### Select Synthesizer {#SelectSynthesizer} + + + +##### Open Select Synthesizer dialog {#OpenSelectSynthesizer} + +Key: `NVDA+control+s` + +The Synthesizer dialog, which can be opened by activating the Change... button in the speech category of the NVDA settings dialog, allows you to select which Synthesizer NVDA should use to speak with. +Once you have selected your synthesizer of choice, you can press Ok and NVDA will load the selected Synthesizer. +If there is an error loading the synthesizer, NVDA will notify you with a message, and continue using the previous synthesizer. + +##### Synthesizer {#SelectSynthesizerSynthesizer} + +This option allows you to choose the synthesizer you wish NVDA to use for speech output. + +For a list of the Synthesizers that NVDA supports, please see the [Supported Speech Synthesizers](#SupportedSpeechSynths) section. + +One special item that will always appear in this list is "No speech", which allows you to use NVDA with no speech output whatsoever. +This may be useful for someone who wishes to only use NVDA with braille, or perhaps to sighted developers who only wish to use the Speech Viewer. + +#### Synth settings ring {#SynthSettingsRing} + +If you wish to quickly change speech settings without going to the Speech category of the NVDA settings dialog, there are some NVDA key commands that allow you to move through the most common speech settings from anywhere while running NVDA: + + +| Name |Desktop key |Laptop key |Description| +|---|---|---|---| +|Move to next synth setting |NVDA+control+rightArrow |NVDA+shift+control+rightArrow |Moves to the next available speech setting after the current, wrapping around to the first setting again after the last| +|Move to previous synth setting |NVDA+control+leftArrow |NVDA+shift+control+leftArrow |Moves to the next available speech setting before the current, wrapping around to the last setting after the first| +|Increment current synth setting |NVDA+control+upArrow |NVDA+shift+control+upArrow |increases the current speech setting you are on. E.g. increases the rate, chooses the next voice, increases the volume| +|Increment the current synth setting in a larger step |`NVDA+control+pageUp` |`NVDA+shift+control+pageUp` |Increases the value of the current speech setting you're on in larger steps. e.g. when you're on a voice setting, it will jump forward every 20 voices; when you're on slider settings (rate, pitch, etc) it will jump forward the value up to 20%| +|Decrement current synth setting |NVDA+control+downArrow |NVDA+shift+control+downArrow |decreases the current speech setting you are on. E.g. decreases the rate, chooses the previous voice, decreases the volume| +|Decrement the current synth setting in a larger step |`NVDA+control+pageDown` |`NVDA+shift+control+pageDown` |Decreases the value of the current speech setting you're on in larger steps. e.g. when you're on a voice setting, it will jump backward every 20 voices; when you're on a slider setting, it will jump backward the value up to 20%| + + + +#### Braille {#BrailleSettings} + +The Braille category in the NVDA Settings dialog contains options that let you change several aspects of braille input and output. +This category contains the following options: + +##### Change braille display {#BrailleSettingsChange} + +The Change... button in the Braille category of the NVDA Settings dialog activates the [Select Braille Display](#SelectBrailleDisplay) dialog, which allows you to select the active braille display. +This dialog opens on top of the NVDA Settings dialog. +Saving or dismissing the settings in the Select Braille Display dialog will return you to the NVDA Settings dialog. + +##### Output Table {#BrailleSettingsOutputTable} + +The next option you will come to in this category is the braille output table combo box. +In this combo box, you will find braille tables for different languages, braille standards and grades. +The chosen table will be used to translate text into braille to be presented on your braille display. +You can move from braille table to braille table in the list by using the arrow keys. + +##### Input Table {#BrailleSettingsInputTable} + +Complementary to the previous option, the next setting you will find is the braille input table combo box. +The chosen table will be used to translate braille entered on your braille display's Perkins-style keyboard into text. +You can move from braille table to braille table in the list by using the arrow keys. + +Note that this option is only useful if your braille display has a Perkins-style keyboard and this feature is supported by the braille display driver. +If input is not supported on a display which does have a braille keyboard, this will be noted in the [Supported Braille Displays](#SupportedBrailleDisplays) section. + + + +##### Braille mode {#BrailleMode} + +Key: `NVDA+alt+t` + +This option allows you to select between the available braille modes. + +Currently, two braille modes are supported, "follow cursors" and "display speech output". + +When follow cursors is selected, the braille display will follow either the system focus/caret or the navigator object/review cursor, depending on what braille is tethered to. + +When display speech output is selected, the braille display will show what NVDA speaks, or would have spoken if speech mode was set to "talk". + +##### Expand to computer braille for the word at the cursor {#BrailleSettingsExpandToComputerBraille} + +This option allows the word that is under the cursor to be displayed in non-contracted computer braille. + +##### Show Cursor {#BrailleSettingsShowCursor} + +This option allows the braille cursor to be turned on and off. +It applies to the system caret and review cursor, but not to the selection indicator. + +##### Blink Cursor {#BrailleSettingsBlinkCursor} + +This option allows the braille cursor to blink. +If blinking is turned off, the braille cursor will constantly be in the "up" position. +The selection indicator is not affected by this option, it is always dots 7 and 8 without blinking. + +##### Cursor Blink Rate (ms) {#BrailleSettingsBlinkRate} + +This option is a numerical field that allows you to change the blink rate of the cursor in milliseconds. + +##### Cursor Shape for Focus {#BrailleSettingsCursorShapeForFocus} + +This option allows you to choose the shape (dot pattern) of the braille cursor when braille is tethered to focus. +The selection indicator is not affected by this option, it is always dots 7 and 8 without blinking. + +##### Cursor Shape for Review {#BrailleSettingsCursorShapeForReview} + +This option allows you to choose the shape (dot pattern) of the braille cursor when braille is tethered to review. +The selection indicator is not affected by this option, it is always dots 7 and 8 without blinking. + +##### Show Messages {#BrailleSettingsShowMessages} + +This is a combobox that allows you to select if NVDA should display braille messages and when they should disappear automatically. + +To toggle show messages from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + +##### Message Timeout (sec) {#BrailleSettingsMessageTimeout} + +This option is a numerical field that controls how long NVDA messages are displayed on the braille display. +The NVDA message is immediately dismissed when pressing a routing key on the braille display, but appears again when pressing a corresponding key which triggers the message. +This option is shown only if "Show Messages" is set to "Use timeout". + + + +##### Tether Braille {#BrailleTether} + +Key: NVDA+control+t + +This option allows you to choose whether the braille display will follow the system focus / caret, the navigator object / review cursor, or both. +When "automatically" is selected, NVDA will follow the system focus and caret by default. +In this case, when the navigator object or the review cursor position is changed by means of explicit user interaction, NVDA will tether to review temporarily, until the focus or the caret changes. +If you want it to follow the focus and caret only, you need to configure braille to be tethered to focus. +In this case, braille will not follow the NVDA navigator during object navigation or the review cursor during review. +If you want braille to follow object navigation and text review instead, you need to configure braille to be tethered to review. +In this case, Braille will not follow system focus and system caret. + +##### Move system caret when routing review cursor {#BrailleSettingsReviewRoutingMovesSystemCaret} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Default (Never), Never, Only when tethered automatically, Always| +|Default |Never| + +This setting determines if the system caret should also be moved with a routing button press. +This option is set to Never by default, meaning that routing will never move the caret when routing the review cursor. + +When this option is set to Always, and [braille tethering](#BrailleTether) is set to "automatically" or "to review", pressing a cursor routing key will also move the system caret or focus when supported. +When the current review mode is [Screen Review](#ScreenReview), there is no physical caret. +In this case, NVDA tries to focus the object under the text you're routing to. +The same applies to [object review](#ObjectReview). + +You can also set this option to only move the caret when tethered automatically. +In that case, pressing a cursor routing key will only move the system caret or focus when NVDA is tethered to the review cursor automatically, whereas no movement will occur when manually tethered to the review cursor. + +This option is shown only if "[tether braille](#BrailleTether)" is set to "automatically" or "to review". + +To toggle move system caret when routing review cursor from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + +##### Read by Paragraph {#BrailleSettingsReadByParagraph} + +If enabled, braille will be displayed by paragraphs instead of lines. +Also, the next and previous line commands will move by paragraph accordingly. +This means that you do not have to scroll the display at the end of each line even where more text would fit on the display. +This may allow for more fluent reading of large amounts of text. +It is disabled by default. + +##### Avoid splitting words when possible {#BrailleSettingsWordWrap} + +If this is enabled, a word which is too large to fit at the end of the braille display will not be split. +Instead, there will be some blank space at the end of the display. +When you scroll the display, you will be able to read the entire word. +This is sometimes called "word wrap". +Note that if the word is too large to fit on the display even by itself, the word must still be split. + +If this is disabled, as much of the word as possible will be displayed, but the rest will be cut off. +When you scroll the display, you will then be able to read the rest of the word. + +Enabling this may allow for more fluent reading, but generally requires you to scroll the display more. + +##### Unicode normalization {#BrailleUnicodeNormalization} +| . {.hideHeaderRow} |.| +|---|---| +|Options |Default (Disabled), Enabled, Disabled| +|Default |Disabled| + +When this option is enabled, unicode normalization is performed on the text that is brailled on the braille display. +This is beneficial when coming across characters in braille that are unknown in a particular braille table and which have a compatible alternative, like the bold and italic characters commonly used on social media. +Other benefits of unicode normalization are explained in greater detail in the [section for the equivalent speech setting](#SpeechUnicodeNormalization). + +To toggle Unicode normalization from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + +##### Focus context presentation {#BrailleSettingsFocusContextPresentation} + +This option allows you to choose what context information NVDA will show on the braille display when an object gets focus. +Context information refers to the hierarchy of objects containing the focus. +For example, when you focus a list item, this list item is part of a list. +This list might be contained by a dialog, etc. +Please consult the section about [object navigation](#ObjectNavigation) for more information about the hierarchy that applies to objects in NVDA. + +When set to fill display for context changes, NVDA will try to display as much context information as possible on the braille display, but only for the parts of the context that have changed. +For the example above, this means that when changing focus to the list, NVDA will show the list item on the braille display. +Furthermore, if there is enough space left on the braille display, NVDA will try to show that the list item is part of a list. +If you then start moving through the list with your arrow keys, it is assumed that you are aware that you are still in the list. +Thus, for the remaining list items you focus, NVDA will only show the focused list item on the display. +In order for you to read the context again (i.e. that you are in a list and that the list is part of a dialog), you will have to scroll your braille display back. + +When this option is set to always fill the display, NVDA will try to show as much context information as possible on the braille display, regardless of whether you have seen the same context information before. +This has the advantage that NVDA will fit as much information as possible on the display. +However, the downside is that there is always a difference in the position where the focus starts on the braille display. +This can make it difficult to skim a long list of items, for example, as you will need to continually move your finger to find the start of the item. +This was the default behaviour for NVDA 2017.2 and before. + +When you set the focus context presentation option to only show the context information when scrolling back, NVDA never shows context information on your braille display by default. +Thus, in the example above, NVDA will display that you focused a list item. +However, in order for you to read the context (i.e. that you are in a list and that the list is part of a dialog), you will have to scroll your braille display back. + +To toggle focus context presentation from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + +##### Interrupt speech while scrolling {#BrailleSettingsInterruptSpeech} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Default (Enabled), Enabled, Disabled| +|Default |Enabled| + +This setting determines if speech should be interrupted when the Braille display is scrolled backwards/forwards. +Previous/next line commands always interrupt speech. + +On-going speech might be a distraction while reading Braille. +For this reason the option is enabled by default, interrupting speech when scrolling braille. + +Disabling this option allows speech to be heard while simultaneously reading Braille. + +##### Show selection {#BrailleSettingsShowSelection} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Default (Enabled), Enabled, Disabled| +|Default |Enabled| + +This setting determines if selection indicator (dots 7 and 8) is shown by the braille display. +The option is enabled by default so the selection indicator is shown. +The selection indicator might be a distraction while reading. +Disabling this option may improve readability. + +To toggle show selection from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + +#### Select Braille Display {#SelectBrailleDisplay} + + + +##### Open Select Braille Display dialog {#OpenSelectBrailleDisplay} + +Key: `NVDA+control+a` + +The Select Braille Display dialog, which can be opened by activating the Change... button in the Braille category of the NVDA settings dialog, allows you to select which Braille display NVDA should use for braille output. +Once you have selected your braille display of choice, you can press Ok and NVDA will load the selected display. +If there is an error loading the display driver, NVDA will notify you with a message, and continue using the previous display, if any. + +##### Braille Display {#SelectBrailleDisplayDisplay} + +This combo box presents you with several options depending on what braille display drivers are available on your system. +Move between these options with the arrow keys. + +The automatic option will allow NVDA to search for many supported braille displays in the background. +When this feature is enabled and you connect a supported display using USB or bluetooth, NVDA will automatically connect with this display. + +No braille means that you are not using braille. + +Please see the [Supported Braille Displays](#SupportedBrailleDisplays) section for more information about supported braille displays and which of these support automatic detection in the background. + +##### Displays to detect automatically {#SelectBrailleDisplayAutoDetect} + +When braille display is set to "Automatic", the check boxes in this list control allows you to enable and disable display drivers that will be involved in the automatic detection process. +This allows you to exclude braille display drivers you do not use on a regular basis. +For example, if you only own a display that requires the Baum driver to function, you may leave the Baum driver enabled whereas the other drivers can be disabled. + +By default, all drivers that support automatic detection are enabled. +Any driver added, for example in a future version of NVDA or in an add-on, will also be enabled by default. + +You may consult the documentation for your braille display in the section [Supported Braille Displays](#SupportedBrailleDisplays) to check whether the driver supports automatic detection of displays. + +##### Port {#SelectBrailleDisplayPort} + +This option, if available, allows you to choose what port or type of connection will be used to communicate with the braille display you have selected. +It is a combo box containing the possible choices for your braille display. + +By default, NVDA employs automatic port detection, which means the connection with the braille device will be established automatically by scanning for available USB and bluetooth devices on your system. +However, for some braille displays, you may be able to explicitly choose what port should be used. +Common options are "Automatic" (which tells NVDA to employ the default automatic port selection procedure), "USB", "Bluetooth" and legacy serial communication ports if your braille display supports this type of communication. + +This option won't be available if your braille display only supports automatic port detection. + +You may consult the documentation for your braille display in the section [Supported Braille Displays](#SupportedBrailleDisplays) to check for more details on the supported types of communication and available ports. + +Please note: If you connect multiple Braille Displays to your machine at the same time which use the same driver (E.g. connecting two Seika displays), +it is currently impossible to tell NVDA which display to use. +Therefore it is recommended to only connect one Braille Display of a given type / manufacturer to your machine at a time. + +#### Audio {#AudioSettings} + + + +##### Open Audio settings {#OpenAudioSettings} + +Key: `NVDA+control+u` + +The Audio category in the NVDA Settings dialog contains options that let you change several aspects of audio output. + +##### Output device {#SelectSynthesizerOutputDevice} + +This option allows you to choose the audio device that NVDA should instruct the selected synthesizer to speak through. + + + +##### Audio Ducking Mode {#SelectSynthesizerDuckingMode} + +Key: `NVDA+shift+d` + +This option allows you to choose if NVDA should lower the volume of other applications while NVDA is speaking, or all the time while NVDA is running. + +* No Ducking: NVDA will never lower the volume of other audio. +* Duck when outputting speech and sounds: NVDA will only lower the volume of other audio when NVDA is speaking or playing sounds. This may not work for all synthesizers. +* Always duck: NVDA will keep the volume of other audio lower the whole time NVDA is running. + +This option is only available if NVDA has been installed. +It is not possible to support audio ducking for portable and temporary copies of NVDA. + +##### Volume of NVDA sounds follows voice volume {#SoundVolumeFollowsVoice} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Disabled, Enabled| +|Default |Disabled| + +When this option is enabled, the volume of NVDA sounds and beeps will follow the volume setting of the voice you are using. +If you decrease the volume of the voice, the volume of sounds will decrease. +Similarly, if you increase the volume of the voice, the volume of sounds will increase. +This option is not available if you have started NVDA with [WASAPI disabled for audio output](#WASAPI) in Advanced Settings. + +##### Volume of NVDA sounds {#SoundVolume} + +This slider allows you to set the volume of NVDA sounds and beeps. +This setting only takes effect when "Volume of NVDA sounds follows voice volume" is disabled. +This option is not available if you have started NVDA with [WASAPI disabled for audio output](#WASAPI) in Advanced Settings. + +##### Sound split {#SelectSoundSplitMode} + +The sound split feature allows users to make use of their stereo output devices, such as headphones and speakers. +Sound split makes it possible to have NVDA speech in one channel (e.g. left) and have all other applications play their sounds in the other channel (e.g. right). +By default sound split is disabled. +A gesture allows cycling through the various sound split modes: + + +| Name |Key |Description| +|---|---|---| +|Cycle Sound Split Mode |`NVDA+alt+s` |Cycles between sound split modes.| + + + +By default this command will cycle between the following modes: + +* Sound split disabled: NVDA does not apply any sound split processing. +* NVDA on the left and applications on the right: NVDA will speak in the left channel, while other applications will play sounds in the right channel. +* NVDA on the left and applications in both channels: NVDA will speak in the left channel, while other applications will play sounds in both left and right channels. + +There are more advanced sound split modes available in NVDA setting combo box. +Among these modes, "NVDA in both channels and applications in both channels" forces all the sounds to be directed in both channels. +This mode may differ from "Sound split disabled" mode in case other audio processing interfers with channel volumes. + +Please note, that sound split doesn't work as a mixer. +For example, if an application is playing a stereo sound track while sound split is set to "NVDA on the left and applications on the right", then you will only hear the right channel of the sound track, while the left channel of the sound track will be muted. + +This option is not available if you have started NVDA with [WASAPI disabled for audio output](#WASAPI) in Advanced Settings. + +Please note, that if NVDA crashes, then it won't be able to restore application sounds volume, and those applications might still output sound only in one channel after NVDA crash. +In order to mitigate this, please restart NVDA and select the mode "NVDA in both channels and applications in both channels". + +##### Customizing Sound split modes {#CustomizeSoundSplitModes} + +This checkable list allows selecting which sound split modes are included when cycling between them using `NVDA+alt+s`. +Modes which are unchecked are excluded. +By default only three modes are included. + +* Sound split disabled. +* NVDA on the left and applications on the right. +* NVDA on the left and applications in both channels. + +Note that it is necessary to check at least one mode. +This option is not available if you have started NVDA with [WASAPI disabled for audio output](#WASAPI) in Advanced Settings. + +##### Time to keep audio device awake after speech {#AudioAwakeTime} + +This edit box specifies how long NVDA keeps the audio device awake after speech ends. +This allows NVDA to avoid certain speech glitches like dropped parts of words. +This can happen due to audio devices (especially Bluetooth and wireless devices) entering standby mode. +This might also be helpful in other use cases, such as when running NVDA inside a virtual machine (e.g. Citrix Virtual Desktop), or on certain laptops. + +Lower values may allow audio to be cut-off more often, as a device may enter standby mode too soon, causing the start of the following speech to be clipped. +Setting the value too high may cause the battery of the sound output device to discharge faster, as it stays active for longer while no sound is being sent. + +You can set the time to zero in order to disable this feature. + +#### Vision {#VisionSettings} + +The Vision category in the NVDA Settings dialog allows you to enable, disable and configure [visual aids](#Vision). + +Note that the available options in this category could be extended by [NVDA add-ons](#AddonsManager). +By default, this settings category contains the following options: + +##### Visual Highlight {#VisionSettingsFocusHighlight} + +The check boxes in the Visual Highlight grouping control the behaviour of NVDA's built-in [Visual Highlight](#VisionFocusHighlight) facility. + +* Enable Highlighting: Toggles Visual Highlight on and off. +* Highlight system focus: toggles whether the [system focus](#SystemFocus) will be highlighted. +* Highlight navigator object: toggles whether the [navigator object](#ObjectNavigation) will be highlighted. +* Highlight browse mode cursor: Toggles whether the [virtual browse mode cursor](#BrowseMode) will be highlighted. + +Note that checking and unchecking the "Enable Highlighting" check box wil also change the state of the tree other check boxes accordingly. +Therefore, if "Enable Highlighting" is off and you check this check box, the other tree check boxes will also be checked automatically. +If you only want to highlight the focus and leave the navigator object and browse mode check boxes unchecked, the state of the "Enable Highlighting" check box will be half checked. + +##### Screen Curtain {#VisionSettingsScreenCurtain} + +You can enable the [Screen Curtain](#VisionScreenCurtain) by checking the "Make screen black (immediate effect)" check box. +A warning that your screen will become black after activation will be displayed. +Before continuing (selecting "Yes"), ensure you have enabled speech / braille and will be able to control your computer without the use of the screen. +Select "No" if you no longer wish to enable the Screen Curtain. +If you are sure, you can choose the Yes button to enable the screen curtain. +If you no longer want to see this warning message every time, you can change this behaviour in the dialog that displays the message. +You can always restore the warning by checking the "Always show a warning when loading Screen Curtain" check box next to the "Make screen black" check box. + +By default, sounds are played when the Screen Curtain is toggled. +When you want to change this behaviour, you can uncheck the "Play sound when toggling Screen Curtain" check box. + +##### Settings for third party visual aids {#VisionSettingsThirdPartyVisualAids} + +Additional vision enhancement providers can be provided in [NVDA add-ons](#AddonsManager). +When these providers have adjustable settings, they will be shown in this settings category in separate groupings. +For the supported settings per provider, please refer to the documentation for that provider. + +#### Keyboard {#KeyboardSettings} + + + +##### Open Keyboard settings {#OpenKeyboardSettings} + +Key: `NVDA+control+k` + +The Keyboard category in the NVDA Settings dialog contains options that set how NVDA behaves as you use and type on your keyboard. +This settings category contains the following options: + +##### Keyboard layout {#KeyboardSettingsLayout} + +This combo box lets you choose what type of keyboard layout NVDA should use. Currently the two that come with NVDA are Desktop and Laptop. + +##### Select NVDA Modifier Keys {#KeyboardSettingsModifiers} + +The checkboxes in this list control what keys can be used as [NVDA modifier keys](#TheNVDAModifierKey). The following keys are available to choose from: + +* The Caps Lock key +* The insert key on the number pad +* The extended insert key (usually found above the arrow keys, near home and end) + +If no key is chosen as the NVDA key it may be impossible to access many NVDA commands, therefore you are required to check at least one of the modifiers. + + + +##### Speak Typed Characters {#KeyboardSettingsSpeakTypedCharacters} + +Key: NVDA+2 + +When enabled, NVDA will announce all characters you type on the keyboard. + + + +##### Speak Typed Words {#KeyboardSettingsSpeakTypedWords} + +Key: NVDA+3 + +When enabled, NVDA will announce all words you type on the keyboard. + +##### Speech interrupt for typed characters {#KeyboardSettingsSpeechInteruptForCharacters} + +If on, this option will cause speech to be interrupted each time a character is typed. This is on by default. + +##### Speech interrupt for Enter key {#KeyboardSettingsSpeechInteruptForEnter} + +If on, this option will cause speech to be interrupted each time the Enter key is pressed. This is on by default. + +##### Allow skim reading in Say All {#KeyboardSettingsSkimReading} + +If on, certain navigation commands (such as quick navigation in browse mode or moving by line or paragraph) do not stop Say All, rather Say All jumps to the new position and continues reading. + +##### Beep if Typing Lowercase Letters when Caps Lock is On {#KeyboardSettingsBeepLowercase} + +When enabled, a warning beep will be heard if a letter is typed with the shift key while Caps Lock is on. +Generally, typing shifted letters with Caps Lock is unintentional and is usually due to not realizing that Caps Lock is enabled. +Therefore, it can be quite helpful to be warned about this. + + + +##### Speak Command Keys {#KeyboardSettingsSpeakCommandKeys} + +Key: NVDA+4 + +When enabled, NVDA will announce all non-character keys you type on the keyboard. This includes key combinations such as control plus another letter. + +##### Play sound for spelling errors while typing {#KeyboardSettingsAlertForSpellingErrors} + +When enabled, a short buzzer sound will be played when a word you type contains a spelling error. +This option is only available if reporting of spelling errors is enabled in NVDA's [Document Formatting Settings](#DocumentFormattingSettings), found in the NVDA Settings dialog. + +##### Handle keys from other applications {#KeyboardSettingsHandleKeys} + +This option allows the user to control if key presses generated by applications such as on-screen keyboards and speech recognition software should be processed by NVDA. +This option is on by default, though certain users may wish to turn this off, such as those typing Vietnamese with the UniKey typing software as it will cause incorrect character input. + +#### Mouse {#MouseSettings} + + + +##### Open Mouse settings {#OpenMouseSettings} + +Key: `NVDA+control+m` + +The Mouse category in the NVDA Settings dialog allows NVDA to track the mouse, play mouse coordinate beeps and sets other mouse usage options. +This category contains the following options: + +##### Report Mouse Shape Changes {#MouseSettingsShape} + +A checkbox, that when checked means that NVDA will announce the shape of the mouse pointer each time it changes. +The mouse pointer in Windows changes shape to convey certain information such as when something is editable, or when something is loading etc. + + + +##### Enable mouse tracking {#MouseSettingsTracking} + +Key: NVDA+m + +When enabled, NVDA will announce the text currently under the mouse pointer, as you move it around the screen. This allows you to find things on the screen, by physically moving the mouse, rather than trying to find them through object navigation. + +##### Text unit resolution {#MouseSettingsTextUnit} + +If NVDA is set to announce the text under the mouse as you move it, this option allows you to choose exactly how much text will be spoken. +The options are character, word, line and paragraph. + +To toggle text unit resolution from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + +##### Report object when mouse enters it {#MouseSettingsRole} + +If this checkbox is checked, NVDA will announce information about objects as the mouse moves inside them. +This includes the role (type) of the object as well as states (checked/pressed), cell coordinates in tables, etc. +Note that the announcement of some object details might be dependent on how other settings are set, such as in the [object presentation](#ObjectPresentationSettings) or [Document Formatting](#DocumentFormattingSettings) categories. + +##### Play audio coordinates when mouse moves {#MouseSettingsAudio} + +Checking this checkbox makes NVDA play beeps as the mouse moves, so that the user can work out where the mouse is in regards to the dimensions of the screen. +The higher the mouse is on the screen, the higher the pitch of the beeps. +The further left or right the mouse is located on the screen, the further left or right the sound will be played (assuming the user has stereo speakers or headphones). + +##### Brightness controls audio coordinates volume {#MouseSettingsBrightness} + +If the "play audio coordinates when mouse moves" checkbox is checked, then checking this checkbox means that the volume of the audio coordinates beeps is controlled by how bright the screen is under the mouse. +This setting is unchecked by default. + +##### Ignore mouse input from other applications {#MouseSettingsHandleMouseControl} + +This option allows the user to ignore mouse events (including mouse movement and button presses) generated by other applications such as TeamViewer and other remote control software. +This option is unchecked by default. +If you check this option and you have the "Enable mouse tracking" option enabled, NVDA will not announce what is under the mouse if the mouse is moved by another application. + +#### Touch Interaction {#TouchInteraction} + +This settings category, only available on computers with touch capabilities, allows you to configure how NVDA interacts with touchscreens. +This category contains the following options: + +##### Enable touch interaction support {#TouchSupportEnable} + +This checkbox enables NVDA's touch interaction support. +If enabled, you can use your fingers to navigate and interact with items on screen using a touchscreen device. +If disabled, touchscreen support will be disabled as though NVDA is not running. +This setting can also be toggled using NVDA+control+alt+t. + +##### Touch typing mode {#TouchTypingMode} + +This checkbox allows you to specify the method you wish to use when entering text using the touch keyboard. +If this checkbox is checked, when you locate a key on the touch keyboard, you can lift your finger and the selected key will be pressed. +If this is unchecked, you need to double-tap on the key of the touch keyboard to press the key. + +#### Review Cursor {#ReviewCursorSettings} + +The Review Cursor category in the NVDA Settings dialog is used to configure NVDA's review cursor behaviour. +This category contains the following options: + + + +##### Follow System Focus {#ReviewCursorFollowFocus} + +Key: NVDA+7 + +When enabled, The review cursor will always be placed in the same object as the current system focus whenever the focus changes. + + + +##### Follow System Caret {#ReviewCursorFollowCaret} + +Key: NVDA+6 + +When enabled, the review cursor will automatically be moved to the position of the System caret each time it moves. + +##### Follow mouse cursor {#ReviewCursorFollowMouse} + +When enabled, the review cursor will follow the mouse as it moves. + +##### Simple Review mode {#ReviewCursorSimple} + +When enabled, NVDA will filter the hierarchy of objects that can be navigated to exclude objects that aren't of interest to the user; e.g. invisible objects and objects used only for layout purposes. + +To toggle simple review mode from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + +#### Object Presentation {#ObjectPresentationSettings} + + + +##### Open Object Presentation settings {#OpenObjectPresentationSettings} + +Key: `NVDA+control+o` + +The Object Presentation category in the NVDA Settings dialog is used to set how much information NVDA will present about controls such as description, position information and so on. +These options don't typically apply to browse mode. +These options typically apply to focus reporting and NVDA object navigation, but not reading text content e.g. browse mode. + +##### Report tooltips {#ObjectPresentationReportToolTips} + +A checkbox that when checked tells NVDA to report tooltips as they appear. +Many Windows and controls show a small message (or tooltip) when you move the mouse pointer over them, or sometimes when you move the focus to them. + +##### Report notifications {#ObjectPresentationReportNotifications} + +This checkbox, when checked, tells NVDA to report help balloons and toast notifications as they appear. + +* Help Balloons are like tooltips, but are usually larger in size, and are associated with system events such as a network cable being unplugged, or perhaps to alert you about Windows security issues. +* Toast notifications have been introduced in Windows 10 and appear in the notification centre in the system tray, informing about several events (i.e. if an update has been downloaded, a new e-mail arrived in your inbox, etc.). + +##### Report Object Shortcut Keys {#ObjectPresentationShortcutKeys} + +When this checkbox is checked, NVDA will include the shortcut key that is associated with a certain object or control when it is reported. +For example the File menu on a menu bar may have a shortcut key of alt+f. + +##### Report object position information {#ObjectPresentationPositionInfo} + +This option lets you choose whether you wish to have an object's position (e.g. 1 of 4) reported when moving to the object with the focus or object navigation. + +##### Guess Object Position Information when unavailable {#ObjectPresentationGuessPositionInfo} + +If reporting of object position information is turned on, this option allows NVDA to guess object position information when it is otherwise unavailable for a particular control. + +When on, NVDA will report position information for more controls such as menus and toolbars, however this information may be slightly inaccurate. + +##### Report Object descriptions {#ObjectPresentationReportDescriptions} + +Uncheck this checkbox if you don't wish to have the description reported along with objects (i.e. search suggestions, reporting of whole dialog window right after the dialog opens, etc.). + + + +##### Progress bar output {#ObjectPresentationProgressBarOutput} + +Key: NVDA+u + +This option controls how NVDA reports progress bar updates to you. + +It has the following options: + +* Off: Progress bars will not be reported as they change. +* Speak: This option tells NVDA to speak the progress bar in percentages. Each time the progress bar changes, NVDA will speak the new value. +* Beep: This tells NVDA to beep each time the progress bar changes. The higher the beep, the closer the progress bar is to completion. +* Beep and speak: This option tells NVDA to both beep and speak when a progress bar updates. + +##### Report background progress bars {#ObjectPresentationReportBackgroundProgressBars} + +This is an option that, when checked, tells NVDA to keep reporting a progress bar, even if it is not physically in the foreground. +If you minimize or switch away from a window that contains a progress bar, NVDA will keep track of it, allowing you to do other things while NVDA tracks the progress bar. + + + +##### Report dynamic content changes {#ObjectPresentationReportDynamicContent} + +Key: NVDA+5 + +Toggles the announcement of new content in particular objects such as terminals and the history control in chat programs. + +##### Play a sound when auto-suggestions appear {#ObjectPresentationSuggestionSounds} + +Toggles announcement of appearance of auto-suggestions, and if enabled, NVDA will play a sound to indicate this. +Auto-suggestions are lists of suggested entries based on text entered into certain edit fields and documents. +For example, when you enter text into the search box in Start menu in Windows Vista and later, Windows displays a list of suggestions based on what you typed. +For some edit fields such as search fields in various Windows 10 apps, NVDA can notify you that a list of suggestions has appeared when you type text. +The auto-suggestions list will close once you move away from the edit field, and for some fields, NVDA can notify you of this when this happens. + +#### Input Composition {#InputCompositionSettings} + +The Input Composition category allows you to control how NVDA reports the input of Asian characters, such as with IME or Text Service input methods. +Note that due to the fact that input methods vary greatly by available features and by how they convey information, it will most likely be necessary to configure these options differently for each input method to get the most efficient typing experience. + +##### Automatically report all available candidates {#InputCompositionReportAllCandidates} + +This option, which is on by default, allows you to choose whether or not all visible candidates should be reported automatically when a candidate list appears or its page is changed. +Having this option on for pictographic input methods such as Chinese New ChangJie or Boshiami is useful, as you can automatically hear all symbols and their numbers and you can choose one right away. +However, for phonetic input methods such as Chinese New Phonetic, it may be more useful to turn this option off, as all the symbols will sound the same and you will have to use the arrow keys to navigate the list items individually to gain more information from the character descriptions for each candidate. + +##### Announce Selected Candidate {#InputCompositionAnnounceSelectedCandidate} + +This option, which is on by default, allows you to choose whether NVDA should announce the selected candidate when a candidate list appears or when the selection is changed. +For input methods where the selection can be changed with the arrow keys (such as Chinese New Phonetic) this is necessary, but for some input methods it may be more efficient typing with this option turned off. +Note that even with this option off, the review cursor will still be placed on the selected candidate allowing you to use object navigation / review to manually read this or other candidates. + +##### Always include short character descriptions for candidates {#InputCompositionCandidateIncludesShortCharacterDescription} + +This option, which is on by default, allows you to choose whether or not NVDA should provide a short description for each character in a candidate, either when it's selected or when it's automatically read when the candidate list appears. +Note that for locales such as Chinese, the announcement of extra character descriptions for the selected candidate is not affected by this option. +This option may be useful for Korean and Japanese input methods. + +##### Report changes to the reading string {#InputCompositionReadingStringChanges} + +Some input methods such as Chinese New Phonetic and New ChangJie have a reading string (sometimes known as a precomposition string). +You can choose whether or not NVDA should announce new characters being typed into this reading string with this option. +This option is on by default. +Note some older input methods such as Chinese ChangJie may not use the reading string to hold precomposition characters, but instead use the composition string directly. Please see the next option for configuring reporting of the composition string. + +##### Report changes to the composition string {#InputCompositionCompositionStringChanges} + +After reading or precomposition data has been combined into a valid pictographic symbol, most input methods place this symbol into a composition string for temporary storage along with other combined symbols before they are finally inserted into the document. +This option allows you to choose whether or not NVDA should report new symbols as they appear in the composition string. +This option is on by default. + +#### Browse Mode {#BrowseModeSettings} + + + +##### Open Browse Mode settings {#OpenBrowseModeSettings} + +Key: `NVDA+control+b` + +The Browse Mode category in the NVDA Settings dialog is used to configure NVDA's behaviour when you read and navigate complex documents such as web pages. +This category contains the following options: + +##### Maximum Number of Characters on One Line {#BrowseModeSettingsMaxLength} + +This field sets the maximum length of a line in browse mode (in characters). + +##### Maximum Lines Per Page {#BrowseModeSettingsPageLines} + +This field sets the amount of lines you will move by when pressing page up or page down while in browse mode. + + + +##### Use screen layout {#BrowseModeSettingsScreenLayout} + +Key: NVDA+v + +This option allows you to specify whether browse mode should place clickable content (links, buttons and fields) on its own line, or if it should keep it in the flow of text as it is visually shown. +Note that this option doesn't apply to Microsoft Office apps such as Outlook and Word, which always use screen layout. +When screen layout is enabled, page elements will stay as they are visually shown. +For example, a visual line of multiple links will be presented in speech and braille as multiple links on the same line. +If it is disabled, then page elements will be placed on their own lines. +This may be easier to understand during line by line page navigation and make items easier to interact with for some users. + +##### Enable browse mode on page load {#BrowseModeSettingsEnableOnPageLoad} + +This checkbox toggles whether browse mode should be automatically enabled when loading a page. +When this option is disabled, browse mode can still be manually activated on pages or in documents where browse mode is supported. +See the [Browse Mode section](#BrowseMode) for a list of applications supported by browse mode. +Note that this option does not apply to situations where browse mode is always optional, e.g. in Microsoft Word. +This option is enabled by default. + +##### Automatic Say All on page load {#BrowseModeSettingsAutoSayAll} + +This checkbox toggles the automatic reading of a page after it loads in browse mode. +This option is enabled by default. + +##### Include layout tables {#BrowseModeSettingsIncludeLayoutTables} + +This option affects how NVDA handles tables used purely for layout purposes. +When on, NVDA will treat these as normal tables, reporting them based on [Document Formatting Settings](#DocumentFormattingSettings) and locating them with quick navigation commands. +When off, they will not be reported nor found with quick navigation. +However, the content of the tables will still be included as normal text. +This option is turned off by default. + +To toggle inclusion of layout tables from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + +##### Configuring reporting of fields such as links and headings {#BrowseModeLinksAndHeadings} + +Please see the options in the [Document Formatting category](#DocumentFormattingSettings) of the [NVDA Settings](#NVDASettings) dialog to configure the fields that are reported when navigating, such as links, headings and tables. + +##### Automatic focus mode for focus changes {#BrowseModeSettingsAutoPassThroughOnFocusChange} + +This option allows focus mode to be invoked if focus changes. +For example, when on a web page, if you press tab and you land on a form, if this option is checked, focus mode will automatically be invoked. + +##### Automatic focus mode for caret movement {#BrowseModeSettingsAutoPassThroughOnCaretMove} + +This option, when checked, allows NVDA to enter and leave focus mode when using arrow keys. +For example, if arrowing down a web page and you land on an edit box, NVDA will automatically bring you into focus mode. +If you arrow out of the edit box, NVDA will put you back in browse mode. + +##### Audio indication of Focus and Browse modes {#BrowseModeSettingsPassThroughAudioIndication} + +If this option is enabled, NVDA will play special sounds when it switches between browse mode and focus mode, rather than speaking the change. + +##### Trap non-command gestures from reaching the document {#BrowseModeSettingsTrapNonCommandGestures} + +Enabled by default, this option allows you to choose if gestures (such as key presses) that do not result in an NVDA command and are not considered to be a command key in general, should be trapped from going through to the document you are currently focused on. +As an example, if enabled and the letter j was pressed, it would be trapped from reaching the document, even though it is not a quick navigation command nor is it likely to be a command in the application itself. +In this case NVDA will tell Windows to play a default sound whenever a key which gets trapped is pressed. + + + +##### Automatically set system focus to focusable elements {#BrowseModeSettingsAutoFocusFocusableElements} + +Key: NVDA+8 + +Disabled by default, this option allows you to choose if the system focus should automatically be set to elements that can take the system focus (links, form fields, etc.) when navigating content with the browse mode caret. +Leaving this option disabled will not automatically focus focusable elements when they are selected with the browse mode caret. +This might result in faster browsing experience and better responsiveness in browse mode. +The focus will yet be updated to the particular element when interacting with it (e.g. pressing a button, checking a check box). +Enabling this option may improve support for some websites at the cost of performance and stability. + +#### Document Formatting {#DocumentFormattingSettings} + + + +##### Open Document Formatting settings {#OpenDocumentFormattingSettings} + +Key: `NVDA+control+d` + +Most of the options in this category are for configuring what type of formatting you wish to have reported as you move the cursor around documents. +For example, if you check the report font name checkbox, each time you arrow onto text with a different font, the name of the font will be announced. + +The document formatting options are organized into groups. +You can configure reporting of: + +* Font + * Font name + * Font size + * Font attributes + * Superscripts and subscripts + * Emphasis + * Highlighted (Marked) text + * Style + * Colours +* Document information + * Comments + * Bookmarks + * Editor revisions + * Spelling errors +* Pages and spacing + * Page numbers + * Line numbers + * Line indentation reporting [(Off, Speech, Tones, Both Speech and Tones)](#DocumentFormattingSettingsLineIndentation) + * Ignore blank lines for line indentation reporting + * Paragraph indentation (e.g. hanging indent, first line indent) + * Line spacing (single, double, etc.) + * Alignment +* Table information + * Tables + * Row/column headers (Off, Rows, Columns, Rows and columns) + * Cell coordinates + * Cell borders (Off, Styles, Both Colours and Styles) +* Elements + * Headings + * Links + * Graphics + * Lists + * Block quotes + * Groupings + * Landmarks + * Articles + * Frames + * Figures and captions + * Clickable + +To toggle these settings from anywhere, please assign custom gestures using the [Input Gestures dialog](#InputGestures). + +##### Report formatting changes after the cursor {#DocumentFormattingDetectFormatAfterCursor} + +If enabled, this setting tells NVDA to try and detect all the formatting changes on a line as it reports it, even if doing this may slow down NVDA's performance. + +By default, NVDA will detect the formatting at the position of the System caret / Review Cursor, and in some instances may detect formatting on the rest of the line, only if it is not going to cause a performance decrease. + +Enable this option while proof reading documents in applications such as WordPad, where formatting is important. + +##### Line indentation reporting {#DocumentFormattingSettingsLineIndentation} + +This option allows you to configure how indentation at the beginning of lines is reported. +The Report line indentation with combo box has four options. + +* Off: NVDA will not treat indentation specially. +* Speech: If speech is selected, when the amount of indentation changes, NVDA will say something like "twelve space" or "four tab." +* Tones: If Tones is selected, when the amount of indentation changes, tones indicate the amount of change in indent. +The tone will increase in pitch every space, and for a tab, it will increase in pitch the equivalent of 4 spaces. +* Both Speech and Tones: This option reads indentation using both of the above methods. + +If you tick the "Ignore blank lines for line indentation reporting" checkbox, then indentation changes won't be reported for blank lines. +This may be useful when reading a document where blank lines are used to separate indented bloks of text, such as in programming source code. + +#### Document Navigation {#DocumentNavigation} + +This category allows you to adjust various aspects of document navigation. + +##### Paragraph Style {#ParagraphStyle} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Default (Handled by application), Handled by application, Single line break, Multi line break| +|Default |Handled by application| + +This combo box allows you to select the paragraph style to be used when navigating by paragraphs with `control+upArrow` and `control+downArrow`. +The available paragraph styles are: + +* Handled by application: NVDA will let the application determine the previous or next paragraph, and NVDA will read the new paragraph when navigating. +This style works best when the application supports paragraph navigation natively, and is the default. +* Single line break: NVDA will attempt to determine the previous or next paragraph using a single line break as the paragraph indicator. +This style works best when reading documents in an application which does not natively support paragraph navigation, and paragraphs in the document are marked by a single press of the `enter` key. +* Multi line break: NVDA will attempt to determine the previous or next paragraph using at least one blank line (two presses of the `enter` key) as the paragraph indicator. +This style works best when working with documents which use block paragraphs. +Note that this paragraph style cannot be used in Microsoft Word or Microsoft Outlook, unless you are using UIA to access Microsoft Word controls. + +You may toggle through the available paragraph styles from anywhere by assigning a key in the [Input Gestures dialog](#InputGestures). + +#### Add-on Store Settings {#AddonStoreSettings} + +This category allows you to adjust the behaviour of the Add-on Store. + +##### Update Notifications {#AutomaticAddonUpdates} + +When this option is set to "Notify", the Add-on Store will notify you after NVDA startup if any add-on updates are available. +This check is performed every 24 hours. +Notifications will only occur for add-ons with updates available within the same channel. +For example, for installed beta add-ons, you will only be notified of updates within the beta channel. + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Notify (Default), Disabled | +|Default |Notify | + +|Option |Behaviour | +|---|---| +|Notify |Notify when updates are available to add-ons within the same channel | +|Disabled |Do not automatically check for updates to add-ons | + +#### Windows OCR Settings {#Win10OcrSettings} + +The settings in this category allow you to configure [Windows OCR](#Win10Ocr). +This category contains the following options: + +##### Recognition language {#Win10OcrSettingsRecognitionLanguage} + +This combo box allows you to choose the language to be used for text recognition. +To cycle through available languages from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + +##### Periodically refresh recognized content {#Win10OcrSettingsAutoRefresh} + +When this checkbox is enabled, NVDA will automatically refresh the recognized content when a recognition result has focus. +This can be very useful when you want to monitor constantly changing content, such as when watching a video with subtitles. +The refresh takes place every one and a half seconds. +This option is disabled by default. + +#### Advanced Settings {#AdvancedSettings} + +Warning! The settings in this category are for advanced users and may cause NVDA to not function correctly if configured in the wrong way. +Only make changes to these settings if you are sure you know what you are doing or if you have been specifically instructed to by an NVDA developer. + +##### Making changes to advanced settings {#AdvancedSettingsMakingChanges} + +In order to make changes to the advanced settings, the controls must be enabled by confirming, with the checkbox, that you understand the risks of modifying these settings + +##### Restoring the default settings {#AdvancedSettingsRestoringDefaults} + +The button restores the default values for the settings, even if the confirmation checkbox is not ticked. +After changing settings you may wish to revert to the default values. +This may also be the case if you are unsure if the settings have been changed. + +##### Enable loading custom code from Developer Scratchpad Directory {#AdvancedSettingsEnableScratchpad} + +When developing add-ons for NVDA, it is useful to be able to test code as you are writing it. +This option when enabled, allows NVDA to load custom appModules, globalPlugins, brailleDisplayDrivers, synthDrivers and vision enhancement providers, from a special developer scratchpad directory in your NVDA user configuration directory. +As their equivalents in add-ons, these modules are loaded when starting NVDA or, in the case of appModules and globalPlugins, when [reloading plugins](#ReloadPlugins). +This option is off by default, ensuring that no untested code is ever run in NVDA with out the user's explicit knowledge. +If you wish to distribute custom code to others, you should package it as an NVDA add-on. + +##### Open Developer Scratchpad Directory {#AdvancedSettingsOpenScratchpadDir} + +This button opens the directory where you can place custom code while developing it. +This button is only enabled if NVDA is configured to enable loading custom code from the Developer Scratchpad Directory. + +##### Registration for UI Automation events and property changes {#AdvancedSettingsSelectiveUIAEventRegistration} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Automatic, Selective, Global| +|Default |Automatic| + +This option changes how NVDA registers for events fired by the Microsoft UI Automation accessibility API. +The registration for UI Automation events and property changes combo box has three options: + +* Automatic: "selective" on Windows 11 Sun Valley 2 (version 22H2) and later, "global" otherwise. +* Selective: NVDA will limit event registration to the system focus for most events. +If you suffer from performance issues in one or more applications, We recommend you to try this functionality to see whether performance improves. +However, on older versions of Windows, NVDA may have trouble tracking focus in some controls (such as the task manager and emoji panel). +* Global: NVDA registers for many UIA events that are processed and discarded within NVDA itself. +While focus tracking is more reliable in more situations, performance is significantly degraded, especially in applications like Microsoft Visual Studio. + +##### Use UI automation to access Microsoft Word document controls {#MSWordUIA} + +Configures whether or not NVDA should use the UI Automation accessibility API to access Microsoft Word documents, rather than the older Microsoft Word object model. +This applies to documents in Microsoft word itself, plus messages in Microsoft Outlook. +This setting contains the following values: + +* Default (where suitable) +* Only where necessary: where the Microsoft Word object model is not available at all +* Where suitable: Microsoft Word version 16.0.15000 or higher, or where the Microsoft Word object model is unavailable +* Always: where ever UI automation is available in Microsoft word (no matter how complete). + +##### Use UI automation to access Microsoft Excel spreadsheet controls when available {#UseUiaForExcel} + +When this option is enabled, NVDA will try to use the Microsoft UI Automation accessibility API in order to fetch information from Microsoft Excel Spreadsheet controls. +This is an experimental feature, and some features of Microsoft Excel may not be available in this mode. +For instance, NVDA's Elements List for listing formulas and comments, and Browse mode quick navigation to jump to form fields on a spreadsheet features are not available. +However, for basic spreadsheet navigating / editing, this option may provide a vast performance improvement. +We still do not recommend that the majority of users turn this on by default, though we do welcome users of Microsoft Excel build 16.0.13522.10000 or higher to test this feature and provide feedback. +Microsoft Excel's UI automation implementation is ever changing, and versions of Microsoft Office older than 16.0.13522.10000 may not expose enough information for this option to be of any use. + +##### Use enhanced event processing {#UIAEnhancedEventProcessing} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Default (Enabled), Disabled, Enabled| +|Default |Enabled| + +When this option is enabled, NVDA should remain responsive when being flooded with many UI Automation events, e.g. large amounts of text in a terminal. +After changing this option, you will need to restart NVDA for the change to take effect. + +##### Windows Console support {#AdvancedSettingsConsoleUIA} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Automatic, UIA when available, Legacy| +|Default |Automatic| + +This option selects how NVDA interacts with the Windows Console used by command prompt, PowerShell, and the Windows Subsystem for Linux. +It does not affect the modern Windows Terminal. +In Windows 10 version 1709, Microsoft [added support for its UI Automation API to the console](https://devblogs.microsoft.com/commandline/whats-new-in-windows-console-in-windows-10-fall-creators-update/), bringing vastly improved performance and stability for screen readers that support it. +In situations where UI Automation is unavailable or known to result in an inferior user experience, NVDA's legacy console support is available as a fallback. +The Windows Console support combo box has three options: + +* Automatic: Uses UI Automation in the version of Windows Console included with Windows 11 version 22H2 and later. +This option is recommended and set by default. +* UIA when available: Uses UI Automation in consoles if available, even for versions with incomplete or buggy implementations. +While this limited functionality may be useful (and even sufficient for your usage), use of this option is entirely at your own risk and no support for it will be provided. +* Legacy: UI Automation in the Windows Console will be completely disabled. +The legacy fallback will always be used even in situations where UI Automation would provide a superior user experience. +Therefore, selecting this option is not recommended unless you know what you are doing. + +##### Use UIA with Microsoft Edge and other Chromium based browsers when available {#ChromiumUIA} + +Allows specifying when UIA will be used when it is available in Chromium based browsers such as Microsoft Edge. +UIA support for Chromium based browsers is early in development and may not provide the same level of access as IA2. +The combo box has the following options: + +* Default (Only when necessary): The NVDA default, currently this is "Only when necessary". This default may change in the future as the technology matures. +* Only when necessary: When NVDA is unable to inject into the browser process in order to use IA2 and UIA is available, then NVDA will fall back to using UIA. +* Yes: If the browser makes UIA available, NVDA will use it. +* No: Don't use UIA, even if NVDA is unable to inject in process. This may be useful for developers debugging issues with IA2 and want to ensure that NVDA does not fall back to UIA. + +##### Annotations {#Annotations} + +This group of options is used to enable features which add experimental support for ARIA annotations. +Some of these features may be incomplete. + + +To "Report summary of any annotation details at the system caret", press NVDA+d. + + +The following options exist: + +* "Report 'has details' for structured annotations": enables reporting if the text or control has further details. +* "Report aria-description always": + When the source of `accDescription` is aria-description, the description is reported. + This is useful for annotations on the web. + Note: + * There are many sources for `accDescription` several have mixed or unreliable semantics. + Historically AT has not been able to differentiate sources of `accDescription` typically it wasn't spoken due to the mixed semantics. + * This option is in very early development, it relies on browser features not yet widely available. + * Expected to work with Chromium 92.0.4479.0+ + +##### Report live regions {#BrailleLiveRegions} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Default (Enabled), Disabled, Enabled| +|Default |Enabled| + +This option selects whether NVDA reports changes in some dynamic web content in Braille. +Disabling this option is equivalent to NVDA's behaviour in versions 2023.1 and earlier, which only reported these content changes in speech. + +##### Speak passwords in all enhanced terminals {#AdvancedSettingsWinConsoleSpeakPasswords} + +This setting controls whether characters are spoken by [speak typed characters](#KeyboardSettingsSpeakTypedCharacters) or [speak typed words](#KeyboardSettingsSpeakTypedWords) in situations where the screen does not update (such as password entry) in some terminal programs, such as the Windows Console with UI automation support enabled and Mintty. +For security purposes, this setting should be left disabled. +However, you may wish to enable it if you experience performance issues or instability with typed character and/or word reporting in consoles, or work in trusted environments and prefer password announcement. + +##### Use enhanced typed character support in legacy Windows Console when available {#AdvancedSettingsKeyboardSupportInLegacy} + +This option enables an alternative method for detecting typed characters in legacy Windows consoles. +While it improves performance and prevents some console output from being spelled out, it may be incompatible with some terminal programs. +This feature is available and enabled by default on Windows 10 versions 1607 and later when UI Automation is unavailable or disabled. +Warning: with this option enabled, typed characters that do not appear onscreen, such as passwords, will not be suppressed. +In untrusted environments, you may temporarily disable [speak typed characters](#KeyboardSettingsSpeakTypedCharacters) and [speak typed words](#KeyboardSettingsSpeakTypedWords) when entering passwords. + +##### Diff algorithm {#DiffAlgo} + +This setting controls how NVDA determines the new text to speak in terminals. +The diff algorithm combo box has three options: + +* Automatic: This option causes NVDA to prefer Diff Match Patch in most situations, but fall back to Difflib in problematic applications, such as older versions of the Windows Console and Mintty. +* Diff Match Patch: This option causes NVDA to calculate changes to terminal text by character, even in situations where it is not recommended. +It may improve performance when large volumes of text are written to the console and allow more accurate reporting of changes made in the middle of lines. +However, in some applications, reading of new text may be choppy or inconsistent. +* Difflib: this option causes NVDA to calculate changes to terminal text by line, even in situations where it is not recommended. +It is identical to NVDA's behaviour in versions 2020.4 and earlier. +This setting may stabilize reading of incoming text in some applications. +However, in terminals, when inserting or deleting a character in the middle of a line, the text after the caret will be read out. + +##### Speak new text in Windows Terminal via {#WtStrategy} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Default (Diffing), Diffing, UIA notifications| +|Default |Diffing| + +This option selects how NVDA determines what text is "new" (and thus what to speak when "report dynamic content changes" is enabled) in Windows Terminal and the WPF Windows Terminal control used in Visual Studio 2022. +It does not affect the Windows Console (`conhost.exe`). +The Speak new text in Windows Terminal combo box has three options: + +* Default: This option is currently equivalent to "diffing", but it is anticipated to change once support for UIA notifications is further developed. +* Diffing: This option uses the selected diff algorithm to calculate changes each time the terminal renders new text. +This is identical to NVDA's behaviour in versions 2022.4 and earlier. +* UIA notifications: This option defers the responsibility of determining what text to speak to Windows Terminal itself, meanning that NVDA no longer has to determine what text currently on-screen is "new". +This should markedly improve performance and stability of Windows Terminal, but this feature is not yet complete. +In particular, typed characters that are not displayed on-screen, such as passwords, are reported when this option is selected. +Additionally, contiguous spans of output of over 1,000 characters may not be reported accurately. + +##### Attempt to cancel speech for expired focus events {#CancelExpiredFocusSpeech} + +This option enables behaviour which attempts to cancel speech for expired focus events. +In particular moving quickly through messages in Gmail with Chrome can cause NVDA to speak outdated information. +This functionality is enabled by default as of NVDA 2021.1. + +##### Caret move timeout (in MS) {#AdvancedSettingsCaretMoveTimeout} + +This option allows you to configure the number of milliseconds NVDA will wait for the caret (insertion point) to move in editable text controls. +If you find that NVDA seems to be incorrectly tracking the caret E.g. it seems to be always one character behind or is repeating lines, then you may wish to try increasing this value. + +##### Report transparency for colors {#ReportTransparentColors} + +This option enables reporting when colors are transparent, useful for addon/appModule developers gathering information to improve user experience with a 3rd party application. +Some GDI applications will highlight text with a background color, NVDA (via display model) attempts to report this color. +In some situations, the text background may be entirely transparent, with the text layered on some other GUI element. +With several historically popular GUI APIs, the text may be rendered with a transparent background, but visually the background color is accurate. + +##### Use WASAPI for audio output {#WASAPI} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Default (Enabled), Disabled, Enabled| +|Default |Enabled| + +This option enables audio output via the Windows Audio Session API (WASAPI). +WASAPI is a more modern audio framework which may improve the responsiveness, performance and stability of NVDA audio output, including both speech and sounds. +After changing this option, you will need to restart NVDA for the change to take effect. +Disabling WASAPI will disable the following options: + +* [Volume of NVDA sounds follows voice volume](#SoundVolumeFollowsVoice) +* [Volume of NVDA sounds](#SoundVolume) + +##### Debug logging categories {#AdvancedSettingsDebugLoggingCategories} + +The checkboxes in this list allow you to enable specific categories of debug messages in NVDA's log. +Logging these messages can result in decreased performance and large log files. +Only turn one of these on if specifically instructed to by an NVDA developer e.g. when debugging why a braille display driver is not functioning correctly. + +##### Play a sound for logged errors {#PlayErrorSound} + +This option allows you to specify if NVDA will play an error sound in case an error is logged. +Choosing Only in test versions (default) makes NVDA play error sounds only if the current NVDA version is a test version (alpha, beta or run from source). +Choosing Yes allows to enable error sounds whatever your current NVDA version is. + +##### Regular expression for text paragraph quick navigation commands {#TextParagraphRegexEdit} + +This field allows users to customize regular expression for detecting text paragraphs in browse mode. +The [text paragraph navigation command](#TextNavigationCommand) searches for paragraphs matched by this regular expression. + +### miscellaneous Settings {#MiscSettings} + +Besides the [NVDA Settings](#NVDASettings) dialog, The Preferences sub-menu of the NVDA Menu contains several other items which are outlined below. + +#### Speech dictionaries {#SpeechDictionaries} + +The speech dictionaries menu (found in the Preferences menu) contains dialogs that allow you to manage the way NVDA pronounces particular words or phrases. +There are currently three different types of speech dictionaries. +They are: + +* Default: rules in this dictionary affect all speech in NVDA. +* Voice: rules in this dictionary affect speech for the synthesizer voice currently being used. +* Temporary: rules in this dictionary affect all speech in NVDA, but only for the current session. These rules are temporary and will be lost if NVDA is restarted. + +You need to assign custom gestures using the [Input Gestures dialog](#InputGestures) if you wish to open any of these dictionary dialogs from anywhere. + +All dictionary dialogs contain a list of rules which will be used for processing the speech. +The dialog also contains Add, Edit, Remove and Remove all buttons. + +To add a new rule to the dictionary, press the Add button, and fill in the fields in the dialog box that appears and then press Ok. +You will then see your new rule in the list of rules. +However, to make sure your rule is actually saved, make sure to press Ok to exit the dictionary dialog completely once you have finished adding/editing rules. + +The rules for NVDA's speech dictionaries allow you to change one string of characters into another. +For example, you could create a rule which causes NVDA to say the word "frog" instead of "bird" whenever the word "bird" is encountered. +In the Add rule dialog, the easiest way to do this is to type the word bird in the Pattern field, and the word frog in the Replacement field. +You may also want to type a description of the rule in the Comment field (something like: changes bird to frog). + +NVDA's speech dictionaries however are much more powerful than simple word replacement. +The Add rule dialog also contains a checkbox to say whether or not you want the rule to be case sensitive (meaning that NVDA should care whether the characters are uppercase or lowercase. +NVDA ignores case by default). + +Finally, a set of radio buttons allows you to tell NVDA whether your pattern should match anywhere, should only match if it is a complete word or should be treated as a "Regular expression". +Setting the pattern to match as a whole word means that the replacement will only be made if the pattern does not occur as part of a larger word. +This condition is met if the characters immediately before and after the word are anything other than a letter, a number, or an underscore, or if there are no characters at all. +Thus, using the earlier example of replacing the word "bird" with "frog", if you were to make this a whole word replacement, it would not match "birds" or "bluebird". + +A regular expression is a pattern containing special symbols that allow you to match on more than one character at a time, or match on just numbers, or just letters, as a few examples. +Regular expressions are not covered in this user guide. +For an introductory tutorial, please refer to [Python's Regular Expression Guide](https://docs.python.org/3.11/howto/regex.html). + +#### Punctuation/symbol pronunciation {#SymbolPronunciation} + +This dialog allows you to change the way punctuation and other symbols are pronounced, as well as the symbol level at which they are spoken. + +The language for which symbol pronunciation is being edited will be shown in the dialog's title. +Note that this dialog respects the "Trust voice's language for processing symbols and characters" option found in the [Speech category](#SpeechSettings) of the [NVDA Settings](#NVDASettings) dialog; i.e. it uses the voice language rather than the NVDA global language setting when this option is enabled. + +To change a symbol, first select it in the Symbols list. +You can filter the symbols by entering the symbol or a part of the symbol's replacement into the Filter by edit box. + +* The Replacement field allows you to change the text that should be spoken in place of this symbol. +* Using the Level field, you can adjust the lowest symbol level at which this symbol should be spoken (none, some, most or all). +You can also set the level to character; in this case the symbol will not be spoken regardless of the symbol level in use, with the following two exceptions: + * When navigating character by character. + * When NVDA is spelling any text containing that symbol. +* The Send actual symbol to synthesizer field specifies when the symbol itself (in contrast to its replacement) should be sent to the synthesizer. +This is useful if the symbol causes the synthesizer to pause or change the inflection of the voice. +For example, a comma causes the synthesizer to pause. +There are three options: + * never: Never send the actual symbol to the synthesizer. + * always: Always send the actual symbol to the synthesizer. + * only below symbols' level: Send the actual symbol only if the configured speech symbol level is lower than the level set for this symbol. + For example, you might use this so that a symbol will have its replacement spoken at higher levels without pausing, while still being indicated with a pause at lower levels. + +You can add new symbols by pressing the Add button. +In the dialog that appears, enter the symbol and press the OK button. +Then, change the fields for the new symbol as you would for other symbols. + +You can remove a symbol you previously added by pressing the Remove button. + +When you are finished, press the OK button to save your changes or the Cancel button to discard them. + +In the case of complex symbols, the Replacement field may have to include some group references of the matched text. For instance, for a pattern matching a whole date, \1, \2, and \3 would need to appear in the field, to be replaced by the corresponding parts of the date. +Normal backslashes in the Replacement field should thus be doubled, e.g. "a\\b" should be typed in order to get the "a\b" replacement. + +#### Input Gestures {#InputGestures} + +In this dialog, you can customize the input gestures (keys on the keyboard, buttons on a braille display, etc.) for NVDA commands. + +Only commands that are applicable immediately before the dialog is opened are shown. +For example, if you want to customize commands related to browse mode, you should open the Input Gestures dialog while you are in browse mode. + +The tree in this dialog lists all of the applicable NVDA commands grouped by category. +You can filter them by entering one or more words from the command's name into the Filter by edit box in any order. +Any gestures associated with a command are listed beneath the command. + +To add an input gesture to a command, select the command and press the Add button. +Then, perform the input gesture you wish to associate; e.g. press a key on the keyboard or a button on a braille display. +Often, a gesture can be interpreted in more than one way. +For example, if you pressed a key on the keyboard, you may wish it to be specific to the current keyboard layout (e.g. desktop or laptop) or you may wish it to apply for all layouts. +In this case, a menu will appear allowing you to select the desired option. + +To remove a gesture from a command, select the gesture and press the Remove button. + +The Emulated system keyboard keys category contains NVDA commands that emulate keys on the system keyboard. +These emulated system keyboard keys can be used to control a system keyboard right from your braille display. +To add an emulated input gesture, select the Emulated system keyboard keys category and press the Add button. +Then, press the key on the keyboard you wish to emulate. +After that, the key will be available from the Emulated system keyboard keys category and you will be able to assign an input gesture to it as described above. + +Note: + +* Emulated keys must have gestures assigned in order to persist when saving / closing the dialog. +* An input gesture with modifier keys may not be able to be mapped to an emulated gesture without modifier keys. +For instance, setting the emulated input `a` and configuring an input gesture of `ctrl+m`, may result in the application receiving `ctrl+a`. + +When you are finished making changes, press the OK button to save them or the Cancel button to discard them. + +### Saving and Reloading the configuration {#SavingAndReloading} + +By default NVDA will automatically save your settings on exit. +Note, however, that this option can be changed under the general options in the preferences menu. +To save the settings manually at any time, choose the Save configuration item in the NVDA menu. + +If you ever make a mistake with your settings and need to revert back to the saved settings, choose the "revert to saved configuration" item in the NVDA menu. +You can also reset your settings to their original factory defaults by choosing Reset Configuration To Factory Defaults, which is also found in the NVDA menu. + +The following NVDA key commands are also useful: + + +| Name |Desktop key |Laptop key |Description| +|---|---|---|---| +|Save configuration |NVDA+control+c |NVDA+control+c |Saves your current configuration so that it is not lost when you exit NVDA| +|Revert configuration |NVDA+control+r |NVDA+control+r |Pressing once resets your configuration to when you last saved it. Pressing three times will reset it back to factory defaults.| + + + +### Configuration Profiles {#ConfigurationProfiles} + +Sometimes, you may wish to have different settings for different situations. +For example, you may wish to have reporting of indentation enabled while you are editing or reporting of font attributes enabled while you are proofreading. +NVDA allows you to do this using configuration profiles. + +A configuration profile contains only those settings which are changed while the profile is being edited. +Most settings can be changed in configuration profiles except for those in the General category of the [NVDA Settings](#NVDASettings) dialog, which apply to the entirety of NVDA. + +Configuration profiles can be manually activated either from a dialog or using custom added gestures. +They can also be activated automatically due to triggers such as switching to a particular application. + +#### Basic Management {#ProfilesBasicManagement} + +You manage configuration profiles by selecting "Configuration profiles" in the NVDA menu. +You can also do this using a key command: + + +* NVDA+control+p: Show the Configuration Profiles dialog. + + + +The first control in this dialog is the profile list from which you can select one of the available profiles. +When you open the dialog, the profile you are currently editing is selected. +Additional information is also shown for active profiles, indicating whether they are manually activated, triggered and/or being edited. + +To rename or delete a profile, press the Rename or Delete buttons, respectively. + +Press the Close button to close the dialog. + +#### Creating a Profile {#ProfilesCreating} + +To create a profile, press the New button. + +In the New Profile dialog, you can enter a name for the profile. +You can also select how this profile should be used. +If you only want to use this profile manually, select Manual activation, which is the default. +Otherwise, select a trigger which should automatically activate this profile. +For convenience, if you haven't entered a name for the profile, selecting a trigger will fill in the name accordingly. +See [below](#ConfigProfileTriggers) for more information about triggers. + +Pressing OK will create the profile and close the Configuration Profiles dialog so you can edit it. + +#### Manual Activation {#ConfigProfileManual} + +You can manually activate a profile by selecting a profile and pressing the Manual activate button. +Once activated, other profiles can still be activated due to triggers, but any settings in the manually activated profile will override them. +For example, if a profile is triggered for the current application and reporting of links is enabled in that profile but disabled it in the manually activated profile, links will not be reported. +However, if you have changed the voice in the triggered profile but have never changed it in the manually activated profile, the voice from the triggered profile will be used. +Any settings you change will be saved in the manually activated profile. +To deactivate a manually activated profile, select it in the Configuration Profiles dialog and press the Manual deactivate button. + +#### Triggers {#ConfigProfileTriggers} + +Pressing the Triggers button in the Configuration Profiles dialog allows you to change the profiles which should be automatically activated for various triggers. + +The Triggers list shows the available triggers, which are as follows: + +* Current application: Triggered when you switch to the current application. +* Say all: Triggered while reading with the say all command. + +To change the profile which should be automatically activated for a trigger, select the trigger and then select the desired profile from the Profile list. +You can select "(normal configuration)" if you don't want a profile to be used. + +Press the Close button to return to the Configuration Profiles dialog. + +#### Editing a Profile {#ConfigProfileEditing} + +If you have manually activated a profile, any settings you change will be saved to that profile. +Otherwise, any settings you change will be saved to the most recently triggered profile. +For example, if you have associated a profile with the Notepad application and you switch to Notepad, any changed settings will be saved to that profile. +Finally, if there is neither a manually activated nor a triggered profile, any settings you change will be saved to your normal configuration. + +To edit the profile associated with say all, you must [manually activate](#ConfigProfileManual) that profile. + +#### Temporarily Disabling Triggers {#ConfigProfileDisablingTriggers} + +Sometimes, it is useful to temporarily disable all triggers. +For example, you might wish to edit a manually activated profile or your normal configuration without triggered profiles interfering. +You can do this by checking the Temporarily disable all triggers checkbox in the Configuration Profiles dialog. + +To toggle disabling triggers from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + +#### Activating a profile using input gestures {#ConfigProfileGestures} + +For every profile you add, you are able to assign one or more input gestures to activate it. +By default, configuration profiles do not have input gestures assigned. +You can add gestures to activate a profile using the [Input Gestures dialog](#InputGestures). +Every profile has its own entry under the configuration profiles category. +When you rename a profile, any gesture you added previously will still be available. +Removing a profile will automatically delete the gestures associated with it. + +### Location of Configuration files {#LocationOfConfigurationFiles} + +Portable versions of NVDA store all settings and add-ons in a directory called userConfig, found in the NVDA directory. + +Installed versions of NVDA store all settings and add-ons in a special NVDA directory located in your Windows user profile. +This means that each user on the system can have their own NVDA settings. +To open your settings directory from anywhere you can use [Input Gestures dialog](#InputGestures) to add a custom gesture. +In addition for an installed version of NVDA, on the start menu you can go to programs -> NVDA -> explore user configuration directory. + +Settings for NVDA when running during sign-in or on UAC screens are stored in the systemConfig directory in NVDA's installation directory. +Usually, this configuration should not be touched. +To change NVDA's configuration during sign-in or on UAC screens, configure NVDA as you wish while signed into Windows, save the configuration, and then press the "use currently saved settings during sign-in and on secure screens" button in the General category of the [NVDA Settings](#NVDASettings) dialog. + +## Add-ons and the Add-on Store {#AddonsManager} + +Add-ons are software packages which provide new or altered functionality for NVDA. +They are developed by the NVDA community, and external organisations such as commercial vendors. +Add-ons may do any of the following: + +* Add or enhance support for certain applications. +* Provide support for extra Braille displays or speech synthesizers. +* Add or change features in NVDA. + +NVDA's Add-on Store allows you to browse and manage add-on packages. +All add-ons that are available in the Add-on Store can be downloaded for free. +However, some of them may require users to pay for a license or additional software before they can be used. +Commercial speech synthesizers are an example of this type of add-on. +If you install an add-on with paid components and change your mind about using it, the add-on can be easily removed. + +The Add-on Store is accessed from the Tools submenu of the NVDA menu. +To access the Add-on Store from anywhere, assign a custom gesture using the [Input Gestures dialog](#InputGestures). + +### Browsing add-ons {#AddonStoreBrowsing} + +When opened, the Add-on Store displays a list of add-ons. +If you have not installed an add-on before, the Add-on Store will open to a list of add-ons available to install. +If you have installed add-ons, the list will display currently installed add-ons. + +Selecting an add-on, by moving to it with the up and down arrow keys, will display the details for the add-on. +Add-ons have associated actions that you can access through an [actions menu](#AddonStoreActions), such as install, help, disable, and remove. +Available actions will change based on whether the add-on is installed or not, and whether it is enabled or disabled. + +#### Add-on list views {#AddonStoreFilterStatus} + +There are different views for installed, updatable, available and incompatible add-ons. +To change the view of add-ons, change the active tab of the add-ons list using `ctrl+tab`. +You can also `tab` to the list of views, and move through them with the `leftArrow` and `rightArrow` keys. + +#### Filtering for enabled or disabled add-ons {#AddonStoreFilterEnabled} + +Normally, an installed add-on is "enabled", meaning that it is running and available within NVDA. +However, some of your installed add-ons may be set to the "disabled" state. +This means that they will not be used, and their functions won't be available during your current NVDA session. +You may have disabled an add-on because it conflicted with another add-on, or with a certain application. +NVDA may also disable certain add-ons, if they are found to be incompatible during an NVDA upgrade; though you will be warned if this is going to happen. +Add-ons can also be disabled if you simply don't need them for a prolonged period, but don't want to uninstall them because you expect to want them again in the future. + +The lists of installed and incompatible add-ons can be filtered by their enabled or disabled state. +The default shows both enabled and disabled add-ons. + +#### Include incompatible add-ons {#AddonStoreFilterIncompatible} + +Available and updatable add-ons can be filtered to include [incompatible add-ons](#incompatibleAddonsManager) that are available to install. + +#### Filter add-ons by channel {#AddonStoreFilterChannel} + +Add-ons can be distributed through up to four channels: + +* Stable: The developer has released this as a tested add-on with a released version of NVDA. +* Beta: This add-on may need further testing, but is released for user feedback. +Suggested for early adopters. +* Dev: This channel is suggested to be used by add-on developers to test unreleased API changes. +NVDA alpha testers may need to use a "Dev" version of their add-ons. +* External: Add-ons installed from external sources, outside of the Add-on Store. + +To list add-ons only for specific channels, change the "Channel" filter selection. + +#### Searching for add-ons {#AddonStoreFilterSearch} + +To search add-ons, use the "Search" text box. +You can reach it by pressing `shift+tab` from the list of add-ons. +Type a keyword or two for the kind of add-on you're looking for, then `tab` to the list of add-ons. +Add-ons will be listed if the search text can be found in the add-on ID, display name, publisher, author or description. + +### Add-on actions {#AddonStoreActions} + +Add-ons have associated actions, such as install, help, disable, and remove. +For an add-on in the add-on list, these actions can be accessed through a menu opened by pressing the `applications` key, `enter`, right clicking or double clicking the add-on. +This menu can also be accessed through an Actions button in the selected add-on's details. + +#### Installing add-ons {#AddonStoreInstalling} + +Just because an add-on is available in the NVDA Add-on Store, does not mean that it has been approved or vetted by NV Access or anyone else. +It is very important to only install add-ons from sources you trust. +The functionality of add-ons is unrestricted inside NVDA. +This could include accessing your personal data or even the entire system. + +You can install and update add-ons by [browsing Available add-ons](#AddonStoreBrowsing). +Select an add-on from the "Available add-ons" or "Updatable add-ons" tab. +Then use the update, install, or replace action to start the installation. + +You can also install multiple add-ons at once. +This can be done by selecting multiple add-ons in the available add-ons tab, then activating the context menu on the selection and choosing the "Install selected add-ons" action. + +To install an add-on you have obtained outside of the Add-on Store, press the "Install from external source" button. +This will allow you to browse for an add-on package (`.nvda-addon` file) somewhere on your computer or on a network. +Once you open the add-on package, the installation process will begin. + +If NVDA is installed and running on your system, you can also open an add-on file directly from the browser or file system to begin the installation process. + +When an add-on is being installed from an external source, NVDA will ask you to confirm the installation. +Once the add-on is installed, NVDA must be restarted for the add-on to start running, although you may postpone restarting NVDA if you have other add-ons to install or update. + +By default, after NVDA startup, you will be notified if any add-on updates are available. +To learn more about and configure this behaviour, refer to ["Update Notifications"](#AutomaticAddonUpdates). + +#### Removing Add-ons {#AddonStoreRemoving} + +To remove an add-on, select the add-on from the list and use the Remove action. +NVDA will ask you to confirm removal. +As with installing, NVDA must be restarted for the add-on to be fully removed. +Until you do, a status of "Pending removal" will be shown for that add-on in the list. +As with installing, you can also remove multiple add-ons at once. + +#### Disabling and Enabling Add-ons {#AddonStoreDisablingEnabling} + +To disable an add-on, use the "disable" action. +To enable a previously disabled add-on, use the "enable" action. +You can disable an add-on if the add-on status indicates it is "enabled", or enable it if the add-on is "disabled". +For each use of the enable/disable action, add-on status changes to indicate what will happen when NVDA restarts. +If the add-on was previously "disabled", the status will show "enabled after restart". +If the add-on was previously "enabled", the status will show "disabled after restart". +Just like when you install or remove add-ons, you need to restart NVDA in order for changes to take effect. +You can also enable or disable multiple add-ons at once by selecting multiple add-ons in the available add-ons tab, then activating the context menu on the selection and choosing the appropriate action. + +#### Reviewing add-ons and reading reviews {#AddonStoreReviews} + +You may want to read reviews by other users who have experienced an add-on, for example before you install it, or as you are learning to use it. +Also, it is helpful to other users to provide feedback about add-ons you have tried. +To read reviews for an add-on, select it, and use the "Community reviews" action. +This links to a GitHub Discussion webpage, where you will be able to read and write reviews for the add-on. +Please be aware that this doesn't replace direct communication with add-on developers. +Instead, the purpose of this feature is to share feedback to help users decide if an add-on may be useful for them. + +### Incompatible Add-ons {#incompatibleAddonsManager} + +Some older add-ons may no longer be compatible with the version of NVDA that you have. +If you are using an older version of NVDA, some newer add-ons may not be compatible either. +Attempting to install an incompatible add-on will result in an error explaining why the add-on is considered incompatible. + +For older add-ons, you can override the incompatibility at your own risk. +Incompatible add-ons may not work with your version of NVDA, and can cause unstable or unexpected behaviour including crashing. +You can override compatibility when enabling or installing an add-on. +If the incompatible add-on causes issues later, you can disable or remove it. + +If you are having trouble running NVDA, and you have recently updated or installed an add-on, especially if it is an incompatible add-on, you may want to try running NVDA temporarily with all add-ons disabled. +To restart NVDA with all add-ons disabled, choose the appropriate option when quitting NVDA. +Alternatively, use the [command line option](#CommandLineOptions) `--disable-addons`. + +You can browse available incompatible add-ons using the [available and updatable add-ons tabs](#AddonStoreFilterStatus). +You can browse installed incompatible add-ons using the [incompatible add-ons tab](#AddonStoreFilterStatus). + +## Extra Tools {#ExtraTools} +### Log Viewer {#LogViewer} + +The log viewer, found under Tools in the NVDA menu, allows you to view the logging output that has occurred since the latest session of NVDA was started. + +Apart from reading the content, you can also Save a copy of the log file, or refresh the viewer so that it loads new log output generated after the Log viewer was opened. +These actions are available under the Log menu in the log viewer. + +The file which is displayed when you open the log viewer is saved on your computer at the file location `%temp%\nvda.log`. +A new log file is created each time NVDA is started. +When this happens, the previous NVDA session's log file is moved to `%temp%\nvda-old.log`. + +You can also copy a fragment of the current log file to the clipboard without opening the log viewer. + + +| Name |Key |Description| +|---|---|---| +|Open log viewer |`NVDA+f1` |Opens the log viewer and displays developer information about the current navigator object.| +|Copy a fragment of the log to the clipboard |`NVDA+control+shift+f1` |When this command is pressed once, it sets a starting point for the log content that should be captured. When pressed a second time, it copies the log content since the start point to your clipboard.| + + + +### Speech Viewer {#SpeechViewer} + +For sighted software developers or people demoing NVDA to sighted audiences, a floating window is available that allows you to view all the text that NVDA is currently speaking. + +To enable the speech viewer, check the "Speech Viewer" menu item under Tools in the NVDA menu. +Uncheck the menu item to disable it. + +The speech viewer window contains a check box labelled "Show speech viewer on startup". +If this is checked, the speech viewer will open when NVDA is started. +The speech viewer window will always attempt to re-open with the same dimensions and location as when it was closed. + +While the speech viewer is enabled, it constantly updates to show you the most current text being spoken. +However, if you hover your mouse over or focus inside the viewer, NVDA will temporarily stop updating the text, so that you are able to easily select or copy the existing content. + +To toggle the speech viewer from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + +### Braille Viewer {#BrailleViewer} + +For sighted software developers or people demoing NVDA to sighted audiences, a floating window is available that allows you to view braille output, and the text equivalent for each braille character. +The braille viewer can be used at the same time as a physical braille display, it will match the number of cells on the physical device. +While the braille viewer is enabled, it constantly updates to show you the braille that would be displayed on a physical braille display. + +To enable the braille viewer, check the "Braille Viewer" menu item under Tools in the NVDA menu. +Uncheck the menu item to disable it. + +Physical braille displays typically have buttons to scroll forwards or backwards, to enable scrolling with the braille viewer tool use the [Input Gestures dialog](#InputGestures) to assign keyboard shortcuts which "Scrolls the braille display back" and "Scrolls the braille display forward" + +The braille viewer window contains a check box labelled "Show braille viewer on startup". +If this is checked, the braille viewer will open when NVDA is started. +The braille viewer window will always attempt to re-open with the same dimensions and location as when it was closed. + +The braille viewer window contains a check box labeled "Hover for cell routing", the default is unchecked. +If checked, hovering the mouse over a braille cell will enable trigger the "route to braille cell" command for that cell. +This is often used to move the caret or trigger the action for a control. +This can be useful for testing NVDA is able to correctly reverse map a from braille cell. +To prevent unintentionally routing to cells, the command is delayed. +The mouse must hover until the cell turns green. +The cell will start as a light yellow colour, transition to orange, then suddenly become green. + +To toggle the braille viewer from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + +### Python Console {#PythonConsole} + +The NVDA Python console, found under Tools in the NVDA menu, is a development tool which is useful for debugging, general inspection of NVDA internals or inspection of the accessibility hierarchy of an application. +For more information, please see the [NVDA Developer Guide](https://www.nvaccess.org/files/nvda/documentation/developerGuide.html). + +### Add-on Store {#AddonStoreMenuItem} + +This will open the [NVDA Add-on Store](#AddonsManager). +For more information, read the in-depth section: [Add-ons and the Add-on Store](#AddonsManager). + +### Create portable copy {#CreatePortableCopy} + +This will open a dialog which allows you to create a portable copy of NVDA out of the currently running version. + +Follow the directions in [Creating a portable copy](#CreatingAPortableCopy) for more information. + +### Run COM registration fixing tool... {#RunCOMRegistrationFixingTool} + +Installing and uninstalling programs on a computer can, in certain cases, cause COM DLL files to get unregistered. +As COM Interfaces such as IAccessible depend on correct COM DLL registrations, issues can appear in case the correct registration is missing. + +This can happen i.e. after installing and uninstalling Adobe Reader, Math Player and other programs. + +The missing registration can cause issues in browsers, desktop apps, task bar and other interfaces. + +Specifically, following issues can be solved by running this tool: + +* NVDA reports "unknown" when navigating in browsers such as Firefox, Thunderbird etc. +* NVDA fails to switch between focus mode and browse mode +* NVDA is very slow when navigating in browsers while using browse mode +* And possibly other issues. + +### Reload plugins {#ReloadPlugins} + +This item, once activated, reloads app modules and global plugins without restarting NVDA, which can be useful for developers. +App modules manage how NVDA interacts with specific applications. +Global plugins manage how NVDA interacts with all applications. + +The following NVDA key commands may also be useful: + + +| Name |Key |Description| +|---|---|---| +|Reload plugins |`NVDA+control+f3` |Reloads NVDA's global plugins and app modules.| +|Report loaded app module and executable |`NVDA+control+f1` |Report the name of the app module, if any, and the name of the executable associated with the application which has the keyboard focus.| + + + +## Supported Speech Synthesizers {#SupportedSpeechSynths} + +This section contains information about the speech synthesizers supported by NVDA. +For an even more extensive list of free and commercial synthesizers that you can purchase and download for use with NVDA, please see the [extra voices page](https://github.com/nvaccess/nvda/wiki/ExtraVoices). + +### eSpeak NG {#eSpeakNG} + +The [eSpeak NG](https://github.com/espeak-ng/espeak-ng) synthesizer is built directly into NVDA and does not require any other special drivers or components to be installed. +On Windows 8.1 NVDA uses eSpeak NG by default ([Windows OneCore](#OneCore) is used in Windows 10 and later by default). +As this synthesizer is built into NVDA, this is a great choice for when running NVDA off a USB thumb drive on other systems. + +Each voice that comes with eSpeak NG speaks a different language. +There are over 43 different languages supported by eSpeak NG. + +There are also many variants which can be chosen to alter the sound of the voice. + +### Microsoft Speech API version 4 (SAPI 4) {#SAPI4} + +SAPI 4 is an older Microsoft standard for software speech synthesizers. +NVDA still supports this for users who already have SAPI 4 synthesizers installed. +However, Microsoft no longer support this and needed components are no longer available from Microsoft. + +When using this synthesizer with NVDA, the available voices (accessed from the [Speech category](#SpeechSettings) of the [NVDA Settings](#NVDASettings) dialog or by the [Synth Settings Ring](#SynthSettingsRing)) will contain all the voices from all the installed SAPI 4 engines found on your system. + +### Microsoft Speech API version 5 (SAPI 5) {#SAPI5} + +SAPI 5 is a Microsoft standard for software speech synthesizers. +Many speech synthesizers that comply with this standard may be purchased or downloaded for free from various companies and websites, though your system will probably already come with at least one SAPI 5 voice preinstalled. +When using this synthesizer with NVDA, the available voices (accessed from the [Speech category](#SpeechSettings) of the [NVDA Settings](#NVDASettings) dialog or by the [Synth Settings Ring](#SynthSettingsRing)) will contain all the voices from all the installed SAPI 5 engines found on your system. + +### Microsoft Speech Platform {#MicrosoftSpeechPlatform} + +The Microsoft Speech Platform provides voices for many languages which are normally used in the development of server-based speech applications. +These voices can also be used with NVDA. + +To use these voices, you will need to install two components: + +* [Microsoft Speech Platform - Runtime (Version 11), x86](https://www.microsoft.com/download/en/details.aspx?id=27225) +* [Microsoft Speech Platform - Runtime Languages (Version 11)](https://www.microsoft.com/download/en/details.aspx?id=27224) + * This page includes many files for both speech recognition and text-to-speech. + Choose the files containing the TTS data for the desired languages/voices. + For example, the file MSSpeech_TTS_en-US_ZiraPro.msi is a U.S. English voice. + +### Windows OneCore Voices {#OneCore} + +Windows 10 and later includes voices known as "OneCore" or "mobile" voices. +Voices are provided for many languages, and they are more responsive than the Microsoft voices available using Microsoft Speech API version 5. +On Windows 10 and later, NVDA uses Windows OneCore voices by default ([eSpeak NG](#eSpeakNG) is used in other releases). + +To add new Windows OneCore voices, go to "Speech Settings", within Windows system settings. +Use the "Add voices" option and search for the desired language. +Many languages include multiple variants. +"United Kingdom" and "Australia" are two of the English variants. +"France", "Canada" and "Switzerland" are French variants available. +Search for the broader language (such as English or French), then locate the variant in the list. +Select any languages desired and use the "add" button to add them. +Once added, restart NVDA. + +Please see [Supported languages and voices](https://support.microsoft.com/en-us/windows/appendix-a-supported-languages-and-voices-4486e345-7730-53da-fcfe-55cc64300f01) for a list of available voices. + +## Supported Braille Displays {#SupportedBrailleDisplays} + +This section contains information about the Braille displays supported by NVDA. + +### Displays supporting automatic detection in the background {#AutomaticDetection} + +NVDA has the ability to detect many braille displays in the background automatically, either via USB or bluetooth. +This behaviour is achieved by selecting the Automatic option as the preferred braille display from NVDA's [Braille Settings dialog](#BrailleSettings). +This option is selected by default. + +The following displays support this automatic detection functionality. + +* Handy Tech displays +* Baum/Humanware/APH/Orbit braille displays +* HumanWare Brailliant BI/B series +* HumanWare BrailleNote +* SuperBraille +* Optelec ALVA 6 series +* HIMS Braille Sense/Braille EDGE/Smart Beetle/Sync Braille Series +* Eurobraille Esys/Esytime/Iris displays +* Nattiq nBraille displays +* Seika Notetaker: MiniSeika (16, 24 cells), V6, and V6Pro (40 cells) +* Tivomatic Caiku Albatross 46/80 displays +* Any Display that supports the Standard HID Braille protocol + +### Freedom Scientific Focus/PAC Mate Series {#FreedomScientificFocus} + +All Focus and PAC Mate displays from [Freedom Scientific](https://www.freedomscientific.com/) are supported when connected via USB or bluetooth. +You will need the Freedom Scientific braille display drivers installed on your system. +If you do not have them already, you can obtain them from the [Focus Blue Braille Display Driver page](https://support.freedomscientific.com/Downloads/Focus/FocusBlueBrailleDisplayDriver). +Although this page only mentions the Focus Blue display, the drivers support all Freedom Scientific Focus and Pacmate displays. + +By default, NVDA can automatically detect and connect to these displays either via USB or bluetooth. +However, when configuring the display, you can explicitly select "USB" or "Bluetooth" ports to restrict the connection type to be used. +This might be useful if you want to connect the focus display to NVDA using bluetooth, but still be able to charge it using USB power from your computer. +NVDA's automatic braille display detection will also recognize the display on USB or Bluetooth. + +Following are the key assignments for this display with NVDA. +Please see the display's documentation for descriptions of where these keys can be found. + + +| Name |Key| +|---|---| +|Scroll braille display back |topRouting1 (first cell on display)| +|Scroll braille display forward |topRouting20/40/80 (last cell on display)| +|Scroll braille display back |leftAdvanceBar| +|Scroll braille display forward |rightAdvanceBar| +|Toggle braille tethered to |leftGDFButton+rightGDFButton| +|Toggle left wiz wheel action |leftWizWheelPress| +|Move back using left wiz wheel action |leftWizWheelUp| +|Move forward using left wiz wheel action |leftWizWheelDown| +|Toggle right wiz wheel action |rightWizWheelPress| +|Move back using right wiz wheel action |rightWizWheelUp| +|Move forward using right wiz wheel action |rightWizWheelDown| +|Route to braille cell |routing| +|shift+tab key |brailleSpaceBar+dot1+dot2| +|tab key |brailleSpaceBar+dot4+dot5| +|upArrow key |brailleSpaceBar+dot1| +|downArrow key |brailleSpaceBar+dot4| +|control+leftArrow key |brailleSpaceBar+dot2| +|control+rightArrow key |brailleSpaceBar+dot5| +|leftArrow |brailleSpaceBar+dot3| +|rightArrow key |brailleSpaceBar+dot6| +|home key |brailleSpaceBar+dot1+dot3| +|end key |brailleSpaceBar+dot4+dot6| +|control+home key |brailleSpaceBar+dot1+dot2+dot3| +|control+end key |brailleSpaceBar+dot4+dot5+dot6| +|alt key |brailleSpaceBar+dot1+dot3+dot4| +|alt+tab key |brailleSpaceBar+dot2+dot3+dot4+dot5| +|alt+shift+tab key |brailleSpaceBar+dot1+dot2+dot5+dot6| +|windows+tab key |brailleSpaceBar+dot2+dot3+dot4| +|escape key |brailleSpaceBar+dot1+dot5| +|windows key |brailleSpaceBar+dot2+dot4+dot5+dot6| +|space key |brailleSpaceBar| +|Toggle control key |brailleSpaceBar+dot3+dot8| +|Toggle alt key |brailleSpaceBar+dot6+dot8| +|Toggle windows key |brailleSpaceBar+dot4+dot8| +|Toggle NVDA key |brailleSpaceBar+dot5+dot8| +|Toggle shift key |brailleSpaceBar+dot7+dot8| +|Toggle control and shift keys |brailleSpaceBar+dot3+dot7+dot8| +|Toggle alt and shift keys |brailleSpaceBar+dot6+dot7+dot8| +|Toggle windows and shift keys |brailleSpaceBar+dot4+dot7+dot8| +|Toggle NVDA and shift keys |brailleSpaceBar+dot5+dot7+dot8| +|Toggle control and alt keys |brailleSpaceBar+dot3+dot6+dot8| +|Toggle control, alt, and shift keys |brailleSpaceBar+dot3+dot6+dot7+dot8| +|windows+d key (minimize all applications) |brailleSpaceBar+dot1+dot2+dot3+dot4+dot5+dot6| +|Report Current Line |brailleSpaceBar+dot1+dot4| +|NVDA menu |brailleSpaceBar+dot1+dot3+dot4+dot5| + +For newer Focus models that contain rocker bar keys (focus 40, focus 80 and focus blue): + +| Name |Key| +|---|---| +|Move braille display to previous line |leftRockerBarUp, rightRockerBarUp| +|Move braille display to next line |leftRockerBarDown, rightRockerBarDown| + +For Focus 80 only: + +| Name |Key| +|---|---| +|Scroll braille display back |leftBumperBarUp, rightBumperBarUp| +|Scroll braille display forward |leftBumperBarDown, rightBumperBarDown| + + + +### Optelec ALVA 6 series/protocol converter {#OptelecALVA} + +Both the ALVA BC640 and BC680 displays from [Optelec](https://www.optelec.com/) are supported when connected via USB or bluetooth. +Alternatively, you can connect an older Optelec display, such as a Braille Voyager, using a protocol converter supplied by Optelec. +You do not need any specific drivers to be installed to use these displays. +Just plug in the display and configure NVDA to use it. + +Note: NVDA might be unable to use an ALVA BC6 display over Bluetooth when it is paired using the ALVA Bluetooth utility. +When you have paired your device using this utility and NVDA is unable to detect your device, we recommend you to pair your ALVA display the regular way using the Windows Bluetooth settings. + +Note: while some of these displays do have a braille keyboard, they handle translation from braille to text themselves by default. +This means that NVDA's braille input system is not in use in the default situation (i.e. the input braille table setting has no effect). +For ALVA displays with recent firmware, it is possible to disable this HID keyboard simulation using an input gesture. + +Following are key assignments for this display with NVDA. +Please see the display's documentation for descriptions of where these keys can be found. + + +| Name |Key| +|---|---| +|Scroll braille display back |t1, etouch1| +|Move braille display to previous line |t2| +|Move to current focus |t3| +|Move braille display to next line |t4| +|Scroll braille display forward |t5, etouch3| +|Route to braille cell |routing| +|Report text formatting under braille cell |secondary routing| +|Toggle HID keyboard simulation |t1+spEnter| +|Move to top line in review |t1+t2| +|Move to bottom line in review |t4+t5| +|Toggle braille tethered to |t1+t3| +|Report title |etouch2| +|Report status bar |etouch4| +|shift+tab key |sp1| +|alt key |sp2, alt| +|escape key |sp3| +|tab key |sp4| +|upArrow key |spUp| +|downArrow key |spDown| +|leftArrow key |spLeft| +|rightArrow key |spRight| +|enter key |spEnter, enter| +|Report date/time |sp2+sp3| +|NVDA Menu |sp1+sp3| +|windows+d key (minimize all applications) |sp1+sp4| +|windows+b key (focus system tray) |sp3+sp4| +|windows key |sp1+sp2, windows| +|alt+tab key |sp2+sp4| +|control+home key |t3+spUp| +|control+end key |t3+spDown| +|home key |t3+spLeft| +|end key |t3+spRight| +|control key |control| + + + +### Handy Tech Displays {#HandyTech} + +NVDA supports most displays from [Handy Tech](https://www.handytech.de/) when connected via USB, serial port or bluetooth. +For older USB displays, you will need to install the USB drivers from Handy Tech on your system. + +The following displays are not supported out of the box, but can be used via [Handy Tech's universal driver](https://handytech.de/en/service/downloads-and-manuals/handy-tech-software/braille-display-drivers) and NVDA add-on: + +* Braillino +* Bookworm +* Modular displays with firmware version 1.13 or lower. Please note that the firmware of this displays can be updated. + +Following are the key assignments for Handy Tech displays with NVDA. +Please see the display's documentation for descriptions of where these keys can be found. + + +| Name |Key| +|---|---| +|Scroll braille display back |left, up, b3| +|Scroll braille display forward |right, down, b6| +|Move braille display to previous line |b4| +|Move braille display to next line |b5| +|Route to braille cell |routing| +|shift+tab key |esc, left triple action key up+down| +|alt key |b2+b4+b5| +|escape key |b4+b6| +|tab key |enter, right triple action key up+down| +|enter key |esc+enter, left+right triple action key up+down, joystickAction| +|upArrow key |joystickUp| +|downArrow key |joystickDown| +|leftArrow key |joystickLeft| +|rightArrow key |joystickRight| +|NVDA Menu |b2+b4+b5+b6| +|Toggle braille tethered to |b2| +|Toggle the braille cursor |b1| +|Toggle focus context presentation |b7| +|Toggle braille input |space+b1+b3+b4 (space+capital B)| + + + +### MDV Lilli {#MDVLilli} + +The Lilli braille display available from [MDV](https://www.mdvbologna.it/) is supported. +You do not need any specific drivers to be installed to use this display. +Just plug in the display and configure NVDA to use it. + +This display does not support NVDA's automatic background braille display detection functionality. + +Following are the key assignments for this display with NVDA. +Please see the display's documentation for descriptions of where these keys can be found. + + +| Name |Key| +|---|---| +|Scroll braille display backward |LF| +|Scroll braille display forward |RG| +|Move braille display to previous line |UP| +|Move braille display to next line |DN| +|Route to braille cell |route| +|shift+tab key |SLF| +|tab key |SRG| +|alt+tab key |SDN| +|alt+shift+tab key |SUP| + + + +### Baum/Humanware/APH/Orbit Braille Displays {#Baum} + +Several [Baum](https://www.visiobraille.de/index.php?article_id=1&clang=2), [HumanWare](https://www.humanware.com/), [APH](https://www.aph.org/) and [Orbit](https://www.orbitresearch.com/) displays are supported when connected via USB, bluetooth or serial. +These include: + +* Baum: SuperVario, PocketVario, VarioUltra, Pronto!, SuperVario2, Vario 340 +* HumanWare: Brailliant, BrailleConnect, Brailliant2 +* APH: Refreshabraille +* Orbit: Orbit Reader 20 + +Some other displays manufactured by Baum may also work, though this has not been tested. + +If connecting via USB to displays which do not use HID, you must first install the USB drivers provided by the manufacturer. +The VarioUltra and Pronto! use HID. +The Refreshabraille and Orbit Reader 20 can use HID if configured appropriately. + +The USB serial mode of the Orbit Reader 20 is currently only supported in Windows 10 and later. +USB HID should generally be used instead. + +Following are the key assignments for these displays with NVDA. +Please see your display's documentation for descriptions of where these keys can be found. + + +| Name |Key| +|---|---| +|Scroll braille display back |`d2`| +|Scroll braille display forward |`d5`| +|Move braille display to previous line |`d1`| +|Move braille display to next line |`d3`| +|Route to braille cell |`routing`| +|`shift+tab` key |`space+dot1+dot3`| +|`tab` key |`space+dot4+dot6`| +|`alt` key |`space+dot1+dot3+dot4` (`space+m`)| +|`escape` key |`space+dot1+dot5` (`space+e`)| +|`windows` key |`space+dot3+dot4`| +|`alt+tab` key |`space+dot2+dot3+dot4+dot5` (`space+t`)| +|NVDA Menu |`space+dot1+dot3+dot4+dot5` (`space+n`)| +|`windows+d` key (minimize all applications) |`space+dot1+dot4+dot5` (`space+d`)| +|Say all |`space+dot1+dot2+dot3+dot4+dot5+dot6`| + +For displays which have a joystick: + +| Name |Key| +|---|---| +|upArrow key |up| +|downArrow key |down| +|leftArrow key |left| +|rightArrow key |right| +|enter key |select| + + + +### hedo ProfiLine USB {#HedoProfiLine} + +The hedo ProfiLine USB from [hedo Reha-Technik](https://www.hedo.de/) is supported. +You must first install the USB drivers provided by the manufacturer. + +This display does not yet support NVDA's automatic background braille display detection functionality. + +Following are the key assignments for this display with NVDA. +Please see the display's documentation for descriptions of where these keys can be found. + + +| Name |Key| +|---|---| +|Scroll braille display back |K1| +|Scroll braille display forward |K3| +|Move braille display to previous line |B2| +|Move braille display to next line |B5| +|Route to braille cell |routing| +|Toggle braille tethered to |K2| +|Say all |B6| + + + +### hedo MobilLine USB {#HedoMobilLine} + +The hedo MobilLine USB from [hedo Reha-Technik](https://www.hedo.de/) is supported. +You must first install the USB drivers provided by the manufacturer. + +This display does not yet support NVDA's automatic background braille display detection functionality. + +Following are the key assignments for this display with NVDA. +Please see the display's documentation for descriptions of where these keys can be found. + + +| Name |Key| +|---|---| +|Scroll braille display back |K1| +|Scroll braille display forward |K3| +|Move braille display to previous line |B2| +|Move braille display to next line |B5| +|Route to braille cell |routing| +|Toggle braille tethered to |K2| +|Say all |B6| + + + +### HumanWare Brailliant BI/B Series / BrailleNote Touch {#HumanWareBrailliant} + +The Brailliant BI and B series of displays from [HumanWare](https://www.humanware.com/), including the BI 14, BI 32, BI 20X, BI 40, BI 40X and B 80, are supported when connected via USB or bluetooth. +If connecting via USB with the protocol set to HumanWare, you must first install the USB drivers provided by the manufacturer. +USB drivers are not required if the protocol is set to OpenBraille. + +The following extra devices are also supported (and do not require any special drivers to be installed): + +* APH Mantis Q40 +* APH Chameleon 20 +* Humanware BrailleOne +* NLS eReader + * Note that the Zoomax is currently not supported without external drivers + +Following are the key assignments for the Brailliant BI/B and BrailleNote touch displays with NVDA. +Please see the display's documentation for descriptions of where these keys can be found. + +#### Key assignments for All models {#HumanWareBrailliantKeyAssignmentForAllModels} + + + +| Name |Key| +|---|---| +|Scroll braille display back |left| +|Scroll braille display forward |right| +|Move braille display to previous line |up| +|Move braille display to next line |down| +|Route to braille cell |routing| +|Toggle braille tethered to |up+down| +|upArrow key |space+dot1| +|downArrow key |space+dot4| +|leftArrow key |space+dot3| +|rightArrow key |space+dot6| +|shift+tab key |space+dot1+dot3| +|tab key |space+dot4+dot6| +|alt key |space+dot1+dot3+dot4 (space+m)| +|escape key |space+dot1+dot5 (space+e)| +|enter key |dot8| +|windows key |space+dot3+dot4| +|alt+tab key |space+dot2+dot3+dot4+dot5 (space+t)| +|NVDA Menu |space+dot1+dot3+dot4+dot5 (space+n)| +|windows+d key (minimize all applications) |space+dot1+dot4+dot5 (space+d)| +|Say all |space+dot1+dot2+dot3+dot4+dot5+dot6| + + + +#### Key assignments for Brailliant BI 32, BI 40 and B 80 {#HumanWareBrailliantKeyAssignmentForBI32BI40AndB80} + + + +| Name |Key| +|---|---| +|NVDA Menu |c1+c3+c4+c5 (command n)| +|windows+d key (minimize all applications) |c1+c4+c5 (command d)| +|Say all |c1+c2+c3+c4+c5+c6| + + + +#### Key assignments for Brailliant BI 14 {#HumanWareBrailliantKeyAssignmentForBI14} + + + +| Name |Key| +|---|---| +|up arrow key |joystick up| +|down arrow key |joystick down| +|left arrow key |joystick left| +|right arrow key |joystick right| +|enter key |joystick action| + + + +### HIMS Braille Sense/Braille EDGE/Smart Beetle/Sync Braille Series {#Hims} + +NVDA supports Braille Sense, Braille EDGE, Smart Beetle and Sync Braille displays from [Hims](https://www.hims-inc.com/) when connected via USB or bluetooth. +If connecting via USB, you will need to install the [USB drivers from HIMS](http://www.himsintl.com/upload/HIMS_USB_Driver_v25.zip) on your system. + +Following are the key assignments for these displays with NVDA. +Please see the display's documentation for descriptions of where these keys can be found. + + +| Name |Key| +|---|---| +|Route to braille cell |routing| +|Scroll braille display back |leftSideScrollUp, rightSideScrollUp, leftSideScroll| +|Scroll braille display forward |leftSideScrollDown, rightSideScrollDown, rightSideScroll| +|Move braille display to previous line |leftSideScrollUp+rightSideScrollUp| +|Move braille display to next line |leftSideScrollDown+rightSideScrollDown| +|Move to previous line in review |rightSideUpArrow| +|Move to next line in review |rightSideDownArrow| +|Move to previous character in review |rightSideLeftArrow| +|Move to next character in review |rightSideRightArrow| +|Move to current focus |leftSideScrollUp+leftSideScrollDown, rightSideScrollUp+rightSideScrollDown, leftSideScroll+rightSideScroll| +|control key |smartbeetle:f1, brailleedge:f3| +|windows key |f7, smartbeetle:f2| +|alt key |dot1+dot3+dot4+space, f2, smartbeetle:f3, brailleedge:f4| +|shift key |f5| +|insert key |dot2+dot4+space, f6| +|applications key |dot1+dot2+dot3+dot4+space, f8| +|Caps Lock key |dot1+dot3+dot6+space| +|tab key |dot4+dot5+space, f3, brailleedge:f2| +|shift+alt+tab key |f2+f3+f1| +|alt+tab key |f2+f3| +|shift+tab key |dot1+dot2+space| +|end key |dot4+dot6+space| +|control+end key |dot4+dot5+dot6+space| +|home key |dot1+dot3+space, smartbeetle:f4| +|control+home key |dot1+dot2+dot3+space| +|alt+f4 key |dot1+dot3+dot5+dot6+space| +|leftArrow key |dot3+space, leftSideLeftArrow| +|control+shift+leftArrow key |dot2+dot8+space+f1| +|control+leftArrow key |dot2+space| +|shift+alt+leftArrow key |dot2+dot7+f1| +|`alt+leftArrow` |`dot2+dot7+space`| +|rightArrow key |dot6+space, leftSideRightArrow| +|control+shift+rightArrow key |dot5+dot8+space+f1| +|control+rightArrow key |dot5+space| +|shift+alt+rightArrow key |dot5+dot7+f1| +|`alt+rightArrow` |`dot5+dot7+space`| +|pageUp key |dot1+dot2+dot6+space| +|control+pageUp key |dot1+dot2+dot6+dot8+space| +|upArrow key |dot1+space, leftSideUpArrow| +|control+shift+upArrow key |dot2+dot3+dot8+space+f1| +|control+upArrow key |dot2+dot3+space| +|shift+alt+upArrow key |dot2+dot3+dot7+f1| +|`alt+upArrow` |`dot2+dot3+dot7+space`| +|shift+upArrow key |leftSideScrollDown+space| +|pageDown key |dot3+dot4+dot5+space| +|control+pageDown key |dot3+dot4+dot5+dot8+space| +|downArrow key |dot4+space, leftSideDownArrow| +|control+shift+downArrow key |dot5+dot6+dot8+space+f1| +|control+downArrow key |dot5+dot6+space| +|shift+alt+downArrow key |dot5+dot6+dot7+f1| +|`alt+downArrow` |`dot5+dot6+dot7+space`| +|shift+downArrow key |space+rightSideScrollDown| +|escape key |dot1+dot5+space, f4, brailleedge:f1| +|delete key |dot1+dot3+dot5+space, dot1+dot4+dot5+space| +|f1 key |dot1+dot2+dot5+space| +|f3 key |dot1+dot4+dot8+space| +|f4 key |dot7+f3| +|windows+b key |dot1+dot2+f1| +|windows+d key |dot1+dot4+dot5+f1| +|control+insert key |smartbeetle:f1+rightSideScroll| +|alt+insert key |smartbeetle:f3+rightSideScroll| + + + +### Seika Braille Displays {#Seika} + +The following Seika Braille displays from Nippon Telesoft are supported in two groups with different functionality: + +* [Seika Version 3, 4, and 5 (40 cells), Seika80 (80 cells)](#SeikaBrailleDisplays) +* [MiniSeika (16, 24 cells), V6, and V6Pro (40 cells)](#SeikaNotetaker) + +You can find more information about the displays on their [Demo and Driver Download page](https://en.seika-braille.com/down/index.html). + +#### Seika Version 3, 4, and 5 (40 cells), Seika80 (80 cells) {#SeikaBrailleDisplays} + +* These displays do not yet support NVDA's automatic background braille display detection functionality. +* Select "Seika Braille Displays" to manually configure +* A device drivers must be installed before using Seika v3/4/5/80. +The drivers are [provided by the manufacturer](https://en.seika-braille.com/down/index.html). + +The Seika Braille Display key assignments follow. +Please see the display's documentation for descriptions of where these keys can be found. + + +| Name |Key| +|---|---| +|Scroll braille display back |left| +|Scroll braille display forward |right| +|Move braille display to previous line |b3| +|Move braille display to next line |b4| +|Toggle braille tethered to |b5| +|Say all |b6| +|tab |b1| +|shift+tab |b2| +|alt+tab |b1+b2| +|NVDA Menu |left+right| +|Route to braille cell |routing| + + + +#### MiniSeika (16, 24 cells), V6, and V6Pro (40 cells) {#SeikaNotetaker} + +* NVDA's automatic background braille display detection functionality is supported via USB and Bluetooth. +* Select "Seika Notetaker" or "auto" to configure. +* No extra drivers are required when using a Seika Notetaker braille display. + +The Seika Notetaker key assignments follow. +Please see the display's documentation for descriptions of where these keys can be found. + + +| Name |Key| +|---|---| +|Scroll braille display back |left| +|Scroll braille display forward |right| +|Say all |space+Backspace| +|NVDA Menu |Left+Right| +|Move braille display to previous line |LJ up| +|Move braille display to next line |LJ down| +|Toggle braille tethered to |LJ center| +|tab |LJ right| +|shift+tab |LJ left| +|upArrow key |RJ up| +|downArrow key |RJ down| +|leftArrow key |RJ left| +|rightArrow key |RJ right| +|Route to braille cell |routing| +|shift+upArrow key |Space+RJ up, Backspace+RJ up| +|shift+downArrow key |Space+RJ down, Backspace+RJ down| +|shift+leftArrow key |Space+RJ left, Backspace+RJ left| +|shift+rightArrow key |Space+RJ right, Backspace+RJ right| +|enter key |RJ center, dot8| +|escape key |Space+RJ center| +|windows key |Backspace+RJ center| +|space key |Space, Backspace| +|backspace key |dot7| +|pageup key |space+LJ right| +|pagedown key |space+LJ left| +|home key |space+LJ up| +|end key |space+LJ down| +|control+home key |backspace+LJ up| +|control+end key |backspace+LJ down| + +### Papenmeier BRAILLEX Newer Models {#Papenmeier} + +The following Braille displays are supported: + +* BRAILLEX EL 40c, EL 80c, EL 20c, EL 60c (USB) +* BRAILLEX EL 40s, EL 80s, EL 2d80s, EL 70s, EL 66s (USB) +* BRAILLEX Trio (USB and bluetooth) +* BRAILLEX Live 20, BRAILLEX Live and BRAILLEX Live Plus (USB and bluetooth) + +These displays do not support NVDA's automatic background braille display detection functionality. +There is an option in the display's USB driver which can cause an issue with loading the display. +Please try the following: + +1. Please make sure that you have installed the [latest driver](https://www.papenmeier-rehatechnik.de/en/service/downloadcenter/software/articles/software-braille-devices.html). +1. Open the Windows Device Manager. +1. Scroll down the list to "USB Controllers" or "USB Devices". +1. Select "Papenmeier Braillex USB Device". +1. Open the properties and switch to the "Advanced" tab. +Sometimes the "Advanced" tab doesn't appear. +If this is the case, disconnect the braille display from the computer, exit NVDA, wait a moment and reconnect the braille display. +Repeat this 4 to 5 times if necessary. +If the "Advanced" tab is still not displayed, please restart the computer. +1. Disable the "Load VCP" option. + +Most devices have an Easy Access Bar (EAB) that allows intuitive and fast operation. +The EAB can be moved in four directions where generally each direction has two switches. +The C and Live series are the only exceptions to this rule. + +The c-series and some other displays have two routing rows whereby the upper row is used to report formatting information. +Holding one of the upper routing keys and pressing the EAB on c-series devices emulates the second switch state. +The live series displays have one routing row only and the EAB has one step per direction. +The second step may be emulated by pressing one of the routing keys and pressing the EAB in the corresponding direction. +Pressing and holding the up, down, right and left keys (or EAB) causes the corresponding action to be repeated. + +Generally, the following keys are available on these braille displays: + +| Name |Key| +|---|---| +|l1 |Left front key| +|l2 |Left rear key| +|r1 |Right front key| +|r2 |Right rear key| +|up |1 Step up| +|up2 |2 Steps up| +|left |1 Step left| +|left2 |2 Steps left| +|right |1 Step right| +|right2 |2 Steps right| +|dn |1 Step down| +|dn2 |2 Steps down| + +Following are the Papenmeier command assignments for NVDA: + + +| Name |Key| +|---|---| +|Scroll braille display back |left| +|Scroll braille display forward |right| +|Move braille display to previous line |up| +|Move braille display to next line |dn| +|Route to braille cell |routing| +|Report current character in review |l1| +|Activate current navigator object |l2| +|Toggle braille tethered to |r2| +|Report title |l1+up| +|Report Status Bar |l2+down| +|Move to containing object |up2| +|Move to first contained object |dn2| +|Move to previous object |left2| +|Move to next object |right2| +|Report text formatting under braille cell |upper routing row| + + + +The Trio model has four additional keys which are in front of the braille keyboard. +These are (ordered from left to right): + +* left thumb key (lt) +* space +* space +* right thumb key (rt) + +Currently, the right thumb key is not in use. +The inner keys are both mapped to space. + + + +| Name |Key| +|---|---| +|escape key |space with dot 7| +|upArrow key |space with dot 2| +|leftArrow key |space with dot 1| +|rightArrow key |space with dot 4| +|downArrow |space with dot 5| +|control key |lt+dot2| +|alt key |lt+dot3| +|control+escape key |space with dot 1 2 3 4 5 6| +|tab key |space with dot 3 7| + + + +### Papenmeier Braille BRAILLEX Older Models {#PapenmeierOld} + +The following Braille displays are supported: + +* BRAILLEX EL 80, EL 2D-80, EL 40 P +* BRAILLEX Tiny, 2D Screen + +Note that these displays can only be connected via a serial port. +Due to this, these displays do not support NVDA's automatic background braille display detection functionality. +You should select the port to which the display is connected after you have chosen this driver in the [Select Braille Display](#SelectBrailleDisplay) dialog. + +Some of these devices have an Easy Access Bar (EAB) that allows intuitive and fast operation. +The EAB can be moved in four directions where generally each direction has two switches. +Pressing and holding the up, down, right and left keys (or EAB) causes the corresponding action to be repeated. +Older devices do not have an EAB; front keys are used instead. + +Generally, the following keys are available on braille displays: + +| Name |Key| +|---|---| +|l1 |Left front key| +|l2 |Left rear key| +|r1 |Right front key| +|r2 |Right rear key| +|up |1 Step up| +|up2 |2 Steps up| +|left |1 Step left| +|left2 |2 Steps left| +|right |1 Step right| +|right2 |2 Steps right| +|dn |1 Step down| +|dn2 |2 Steps down| + +Following are the Papenmeier command assignments for NVDA: + + +Devices with EAB: + +| Name |Key| +|---|---| +|Scroll braille display back |left| +|Scroll braille display forward |right| +|Move braille display to previous line |up| +|Move braille display to next line |dn| +|Route to braille cell |routing| +|Report current character in review |l1| +|Activate current navigator object |l2| +|Report title |l1up| +|Report Status Bar |l2down| +|Move to containing object |up2| +|Move to first contained object |dn2| +|Move to next object |right2| +|Move to previous object |left2| +|Report text formatting under braille cell |upper routing strip| + +BRAILLEX Tiny: + +| Name |Key| +|---|---| +|Report current character in review |l1| +|Activate current navigator object |l2| +|Scroll braille display back |left| +|Scroll braille display forward |right| +|Move braille display to previous line |up| +|Move braille display to next line |dn| +|Toggle braille tethered to |r2| +|Move to containing object |r1+up| +|Move to first contained object |r1+dn| +|Move to previous object |r1+left| +|Move to next object |r1+right| +|Report text formatting under braille cell |upper routing strip| +|Report title |l1+up| +|Report status bar |l2+down| + +BRAILLEX 2D Screen: + +| Name |Key| +|---|---| +|Report current character in review |l1| +|Activate current navigator object |l2| +|Toggle braille tethered to |r2| +|Report text formatting under braille cell |upper routing strip| +|Move braille display to previous line |up| +|Scroll braille display back |left| +|Scroll braille display forward |right| +|Move braille display to next line |dn| +|Move to next object |left2| +|Move to containing object |up2| +|Move to first contained object |dn2| +|Move to previous object |right2| + + + +### HumanWare BrailleNote {#HumanWareBrailleNote} + +NVDA supports the BrailleNote notetakers from [Humanware](https://www.humanware.com) when acting as a display terminal for a screen reader. +The following models are supported: + +* BrailleNote Classic (serial connection only) +* BrailleNote PK (Serial and bluetooth connections) +* BrailleNote MPower (Serial and bluetooth connections) +* BrailleNote Apex (USB and Bluetooth connections) + +For BrailleNote Touch, please refer to the [Brailliant BI Series / BrailleNote Touch](#HumanWareBrailliant) section. + +Except for BrailleNote PK, both braille (BT) and QWERTY (QT) keyboards are supported. +For BrailleNote QT, PC keyboard emulation isn't supported. +You can also enter braille dots using the QT keyboard. +Please check the braille terminal section of the BrailleNote manual guide for details. + +If your device supports more than one type of connection, when connecting your BrailleNote to NVDA, you must set the braille terminal port in braille terminal options. +Please check the BrailleNote manual for details. +In NVDA, you may also need to set the port in the [Select Braille Display](#SelectBrailleDisplay) dialog. +If you are connecting via USB or bluetooth, you can set the port to "Automatic", "USB" or "Bluetooth", depending on the available choices. +If connecting using a legacy serial port (or a USB to serial converter) or if none of the previous options appear, you must explicitly choose the communication port to be used from the list of hardware ports. + +Before connecting your BrailleNote Apex using its USB client interface, you must install the drivers provided by HumanWare. + +On the BrailleNote Apex BT, you can use the scroll wheel located between dots 1 and 4 for various NVDA commands. +The wheel consists of four directional dots, a centre click button, and a wheel that spins clockwise or counterclockwise. + +Following are the BrailleNote command assignments for NVDA. +Please check your BrailleNote's documentation to find where these keys are located. + + + +| Name |Key| +|---|---| +|Scroll braille display back |back| +|Scroll braille display forward |advance| +|Move braille display to previous line |previous| +|Move braille display to next line |next| +|Route to braille cell |routing| +|NVDA menu |space+dot1+dot3+dot4+dot5 (space+n)| +|Toggle braille tethered to |previous+next| +|Up arrow key |space+dot1| +|Down arrow key |space+dot4| +|Left Arrow key |space+dot3| +|Right arrow key |space+dot6| +|Page up key |space+dot1+dot3| +|Page down key |space+dot4+dot6| +|Home key |space+dot1+dot2| +|End key |space+dot4+dot5| +|Control+home keys |space+dot1+dot2+dot3| +|Control+end keys |space+dot4+dot5+dot6| +|Space key |space| +|Enter |space+dot8| +|Backspace |space+dot7| +|Tab key |space+dot2+dot3+dot4+dot5 (space+t)| +|Shift+tab keys |space+dot1+dot2+dot5+dot6| +|Windows key |space+dot2+dot4+dot5+dot6 (space+w)| +|Alt key |space+dot1+dot3+dot4 (space+m)| +|Toggle input help |space+dot2+dot3+dot6 (space+lower h)| + +Following are commands assigned to BrailleNote QT when it is not in braille input mode. + +| Name |Key| +|---|---| +|NVDA menu |read+n| +|Up arrow key |upArrow| +|Down arrow key |downArrow| +|Left Arrow key |leftArrow| +|Right arrow key |rightArrow| +|Page up key |function+upArrow| +|Page down key |function+downArrow| +|Home key |function+leftArrow| +|End key |function+rightArrow| +|Control+home keys |read+t| +|Control+end keys |read+b| +|Enter key |enter| +|Backspace key |backspace| +|Tab key |tab| +|Shift+tab keys |shift+tab| +|Windows key |read+w| +|Alt key |read+m| +|Toggle input help |read+1| + +Following are commands assigned to the scroll wheel: + +| Name |Key| +|---|---| +|Up arrow key |upArrow| +|Down arrow key |downArrow| +|Left Arrow key |leftArrow| +|Right arrow key |rightArrow| +|Enter key |centre button| +|Tab key |scroll wheel clockwise| +|Shift+tab keys |scroll wheel counterclockwise| + + + +### EcoBraille {#EcoBraille} + +NVDA supports EcoBraille displays from [ONCE](https://www.once.es/). +The following models are supported: + +* EcoBraille 20 +* EcoBraille 40 +* EcoBraille 80 +* EcoBraille Plus + +In NVDA, you can set the serial port to which the display is connected in the [Select Braille Display](#SelectBrailleDisplay) dialog. +These displays do not support NVDA's automatic background braille display detection functionality. + +Following are the key assignments for EcoBraille displays. +Please see the [EcoBraille documentation](ftp://ftp.once.es/pub/utt/bibliotecnia/Lineas_Braille/ECO/) for descriptions of where these keys can be found. + + + +| Name |Key| +|---|---| +|Scroll braille display back |T2| +|Scroll braille display forward |T4| +|Move braille display to previous line |T1| +|Move braille display to next line |T5| +|Route to braille cell |Routing| +|Activate current navigator object |T3| +|Switch to next review mode |F1| +|Move to containing object |F2| +|Switch to previous review mode |F3| +|Move to previous object |F4| +|Report current object |F5| +|Move to next object |F6| +|Move to focus object |F7| +|Move to first contained object |F8| +|Move System focus or caret to current review position |F9| +|Report review cursor location |F0| +|Toggle braille tethered to |A| + + + +### SuperBraille {#SuperBraille} + +The SuperBraille device, mostly available in Taiwan, can be connected to by either USB or serial. +As the SuperBraille does not have any physical typing keys or scrolling buttons, all input must be performed via a standard computer keyboard. +Due to this, and to maintain compatibility with other screen readers in Taiwan, two key bindings for scrolling the braille display have been provided: + + +| Name |Key| +|---|---| +|Scroll braille display back |numpadMinus| +|Scroll braille display forward |numpadPlus| + + + +### Eurobraille displays {#Eurobraille} + +The b.book, b.note, Esys, Esytime and Iris displays from Eurobraille are supported by NVDA. +These devices have a braille keyboard with 10 keys. +Please refer to the display's documentation for descriptions of these keys. +Of the two keys placed like a space bar, the left key is corresponding to the backspace key and the right key to the space key. + +These devices are connected via USB and have one stand-alone USB keyboard. +It is possible to enable/disable this keyboard by toggling "HID Keyboard simulation" using an input gesture. +The braille keyboard functions described directly below is when "HID Keyboard simulation" is disabled. + +#### Braille keyboard functions {#EurobrailleBraille} + + + +| Name |Key| +|---|---| +|Erase the last entered braille cell or character |`backspace`| +|Translate any braille input and press the enter key |`backspace+space`| +|Toggle `NVDA` key |`dot3+dot5+space`| +|`insert` key |`dot1+dot3+dot5+space`, `dot3+dot4+dot5+space`| +|`delete` key |`dot3+dot6+space`| +|`home` key |`dot1+dot2+dot3+space`| +|`end` key |`dot4+dot5+dot6+space`| +|`leftArrow` key |`dot2+space`| +|`rightArrow` key |`dot5+space`| +|`upArrow` key |`dot1+space`| +|`downArrow` key |`dot6+space`| +|`pageUp` key |`dot1+dot3+space`| +|`pageDown` key |`dot4+dot6+space`| +|`numpad1` key |`dot1+dot6+backspace`| +|`numpad2` key |`dot1+dot2+dot6+backspace`| +|`numpad3` key |`dot1+dot4+dot6+backspace`| +|`numpad4` key |`dot1+dot4+dot5+dot6+backspace`| +|`numpad5` key |`dot1+dot5+dot6+backspace`| +|`numpad6` key |`dot1+dot2+dot4+dot6+backspace`| +|`numpad7` key |`dot1+dot2+dot4+dot5+dot6+backspace`| +|`numpad8` key |`dot1+dot2+dot5+dot6+backspace`| +|`numpad9` key |`dot2+dot4+dot6+backspace`| +|`numpadInsert` key |`dot3+dot4+dot5+dot6+backspace`| +|`numpadDecimal` key |`dot2+backspace`| +|`numpadDivide` key |`dot3+dot4+backspace`| +|`numpadMultiply` key |`dot3+dot5+backspace`| +|`numpadMinus` key |`dot3+dot6+backspace`| +|`numpadPlus` key |`dot2+dot3+dot5+backspace`| +|`numpadEnter` key |`dot3+dot4+dot5+backspace`| +|`escape` key |`dot1+dot2+dot4+dot5+space`, `l2`| +|`tab` key |`dot2+dot5+dot6+space`, `l3`| +|`shift+tab` keys |`dot2+dot3+dot5+space`| +|`printScreen` key |`dot1+dot3+dot4+dot6+space`| +|`pause` key |`dot1+dot4+space`| +|`applications` key |`dot5+dot6+backspace`| +|`f1` key |`dot1+backspace`| +|`f2` key |`dot1+dot2+backspace`| +|`f3` key |`dot1+dot4+backspace`| +|`f4` key |`dot1+dot4+dot5+backspace`| +|`f5` key |`dot1+dot5+backspace`| +|`f6` key |`dot1+dot2+dot4+backspace`| +|`f7` key |`dot1+dot2+dot4+dot5+backspace`| +|`f8` key |`dot1+dot2+dot5+backspace`| +|`f9` key |`dot2+dot4+backspace`| +|`f10` key |`dot2+dot4+dot5+backspace`| +|`f11` key |`dot1+dot3+backspace`| +|`f12` key |`dot1+dot2+dot3+backspace`| +|`windows` key |`dot1+dot2+dot4+dot5+dot6+space`| +|Toggle `windows` key |`dot1+dot2+dot3+dot4+backspace`, `dot2+dot4+dot5+dot6+space`| +|`capsLock` key |`dot7+backspace`, `dot8+backspace`| +|`numLock` key |`dot3+backspace`, `dot6+backspace`| +|`shift` key |`dot7+space`| +|Toggle `shift` key |`dot1+dot7+space`, `dot4+dot7+space`| +|`control` key |`dot7+dot8+space`| +|Toggle `control` key |`dot1+dot7+dot8+space`, `dot4+dot7+dot8+space`| +|`alt` key |`dot8+space`| +|Toggle `alt` key |`dot1+dot8+space`, `dot4+dot8+space`| +|Toggle HID Keyboard simulation |`switch1Left+joystick1Down`, `switch1Right+joystick1Down`| + + + +#### b.book keyboard commands {#Eurobraillebbook} + + + +| Name |Key| +|---|---| +|Scroll braille display back |`backward`| +|Scroll braille display forward |`forward`| +|Move to current focus |`backward+forward`| +|Route to braille cell |`routing`| +|`leftArrow` key |`joystick2Left`| +|`rightArrow` key |`joystick2Right`| +|`upArrow` key |`joystick2Up`| +|`downArrow` key |`joystick2Down`| +|`enter` key |`joystick2Center`| +|`escape` key |`c1`| +|`tab` key |`c2`| +|Toggle `shift` key |`c3`| +|Toggle `control` key |`c4`| +|Toggle `alt` key |`c5`| +|Toggle `NVDA` key |`c6`| +|`control+Home` key |`c1+c2+c3`| +|`control+End` key |`c4+c5+c6`| + + + +#### b.note keyboard commands {#Eurobraillebnote} + + + +| Name |Key| +|---|---| +|Scroll braille display back |`leftKeypadLeft`| +|Scroll braille display forward |`leftKeypadRight`| +|Route to braille cell |`routing`| +|Report text formatting under braille cell |`doubleRouting`| +|Move to next line in review |`leftKeypadDown`| +|Switch to previous review mode |`leftKeypadLeft+leftKeypadUp`| +|Switch to next review mode |`leftKeypadRight+leftKeypadDown`| +|`leftArrow` key |`rightKeypadLeft`| +|`rightArrow` key |`rightKeypadRight`| +|`upArrow` key |`rightKeypadUp`| +|`downArrow` key |`rightKeypadDown`| +|`control+home` key |`rightKeypadLeft+rightKeypadUp`| +|`control+end` key |`rightKeypadLeft+rightKeypadUp`| + + + +#### Esys keyboard commands {#Eurobrailleesys} + + + +| Name |Key| +|---|---| +|Scroll braille display back |`switch1Left`| +|Scroll braille display forward |`switch1Right`| +|Move to current focus |`switch1Center`| +|Route to braille cell |`routing`| +|Report text formatting under braille cell |`doubleRouting`| +|Move to previous line in review |`joystick1Up`| +|Move to next line in review |`joystick1Down`| +|Move to previous character in review |`joystick1Left`| +|Move to next character in review |`joystick1Right`| +|`leftArrow` key |`joystick2Left`| +|`rightArrow` key |`joystick2Right`| +|`upArrow` key |`joystick2Up`| +|`downArrow` key |`joystick2Down`| +|`enter` key |`joystick2Center`| + + + +#### Esytime keyboard commands {#EurobrailleEsytime} + + + +| Name |Key| +|---|---| +|Scroll braille display back |`l1`| +|Scroll braille display forward |`l8`| +|Move to current focus |`l1+l8`| +|Route to braille cell |`routing`| +|Report text formatting under braille cell |`doubleRouting`| +|Move to previous line in review |`joystick1Up`| +|Move to next line in review |`joystick1Down`| +|Move to previous character in review |`joystick1Left`| +|Move to next character in review |`joystick1Right`| +|`leftArrow` key |`joystick2Left`| +|`rightArrow` key |`joystick2Right`| +|`upArrow` key |`joystick2Up`| +|`downArrow` key |`joystick2Down`| +|`enter` key |`joystick2Center`| +|`escape` key |`l2`| +|`tab` key |`l3`| +|Toggle `shift` key |`l4`| +|Toggle `control` key |`l5`| +|Toggle `alt` key |`l6`| +|Toggle `NVDA` key |`l7`| +|`control+home` key |`l1+l2+l3`, `l2+l3+l4`| +|`control+end` key |`l6+l7+l8`, `l5+l6+l7`| +|Toggle HID Keyboard simulation |`l1+joystick1Down`, `l8+joystick1Down`| + + + +### Nattiq nBraille Displays {#NattiqTechnologies} + +NVDA supports displays from [Nattiq Technologies](https://www.nattiq.com/) when connected via USB. +Windows 10 and later detects the Braille Displays once connected, you may need to install USB drivers if using older versions of Windows (below Win10). +You can get them from the manufacturer's website. + +Following are the key assignments for Nattiq Technologies displays with NVDA. +Please see the display's documentation for descriptions of where these keys can be found. + + +| Name |Key| +|---|---| +|Scroll braille display back |up| +|Scroll braille display forward |down| +|Move braille display to previous line |left| +|Move braille display to next line |right| +|Route to braille cell |routing| + + + +### BRLTTY {#BRLTTY} + +[BRLTTY](https://www.brltty.app/) is a separate program which can be used to support many more braille displays. +In order to use this, you need to install [BRLTTY for Windows](https://www.brltty.app/download.html). +You should download and install the latest installer package, which will be named, for example, brltty-win-4.2-2.exe. +When configuring the display and port to use, be sure to pay close attention to the instructions, especially if you are using a USB display and already have the manufacturer's drivers installed. + +For displays which have a braille keyboard, BRLTTY currently handles braille input itself. +Therefore, NVDA's braille input table setting is not relevant. + +BRLTTY is not involved in NVDA's automatic background braille display detection functionality. + +Following are the BRLTTY command assignments for NVDA. +Please see the [BRLTTY key binding lists](https://brltty.app/doc/KeyBindings/) for information about how BRLTTY commands are mapped to controls on braille displays. + + +| Name |BRLTTY command| +|---|---| +|Scroll braille display back |`fwinlt` (go left one window)| +|Scroll braille display forward |`fwinrt` (go right one window)| +|Move braille display to previous line |`lnup` (go up one line)| +|Move braille display to next line |`lndn` (go down one line)| +|Route to braille cell |`route` (bring cursor to character)| +|Toggle input help |`learn` (enter/leave command learn mode)| +|Open the NVDA menu |`prefmenu` (enter/leave preferences menu)| +|Revert configuration |`prefload` (restore preferences from disk)| +|Save configuration |`prefsave` (save preferences to disk)| +|Report time |`time` (show current date and time)| +|Speak the line where the review cursor is located |`say_line` (speak current line)| +|Say all using review cursor |`say_below` (speak from current line through bottom of screen)| + + + +### Tivomatic Caiku Albatross 46/80 {#Albatross} + +The Caiku Albatross devices, which were manufactured by Tivomatic and available in Finland, can be connected to by either USB or serial. +You do not need any specific drivers to be installed to use these displays. +Just plug in the display and configure NVDA to use it. + +Note: Baud rate 19200 is strongly recommended. +If required, switch Baud rate setting value to 19200 from the braille device's menu. +Although the driver supports 9600 baud rate, it has no way to control what baud rate the display uses. +Because 19200 is the display default baud rate, the driver tries it at first. +If baud rates are not the same, the driver may behave unexpectedly. + +Following are key assignments for these displays with NVDA. +Please see the display's documentation for descriptions of where these keys can be found. + + +| Name |Key| +|---|---| +|Move to top line in review |`home1`, `home2`| +|Move to bottom line in review |`end1`, `end2`| +|Sets the navigator object to the current focus |`eCursor1`, `eCursor2`| +|Move to current focus |`cursor1`, `cursor2`| +|Moves the mouse pointer to the current navigator object |`home1+home2`| +|Sets the navigator object to the current object under the mouse pointer and speaks it |`end1+end2`| +|Moves focus to current navigator object |`eCursor1+eCursor2`| +|Toggle braille tethered to |`cursor1+cursor2`| +|Move braille display to previous line |`up1`, `up2`, `up3`| +|Move braille display to next line |`down1`, `down2`, `down3`| +|Scroll braille display back |`left`, `lWheelLeft`, `rWheelLeft`| +|Scroll braille display forward |`right`, `lWheelRight`, `rWheelRight`| +|Route to braille cell |`routing`| +|Report text formatting under braille cell |`secondary routing`| +|Toggle the way context information is presented in braille |`attribute1+attribute3`| +|Cycles between speech modes |`attribute2+attribute4`| +|Switches to the previous review mode (e.g. object, document or screen) |`f1`| +|Switches to the next review mode (e.g. object, document or screen) |`f2`| +|Moves the navigator object to the object containing it |`f3`| +|Moves the navigator object to the first object inside it |`f4`| +|Moves the navigator object to the previous object |`f5`| +|Moves the navigator object to the next object |`f6`| +|Reports the current navigator object |`f7`| +|Reports information about the location of the text or object at the review cursor |`f8`| +|Shows braille settings |`f1+home1`, `f9+home2`| +|Reads status bar and moves navigator object into it |`f1+end1`, `f9+end2`| +|Cycle the braille cursor shape |`f1+eCursor1`, `f9+eCursor2`| +|Toggle the braille cursor |`f1+cursor1`, `f9+cursor2`| +|Cycle the braille show messages mode |`f1+f2`, `f9+f10`| +|Cycle the braille show selection state |`f1+f5`, `f9+f14`| +|Cycle the "braille move system caret when routing review cursor" states |`f1+f3`, `f9+f11`| +|Performs the default action on the current navigator object |`f7+f8`| +|Reports date/time |`f9`| +|Reports battery status and time remaining if AC is not plugged in |`f10`| +|Reports title |`f11`| +|Reports status bar |`f12`| +|Reports the current line under the application cursor |`f13`| +|Say all |`f14`| +|Reports current character under review cursor |`f15`| +|Reports the line of the current navigator object where the review cursor is situated |`f16`| +|Speaks the word of the current navigator object where the review cursor is situated |`f15+f16`| +|Moves the review cursor to the previous line of the current navigator object and speaks it |`lWheelUp`, `rWheelUp`| +|Moves the review cursor to the next line of the current navigator object and speaks it |`lWheelDown`, `rWheelDown`| +|`Windows+d` key (minimize all applications) |`attribute1`| +|`Windows+e` key (this computer) |`attribute2`| +|`Windows+b` key (focus system tray) |`attribute3`| +|`Windows+i` key (Windows settings) |`attribute4`| + + + +### Standard HID Braille displays {#HIDBraille} + +This is an experimental driver for the new Standard HID Braille Specification, agreed upon in 2018 by Microsoft, Google, Apple and several assistive technology companies including NV Access. +The hope is that all future Braille Display models created by any manufacturer, will use this standard protocol which will remove the need for manufacturer-specific Braille drivers. + +NVDA's automatic braille display detection will also recognize any display that supports this protocol. + +Following are the current key assignments for these displays. + + +| Name |Key| +|---|---| +|Scroll braille display back |pan left or rocker up| +|Scroll braille display forward |pan right or rocker down| +|Route to braille cell |routing set 1| +|Toggle braille tethered to |up+down| +|upArrow key |joystick up, dpad up or space+dot1| +|downArrow key |joystick down, dpad down or space+dot4| +|leftArrow key |space+dot3, joystick left or dpad left| +|rightArrow key |space+dot6, joystick right or dpad right| +|shift+tab key |space+dot1+dot3| +|tab key |space+dot4+dot6| +|alt key |space+dot1+dot3+dot4 (space+m)| +|escape key |space+dot1+dot5 (space+e)| +|enter key |dot8, joystick center or dpad center| +|windows key |space+dot3+dot4| +|alt+tab key |space+dot2+dot3+dot4+dot5 (space+t)| +|NVDA Menu |space+dot1+dot3+dot4+dot5 (space+n)| +|windows+d key (minimize all applications) |space+dot1+dot4+dot5 (space+d)| +|Say all |space+dot1+dot2+dot3+dot4+dot5+dot6| + + + +## Advanced Topics {#AdvancedTopics} +### Secure Mode {#SecureMode} + +System administrators may wish to configure NVDA to restrict unauthorized system access. +NVDA allows the installation of custom add-ons, which can execute arbitrary code, including when NVDA is elevated to administrator privileges. +NVDA also allows users to execute arbitrary code through the NVDA Python Console. +NVDA secure mode prevents users from modifying their NVDA configuration, and otherwise limits unauthorized system access. + +NVDA runs in secure mode when executed on [secure screens](#SecureScreens), unless the `serviceDebug` [system wide parameter](#SystemWideParameters) is enabled. +To force NVDA to always start in secure mode, set the `forceSecureMode` [system wide parameter](#SystemWideParameters). +NVDA can also be started in secure mode with the `-s` [command line option](#CommandLineOptions). + +Secure mode disables: + +* Saving configuration and other settings to disk +* Saving the gesture map to disk +* [Configuration Profile](#ConfigurationProfiles) features such as creation, deletion, renaming profiles etc. +* Loading custom configuration folders using [the `-c` command line option](#CommandLineOptions) +* Updating NVDA and creating portable copies +* The [Add-on Store](#AddonsManager) +* The [NVDA Python console](#PythonConsole) +* The [Log Viewer](#LogViewer) and logging +* The [Braille Viewer](#BrailleViewer) and [Speech Viewer](#SpeechViewer) +* Opening external documents from the NVDA menu, such as the user guide or contributors file. + +Installed copies of NVDA store their configuration including add-ons in `%APPDATA%\nvda`. +To prevent NVDA users from modifying their configuration or add-ons directly, user access to this folder must also be restricted. + +Secure mode is ineffective for portable copies of NVDA. +This limitation also applies to the temporary copy of NVDA which runs when launching the installer. +In secure environments, a user being able to run a portable executable is the same security risk regardless of secure mode. +It is expected that system administrators restrict unauthorized software from running on their systems, including portable copies of NVDA. + +NVDA users often rely on configuring their NVDA profile to suit their needs. +This may include installing and configuring custom add-ons, which should be vetted independently to NVDA. +Secure mode freezes changes to NVDA configuration, so please ensure that NVDA is configured appropriately before forcing secure mode. + +### Secure Screens {#SecureScreens} + +NVDA runs in [secure mode](#SecureMode) when executed on secure screens unless the `serviceDebug` [system wide parameter](#SystemWideParameters) is enabled. + +When running from a secure screen, NVDA uses a system profile for preferences. +NVDA user preferences can be copied [for use in secure screens](#GeneralSettingsCopySettings). + +Secure screens include: + +* The Windows sign-in screen +* The User Access Control dialog, active when performing an action as an administrator + * This includes installing programs + +### Command Line Options {#CommandLineOptions} + +NVDA can accept one or more additional options when it starts which alter its behaviour. +You can pass as many options as you need. +These options can be passed when starting from a shortcut (in the shortcut properties), from the Run dialog (Start Menu -> Run or Windows+r) or from a Windows command console. +Options should be separated from the name of NVDA's executable file and from other options by spaces. +For example, a useful option is `--disable-addons`, which tells NVDA to suspend all running add-ons. +This allows you to determine whether a problem is caused by an add-on and to recover from serious problems caused by add-ons. + +As an example, you can exit the currently running copy of NVDA by entering the following in the Run dialog: + + nvda -q + +Some of the command line options have a short and a long version, while some of them have only a long version. +For those which have a short version, you can combine them like this: + +| . {.hideHeaderRow} |.| +|---|---| +|`nvda -mc CONFIGPATH` |This will start NVDA with startup sounds and message disabled, and the specified configuration| +|`nvda -mc CONFIGPATH --disable-addons` |Same as above, but with add-ons disabled| + +Some of the command line options accept additional parameters; e.g. how detailed the logging should be or the path to the user configuration directory. +Those parameters should be placed after the option, separated from the option by a space when using the short version or an equals sign (`=`) when using the long version; e.g.: + +| . {.hideHeaderRow} |.| +|---|---| +|`nvda -l 10` |Tells NVDA to start with log level set to debug| +|`nvda --log-file=c:\nvda.log` |Tells NVDA to write its log to `c:\nvda.log`| +|`nvda --log-level=20 -f c:\nvda.log` |Tells NVDA to start with log level set to info and to write its log to `c:\nvda.log`| + +Following are the command line options for NVDA: + +| Short |Long |Description| +|---|---|---| +|`-h` |`--help` |show command line help and exit| +|`-q` |`--quit` |Quit already running copy of NVDA| +|`-k` |`--check-running` |Report whether NVDA is running via the exit code; 0 if running, 1 if not running| +|`-f LOGFILENAME` |`--log-file=LOGFILENAME` |The file where log messages should be written to. Logging is always disabled if secure mode is enabled.| +|`-l LOGLEVEL` |`--log-level=LOGLEVEL` |The lowest level of message logged (debug 10, input/output 12, debug warning 15, info 20, disabled 100). Logging is always disabled if secure mode is enabled.| +|`-c CONFIGPATH` |`--config-path=CONFIGPATH` |The path where all settings for NVDA are stored. The default value is forced if secure mode is enabled.| +|None |`--lang=LANGUAGE` |Override the configured NVDA language. Set to "Windows" for current user default, "en" for English, etc.| +|`-m` |`--minimal` |No sounds, no interface, no start message, etc.| +|`-s` |`--secure` |Starts NVDA in [Secure Mode](#SecureMode)| +|None |`--disable-addons` |Add-ons will have no effect| +|None |`--debug-logging` |Enable debug level logging just for this run. This setting will override any other log level ( `--loglevel`, `-l`) argument given, including no logging option.| +|None |`--no-logging` |Disable logging altogether while using NVDA. This setting can be overridden if a log level (`--loglevel`, `-l`) is specified from command line or if debug logging is turned on.| +|None |`--no-sr-flag` |Don't change the global system screen reader flag| +|None |`--install` |Installs NVDA (starting the newly installed copy)| +|None |`--install-silent` |Silently installs NVDA (does not start the newly installed copy)| +|None |`--enable-start-on-logon=True|False` |When installing, enable NVDA's [Use NVDA during Windows sign-in](#StartAtWindowsLogon)| +|None |`--copy-portable-config` |When installing, copy the portable configuration from the provided path (`--config-path`, `-c`) to the current user account| +|None |`--create-portable` |Creates a portable copy of NVDA (and starts the new copy). Requires `--portable-path` to be specified| +|None |`--create-portable-silent` |Creates a portable copy of NVDA (without starting the new copy). Requires `--portable-path` to be specified. This option suppresses warnings when writing to non-empty directories and may overwrite files without warning.| +|None |`--portable-path=PORTABLEPATH` |The path where a portable copy will be created| + +### System Wide Parameters {#SystemWideParameters} + +NVDA allows some values to be set in the system registry which alter the system wide behaviour of NVDA. +These values are stored in the registry under one of the following keys: + +* 32-bit system: `HKEY_LOCAL_MACHINE\SOFTWARE\nvda` +* 64-bit system: `HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\nvda` + +The following values can be set under this registry key: + +| Name |Type |Possible values |Description| +|---|---|---|---| +|`configInLocalAppData` |DWORD |0 (default) to disable, 1 to enable |If enabled, stores the NVDA user configuration in the local application data instead of the roaming application data| +|`serviceDebug` |DWORD |0 (default) to disable, 1 to enable |If enabled, disables [Secure Mode](#SecureMode) on [secure screens](#SecureScreens). Due to several major security implications, the use of this option is strongly discouraged| +|`forceSecureMode` |DWORD |0 (default) to disable, 1 to enable |If enabled, forces [Secure Mode](#SecureMode) to be enabled when running NVDA.| + +## Further Information {#FurtherInformation} + +If you require further information or assistance regarding NVDA, please visit the [NVDA web site](NVDA_URL). +Here, you can find additional documentation, as well as technical support and community resources. +This site also provides information and resources concerning NVDA development. diff --git a/tests/markdownTranslate/fr_pretranslated_2024.2_userGuide.md b/tests/markdownTranslate/fr_pretranslated_2024.2_userGuide.md new file mode 100644 index 00000000000..7e1de5fe3c3 --- /dev/null +++ b/tests/markdownTranslate/fr_pretranslated_2024.2_userGuide.md @@ -0,0 +1,5022 @@ +# Guide de l'utilisateur de NVDA NVDA_VERSION + +[TOC] + + + + + +## Introduction {#Introduction} + +Bienvenue dans NVDA ! + +NonVisual Desktop Access (NVDA) est une revue d'écran gratuite et à source ouverte pour le système d'exploitation Microsoft Windows. +En donnant des informations via une voix synthétique et le braille, il permet aux personnes aveugles ou malvoyantes d'accéder à un ordinateur sans coût additionnel par rapport à une personne voyante. +NVDA est développé par [NV Access](https://www.nvaccess.org/), avec des contributions de la communauté. + +### Caractéristiques Générales {#GeneralFeatures} + +En restituant l'information par synthèse vocale ou en braille, NVDA permet aux personnes aveugles et malvoyantes d'utiliser le système d'exploitation Windows ainsi que beaucoup d'applications disponibles dans cet environnement. + +Une courte vidéo de démonstration en anglais, ["Qu'est-ce que NVDA ?"](https://www.youtube.com/watch?v=tCFyyqy9mqo) est disponible sur la chaîne Youtube de NV Access. + +Ses points forts sont : + +* La prise en charge d'applications grand-public telles que des navigateurs Web, clients e-mail, programmes de tchat sur Internet et suites bureautiques +* Un synthétiseur intégré prenant en charge plus de 80 langues +* L'annonce, quand c'est possible, d'informations de mise en forme du texte telles que le nom et la taille de la police, le style et les fautes d'orthographe +* L'annonce automatique du texte sous la souris et, en option, l'indication sonore de la position de la souris +* La prise en charge de nombreux afficheurs braille, incluant la capacité de détecter automatiquement beaucoup d'entre eux ainsi que la saisie pour les afficheurs disposant d'un clavier braille +* La possibilité de s'exécuter entièrement depuis une clé USB ou tout autre média portable sans avoir à installer +* Un installateur parlant facile à utiliser +* Une traduction dans 54 langues +* La prise en charge des environnements Windows modernes, incluant les versions 32 et 64 bits +* L'accès à l'écran de connexion à Windows et aux [autres écrans sécurisés](#SecureScreens). +* L'annonce des contrôles et du texte durant l'utilisation de gestes tactiles +* Le support des interfaces d'accessibilité communes telles que Microsoft Active Accessibility, Java Access Bridge, IAccessible2 et UI Automation +* Le support de l'invite de commandes Windows et des applications en mode console +* La possibilité de mettre en évidence le focus système + +### Configuration Système Requise {#SystemRequirements} + +* Systèmes d'Exploitation : toutes les éditions 32-bit et 64-bit de Windows 8.1, Windows 10, Windows 11, et toutes les versions serveur à partir de Windows Server 2012 R2. + * les variantes AMD64 et ARM64 de Windows sont prises en charge. +* au moins 150 Mo d'espace de stockage. + +### Internationalisation {#Internationalization} + +Il est important que chacun, partout dans le monde, quelle que soit sa langue, ait le même accès aux technologies. +Outre l'anglais, NVDA a été traduit en 52 langues : l'afrikaans, l'albanais, l'amharique, l'arabe, l'aragonais, le portugais (Brésil et Portugal), le bulgare, le birman, le catalan, l'espagnol (Colombie et Espagne), le croate, le tchèque, le danois, le néerlandais, le persan, le finnois, le français, le galicien, le Géorgien, l'allemand (Allemagne et Suisse), le grec, l'hébreu, l'hindi, le hongrois, l'islandais, l'irlandais, l'italien, le japonais, le kannada, le coréen, le kirghize, le lituanien, le macédonien, le Mongol, le népalais, le norvégien, le polonais, le portugais, le punjabi, le roumain, le russe, le serbe, le slovaque, le slovène, l'espagnol, le suédois, le tamoul, le thaï, le chinois traditionnel et simplifié, le turc, l'ukrainien et le vietnamien. + +### Support des Synthèses Vocales {#SpeechSynthesizerSupport} + +En plus de proposer ses messages et son interface en plusieurs langues, NVDA permet également à l'utilisateur de lire les contenus dans n'importe quelle langue, dans la mesure où il possède un synthétiseur parlant cette langue. + +NVDA est fourni avec [eSpeak NG](https://github.com/espeak-ng/espeak-ng), un synthétiseur de parole gratuit, à source ouverte, multilingue. + +Pour des informations concernant les autres synthétiseurs de parole pris en charge par NVDA, reportez-vous à la section [Synthétiseurs de parole pris en charge](#SupportedSpeechSynths). + +### Support du Braille {#BrailleSupport} + +Pour les utilisateurs possédant un terminal braille, NVDA peut afficher ses informations en braille. +NVDA utilise le traducteur braille à source ouverte [LibLouis](https://liblouis.io/) pour générer des séquences braille à partir de texte. +La saisie braille en intégral ou abrégé via un clavier braille est également supportée. +De plus, NVDA détectera automatiquement beaucoup de terminaux braille par défaut. +Reportez-vous à la section [Terminaux braille pris en charge](#SupportedBrailleDisplays) pour les informations concernant les terminaux braille. + +NVDA propose de nombreux codes braille couvrant un grand ensemble de langues. Dans bien des cas, le braille intégral et abrégé sont disponibles. Pour les utilisateurs francophones, le braille français unifié est disponible en intégral et abrégé. + +### Licence et Copyright {#LicenseAndCopyright} + +NVDA est Copyright (C) NVDA_COPYRIGHT_YEARS NVDA contributors. + +NVDA est disponible sous la licence GNU General Public License Version 2), avec deux exceptions spéciales. +Les exceptions sont précisées dans le document de licence dans la section "Non-GPL Components in Plugins and Drivers" et "Microsoft Distributable Code". +NVDA inclut et utilise également des composants qui sont disponibles sous différentes licences libres et open source. +Vous avez le droit de distribuer ou modifier ce logiciel comme il vous plaît pourvu que vous distribuiez la licence avec le logiciel, et rendiez disponible l'intégralité du code source pour toute personne qui le veut. +Ceci s'applique aussi bien à la version originale qu'aux copies modifiées de ce logiciel, et aussi à tout travail dérivé. + +Pour plus de détails, vous pouvez [lire l'intégralité de la licence.](https://www.gnu.org/licenses/old-licenses/gpl-2.0.html) +Pour les détails concernant les exceptions, veuillez consulter le document de licence depuis le menu NVDA dans la section "Aide". + +## Guide de Démarrage Rapide de NVDA {#NVDAQuickStartGuide} + +Ce guide de démarrage rapide contient trois sections principales : téléchargement, configuration initiale et exécution de NVDA. +Celles-ci sont suivies d'informations sur l'ajustement des préférences, l'utilisation des extensions, la participation à la communauté et l'obtention d'aide. +Les informations contenues dans ce guide sont condensées à partir d'autres parties du Guide de l'utilisateur NVDA. +Veuillez vous reporter au Guide de l'utilisateur complet pour obtenir des informations plus détaillées sur chaque sujet. + +### Télécharger NVDA {#GettingAndSettingUpNVDA} + +NVDA est entièrement gratuit pour tout le monde. +Il ne nécessite pas de clé de licence ni d'abonnement coûteux à payer. +NVDA est mis à jour, en moyenne, quatre fois par an. +La dernière version de NVDA est toujours disponible à partir de la page "Télécharger" du [site Web de NV Access](NVDA_URL). + +NVDA fonctionne avec toutes les versions récentes de Microsoft Windows. +Vérifiez les [Configurations requises](#SystemRequirements) pour plus de détails. + +#### Étapes pour Télécharger NVDA {#StepsForDownloadingNVDA} + +Ces étapes supposent une certaine familiarité avec la navigation sur une page Web. + +* Ouvrez votre navigateur Web (appuyez sur la touche `Windows`, tapez le mot "internet" sans les guillemets et appuyez sur `entrer`) +* Chargez la page de téléchargement de NV Access (Appuyez sur `alt+d`, tapez l'adresse suivante et appuyez sur `entrée`): +https://www.nvaccess.org/download +* Activez le bouton "télécharger" +* Le navigateur peut ou non demander une action à effectuer après le téléchargement, puis lancer le téléchargement +* Selon le navigateur, le fichier peut s'exécuter automatiquement après son téléchargement +* Si le fichier doit être lancé manuellement, appuyez sur `alt+n` pour accéder à la zone de notification, puis sur `alt+r` pour exécuter le fichier (ou les étapes de votre navigateur) + +### Mise en place de NVDA {#SettingUpNVDA} + +Démarrer le fichier téléchargé exécutera une version temporaire de NVDA. +Il vous sera alors demandé si vous souhaitez installer NVDA, créer une copie portable ou simplement continuer à utiliser la copie temporaire. + +NVDA n'a pas besoin d'accéder à Internet pour s'exécuter ou s'installer une fois le lanceur téléchargé. +Si elle est disponible, une connexion Internet permet à NVDA de vérifier périodiquement les mises à jour. + +#### Étapes pour exécuter le lanceur téléchargé {#StepsForRunningTheDownloadLauncher} + +Le fichier d'installation est nommé "nvda_2022.1.exe" ou similaire. +L'année et la version changent entre les mises à jour pour refléter la version actuelle. + +1. Exécutez le fichier téléchargé. +Une musique est jouée pendant le chargement d'une copie temporaire de NVDA. +Une fois chargé, NVDA parlera tout au long du processus. +1. La fenêtre du Lanceur NVDA apparaît avec le contrat de licence. +Appuyez sur `flècheBas` pour lire le contrat de licence si vous le souhaitez. +1. Appuyez sur `tab` pour passer à la case "J'accepte", puis appuyez sur la `barre d'espace` pour la cocher. +1. Appuyez sur `tab` pour parcourir les options, puis appuyez sur `entrée` sur l'option souhaitée. + +Les options sont : + +* "Installer NVDA sur cet ordinateur" : C'est l'option principale que la plupart des utilisateurs souhaitent pour une utilisation facile de NVDA. +* "Créer une copie portable" : Cela permet à NVDA d'être copié dans n'importe quel dossier sans installation. +Ceci est utile sur les ordinateurs sans droits d'administrateur ou sur une clé USB à emporter avec vous. +Lorsque cette option est sélectionnée, NVDA parcourt les étapes pour créer une copie portable. +La principale chose que NVDA doit connaître est le dossier dans lequel configurer la copie portable. +* "Continuer l'exécution" : Cela permet de maintenir la copie temporaire de NVDA en cours d'exécution. +Ceci est utile pour tester les fonctionnalités d'une nouvelle version avant de l'installer. +Lorsque cette option est sélectionnée, la fenêtre du lanceur se ferme et la copie temporaire de NVDA continue de s'exécuter jusqu'à ce qu'elle soit fermée ou que le PC soit arrêté. +Notez que les modifications apportées aux paramètres ne sont pas enregistrées. +* "Quitter" : Cela ferme NVDA sans effectuer aucune action. + +Si vous prévoyez de toujours utiliser NVDA sur cet ordinateur, vous choisirez d'installer NVDA. +L'installation de NVDA permettra des fonctionnalités supplémentaires telles que le démarrage automatique après la connexion, la possibilité de lire l'écran de connexion Windows et [les écrans sécurisés](#SecureScreens). +Cela ne peut pas être fait avec des copies portables ou temporaires. +Pour plus de détails sur les limitations lors de l'exécution d'une copie portable ou temporaire de NVDA, veuillez consulter les [Restrictions relatives aux copies portables et temporaires](#PortableAndTemporaryCopyRestrictions). + +L'installation propose également de créer des raccourcis dans le menu Démarrer et sur le bureau, et permet à NVDA d'être démarré avec `contrôle+alt+n`. + +#### Étapes pour installer NVDA depuis le lanceur {#StepsForInstallingNVDAFromTheLauncher} + +Ces étapes décrivent les options de configuration les plus courantes. +Pour plus de détails sur les options disponibles, veuillez consulter [Options d'installation](#InstallingNVDA). + +1. Depuis le lanceur, assurez-vous que la case à cocher pour accepter la licence est cochée. +1. Appuyez sur `Tab` jusqu'au bouton "Installer NVDA sur cet ordinateur" et activez-le. +1. Ensuite, viennent des options pour utiliser NVDA lors de la connexion à Windows et pour créer un raccourci sur le bureau. +Celles-ci sont cochées par défaut. +Si vous le souhaitez, appuyez sur `tabulation` et `barre d'espace` pour modifier l'une de ces options, ou laissez-les par défaut. +1. Appuyez sur `entrée` pour continuer. +1. Un dialogue Windows "Contrôle de compte d'utilisateur (UAC)" apparaît et vous demande "Voulez-vous autoriser cette application à apporter des modifications à votre PC ?". +1. Appuyez sur `alt+o` pour accepter l'invite UAC. +1. Une barre de progression se remplit au fur et à mesure de l'installation de NVDA. +Au cours de ce processus, NVDA émet un bip de plus en plus aigu. +Ce processus est souvent rapide et peut ne pas être remarqué. +1. Un dialogue apparaît confirmant que l'installation de NVDA a réussi. +Le message demande d'"Appuyer sur OK pour démarrer la copie installée". +Appuyez sur `entrée` pour démarrer la copie installée. +1. Le dialogue "Bienvenue dans NVDA" apparaît et NVDA lit un message de bienvenue. +Le focus est mis sur le menu déroulant "Disposition du clavier". +Par défaut, la disposition du clavier "Ordinateur de bureau" utilise le pavé numérique pour certaines fonctions. +Si vous le souhaitez, appuyez sur `flècheBas` pour choisir la disposition du clavier "Ordinateur portable" afin de réaffecter les fonctions du pavé numérique à d'autres touches. +1. Appuyez sur `tab` pour passer à "Utiliser `verrouillage majuscule` comme touche de modification NVDA". +`Insert` est défini comme touche de modification NVDA par défaut. +Appuyez sur `barre d'espace` pour sélectionner `verrouillage majuscule` comme touche de modification alternative. +Notez que la disposition du clavier est définie séparément de la touche de modification NVDA. +La touche de modification NVDA et la disposition du clavier peuvent être modifiées ultérieurement à partir des paramètres du clavier. +1. Utilisez `tab` et `barre d'espace` pour ajuster les autres options sur cet écran. +Celles-ci définissent si NVDA doit démarrer automatiquement. +1. Appuyez sur `entrée` pour fermer le dialogue avec NVDA en cours d'exécution. + +### Exécuter NVDA {#RunningNVDA} + +Le guide de l'utilisateur complet de NVDA contient toutes les commandes NVDA, divisées en différentes sections pour référence. +Les tableaux de commandes sont également disponibles dans le "Résumé des Commandes". +Le module de formation NVDA "Basic Training for NVDA" (en anglais) étudie chaque commande plus en profondeur avec des activités étape par étape. +"Basic Training for NVDA" est disponible dans la [boutique NV Access](http://www.nvaccess.org/shop). + +Voici quelques commandes de base fréquemment utilisées. +Toutes les commandes sont configurables, ce sont donc les frappes par défaut pour ces fonctions. + +#### La Touche de Modification NVDA {#NVDAModifierKey} + +La touche de modification NVDA par défaut est soit `pavnumZéro`, (avec `verrouillage numérique` désactivé), soit la touche `insert`, près des touches `effacement`, `début` et `fin`. +La touche de modification NVDA peut également être définie sur la touche `verrouillage majuscule`. + +#### Aide à la Saisie {#InputHelp} + +Pour apprendre et pratiquer l'emplacement des touches, appuyez sur `NVDA+1` pour activer l'aide à la saisie. +En mode d'aide à la saisie, effectuer n'importe quel geste de saisie (comme appuyer sur une touche ou effectuer un geste tactile) signalera l'action et décrira ce qu'elle fait (le cas échéant). +Les commandes réelles ne s'exécuteront pas en mode d'aide à la saisie. + +#### Démarrer et Arrêter NVDA {#StartingAndStoppingNVDA} + +| Nom |Touche ordinateur de bureau |Touche ordinateur portable |Description| +|---|---|---|---| +|Démarrer NVDA |`contrôle+alt+n` |`contrôle+alt+n` |Démarre ou redémarre NVDA| +|Quitter NVDA |`NVDA+q`, puis `entrée` |`NVDA+q`, puis `entrée` |quitte NVDA| +|Interrompre ou relancer la parole |`majuscule` |`majuscule` |Interrompt instantanément la parole. Un nouvel appui reprendra la parole là où elle s'est arrêtée| +|Arrêt de la parole |`contrôle` |`contrôle` |Interrompt instantanément la parole| + +#### Lire du texte {#ReadingText} + +| Nom |Touche ordinateur de bureau |Touche ordinateur portable |Description| +|---|---|---|---| +|Dire tout |`NVDA+flècheBas` |`NVDA+a` |Commence à lire à partir de la position courante en la déplaçant au fur et à mesure| +|Lire la ligne courante |`NVDA+flècheHaut` |`NVDA+l` |Lit la ligne. Un double appui épelle la ligne. Un triple appui épelle la ligne en utilisant la description de caractères (Alpha, Bravo, Charlie, etc)| +|Lire la sélection |`NVDA+maj+flècheHaut` |`NVDA+maj+s` |Lit tout texte sélectionné. Un double appui épelle l'information. Un triple appui l'épelle en code international| +|Lire le texte du presse-papiers |`NVDA+c` |`NVDA+c` |Lit tout texte dans le presse-papiers. Un double appui épelle l'information. Un triple appui l'épelle en code international| + +#### Annoncer la position et autres informations {#ReportingLocation} + +| Nom |Touche ordinateur de bureau |Touche ordinateur portable |Description| +|---|---|---|---| +|Titre de la fenêtre |`NVDA+t` |`NVDA+t` |Annonce le titre de la fenêtre actuellement active. Un double appui épelle l'information. Un triple appui la copie dans le presse-papiers| +|Annoncer le focus |`NVDA+tab` |`NVDA+tab` |Annonce le contrôle actuellement en focus. Un double appui épelle l'information. Un triple appui l'épelle en code international| +|Lire la fenêtre |`NVDA+b` |`NVDA+b` |Lit entièrement la fenêtre courante (utile pour les dialogues)| +|Lire la barre d'état |`NVDA+fin` |`NVDA+maj+fin` |Annonce la barre d'état si NVDA en trouve une. Un double appui épelle l'information. Un triple appui la copie dans le presse-papiers| +|Lire l'heure |`NVDA+f12` |`NVDA+f12` |Un appui annonce l'heure courante, un double appui annonce la date. L'heure et la date sont annoncées dans le format spécifié dans les paramètres Windows pour l'horloge de la barre d'état système.| +|Annoncer la mise en forme du texte |`NVDA+f` |`NVDA+f` |Annonce la mise en forme du texte. Un double appui affiche l'information dans une fenêtre| +|Annoncer la destination du lien |`NVDA+k` |`NVDA+k` |Un appui annonce l'URL de destination du lien à la position courante du curseur ou du focus. Deux appuis l'affichent dans une fenêtre pour une revue plus attentive| + +#### Choisir les informations lues par NVDA {#ToggleWhichInformationNVDAReads} + +| Nom |Touche ordinateur de bureau |Touche ordinateur portable |Description| +|---|---|---|---| +|Dire les caractères tapés |`NVDA+2` |`NVDA+2` |Lorsqu'activé, NVDA annoncera tous les caractères que vous tapez sur le clavier.| +|Dire les mots tapés |`NVDA+3` |`NVDA+3` |Lorsqu'activé, NVDA annoncera les mots que vous tapez sur le clavier.| +|Dire les touches de commande |`NVDA+4` |`NVDA+4` |Lorsqu'activé, annoncera toutes les touches n'étant pas des caractères que vous taperez sur le clavier. Cela inclut les combinaisons de touches telles que contrôle plus une autre lettre.| +|Activer le suivi de la souris |`NVDA+m` |`NVDA+m` |Lorsqu'activé, NVDA annoncera le texte actuellement sous le pointeur souris, tandis que vous le déplacez sur l'écran. Cela vous permet de trouver les choses sur l'écran, en déplaçant physiquement la souris, plutôt que d'essayer de les trouver en utilisant la navigation par objet.| + +#### La boucle des paramètres synthétiseur {#TheSynthSettingsRing} + +| Nom |Touche ordinateur de bureau |Touche ordinateur portable |Description| +|---|---|---|---| +|Aller au paramètre synthétiseur suivant |`NVDA+contrôle+flècheDroit` |`NVDA+maj+contrôle+flècheDroit` |Va au paramètre vocal suivant disponible, retournant au premier après le dernier| +|Aller au paramètre synthétiseur précédent |`NVDA+contrôle+flècheGauche` |`NVDA+maj+contrôle+flècheGauche` |Va au paramètre vocal précédent disponible, retournant au dernier après le premier| +|Augmenter le paramètre synthétiseur courant |`NVDA+contrôle+flècheHaut` |`NVDA+maj+contrôle+flècheHaut` |Augmente le paramètre vocal sur lequel vous vous trouvez. Ex. augmente le débit, choisit la voix suivante, augmente le volume| +|Augmenter le paramètre courant dans la boucle des paramètres du synthétiseur d'un interval plus important |`NVDA+contrôle+pagePrec` |`NVDA+maj+contrôle+pagePrec` |Augmente d'un pas plus important la valeur du paramètre vocal courant sur lequel vous vous trouvez. Ex. lorsque vous êtes sur le paramètre du choix de la voix, avancer de 20 voix ; lorsque vous êtes sur un paramètres avec potentiomètre (débit, hauteur, etc.), la valeur sera incrémentée de 20%| +|Diminuer le paramètre synthétiseur courant |`NVDA+contrôle+flècheBas` |`NVDA+maj+contrôle+flècheBas` |diminue le paramètre vocal sur lequel vous vous trouvez. Ex. diminue le débit, choisit la voix précédente, diminue le volume| +|Diminuer le paramètre courant dans la boucle des paramètres du synthétiseur d'un interval plus important |`NVDA+contrôle+pageSuiv` |`NVDA+maj+contrôle+pageSuiv` |Diminue d'un pas plus important la valeur du paramètre vocal courant sur lequel vous vous trouvez. Ex. lorsque vous êtes sur le paramètre du choix de la voix, reculer de 20 voix ; lorsque vous êtes sur un paramètres avec potentiomètre (débit, hauteur, etc.), la valeur sera décrémentée de 20%| + +Il est également possible de sauter à la première ou à la dernière valeur du paramètre de synthétiseur courant en attribuant des gestes personnalisés dans la [boîte de dialogue Gestes de commandes](#InputGestures), sous la catégorie parole. +Par exemple, cela signifie que lorsque le débit est le paramètre courant, le débit sera modifié à 0 ou 100. +Lorsque vous êtes sur le paramètre voix, la première ou la dernière voix sera activée. + +#### Navigation sur le web {#WebNavigation} + +La liste complète des touches de navigation à lettre unique se trouve dans la section [Mode Navigation](#BrowseMode) du guide de l'utilisateur. + +| Commande |Frappe |Description| +|---|---|---| +|Titre |`h` |Aller au titre suivant| +|Titre de niveau 1, 2, ou 3 |`1`, `2`, `3` |Aller au titre suivant au niveau spécifié| +|Champ de formulaire |`f` |Aller au champ de formulaire suivant (zone d'édition, bouton, etc)| +|Lien |`k` |Aller au lien suivant| +|Région |`d` |Aller à la région suivante| +|Liste |`l` |Aller à la liste suivante| +|Tableau |`t` |Aller au tableau suivant| +|Revenir en arrière |`maj+lettre` |Pressez `maj` et n'importe laquelle des lettres ci-dessus pour aller à l'élément précédent de ce type| +|Liste des éléments |`NVDA+f7` |Liste différents types d'éléments, tels que liens et titres| + +### Préférences {#Preferences} + +La plupart des fonctions NVDA peuvent être activées ou modifiées via les paramètres NVDA. +Les paramètres et d'autres options sont disponibles via le menu de NVDA. +Pour ouvrir le menu de NVDA, appuyez sur `NVDA+n`. +Pour ouvrir directement le dialogue des paramètres généraux de NVDA, appuyez sur `NVDA+contrôle+g`. +De nombreux écrans de paramètres ont des touches pour les ouvrir directement, comme `NVDA+contrôle+s` pour le synthétiseur, ou `NVDA+contrôle+v` pour les autres options de parole. + +### Extensions {#Addons} +Les extension sont des programmes qui fournissent des fonctionnalités nouvelles ou modifiées pour NVDA. +Les extensions sont développées par la communauté NVDA ou par des sociétés externes et ne sont pas affiliés à NV Access. +Comme pour tout logiciel, il est important de faire confiance au développeur d'une extension avant de l’utiliser. +Veuillez consulter [Installation d'extensions](#AddonStoreInstalling) pour savoir comment vérifier les extensions avant l'installation. + +La première fois que l'Add-on Store est ouvert, NVDA affiche un avertissement concernant les extensions. +Les extensions ne sont pas approuvées par NV Access et peuvent avoir des fonctionnalités et un accès aux informations sans restriction. +Appuyez sur `espace` si vous avez lu l'avertissement et que vous n'avez pas besoin de le voir la prochaine fois. +Appuyez sur `tab` pour atteindre le bouton "OK", puis sur `Entrée` pour accepter l'avertissement et accéder à l'Add-on Store. +La section "[Extensions et Add-on Store](#AddonsManager)" du guide de l'utilisateur contient des informations sur chaque fonctionnalité de l'Add-on Store. + +L'Add-on Store est disponible dans le menu Outils. +Appuyez sur `NVDA+n` pour ouvrir le menu NVDA, puis sur `o` pour Outils, puis sur `s` pour Add-on Store. +Lorsque l'Add-on Store s'ouvre, il affiche "Extensions disponibles" si aucune extension n'est installée. +Lorsque des extensions sont déjà installées, l'Add-on Store s'ouvre sur l'onglet "Extensions installées". + +#### Extensions disponibles {#AvailableAddons} +Lorsque la fenêtre s'ouvre pour la première fois, le chargement des extensions peut prendre quelques secondes. +NVDA lira le nom de la première extension une fois que le chargement de la liste des extensions est terminé. +Les extensions disponibles sont listées par ordre alphabétique dans une liste à plusieurs colonnes. +Pour parcourir la liste et trouver une extension spécifique : + +1. Utilisez les touches fléchées ou appuyez sur la première lettre du nom d'une extension pour vous déplacer dans la liste. +1. Appuyez une fois sur `tab` pour passer à une description de l'extension actuellement sélectionné. +1. Utilisez les [touches de lecture](#ReadingText) ou les touches fléchées pour lire la description complète. +1. Appuyez sur `tab` pour atteindre le bouton "Actions", qui peut être utilisé pour installer l'extension entre autres actions. +1. Appuyez sur `tab` jusqu'au champ "Autres détails", qui répertorie des détails tels que l'éditeur, la version et la page web. +1. Pour revenir à la liste des extensions, appuyez sur `alt+e`, ou `maj+tab` jusqu'à atteindre la liste. + +#### Rechercher des extensions {#SearchingForAddons} +En plus de pouvoir parcourir toutes les extensions disponibles, il est possible de filtrer les extensions affichées. +Pour effectuer une recherche, appuyez sur `alt+r` pour accéder au champ "Recherche" et tapez le texte à rechercher. +La recherche vérifie les correspondances dans les champs ID, nom affiché, éditeur, auteur ou description de l'extension. +La liste se met à jour au cours de la saisie des termes de recherche. +Une fois la saisie terminée, appuyez sur `tab` pour accéder à la liste filtrée des extensions et parcourir les résultats. + +#### Installer des extensions {#InstallingAddons} + +Pour installer une extension : + +1. Lorsque le focus se trouve sur une extension que vous souhaitez installer, appuyez sur `entrée`. +1. Le menu d'actions s'ouvre avec une liste d'actions ; la première action est "Installer". +1. Pour installer l'extension, appuyez sur `i` ou `flècheBas` pour atteindre "Installer" et appuyez sur `entrée`. +1. Le focus revient sur l'extension dans la liste et NVDA lira les détails de cette extension. +1. L'information "État" annoncée par NVDA passent de "Disponible" à "Téléchargement en cours". +1. Une fois le téléchargement de l'extension terminé, elle passe à l'état "Téléchargé, en attente d'installation". +1. Répétez cette procédure pour toutes les extensions que vous souhaitez également installer. +1. Une fois que vous avez fini, appuyez sur `tab` jusqu'à ce que le focus soit sur le bouton "Fermer", puis appuyez sur `entrée`. +1. Les extensions téléchargées démarreront leur processus d'installation dès la fermeture de l'Add-on Store. +Pendant le processus d'installation, les extensions peuvent afficher des boîtes de dialogue auxquelles vous devrez répondre. +1. Une fois que les extensions sont installées, une boîte de dialogue apparaît vous informant que des modifications ont été apportées et vous devez redémarrer NVDA pour que l'installation des extensions soit terminée. +1. Appuyez sur `entrée` pour redémarrer NVDA. + +#### Gérer les extensions {#ManagingInstalledAddons} +Appuyez sur `contrôle+tab` pour vous déplacer entre les onglets de l'Add-on Store. +Les onglets sont : "Extensions installées", "Mises à jour", "Extensions disponibles" et "Extensions incompatibles installés". +Chacun des onglets est présenté de manière similaire, sous la forme d'une liste d'extensions, d'un panneau pour plus de détails sur l'extension sélectionné et d'un bouton pour effectuer des actions pour l'extension sélectionnée. +Le menu d'actions des extensions installés comprend les actions "Désactiver" et "Supprimer" au lieu de "Installer". +La désactivation d'une extension empêche NVDA de la charger, mais la garde installée. +Pour réactiver une extension désactivée, appuyez sur "Activer" dans le menu actions. +Après avoir activé, désactivé ou supprimé des extensions, vous serez invité à redémarrer NVDA lors de la fermeture de l'Add-on Store. +Ces modifications ne prendront effet qu'une fois NVDA redémarré. +Veuillez noter que dans la fenêtre de l'Add-on Store, `échap` fonctionne de la même manière que le bouton Fermer. + +#### Mettre à jour des extensions {#UpdatingAddons} +Lorsqu'une mise à jour pour une extension que vous avez installée est disponible, elle sera listée dans l'onglet "Mises à jour". +Appuyez sur `contrôle+tab` pour accéder à cet onglet depuis n'importe où dans l'Add-on Store. +L'état de l'extension sera "Mise à jour disponible". +La liste indiquera la version actuellement installée et la version disponible. +Appuyez sur `entrée` sur l'extension pour ouvrir la liste d'actions ; choisissez "Mettre à jour". + +### Communauté {#Community} + +NVDA a une communauté d'utilisateurs dynamique. +Il existe une [liste de diffusion principale en anglais](https://nvda.groups.io/g/nvda) et une page complète de [groupes de langues locales](https://github.com/nvaccess/nvda-community/wiki/Connect) . +NV Access, développeur de NVDA, est actif sur Twitter [Twitter](https://twitter.com/nvaccess) et [Facebook](https://www.facebook.com/NVAccess). +NV Access a également un [blog In-Process](https://www.nvaccess.org/category/in-process/) régulier. + +Il existe également un programme [NVDA Certified Expert](https://certification.nvaccess.org/). +Il s'agit d'un examen en ligne que vous pouvez passer pour démontrer vos compétences dans NVDA. +[Les experts certifiés NVDA](https://certification.nvaccess.org/) peuvent répertorier leurs coordonnées et les détails commerciaux pertinents. + +### Obtenir de l'aide {#GettingHelp} + +Pour obtenir de l'aide sur NVDA, appuyez sur `NVDA+n` pour ouvrir le menu, puis sur `h` pour obtenir de l'aide. +À partir de ce sous-menu, vous pouvez accéder au Guide de l'utilisateur, à une référence rapide des commandes, à l'historique des nouvelles fonctionnalités et bien plus encore. +Ces trois premières options s'ouvrent dans le navigateur Web par défaut. +Il existe également du matériel de formation plus complet (en anglais) disponible dans la [Boutique NV Access](https://www.nvaccess.org/shop). + +Nous vous recommandons de commencer par le module "Formation de base pour NVDA". +Ce module couvre les concepts allant de la mise en route à la navigation sur le Web et à l'utilisation de la navigation par objet. +Il est disponible en : + +* [Texte électronique](https://www.nvaccess.org/product/basic-training-for-nvda-ebook/), qui inclut les formats Word DOCX, page Web HTML, eBook ePub et Kindle KFX. +* [Lecture vocale (voix humaine), audio mp3](https://www.nvaccess.org/product/basic-training-for-nvda-downloadable-audio/) +* [Version papier Braille UEB](https://www.nvaccess.org/product/basic-training-for-nvda-braille-hard-copy/) avec livraison incluse partout dans le monde. + +D'autres modules, et le [Pack de productivité NVDA](https://www.nvaccess.org/product/nvda-productivity-bundle/) à prix réduit, sont disponibles dans la [Boutique NV Access](https://www.nvaccess.org/shop/). + +NV Access vend également une [assistance téléphonique](https://www.nvaccess.org/product/nvda-telephone-support/), soit en blocs, soit dans le cadre du [Pack de Productivité NVDA](https://www.nvaccess.org/product/nvda-productivity-bundle/). +L'assistance téléphonique est disponible pour les numéros situés en Australie et aux États-Unis. + +Les [groupes d'utilisateurs par e-mail](https://github.com/nvaccess/nvda/wiki/Connect) sont une excellente source d'aide communautaire, tout comme les [experts NVDA certifiés](https://certification.nvaccess.org/). + +Vous pouvez créer des rapports de bogues ou des demandes de fonctionnalités via [GitHub](https://github.com/nvaccess/nvda/blob/master/projectDocs/issues/readme.md). +Les [contribution guidelines](https://github.com/nvaccess/nvda/blob/master/.github/CONTRIBUTING.md) (en anglais) contiennent des informations précieuses pour contribuer à la communauté. + +## Plus d'Options de Configuration {#MoreSetupOptions} +### Options d'Installation {#InstallingNVDA} + +Si vous installez NVDA directement depuis le lanceur NVDA téléchargé, appuyez sur le bouton Installer NVDA. +Si vous avez déjà fermé ce dialogue ou souhaitez installer à partir d'une copie portable, veuillez choisir l'élément de menu Installer NVDA qui se trouve sous Outils dans le menu NVDA. + +Le dialogue d'installation qui apparaît demandera de confirmer si vous souhaitez installer NVDA et vous indiquera également si cette installation mettra à jour une installation précédente. +Appuyez sur le bouton Continuer pour lancer l'installation de NVDA. +Il y a aussi quelques options dans ce dialogue qui sont expliquées ci-dessous. +Une fois l'installation terminée, un message apparaîtra vous indiquant qu'elle a réussi. +Appuyer sur OK à ce stade redémarrera la copie nouvellement installée de NVDA. + +#### Avertissement d'extensions incompatibles {#InstallWithIncompatibleAddons} + +Si vous avez déjà installé des extensions, il peut également y avoir un avertissement indiquant que les extensions incompatibles seront désactivées. +Avant de pouvoir presser le bouton Continuer, vous devrez utiliser la case à cocher pour confirmer que vous comprenez que ces extensions seront désactivées. +Il y aura également un bouton pour lister les extensions qui seront désactivées. +Veuillez consulter la section [dialogue des extensions incompatibles](#incompatibleAddonsManager) pour plus d'aide concernant ce bouton. +Après l'installation, vous pouvez réactiver les extensions incompatibles à vos risques et périls à partir de l'[Add-on Store](#AddonsManager). + +#### Utiliser NVDA lors de la connexion {#StartAtWindowsLogon} + +Cette option vous permet de choisir si NVDA doit ou non démarrer automatiquement lorsque vous êtes sur l'écran de connexion Windows, avant que vous ayez entré un mot de passe. +Cela inclut également le contrôle de compte d'utilisateur et [autres écrans sécurisés](#SecureScreens). +Cette option est activée par défaut pour les nouvelles installations. + +#### Créer un raccourci sur le bureau (ctrl+alt+n) {#CreateDesktopShortcut} + +Cette option vous permet de choisir si NVDA doit ou non créer un raccourci sur le bureau pour démarrer NVDA. +S'il est créé, ce raccourci se verra également attribuer une touche de raccourci `contrôle+alt+n`, vous permettant de démarrer NVDA à tout moment avec cette touche. + +#### Copier la configuration portable sur le compte d'utilisateur actuel {#CopyPortableConfigurationToCurrentUserAccount} + +Cette option vous permet de choisir si NVDA doit ou non copier la configuration utilisateur de NVDA en cours d'exécution dans la configuration de l'utilisateur actuellement connecté, pour la copie installée de NVDA. +Cela ne copiera pas la configuration pour les autres utilisateurs de ce système ni dans la configuration du système à utiliser lors de la connexion à Windows et [autres écrans sécurisés](#SecureScreens). +Cette option n'est disponible que lors de l'installation à partir d'une copie portable, et non lors de l'installation directement à partir du Lanceur téléchargé. + +### Création d'une copie portable {#CreatingAPortableCopy} + +Si vous créez une copie portable directement à partir du package de téléchargement NVDA, appuyez sur le bouton Créer une copie portable. +Si vous avez déjà fermé ce dialogue ou si vous exécutez une copie installée de NVDA, choisissez l'élément de menu Créer une copie portable qui se trouve sous Outils dans le menu NVDA. + +Le dialogue qui apparaît vous permet de choisir où la copie portable doit être créée. +Il peut s'agir d'un répertoire sur votre disque dur ou d'un emplacement sur une clé USB ou un autre support portable. +Il existe également une option pour choisir si NVDA doit copier la configuration NVDA actuelle de l'utilisateur connecté pour l'utiliser avec la copie portable nouvellement créée. +Cette option n'est disponible que lors de la création d'une copie portable à partir d'une copie installée, pas lors de la création à partir du package de téléchargement. +Appuyer sur Continuer créera la copie portable. +Une fois la création terminée, un message apparaîtra vous indiquant qu'elle a réussi. +Appuyez sur OK pour fermer ce dialogue. + +### Restrictions des Versions Portables et Temporaires {#PortableAndTemporaryCopyRestrictions} + +Si vous souhaitez emporter NVDA avec vous sur une clé USB ou un autre support inscriptible, vous devez choisir de créer une copie portable. +La copie installée est également capable de créer une copie portable d'elle-même à tout moment. +La copie portable a également la capacité de s'installer sur n'importe quel ordinateur ultérieurement. +Cependant, si vous souhaitez copier NVDA sur un support en lecture seule tel qu'un CD, vous devez simplement copier le package de téléchargement. +L'exécution de la version portable directement à partir d'un support en lecture seule n'est pas prise en charge pour le moment. + +Le [programme d'installation de NVDA](#StepsForRunningTheDownloadLauncher) peut être utilisé comme une copie temporaire de NVDA. +Les copies temporaires empêchent l'enregistrement des paramètres de NVDA. +Cela inclut la désactivation de l'utilisation de l'[Add-on Store](#AddonsManager). + +Les copies portables et temporaires de NVDA ont les restrictions suivantes : + +* L'impossibilité de démarrer automatiquement pendant et/ou après la connexion. +* L'impossibilité d'interagir avec les applications démarrées avec les privilèges administrateur, sauf bien sûr si NVDA a été démarré avec ces privilèges (non recommandé) ; +* L'impossibilité de lire les écrans de contrôle de compte utilisateur (UAC) lorsque l'on tente de démarrer une application avec les privilèges administrateur ; +* L'impossibilité d'utiliser un écran tactile comme support d'entrée ; +* L'impossibilité de prendre en charge des fonctionnalités comme le mode navigation ou l'annonce des caractères saisis dans les applications du Windows Store. +* L'atténuation audio n'est pas supportée. + +## Prendre en Main NVDA {#GettingStartedWithNVDA} +### Démarrer NVDA {#LaunchingNVDA} + +Si NVDA a été installé à l'aide de l'installateur, alors il suffit, soit de frapper la combinaison contrôle+alt+n, soit de choisir dans le menu Démarrer / Programmes / NVDA / NVDA. +De plus, Vous pouvez taper NVDA dans le dialogue "Exécuter" puis appuyer sur "Entrée". +Si NVDA est déjà en cours d'exécution, il sera redémarré. +Vous pouvez aussi ajouter quelques [options de ligne de commande](#CommandLineOptions) vous permettant de quitter (-q), désactiver les extensions (--disable-addons), etc. + +Pour les copies installées, NVDA enregistre la configuration dans le dossier de données applicatives roaming de l'utilisateur courant par défaut (ex : "`C:\Users\\AppData\Roaming`"). +Il est possible de modifier cela de manière à ce que NVDA charge sa configuration depuis le dossier de données applicatives local. +Consultez la section concernant les [paramètres système](#SystemWideParameters) pour plus de détails. + +Pour démarrer la copie portable, rendez-vous dans le dossier où NVDA a été décompressé, et appuyez sur "Entrée" ou double-cliquez sur nvda.exe. +Si NVDA est déjà en cours d'exécution, il s'arrêtera pour démarrer la version portable. + +Au démarrage de NVDA, on entend d'abord une série de sons ascendants (indiquant que NVDA se charge). +Suivant la rapidité de votre ordinateur, ou si vous exécutez NVDA à partir d'une clé USB ou d'un autre périphérique lent, le démarrage peut demander un certain temps. +Si le démarrage est vraiment lent, vous entendrez le message "Chargement de NVDA, veuillez patienter...". + +Si vous n'entendez rien de tout cela, ou si vous entendez le signal sonore d'erreur de Windows, ou une série de sons descendants, cela indique un problème de NVDA et vous pourrez, si vous le voulez, envoyer un rapport d'erreur aux développeurs. +Reportez-vous au site Web de NVDA pour les détails de la procédure. + +#### Dialogue de Bienvenue {#WelcomeDialog} + +Quand NVDA démarre pour la première fois, vous êtes accueilli par un dialogue vous donnant des informations de base sur la touche NVDA et le menu NVDA. +Veuillez consulter les sections ci-après pour plus d'informations sur ces sujets. +Le dialogue contient également une liste déroulante et trois cases à cocher. +La liste déroulante vous permet de sélectionner la configuration clavier. +La première case à cocher vous permet de choisir si vous voulez utiliser la touche de verrouillage majuscules comme touche NVDA. +La deuxième spécifie si NVDA doit démarrer à l'ouverture de votre session et est disponible uniquement sur la version installée. +La troisième permet d'indiquer si ce dialogue d'accueil doit apparaître à chaque démarrage. + +#### Dialogue de statistiques d'utilisation des données {#UsageStatsDialog} + +Depuis NVDA 2018.3, il est demandé à l'utilisateur s'il veut autoriser l'envoi de données d'utilisation à NV Access afin d'aider à l'amélioration de NVDA à l'avenir. +Au premier démarrage de NVDA, un dialogue vous demandant si vous désirer envoyer des données à NV Access durant l'utilisation de NVDA apparaîtra. +Vous pouvez obtenir plus d'informations concernant les données recueillies par NV Access dans la section paramètres généraux, [Autoriser NV Access à recueillir des statistiques d'utilisation](#GeneralSettingsGatherUsageStats). +Note : l'appui sur "oui" ou "non" sauvegardera ce choix et ce dialogue n'apparaîtra plus à moins que vous réinstalliez NVDA. +Cependant, vous pouvez activer ou désactiver le processus de collecte de données manuellement dans l'écran de paramètres généraux de NVDA. Pour modifier ce paramètre manuellement, vous pouvez cocher ou décocher la case appelée [Autoriser le projet NVDA à recueillir des statistiques d'utilisation](#GeneralSettingsGatherUsageStats). + +### À Propos des Commandes Clavier de NVDA {#AboutNVDAKeyboardCommands} +#### La Touche NVDA {#TheNVDAModifierKey} + +La plupart des commandes spécifiques de NVDA se font en appuyant sur la touche NVDA en conjonction avec une ou plusieurs autres touches. +Les fonctions de revue de texte qui n'utilisent que le pavé numérique constituent une des quelques exceptions. + +NVDA peut être configuré pour que les touches "Insert" du pavé numérique, "Insert" du clavier étendu ou verrouillage majuscules puissent être utilisées comme touche NVDA. +Par défaut, les touches "Insert" du pavé numérique et du clavier étendu sont définies comme touche NVDA. + +Si vous souhaitez que l'une des touches NVDA se comporte comme d'habitude, comme si NVDA n'était pas en cours d'exécution (par exemple si vous voulez utiliser verrouillage majuscules pour verrouiller les majuscules après l'avoir définie comme touche NVDA) vous devrez appuyer deux fois rapidement sur la touche. + +#### Les Configurations Clavier {#KeyboardLayouts} + +NVDA comporte actuellement deux configurations clavier : une pour les ordinateurs de bureau (Desktop) et une pour les ordinateurs portables (Laptop). +Par défaut, NVDA est configuré pour un ordinateur de bureau. Pour passer en configuration ordinateur portable, allez dans la catégorie Clavier du dialogue [Paramètres](#NVDASettings) qui se trouve dans le menu Préférences de NVDA. + +La configuration pour ordinateur de bureau fait un usage intensif du pavé numérique (avec le verrouillage numérique désactivé). +Bien que la plupart des ordinateurs portables ne comportent pas de pavé numérique, certains peuvent l'émuler en maintenant enfoncée la touche "FN" puis en appuyant sur les lettres et les chiffres à la droite du clavier ( 7 8 9 u i o j k l etc.). +Si votre ordinateur portable ne peut pas le faire ou ne vous permet pas de désactiver le verrouillage numérique, vous pourrez alors basculer vers la disposition Ordinateur Portable. + +### Gestes Tactiles de NVDA {#NVDATouchGestures} + +Si vous utilisez NVDA sur un système possédant un écran tactile, vous pouvez aussi contrôler NVDA directement via l'écran tactile. +Tant que NVDA est actif, à moins que le support de l'interaction tactile soit désactivée, toutes les manipulations sur l'écran tactile vont directement à NVDA. +Ainsi, toutes les actions qui peuvent être faites normalement sans NVDA ne fonctionneront pas. + +Pour activer/désactiver le support d'interaction tactile, pressez NVDA+contrôle+alt+t. + +Vous pouvez aussi activer ou désactiver le [support d'interaction tactile](#TouchSupportEnable) depuis la catégorie Interaction Tactile des paramètres de NVDA. + +#### Explorer l'Écran {#ExploringTheScreen} + +L'action la plus basique que vous pouvez effectuer avec l'écran tactile est d'obtenir l'annonce du texte ou de l'élément à n'importe quel point de l'écran. +Pour ce faire, placez un doigt n'importe où sur l'écran. +Vous pouvez également garder votre doigt sur l'écran et le déplacer pour lire les autres éléments et textes sur lesquels votre doigt se place. + +#### Gestes Tactiles {#TouchGestures} + +Lorsque les commandes NVDA sont décrites dans ce guide utilisateur, elles peuvent comporter un geste tactile qui peut être utilisé pour activer cette commande avec l'écran tactile. +Voici quelques instructions sur la manière d'effectuer les différents gestes tactiles. + +##### Tapes {#Taps} + +Tapoter rapidement sur l'écran avec un ou plusieurs doigts. + +Tapoter une fois avec un seul doigt s'appelle une simple tape. +Tapoter une fois avec deux doigts s'appelle une tape à deux doigts et ainsi de suite. + +Si la même tape est faite une fois ou plus dans une succession rapide, NVDA la prendra comme un geste tactile multi-tape. +Tapoter deux fois sera une double-tape. +Tapoter trois fois sera une triple-tape et ainsi de suite. +Bien sûr, ces gestes à tapes multiples reconnaissent combien de doigts sont utilisés, il est donc possible d'avoir des gestes tel qu'une triple-tape à deux doigts, ou une tape à quatre doigts, etc. + +##### Glisser {#Flicks} + +Glissez rapidement votre doigt sur l'écran. + +On peut glisser dans les quatre directions : glissé gauche, glissé droite, glissé bas, glissé haut. + +Exactement comme pour les tapes, il est possible d'utiliser plusieurs doigts. +Il est donc possible d'avoir un glissé à deux doigts vers le haut ou trois vers la droite. + +#### Modes Tactiles {#TouchModes} + +Comme il y a plus de commandes NVDA que de gestes tactiles possibles, NVDA a plusieurs modes tactiles entre lesquels on peut basculer, qui rendent un certain nombre de commandes disponibles. +Les deux modes sont le mode texte et le mode objet. +Certaines commandes listées dans ce manuel peuvent avoir un mode indiqué entre parenthèses après le geste. +Par exemple, glissé haut (mode texte) signifie que cette commande sera exécutée si vous glissez vers le haut, mais seulement en mode texte. +Si la commande n'a aucun mode associé, le geste fonctionnera dans tous les modes. + + +Pour basculer entre les modes, faites une tape avec trois doigts. + + +#### Clavier Tactile {#TouchKeyboard} + +Le clavier tactile sert à entrer du texte et des commandes à partir d'un écran tactile. +Quand le focus est sur un champ de saisie, vous pouvez faire apparaître le clavier tactile d'une double-tape sur l'icône du clavier tactile au bas de l'écran. +Sur les tablettes comme la Microsoft Surface Pro, le clavier tactile est toujours disponible quand le clavier est déconnecté +Pour masquer le clavier tactile, faites une double-tape sur son icône ou quittez la zone de saisie. + +Quand le clavier tactile est activé, pour repérer une touche, placez vos doigts à l'endroit où se situe le clavier tactile (généralement au bas de l'écran), puis déplacez-vous sur le clavier avec un doigt. +Quand vous avez trouvé la touche que vous voulez presser, double-tapez la touche ou retirez votre doigt, selon les options définies dans la catégorie [Paramètres d'Interaction Tactile](#TouchInteraction)des Paramètres NVDA. + +### Aide des Commandes {#InputHelpMode} + +Des commandes clavier et tactiles sont mentionnées tout au long de ce guide utilisateur, mais une manière simple d'explorer les différentes touches de commandes est d'activer l'aide clavier. + +Pour activer l'aide clavier, appuyez sur NVDA+1. +Pour la désactiver, appuyez à nouveau sur NVDA+1. +Quand l'aide clavier est activée, l'appui sur une touche braille ou clavier, ou faire un geste à l'écran tactile annonce sa fonction (si elle en a une). +La fonction n'est pas réellement exécutée, vous pouvez donc appuyer sur n'importe quelle touche sans crainte. + +### Le Menu NVDA {#TheNVDAMenu} + +Le menu NVDA vous permet de gérer les paramètres de NVDA, d'obtenir de l'aide, sauvegarder ou recharger la configuration, modifier le dictionnaire de prononciation, accéder à des outils additionnels ou quitter NVDA. + +Pour accéder au menu NVDA depuis n'importe où dans Windows pendant que NVDA est en cours d'exécution, vous pouvez effectuer l'une des actions suivantes : + +* appuyez sur `NVDA+n` sur le clavier. +* Effectuez une double-tape à 2 doigts sur l'écran tactile. +* Accédez à la barre d'état système en appuyant sur `Windows+b`, `flècheBas` jusqu'à l'icône NVDA, et appuyez sur `entrée`. +* Alternativement, accédez à la barre d'état système en appuyant sur `Windows+b`, `flècheBas` jusqu'à l'icône NVDA, et ouvrez le menu contextuel en appuyant sur la touche `applications` située à côté de la touche de contrôle droite sur la plupart des claviers. +Sur un clavier sans touche `applications`, appuyez sur `maj+f10` à la place. +* Faites un clic droit sur l'icône NVDA située dans la barre d'état système de Windows + +Lorsque le menu apparaît, vous pouvez utiliser les touches fléchées pour naviguer dans le menu et la touche `entrée` pour activer un élément. + +### Commandes de Base {#BasicNVDACommands} + + + +| Nom |Ordinateur de bureau |Ordinateur portable |Tactile |Description| +|---|---|---|---|---| +|Démarrer ou redémarrer NVDA |Contrôle+alt+n |Contrôle+alt+n |aucun |Démarre ou redémarre NVDA depuis le bureau, si ce raccourci Windows est activé durant le processus d'installation de NVDA. Ceci est un raccourci spécifique à Windows et de ce fait il ne peut être réassigné dans le dialogue gestes de commandes.| +|Arrêt parole |Contrôle |Contrôle |tape 2 doigts |Arrêt instantané de la parole| +|Pause parole |Maj |Maj |Aucun |Pause instantanée de la parole, un second appui reprend la parole là où elle s'était arrêtée| +|Menu NVDA |NVDA+n |NVDA+n |Double-tape 2 doigts |Affiche le menu NVDA pour vous permettre d'accéder aux préférences, outils, aide etc.| +|Passage en mode aide à la saisie |NVDA+1 |NVDA+1 |Aucun |Dans ce mode, l'appui sur n'importe quelle touche donnera son nom et la description de la commande NVDA qui lui est éventuellement associée| +|Quitter NVDA |NVDA+q |NVDA+q |Aucun |Quitter NVDA| +|Ignorer la touche suivante |NVDA+f2 |NVDA+f2 |Aucun |Indique à NVDA de passer la touche suivante directement à l'application - même si cette touche correspond normalement à une commande NVDA| +|Bascule du mode veille |NVDA+maj+s |NVDA+maj+z |Aucun |Le mode veille désactive toutes les commandes NVDA ainsi que la parole et le braille pour l'application en cours. Ceci est utile dans les applications fournissant leur propre système de revue d'écran. Appuyez à nouveau la combinaison pour désactiver le mode veille.| + + + +### Annonce des Informations système {#ReportingSystemInformation} + + + +| Nom |Touche |Description| +|---|---|---| +|Annoncer date/heure |NVDA+f12 |Un appui annonce l'heure, deux appuis annoncent la date| +|Annoncer l'état de la batterie |NVDA+maj+b |Annonce le pourcentage de charge de la batterie ou si l'adaptateur secteur est connectée| +|Annoncer le contenu du presse-papiers |NVDA+c |Lit le contenu du presse-papier s'il y a lieu| + + + +### Mode de parole {#SpeechModes} + +Le mode de parole détermine la façon dont le contenu de l'écran, les notifications, les réponses aux commandes et autres sorties sont prononcés pendant le fonctionnement de NVDA. +Le mode par défaut est "activée", où la parole est utilisée dans les situations attendues lors de l'utilisation d'un lecteur d'écran. +Cependant, dans certaines circonstances, ou lors de l'exécution de programmes particuliers, l'un des autres modes de parole peut s'avérer utile. + +Les quatre modes de parole disponibles sont : + +* Activée (par défaut) : NVDA parlera normalement en réaction aux changements d'écran, aux notifications et aux actions telles que déplacer le focus ou émettre des commandes. +* À la demande : NVDA ne parlera que lorsque vous utilisez des commandes avec une fonction d'annonce (par exemple annoncer le titre de la fenêtre) ; mais il ne parlera pas en réaction à des actions telles que le déplacement du focus ou du curseur. +* Désactivée : NVDA ne dira rien, mais contrairement au mode veille, il réagira silencieusement aux commandes. +* remplacée par des bips : NVDA remplacera la parole normale par des bips courts. + +Le mode bips peut être utile lorsqu'une sortie très importante défile dans une fenêtre de terminal, mais vous ne vous souciez pas de ce que c'est, seulement du fait qu'elle continue à défiler ; ou dans d’autres circonstances où le fait qu’il y ait une sortie est plus pertinent que la production elle-même. + +Le mode À la demande peut s'avérer utile lorsque vous n'avez pas besoin d'un retour constant sur ce qui se passe à l'écran ou sur l'ordinateur, mais que vous devez périodiquement vérifier des éléments particuliers à l'aide de commandes de revue, etc. +Les exemples incluent lors d'un enregistrement audio, lors de l'utilisation d'un agrandissement de l'écran, lors d'une réunion ou d'un appel, ou comme alternative au mode bips. + +Un geste permet de parcourir les différents modes de parole : + + +| Nom |Touche |Description| +|---|---|---| +|Faire défiler les modes de parole |`NVDA+s` |Passer d’un mode vocal à l’autre| + + + +Si vous avez seulement besoin de basculer entre un sous-ensemble limité de modes de parole, voir [Modes disponibles dans la commande Faire défiler les modes de parole](#SpeechModesDisabling) pour savoir comment désactiver les modes non souhaités. + +## Naviguer avec NVDA {#NavigatingWithNVDA} + +NVDA vous permet de naviguer dans le système ou de l'explorer de différentes manières, soit en interaction normale, soit en revue. + +### Objets {#Objects} + +Chaque application et le système d'exploitation lui-même se composent d'un grand nombre d'objets. +Un objet est un élément simple tel qu'un morceau de texte, un bouton, une case à cocher, un potentiomètre, une liste ou une zone d'édition. + +### Naviguer avec le Focus Système {#SystemFocus} + +Le focus système, ou plus simplement focus, est [l'objet](#Objects) qui reçoit les touches tapées au clavier. +Par exemple, si vous tapez du texte dans une zone d'édition, cette zone d'édition a le focus. + +La manière la plus commune de naviguer dans Windows avec NVDA, est de simplement se déplacer avec des commandes clavier normales, comme "Tabulation" et "Majuscule+Tabulation" pour se déplacer entre les contrôles, "Alt" pour aller au menu puis "Flèches" pour naviguer dans les menus, utiliser "Alt+Tabulation" pour passer d'une application à l'autre. Cela déplace le focus système, c'est-à-dire l'objet qui reçoit les touches que vous tapez au clavier. +Quand vous faites cela, NVDA donne des informations sur l'objet ayant le focus, telles que son nom, son type, son état, sa valeur, sa description, son raccourci clavier et sa position. +Quand la [Mise en Évidence Visuelle](#VisionFocusHighlight) est activée, la position du focus système courant est également présentée visuellement. + +Quelques touches de commandes utiles pour naviguer avec le focus : + + +| Nom |Ordinateur de bureau |Ordinateur portable |Description| +|---|---|---|---| +|Annonce du focus courant |NVDA+tab |NVDA+tab |Annonce l'objet en cours ou le contrôle qui a le focus système. Un double appui épelle l'information| +|Annonce du titre |NVDA+t |NVDA+t |Annonce le titre de la fenêtre active. Un double appui épelle l'information, un triple appui la copie dans le presse-papiers| +|Lecture de la fenêtre active |NVDA+b |NVDA+b |lit tous les contrôles de la fenêtre active (utile pour les dialogues)| +|Annonce de la barre d'état |NVDA+fin |NVDA+maj+fin |Lit la barre d'état si NVDA en trouve une. Un double appui épelle l'information. Un triple appui la copie dans le presse-papiers| +|Annoncer le Raccourci Clavier |`maj+pavnum2` |`NVDA+contrôle+maj+point-virgule` |Annonce le raccourci clavier (accélérateur) de l'objet actuellement en focus| + + + +### Naviguer avec le Curseur Système {#SystemCaret} + +Quand un [objet](#Objects) qui autorise la navigation ou l'édition de texte a le [focus](#SystemFocus), vous pouvez vous déplacer dans le texte en utilisant le curseur système ou curseur d'édition. + +Quand le focus est sur un objet ayant un curseur d'édition, vous pouvez utiliser les flèches, les touches début, fin, page précédente, page suivante pour vous déplacer dans le texte. +Vous pouvez également modifier le texte si le champ le permet. +NVDA annonce le déplacement par caractère, mot ou ligne, et annonce aussi la sélection et la désélection de texte. + +NVDA fournit les commandes clavier suivantes relatives au curseur système : + + +| Nom |Ordinateur de bureau |Ordinateur portable |Description| +|---|---|---|---| +|Dire tout |NVDA+flèche bas |NVDA+a |Démarre la lecture depuis la position du curseur système en lui faisant suivre la lecture| +|Lire ligne courante |NVDA+flèche haut |NVDA+l |Lit la ligne où se trouve le curseur système. Un double appui épelle la ligne. Un triple appui l'épelle en code international.| +|Lire texte sélectionné |NVDA+Maj+flèche haut |NVDA+Maj+s |Lit tout le texte actuellement sélectionné| +|Annoncer la mise en forme du texte |NVDA+f |NVDA+f |annonce la mise en forme du texte à la position actuelle du curseur. Un double appui présente l'information en mode navigation| +|Annoncer la destination du lien |`NVDA+k` |`NVDA+k` |Un appui annonce l'URL de destination du lien à la position courante du curseur ou du focus. Deux appuis l'affichent dans une fenêtre pour une revue plus attentive| +|Annoncer la position du curseur |NVDA+pavnumEffacement |NVDA+effacement |Annonce des informations sur l'emplacement du texte ou de l'objet à la position du curseur système. Par exemple, cela peut inclure le pourcentage dans le document, la distance depuis le bord de la page ou la position exacte sur l'écran. Appuyer deux fois peut fournir plus de détails.| +|Phrase suivante |alt+flècheBas |alt+flècheBas |Amène le curseur à la phrase suivante et la lit. (Supporté seulement sous Microsoft Word et Outlook)| +|Phrase précédente |alt+flècheHaut |alt+flècheHaut |Amène le curseur à la phrase précédente et la lit. (Supporté seulement sous Microsoft Word et Outlook)| + +Dans un tableau, vous disposez également des touches de commandes suivantes : + +| Nom |Touche |Description| +|---|---|---| +|Aller à la colonne précédente |contrôle+alt+flèche gauche |Déplace le curseur système à la colonne précédente en restant sur la même ligne| +|Aller à la colonne suivante |contrôle+alt+flèche droite |Déplace le curseur système à la colonne suivante en restant sur la même ligne| +|Aller à la ligne précédente |contrôle+alt+flèche haut |Déplace le curseur système à la ligne précédente en restant sur la même colonne| +|Aller à la ligne suivante |contrôle+alt+flèche bas |Déplace le curseur système à la ligne suivante en restant sur la même colonne| +|Aller à la première colonne |contrôle+alt+début |Déplace le curseur système à la première colonne (en restant sur la même ligne)| +|Aller à la dernière colonne |contrôle+alt+fin |Déplace le curseur système à la dernière colonne (en restant sur la même ligne)| +|Aller à la première ligne |contrôle+alt+PagePrec |Déplace le curseur système à la première ligne (en restant sur la même colonne)| +|Aller à la dernière ligne |contrôle+alt+pageSuiv |Déplace le curseur système à la dernière ligne (en restant sur la même colonne)| +|Dire tout dans la colonne |`NVDA+contrôle+alt+flècheBas` |Lit la colonne verticalement depuis la cellule courante jusqu'à la dernière cellule de la colonne.| +|Dire tout dans la ligne |`NVDA+contrôle+alt+flècheDroit` |Lit la ligne horizontalement depuis la cellule courante jusqu'à la dernière cellule de la ligne.| +|Lire toute la colonne |`NVDA+contrôle+alt+flècheHaut` |Lit la colonne courante verticalement du début à la fin sans déplacer le curseur système.| +|Lire toute la ligne |`NVDA+contrôle+alt+flècheGauche` |Lit la ligne courante horizontalement de gauche à droite sans déplacer le curseur système.| + + + +### Naviguer par Objet {#ObjectNavigation} + +La plupart du temps, vous travaillerez avec les applications en utilisant des commandes qui déplacent le [focus](#SystemFocus) et le [curseur](#SystemCaret). +Cependant, vous pouvez parfois avoir besoin d'explorer l'application en cours ou le système sans déplacer le focus ou le curseur. +Vous pouvez aussi avoir besoin d'accéder à des [objets](#Objects) inaccessibles par les commandes clavier habituelles. +Dans ces cas, vous pouvez utiliser la navigation par objet. + +La navigation par objet vous permet de vous déplacer parmi les différents [objets](#Objects) et d'obtenir des informations à leur sujet. +Quand vous atteignez un objet, NVDA l'annoncera de la même manière qu'il annonce le focus système. +Si vous désirez explorer tout le texte tel qu'il se présente à l'écran, vous pouvez également utiliser la [revue d'écran](#ScreenReview). + +Pour ne pas avoir à errer entre tous les objets présents dans le système, ceux-ci sont groupés hiérarchiquement. +Cela signifie que vous devez entrer dans certains objets pour voir les objets qu'ils contiennent. +Par exemple, une liste contient des éléments de liste, vous devez donc entrer dans la liste pour voir ces éléments. +Si vous êtes sur un élément de liste, aller à l'élément suivant ou précédent vous amènera à un autre élément de la même liste. +Si vous allez sur l'objet contenant les éléments de la liste, vous serez ramené à la liste. +Vous pourrez alors la quitter si vous désirez accéder à d'autres objets. +De la même manière, une barre d'outils contient des contrôles, vous devrez donc entrer dans la barre d'outils pour accéder aux contrôles qu'elle contient. + +Si vous préférez plutôt vous déplacer entre chaque objet simple du système, vous pouvez utiliser des commandes pour passer à l'objet précédent/suivant dans une vue à plat. +Par exemple, si vous vous déplacez vers l'objet suivant dans cette vue à plat et que l'objet actuel contient d'autres objets, NVDA se déplacera automatiquement vers le premier objet contenu. +Au contraire, si l'objet courant ne contient aucun objet, NVDA passera à l'objet suivant au niveau courant de la hiérarchie. +S'il n'y a pas d'objet suivant de ce type, NVDA essaiera de trouver l'objet suivant dans la hiérarchie en fonction des objets contenants jusqu'à ce qu'il n'y ait plus d'objets vers lesquels se déplacer. +Les mêmes règles s'appliquent pour reculer dans la hiérarchie. + +L'objet en cours de revue s'appelle l'objet navigateur. +Quand vous atteignez un objet, vous pouvez examiner son contenu en utilisant les [commandes de revue de texte](#ReviewingText) en étant en [mode Revue d'objet](#ObjectReview). +Quand la [Mise en Évidence Visuelle](#VisionFocusHighlight) est activée, la position de l'objet navigateur courant est également présentée visuellement. +Par défaut, l'objet navigateur suit le focus système, mais ce comportement peut être désactivé. + +Note : Le suivi de la Navigation par Objet par le Braille peut être configuré via [Braille Suit](#BrailleTether). + +Pour naviguer par objet, utilisez les commandes suivantes : + + + +| Nom |Ordinateur de bureau |Ordinateur portable |Tactile |Description| +|---|---|---|---|---| +|Annonce de l'objet courant |NVDA+pavnum5 |NVDA+Maj+o |Aucun |Annonce l'objet navigateur courant, deux appuis épellent l'information, trois appuis copient le nom et le contenu de l'objet dans le presse-papiers| +|Aller à l'objet parent |NVDA+pavnum8 |NVDA+maj+flèche haut |Glisser vers le haut (mode objet) |Va à l'objet parent (qui contient l'objet navigateur courant)| +|Aller à l'objet précédent |NVDA+pavnum4 |NVDA+maj+flèchegauche |aucun |Se déplace vers l'objet avant l'objet navigateur courant| +|Aller à l'objet précédent en vue à plat |NVDA+pavnum9 |NVDA+maj+ù |glisser vers la gauche (mode objet) |Passe à l'objet précédent dans une vue à plat de la hiérarchie de navigation d'objets| +|Passer à l'objet suivant |NVDA+pavnum6 |NVDA+maj+flècheDroite |aucun |Se déplace vers l'objet après l'objet navigateur courant| +|Passer à l'objet suivant dans la vue à plat |NVDA+pavnum3 |NVDA+maj+* |glisser vers la droite (mode objet) |Passe à l'objet suivant dans une vue à plat de la hiérarchie de navigation d'objets| +|Aller au premier objet inclus |NVDA+pavnum2 |NVDA+maj+flèche bas |Glisser vers le bas (mode objet) |Va au premier objet inclus dans l'objet navigateur courant| +|Aller à l'objet en focus |NVDA+pavnumMoins |NVDA+retour arrière |Aucun |Va à l'objet ayant le focus système, et place le curseur de revue sur le curseur système s'il est présent| +|Activer l'objet navigateur courant |NVDA+pavnumEntrer |NVDA+entrée |Double tape |Active l'objet navigateur courant (similaire à un clic de souris ou à appuyer la barre d'espace quand l'objet a le focus système)| +|Amener le focus système à l'objet navigateur courant |NVDA+maj+pavnumMoins |NVDA+maj+retour arrière |Aucun |Amène le focus système à l'objet navigateur courant si c'est possible| +|Annoncer la position du curseur de revue |NVDA+pavnumEffacement |NVDA+effacement |Aucun |Annonce la position du texte ou de l'objet sous le curseur de revue. Cela peut inclure, par exemple, le pourcentage dans le document, la distance au bord de la page ou la position exacte sur l'écran. Un double appui annonce éventuellement des informations supplémentaires.| +|Amener le curseur de revue à la barre d'état |aucun |aucun |aucun |Annonce la barre d'état si NVDA en trouve une. Amène également l'objet navigateur à sa position.| + + + +Note : Les touches du pavé numérique nécessitent de désactiver le verrouillage numérique pour fonctionner correctement. + +### Revue de Texte {#ReviewingText} + +NVDA vous permet de lire le contenu de [l'écran](#ScreenReview), du [document](#DocumentReview) ou de [l'objet](#ObjectReview) par caractère, mot ou ligne. +Ceci est particulièrement utile dans la console de commandes Windows et d'autres applications où le [curseur système](#SystemCaret) est inexistant. +Par exemple, cela peut servir à consulter le texte d'un long message dans un dialogue. + +Quand vous déplacez le curseur de revue, le curseur système ne bouge pas, ainsi vous pouvez explorer un texte sans perdre votre position d'édition actuelle. +Cependant, par défaut, quand le curseur système bouge, le curseur de revue le suit. +Ceci peut être désactivé. + +Note : Le suivi de la Navigation par Objet par le Braille peut être configuré via [Braille Suit](#BrailleTether). + +Vous disposez des commandes suivantes pour explorer du texte : + + +| Nom |Ordinateur de bureau |Ordinateur portable |Tactile |Description| +|---|---|---|---|---| +|Aller à la première ligne en revue |Maj+pavnum7 |NVDA+contrôle+début |Aucun |Amène le curseur de revue à la première ligne du texte| +|Aller à la ligne précédente en revue |pavnum7 |NVDA+flèche haut |Glisser vers le haut (mode texte) |Amène le curseur de revue sur la ligne de texte précédente| +|Annoncer la ligne courante en revue |pavnum8 |NVDA+maj+point-virgule |Aucun |Lit la ligne de texte sous le curseur de revue, un double appui épelle la ligne| +|Aller à la ligne suivante en revue |pavnum9 |NVDA+flèche bas |Glisser vers le bas (mode texte) |Amène le curseur de revue à la ligne de texte suivante| +|Aller à la dernière ligne en revue |maj+pavnum9 |NVDA+contrôle+fin |Aucun |Amène le curseur de revue à la dernière ligne de texte| +|Aller au mot précédent en revue |pavnum4 |NVDA+contrôle+flèche gauche |Glisser vers la gauche 2 doigts (mode texte) |Amène le curseur de revue au mot précédent dans le texte| +|Annoncer le mot courant en revue |pavnum5 |NVDA+contrôle+point-virgule |Aucun |Lit le mot à la position du curseur de revue, un double appui épelle le mot| +|Aller au mot suivant en revue |pavnum6 |NVDA+contrôle+flèche droite |Glisser vers la droite 2 doigts (mode texte) |Amène le curseur de revue au mot suivant| +|Aller au début de la ligne en revue |maj+pavnum1 |NVDA+début |Aucun |Amène le curseur de revue au début de la ligne courante| +|Aller au caractère précédent en revue |pavnum1 |NVDA+flèche gauche |Glisser vers la gauche (mode texte) |Amène le curseur de revue au caractère précédent de la ligne courante| +|Annoncer le caractère courant en revue |pavnum2 |NVDA+point-virgule |Aucun |Annonce le caractère courant sous le curseur de revue, un double appui annonce la valeur du caractère en décimal et hexadécimal| +|Aller au caractère suivant en revue |pavnum3 |NVDA+flèche droite |Glisser vers la droite (mode texte) |Amène le curseur de revue au caractère suivant de la ligne courante| +|Aller en fin de ligne en revue |maj+pavnum3 |NVDA+fin |Aucun |Amène le curseur de revue à la fin de la ligne courante| +|Aller à la page précédente en revue |`NVDA+pagePrec` |`NVDA+maj+pagePrec` |aucune |Amène le curseur de revue à la page précédente de texte si supporté par l'application| +|Aller à la page suivante en revue |`NVDA+pageSuiv` |`NVDA+maj+pageSuiv` |aucune |Amène le curseur de revue à la page suivante de texte si supporté par l'application| +|Dire tout en revue |pavnumPlus |NVDA+maj+a |Glisser vers le bas 3 doigts (mode texte) |Lit en partant de la position du curseur de revue, celui-ci suivant la lecture| +|Sélectionner puis copier à partir du curseur de revue |NVDA+f9 |NVDA+f9 |Aucun |Commence à sélectionner puis copier le texte depuis la position du curseur de revue. La copie ne s'effectue pas tant qu'on n'a pas indiqué la fin du texte à copier| +|Sélectionner puis copier jusqu'au curseur de revue |NVDA+f10 |NVDA+f10 |Aucun |Au premier appui, le texte est sélectionné depuis la position préalablement définie par "copier à partir du curseur de revue" jusqu'à la position actuelle du curseur de revue. Si le curseur système peut atteindre le texte, il sera amené au texte sélectionné. Au second appui, le texte est copié dans le presse-papiers de Windows.| +|aller au marqueur de début de copie en mode revue |NVDA+maj+f9 |NVDA+maj+f9 |aucun |Amène le curseur de revue à la position préalablement définiee comme marqueur de début de copie| +|Annoncer la mise en forme du texte |NVDA+maj+f |NVDA+maj+f |Aucun |Annonce la mise en forme du texte à la position du curseur de revue. Un double appui affiche l'information en mode navigation| +|Annonce le remplacement du symbole courant |Aucun |Aucun |aucun |Dit le symbole à la position du curseur de revue. Un double appui montre le symbole et le texte utilisé pour le remplacer en mode navigation.| + + + +Note : Les touches du pavé numérique nécessitent de désactiver le verrouillage numérique pour fonctionner correctement. + +Pour vous aider à mémoriser les touches de commandes de la disposition ordinateur de bureau, notez que les commandes de base de revue de texte sont organisées selon une grille de 3 sur 3 avec, de haut en bas, lignes, mots, caractères et, de gauche à droite, précédent, courant, suivant. +La disposition se présente ainsi : + +| . {.hideHeaderRow} |. |.| +|---|---|---| +|Ligne précédente |Ligne courante |Ligne suivante| +|Mot précédent |Mot courant |Mot suivant| +|Caractère précédent |Caractère courant |Caractère suivant| + +### Modes de Revue {#ReviewModes} + +Les commandes de [revue](#ReviewingText) de NVDA permettent de lire le contenu de l'objet courant du navigateur, le document courant ou l'écran, selon le mode de revue sélectionné. + +Les commandes suivantes basculent entre les modes de revue : + + +| Nom |Ordinateur de bureau |Ordinateur portable |Tactile |Description| +|---|---|---|---|---| +|Passer au mode revue suivant |NVDA+pavnum7 |NVDA+PagePrec |Glisser vers le haut 2 doigts |Passe au mode de revue suivant disponible supérieur au mode actuel.| +|Passer au mode revue précédent |NVDA+pavnum1 |NVDA+PageSuiv |Glisser vers le bas 2 doigts |Passe au mode de revue suivant disponible inférieur au mode actuel.| + + + +#### Revue d'Objet {#ObjectReview} + +En mode revue d'objet, vous pouvez explorer seulement le contenu de [l'objet du navigateur](#ObjectNavigation). +Pour les objets comme les champs d'édition ou les documents basiques, cela sera généralement le texte contenu. +Pour les autres objets, cela peut être le nom ou la valeur. + +#### Revue de Document {#DocumentReview} + +Quand [l'objet du navigateur](#ObjectNavigation) est dans un document comme une page web ou un document complexe (ex : document Lotus Symphony), il est possible de passer en mode revue de document. +Le mode revue de document vous permet de relire le contenu du document en entier. + +En passant du mode revue d'objet au mode revue de document, le curseur de revue se place là où se trouve le navigateur d'objet. +En bougeant le curseur de revue, le navigateur d'objet est déplacé à la même position que le curseur de revue. + +Notez que NVDA basculera automatiquement au mode revue de document depuis le mode revue d'objet lors d'un déplacement dans le document en mode navigation. + +#### Revue de l'Écran {#ScreenReview} + +Le mode revue de l'écran vous permet de lire le texte visible tel qu'il apparaît à l'écran dans l'application courante. +Cela est très similaire aux fonctionnalités mode revue ou curseur souris des autres lecteurs d'écran sous Windows. + +En basculant en mode revue de l'écran, le curseur de revue est placé à la position de [l'objet du navigateur](#ObjectNavigation). +En se déplaçant sur l'écran avec le curseur de revue, le navigateur d'objet est déplacé à l'objet trouvé à la position du curseur de revue. + +Notez que dans certaines nouvelles applications, NVDA ne pourra pas lire tout ou partie du texte à l'écran, étant donné qu'elles utilisent des techniques d'affichage qui ne peuvent être gérées actuellement. + +### Naviguer avec la Souris {#NavigatingWithTheMouse} + +Lorsqu'on déplace la souris, NVDA annonce par défaut le texte se trouvant directement sous le pointeur de la souris. +Quand c'est possible, NVDA lira un paragraphe, cependant certains contrôles ne peuvent être lus que par ligne. + +NVDA peut être configuré pour annoncer également le type d'[objet](#Objects) sous la souris lors de son déplacement (par exemple liste, bouton, etc.). +Cela peut être utile pour les personnes complètement aveugles car le texte n'est pas toujours suffisant. + +NVDA offre à l'utilisateur un moyen d'évaluer la position de la souris sur l'écran en émettant des bips audio représentant les coordonnées de la souris. +Plus la souris est haut sur l'écran, plus les bips sont aigus. +Plus la souris va à gauche ou à droite, plus le son viendra de gauche ou de droite dans la mesure où l'utilisateur possède des haut-parleurs stéréo. + +Par défaut, ces fonctions additionnelles de la souris ne sont pas activées. +Si vous voulez en tirer profit, vous pouvez les configurer dans la catégorie [Souris](#MouseSettings) du dialogue [Paramètres](#NVDASettings) qui se trouve dans le menu "Préférences" de NVDA. + +Bien qu'une souris physique ou un pavé tactile devrait être utilisée pour naviguer à la souris, NVDA possède quelques commandes clavier liées à la souris : + + +| Nom |Ordinateur de bureau |Ordinateur portable |Tactile |Description| +|---|---|---|---|---| +|Clic gauche |pavnumDiviser |NVDA+uAccentGrave |Aucun |Simple clic gauche. Le double clic s'obtient par deux appuis rapides| +|Verrouillage du bouton gauche de la souris |maj+pavnumDiviser |NVDA+maj+uAccentGrave |Aucun |Verrouille le bouton gauche de la souris en position enfoncée. Un second appui déverrouille le bouton. Pour glisser-déposer avec la souris, verrouillez le bouton puis déplacez la souris soit physiquement ou par l'une des commandes NVDA prévues à cet effet| +|Clic droit |pavnumMultiplier |NVDA+astérisque |Taper et maintenir |Simple clic droit| +|Verrouillage du bouton droit de la souris |maj+pavnumMultiplier |NVDA+maj+astérisque |Aucun |Verrouille le bouton droit de la souris en position enfoncée, un second appui déverrouille le bouton. Pour glisser-déposer avec la souris, verrouillez le bouton puis déplacez la souris soit physiquement ou par l'une des commandes NVDA prévues à cet effet| +|Amener la souris à l'objet navigateur courant |NVDA+pavnumDiviser |NVDA+maj+m |Aucun |Amène la souris à la position de l'objet navigateur courant puis au curseur de revue| +|Aller à l'objet sous la souris |NVDA+pavnumMultiplier |NVDA+maj+n |Aucun |Amène l'objet navigateur à l'objet situé à la position de la souris| + + + +## Le mode Navigation {#BrowseMode} + +Les documents complexes, tels que les pages web, sont représentés sous NVDA en utilisant le Mode Navigation. +Cela inclut les documents dans les applications suivantes : + +* Mozilla Firefox +* Microsoft Internet Explorer +* Mozilla Thunderbird +* Les messages HTML sous Microsoft Outlook +* Google Chrome +* Microsoft Edge +* Adobe Reader +* Foxit Reader +* Les livres supportés sous Amazon Kindle pour PC + +Le mode navigation est aussi disponible en option pour les documents Microsoft Word. + +Le mode navigation offre une représentation platement textuelle du document dans laquelle on peut se déplacer avec les flèches de navigation. +Dans ce mode, toutes les touches de commandes du [mode curseur](#SystemCaret) fonctionneront (ex : dire tout, annonce de la mise en forme, touches de navigation dans les tableaux etc.). +Quand la [Mise en Évidence Visuelle](#VisionFocusHighlight) est activée, la position du curseur virtuel de mode navigation est également présentée visuellement. +Des informations indiquant si le texte est un lien, un titre etc., sont annoncées avec le texte pendant que vous vous déplacez. + +Parfois, vous devrez interagir directement avec les contrôles contenus dans ces documents. +Par exemple, vous devrez le faire pour les zones d'édition et les listes pour pouvoir entrer du texte ou utiliser le curseur pour travailler avec les contrôles. +Cela se fait en passant en mode formulaire, mode dans lequel presque toutes les touches sont passées directement au contrôle. +En mode navigation, par défaut, NVDA passera automatiquement en mode formulaire si vous tabulez ou cliquez sur un champ qui le requiert. +Inversement, tabuler ou cliquer sur un contrôle qui ne requiert pas le mode formulaire rebasculera NVDA en mode navigation. +Appuyer sur la "barre d'espace" ou la touche "entrée" passera également NVDA en mode formulaire si le champ le permet. +Appuyer sur la touche "échap" repassera NVDA en mode navigation. +De plus, vous pouvez aussi passer manuellement NVDA en mode formulaire, après quoi il y restera jusqu'à ce que vous choisissiez de le désactiver. + + + +| Nom |Touche |Description| +|---|---|---| +|Bascule entre mode formulaire et mode navigation |NVDA+espace |Bascule entre le mode formulaire et le mode navigation| +|Quitter le mode formulaire |échap |Retourne en mode navigation si le mode formulaire a préalablement été activé automatiquement| +|Réactualiser le document |NVDA+f5 |Recharge le document en cours, (utile si le contenu de la page semble incomplet. Non disponible sous Microsoft Word et Outlook.)| +|Rechercher |NVDA+contrôle+f |Affiche un dialogue qui vous permet de rechercher du texte dans le document courant. Voir [chercher du texte](#SearchingForText) pour plus d'information| +|Rechercher suivant |NVDA+f3 |Recherche l'occurrence suivante du texte que vous avez préalablement recherché dans le document| +|Rechercher précédent |NVDA+maj+f3 |Recherche l'occurrence précédente du texte que vous avez préalablement recherché dans le document| + + + +### Les Touches de Navigation Rapide {#SingleLetterNavigation} + +En mode navigation, pour une navigation plus rapide, NVDA dispose de raccourcis clavier où l'appui d'une seule touche amène à certains champs dans le document. +Notez que toutes ces commandes ne sont pas disponibles dans tous les types de documents. + + +Les touches suivantes permettent d'aller à l'élément suivant. En les combinant avec maj, on retourne à l'élément précédent. + +* h : titre +* l : liste +* i : élément de liste +* t : tableau +* k : lien +* n : texte hors lien +* f : champ de formulaire +* u : lien non visité +* v : lien visité +* e : zone d'édition +* b : bouton +* x : case à cocher +* c : liste déroulante +* r : bouton radio +* q : balise de citation +* s : séparateur +* m : cadre +* g : graphique +* d : région +* o : objet embarqué (lecteur audio et vidéo, application, dialogue etc.) +* 1 ... 6 : Titres 1 ... 6. +* a: annotation (commentaire, modification de l'éditeur, etc.) +* `p` : paragraphe de texte +* w: fautes d'orthographe + +Pour se déplacer au début ou à la fin des éléments contenants comme les listes et tableaux : + +| Nom |Touche |Description| +|---|---|---| +|Aller au début du conteneur |maj+virgule |Se déplace au début du conteneur (liste, tableau etc.) où le curseur est positionné| +|Aller après la fin du conteneur |virgule |Se déplace après la fin du conteneur (liste, tableau etc.) où le curseur se trouve| + + + +Quelques applications web comme Gmail, Twitter et Facebook utilisent de simple lettres comme touches de raccourci. +Si vous voulez les utiliser tout en restant capable d'utiliser vos touches curseur en mode navigation, vous pouvez désactiver temporairement les touches de navigation rapide de NVDA. + +Pour activer ou désactiver la navigation rapide pour le document courant, pressez NVDA+maj+espace. + + +#### Commande de navigation par paragraphe de texte {#TextNavigationCommand} + +Vous pouvez passer au paragraphe de texte suivant ou précédent en appuyant sur `p` ou `maj+p`. +Les paragraphes de texte sont définis comme un groupe de texte qui semble être écrit sous forme de phrases complètes. +Cela peut être utile pour trouver le début du contenu à lire sur diverses pages Web, telles que : + +* Les sites d'actualités +* Les forums +* Les articles de blog + +Ces commandes peuvent également être utiles pour éviter certains types de contenu, tels que : + +* Les publicités +* Les menus +* Les titres + +Veuillez noter cependant que même si NVDA fait de son mieux pour identifier les paragraphes de texte, l'algorithme n'est pas parfait et peut parfois commettre des erreurs. +De plus, cette commande est différente des commandes de navigation par paragraphe `contrôle+flècheBas/flècheHaut`. +La navigation par paragraphes de texte saute uniquement entre les paragraphes de texte, tandis que les commandes de navigation par paragraphe amènent le curseur aux paragraphe précédent/suivant, qu'ils contiennent ou non du texte. + +#### Autres commandes de navigation {#OtherNavigationCommands} + +En plus des commandes de navigation rapide répertoriées ci-dessus, NVDA dispose de commandes auxquelles aucune touche par défaut n'est attribuée. +Pour utiliser ces commandes, vous devez d'abord leur attribuer des gestes à l'aide de la [boîte de dialogue Gestes de commandes](#InputGestures). +Voici une liste des commandes disponibles: + +* Article +* Figure +* Regroupement +* Onglet +* Menu item +* Bouton à bascule +* Barre de progression +* Formule mathématique +* Paragraphe aligné verticalement +* Texte de même style +* Texte de style différent + +Gardez à l'esprit qu'il existe deux commandes pour chaque type d'élément, pour avancer et reculer dans le document, et vous devez attribuer des gestes aux deux commandes afin de pouvoir naviguer rapidement dans les deux sens. +Par exemple, si vous souhaitez utiliser les touches `y` / `maj+y` pour naviguer rapidement dans les onglets, procédez comme suit: + +1. Ouvrez la boîte de dialogue des gestes de commandes à partir du mode navigation. +1. Recherchez l'élément "Aller à l'onglet suivant" dans la section Mode navigation. +1. Attribuez la touche `y` pour le geste trouvé. +1. Recherchez l'élément "Aller à l'onglet précédent". +1. Attribuez `maj+y` pour le geste trouvé. + +### La Liste d'Éléments {#ElementsList} + +La liste d'éléments donne accès à une liste de différents types d'éléments dans le document, de manière appropriée à l'application. +Par exemple, dans les navigateurs web, la liste d'éléments peut afficher les liens, les titres, les champs de formulaire, les boutons ou les régions. +Des boutons radio vous permettent de choisir entre les différents types d'éléments. +Une zone d'édition est également présente dans le dialogue, elle vous permet de filtrer la liste pour faciliter la recherche d'un élément particulier dans la page. +Quand vous avez choisi un élément, des boutons vous permettent de vous y rendre ou de l'activer. + + +| Nom |Touche |Description| +|---|---|---| +|Liste d'éléments du document |NVDA+f7 |Liste les différents types d'éléments du document courant| + + + +### Chercher du texte {#SearchingForText} + +Ce dialogue vous permet de rechercher des termes dans le document courant. +Dans le champ "Entrez le texte à rechercher", le texte à trouver peut être saisi. +La case à cocher "Respecter la casse" force la recherche à différencier les lettres majuscules et minuscules. +Par exemple, quand Respecter la casse est sélectionné, vous trouverez " NV Access " mais pas " nv access ". +Utilisez les touches suivantes pour effectuer des recherches : + + +| Nom |Touche |Description| +|---|---|---| +|Rechercher du texte |NVDA+contrôle+f |Ouvre le dialogue de recherche| +|Trouver l'occurrence suivante |NVDA+f3 |recherche l'occurrence suivante du terme en cours de recherche| +|Trouver l'occurrence précédente |NVDA+maj+f3 |recherche l'occurrence précédente du terme en cours de recherche| + + + +### Les Objets Embarqués {#ImbeddedObjects} + +Certaines pages peuvent inclure du contenu riche utilisant des technologies comme Oracle Java et HTML5, tout comme des applications ou des dialogues. +Quand il en rencontre dans un document, NVDA annonce "objet embarqué", "application", ou "dialogue" respectivement. +Vous pouvez vous y rendre rapidement en utilisant les touches de navigation rapide pour objets embarqués o et maj+o. +Pour interagir avec ces objets, vous pouvez presser Entrée sur eux. +Si l'objet est accessible, vous pourrez interagir avec lui comme n'importe quelle autre application. +Une touche de commande permet de retourner à la page contenant l'objet embarqué. + + +| Nom |Touche |Description| +|---|---|---| +|Aller au document contenant l'objet |NVDA+contrôle+espace |Retire le focus à l'objet embarqué en cours et le rend au document contenant l'objet| + + + +### Mode sélection native {#NativeSelectionMode} + +Par défaut lors de la sélection de texte avec les touches `maj+flèche` en mode navigation, la sélection est seulement effectuée dans la représentation du document en mode navigation de NVDA, et non dans l'application elle-même. +Cela signifie que la sélection n'est pas visible à l'écran, et la copie du texte avec `contrôle+c` copiera seulement la représentation du contenu en texte brut par NVDA. C'est-à-dire que le formatage des tableaux ou comme lien ne sera pas copié. +Cependant, NVDA dispose d'un mode de sélection native qui peut être activé dans certains documents en mode navigation (pour l'instant seulement dans Mozilla Firefox), ce qui fait que la sélection native dans le document suit la sélection du mode navigation de NVDA. + + + +| Nom |Touche |Description| +|---|---|---| +|Activer ou désactiver le mode de sélection native |`NVDA+maj+f10` |Active ou désactive le mode de sélection native| + + + +Lorsque le mode de sélection native est activé, la copie de la sélection avec `contrôle+c` utilisera également la fonctionnalité de copie de l'application elle-même, ce qui signifie que le contenu riche sera copié dans le presse-papiers, au lieu du texte brut. +Cela signifie que le collage de ce contenu dans un programme tel que Microsoft Word ou Excel, le formatage tel que des tableaux ou le fait qu'un élément soit un lien seront inclus. +Veuillez noter cependant qu'en mode de sélection natif, certains labels accessibles ou autres informations générées par NVDA en mode Navigation ne seront pas inclus. +De plus, bien que l'application fasse de son mieux pour faire correspondre la sélection native à la sélection du mode navigation de NVDA, elle peut ne pas toujours être complètement exacte. +Cependant, pour les scénarios dans lesquels vous souhaitez copier un tableau ou un paragraphe entier de contenu riche, cette fonctionnalité devrait s'avérer utile. + +## Lecture de Contenu Mathématique {#ReadingMath} + +NVDA peut lire et naviguer dans du contenu mathématique sur le Web et dans d'autres applications, offrant un accès à la fois en parole et en braille. +Cependant, pour que NVDA puisse lire et interagir avec le contenu mathématique, vous devrez d'abord installer un composant mathématique pour NVDA. +Il existe plusieures extensions NVDA disponibles dans l'Add-on Store de NVDA qui prennent en charge les mathématiques, notamment l'[extension MathCAT NVDA](https://nsoiffer.github.io/MathCAT/) et [Access8Math](https://github.com/tsengwoody/Access8Math). +Veuillez vous référer à la [section Add-on Store](#AddonsManager) pour savoir comment découvrir et installer les extensions disponibles dans NVDA. +NVDA peut également utiliser l'ancien logiciel [MathPlayer](https://info.wiris.com/mathplayer-info) de Wiris s'il se trouve sur votre système, bien que ce logiciel ne soit plus maintenu. + +### Contenu mathématique pris en charge {#SupportedMathContent} + +Avec un composant mathématique approprié installé, NVDA supporte les types de contenu mathématiques suivants : + +* MathML sous Mozilla Firefox, Microsoft Internet Explorer et Google Chrome. +* Microsoft Word 365 Modern Math Equations via UI automation : +NVDA est capable de lire et d'interagir avec des équations mathématiques dans Microsoft Word 365/2016 build 14326 et supérieur. +Notez cependant que toutes les équations MathType créées précédemment doivent d'abord être converties en Office Math. +Cela peut être fait en sélectionnant chaque équation et en choisissant "Options d'équation", puis "Convertir en Office Math" dans le menu contextuel. +Assurez-vous que votre version de MathType est la dernière version avant de faire cela. +Microsoft Word fournit une navigation linéaire basée sur des symboles à travers les équations elles-mêmes et prend en charge la saisie de mathématiques à l'aide de plusieurs syntaxes, y compris LateX. +Pour plus de détails, veuillez consulter [Équations au format linéaire utilisant UnicodeMath et LaTeX dans Word](https://support.microsoft.com/fr-fr/office/%C3%A9quations-au-format-lin%C3%A9aire-utilisant-unicodemath-et-latex-dans-word-2e00618d-b1fd-49d8-8cb4-8d17f25754f8) +* Microsoft Powerpoint et les anciennes versions de Microsoft Word : +NVDA peut lire et parcourir les équations MathType dans Microsoft Powerpoint et Microsoft Word. +MathType doit être installé pour que cela fonctionne. +La version de démonstration est suffisante. +Elle peut être téléchargée depuis la [page de présentation de MathType](https://www.wiris.com/en/mathtype/). +* Adobe Reader. +Notez que ceci n'est pas un standard officiel, ce qui fait qu'actuellement, il n'existe pas de logiciels grand public pouvant produire ce contenu. +* Kindle Reader pour PC : +NVDA peut lire et parcourir Math dans Kindle pour PC pour les livres avec des mathématiques accessibles. + +Durant la lecture d'un document, NVDA annoncera tout contenu mathématique supporté quand il se présente. +Si vous utilisez un afficheur braille, ce contenu sera aussi affiché en braille. + +### Navigation Interactive {#InteractiveNavigation} + +Si vous travaillez principalement à la synthèse vocale, dans la plupart des cas, vous souhaiterez probablement examiner l'expression en plus petits segments plutôt qu'entendre toute l'expression en une seule fois. + +Si vous êtes en mode navigation, vous pouvez le faire en amenant le curseur sur le contenu mathématique et en appuyant sur Entrée. + +Si vous n'êtes pas en mode navigation : + +1. Amenez le curseur de revue sur le contenu mathématique. +Par défaut, le curseur de revue suit le curseur système, vous pouvez donc généralement utiliser le curseur système pour aller au contenu désiré. +1. Ensuite, activez la commande suivante : + + + +| Nom |Touche |Description| +|---|---|---| +|Interagir avec le contenu mathématique |NVDA+alt+m |Commence l'interaction avec le contenu mathématique.| + + + +A ce stade, NVDA entrera en mode mathématiques, dans lequel vous pouvez utiliser les commandes telles que les flèches pour explorer l'expression. +Par exemple, vous pouvez vous déplacer dans l'expression avec les flèches gauche et droite puis zoomer sur une partie de l'expression telle qu'une fraction en utilisant la flèche basse. + +Quand vous voulez retourner au document, appuyez simplement sur la touche échap. + +Pour plus d'informations sur les commandes disponibles et les préférences pour la lecture et la navigation dans le contenu mathématique, veuillez vous référer à la documentation du composant mathématique particulier que vous avez installé. + +* [Documentation MathCAT](https://nsoiffer.github.io/MathCAT/users.html) +* [Documentation Access8Math](https://github.com/tsengwoody/Access8Math) +* [Documentation MathPlayer](https://docs.wiris.com/mathplayer/en/mathplayer-user-manual.html) + +Parfois le contenu mathématique peut être affiché comme un bouton ou autre type d'élément qui, quand activé, peut afficher un dialogue ou plus d'informations relatives à la formule. +Pour activer le bouton ou l'élément contenant la formule, appuyez sur ctrl+entrée. + +### Installation de MathPlayer {#InstallingMathPlayer} + +Bien qu'il soit généralement recommandé d'utiliser l'une des extensions NVDA les plus récentes pour prendre en charge les mathématiques dans NVDA, dans certains scénarios limités, MathPlayer peut toujours être un choix plus approprié. +Par exemple. MathPlayer peut prendre en charge une langue particulière ou un code braille qui n'est pas pris en charge dans les extensions plus récentes. +MathPlayer est disponible gratuitement sur le site Wiris. +[Télécharger MathPlayer](https://downloads.wiris.com/mathplayer/MathPlayerSetup.exe). +Après avoir installé MathPlayer, vous devrez redémarrer NVDA. +Veuillez noter que les informations sur MathPlayer peuvent indiquer qu'il est uniquement destiné aux navigateurs plus anciens tels qu'Internet Explorer 8. +Cela fait uniquement référence à l'utilisation de MathPlayer pour afficher visuellement du contenu mathématique et peut être ignoré par ceux qui l'utilisent pour lire ou naviguer dans les mathématiques avec NVDA. + +## Braille {#Braille} + +Si vous possédez un afficheur braille, NVDA peut afficher des informations en braille. +Si votre terminal braille possède un clavier de type Perkins, vous pouvez également saisir du texte en intégral ou abrégé. +Le Braille peut aussi être affiché à l'écran en utilisant [la Visionneuse Braille](#BrailleViewer) en remplacement ou en parallèle d'un afficheur braille physique. + +Veuillez consulter la section [Terminaux Braille Pris en Charge](#SupportedBrailleDisplays) pour des informations concernant les terminaux braille pris en charge. +Cette section contient également des informations sur les terminaux qui supportent la détection automatique de terminaux braille en arrière-plan. +Vous pouvez configurer le braille dans la catégorie [Braille](#BrailleSettings) du dialogue [Paramètres](#NVDASettings). + +### Abréviations des Types, États des Contrôles et Repères en Braille {#BrailleAbbreviations} + +Dans le but de loger autant d'informations que possible sur un afficheur braille, les abréviations suivantes ont été définies pour indiquer le type et l'état des contrôles ainsi que les repères. + +| Abréviation |Type de contrôle| +|---|---| +|app |application| +|art |article| +|ctn |citation| +|btn |bouton| +|btnd |bouton déroulant| +|btnrot |bouton rotatif| +|btnp |bouton partagé| +|bsc |bascule| +|lég |légende| +|lstd |liste déroulante| +|càc |case à cocher| +|dlg |dialogue| +|doc |document| +|éd |zone d'édition| +|édmdp |édition de mot de passe| +|objemb |objet embarqué| +|notef |note de fin| +|fig |figure| +|noteb |note de bas de page| +|gra |graphique| +|grp |groupe| +|tN |titre de niveau n, ex : t1, t2.| +|aid |bulle d'aide| +|rgn |repère| +|ln |lien| +|lnv |lien visité| +|lst |liste| +|mnu |menu| +|bmnu |barre de menu| +|btnmnu |bouton de menu| +|élmnu |élément de menu| +|pn |panneau| +|bpr |barre de progression| +|indoc |indicateur d'occupation| +|btnr |bouton radio| +|bdéf |barre de défilement| +|sect |section| +|bét |barre d'état| +|ong |Contrôle d'onglet| +|tb |tableau| +|cN |colonne n d'un tableau, ex : c1, c2.| +|lN |ligne n d'un tableau, ex : l1, l2.| +|term |terminal| +|bo |barre d'outils| +|sug |suggestion| +|arb |arborescence| +|btnarb |bouton d'arborescence| +|élarb |élément d'arborescence| +|nv N |un élément d'arborescence a un niveau hiérarchique N| +|fen |fenêtre| +|⠤⠤⠤⠤⠤ |séparateur| +|mrq |contenu marqué| + +Les indicateurs d'état suivants sont également définis : + +| Abréviation |État du contrôle| +|---|---| +|... |affiché quand un objet supporte l'autocomplétion| +|⢎⣿⡱ |affiché quand un objet (ex : une bascule) est enfoncé| +|⢎⣀⡱ |affiché quand un objet (ex : une bascule) n'est pas enfoncé| +|⣏⣿⣹ |affiché quand un objet (ex : une case à cocher) est coché| +|⣏⣸⣹ |affiché quand un objet (ex : une case à cocher) est semi-coché| +|⣏⣀⣹ |affiché quand un objet (ex : une case à cocher) n'est pas coché| +|- |affiché quand un objet tel qu'un élément d'arborescence peut être réduit| +|+ |affiché quand un objet tel qu'un élément d'arborescence peut être développé| +|*** |affiché quand on rencontre un contrôle ou un document protégé| +|clq |affiché quand un objet est cliquable| +|cmnt |affiché quand il y a un commentaire pour une cellule de feuille de travail ou un document| +|frml |affiché quand il y a une formule dans une cellule de feuille de travail| +|invl |affiché lors d'une saisie invalide| +|ldesc |affiché quand un objet, généralement un graphique, a une description longue| +|mléd |affiché quand un champ d'édition permet la frappe de plusieurs lignes de texte comme les zones de commentaire sur les sites web| +|oblg |affiché quand on rencontre un champ de saisie obligatoire| +|ls |affiché quand un objet tel qu'une zone d'édition est en lecture seule| +|sél |affiché quand un objet est sélectionné| +|nsél |affiché quand un objet n'est pas sélectionné| +|tcro |affiché quand un objet est trié en ordre croissant| +|tdéc |affiché quand un objet est trié en ordre décroissant| +|smnu |affiché quand un objet a un sous-menu| + +Enfin, les abréviations de repères suivantes sont définies : + +| Abréviation |Repère| +|---|---| +|bnr |bannière| +|cinf |information sur le contenu| +|cmp |complémentaire| +|form |formulaire| +|prc |principale| +|nav |navigation| +|rch |recherche| +|rgn |région| + +### Saisie en Braille {#BrailleInput} + +NVDA supporte la saisie de braille intégral ou abrégé via un clavier braille. +Vous pouvez sélectionner la table de conversion utilisée pour convertir le braille en texte en utilisant le paramètre [Table de saisie](#BrailleSettingsInputTable) de la catégorie Braille du dialogue [Paramètres](#NVDASettings). + +Quand on utilise le braille intégral , le texte est inséré aussitôt qu'il est entré. +Quand on utilise le braille abrégé, le texte est inséré quand on presse espace ou entrée à la fin d'un mot. +Notez que la conversion ne concerne que les mots braille que vous êtes en train de taper et ne peut pas considérer du texte existant. +Par exemple, si vous utilisez un code braille dont les nombres doivent commencer par un indicateur numérique et pressez retour arrière pour aller à la fin d'un nombre, vous devrez entrer à nouveau l'indicateur numérique pour entrer des chiffres supplémentaires. + + +L'appui sur le point 7 efface la dernière cellule ou le dernier caractère braille saisi. +Le point 8 traduit toute saisie braille puis appuie sur la touche Entrée. +L'appui simultané sur les points 7 et 8 traduit toute saisie braille sans ajouter d'espace ou actionner la touche entrée. + + +#### Saisie de raccourcis clavier {#BrailleKeyboardShortcuts} + +NVDA prend en charge la saisie de raccourcis clavier et l'émulation de touches à l'aide de l'afficheur braille. +Cette émulation se présente sous deux formes : l'attribution d'une entrée braille directement à un appui sur une touche et l'utilisation des touches de modification virtuelles. + +Les touches couramment utilisées, telles que les touches fléchées ou l'appui sur Alt pour accéder aux menus, peuvent être mappées directement sur la saisie braille. +Le pilote de chaque afficheur braille est pré-équipé avec certaines de ces affectations. +Vous pouvez modifier ces affectations ou ajouter de nouvelles touches émulées à partir du [dialogue Gestes de commandes](#InputGestures). + +Bien que cette approche soit utile pour les touches fréquemment pressées ou uniques (telles que la tabulation), vous ne souhaiterez peut-être pas attribuer un ensemble unique de touches à chaque raccourci clavier. +Pour permettre l'émulation de pression de touches lorsque les touches de modification sont maintenues enfoncées, NVDA fournit des commandes pour basculer entre les touches contrôle, alt, majuscule, windows et NVDA, ainsi que des commandes pour certaines combinaisons de ces touches. +Pour utiliser ces bascules, appuyez d'abord sur la commande (ou la séquence de commandes) des touches de modification sur lesquelles vous souhaitez appuyer. +Saisissez ensuite le caractère faisant partie du raccourci clavier que vous souhaitez saisir. +Par exemple, pour produire contrôle+f, utilisez la commande "bascule de touche contrôle" puis tapez un f, +et pour saisir contrôle+alt+t, utilisez soit les commandes "bascule de touche contrôle" et "bascule de touche alt", dans n'importe quel ordre, soit la commande "bascule de touches Contrôle et alt", suivie de la saisie d'un t. + +Si vous basculez accidentellement les touches de modification, exécuter à nouveau la commande bascule supprimera le modificateur. + +Lors de la saisie en braille abrégé, l'utilisation des touches de modification entraînera la traduction de votre entrée comme si vous aviez appuyé sur les points 7 + 8. +De plus, la touche émulée ne peut pas refléter le braille tapé avant que la touche de modification ne soit enfoncée. +Cela signifie que, pour taper alt+2 avec un code braille qui utilise un signe dièse, vous devez d'abord basculer Alt puis taper un signe dièse. + +## Vision {#Vision} + +Bien que NVDA soit en premier lieu destiné à des personnes aveugles ou malvoyantes qui utilisent principalement la parole ou le braille pour accéder à un ordinateur, il offre aussi des facilités internes pour changer le contenu de l'écran. +Sous NVDA, une telle aide visuelle est appelée un service d'amélioration visuelle. + +NVDA offre plusieurs services d'amélioration visuelle décrits ci-dessous. +Des services d'amélioration visuelle additionnels peuvent être apportés dans des [Extensions NVDA](#AddonsManager). + +Les paramètres de vision de NVDA peuvent être modifiés dans la [catégorie vision](#VisionSettings) du dialogue [Paramètres NVDA](#NVDASettings). + +### Mise en Évidence Visuelle {#VisionFocusHighlight} + +La mise en évidence Visuelle peut aider à identifier la position du [focus système](#SystemFocus), de [l'objet navigateur](#ObjectNavigation) et du [mode navigation](#BrowseMode). +Ces positions sont mises en évidence avec un contour rectangulaire coloré. + +* Le bleu continu indique la position d'un objet navigateur combiné au focus système (ex : lorsque [l'objet navigateur suit le curseur système](#ReviewCursorFollowFocus)). +* Le bleu pointillé indique juste l'objet ayant le focus système. +* Le rose continu indique juste l'objet navigateur. +* Le jaune continu indique le curseur virtuel utilisé en mode navigation (quand il n'y a pas de curseur physique comme dans les navigateurs web). + +Quand la Mise en Évidence Visuelle est activée dans la [catégorie vision](#VisionSettings) du dialogue [Paramètres de NVDA](#NVDASettings), vous pouvez [choisir de mettre en évidence ou non le focus, l'objet navigateur ou le curseur du mode navigation](#VisionSettingsFocusHighlight). + +### Le Rideau d'Écran {#VisionScreenCurtain} + +En tant qu'utilisateur aveugle ou malvoyant, il est parfois impossible ou inutile de voir le contenu de l'écran. +Par ailleurs, il peut être difficile de s'assurer que personne ne regarde par-dessus votre épaule. +Pour cette situation, NVDA contient une fonctionnalité appelée "Rideau d'Écran" qui peut être activée pour rendre l'écran noir. + +Vous pouvez activer le Rideau d'Écran dans la [catégorie vision](#VisionSettings) du dialogue [Paramètres NVDA Settings](#NVDASettings). + + + +| Nom |Touche |Description| +|---|---|---| +|Activer ou désactiver le rideau d'écran |`NVDA+contrôle+échap` |Activer pour rendre l'écran noir ou désactiver pour afficher le contenu de l'écran. Un appui active le rideau d'écran jusqu'au prochain redémarrage de NVDA. Deux appuis activent le rideau d'écran jusqu'à ce que vous le désactiviez.| + + + +Quand le Rideau d'Écran est activé, certaines tâches directement liées à ce qui apparaît sur l'écran telles que [la reconnaissance optique de caractères](#Win10Ocr) ou la prise d'une copie d'écran ne peuvent pas être effectuées. + +En raison d'un changement dans l'API de grossissement de Windows, le Rideau d'Écran a dû être mis à jour pour prendre en charge les dernières versions de Windows. +Utilisez NVDA 2021.2 pour activer le Rideau d'Écran avec Windows 10 21H2 (10.0.19044) ou une version ultérieure. +Pour des raisons de sécurité, lorsque vous utilisez une nouvelle version de Windows, obtenez une confirmation visuelle que le rideau d'écran rend l'écran entièrement noir. + +Veuillez noter que lorsque la Loupe Windows est en cours d'exécution et que les couleurs d'écran inversées sont utilisées, le rideau d'écran ne peut pas être activé. + +## Reconnaissance de Contenu {#ContentRecognition} + +Quand les auteurs ne fournissent pas assez d'informations pour qu'un utilisateur de revue d'écran puisse déterminer le contenu de quelque chose, divers outils peuvent être utilisés pour tenter de reconnaître le contenu à partir d'une image. +NVDA supporte la fonctionnalité de reconnaissance optique de caractères (OCR) disponible sous Windows 10 et versions ultérieures pour reconnaître le texte dans les images. +Des outils de reconnaissance de contenu additionnels peuvent être fournis dans des extensions de NVDA. + +Quand vous utilisez une commande de reconnaissance de contenu, NVDA reconnaît le contenu de [l'objet navigateur courant](#ObjectNavigation). +Par défaut, l'objet navigateur suit le focus système ou le curseur du mode navigation, il vous suffit donc généralement d'amener le focus ou le curseur de navigation à l'endroit désiré. +Par exemple, si vous amenez le curseur de navigation sur un graphique, la reconnaissance reconnaîtra le contenu de ce graphique par défaut. +Cependant, vous pouvez utiliser directement la navigation par objet pour, par exemple, reconnaître tout le contenu d'une fenêtre d'application. + +Une fois la reconnaissance terminée, le résultat sera présenté dans un document similaire au mode navigation, vous permettant de lire les informations avec les touches curseur, etc. +L'appui sur la touche Entrée ou Espace activera (clic normal) le texte sous le curseur si possible. +L'appui sur échap quitte et efface le résultat de reconnaissance. + +### Reconnaissance Optique de Caractères de Windows {#Win10Ocr} + +Windows 10 et les versions ultérieures incluent la reconnaissance optique de caractères pour beaucoup de langues. +NVDA peut l'utiliser pour extraire le texte d'images ou d'applications inaccessibles. + +Vous pouvez définir la langue à utiliser pour la reconnaissance de texte dans la catégorie [Reconnaissance Optique De Caractères de Windows](#Win10OcrSettings) du dialogue [Paramètres](#NVDASettings). +Des langues additionnelles peuvent être installées en ouvrant le menu Démarrer, choisir Paramètres, Sélectionner Heure et Langue -> Région & Langue puis choisir Ajouter une langue. + +Lorsque vous souhaitez surveiller un contenu en constante évolution, par exemple lorsque vous regardez une vidéo avec sous-titres, vous pouvez éventuellement activer l'actualisation automatique du contenu reconnu. +Cela peut également être fait dans la [Catégorie Reconnaissance optique de caractères de Windows](#Win10OcrSettings) de la boîte de dialogue [Paramètres NVDA](#NVDASettings). + +La reconnaissance optique de caractères de Windows peut être partiellement ou totalement incompatible avec [les améliorations visuelles de NVDA](#Vision) ou autres aides visuelles externes. Vous devrez désactiver ces aides avant de procéder à une reconnaissance. + + +Pour reconnaître le texte dans l'objet navigateur courant en utilisant la reconnaissance optique de caractères de Windows, pressez NVDA+r. + + +## Fonctionnalités Spécifiques à Certaines Applications {#ApplicationSpecificFeatures} + +NVDA fournit ses propres fonctionnalités additionnelles dans quelques applications pour rendre certaines tâches plus faciles ou pour donner accès à certaines fonctions qui ne seraient pas accessibles autrement. + +### Microsoft Word {#MicrosoftWord} +#### Lecture Automatique des En-têtes de Lignes et de Colonnes {#WordAutomaticColumnAndRowHeaderReading} + +NVDA est capable d'annoncer automatiquement les en-têtes des lignes et des colonnes quand on navigue dans un tableau sous Microsoft Word. +Ceci nécessite que l'option "En-têtes de ligne et de colonne" soit activée dans la catégorie "Mise en Forme des Documents" qui se trouve dans le dialogue [Paramètres](#NVDASettings) de NVDA. + +Si vous utilisez [UIA pour accéder aux documents Word](#MSWordUIA), qui est le choix par défaut pour les versions récentes de Word et Windows, les cellules de la première ligne seront automatiquement considérées comme en-têtes de colonnes ; de même, les cellules de la première colonne seront automatiquement considérées comme en-têtes de lignes. + +Au contraire, si vous n'utilisez pas [UIA pour accéder aux documents Word](#MSWordUIA), vous devrez indiquer à NVDA quelle ligne ou colonne contient les en-têtes pour chaque tableau. +Après vous être placé sur la première cellule dans la colonne ou la ligne contenant les titres, utilisez l'une des commandes suivantes : + + +| Nom |Touche |Description| +|---|---|---| +|Définir les titres de colonnes |NVDA+maj+c |Appuyer une fois indique à NVDA que cette cellule est la première de la ligne contenant les titres de colonnes, qui devraient être annoncés automatiquement en naviguant entre les colonnes sous cette ligne. Appuyer deux fois permet d'effacer le paramétrage.| +|Définir les titres de lignes |NVDA+maj+r |Appuyer une fois indique à NVDA que cette cellule est la première de la colonne contenant les titres de lignes, qui devraient être annoncés automatiquement en naviguant entre les lignes après cette colonne. Appuyer deux fois permet d'effacer le paramétrage.| + + +Ces paramètres seront enregistrés dans le document comme des signets, compatibles avec d'autres revues d'écran comme JAWS. +Cela signifie que d'autres utilisateurs de revues d'écran ouvrant ce document ultérieurement auront automatiquement les titres des lignes et colonnes déjà définis. + +#### Mode Navigation sous Microsoft Word {#BrowseModeInMicrosoftWord} + +Comme sur le web, le mode navigation peut être utilisé sous Microsoft Word pour vous permettre d'utiliser des fonctionnalités telles que la navigation rapide et la Liste d'éléments. + +Pour activer ou désactiver le mode navigation sous Microsoft Word, pressez NVDA+espace. + +Pour plus d'information sur le mode navigation et la navigation rapide, consultez la [section Mode navigation](#BrowseMode). + +##### La Liste d'Éléments {#WordElementsList} + + +Quand vous êtes en mode navigation sous Microsoft Word, vous pouvez accéder à la liste d'éléments en pressant NVDA+f7. + +La liste d'éléments peut lister les titres, les liens, annotations (incluant inclut les commentaires et les demandes de changement) et les erreurs (actuellement limité aux fautes d'orthographe). + +#### Annonce des Commentaires {#WordReportingComments} + + +Pour annoncer tout commentaire à la position actuelle du curseur, pressez NVDA+alt+c. + +Tous les commentaires pour le document ainsi que les autres demandes de modification peuvent aussi être listés dans la liste d'éléments de NVDA en choisissant le type Annotations. + +### Microsoft Excel {#MicrosoftExcel} +#### Lecture Automatique des En-têtes de Lignes et de Colonnes {#ExcelAutomaticColumnAndRowHeaderReading} + +NVDA est capable d'annoncer automatiquement les en-têtes des lignes et des colonnes quand on navigue dans un tableau dans une feuille de calcul Excel. +Ceci nécessite d'abord que l'option "En-têtes de ligne et de colonne" soit activée dans la catégorie "Mise en Forme des Documents" qui se trouve dans le dialogue [Paramètres](#NVDASettings) de NVDA. +Ensuite, NVDA doit savoir quelle ligne ou colonne contient les titres dans le tableau considéré. +Après vous être placé sur la première cellule dans la colonne ou la ligne contenant les titres, utilisez l'une des commandes suivantes : + + +| Nom |Touche |Description| +|---|---|---| +|Définir les titres de colonnes |NVDA+maj+c |Appuyer une fois indique à NVDA que cette cellule est la première de la ligne contenant les titres de colonnes, qui devraient être annoncés automatiquement en naviguant entre les colonnes sous cette ligne. Appuyer deux fois permet d'effacer le paramétrage.| +|Définir les titres de lignes |NVDA+maj+r |Appuyer une fois indique à NVDA que cette cellule est la première de la colonne contenant les titres de lignes, qui devraient être annoncés automatiquement en naviguant entre les lignes après cette colonne. Appuyer deux fois permet d'effacer le paramétrage.| + + +Ces paramètres seront enregistrés dans le document comme plages de noms définis, compatibles avec d'autres revues d'écran comme JAWS. +Cela signifie que d'autres utilisateurs de revues d'écran ouvrant ce document ultérieurement auront automatiquement les titres des lignes et colonnes déjà définis. + +#### La Liste d'Éléments {#ExcelElementsList} + +Comme sur le web, NVDA a une liste d'éléments pour Microsoft Excel permettant d'accéder à différents types d'informations. + +Pour accéder à la liste d'éléments sous Excel, pressez NVDA+f7. + +Les différents types d'informations disponibles dans la liste d'éléments sont : + +* Diagrammes : Ceci liste tous les diagrammes dans la feuille de travail active. +Sélectionner un diagramme et appuyer sur la touche Entrée ou le bouton "Aller à" amène le focus au diagramme pour naviguer et lire avec les flèches. +* Commentaires : Ceci liste toutes les cellules de la feuille de travail active contenant des commentaires. +L'adresse de la cellule et ses commentaires sont présentés pour chaque cellule. +L'appui sur la touche Entrée ou le bouton Aller à sur un commentaire de la liste vous amènera directement à cette cellule. +* Formules : Ceci liste toutes les cellules de la feuille de travail contenant une formule. +L'adresse de la cellule et sa formule sont présentés pour chaque cellule. +L'appui sur la touche Entrée ou le bouton Aller à sur une formule de la liste vous amènera directement à cette cellule. +* feuilles : Ceci liste toutes les feuilles du classeur. +L'appui sur f2 sur une feuille de la liste vous permet de renommer cette feuille. +L'appui sur la touche Entrée ou le bouton Aller à sur une feuille de la liste vous amènera directement à cette feuille. +* Champs de formulaire : Ceci liste tous les champs de formulaire dans la feuille de travail active. +Pour chaque champ de formulaire, la liste d'éléments présente le texte alternatif du champ avec l'adresse des cellules concernées. +La sélection d'un champ de formulaire et l'appui sur entrée ou le bouton Aller à amènent à ce champ en mode navigation. + +#### Annonce des Notes {#ExcelReportingComments} + + +Pour annoncer toute note pour la cellule actuellement en focus, pressez NVDA+alt+c. +Sous Microsoft 2016, 365 et plus récents, les commentaires classiques sous Microsoft Excel ont été renommés en "notes". + +Toutes les notes de la feuille de calcul peuvent aussi être listés dans la liste d'éléments de NVDAaprès appui sur NVDA+f7. + +NVDA peut aussi afficher un dialogue spécifique pour ajouter ou éditer une note particulière. +NVDA remplace la zone d'édition de note originale de MS Excel en raison de contraintes d'accessibilité, mais le raccourci clavier pour afficher le dialogue est hérité de MS Excel et fonctionne aussi sans que NVDA soit actif. + +Pour ajouter ou éditer une note, dans une cellule en focus, pressez maj+f2. + + +Ce raccourci n'apparaît pas et ne peut être remplacé dans le dialogue Geste de Commandes de NVDA. + +Note : il est également possible d'ouvrir la zone d'édition de note de MS Excel par le menu contextuel de n'importe quelle cellule de la feuille de calcul. +Cependant, cela ouvrira la zone d'édition de note inaccessible et non le dialogue spécifique d'édition de commentaire de NVDA. + +Sous Microsoft Office 2016, 365 et plus récents, un nouveau genre de dialogue de commentaire a été ajouté. +Ce dialogue est accessible et apporte plus de fonctionnalités telles que la réponse aux commentaires, etc. +Il peut aussi être ouvert depuis le menu contextuel d'une cellule. +Les commentaires ajoutés au cellules via le nouveau dialogue de commentaire ne sont pas liés aux "notes". + +#### Lecture des Cellules Protégées {#ExcelReadingProtectedCells} + +Si un classeur a été protégé, il peut être impossible d'amener le focus à certaines cellules ayant été protégées en écriture. + +Pour pouvoir aller aux cellules protégées, passer en mode navigation en pressant NVDA+espace, puis utilisez les commandes standards de mouvement d'Excel telles que les flèches pour vous déplacer parmi les cellules de la feuille en cours. + + +#### Champs de Formulaire {#ExcelFormFields} + +Les feuilles de travail Excel peuvent inclure des champs de formulaire. +Vous pouvez y accéder en utilisant la liste d'éléments ou les touches de navigation rapide f et maj+f. +Quand vous êtes sur un champ de formulaire en mode navigation, vous pouvez appuyer sur Entrée ou Espace pour l'activer ou passer en mode formulaire pour pouvoir interagir avec lui, selon le type de contrôle. +Pour plus d'information concernant le mode navigation et la navigation par lettre, veuillez consulter la [section Mode Navigation](#BrowseMode). + +### Microsoft PowerPoint {#MicrosoftPowerPoint} + + + +| Nom |Touche |Description| +|---|---|---| +|Basculer l'arrêt de la lecture vocale |contrôle+maj+s |Lorsque l'on est dans un diaporama en cours de lecture, cette commande basculera entre les notes du commentateur du diaporama et le contenu de celui-ci. Cela n'affecte que ce que NVDA lira, pas l'affichage à l'écran.| + + + +### Foobar2000 {#Foobar2000} + + + +| Nom |Touche |Description| +|---|---|---| +|Annonce du temps restant |contrôle+maj+r |Annonce le temps restant pour le morceau en cours.| +|Annonce du temps écoulé |contrôle+maj+e |annonce le temps écoulé de la piste en cours.| +|Annonce de la longueur de la piste |contrôle+maj+t |Annonce la longueur de la piste en cours.| + + + +Note : Les raccourcis ci-dessus fonctionnent seulement avec le format de chaîne par défaut pour la barre d'état de Foobar. + +### Miranda IM {#MirandaIM} + + + +| Nom |Touche |Description| +|---|---|---| +|Annonce de message récent |NVDA+contrôle+1-4 |Annonce un des messages récents selon le chiffre appuyé ; ex : NVDA+contrôle+2 lit le second message le plus récent.| + + + +### Poedit {#Poedit} + +NVDA offre un support amélioré pour Poedit 3.4 ou plus récent. + + + +| Nom |Touche |Description| +|---|---|---| +|Annonce des notes pour les traducteurs |`contrôle+maj+a` |Annonce les notes pour les traducteurs. Deux appuis présente les notes en mode navigation| +|Annonce de la fenêtre de commentaires |`contrôle+maj+c` |Annonce tout commentaire dans la fenêtre de commentaires. Deux appuis présente le commentaire en mode navigation| +|Annonce de l'ancien texte source |`contrôle+maj+o` |Annonce l'ancien texte source s'il y en a un. Deux appuis présente le texte en mode navigation| +|Annonce l'avertissement de traduction |`contrôle+maj+w` |Annonce l'avertissement de traduction, s'il y en a un. Deux appuis présente l'avertissement en mode navigation| + + + +### Kindle pour PC {#Kindle} + +NVDA supporte la lecture et la navigation dans les livres sous Amazon Kindle pour PC. +Cette fonctionnalité est disponible seulement dans les livres Kindle signalés par "Support des revues d'écran", ce que vous pouvez vérifier sur la page de détails du livre. + +On utilise le mode navigation pour lire les livres. +Il est activé automatiquement quand vous ouvrez un livre ou quand vous placez le focus sur la zone du livre. +La page sera tournée automatiquement quand vous déplacerez le curseur ou utiliserez la commande dire tout. + +Vous pouvez aller manuellement à la page suivante en pressant la touche PageSuiv ou à la page précédente en pressant la touche PagePrec. + + +La navigation par simple lettre est supportée pour les liens et les graphiques, mais seulement dans la page en cours. +La navigation par liens inclut également les notes de bas de page. + +NVDA fournit une ébauche de support pour la lecture et la navigation interactive de contenu mathématique pour les livres avec du contenu mathématique accessible. +Veuillez consulter la section [Lecture de Contenu Mathématique](#ReadingMath) pour plus d'informations. + +#### Sélection de Texte {#KindleTextSelection} + +Kindle vous permet d'exécuter diverses fonctions relatives au texte sélectionné, incluant l'obtention d'une définition du dictionnaire, l'ajout de notes et de surlignages, la copie du texte dans le presse-papiers et la recherche sur le web. +Pour faire cela, sélectionnez d'abord le texte comme vous le feriez normalement en mode navigation; ex: en utilisant maj et les touches curseur. + +Une fois que vous avez sélectionné le texte, pressez la touche applications ou maj+f10 pour afficher les options disponibles pour travailler avec la sélection. + +Si vous faites ceci sans avoir sélectionné de texte, les options pour le mot sous le curseur seront affichées. + +#### Notes de l'Utilisateur {#KindleUserNotes} + +Vous pouvez ajouter une note concernant un mot ou un passage du texte. +Pour faire cela, sélectionnez d'abord le texte concerné et accédez aux options de sélection comme décrit plus haut. +Ensuite, choisissez Ajouter une Note. + +Durant la lecture en mode navigation, NVDA fait référence à cette note comme un commentaire. + +Pour afficher, éditer ou effacer une note. + +1. Amenez le curseur au texte contenant la note. +1. Accédez aux options de sélection comme décrit plus haut. +1. Choisissez Éditer la Note. + +### Azardi {#Azardi} + + +Quand vous êtes dans le tableau des livres ajoutés : + +| Nom |Touche |Description| +|---|---|---| +|Entrée |entrée |Ouvre le livre sélectionné.| +|Menu contextuel |applications |Ouvre le menu contextuel pour le livre sélectionné.| + + + +### Console Windows {#WinConsole} + +NVDA fournit un support pour la console de commande de Windows utilisée par l'invite de commandes, PowerShell, et le sous-système Windows pour Linux. +La console Windows est de taille fixe, typiquement beaucoup plus petite que le tampon contenant l'affichage. +Quand du nouveau texte est écrit, le contenu défile vers le haut et le texte précédent n'est plus visible. +Sur les versions de Windows antérieures à Windows 11 22H2, le texte de la console qui n'est pas visiblement affiché dans la fenêtre n'est pas accessible avec les commandes de revue de texte de NVDA. +Ainsi, il est nécessaire de faire défiler la fenêtre de la console pour lire le texte plus ancien. +Dans les versions plus récentes de la console et dans Windows Terminal, il est possible de consulter librement l'intégralité du tampon de texte sans avoir à faire défiler la fenêtre. + +Les raccourcis clavier propres à Windows suivants peuvent être utiles pour [revoir du texte](#ReviewingText) avec NVDA dans les versions plus anciennes de la Console Windows : + +| Nom |Touche |Description| +|---|---|---| +|Défilement vers le haut |contrôle+flècheHaute |Fait défiler la fenêtre de la console vers le haut pour que le texte plus ancien puisse être lu.| +|Défilement vers le bas |contrôle+flècheBasse |Fait défiler la fenêtre de la console vers le bas pour que le texte plus récent puisse être lu.| +|Aller au début |contrôle+début |Aligne la fenêtre de la console sur le début du tampon.| +|Aller à la fin |contrôle+fin |Aligne la fenêtre de la console sur la fin du tampon.| + + + +## Configurer NVDA {#ConfiguringNVDA} + +La plupart des paramètres de NVDA peuvent être modifiés en utilisant les dialogues accessibles par le sous-menu "Préférences" du menu NVDA. +Beaucoup de ces paramètres se trouvent dans le dialogue multipage [Paramètres](#NVDASettings). +Dans tous les dialogues, appuyez sur le bouton "OK" pour valider vos modifications. +Pour annuler les modifications, appuyez sur le bouton "Annuler" ou sur la touche "échap". +Pour certains dialogues, vous pouvez activer le bouton Appliquer pour que les paramètres prennent effet immédiatement sans fermer le dialogue. +La plupart des dialogue NVDA prennent en charge l'aide contextuelle. + +Dans un dialogue, un appui sur `f1` ouvre le guide de l'utilisateur au paragraphe relatif au paramètre sélectionné ou au dialogue actuel. + +Certains paramètres peuvent aussi être modifiés en utilisant des raccourcis clavier que vous trouverez dans les sections ci-dessous. + +### Paramètres de NVDA {#NVDASettings} + + +NVDA fournit de nombreux paramètres de configuration qui peuvent être modifiés à l'aide de la boîte de dialogue des paramètres. +Pour faciliter la recherche du type de paramètres que vous souhaitez modifier, la boîte de dialogue affiche une liste de catégories de configuration parmi lesquelles choisir. +Lorsque vous sélectionnez une catégorie, tous les paramètres qui s'y rapportent s'affichent dans la boîte de dialogue. +Pour vous déplacer entre les catégories, utilisez `tab` ou `maj+tab` pour atteindre la liste des catégories, puis utilisez les touches fléchées haut et bas pour naviguer dans la liste. +De n'importe où dans la boîte de dialogue, vous pouvez également avancer d'une catégorie en appuyant sur `ctrl+tab`, ou reculer d'une catégorie en appuyant sur `maj+ctrl+tab`. + +Une fois que vous avez modifié un ou plusieurs paramètres, les paramètres peuvent être appliqués à l'aide du bouton Appliquer, auquel cas la boîte de dialogue restera ouverte, vous permettant de modifier d'autres paramètres ou de choisir une autre catégorie. +Si vous voulez sauvegarder vos paramètres et fermer le dialogue Paramètres, vous pouvez utiliser le bouton "OK". + +Certaines catégories de paramètres ont un raccourci clavier dédié. +Si on le presse, ce raccourci ouvrira le dialogue Paramètres directement dans cette catégorie particulière. +Par défaut, toutes les catégories ne peuvent pas être atteintes via un raccourci clavier. +Si vous accédez fréquemment à une catégorie qui n'a pas de raccourci dédié, utilisez le dialogue [Geste de Commandes](#InputGestures) pour ajouter un geste personnalisé tel qu'un raccourci clavier ou un geste tactile pour cette catégorie. + +Les catégories de paramètres du dialogue Paramètres sont décrite ci-dessous. + +#### Général {#GeneralSettings} + + + +##### Ouvrir les paramètres généraux {#OpenGeneralSettings} + +Raccourci clavier : `NVDA+contrôle+g` + +La catégorie Général du dialogue Paramètres définit le comportement global de NVDA tel que la langue de l'interface et la vérification des mises à jour. +Elle contient les options suivantes : + +##### Langue {#GeneralSettingsLanguage} + +C'est une liste déroulante qui permet de choisir la langue de l'interface utilisateur et des messages de NVDA. +La liste comporte de nombreuses langues et le choix par défaut est dénommé "Utilisateur par défaut". +Ce choix indique à NVDA d'utiliser la langue de Windows. + +Noter qu'il faut relancer NVDA quand on change la langue. +Quand le dialogue de confirmation apparaît, sélectionnez "redémarrer maintenant" ou "redémarrer plus tard" selon que vous voulez utiliser la nouvelle langue maintenant ou ultérieurement, respectivement. Si "redémarrer plus tard" est sélectionné, la configuration doit être sauvegardée (soit manuellement soit en utilisant la fonctionnalité sauvegarder la configuration en quittant). + +##### Sauvegarder la configuration en quittant {#GeneralSettingsSaveConfig} + +C'est une case à cocher qui, une fois cochée, indique à NVDA de sauvegarder automatiquement la configuration courante lorsqu'on arrête NVDA. + +##### Afficher les options d'arrêt avant de quitter NVDA {#GeneralSettingsShowExitOptions} + +Cette option est une case à cocher qui vous permet de décider si un dialogue doit s'afficher ou non lorsque vous quittez NVDA, pour demander quelle action vous souhaitez effectuer. +Quand elle est cochée, un dialogue apparaît lorsque vous voulez quitter NVDA, vous demandant si vous voulez quitter, redémarrer, redémarrer sans extensions ou installer des mises à jour en attente s'il y en a. +Quand elle n'est pas cochée, NVDA s'arrête immédiatement. + +##### Jouer des sons au démarrage ou à l'arrêt de NVDA {#GeneralSettingsPlaySounds} + +Cette option est une case à cocher qui, quand elle est cochée, dit à NVDA de jouer des sons lors de son démarrage ou de son arrêt. + +##### Niveau de journalisation {#GeneralSettingsLogLevel} + +C'est une liste déroulante qui vous permet de choisir la quantité d'informations que NVDA consignera dans son journal durant son exécution. +Généralement, l'utilisateur n'aura pas besoin d'y toucher dans la mesure où assez peu d'informations sont consignées. +Cependant, si vous voulez fournir des informations lors d'un rapport d'erreur, ou activer/désactiver la journalisation, cette option peut être utile. + +Les niveaux de journalisation disponibles sont : + +* Désactivé : À l'exception d'un bref message de démarrage, NVDA ne journalisera rien durant son exécution. +* Info : NVDA journalisera des informations de base telles que les messages de démarrage et des informations utiles pour les développeurs. +* Avertissements de débogage : Les messages d'avertissement qui ne sont pas causés par des erreurs graves seront journalisés. +* Entrées/sorties : Les entrées du clavier et des terminaux braille, ainsi que les sorties en parole et en braille seront journalisées. +Si la confidentialité vous préoccupe, ne définissez pas le niveau de journalisation sur cette option. +* Débogage : En plus des messages d'info, avertissements et entrées/sorties, des messages additionnels de débogage seront journalisés. +Tout comme pour entrées/sorties, si la confidentialité vous préoccupe, vous ne devez pas définir le niveau de journalisation sur cette option. + +##### Démarrer NVDA automatiquement après ma connexion à Windows {#GeneralSettingsStartAfterLogOn} + +Si cette option est activée, NVDA démarrera automatiquement dès que vous vous connecterez à Windows. +Cette option n'existe que dans les versions installées de NVDA. + +##### Utiliser NVDA sur l'écran de connexion à Windows (nécessite des privilèges administrateur) {#GeneralSettingsStartOnLogOnScreen} + +Si vous vous connectez à Windows en fournissant un nom d'utilisateur et un mot de passe, l'activation de cette option permettra à NVDA de démarrer automatiquement dès l'écran de connexion au démarrage de Windows. +Cette option n'existe que dans les versions installées de NVDA. + +##### Utiliser les paramètres actuellement sauvegardés sur l'écran de connexion et les autres écrans sécurisés {#GeneralSettingsCopySettings} + +L'appui sur ce bouton copie votre configuration utilisateur actuellement sauvegardée dans le répertoire système de NVDA, ainsi, NVDA peut l'utiliser quand il s'exécute sur l'écran de connexion et les [autres écrans sécurisés](#SecureScreens). +Pour vous assurer que tous vos paramètres sont transférés, enregistrez d'abord votre configuration avec contrôle+NVDA+c ou Enregistrer la configuration dans le menu NVDA. +Cette option n'existe que dans les versions installées de NVDA. + +##### Vérifier automatiquement les mises à jour de NVDA {#GeneralSettingsCheckForUpdates} + +Si ceci est activé, NVDA recherchera automatiquement les versions mises à jour et vous informera lorsqu'une mise à jour est disponible. +Vous pouvez également vérifier manuellement les mises à jour en sélectionnant "Recherche d'une Mise à Jour..." sous "Aide" du menu NVDA. +Lors d'une vérification manuelle ou automatique des mises à jour, NVDA doit envoyer certaines informations au serveur pour recevoir la mise à jour appropriée à votre système. +Les informations suivantes sont toujours envoyées : + +* Version courante de NVDA +* Version du système d'exploitation +* Système d'exploitation 32 ou 64 bits + +##### Autoriser NV Access à recueillir des statistiques d'utilisation {#GeneralSettingsGatherUsageStats} + +Si ceci est activé, NV Access utilisera les informations de la vérification de mises à jour pour connaître le nombre d'utilisateurs de NVDA en incluant certaines informations démographiques telles que le système d'exploitation et le pays d'origine. +Bien que votre adresse IP soit utilisée pour déterminer votre pays durant la mise à jour, elle ne sera jamais conservée. +En plus des informations obligatoires nécessaires à la mise à jour, les informations supplémentaires suivantes sont également envoyées : + +* La langue d'interface de NVDA +* Copie en cours de NVDA installée ou portables +* Le nom du synthétiseur vocal actuellement utilisé (incluant le nom de l'extension dont provient le pilote) +* Le nom du terminal braille actuellement utilisé (incluant le nom de l'extension dont provient le pilote) +* La table d'affichage braille en cours (si le braille est activé) + +Ces informations aident grandement NV Access pour prioritiser les futurs développements de NVDA. + +##### Avertir des mises à jour en attente au démarrage {#GeneralSettingsNotifyPendingUpdates} + +Si ceci est activé, NVDA vous informera quand il y a une mise à jour en attente au démarrage, et vous offrira la possibilité de l'installer. +Vous pouvez aussi installer manuellement la mise à jour en attente depuis le dialogue de sortie de NVDA (si activé), depuis le menu NVDA, ou quand vous exécutez une vérification depuis le menu Aide. + +#### Parole {#SpeechSettings} + + + +##### Ouvrir les paramètres de parole {#OpenSpeechSettings} + +Raccourci clavier : `NVDA+contrôle+v` + +La catégorie "Parole" dans le dialogue Paramètres de NVDA, contient des options vous permettant de changer le synthétiseur vocal ainsi que les caractéristiques de la voix pour le synthétiseur choisi. +Pour une manière plus rapide de contrôler les paramètres vocaux depuis n'importe où, reportez-vous à la section [boucle des paramètres synthétiseur](#SynthSettingsRing). + +La catégorie Parole contient les options suivantes : + +##### Changer de synthétiseur {#SpeechSettingsChange} + +La première option dans la catégorie Parole est le bouton Changer... Ce bouton active le dialogue [Choisir le Synthétiseur](#SelectSynthesizer) qui vous permet de choisir le synthétiseur actif et le périphérique de sortie. +Ce dialogue s'ouvre par-dessus le dialogue Paramètres. +Sauvegarder ou annuler les paramètres dans le dialogue de choix du synthétiseur vous ramènera au dialogue Paramètres. + +##### Voix {#SpeechSettingsVoice} + +L'option Voix est une liste déroulante contenant, pour le synthétiseur en cours, toutes les voix que vous avez installées. +Vous pouvez utiliser les flèches pour entendre les différents choix possibles. +Les flèches gauche et haut vous font monter dans la liste et les flèches droit et bas vous font descendre. + +##### Variante {#SpeechSettingsVariant} + +Si vous utilisez le synthétiseur Espeak NG fourni avec NVDA, cette liste déroulante vous permettra de choisir la variante avec laquelle le synthétiseur doit parler. +Les variantes ESpeak NG sont comme des voix, dans la mesure où elles ajoutent des attributs légèrement différents à la voix ESpeak NG. +Certaines variantes ressembleront à un homme, d'autres à une femme, d'autres même à une grenouille. +Si vous utilisez un synthétiseur tiers, vous pourrez peut-être changer cette valeur aussi, si la voix que vous aurez choisie prend cela en charge. + +##### Débit {#SpeechSettingsRate} + +Cette option vous permet de modifier le débit de la parole. +C'est un potentiomètre qui va de 0 à 100, (0 étant la vitesse la plus lente et 100 la plus rapide). + +##### Débit augmenté {#SpeechSettingsRateBoost} + +Activer cette option augmentera significativement le débit de la parole, si le synthétiseur courant le permet. + +##### Hauteur {#SpeechSettingsPitch} + +Cette option vous permet de modifier la hauteur de la voix. +C'est un potentiomètre qui va de 0 à 100 - 0 étant le son le plus grave et 100 le plus aigu. + +##### Volume {#SpeechSettingsVolume} + +Cette option est un potentiomètre qui va de 0 à 100 - 0 étant le volume le plus bas et 100 le plus élevé. + +##### Inflexion {#SpeechSettingsInflection} + +Cette option est un potentiomètre qui vous permet de choisir le degré d'inflexion (augmentation et diminution de la hauteur) que le synthétiseur doit utiliser pour parler. + +##### Changement automatique de langue {#SpeechSettingsLanguageSwitching} + +Cette case à cocher vous permet de choisir si NVDA doit changer de langue à la volée si une balise de langue est présente dans le texte en cours de lecture. +Cette option est activée par défaut. + +##### Changement automatique de dialecte {#SpeechSettingsDialectSwitching} + +Cette case à cocher vous permet de choisir si les changements de dialecte doivent être pris en compte en plus des changements de langue réels. +Par exemple, un texte peut être en Anglais Américain et comporter des passages marqués comme Anglais Britannique. Si cette option est activée, le synthétiseur respectera les changements d'accent. +Par défaut, cette option est désactivée. + + + +##### Niveau des ponctuations et symboles {#SpeechSettingsSymbolLevel} + +Raccourci clavier : NVDA+p + +Ceci vous permet de choisir la quantité de ponctuations et autres symboles qui seront prononcés. +Par exemple, si vous choisissez "Tous", tous les symboles seront annoncés. +Cette option s'applique à tous les synthétiseurs, pas uniquement au synthétiseur courant. + +##### Se baser sur la langue de la voix pour le traitement des symboles et caractères {#SpeechSettingsTrust} + +Activée par défaut, cette option indique à NVDA si la langue de la voix en cours peut être utilisée pour le traitement des symboles et caractères. +Si vous trouvez que NVDA lit les ponctuations dans la mauvaise langue pour une voix ou un synthétiseur particulier, vous pouvez désactiver ce comportement pour forcer NVDA à utiliser ses paramètres généraux de langue à la place. + +##### Inclure les données du Consortium Unicode (incluant les emoji) dans le traitement des caractères et symboles {#SpeechSettingsCLDR} + +Quand cette case est cochée, NVDA inclura des dictionnaires de prononciation de symboles additionels lorsqu'il prononce des caractères et des symboles. +Ces dictionnaires contiennent des descriptions de symboles (en particulier les emoji) qui sont fournies par le [Consortium Unicode](https://www.unicode.org/consortium/) comme faisant partie de leur [référentiel commun de données locales Repository](https://cldr.unicode.org/). +Si vous voulez que NVDA annonce la descriptions des caractères emoji en se basant sur ces données, vous devez activer cette option. +Cependant, si vous utilisez un synthétiseur vocal supportant nativement ces descriptions, vous pouvez la désactiver. + +Notez que les descriptions de caractères ajoutées manuellement ou modifiées sont sauvegardées dans vos paramètres personnels. +Ainsi, si vous changez la description d'un emoji particulier, votre description personnalisée sera annoncée pour cet emoji que cette option soit activée ou non. +Vous pouvez ajouter, modifier ou supprimer des descriptions de symboles par le dialogue [Prononciation des ponctuations et symboles](#SymbolPronunciation) de NVDA. + +Pour activer/désactiver l'inclusion des données du Consortium Unicode de n'importe où, veuillez assigner un geste personnalisé en utilisant le [dialogue des Gestes de Commandes](#InputGestures). + +##### Pourcentage de changement de la hauteur pour indiquer les majuscules {#SpeechSettingsCapPitchChange} + +Ce champ d'édition vous permet d'entrer la valeur du changement de hauteur de la voix à l'annonce d'une lettre majuscule. +Cette valeur est un pourcentage, une valeur négative réduit la hauteur, une valeur positive l'augmente. +Pour n'avoir aucun changement de hauteur, entrez la valeur 0. +D'ordinaire, NVDA augmente légèrement la tonalité pour chaque lettre majuscule, mais certains synthétiseurs peuvent ne pas supporter cela correctement. +Si le changement de hauteur pour les majuscules n'est pas supporté, optez pour [Dire "majuscule" après les majuscules](#SpeechSettingsSayCapBefore) et/ou [ Émettre un bip pour signaler les majuscules](#SpeechSettingsBeepForCaps) à la place. + +##### Dire "majuscule" après les majuscules {#SpeechSettingsSayCapBefore} + +Ce paramètre est une case à cocher qui, si cochée, indique à NVDA de dire "maj" pour une lettre en majuscule quand on l'atteint par les flèches de direction ou lors de la frappe. + +##### Annoncer les majuscules par des bips {#SpeechSettingsBeepForCaps} + +Quand cette case à cocher est cochée, NVDA émettra un petit "bip" chaque fois qu'il rencontre un caractère majuscule. + +##### Utiliser la fonction d'épellation si elle est supportée {#SpeechSettingsUseSpelling} + +Certains mots ne comportent qu'un seul caractère, mais la prononciation est différente selon que le caractère est prononcé comme un caractère unique (épellation) ou comme un mot. +Par exemple, en Français, "y" est à la fois une lettre et un mot et se prononce différemment selon le cas. +Cette option permet au synthétiseur de différencier les deux cas si le synthétiseur la supporte. +La plupart des synthétiseurs la supportent. + +En général, cette option devrait être activée. +Cependant, certains synthétiseurs utilisant les API de parole Microsoft se comportent bizarrement quand cette option est activée. +Si vous rencontrez des problèmes à l'épellation de caractères, essayez de désactiver cette option. + +##### Description différée des caractères lors du mouvement du curseur {#delayedCharacterDescriptions} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Activé, Désactivé| +|Défaut |Désactivé| + +Lorsque ce paramètre est coché, NVDA dira la description du caractère lorsque vous vous déplacerez par caractère. + +Par exemple, lors de la revue d'une ligne par caractères, lorsque la lettre "b" est lue, NVDA dira "Bravo" après un délai d'une seconde. +Cela peut être utile s'il est difficile de distinguer la prononciation des symboles ou pour les utilisateurs malentendants. + +La description différée du caractère sera annulée si un autre texte est prononcé pendant ce temps, ou si vous appuyez sur la touche `contrôle`. + +##### Modes disponibles dans la commande Faire défiler les modes de parole {#SpeechModesDisabling} + +Les cases à cocher dans cette liste vous permettent de choisir quels [modes de parole](#SpeechModes) sont inclus lors du passage de l'un à l'autre en utilisant `NVDA+s`. +Les modes non cochés sont exclus. +Par défaut, tous les modes sont inclus. + +Par exemple, si vous n'avez pas besoin d'utiliser les modes "bips" et "désactivée", vous devez décocher ces deux modes et laisser cochés les modes "activée" et "à la demande". +A noter qu'il est nécessaire de cocher au moins deux modes. + +#### Choix du synthétiseur {#SelectSynthesizer} + + + +##### Ouvrir le dialogue sélection du synthétiseur {#OpenSelectSynthesizer} + +Raccourci clavier : `NVDA+contrôle+s` + +Le dialogue Synthétiseur, qui s'ouvre en activant le bouton Changer dans la catégorie Parole du dialogue Paramètres, permet de choisir le synthétiseur de parole qui sera utilisé par NVDA. +Une fois que vous aurez choisi votre synthétiseur, appuyez sur "OK" et NVDA chargera le synthétiseur choisi. +S'il y a une erreur au chargement du synthétiseur, NVDA vous en informera par un message, puis continuera à utiliser le synthétiseur précédent. + +##### Synthétiseur {#SelectSynthesizerSynthesizer} + +Cette option vous permet de choisir le synthétiseur de parole qui sera utilisé par NVDA. + +Pour une liste des synthétiseurs de parole pris en charge par NVDA, reportez-vous à la section [Synthétiseurs de parole pris en charge](#SupportedSpeechSynths). + +L'élément particulier "Pas de parole" apparaîtra toujours dans cette liste. +Cela peut être utile pour quelqu'un qui veut utiliser NVDA seulement avec le braille, ou peut-être pour un développeur voyant qui ne veut utiliser que la visionneuse de parole. + +#### Boucle des paramètres synthétiseur {#SynthSettingsRing} + +Si vous voulez changer rapidement les paramètres vocaux sans passer par la catégorie Voix du dialogue Paramètres, il y a quelques touches de commandes qui vous permettent de le faire de n'importe où quand NVDA est en fonction. + + +| Nom |Ordinateur de bureau |Ordinateur portable |Description| +|---|---|---|---| +|Aller au paramètre synthétiseur suivant |NVDA+contrôle+flèche droite |NVDA+contrôle+maj+flèche droite |Va au paramètre synthétiseur applicable suivant, retourne au premier après le dernier| +|Aller au paramètre synthétiseur précédent |NVDA+contrôle+flèche gauche |NVDA+contrôle+maj+flèche gauche |Va au paramètre synthétiseur applicable précédent, retourne au dernier après le premier| +|Augmenter le paramètre synthétiseur courant |NVDA+contrôle+flèche haut |NVDA+contrôle+maj+flèche haut |Augmente le paramètre synthétiseur sur lequel vous vous trouvez. Ex : augmente le débit, choisit la voix suivante, augmente le volume| +|Augmenter le paramètre courant dans la boucle des paramètres du synthétiseur d'un interval plus important |`NVDA+contrôle+pagePrec` |`NVDA+maj+contrôle+pagePrec` |Augmente d'un pas plus important la valeur du paramètre vocal courant sur lequel vous vous trouvez. Ex. lorsque vous êtes sur le paramètre du choix de la voix, avancer de 20 voix ; lorsque vous êtes sur un paramètres avec potentiomètre (débit, hauteur, etc.), la valeur sera incrémentée de 20%| +|Diminuer le paramètre synthétiseur courant |NVDA+contrôle+flèche bas |NVDA+contrôle+maj+flèche bas |diminue le paramètre synthétiseur sur lequel vous vous trouvez. Ex : diminue le débit, choisit la voix précédente, diminue le volume| +|Diminuer le paramètre courant dans la boucle des paramètres du synthétiseur d'un interval plus important |`NVDA+contrôle+pageSuiv` |`NVDA+maj+contrôle+pageSuiv` |Diminue d'un pas plus important la valeur du paramètre vocal courant sur lequel vous vous trouvez. Ex. lorsque vous êtes sur le paramètre du choix de la voix, reculer de 20 voix ; lorsque vous êtes sur un paramètres avec potentiomètre (débit, hauteur, etc.), la valeur sera décrémentée de 20%| + + + +#### Braille {#BrailleSettings} + +La catégorie Braille du dialogue Paramètres contient des options vous permettant de modifier différents aspect de la saisie et de l'affichage braille. +Cette catégorie contient les options suivantes : + +##### Changer de Terminal Braille {#BrailleSettingsChange} + +Dans la catégorie Braille du dialogue Paramètres, le bouton Changer... active le dialogue [Choix de l'Afficheur Braille](#SelectBrailleDisplay) qui vous permet de choisir l'afficheur braille actif. +Ce dialogue s'ouvre par-dessus le dialogue Paramètres. +Sauvegarder ouannuler les paramètres dans le dialogue de choix de l'afficheur braille vous ramènera au dialogue Paramètres. + +##### Table d'affichage {#BrailleSettingsOutputTable} + +L'option suivante est la liste déroulante des tables d'affichage. +Dans cette liste, vous trouverez des tables braille pour différentes langues, braille intégral, informatique, abrégé et autres. +La table choisie sera utilisée pour traduire le texte en braille qui sera présenté sur votre afficheur braille. +Vous pouvez vous déplacer de table en table en utilisant les flèches. + +##### Table de saisie {#BrailleSettingsInputTable} + +En complément de l'option précédente, l'option que vous trouverez ensuite est la liste déroulante des tables de saisie. +La table choisie sera utilisée pour traduire en texte le braille saisi à l'aide du clavier Perkins de votre afficheur braille. +Vous pouvez vous déplacer de table en table en utilisant les flèches. + +Notez que cette option n'est utile que si votre afficheur braille dispose d'un clavier Perkins et que le pilote de celui-ci supporte cette fonctionnalité. +Si la saisie n'est pas supportée par un afficheur qui dispose d'un clavier Perkins, cela sera noté dans la section [Afficheurs braille Supportés](#SupportedBrailleDisplays). + + + +##### Mode braille {#BrailleMode} + +Raccourci clavier : `NVDA+alt+t` + +Cette option vous permet de choisir entre les modes braille disponibles. + +Actuellement, deux modes braille sont pris en charge : "suivre les curseurs" et "afficher la parol". + +Lorsque suivre les curseurs est sélectionné, l'afficheur braille suivra soit le focus / le curseur système, soit l'objet navigateur / curseur de revue en fonction de ce que le braille doit suivre. + +Lorsque l'affichage de la parole est sélectionné, l'afficheur braille affichera ce que NVDA annonce, ou aurait annoncé si le mode de parole était réglé sur "parole activée". + +##### Afficher le mot sous le curseur en braille informatique {#BrailleSettingsExpandToComputerBraille} + +Cette option permet d'afficher le mot sous le curseur en intégral. + +##### Montrer le Curseur {#BrailleSettingsShowCursor} + +Cette option permet d'activer ou de désactiver l'affichage du curseur braille. +Elle s'applique au curseur système et au curseur de revue, mais pas à l'indicateur de sélection. + +##### Clignotement du Curseur {#BrailleSettingsBlinkCursor} + +Cette option permet au curseur braille de clignoter. +Si le clignotement est désactivé, le curseur braille sera constamment en position haute. +L'indicateur de sélection n'est pas affecté par cette option, c'est toujours les points 7 et 8 sans clignotement. + +##### Vitesse de clignotement du curseur (ms) {#BrailleSettingsBlinkRate} + +Cette option est un champ numérique qui vous permet de modifier la vitesse de clignotement du curseur en millisecondes. + +##### Forme du Curseur pour le Focus {#BrailleSettingsCursorShapeForFocus} + +Cette option vous permet de choisir la forme (combinaison de points) du curseur braille quand le braille suit le focus. +L'indicateur de sélection n'est pas affecté par cette option, c'est toujours les points 7 et 8 sans clignotement. + +##### Forme du Curseur pour la Revue {#BrailleSettingsCursorShapeForReview} + +Cette option vous permet de choisir la forme (combinaison de points) du curseur braille quand le braille suit la revue. +L'indicateur de sélection n'est pas affecté par cette option, c'est toujours les points 7 et 8 sans clignotement. + +##### Affichage des messages {#BrailleSettingsShowMessages} + +C'est une liste déroulante qui vous permet de choisir si NVDA doit afficher les messages en braille et quand ils doivent disparaître automatiquement. + +Pour basculer l'affichage des messages de n'importe où, veuillez attribuer un geste personnalisé à l'aide de la [boîte de dialogue Gestes de commandes](#InputGestures). + +##### Durée d'affichage des messages (sec) {#BrailleSettingsMessageTimeout} + +Cette option est un champ numérique qui contrôle la durée en secondes d'affichage des messages système sur le terminal braille. +Le message de NVDA est immédiatement supprimé à l'appui d'une touche de routage curseur sur l'afficheur braille, mais réapparaît à l'appui d'une touche correspondante qui déclenche le message. +Cette option n'apparaît que si "Affichage des message" est réglé sur "Définir une durée maximale". + + + +##### braille suit {#BrailleTether} + +Raccourci clavier : NVDA+contrôle+t + +Cette option vous permet de choisir si le braille suivra le curseur du focus système, le curseur de l'objet navigateur ou les deux. +Quand "automatiquement" est sélectionné, NVDA suivra le curseur système et le focus par défaut. +Dans ce cas, quand la position de l'objet de navigation ou du curseur de revue est modifiée par une action explicite de l'utilisateur, NVDA suivra temporairement la revue, jusqu'à ce que le focus ou le curseur système change. +Si vous voulez qu'il ne suive que le focus et le curseur, vous devez configurer le braille pour qu'il suive le focus. +Dans ce cas, le braille ne suivra pas le navigateur NVDA durant la navigation par objet ou le curseur de revue durant la revue. +Si vous voulez que le braille suive la navigation par objet et la revue de texte, vous devez configurer le braille pour qu'il suive la revue. +Dans ce cas, le braille ne suivra pas le focus système et le curseur système. + +##### Déplacer le curseur système lors du routage du curseur de revue {#BrailleSettingsReviewRoutingMovesSystemCaret} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Défaut (Jamais), Jamais, Seulement quand le braille suit automatiquement, Toujours| +|Défaut |Jamais| + +Ce paramètre détermine si le curseur système doit également être déplacé lors d'un appui sur une touche de routage du curseur. +Cette option est définie sur Jamais par défaut, ce qui signifie que le routage ne déplacera jamais le curseur système lors du routage du curseur de revue. + +Lorsque cette option est définie sur Toujours et que [Le braille suit](#BrailleTether) est défini sur "automatiquement" ou "la revue", un appui sur une touche de routage du curseur déplacera également le curseur système ou le focus lorsqu'il est pris en charge. +Lorsque le mode de revue actuel est [Revue de l'écran](#ScreenReview), il n'y a pas de curseur physique. +Dans ce cas, NVDA essaie de deplacer le focus à l'objet sous le texte vers lequel vous routez le curseur de revue. +Il en va de même pour le mode de [Revue par objet](#ObjectReview). + +Vous pouvez également définir cette option pour ne déplacer le curseur que lorsque "Le braille suit" est défini sur "automatiquement". +Dans ce cas, un appui sur une touche de routage du curseur ne déplacera le curseur système ou le focus que lorsque NVDA est automatiquement attaché au curseur de revue, alors qu'aucun mouvement ne se produira lorsqu'il sera manuellement attaché au curseur de revue. + +Cette option est uniquement active si "[Le braille suit](#BrailleTether)" est défini sur "automatiquement" ou sur "la revue". + +Pour parcourir les modes de déplacement du curseur système lors du routage du curseur de revue depuis n'importe où, veuillez attribuer un geste personnalisé à l'aide de la [boîte de dialogue Gestes de commandes](#InputGestures). + +##### Lecture par paragraphe {#BrailleSettingsReadByParagraph} + +Si cette option est activée, le braille sera affiché par paragraphe au lieu d'être affiché par ligne. +De la même manière, les commandes de ligne précédente et ligne suivante navigueront par paragraphe. +Cela signifie que vous n'aurez pas besoin de faire défiler l'afficheur à la fin de chaque ligne même si plus de texte peut entrer sur l'afficheur. +Cela permet une lecture plus fluide des textes volumineux. +Par défaut, cette option est désactivée. + +##### Ne pas couper les mots quand c'est possible {#BrailleSettingsWordWrap} + +Si cette option est activée, un mot trop long pour entrer à la fin de l'afficheur braille ne sera pas coupé. +À la place, il y aura des espaces à la fin de l'affichage. +En faisant défiler l'affichage, vous pourrez lire le mot entier. +Ceci est parfois appelé retour automatique à la ligne. +Notez que si le mot est trop long pour entrer sur l'afficheur, il devra quand-même être coupé. + +Si cette option est désactivée, le plus possible du mot sera affiché sur la ligne, mais le reste sera coupé. +En faisant défiler l'affichage, vous pourrez lire le reste du mot. + +Activer cette option peut rendre la lecture plus fluide mais vous obligera à faire défiler plus souvent. + +##### Afficher le contexte du focus {#BrailleSettingsFocusContextPresentation} + +Cette option vous permet de choisir quelles informations contextuelles NVDA affiche en braille quand un objet prend le focus. +Les informations contextuelles font référence à la hiérarchie d'objets contenant le focus. +Par exemple, quand vous focalisez un élément de liste, celui-ci fait partie d'une liste. +Cette liste pourrait être contenue dans un dialogue, etc. +Veuillez consulter la section [navigation par objets](#ObjectNavigation) pour plus d'informations sur la hiérarchie qui s'applique aux objets dans NVDA. + +Quand l'option est sur "Seulement lors d'un changement de contexte", NVDA essaie d'afficher autant d'informations contextuelles que possible sur le terminal braille, mais seulement pour les parties du contexte qui ont changé. +Dans l'exemple ci-dessus, cela signifie que quand le focus est sur la liste, NVDA affiche l'élément de liste sur le terminal braille. +De plus, s'il y a assez de place libre sur le terminal braille, NVDA essaie de montrer que l'élément de liste fait partie d'une liste. +Si vous commencer à vous déplacer dans la liste avec les flèches, on suppose que vous savez que vous êtes toujours dans la liste +Ainsi, pour les autres éléments de la liste que vous focalisez, NVDA affiche seulement l'élément de liste focalisé sur le terminal. +Si vous voulez lire à nouveau le contexte (ex : si vous êtes dans une liste et que la liste fait partie d'un dialogue), vous devrez activer le défilement arrière de votre terminal braille. + +Quand l'option est sur "Toujours", NVDA essaie d'afficher autant d'informations contextuelles que possible sur le terminal braille, même si vous avez déjà vu les mêmes informations précédemment. +L'avantage est que NVDA essaie de mettre autant d'informations que possible sur le terminal. +Cependant, l'inconvénient est que le focus ne démarre pas toujours à la même position sur l'afficheur braille. +Cela peut rendre difficile le parcours d'une longue liste d'éléments, car vous devrez en permanence déplacer vos doigts pour trouver le début de chaque élément. +C'était le comportement par défaut jusqu'à NVDA 2017.2. + +Quand l'option est sur "Seulement lors du défilement arrière", NVDA ne montre jamais les informations contextuelles sur le terminal. +Ainsi, dans l'exemple ci-dessus, NVDA affiche l'élément de liste que vous avez focalisé. +Cependant, si vous voulez lire le contexte (ex : que vous êtes dans une liste et que la liste fait partie d'un dialogue), vous devrez activer le défilement arrière de votre terminal. + +Pour modifier l'option "Afficher le contexte du focus" de n'importe où, veuillez assigner un geste de commande personnalisé en utilisant [le dialogue Gestes de Commandes](#InputGestures). + +##### Interrompre la parole pendant le défilement {#BrailleSettingsInterruptSpeech} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Défaut (Activé), Activé, Désactivé| +|Défaut |Activé| + +Ce paramètre détermine si la parole doit être interrompue lorsque l'afficheur braille défile vers l'arrière/vers l'avant. +Les commandes de ligne précédente/suivante interrompent toujours la parole. + +La parole en cours peut être une distraction lors de la lecture du braille. +Pour cette raison, l'option est activée par défaut, interrompant la parole lors du défilement du braille. + +La désactivation de cette option permet d'entendre la parole tout en lisant simultanément le braille. + +##### Afficher la sélection {#BrailleSettingsShowSelection} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Défaut (Activé), Activé, Désactivé| +|Défaut |Activé| + +Ce réglage détermine si l'indicateur de sélection (points 7 et 8) s'affiche sur l'afficheur braille. +L'option est activée par défaut, donc l'indicateur de sélection est affiché. +L'indicateur de sélection peut être une distraction lors de la lecture. +La désactivation de cette option peut améliorer la lisibilité. + +Pour basculer l'affichage de la sélection de n'importe où, veuillez attribuer un geste personnalisé à l'aide de la [boîte de dialogue Gestes de commandes](#InputGestures). + +#### Choisir l'afficheur braille {#SelectBrailleDisplay} + + + +##### Ouvrir le dialogue de sélection de l'afficheur braille {#OpenSelectBrailleDisplay} + +Raccourci clavier : `NVDA+contrôle+a` + +Le dialogue Choisir l'Afficheur Braille, qui peut être ouvert en activant le bouton Changer... dans la catégorie Braille du dialogue Paramètres, vous permet de choisir l'afficheur Braille qui sera utilisé par NVDA. +Quand vous aurez choisi votre afficheur braille, vous pourrez presser le bouton OK et NVDA chargera l'afficheur sélectionné. +S'il y a une erreur au chargement du pilote de l'afficheur, NVDA vous avertira par un message et continuera à utiliser l'afficheur précédent si défini. + +##### Terminal braille {#SelectBrailleDisplayDisplay} + +Cette liste déroulante vous présente plusieurs options en fonction des pilotes d'afficheurs brailles présents sur votre système. +Déplacez-vous entre les options en utilisant les flèches. + +L'option automatique permet à NVDA de rechercher beaucoup de terminaux braille en arrière-plan. +Quand cette fonctionnalité est activée et que vous connectez un terminal braille supporté via USB ou Bluetooth, NVDA se connectera automatiquement à ce terminal. + +Pas de braille signifie que vous n'utilisez pas le braille. + +Reportez-vous à la section [Terminaux braille pris en charge](#SupportedBrailleDisplays) pour les informations concernant les terminaux braille et ceux qui supportent la détection automatique en arrière-plan. + +##### Afficheurs à détecter automatiquement {#SelectBrailleDisplayAutoDetect} + +Lorsque l'afficheur braille est réglé sur "Automatique", les cases à cocher de ce contrôle de liste vous permettent d'activer et de désactiver les pilotes d'affichage qui seront impliqués dans le processus de détection automatique. +Cela vous permet d'exclure les pilotes d'afficheur braille que vous n'utilisez pas régulièrement. +Par exemple, si vous possédez uniquement un terminal qui nécessite le pilote Baum pour fonctionner, vous pouvez laisser le pilote Baum activé tandis que les autres pilotes peuvent être désactivés. + +Par défaut, tous les pilotes prenant en charge la détection automatique sont activés. +Tout pilote ajouté, par exemple dans une future version de NVDA ou dans une extension, sera également activé par défaut. + +Veuillez consulter la documentation de votre plage braille dans la section [Afficheurs braille supportés](#SupportedBrailleDisplays) pour vérifier si le pilote prend en charge la détection automatique des afficheurs. + +##### Port {#SelectBrailleDisplayPort} + +Cette option, si disponible, vous permet de choisir quel port ou type de connexion sera utilisé pour communiquer avec l'afficheur braille sélectionné. +C'est une liste déroulante contenant les choix possibles pour votre afficheur braille. + +Par défaut, NVDA emploie la détection automatique, ce qui veut dire que la connexion avec le périphérique braille sera établie automatiquement en recherchant les périphériques USB et Bluetooth connectés à votre ordinateur. +De plus, pour certains afficheurs braille, vous pourrez choisir explicitement le port à utiliser. +Les options communes sont "automatique" (qui spécifie à NVDA d'employer la procédure par défaut), "USB", "Bluetooth" et port série si votre afficheur braille supporte ce type de communication. + +Cette option ne sera pas disponible si votre afficheur braille supporte seulement la détection automatique du port. + +Vous devrez consulter la documentation de votre afficheur braille dans la section [Afficheurs braille supportés](#SupportedBrailleDisplays) pour plus de détails sur les types de communications supportés et les ports disponibles. + +Note : Si vous connectez plusieurs Afficheurs Braille utilisant le même pilote en même temps à votre machine (Ex. connexion de deux afficheurs Seika), +il est actuellement impossible de dire à NVDA quel afficheur utiliser. +Par conséquent, il est recommandé de ne connecter qu'un seul afficheur braille d'un type/fabricant donné à votre machine à la fois. + +#### Audio {#AudioSettings} + + + +##### Ouvrir les paramètres audio {#OpenAudioSettings} + +Raccourci clavier : `NVDA+contrôle+u` + +La catégorie Audio du dialogue des Paramètres de NVDA contient des options qui vous permettent de modifier plusieurs aspects de la sortie audio. + +##### Sortie audio {#SelectSynthesizerOutputDevice} + +Cette option vous permet de choisir le périphérique audio par lequel NVDA doit indiquer au synthétiseur sélectionné de parler. + + + +##### Mode d'Atténuation Audio {#SelectSynthesizerDuckingMode} + +Raccourci clavier : `NVDA+maj+d` + +Cette option vous permet de choisir si NVDA doit baisser le volume des autres applications quand il parle, ou tout le temps quand il est en cours d'exécution. + +* Ne jamais atténuer : NVDA ne baissera jamais le volume des autres applications. +* Atténuer les autres sources quand NVDA parle : NVDA ne baissera le son des autres applications que quand il parle ou émet un son. Ceci peut ne pas fonctionner avec tous les synthétiseurs. +* Toujours atténuer : NVDA réduira le son des autres applications tout le long de son exécution. + +Cette option n'est disponible que si NVDA a été installé. +Il n'est pas possible de supporter l'atténuation audio pour les versions portables et temporaires de NVDA. + +##### Le volume des sons NVDA suit le volume de la voix {#SoundVolumeFollowsVoice} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Désactivé, Activé| +|Défaut |Désactivé| + +Lorsque cette option est activée, le volume des sons et des bips de NVDA suivra le réglage du volume de la voix que vous utilisez. +Si vous diminuez le volume de la voix, le volume des sons diminuera. +De même, si vous augmentez le volume de la voix, le volume des sons augmentera. +Cette option n'est pas disponible si vous avez démarré NVDA avec [WASAPI désactivé pour la sortie audio](#WASAPI) dans les Paramètres avancés. + +##### Volume des sons NVDA {#SoundVolume} + +Ce potentiomètre vous permet de régler le volume des sons et des bips de NVDA. +Ce paramètre ne prend effet que lorsque "Le volume des sons NVDA suit le volume de la voix" est désactivé. +Cette option n'est pas disponible si vous avez démarré NVDA avec [WASAPI désactivé pour la sortie audio](#WASAPI) dans les Paramètres avancés. + +##### Séparation du son {#SelectSoundSplitMode} + +La fonction de séparation du son permet aux utilisateurs d'utiliser leurs périphériques de sortie stéréo, tels que des écouteurs et des haut-parleurs. +La séparation du son permet d'avoir la parole de NVDA sur un canal (par exemple gauche) et de faire en sorte que toutes les autres applications diffusent leur son sur l'autre canal (par exemple droit). +Par défaut, la séparation du son est désactivée. +Un geste de commande permet de parcourir les différents modes de séparation du son : + + +| Nom |Touche |Description| +|---|---|---| +|Faire défiler les modes de séparation du son |`NVDA+alt+s` |Passer d'un mode de séparation du son à l'autre.| + + + +Par défaut, cette commande alternera entre les modes suivants : + +* Séparation du son désactivée : NVDA n'applique aucun traitement de séparation du son. +* NVDA à gauche et applications à droite : NVDA parlera dans le canal de gauche, tandis que les autres applications diffuseront leur son dans le canal de droite. +* NVDA à gauche et applications dans les deux canaux : NVDA parlera dans le canal de gauche, tandis que les autres applications diffuseront leur son dans les deux canaux, gauche et droit. + +Il existe des modes de séparation du son plus avancés disponibles dans la liste déroulante des paramètres NVDA. +Parmi ces modes, le mode "NVDA dans les deux canaux et applications dans les deux canaux" force tous les sons à être dirigés dans les deux canaux. +Ce mode peut différer du mode "Séparation du son désactivé" dans le cas où un autre traitement audio interférerait avec les volumes des canaux. + +Veuillez noter que le séparateur de son ne fonctionne pas comme un mélangeur audio. +Par exemple, si une application joue une piste audio stéréo alors que la séparation du son est définie sur "NVDA à gauche et applications à droite", alors vous n'entendrez que le canal droit de la piste audio, tandis que le canal gauche de la piste sera mis en sourdine. + +Cette option n'est pas disponible si vous avez démarré NVDA avec [WASAPI désactivé pour la sortie audio](#WASAPI) dans les Paramètres avancés. + +Veuillez noter que si NVDA plante, il ne sera pas en mesure de restaurer le volume sonore des applications et il se pourrait que ces applications continuent à diffuser leur son sur un seul canal après le crash de NVDA. +Pour corriger ce problème, veuillez redémarrer NVDA et sélectionner le mode "NVDA dans les deux canaux et applications dans les deux canaux". + +##### Personnalisation des modes de séparation du son {#CustomizeSoundSplitModes} + +Cette liste de cases à cocher permet de sélectionner quels modes de séparation du son sont inclus lors du passage de l'un à l'autre en utilisant `NVDA+alt+s`. +Les modes non cochés sont exclus. +Par défaut, seuls trois modes sont inclus. + +* Séparation du son désactivée : NVDA et les applications diffusent des sons dans les canaux gauche et droit. +* NVDA à gauche et applications à droite. +* NVDA à gauche et applications dans les deux canaux. + +Veuillez noter qu'il est nécessaire de cocher au moins un mode. +Cette option n'est pas disponible si vous avez démarré NVDA avec [WASAPI désactivé pour la sortie audio](#WASAPI) dans les Paramètres avancés. + +##### Durée de maintien en éveil du périphérique audio après la parole {#AudioAwakeTime} + +Cette zone d'édition spécifie combien de temps NVDA maintient le périphérique audio en éveil après la fin de la parole. +Cela permet à NVDA d'éviter certains problèmes de parole comme des parties de mots coupées. +Cela peut se produire lorsque des appareils audio (en particulier les appareils Bluetooth et sans fil) passent en mode veille. +Cela peut également être utile dans d'autres cas d'utilisation, par exemple lors de l'exécution de NVDA dans une machine virtuelle (par exemple Citrix Virtual Desktop) ou sur certains ordinateurs portables. + +Des valeurs faibles peuvent provoquer une coupure de l'audio plus souvent, car un appareil peut passer en mode veille trop tôt, provoquant ainsi une coupure du début de la parole suivante. +Une valeur trop élevée peut entraîner une décharge plus rapide de la batterie du périphérique de sortie audio, car il reste active plus longtemps alors qu'aucun son n'est envoyé. + +Vous pouvez mettre cette durée à zéro afin de désactiver cette fonctionnalité. + +#### Vision {#VisionSettings} + +La catégorie Vision du dialogue des paramètres NVDA vous permet d'activer, désactiver et configurer les [aides visuelles](#Vision). + +Notez que les options disponibles dans cette catégorie pourraient être étendues par des [extensions NVDA](#AddonsManager). +Par défaut, cette catégorie de paramètres contient les options suivantes : + +##### Mise en Évidence Visuelle {#VisionSettingsFocusHighlight} + +Les cases à cocher du groupe Mise en Évidence Visuelle contrôlent le comportement de la fonctionnalité interne de [Mise en Évidence Visuelle](#VisionFocusHighlight)de NVDA. + +* Activer la mise en évidence: Active/désactive la mise en évidence visuelle. +* Mettre en évidence le focus système : définit si le [focus système](#SystemFocus) sera mis en évidence. +* Mettre en évidence l'objet navigateur : définit si [l'objet navigateur](#ObjectNavigation) sera mis en évidence. +* Mettre en évidence le curseur du mode navigation : Définit si le [Curseur virtuel du mode navigation](#BrowseMode) sera mis en évidence. + +Notez que cocher ou décocher la case "Activer la Mise en évidence" changera également l'état des trois autres cases à cocher en conséquence. +Ainsi, si "Activer la Mise en évidence" n'est pas cochée et que vous la cochez, les trois autres cases seront cochées automatiquement. +Si vous voulez mettre en évidence seulement le focus et laisser les cases objet navigateur et mode navigation non cochées, l'état de la case "Activer la mise en évidence" sera semicoché. + +##### Le Rideau d'Écran {#VisionSettingsScreenCurtain} + +Vous pouvez activer le [Rideau d'Écran](#VisionScreenCurtain) en cochant la case "Rendre l'écran noir (effet immédiat)". +Un avertissement indiquant que l'écran deviendra noir après activation sera alors affiché +Avant de continuer (en sélectionnant "Oui"), vérifiez que vous avez activé la parole ou le braille et que vous serez capable de contrôler votre ordinateur sans utiliser l'écran. +Sélectionnez "Non" si vous ne souhaitez plus activer le Rideau d'Écran. +Si vous êtes sûr, vous pouvez choisir le bouton Oui pour activer le Rideau d'Écran. +Si vous ne voulez plus voir cet avertissement à chaque fois, vous pouvez changer ce comportement dans le dialogue qui affiche le message. +Vous pouvez toujours restaurer l'avertissement en cochant la case "Toujours afficher un avertissement au chargement du Rideau d'Écran" à côté de la case "Rendre l'écran noir". + +Par défaut, des sons sont émis quand le Rideau d'Écran est activé ou désactivé. +Si vous souhaitez changer ce comportement, vous pouvez décocher la case " Émettre un son lors du basculement du rideau d'écran ". + +##### Paramètres des aides visuelles tierses {#VisionSettingsThirdPartyVisualAids} + +Des services d'aide visuelle additionnels peuvent être fournis dans des [Extensions NVDA](#AddonsManager). +Si ces services ont des paramètres ajustables, ils seront affichés dans cette catégorie de paramètres dans des groupes séparés. +Pour les paramètres supportés par un service, veuillez vous référer à la documentation pour ce service. + +#### Clavier {#KeyboardSettings} + + + +##### Ouvrir les paramètres Clavier {#OpenKeyboardSettings} + +Raccourci clavier : `NVDA+contrôle+k` + +La catégorie Clavier du dialogue Paramètres de NVDA contient des options qui définissent le comportement de NVDA quand vous utilisez ou tapez sur votre clavier. +Cette catégorie de paramètres contient les options suivantes : + +##### Configuration du clavier {#KeyboardSettingsLayout} + +Cette liste déroulante vous permet de choisir la configuration de clavier utilisée par NVDA. Actuellement, les deux configurations fournies avec NVDA sont : Desktop (ordinateur de bureau) et Laptop (ordinateur portable). + +##### Choisir les Touches NVDA {#KeyboardSettingsModifiers} + +Les cases à cocher de cette liste contrôlent quelles touches peuvent être utilisées comme [touches NVDA](#TheNVDAModifierKey). Vous pouvez choisir parmi les touches suivantes : + +* La touche Verrouillage Majuscule +* La touche insertion du pavé numérique +* La touche insertion étendue (elle se trouve généralement au-dessus des flèches, près de début et fin) + +Si aucune touche n'est choisie pour être la touche NVDA, il peut être impossible d'accéder à de nombreuses commandes de NVDA, vous devez donc cocher au moins une des touches. + + + +##### Écho clavier par caractère {#KeyboardSettingsSpeakTypedCharacters} + +Raccourci clavier : NVDA+2 + +Quand cette case est cochée, NVDA prononcera chaque caractère tapé au clavier. + + + +##### Écho clavier par mot {#KeyboardSettingsSpeakTypedWords} + +Raccourci clavier : NVDA+3 + +Quand cette case est cochée, NVDA prononcera chaque mot tapé au clavier. + +##### Interruption de la parole à la frappe d'un caractère {#KeyboardSettingsSpeechInteruptForCharacters} + +Si cette option est activée, la parole sera interrompue à chaque fois qu'un caractère est saisi. Cette option est activée par défaut. + +##### Interruption de la parole à l'appui de la touche Entrée {#KeyboardSettingsSpeechInteruptForEnter} + +Si cette option est activée, la parole sera interrompue à chaque fois que la touche "Entrée" est appuyée. Cette option est activée par défaut. + +##### Permettre le survol en mode dire tout {#KeyboardSettingsSkimReading} + +Si cette option est activée, certaines commandes de navigation (telles que les touches de navigation rapide en mode navigation ou l'exploration par ligne ou par paragraphe) n'arrêtent pas dire tout, qui reprend plutôt la lecture à la nouvelle position. + +##### Émettre un bip à la frappe d'un caractère minuscule quand le verrouillage majuscule est activé {#KeyboardSettingsBeepLowercase} + +Quand cette case est cochée, on entend un bip d'avertissement si on entre une lettre en combinaison avec la touche Majuscule alors que le Verrouillage Majuscule est activé. +Généralement, la frappe des lettres en majuscule quand les Majuscules sont verrouillées n'est pas intentionnelle et est généralement due au fait qu'on a oublié que la touche Majuscule est activée. +Cela peut donc être utile d'en être averti. + + + +##### Dire les touches de commandes {#KeyboardSettingsSpeakCommandKeys} + +Raccourci clavier : NVDA+4 + +Quand cette case est cochée, NVDA annonce, lors de leur frappe, toutes les touches ne correspondant pas à des caractères. Ceci inclut les combinaisons de touches telles que "contrôle" plus une autre lettre. + +##### Jouer un son pour les fautes d'orthographe durant la frappe {#KeyboardSettingsAlertForSpellingErrors} + +Quand cette option est activée, un court son de vibreur sera émis quand un mot que vous frappez contient une faute d'orthographe. +Cette option n'est disponible que si l'annonce des fautes d'orthographe est activée dans [Mise en Forme des Documents](#DocumentFormattingSettings) qui se trouve dans le dialogue Paramètres de NVDA. + +##### Exécuter les touches d'autres applications {#KeyboardSettingsHandleKeys} + +Cette option permet à l'utilisateur de choisir si les combinaisons de touches générées par des applications telles que les claviers à l'écran et les logiciels de reconnaissance vocale doivent être traitées par NVDA. +Cette option est activée par défaut, mais certains utilisateurs souhaiteraient la désactiver, comme ceux tapant en vietnamien avec le logiciel de dactylographie UniKey, car cela causerait la saisie de caractères incorrects. + +#### Souris {#MouseSettings} + + + +##### Ouvrire les paramètres de souris {#OpenMouseSettings} + +Raccourci clavier : `NVDA+contrôle+m` + +La catégorie Souris du dialogue Paramètres de NVDA permet de définir le mode de suivi de la souris par NVDA, de sonoriser les coordonnées de la souris par des bips et de définir d'autres options d'utilisation de la souris. +Elle contient les options suivantes : + +##### Annoncer les changements de forme de la souris {#MouseSettingsShape} + +Quand cette case est cochée, NVDA annonce la forme du pointeur souris chaque fois qu'elle change. +Sous Windows, le pointeur de souris change de forme pour transmettre certaines informations comme indiquer que quelque chose devient modifiable, ou que quelque chose est en train de se charger, etc. + + + +##### Activer le suivi de la souris {#MouseSettingsTracking} + +Raccourci clavier : NVDA+m + +Quand cette case est cochée, NVDA annonce le texte présent sous le pointeur souris, lorsqu'on la déplace sur l'écran. Cela vous permet de trouver un objet sur l'écran en déplaçant la souris au lieu de recourir à la navigation par objet. + +##### Résolution d'unités de texte {#MouseSettingsTextUnit} + +Si NVDA est configuré pour annoncer le texte sous la souris quand vous la déplacez, cette option vous permet de choisir précisément la quantité de texte qui sera lue. +Les options sont caractère, mot, ligne ou paragraphe. + +Pour activer la résolution d'unités de texte de n'importe où, veuillez assigner un geste de commande personnalisé en utilisant le dialogue [Gestes de Commandes](#InputGestures). + +##### Annoncer l'objet quand la souris y entre {#MouseSettingsRole} + +Quand cette case est cochée, NVDA annonce des informations sur les objets quand la souris y entre. +Cela comprend le rôle (type) de l'objet ainsi que les états (coché/appuyé), les coordonnées des cellules dans les tableaux, etc. +Veuillez Noter que l'annonce de certains détails d'objet peut dépendre de la façon dont d'autres paramètres sont définis, tels que les paramètres dans les catégories [Présentation des objets](#ObjectPresentationSettings) ou [Mise en Forme des Documents](#DocumentFormattingSettings). + +##### Sonoriser les coordonnées quand la souris se déplace {#MouseSettingsAudio} + +Quand cette case est cochée, NVDA émet des bips quand la souris se déplace, pour que l'utilisateur puisse se figurer la position de la souris sur l'écran. +Plus la souris est haut sur l'écran, plus la fréquence des bips est élevée. +Plus la souris est à gauche ou à droite sur l'écran, plus le son sera émis à gauche ou à droite, dans la mesure où l'utilisateur possède des haut-parleurs ou un casque stéréophoniques. + +##### La brillance modifie le volume des coordonnées audio {#MouseSettingsBrightness} + +Si la case "Sonoriser les coordonnées quand la souris se déplace" est cochée, le volume des bips variera en fonction de la brillance de la zone sous le pointeur de la souris. +Cette case est décochée par défaut. + +##### Ignorer les entrées souris d'autres applications {#MouseSettingsHandleMouseControl} + +Cette option permet à l'utilisateur d'ignorer les événements relatifs à la souris (incluant le déplacement et l'appui sur les boutons) générés par d'autres applications telles que TeamViewer et autres logiciels de contrôle à distance. +Cette option est décochée par défaut. +Si vous cochez cette option et que l'option "suivi de la souris" est activée, NVDA n'annoncera pas ce qui est sous la souris si la souris est déplacée par une autre application. + +#### Interaction tactile {#TouchInteraction} + +Cette catégorie, disponible seulement sur un ordinateur possédant des capacités tactiles, vous permet de configurer la manière dont NVDA interagit avec l'écran tactile. +Elle contient les options suivantes : + +##### Activer le support d'interaction tactile {#TouchSupportEnable} + +Cette case à cocher active le support d'interaction tactile de NVDA. +Quand il est activé, vous pouvez utiliser vos doigts pour naviguer et interagir avec les éléments sur l'écran en utilisant un écran tactile. +Quand il est désactivé, le support d'écran tatile est désactivé tant que NVDA est en cours d'exécution. +Ce paramètre peut aussi être activé/désactivé en utilisant NVDA+contrôle+alt+t. + +##### Mode de frappe tactile {#TouchTypingMode} + +Cette case à cocher vous permet d'indiquer la méthode que vous désirez utiliser pour saisir du texte avec le clavier tactile. +Quand elle est cochée, quand vous repérez une touche sur le clavier tactile, vous pouvez retirer votre doigt et la touche sélectionnée sera pressée. +Quand elle est décochée, vous devez double-taper sur la touche du clavier tactile pour la presser. + +#### Curseur de revue {#ReviewCursorSettings} + +La catégorie Curseur de Revue du dialogue Paramètres de NVDA sert à configurer le comportement du curseur de revue de NVDA. +Elle contient les options suivantes : + + + +##### Suivre le focus système {#ReviewCursorFollowFocus} + +Raccourci clavier : NVDA+7 + +Quand cette option est activée, le curseur de revue est toujours placé dans le même objet que le focus système quand il change. + + + +##### Suivre le curseur système {#ReviewCursorFollowCaret} + +Raccourci clavier : NVDA+6 + +Quand l'option est activée, le curseur de revue suit les mouvements du curseur système. + +##### Suivre le curseur souris {#ReviewCursorFollowMouse} + +Quand l'option est activée, le curseur de revue suit les mouvements de la souris. + +##### Mode de revue simple {#ReviewCursorSimple} + +Quand l'option est activée, NVDA filtre la hiérarchie des objets que l'on peut atteindre, excluant les objets sans intérêt pour l'utilisateur ; Ex : les objets invisibles et les objets utilisés seulement à des fins de présentation. + +Pour activer ou désactiver le mode de revue simple depuis n'importe où, veuillez lui assigner un geste de commande personnalisé en utilisant le [dialogue Gestes de Commandes](#InputGestures). + +#### Présentation des objets {#ObjectPresentationSettings} + + + +##### Ouvrir les paramètres de présentation des objets {#OpenObjectPresentationSettings} + +Raccourci clavier : `NVDA+contrôle+o` + +La catégorie Présentation des Objets du dialogue Paramètres de NVDA sert à définir la quantité d'informations annoncées par NVDA pour les contrôles tels que leur description, leur position etc. +Ces options ne s'appliquent généralement pas au mode navigation. +Elles s'appliquent généralement aux annonces de focus et à la navigation par objets de NVDA, mais pas à la lecture de contenu textuel, par ex. mode navigation. + +##### Annoncer les suggestions {#ObjectPresentationReportToolTips} + +Quand cette case est cochée, NVDA annonce les suggestions à leur apparition. +De nombreuses fenêtres et commandes font apparaître un court message (ou suggestion) lorsqu'on y déplace la souris ou le focus. + +##### Annoncer les notifications {#ObjectPresentationReportNotifications} + +Quand cette case est cochée, NVDA annonce les bulles d'aide et les notifications d'invitation à leur apparition. + +* Les bulles d'aide sont semblables aux suggestions mais généralement de plus grande taille, et sont associées à des évènements système tels que le débranchement d'un câble réseau, ou bien des alertes relatives à la sécurité. +* Les notifications d'invitation ont été introduites dans Windows 10 et apparaissent dans le centre de notification dans la barre d'état système, informant sur divers événements (ex : une mise à jour a été téléchargée, un ouveau courriel est arrivé dans votre boîte de réception, etc.). + +##### Annoncer les raccourcis clavier des objets {#ObjectPresentationShortcutKeys} + +Quand cette case est cochée, NVDA inclut, à l'annonce d'un objet ou d'une commande, le raccourci clavier qui lui est associé. +Par exemple, le menu "Fichier" d'une barre de menu peut avoir pour raccourci clavier Alt+f. + +##### Annoncer le rang de l'objet dans une liste {#ObjectPresentationPositionInfo} + +Cette option vous permet de choisir si vous voulez connaître le rang de l'objet dans une liste (ex : 1 sur 4) annoncé quand vous allez sur un objet au moyen du focus ou de la navigation par objet. + +##### Deviner le rang de l'objet quand l'information n'est pas disponible {#ObjectPresentationGuessPositionInfo} + +Si l'annonce du rang de l'objet dans une liste est activée, cette option autorise NVDA à deviner le rang de l'objet si cette information n'est pas disponible pour un objet particulier. + +Quand l'option est activée, NVDA annonce le rang pour un plus grand nombre de contrôles tels que les menus et les barres d'outils. Cependant, cette information peut parfois être inexacte. + +##### Annonce de la description des objets {#ObjectPresentationReportDescriptions} + +Décochez cette case si vous pensez que vous n'avez pas besoin d'entendre leur description annoncée avec les objets. + + + +##### Suivi des barres de progression {#ObjectPresentationProgressBarOutput} + +Raccourci clavier : NVDA+u + +Cette option vous présente une liste déroulante qui contrôle la manière dont NVDA vous annonce l'évolution des barres de progression. + +Elle propose les options suivantes : + +* Désactivé : L'évolution des barres de progression ne sera pas annoncée. +* Vocal : Cette option dit à NVDA d'annoncer l'évolution des barres de progression en pourcentage. Chaque fois que la barre changera, NVDA dira la nouvelle valeur. +* Par des bips : Cette option dit à NVDA d'émettre un bip à chaque évolution de la barre de progression. Plus le bip est aigu, plus on approche de la fin de la barre. +* Vocal avec des bips : Cette option dit à NVDA de parler et d'émettre des bips lors de la mise à jour de la barre de progression. + +##### Suivre les barres de progression en arrière-plan {#ObjectPresentationReportBackgroundProgressBars} + +Quand cette case est cochée, NVDA annonce les barres de progression même si elles ne sont pas physiquement sur la fenêtre en avant-plan. +Si vous minimisez ou quittez une fenêtre qui contient une barre de progression, NVDA continuera à la surveiller, vous permettant de faire autre chose pendant ce temps. + + + +##### Annoncer les changements de contenu dynamiques {#ObjectPresentationReportDynamicContent} + +Raccourci clavier : NVDA+5 + +Active ou désactive l'annonce d'un nouveau contenu en particulier dans les applications telles que les terminaux ou l'historique des programmes de tchat. + +##### Jouer un son quand une autosuggestion apparaît {#ObjectPresentationSuggestionSounds} + +Active/désactive l'annonce de l'apparition des autosuggestions, si activé, NVDA jouera un son pour l'indiquer. +Les autosuggestions sont des listes de saisies suggérées basées sur le texte entré dans certains champs de saisie et documents. +Par exemple, quand vous entrez du texte dans la boîte de recherche du menu démarrer de Windows Vista et au-delà, Windows affiche une liste de suggestions basée sur ce que vous avez entré. +Pour certains champs d'édition comme le champ de recherche dans diverses applications Windows 10, NVDA peut vous signaler qu'une liste de suggestions est apparue quand vous tapez du texte. +La liste de suggestions se ferme quand vous quittez le champ d'édition, et pour certains champs, NVDA peut vous en avertir quand ça arrive. + +#### Composition de saisie {#InputCompositionSettings} + +La catégorie Composition de la Saisie permet de contrôler comment NVDA annonce la saisie des caractères asiatiques, avec IME ou les services de texte et langue d'entrée. +Notez que, comme les méthodes de saisie varient considérablement selon les fonctions disponibles et la façon dont elles transmettent l'information, il sera probablement nécessaire de configurer ces options différemment pour chaque méthode de saisie, pour obtenir la meilleure expérience de saisie possible. + +##### Annonce automatique de toutes les suggestions disponibles {#InputCompositionReportAllCandidates} + +Cette option, activée par défaut, permet de choisir si oui ou non toutes les suggestions visibles doivent être automatiquement rapportées quand une liste de suggestions apparaît ou quand sa page change. +Activer cette option sur les méthodes d'entrée pictographiques telles que chinois Nouveau ChangJie ou Boshiami est utile car vous pouvez entendre automatiquement tous les symboles et leurs numéros, et vous pouvez en choisir un tout de suite. +Toutefois, pour les méthodes de saisie phonétique comme le nouveau chinois phonétique, il peut être plus utile de désactiver cette option puisque tous les symboles ont les mêmes sons et vous devrez utiliser les touches fléchées pour naviguer dans les éléments de la liste individuellement pour obtenir plus d'informations de la description de caractères pour chaque suggestion. + +##### Annoncer la suggestion sélectionnée {#InputCompositionAnnounceSelectedCandidate} + +Cette option, activée par défaut, vous permet de choisir si NVDA doit ou non annoncer la suggestion sélectionnée lorsqu'une liste de suggestions apparaît ou quand la sélection est changée. +Pour les méthodes où la suggestion peut être changée en utilisant les flèches (comme chinois nouveau phonétique) cela est nécessaire, cependant pour certaines méthodes il est préférable de désactiver cette option. +Notez que même si cette option est désactivée, le curseur de revue se placera toujours sur la suggestion sélectionnée, vous permettant toujours d'utiliser la navigation par objet ou le curseur de revue pour sélectionner la suggestion. + +##### Toujours inclure une description courte du caractère pour les suggestions {#InputCompositionCandidateIncludesShortCharacterDescription} + +Cette option, activée par défaut, permet de choisir si oui ou non NVDA doit fournir une description courte de chaque caractère d'une suggestion, quand elle est sélectionnée ou lors de la lecture de la liste quand elle apparaît. +Notez que pour les langues comme le chinois, l'annonce des descriptions de caractères supplémentaires pour la suggestion sélectionnée n'est pas affectée par cette option. +Cette option est utile pour les méthodes d'entrées coréennes et japonaises. + +##### Annonce les changements dans la chaîne en cours de lecture {#InputCompositionReadingStringChanges} + +Certains modes de saisie tels que le chinois ChangJie phonétique et Nouveau ChangJie peuvent avoir une chaîne de lecture (parfois connu sous le nom de chaîne de précomposition). +Avec cette option, vous pouvez choisir si oui ou non NVDA doit annoncer les nouveaux caractères saisis dans la chaîne de lecture en cours. +Cette option est activée par défaut. +Notez que certaines anciennes méthodes comme le chinois ChangJie n'utilisent pas la chaîne en cours de lecture pour les caractères de précomposition, utilisez directement la chaîne de composition. Voyez l'option suivante pour configurer l'annonce de la chaîne de composition. + +##### Annoncer les changements dans la chaîne de composition {#InputCompositionCompositionStringChanges} + +Après que les données de lecture ou de précomposition ont été combinées en un symbole pictographique valide, la plupart des méthodes d'entrée placent ce symbole dans une chaîne de composition pour stocker temporairement avec les autres symboles combinés avant de les insérer dans le document. +Cette option permet de choisir si oui ou non NVDA doit annoncer tous les symboles quand ils apparaissent dans la chaîne de composition. +Cette option est activée par défaut. + +#### Mode navigation {#BrowseModeSettings} + + + +##### Ouvrir les paramètres du mode navigation {#OpenBrowseModeSettings} + +Raccourci clavier : `NVDA+contrôle+b` + +La catégorie Mode Navigation du dialogue Paramètres de NVDA sert à configurer le comportement de NVDA quand vous naviguez dans des documents complexes tels que des pages web. +Elle contient les options suivantes : + +##### Nombre maximum de caractères par ligne {#BrowseModeSettingsMaxLength} + +Ce champ définit, en nombre de caractères, la longueur maximum d'une ligne en mode navigation. + +##### Nombre maximum de lignes par page {#BrowseModeSettingsPageLines} + +Ce champ définit le nombre de lignes dont on se déplace par appui sur "Page Précédente" ou "Page Suivante" en mode navigation. + + + +##### Utiliser la disposition telle qu'à l'écran {#BrowseModeSettingsScreenLayout} + +Raccourci clavier : NVDA+v + +Cette option vous permet de spécifier si le mode navigation doit placer le contenu cliquable (liens, boutons et champs) sur sa propre ligne, ou s'il doit le conserver dans le flux du texte tel qu'il est affiché visuellement. +Notez que cette option ne concerne pas les applications Microsoft Office telles qu'Outlook et Word, qui utilisent toujours la disposition telle qu'à l'écran. +Lorsque la disposition telle qu'à l'écran est activée, les éléments de la page restent tels qu'ils sont affichés visuellement. +Par exemple, une ligne visuelle de plusieurs liens sera présentée vocalement et en braille comme plusieurs liens sur la même ligne. +S'il est désactivé, les éléments de la page seront placés sur leurs propres lignes. +Ceci peut être plus facile à comprendre lors de la navigation ligne par ligne dans la page et peut faciliter l'interaction avec les éléments pour certains utilisateurs. + +##### Activer le mode navigation au chargement de la page {#BrowseModeSettingsEnableOnPageLoad} + +Cette case à cocher permet de choisir si le mode navigation doit être activé automatiquement au chargement d'une page. +Quand cette option est désactivée, le mode navigation peut quand-même être activé manuellement sur les pages ou documents où il est supporté. +Veuillez consulter la section [Mode navigation](#BrowseMode) pour avoir une liste des applications supportées par le mode navigation. +Notez que cette option ne s'applique pas aux situations où le mode navigation est toujours optionnel, par exemple sous Microsoft Word. +Cette option est activée par défaut. + +##### Dire tout automatiquement au chargement des pages {#BrowseModeSettingsAutoSayAll} + +Cette case à cocher active ou désactive la lecture automatique des pages après leur chargement en mode navigation. +Cette option est activée par défaut. + +##### Annoncer les tables de disposition {#BrowseModeSettingsIncludeLayoutTables} + +Cette option affecte la façon dont NVDA gère les tableaux utilisées uniquement à des fins de mise en page. +Lorsqu'elle est activée, NVDA les traitera comme des tableaux normaux en les annonçant en fonction des [Paramètres de Mise en forme des documents](#DocumentFormattingSettings) et en les localisant par les commandes de navigation rapides. +Lorsqu'elle est désactivée, ces tableaux ne seront ni annoncés ni trouvés par la navigation rapide. +Cependant, le contenu des tableaux sera toujours inclus sous forme de texte normal. +Cette option est désactivée par défaut. + +Pour activer/désactiver l'inclusion des tables de disposition de n'importe où, veuillez assigner un geste personnalisé en utilisant [le dialogue Gestes de commandes](#InputGestures). + +##### Configurer l'annonce de champs tels que liens et titres {#BrowseModeLinksAndHeadings} + +Veuillez consulter les options dans [Mise en forme des Documents](#DocumentFormattingSettings) du dialogue [Paramètres de NVDA](#NVDASettings) pour configurer les champs qui sont annoncés durant la navigation tels que les liens, les titres et les tableaux. + +##### Mode formulaire automatique au changement de focus {#BrowseModeSettingsAutoPassThroughOnFocusChange} + +Cette option permet au mode formulaire d'être invoqué au changement de focus. +Par exemple, dans une page web, si vous tabulez et arrivez sur un formulaire : si cette option est cochée, le mode formulaire sera automatiquement activé. + +##### Mode formulaire automatique au déplacement du curseur {#BrowseModeSettingsAutoPassThroughOnCaretMove} + +Cette option, quand elle est cochée, permet à NVDA d'activer ou désactiver le mode formulaire quand on se déplace avec les flèches. +Par exemple, si vous naviguez dans une page web avec les flèches et que vous arrivez sur une zone d'édition, NVDA passera automatiquement en mode formulaire. +Si vous sortez de la zone d'édition, le mode formulaire sera automatiquement désactivé. + +##### Indication audio du mode formulaire ou navigation {#BrowseModeSettingsPassThroughAudioIndication} + +Si cette option est activée, NVDA émettra des sons particuliers au passage du mode formulaire au mode navigation plutôt que d'annoncer le changement verbalement. + +##### Empêcher les gestes ne correspondant pas à des commandes d'atteindre le document {#BrowseModeSettingsTrapNonCommandGestures} + +Activée par défaut, cette option vous permet de choisir si des gestes (tels que l'appui sur des touches) qui ne déclenchent pas une commande NVDA et ne sont pas considérés comme une commande en général, devraient être interceptés pour ne pas interagir avec le document actuellement en focus. +Par exemple, si l'option est activée, si la lettre j est pressée, elle sera interceptée pour ne pas atteindre le document, même si ce n'est ni une touche de navigation rapide ni une commande dans l'application elle-même. +Dans ce cas NVDA demandera à Windows de jouer un son par défaut quand une touche interceptée est pressée. + + + +##### Amener automatiquement le focus système aux éléments focalisables {#BrowseModeSettingsAutoFocusFocusableElements} + +Raccourci clavier : NVDA+8 + +Désactivée par défaut, cette option vous permet de choisir si le focus système doit être automatiquement positionné aux éléments pouvant prendre le focus système (liens, champs de saisie, etc.) quand on parcourt le contenu avec le curseur de mode navigation. +Laisser cette option désactivée ne focalisera pas automatiquement les éléments focalisables quand ils seront sélectionnés avec le curseur du mode navigation. +Cela pourrait apporter une expérience de navigation plus rapide et une meilleure réactivité en mode navigation. +Le focus sera alors mis à jour lors d'une interaction avec un élément particulier (ex : l'appui d'un bouton, le cochage d'une case à cocher). +Activer cette option peut améliorer le support de quelques sites web au détriment de la performance et de la stabilité. + +#### Mise en forme des documents (NVDA+contrôle+d) {#DocumentFormattingSettings} + + + +##### Ouvrir les paramètres de mise en forme des documents {#OpenDocumentFormattingSettings} + +Raccourci clavier : `NVDA+contrôle+d` + +La plupart des options de cette catégorie servent à définir quelles informations de mise en forme vous souhaitez entendre automatiquement lorsque vous parcourez un document. +Par exemple, si on coche la case "Annoncer le nom de la police", à chaque fois que les flèches amènent sur un texte avec une police différente, le nom de la police est annoncé. + +Les options de mise en forme des document sont organisées par groupes ; +On peut configurer les annonces suivantes : + +* Police, + * Nom de la police + * Taille de la police, + * Attributs de la police, + * Exposants et indices + * Emphase + * Texte surligné (marqué) + * Style + * Couleurs +* Informations sur le document + * Commentaires + * Signets + * Modifications de l'éditeur + * Fautes d'orthographe +* Pages et espacement + * Numéros de page + * Numéros de ligne + * Annonce du retrait de ligne [(Désactivé, Parole, Sons, Parole et Sons)](#DocumentFormattingSettingsLineIndentation) + * Ignorer les lignes vides pour l'annonce du retrait de ligne + * Retrait des paragraphes (ex. retrait négatif, retrait de première ligne) + * interligne (simple, double etc.) + * Alignement +* Informations sur les tableaux + * Tableaux + * En-têtes des lignes et colonnes (désactivé, lignes, colonnes, lignes et colonnes) + * Coordonnées des cellules + * Bordure des cellules (désactivé, Styles, Couleurs et Styles) +* Éléments + * Titres + * Liens + * Graphiques + * Listes + * Citations + * Groupes + * Régions + * Articles + * Cadres + * Figures et légendes + * Cliquable + +Pour modifier ces paramètres de n'importe où, veuillez assigner un geste personnalisé en utilisant le [dialogue Gestes de Commandes](#InputGestures). + +##### Annonce des changements de mise en forme après le curseur {#DocumentFormattingDetectFormatAfterCursor} + +Si on l'active, ce paramètre dit à NVDA de détecter tous les changements de mise en forme sur une ligne et de les signaler pendant la lecture. Attention, cela peut dégrader les performances de NVDA. + +Par défaut, NVDA détecte la mise en forme sous le curseur système ou le curseur de revue, et, dans certains cas, sur toute la ligne à condition que cela ne dégrade pas les performances. + +Activez cette option quand vous révisez un document dans une application telle que Wordpad et que la mise en forme est importante. + +##### Annonce des retraits de lignes {#DocumentFormattingSettingsLineIndentation} + +Cette option vous permet de configurer la manière dont les retraits en début de ligne sont annoncés. +La liste déroulante "Annoncer les retraits de ligne par" a quatre options : + +* Désactivé : NVDA ne traitera pas les retraits de lignes. +* Parole : Si parole est sélectionnée, quand le niveau de retrait change, NVDA dit quelque chose comme "douze espaces" ou "quatre tabulations.". +* Sons : Si sons est sélectionné, quand le niveau de retrait change, des sons indiquent la quantité de changement dans le retrait. +La hauteur du son montera pour chaque espace, et pour une tabulation, la hauteur montera de l'équivalent de 4 espaces. +* Parole et sons : Cette option indique les retraits en utilisant les deux méthodes ci-dessus. + +Si vous cochez la case "Ignorer les lignes vides pour l'annonce de retrait de ligne", les modifications d'indentation ne seront pas signalées pour les lignes vides. +Cela peut être utile lors de la lecture d'un document dans lequel des lignes vides sont utilisées pour séparer des blocs de texte en retrait, comme dans le code source de programmation. + +#### Navigation dans les documents {#DocumentNavigation} + +Cette catégorie vous permet d'ajuster divers aspects de la navigation dans les documents. + +##### Style des paragraphes {#ParagraphStyle} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Défaut (Géré par l' application), géré par l' application, Saut de ligne unique, Saut de ligne multiple| +|Défaut |Géré par l'application| + +Cette liste déroulante vous permet de sélectionner le style de paragraphe à utiliser lors de la navigation par paragraphes avec `contrôle+flècheHaut` et `contrôle+flècheBas`. +Les styles de paragraphe disponibles sont : + +* Géré par l'application : NVDA laissera l'application déterminer le paragraphe précédent ou suivant, et NVDA lira le nouveau paragraphe lors de la navigation. +Ce style fonctionne mieux lorsque l'application prend en charge la navigation dans les paragraphes de manière native et est la valeur par défaut. +* Saut de ligne simple : NVDA tentera de déterminer le paragraphe précédent ou suivant en utilisant un saut de ligne simple comme indicateur de paragraphe. +Ce style fonctionne mieux lors de la lecture de documents dans une application qui ne prend pas en charge nativement la navigation dans les paragraphes, et dont les paragraphes du document sont marqués par une simple pression sur la touche `entreé`. +* Saut de ligne multiple : NVDA tentera de déterminer le paragraphe précédent ou suivant en utilisant au moins une ligne vierge (deux appuis sur la touche `entreé`) comme indicateur de paragraphe. +Ce style fonctionne mieux lorsque vous travaillez avec des documents qui utilisent des paragraphes de bloc. +Notez que ce style de paragraphe ne peut pas être utilisé dans Microsoft Word ou Microsoft Outlook, sauf si vous utilisez l'UIA pour accéder aux contrôles de Microsoft Word. + +Vous pouvez basculer entre les styles de paragraphe disponibles de n'importe où en attribuant une touche dans la [boîte de dialogue Gestes de commandes](#InputGestures). + +#### Reconnaissance Optique de Caractères de Windows {#Win10OcrSettings} + +Les paramètres de cette catégorie vous permettent de configurer la [Reconnaissance de Caractères de Windows](#Win10Ocr). +Elle contient les options suivantes : + +##### Langue de Reconnaissance {#Win10OcrSettingsRecognitionLanguage} + +Cette liste déroulante vous permet de choisir la langue à utiliser pour la reconnaissance de texte. +Pour faire défiler les langues disponibles à partir de n'importe quel endroit, veuillez assigner un geste de commande personnalisé en utilisant [le dialogue Gestes de Commandes](#InputGestures). + +##### Actualiser périodiquement le contenu reconnu {#Win10OcrSettingsAutoRefresh} + +Lorsque cette case est cochée, NVDA actualisera automatiquement le contenu reconnu lorsqu'un résultat de reconnaissance aura le focus. +Cela peut être très utile lorsque vous souhaitez surveiller un contenu en constante évolution, par exemple lorsque vous regardez une vidéo avec sous-titres. +Le rafraîchissement a lieu toutes les secondes et demie. +Cette option est désactivée par défaut. + +#### Paramètres avancés {#AdvancedSettings} + +Avertissement ! Les paramètres dans cette catégorie sont pour les utilisateurs avancés et peuvent provoquer un mauvais fonctionnement de NVDA si mal configurés. +Ne modifiez ces paramètres que si vous êtes sûr de ce que vous faites ou si un développeur NVDA vous a demandé de le faire. + +##### Modifier les paramètres avancés {#AdvancedSettingsMakingChanges} + +Pour pouvoir modifier les paramètres avancés, les contrôles doivent être activés en confirmant, via la case à cocher, que vous comprenez les risques qu'il y a à modifier ces paramètres + +##### Rétablir les paramètres par défaut {#AdvancedSettingsRestoringDefaults} + +Le bouton rétablit les valeurs par défaut des paramètres, même si la case de confirmation n'est pas cochée. +Après avoir modifié les paramètres vous pouvez souhaiter revenir aux valeurs par défaut. +Cela peut aussi être le cas si vous n'êtes pas sûr que les paramètres ont été modifiés. + +##### Activer le chargement de code personnalisé depuis le Répertoire Bloc-notes du Développeur {#AdvancedSettingsEnableScratchpad} + +Quand vous développez des extensions pour NVDA, il est utile de pouvoir tester le code en cours d'écriture. +Cette option, lorsqu'elle est activée, permet à NVDA de charger des modules applicatifs personnalisés, des modules globaux, des pilotes d'afficheurs braille, des pilotes de synthétiseur et des fournisseurs d'amélioration visuelle, à partir d'un répertoire spécial bloc-notes du développeur dans votre répertoire de configuration utilisateur NVDA. +Comme leurs équivalents dans les extensions, ces modules sont chargés au démarrage de NVDA ou, dans le cas des modules applicatifs et globaux, lors du [rechargement des modules](#ReloadPlugins). +Cette option est désactivée par défaut, garantissant qu'aucun code non testé n'est exécuté par NVDA sans que l'utilisateur en ait explicitement connaissance. +Si vous voulez distribuer du code spécifique à d'autres personnes, vous devriez l'empaqueter sous forme d'extension pour NVDA. + +##### Ouvrir le Répertoire Bloc-notes du Développeur {#AdvancedSettingsOpenScratchpadDir} + +Ce bouton ouvre le répertoire où vous pouvez placer le code personnalisé que vous êtes en train de développer. +Ce bouton n'est disponible que si NVDA est configuré pour permettre le chargement de code personnalisé depuis le répertoire Bloc-notes du développeur. + +##### Enregistrement des événements et modifications de propriété UI Automation {#AdvancedSettingsSelectiveUIAEventRegistration} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Automatique, Sélectif, Global| +|Défaut |Automatique| + +Cette option change la façon dont NVDA enregistre les événements déclenchés par l'API d'accessibilité UI Automation de Microsoft. +La liste déroulante Enregistrement des événements et modifications de propriété UI Automation a trois options : + +* Automatique : "sélectif" sous Windows 11 Sun Valley 2 (version 22H2) et ultérieur, "global" sinon. +* Sélectif : NVDA limitera l'enregistrement des événements au focus système pour la plupart des événements +Si vous rencontrez des problèmes de performances dans une ou plusieurs applications, nous vous recommandons d'essayer cette fonctionnalité pour voir si les performances s'améliorent. +Cependant, sur les anciennes versions de Windows, NVDA peut avoir des difficultés à suivre le focus dans certains contrôles (tels que le gestionnaire de tâches et le panneau emoji). +* Global : NVDA enregistre de nombreux événements UIA qui sont traités et rejetés dans NVDA lui-même. +Bien que le suivi du focus soit plus fiable dans un plus grand nombre de situations, les performances sont considérablement dégradées, en particulier dans des applications telles que Microsoft Visual Studio. + +##### Utiliser UI automation pour accéder aux contrôles des documents Microsoft Word {#MSWordUIA} + +Configure si NVDA doit ou non utiliser l'API d'accessibilité UI Automation pour accéder aux documents Microsoft Word, plutôt que l'ancien modèle d'objet Microsoft Word. +Cela s'applique aux documents dans Microsoft Word lui-même, ainsi qu'aux messages dans Microsoft Outlook. +Ce paramètre contient les valeurs suivantes : + +* Défaut (Lorsque c'est adapté) +* Seulement si nécessaire : quand le modèle d'objet Microsoft Word n'est pas disponible du tout +* Lorsque c'est adapté : Microsoft Word version 16.0.15000 ou supérieure, ou lorsque le modèle d'objet Microsoft Word n'est pas disponible +* Toujours : partout où UI automation est disponible dans Microsoft Word (quel que soit l'avancement de son développement) + +##### Utilisez UI Automation pour accéder aux contrôles de feuille de calcul Microsoft Excel quand disponible {#UseUiaForExcel} + +Lorsque cette option est activée, NVDA essaiera d'utiliser l'API d'accessibilité de Microsoft UI Automation pour récupérer les informations depuis les contrôles de la feuille de calcul Microsoft Excel. +Il s'agit d'une fonctionnalité expérimentale et certaines fonctionnalités de Microsoft Excel peuvent ne pas être disponibles dans ce mode. +Par exemple, la liste des éléments de NVDA pour lister les formules et les commentaires, et la navigation rapide en mode navigation pour sauter aux champs de formulaire sur une feuille de calcul ne sont pas disponibles. +Cependant, pour la navigation/l'édition de base d'une feuille de calcul, cette option peut améliorer considérablement les performances. +Nous ne recommandons toujours pas que la majorité des utilisateurs l'activent par défaut, mais nous invitons les utilisateurs de Microsoft Excel version 16.0.13522.10000 ou supérieure à tester cette fonctionnalité et à nous faire part de leurs commentaires. +L'implémentation de UI Automation dans Microsoft Excel est en constante évolution et les versions de Microsoft Office antérieures à 16.0.13522.10000 peuvent ne pas exposer suffisamment d'informations pour que cette option soit d'une quelconque utilité. + +##### Utiliser le traitement des événements amélioré {#UIAEnhancedEventProcessing} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Défaut (Activé), Désactivé, Activé| +|Défaut |Activé| + +Lorsque cette option est activée, NVDA devrait rester réactif lorsqu'il est submergé de nombreux événements UI Automation, par ex. de grandes quantités de texte dans un terminal. +Après avoir modifié cette option, vous devrez redémarrer NVDA pour que la modification prenne effet. + +##### Prise en charge de la Console Windows {#AdvancedSettingsConsoleUIA} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Automatique, UIA si disponible, Héritée| +|Défaut |Automatique| + +Cette option sélectionne la façon dont NVDA interagit avec la console Windows utilisée par l'invite de commande, PowerShell et le sous-système Windows pour Linux. +Cela n'affecte pas le terminal Windows moderne. +Dans Windows 10 version 1709, Microsoft [a ajouté la prise en charge de son API UI Automation à la console](https://devblogs.microsoft.com/commandline/whats-new-in-windows-console-in-windows-10-fall-creators-update/), apportant des performances et une stabilité considérablement améliorées pour les lecteurs d'écran qui la prennent en charge. +Dans les situations où l'automatisation de l'interface utilisateur n'est pas disponible ou connue pour entraîner une expérience utilisateur inférieure, la prise en charge de la console héritée de NVDA est disponible comme solution de secours. +La liste déroulante de prise en charge de la console Windows comporte trois options : + +* Automatique : utilise UI Automation dans la version de la console Windows incluse avec Windows 11 version 22H2 et versions ultérieures. +Cette option est recommandée et définie par défaut. +* UIA si disponible : utilise l'automatisation de l'interface utilisateur dans les consoles si disponible, même pour les versions avec des implémentations incomplètes ou boguées. +Bien que cette fonctionnalité limitée puisse être utile (et même suffisante pour votre utilisation), l'utilisation de cette option est entièrement à vos risques et périls et aucune assistance ne sera fournie. +* Héritée : l'automatisation de l'interface utilisateur dans la console Windows sera complètement désactivée. +L'héritage de secours sera toujours utilisé même dans les situations où UI Automation offrirait une expérience utilisateur supérieure. +Par conséquent, le choix de cette option n'est pas recommandé, sauf si vous savez ce que vous faites. + +##### Utiliser UIA avec Microsoft Edge et autres navigateurs basés sur Chromium quand c'est possible {#ChromiumUIA} + +Cette option permet de définir quand UIA sera utilisé si disponible dans les navigateurs basés sur Chromium tels que Microsoft Edge. +Le support d'UIA pour les navigateurs basés sur Chromium est au début de son développement et peut ne pas apporter le même niveau d'accessibilité que IA2. +La liste déroulante contient les options suivantes : + +* Défaut (Seulement quand nécessaire) : C'est actuellement la valeur par défaut de NVDA. Cette valeur par défaut peut changer à l'avenir en fonction de l'amélioration de la technologie. +* Seulement quand nécessaire : Quand NVDA est incapable d'injecter dans le processus du navigateur de quoi utiliser IA2 et que UIA est disponible, NVDA utilisera UIA. +* Oui : Si le navigateur rend UIA disponible, NVDA l'utilisera. +* Non : Ne pas utiliser UIA, même si NVDA ne peut pas injecter dans le processus. Ceci peut être utile pour les développeurs corrigeant des problèmes liés à IA2 et voulant s'assurer que NVDA ne revient pas à UIA. + +##### Annotations {#Annotations} + +Ce groupe d'options est utilisé pour activer des fonctionnalités qui ajoutent une prise en charge expérimentale des annotations ARIA. +Certaines de ces fonctionnalités peuvent être incomplètes. + + +Pour "Signaler le résumé de tous les détails d'annotation au niveau du curseur système", appuyez sur NVDA+d. + + +Les options suivantes existent : + +* "Annoncer 'contient des détails' pour les annotations structurées" : active l'annonce si le texte ou le contrôle contient plus de détails. +* "Toujours annoncer aria-description" : + Lorsque la source de `accDescription` est aria-description, la description est annoncée. + Ceci est utile pour les annotations sur le web. + Note : + * Il existe de nombreuses sources pour `accDescription` plusieurs ont une sémantique mixte ou peu fiable. + Historiquement, les technologies d'assistance n'ont pas été en mesure de différencier les sources de `accDescription` généralement, elle n'a pas été annoncée en raison de la sémantique mixte. + * Cette option est en développement très précoce, elle repose sur des fonctionnalités de navigateur pas encore largement disponibles. + * Elle devrait fonctionner avec Chromium 92.0.4479.0+ + +##### Signaler les régions Actives {#BrailleLiveRegions} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Défaut (Activé), Désactivé, Activé| +|Défaut |Activé| + +Cette option définit si NVDA signale les changements dans certains contenus Web dynamiques en Braille. +Désactiver cette option équivaut au comportement de NVDA dans les versions 2023.1 et antérieures, qui ne signalaient ces changements de contenu que par la parole. + +##### Énoncer les mots de passe dans tous les terminaux améliorés {#AdvancedSettingsWinConsoleSpeakPasswords} + +Ce paramètre définit si les caractères sont prononcés en [écho clavier par caractère](#KeyboardSettingsSpeakTypedCharacters) ou [écho clavier par mot](#KeyboardSettingsSpeakTypedWords) dans les situations où l'écran ne se met pas à jour (comme la saisie du mot de passe) dans certains programmes de terminal, tels que la console Windows avec l'automatisation de l'interface utilisateur support activé et Mintty. +Pour des raisons de sécurité, ce paramètre devrait être laissé désactivé. +Cependant, vous souhaiterez peut-être l'activer si vous rencontrez des problèmes de performances ou une instabilité avec les annoncess de caractères et/ou de mots saisis dans les consoles, ou si vous travaillez dans des environnements de confiance et préférez l'annonce du mot de passe. + +##### Utiliser la prise en charge améliorée de la saisie de caractères dans l'ancienne console Windows lorsqu'elle est disponible {#AdvancedSettingsKeyboardSupportInLegacy} + +Cette option active une méthode alternative pour détecter les caractères saisis dans les anciennes consoles Windows. +Bien qu'elle améliore les performances et empêche certains affichages de console d'être épelés, elle peut être incompatible avec certains programmes de terminaux. +Cette fonctionnalité est disponible et activée par défaut sous Windows 10 versions 1607 et ultérieures quand UI Automation n'est pas disponible ou désactivée. +Avertissement : quand cette option est activée, les caractères tapés qui n'apparaissent pas à l'écran comme les mots de passe, ne seront pas supprimés. +Dans les environnement non sûrs, vous pouvez désactiver temporairement [Écho clavier par caractère](#KeyboardSettingsSpeakTypedCharacters) et [Écho clavier par mot](#KeyboardSettingsSpeakTypedWords) quand vous entrez un mot de passe. + +##### Algorithme de comparaison du texte {#DiffAlgo} + +Ce paramètre définit comment NVDA détermine le nouveau texte à annoncer dans les terminaux. +La liste déroulante Algorithme de comparaison du texte a trois options : + +* Automatique : Cette option fait que NVDA préfère Diff Match Patch dans la plupart des situations, mais se rabat sur Difflib dans les applications problématiques, telles que les anciennes versions de la console Windows et de Mintty. +* Diff Match Patch : Cette option permet à NVDA de calculer les modifications apportées au texte du terminal par caractère, même dans les situations où cela n'est pas recommandé. +Cela peut améliorer les performances quand de grandes quantités de texte sont écrites à la console et permet l'annonce plus précises des changements intervenant en milieu de ligne. +Cependant, dans certaines applications, la lecture d'un nouveau texte peut être saccadée ou incohérente. +* Difflib : cette option permet à NVDA de calculer les modifications apportées au texte du terminal par ligne, même dans les situations où cela n'est pas recommandé. +Ce comportement est identique à celui de NVDA en version 2020.4 et antérieures. +Ce paramètre peut stabiliser la lecture du texte entrant dans certaines applications. +Cependant, dans les terminaux, lors de l'insertion ou de la suppression d'un caractère au milieu d'une ligne, le texte après le curseur sera lu. + +##### Annoncez un nouveau texte dans le terminal Windows via {#WtStrategy} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Défaut (Comparaison du texte), Comparaison du texte, Notifications UIA| +|Défaut |Comparaison du texte| + +Cette option sélectionne la façon dont NVDA détermine quel texte est "nouveau" (et donc ce qu'il faut prononcer lorsque "signaler les changements de contenu dynamique" est activé) dans Windows Terminal et le contrôle WPF Windows Terminal utilisé dans Visual Studio 2022. +Elle n'affecte pas la console Windows (`conhost.exe`). +La liste déroulante annoncer le nouveau texte dans le terminal Windows comporte trois options : + +* Par défaut : cette option est actuellement équivalente à "différence", mais il est prévu qu'elle change une fois que la prise en charge des notifications UIA sera développée davantage. +* Différence : cette option utilise l'algorithme de comparaison sélectionné pour calculer les changements à chaque fois que le terminal affiche un nouveau texte. +Ceci est identique au comportement de NVDA dans les versions 2022.4 et antérieures. +* Notifications UIA : Cette option reporte la responsabilité de déterminer quel texte parler au terminal Windows lui-même, ce qui signifie que NVDA n'a plus à déterminer quel texte actuellement à l'écran est "nouveau". +Cela devrait nettement améliorer les performances et la stabilité de Windows Terminal, mais cette fonctionnalité n'est pas encore complète. +En particulier, les caractères saisis qui ne s'affichent pas à l'écran, tels que les mots de passe, sont signalés lorsque cette option est sélectionnée. +De plus, les étendues contiguës d'affichage de plus de 1 000 caractères peuvent ne pas être rapportées avec précision. + +##### Tenter d'interrompre la parole pour les événements de focus expirés {#CancelExpiredFocusSpeech} + +Cette option active un comportement qui tente d'interrompre la parole pour les événements de focus expirés. +En particulier se déplacer rapidement parmi les messages dans Gmail sous Chrome peut amener NVDA à annoncer des informations périmées. +Cette fonctionnalité est activée par défaut à partir de NVDA 2021.1. + +##### Délai d'attente de mouvement du curseur (en ms) {#AdvancedSettingsCaretMoveTimeout} + +Cette option vous permet de configurer le nombre de millisecondes durant lequel NVDA attendra le déplacement du curseur (point d'insertion) dans les contrôles de texte éditable. +Si vous trouvez que NVDA semble mal suivre le curseur ex : il semble être toujours un caractère en retard ou il répète les lignes, alors vous pouvez essayer d'accroître cette valeur. + +##### Annoncer la transparence pour les couleurs {#ReportTransparentColors} + +Cette option permet d'annoncer lorsque les couleurs sont transparentes, utile pour les développeurs d'extensions qui collectent des informations pour améliorer l'expérience utilisateur avec une application tierce. +Certaines applications GDI mettent en surbrillance le texte avec une couleur d'arrière-plan, NVDA (via le modèle d'affichage) tente de signaler cette couleur. +Dans certaines situations, l'arrière-plan du texte peut être entièrement transparent, le texte étant superposé sur un autre élément de l'interface graphique. +Pour plusieurs API GUI historiquement populaires, le texte peut être rendu avec un arrière-plan transparent, mais visuellement, la couleur d'arrière-plan est précise. + +##### Utiliser WASAPI pour la sortie audio {#WASAPI} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Défaut (Activé), Désactivé, Activé| +|Défaut |Activé| + +Cette option active la sortie audio via l'API Windows Audio Session (WASAPI). +WASAPI est une architecture audio plus moderne qui peut améliorer la réactivité, les performances et la stabilité de la sortie audio NVDA, y compris la parole et les sons. +Après avoir modifié cette option, vous devrez redémarrer NVDA pour que la modification prenne effet. +La désactivation de WASAPI désactivera les options suivantes : + +* [Le volume des sons NVDA suit le volume de la voix](#SoundVolumeFollowsVoice) +* [Volume des sons NVDA](#SoundVolume) + +##### Catégories de journalisation de débogage {#AdvancedSettingsDebugLoggingCategories} + +Les cases à cocher dans cette liste vous permettent d'activer des catégories spécifiques de messages de débogage dans le journal de NVDA. +La journalisation de ces messages peut dégrader la performance et produire de gros fichiers de journal. +N'activez l'une d'entre elle que si un développeur de NVDA vous l'a spécifiquement demandé ex : pour déboguer un pilote de terminal braille ne fonctionnant pas correctement. + +##### Jouer un son pour les erreurs journalisées {#PlayErrorSound} + +Cette option vous permet de spécifier si NVDA joue un son d'erreur au cas où une erreur est enregistrée. +En sélectionnant Uniquement dans les versions de test (par défaut), NVDA émet des sons d'erreur uniquement si la version actuelle de NVDA est une version de test (alpha, bêta ou exécutée à partir de la source). +En sélectionnant Oui les sons d'erreur sont activés quelle que soit votre version actuelle de NVDA. + +##### Expression régulière pour la navigation par paragraphes de texte {#TextParagraphRegexEdit} + +Ce champ permet aux utilisateurs de personnaliser l'expression régulière pour détecter les paragraphes de texte en mode navigation. +La [commande de navigation par paragraphe de texte](#TextNavigationCommand) recherche les paragraphes correspondant à cette expression régulière. + +### Autres paramètres {#MiscSettings} + +En plus du dialogue [Paramètres](#NVDASettings), le sous-menu Préférences du menu NVDA contient plusieurs autres éléments décrits ci-dessous. + +#### Dictionnaires de prononciation {#SpeechDictionaries} + +Le menu "Dictionnaires de prononciation" du menu "Préférences" contient des dialogues qui vous permettent de gérer la manière dont NVDA prononce certains mots ou phrases. +Il y a actuellement trois types de dictionnaires. +Ce sont : + +* Défaut : les règles de ce dictionnaire affectent la parole dans tout NVDA. +* Voix : les règles de ce dictionnaire n'affectent que la voix en cours d'utilisation. +* Temporaire : les règles de ce dictionnaire affectent tout NVDA mais seulement pour la session en cours. + +Vous devez assigner des gestes personnalisés en utilisant le [dialogue Gestes de Commandes](#InputGestures) si vous voulez ouvrir l'un de ces dialogues de dictionnaire depuis n'importe où. + +Tous les dialogues des dictionnaires contiennent une liste de règles qui seront utilisées pour produire la parole. +Le dialogue contient aussi des boutons "Ajouter", "Éditer", "Supprimer" et "Tout supprimer". + +Pour ajouter une nouvelle règle au dictionnaire, cliquez sur le bouton "Ajout", remplissez les champs dans le dialogue puis cliquez sur "OK". +Vous verrez ainsi votre nouvelle règle dans la liste des règles. +Cependant, pour être sûr que votre règle est vraiment sauvegardée, n'oubliez pas de cliquer sur le bouton "OK" pour quitter le dialogue de dictionnaire une fois que vous aurez fait toutes vos modifications. + +Les règles des dictionnaires de NVDA vous permettent de remplacer une chaîne de caractères par une autre. +Par exemple, vous pourrez vouloir que NVDA prononce le mot "grenouille" chaque fois qu'il rencontre le mot "oiseau". +Dans le dialogue d'ajout de règles, la manière la plus simple de faire cela est d'entrer le mot "oiseau" dans la zone "modèle" et le mot "grenouille" dans la zone de remplacement. +Vous pouvez aussi ajouter un commentaire décrivant la règle dans la zone commentaire, quelque chose comme "Remplacer oiseau par grenouille". + +Cependant, les dictionnaires de NVDA font bien mieux que le simple remplacement de mot. +Le dialogue "Ajout de règles" contient une case à cocher permettant de choisir si vous voulez que la règle respecte la casse pour que NVDA tienne compte des majuscules et minuscules. +Par défaut, NVDA ne tient pas compte de la casse. + +Pour finir, un ensemble de boutons radio vous permet de dire à NVDA si votre modèle devrait s'appliquer partout, seulement dans le cas d'un mot entier ou s'il devrait être traité comme une "expression régulière". +Définir le modèle comme un mot entier signifie que le remplacement ne sera fait que si le modèle n'est pas rencontré dans un mot plus grand. +Un caractère non alphanumérique ou un souligné ou pas de caractère doit être présent immédiatement avant et après le modèle. +Ainsi, en utilisant l'exemple précédent de remplacement du mot "oiseau" par le mot "grenouille", si vous le définissez comme un remplacement de mot entier, cela ne marcherait pas pour "oiseaux" ou "damoiseau". + +Une expression régulière est un modèle contenant des symboles particuliers vous permettant de trouver une correspondance sur plus d'un caractère à la fois, ou seulement sur les lettres ou les chiffres etc. +Les expressions régulières ne sont pas expliquées dans ce manuel. +Pour un tutoriel d'introduction, veuillez consulter le [Guide des expressions régulières de Python](https://docs.python.org/3.11/howto/regex.html). + +#### Prononciation des ponctuations et symboles {#SymbolPronunciation} + +Ce dialogue vous permet de modifier la façon dont les ponctuations et autres symboles sont prononcés ainsi que le niveau de symbole auquel ils sont annoncés. + +La langue pour laquelle la prononciation des symboles est en cours d'édition sera indiquée dans le titre du dialogue. +Notez que ce dialogue tient compte de l'option "Se baser sur la langue de la voix pour le traitement des caractères et symboles" qui se trouve dans la catégorie [Parole](#SpeechSettings) du dialogue [Paramètres de NVDA](#NVDASettings). Il utilise la langue de la voix plutôt que le paramètre global langue de NVDA quand cette option est activée. + +Pour modifier un symbole, sélectionnez-le d'abord dans la liste de symboles. +Vous pouvez filtrer les symboles en entrant le symbole ou une partie du remplacement du symbole dans le champ d'édition Filtrer par. + +* Le champ "Remplacement" vous permet de modifier le texte qui doit être prononcé à la place de ce symbole. +* En utilisant le champ "Niveau", vous pouvez ajuster le niveau minimum auquel ce symbole doit être annoncé (aucun, quelques-uns, la plupart ou tous). +Vous pouvez également définir le niveau sur caractère ; dans ce cas, le symbole ne sera pas prononcé quel que soit le niveau de symbole utilisé, avec les deux exceptions suivantes : + * Quand vous naviguez caractère par caractère. + * Quand NVDA épelle un texte contenant ce symbole. +* Le champ "Envoyer le symbole réel au synthétiseur" spécifie quand le symbole lui-même (au lieu de son remplacement) devrait être envoyé au synthétiseur. +Ceci est utile si le symbole force le synthétiseur à marquer une pause ou modifie l'inflexion de la voix. +Par exemple, une virgule force le synthétiseur à marquer une pause. +Il y a trois options : + * jamais : Ne jamais envoyer le symbole réel au synthétiseur. + * toujours : Toujours envoyer le symbole réel au synthétiseur. + * seulement au-dessous du niveau du symbole : N'envoyer le symbole réel que si le niveau de symboles configuré est inférieur au niveau assigné à ce symbole. + Par exemple, vous pourriez utiliser cela pour qu'un symbole ait son remplacement annoncés à hauts niveaux sans marquer de pause, tout en étant indiqué par une pause aux niveaux inférieurs. + +Vous pouvez ajouter de nouveaux symboles en pressant le bouton Ajouter. +Dans le dialogue qui apparaît, saisissez le symbole et pressez le bouton OK. +Puis, changez les champs pour le nouveau symbole comme vous le feriez pour les autres symboles. + +Vous pouvez supprimer un symbole précédemment ajouté en pressant le bouton Supprimer. + +Quand vous avez fini, cliquez sur le bouton "OK" pour sauvegarder vos modifications, ou le bouton "Annuler" pour les supprimer. + +Dans le cas de symboles complexes, le champ Remplacement peut inclure quelques références aux groupes du texte source. Par exemple, pour un modèle correspondant à une date complète, \1, \2 et \3 devraient apparaître dans le champ, pour être remplacés par les parties correspondantes de la date. +Ainsi, dans le champ Remplacement, les barres obliques normales doivent être doublées, ex : "a\\b" doit être tapé pour obtenir le remplacement de "a\b". + +#### Gestes de commandes {#InputGestures} + +Dans ce dialogue, vous pouvez configurer les gestes de commandes (raccourcis clavier, boutons d'un afficheur braille etc.) pour les commandes NVDA. + +Seules les commandes qui sont applicables immédiatement avant l'ouverture du dialogue sont affichées. +Par exemple, si vous souhaitez personnaliser des commandes liées au mode navigation, vous devez ouvrir le dialogue des gestes de commandes lorsque vous êtes en mode navigation. + +L'arborescence de ce dialogue répertorie toutes les commandes NVDA applicables regroupées par catégories. +Vous pouvez les filtrer en entrant un ou plusieurs mots du nom de la commande dans la zone d'édition Filtrer par dans n'importe quel ordre. +Tous les gestes associés à une commande sont énumérés au niveau suivant la commande. + +Pour ajouter un geste à une commande, sélectionnez la commande et appuyez sur le bouton "Ajouter". +Ensuite, effectuez le geste de commande que vous souhaitez associer, par exemple appuyez sur une touche du clavier ou un bouton sur l'afficheur braille. +Parfois, un geste peut être interprété de plusieurs façons. +Par exemple, si vous avez appuyé sur une touche du clavier, vous voudrez peut-être qu'elle soit spécifique à la configuration actuelle du clavier (par exemple, ordinateur de bureau ou ordinateur portable) ou vous voudrez peut-être l'appliquer pour toutes les configurations. +Dans ce cas, un menu apparaît, vous permettant de sélectionner l'option désirée. + +Pour supprimer un geste d'une commande, sélectionnez le geste et appuyez sur le bouton "Supprimer". + +La catégorie Touches émulées du clavier système contient des commandes NVDA qui émulent des touches sur le clavier du système. +Ces touches émulées du clavier système peuvent être utilisées pour contrôler une touche du système directement depuis votre terminal braille. +Pour ajouter un geste d'émulation, sélectionnez la catégorie Touches émulées du clavier système et pressez le bouton Ajouter. +Puis, pressez sur le clavier la touche que vous voulez émuler. +Après ça, la touche sera disponible dans la catégorie Touche émulées du clavier système et vous pourrez lui assigner un geste de commande comme décrit plus haut. + +Note : + +* Les touches émulées doivent avoir un geste assigné pour persister lors de la sauvegarde ou de la fermeture du dialogue. +* Un geste de commande avec modificateur peut ne pas pouvoir êttre assigné à un geste émulé sans modificateur +Par exemple, définir le `a` comme touche émulée et configurer un geste de commande `ctrl+m`, peut avoir comme résultat que l'application reçoit `ctrl+a`. + +Lorsque vous avez terminé vos modifications, appuyez sur le bouton "OK" pour les sauvegarder ou sur le bouton "Annuler" pour les ignorer. + +### Sauvegarder et recharger la configuration {#SavingAndReloading} + +Par défaut NVDA sauvegarde automatiquement vos paramètres. +Notez cependant que ce comportement peut être modifié dans le dialogue "Paramètres généraux" du menu "Préférences". +Pour sauvegarder manuellement les paramètres à n'importe quel moment, utilisez l'élément "Sauvegarder la configuration" dans le menu NVDA. + +Si vous faites une erreur dans vos paramètres et avez besoin de revenir aux valeurs précédentes, utilisez l'élément "Revenir à la configuration sauvegardée" dans le menu NVDA. +Vous pouvez également réinitialiser votre configuration aux valeurs d'usine en utilisant l'élément "Réinitialiser la configuration aux valeurs par défaut" également disponible dans le menu de NVDA. + +Les touches de commandes suivantes sont également utiles : + + +| Nom |Ordinateur de bureau |Ordinateur portable |Description| +|---|---|---|---| +|Sauvegarder la configuration |NVDA+contrôle+c |NVDA+contrôle+c |Sauvegarde votre configuration pour qu'elle ne soit pas perdue en quittant NVDA| +|Réinitialiser la configuration |NVDA+contrôle+r |NVDA+contrôle+r |Appuyez une fois pour réinitialiser à la configuration qui existait lors de votre dernière sauvegarde. Appuyez trois fois pour revenir à la configuration par défaut de NVDA.| + + + +### Profils de configuration {#ConfigurationProfiles} + +Parfois, vous souhaiteriez avoir des paramètres différents pour des situations différentes. +Par exemple, vous pourriez avoir l'annonce de retrait activée pendant que vous éditez ou l'annonce des attributs de la police activée pendant que vous corrigez. +NVDA vous permet de faire cela en utilisant des profils de configuration. + +Un profil de configuration contient uniquement les paramètres qui sont modifiés alors que le profil est en cours d'édition. +La plupart des paramètres peuvent être modifiés dans les profils de configuration à l'exception de ceux de la catégorie Général du dialogue [Paramètres](#NVDASettings), qui s'appliquent à l'ensemble de NVDA. + +Les profils de configuration peuvent être activés manuellement soit à partir d'un dialogue soit en utilisant un geste de commande personnalisé. +Ils peuvent également être activés automatiquement grâce à des déclencheurs tels que le passage à une application particulière. + +#### Gestion basique {#ProfilesBasicManagement} + +Vous pouvez gérer les profils de configuration en sélectionnant "Profils de configuration" dans le menu NVDA. +Vous pouvez aussi le faire en utilisant un raccourci clavier : + + +* NVDA+contrôle+p : Afficher le dialogue "Profils de configuration". + + + +Le premier élément dans ce dialogue est la liste des profils à partir de laquelle vous pouvez sélectionner un des profils disponibles. +Lorsque vous ouvrez le dialogue, le profil en cours d'édition est sélectionné. +Des informations complémentaires sont également indiquées pour les profils actifs, indiquant s'ils sont activés manuellement, déclenchés et/ou en cours d'édition. + +Pour renommer ou supprimer un profil, appuyez sur le bouton "Renommer" ou "Supprimer", respectivement. + +Appuyez sur le bouton "Fermer" pour fermer le dialogue. + +#### Création d'un profil {#ProfilesCreating} + +Pour créer un profil, appuyez sur le bouton "Nouveau". + +Dans le dialogue "Nouveau profil", vous pouvez entrer un nom pour le profil. +Vous pouvez également choisir comment ce profil doit être utilisé. +Si vous ne souhaitez utiliser ce profil que manuellement, sélectionnez activation manuelle, qui est la valeur par défaut. +Sinon, sélectionnez un déclencheur qui doit activer automatiquement ce profil. +Pour plus de commodité, si vous n'avez pas saisi un nom pour le profil, sélectionner un déclencheur le fera pour vous. +Reportez-vous [ci-dessous](#ConfigProfileTriggers) pour plus d'informations. + +Appuyer sur "OK" crée le profil et ferme le dialogue de configuration de sorte que vous pouvez le modifier. + +#### Activation manuelle {#ConfigProfileManual} + +Vous pouvez activer manuellement un profil en sélectionnant un profil et en cliquant sur le bouton "Activation manuelle". +Une fois activé, d'autres profils peuvent toujours être activés par des déclencheurs, mais les paramètres dans le profil activé manuellement remplacent ceux des profils activés par ces déclencheurs. +Par exemple, si un profil est déclenché pour l'application actuelle et que l'annonce des liens est activée dans ce profil mais désactivée dans le profil activé manuellement, les liens ne seront pas annoncés. +Toutefois, si vous avez changé la voix dans le profil déclenché mais que vous ne l'avez jamais changée dans le profil activé manuellement, la voix du profil déclenché sera utilisée. +Tous les paramètres que vous modifiez, seront sauvegardés dans le profil activé manuellement. +Pour désactiver un profil activé manuellement, sélectionnez-le dans le dialogue "Profils de configuration" et appuyez sur le bouton "Désactiver manuellement". + +#### Déclencheurs {#ConfigProfileTriggers} + +En appuyant sur le bouton "Déclencheurs" dans le dialogue "Profils de configuration", vous pouvez modifier les profils qui doivent être activés automatiquement par divers déclencheurs. + +La liste des déclencheurs affiche les déclencheurs disponibles, qui sont comme suit : + +* Application en cours : déclenché lors de l'activation de l'application en cours. +* Dire tout: déclenché lors de la lecture avec la commande "Dire Tout". + +Pour modifier le profil qui doit être automatiquement activé par un déclencheur, sélectionnez le déclencheur, puis sélectionnez le profil désiré dans la liste des profils. +Vous pouvez sélectionner "Configuration normale" si vous ne voulez pas utiliser de profil. + +Cliquez sur le bouton "Fermer" pour revenir au dialogue "Profils de configuration". + +#### Éditer un profil {#ConfigProfileEditing} + +Si vous avez activé manuellement un profil, les paramètres modifiés seront sauvegardés dans ce profil. +Autrement, tous les paramètres modifiés seront sauvegardés dans le profil le plus récemment déclenché. +Par exemple, si vous avez associé un profil avec l'application "Bloc-notes" et que vous basculez vers le "Bloc-notes", tous les paramètres modifiés seront sauvegardés dans ce profil. +Enfin, s'il n'y a ni profil activé manuellement, ni profil déclenché, tous les paramètres que vous modifierez seront sauvegardés dans votre configuration normale. + +Pour éditer le profil utilisé dans "Dire Tout", vous devez [activer manuellement](#ConfigProfileManual) ce profil. + +#### Désactiver temporairement tous les déclencheurs {#ConfigProfileDisablingTriggers} + +Parfois, il peut être utile de désactiver temporairement les déclencheurs. +Par exemple, vous voudrez peut-être modifier un profil activé manuellement ou votre configuration normale sans profils déclenchés interférents. +Vous pouvez le faire en cochant la case "Désactiver temporairement tous les déclencheurs" dans le dialogue "Profils de configuration". + +Pour activer ou désactiver les déclencheurs de n'importe où, veuillez assigner un geste de commande en utilisant le dialogue [Gestes de Commandes](#InputGestures). + +#### Activer un profil en utilisant les gestes de commandes {#ConfigProfileGestures} + +Pour chaque profil que vous ajoutez, vous pouvez assigner un ou plusieurs gestes de commandes pour l'activer. +Par défaut, les profils de configuration n'ont pas de geste de commande assigné. +Vous pouvez ajouter des gestes pour activer un profil en utilisant le dialogue [Gestes de Commandes](#InputGestures). +Chaque profil a sa propre entrée dans la catégorie profils de configuration. +Quand vous renommez un profil, tous les gestes que vous avez ajoutés restent disponibles. +La suppression d'un profil entraîne la suppression de tous les gestes qui lui sont associés. + +### Emplacement des fichiers de configuration {#LocationOfConfigurationFiles} + +Les versions portables de NVDA enregistrent tous les paramètres et extensions dans un répertoire nommé "userConfig" situé dans le répertoire de votre copie portable de NVDA. + +Les versions installées de NVDA enregistrent tous les paramètres et extensions dans un répertoire spécial de NVDA situé dans votre profil utilisateur Windows. +Cela signifie que chaque utilisateur du système peut avoir ses propres paramètres NVDA. +Pour ouvrir votre répertoire de paramètres de n'importe où vous pouvez utiliser [le dialogue Geste de commandes](#InputGestures) pour ajouter un geste personnalisé. +De plus, pour une version installée de NVDA, depuis le menu démarrer vous pouvez aller dans programmes -> NVDA -> explorer le répertoire de configuration utilisateur de NVDA. + +Les paramètres qu'utilise NVDA quand il s'exécute sur l'écran de connexion ou l'écran UAC sont enregistrés dans le répertoire "systemConfig" situé dans le répertoire NVDA. +En général, cette configuration n'a pas à être modifiée. +Pour modifier cette configuration, configurez NVDA à votre convenance, sauvegardez la configuration puis cliquez sur le bouton "Utiliser les paramètres NVDA actuellement sauvegardés pour l'écran de connexion à Windows (nécessite des privilèges administrateur)" dans la catégorie Général du dialogue [Paramètres](#NVDASettings). + +## Extensions et Add-on Store {#AddonsManager} + +Les extensions sont des paquets logiciels qui fournissent des fonctionnalités nouvelles ou modifiées pour NVDA. +Elles sont développées par la communauté NVDA et des organisations externes telles que des fournisseurs commerciaux. +Les extensions peuvent effectuer l'une des opérations suivantes : + +* Ajoutez ou améliorez la prise en charge de certaines applications. +* Fournir un support pour des afficheurs braille supplémentaires ou des synthétiseurs vocaux. +* Ajouter ou modifier des fonctionnalités dans NVDA. + +L'Add-on Store de NVDA vous permet de parcourir et de gérer les paquets d'extensions. +Toutes les extensions disponibles dans l'Add-on Store peuvent être téléchargées gratuitement. +Cependant, certaines d'entre elles peuvent exiger que les utilisateurs paient une licence ou un logiciel supplémentaire avant de pouvoir les utiliser. +Les synthétiseurs vocaux commerciaux sont un exemple de ce type d'extension. +Si vous installez une extension avec des composants payants et que vous changez d'avis quant à son utilisation, l'extension peut être facilement supprimée. + +L'Add-on Store est accessible depuis le sous-menu Outils du menu NVDA. +Pour accéder à l'Add-on Store de n'importe où, attribuez un geste personnalisé à l'aide de la [boîte de dialogue Gestes de commandes](#InputGestures). + +### Parcourir les extensions {#AddonStoreBrowsing} + +Lorsqu'il est ouvert, l'Add-on Store affiche une liste d'extensions. +Si vous n'avez pas encore installé d'extension, l'Add-on Store s'ouvrira sur une liste d'extensions disponibles à installer. +Si vous avez installé des extensions, la liste affichera les extensions actuellement installées. + +Sélectionner une extension, en vous déplaçant dessus avec les touches fléchées haut et bas, affichera les détails de l'extension. +Les extensions ont des actions associées auxquelles vous pouvez accéder via un [menu d'actions](#AddonStoreActions), telles que l'installation, l'aide, la désactivation et la suppression. +Les actions disponibles changeront selon que l'extension est installée ou non, et si elle est activée ou désactivée. + +#### Vues de la liste des extensions {#AddonStoreFilterStatus} + +Il existe différentes vues pour les extensions installées, pouvant être mis à jour, disponibles et incompatibles. +Pour changer la vue des extensions, changez l'onglet actif de la liste des extensions en utilisant `ctrl+tab`. +Vous pouvez également `tabuler` dans la liste des vues et vous déplacer à travers elles avec les touches `flècheGauche` et `flècheDroite`. + +#### Filtrage des extensions activées ou désactivées {#AddonStoreFilterEnabled} + +Normalement, une extension installée est "activée", ce qui signifie qu'elle est en cours d'exécution et disponible dans NVDA. +Cependant, certaines de vos extensions installées peuvent être définies sur l'état "désactivé". +Cela signifie qu'elles ne seront pas utilisées et que leurs fonctions ne seront pas disponibles pendant votre session NVDA en cours. +Vous avez peut-être désactivé une extension parce qu'elle était en conflit avec une autre extension ou avec une certaine application. +NVDA peut également désactiver certaines extensions, si elles s'avèrent incompatibles lors d'une mise à jour de NVDA ; mais vous serez averti si cela se produit. +Les extensions peuvent également être désactivées si vous n'en avez tout simplement pas besoin pendant une période prolongée, mais que vous ne souhaitez pas les désinstaller car vous pensez en avoir besoin à nouveau à l'avenir. + +Les listes d'extensions installées et incompatibles peuvent être filtrées par leur état activé ou désactivé. +La valeur par défaut affiche les extensions activées et désactivées. + +#### Inclure les extensions incompatibles {#AddonStoreFilterIncompatible} + +Les extensions disponibles et pouvant être mises à jour peuvent être filtrées pour inclure les [extensions incompatibles](#incompatibleAddonsManager) qui sont disponibles pour l'installation. + +#### Filtrer les extensions par canal {#AddonStoreFilterChannel} + +Les extensions peuvent être distribuées via quatre canaux : + +* Stable : le développeur a publié ceci en tant qu'extension testée avec une version publiée de NVDA. +* Bêta : Cette extension peut nécessiter des tests supplémentaires, mais elle est publiée pour les commentaires des utilisateurs. +Suggéré pour les premiers utilisateurs. +* Dev : ce canal est suggéré pour être utilisé par les développeurs d'extensions pour tester les modifications d'API non publiées. +Les testeurs alpha de NVDA peuvent avoir besoin d'utiliser une version "Dev" de leurs extensions. +* Externe : extensions installées à partir de sources externes, en dehors de l'Add-on Store. + +Pour lister les extensions uniquement pour des canaux spécifiques, modifiez la sélection du filtre "Canal". + +#### Recherche d'extensions {#AddonStoreFilterSearch} + +Pour rechercher des extensions, utilisez la zone de texte "Rechercher". +Vous pouvez y accéder en appuyant sur `maj+tab` dans la liste des extensions. +Tapez un ou deux mots-clés pour le type d'extension que vous recherchez, puis `tabulation` pour aller à la liste des extensions. +Les extensions seront répertoriées si le texte de recherche peut être trouvé dans l'ID, le nom, l'éditeur l'auteur ou la description de l'extension. + +### Actions sur les extensions {#AddonStoreActions} + +Les extensions ont des actions associées, telles que installer, aide, désactiver et supprimer. +Pour une extension de la liste des extensions, ces actions sont accessibles via un menu qu'on ouvre en appuyant sur la touche `applications`, `entrée`, un clic droit ou un double-clic sur l'extension. +Ce menu est également accessible par un bouton Actions dans les détails de l'extension sélectionnée. + +#### Installation d'extensions {#AddonStoreInstalling} + +Ce n'est pas parce qu'une extension est disponible dans l'Add-on Store de NVDA qu'elle a été approuvée ou vérifiée par NV Access ou qui que ce soit d'autre. +Il est très important de n'installer que des extensions provenant de sources de confiance. +La fonctionnalité des extensions est illimitée dans NVDA. +Cela peut inclure l'accès à vos données personnelles ou même à l'ensemble du système. + +Vous pouvez installer et mettre à jour des extensions en [parcourant les extensions disponibles](#AddonStoreBrowsing). +Sélectionnez une extension dans l'onglet "Extensions disponibles" ou "Mises à jour". +Utilisez ensuite l'action de mise à jour, d'installation ou de remplacement pour démarrer l'installation. + +Vous pouvez également installer plusieurs extensions à la fois. +Cela se fait en sélectionnant plusieurs extensions dans l'onglet des extensions disponibles, puis en activant le menu contextuel sur la sélection et en choisissant l'action "Installer les extensions sélectionnées". + +Pour installer une extension que vous avez obtenue en dehors de l'Add-on Store, appuyez sur le bouton "Installer à partir d'une source externe". +Cela vous permettra de rechercher un paquet d'extension (fichier `.nvda-addon`) quelque part sur votre ordinateur ou sur un réseau. +Une fois que vous avez ouvert le paquet d'extension le processus d'installation commencera. + +Si NVDA est installé et en cours d'exécution sur votre système, vous pouvez également ouvrir un fichier d'extension directement depuis le navigateur ou le système de fichiers pour commencer le processus d'installation. + +Lorsqu'une extension est installée depuis une source externe, NVDA vous demandera de confirmer l'installation. +Une fois l'extension installée, NVDA doit être redémarré pour que l'extension démarre, bien que vous puissiez reporter le redémarrage de NVDA si vous avez d'autres extensions à installer ou à mettre à jour. + +#### Suppression des extensions {#AddonStoreRemoving} + +Pour supprimer une extension, sélectionnez-la dans la liste et utilisez l'action Supprimer. +NVDA vous demandera de confirmer la suppression. +Comme pour l'installation, NVDA doit être redémarré pour que l'extension soit complètement supprimée. +En attendant, un statut "En attente de suppression" sera affiché pour cette extension dans la liste. +Comme pour l'installation, vous pouvez également supprimer plusieurs extensions à la fois. + +#### Désactivation et activation des extensions {#AddonStoreDisablingEnabling} + +Pour désactiver une extension, utilisez l'action "désactiver". +Pour activer une extension précédemment désactivée, utilisez l'action "activer". +Vous pouvez désactiver une extension si l'état de l'extension indique qu'elle est "activée" ou l'activer si l'extension est "désactivée". +Pour chaque utilisation de l'action activer/désactiver, le statut de l'extension change pour indiquer ce qui se passera au redémarrage de NVDA. +Si l'extension était auparavant "désactivée", l'état affichera "activé après le redémarrage". +Si l'extension était précédemment "activée", l'état affichera "désactivé après le redémarrage". +Tout comme lorsque vous installez ou supprimez des extensions, vous devez redémarrer NVDA pour que les modifications prennent effet. +Vous pouvez également activer ou désactiver plusieurs extensions à la fois en sélectionnant plusieurs extensions dans l'onglet des extensions disponibles, puis en activant le menu contextuel sur la sélection et en choisissant l'action appropriée. + +#### Examiner les extension et lire les avis {#AddonStoreReviews} + +Vous souhaiterez peut-être lire les avis d'autres utilisateurs qui ont déjà utilisé une extension par exemple avant de l'installer ou pendant que vous apprenez à l'utiliser. +En outre, il est utile pour les autres utilisateurs que vous déposiez des commentaires sur les extensions que vous avez testées. +Pour lire les avis sur une extension, sélectionnez-la et utilisez l'action "Avis de la communauté". +Cela renvoie vers une page Web de discussion GitHub, où vous pourrez lire et rédiger des avis sur l'extension. +Veuillez noter que cela ne remplace pas une communication directe avec les développeurs d'extension. +Le but de cette fonctionnalité est plutôt de partager des commentaires pour aider les utilisateurs à décider si une extension peut leur être utile. + +### Extensions incompatibles {#incompatibleAddonsManager} + +Certaines extensions anciennes peuvent ne plus être compatibles avec la version de NVDA que vous possédez. +Si vous utilisez une ancienne version de NVDA, certaines nouvelles extensions peuvent ne pas être compatibles non plus. +Toute tentative d'installation d'une extension incompatible entraînera une erreur expliquant pourquoi l'extension est considérée comme incompatible. + +Pour les extensions plus anciennes, vous pouvez ignorer l'incompatibilité à vos risques et périls. +Les extensions incompatibles peuvent ne pas fonctionner avec votre version de NVDA et peuvent provoquer un comportement instable ou inattendu, y compris des plantages. +Vous pouvez ignorer la compatibilité lors de l'activation ou de l'installation d'une extension. +Si l'extension incompatible cause des problèmes ultérieurement, vous pouvez la désactiver ou la supprimer. + +Si vous rencontrez des problèmes pour exécuter NVDA et que vous avez récemment mis à jour ou installé une extension, en particulier s'il s'agit d'une extension incompatible, vous pouvez essayer d'exécuter temporairement NVDA avec toutes les extensions désactivées. +Pour redémarrer NVDA avec toutes les extensions désactivées, choisissez l'option appropriée lorsque vous quittez NVDA. +Vous pouvez également utiliser l'[option de ligne de commande](#CommandLineOptions) `--disable-addons`. + +Vous pouvez parcourir les extensions incompatibles disponibles à l'aide des [onglets d'extensions disponibles et mises à jour](#AddonStoreFilterStatus). +Vous pouvez parcourir les extensions incompatibles installées à l'aide de l'[onglet extensions incompatibles](#AddonStoreFilterStatus). + +## Outils Additionnels {#ExtraTools} +### Visionneuse du Journal {#LogViewer} + +La visionneuse du journal, située dans "Outils" du menu NVDA, vous permet de consulter les événements enregistrés depuis le démarrage de la dernière session de NVDA. + +En plus de lire le contenu, vous pouvez également sauvegarder une copie du journal ou réactualiser la visionneuse de manière à charger les nouveaux événements générés après que la visionneuse ait été ouverte. +Ces actions sont disponibles dans le menu Journal de la visionneuse. + +Le fichier qui s'affiche lorsque vous ouvrez la visionneuse de journaux est enregistré sur votre ordinateur à l'emplacement du fichier `%temp%\nvda.log`. +Un nouveau fichier de journal est créé à chaque démarrage de NVDA. +A ce moment, le fichier de journal de la session NVDA précédente est déplacé vers `%temp%\nvda-old.log`. + +Vous pouvez également copier un fragment du fichier de journal courant dans le presse-papiers sans ouvrir la visionneuse de journaux. + + +| Nom |Touche |Description| +|---|---|---| +|Ouvrir la visionneuse de journaux |`NVDA+f1` |Ouvre la visionneuse de journaux et affiche des informations pour le développeur sur l'objet navigateur courant.| +|Copier un fragment du journal dans le presse-papiers |`NVDA+contrôle+maj+f1` |Au premier appui, le point de départ pour le contenu du journal qui doit être capturé est défini. Au deuxième appui, le contenu du journal depuis le point de départ est copié dans votre presse-papiers.| + + + +### Visionneuse de Parole {#SpeechViewer} + +Pour les développeurs voyants ou les personnes présentant NVDA à un public voyant, une fenêtre flottante est disponible, affichant tout ce que dit NVDA. + +Pour activer la visionneuse de parole, cochez l'élément de menu "Visionneuse de parole" situé dans "Outils" dans le menu NVDA. +Décochez l'élément de menu pour la désactiver. + +La fenêtre de la visionneuse de parole contient une case à cocher nommée "Montrer la visionneuse de parole au démarrage". +Si elle est cochée, la visionneuse de parole s'ouvrira au démarrage de NVDA. +La fenêtre de la visionneuse de parole essaiera toujours de s'ouvrir à la même dimension et à la même position que lors de sa fermeture. + +Pendant que la visionneuse de parole est active, elle se met constamment à jour, vous permettant de voir les dernières paroles prononcées par NVDA. +Cependant, si vous déplacez la souris ou mettez le focus sur la visionneuse, NVDA arrêtera momentanément de mettre à jour le texte, vous pourrez ainsi sélectionner ou copier le contenu. + +Pour activer la visionneuse de parole de n'importe où, Veuillez assigner un geste personnalisé en utilisant le [dialogue Gestes de Commandes](#InputGestures). + +### Visionneuse Braille {#BrailleViewer} + +Pour les voyants développeurs de logiciel ou les personnes présentant NVDA à un public voyant, une fenêtre flottante permettant de voir la sortie braille ainsi que le texte correspondant à chaque caractère braille est disponible. +La visionneuse Braille peut être utilisée en même temps qu'un afficheur braille physique, elle s'adaptera au nombre de cellules sur l'afficheur physique. +Quand la visionneuse Braille est activée, elle se met à jour constamment pour vous montrer ce qui serait affiché sur un afficheur braille physique. + +Pour activer la visionneuse Braille, cochez l'élément de menu "Visionneuse Braille" dans Outils dans le menu de NVDA. +Décochez l'élément de menu pour la désactiver. + +Les afficheurs braille physiques ont généralement des boutons pour faire défiler le texte en avant ou en arrière, pour permettre le défilement avec la visionneuse Braille utilisez le [dialogues de Gestes de Commandes](#InputGestures) pour assigner des raccourcis clavier pour "faire défiler l'afficheur braille en arrière" et "faire défiler l'afficheur braille en avant" + +La fenêtre de la visionneuse Braille contient une case à cocher étiquetée "Montrer la visionneuse Braille au démarrage". +Si elle est cochée, la visionneuse Braille s'affichera au démarrage de NVDA. +La visionneuse Braille essaiera toujours de se rouvrir avec les mêmes dimensions et à la même position que lors de sa fermeture. + +La fenêtre de la visionneuse braille contient une case à cocher étiquetée "Survol pour le routage vers une cellule", non cochée par défaut. +Si elle est cochée, le survol d'une cellule braille par la souris permettra d'activer la commande "aller à la cellule braille" pour cette cellule. +Ceci est parfois utilisé pour déplacer le curseur ou activer l'action pour un contrôle. +Ceci peut être utile pour tester si NVDA est capable de retrouver correctement une position à l'écran depuis une cellule braille. +Pour empêcher des routages cellules non intentionnels, la commande s'exécute après un délai. +La souris doit survoler jusqu'à ce que la cellule devienne verte. +La cellule commencera avec une couleur jaune clair, virera à l'orange, puis deviendra brusquement verte. + +Pour activer/désactiver la visionneuse braille de n'importe où, Veuillez assigner un geste de commande personnalisé en utilisant le [dialogue Gestes de commandes](#InputGestures). + +### Console Python {#PythonConsole} + +La console Python de NVDA, disponible sous Outils dans le menu NVDA, est un outil de développement utile pour le débogage, l'inspection générale des internes de NVDA ou l'inspection de la hiérarchie d'accessibilité d'une application. +Pour plus d'informations, veuillez consulter le [Guide de développement NVDA](https://www.nvaccess.org/files/nvda/documentation/developerGuide.html). + +### Add-on Store {#AddonStoreMenuItem} + +Cela ouvrira l'[Add-on Store de NVDA](#AddonsManager). +Pour plus d'informations, lisez la section détaillée : [Extensions et Add-on Store](#AddonsManager). + +### Créer une copie portable {#CreatePortableCopy} + +Ceci ouvrira un dialogue vous permettant de créer une copie portable de NVDA à partir de la version installée. +Au contraire, lors de l'exécution d'une copie portable de NVDA, dans le sous-menu Outils l'élément s'intitulera "installer NVDA sur ce PC" au lieu de "créer une copie portable". + +Le dialogue de création d'une copie portable ou d'installation de NVDA sur ce PC vous demandera de choisir un dossier où créer la copie portable ou installer NVDA. + +Dans ce dialogue vous pourrez activer ou désactiver ce qui suit : + +* Copier la configuration utilisateur actuelle (Ceci inclut les fichiers contenus dans %appdata%\roaming\NVDA ou dans la configuration utilisateur de votre copie portable et inclut également les extensions ou autres modules) +* Démarrer la nouvelle copie portable après création ou démarrer NVDA après installation (démarre automatiquement NVDA après création de la copie portable ou après installation) + +### Exécuter l'outil de correction d'enregistrements COM... {#RunCOMRegistrationFixingTool} + +Installer et désinstaller des programmes sur un ordinateur peut, dans certains cas, causer le désenregistrement des fichiers DLL COM. +Comme les interfaces COM tels que IAccessible dépendent de l'enregistrement correct des DLL COM, des problèmes peuvent apparaître en cas d'absence d'enregistrement de celles-ci. + +Cela peut survenir par exemple après installation et désinstallation d'Adobe Reader, Math Player et autres programmes. + +Les enregistrements manquants peuvent causer des problèmes dans les navigateurs, les applications de bureau, barre des tâches et autres interfaces. + +Spécifiquement, Les problèmes suivants peuvent être réglés par l'exécution de cet outil : + +* NVDA annonce "inconnu" en navigation avec des navigateurs tels que Firefox, Thunderbird etc. +* NVDA échoue à basculer entre mode formulaire et mode navigation. +* NVDA est très lent dans les navigateurs en mode navigation. +* Et possiblement d'autres problèmes. + +### Recharger les modules {#ReloadPlugins} + +Cet élément, quand on l'active, recharge les modules applicatifs et globaux sans avoir à redémarrer NVDA, ce qui peut être utile pour les développeurs. +Les modules applicatifs (appModules) gèrent la manière dont NVDA interagit avec des applications spécifiques. +Les modules globaux (globalPlugins) gèrent la manière dont NVDA interagit avec toutes les applications. + +Les raccourcis clavier NVDA suivants peuvent également être utiles : + + +| Nom |Touche |Description| +|---|---|---| +|Recharger les modules |`NVDA+contrôle+f3` |Recharger les modules globaux et applicatifs| +|Annoncer le module applicatif chargé et l'exécutable |`NVDA+contrôle+f1` |Annoncer le nom du module applicatif, s'il y en a un, et le nom de l'exécutable associé à l'application qui a le focus clavier.| + + + +## Synthétiseurs de Parole Pris en Charge {#SupportedSpeechSynths} + +Cette section contient des informations concernant les synthétiseurs de parole pris en charge par NVDA. +Pour une liste encore plus importante de synthétiseurs gratuits ou du commerce que vous pouvez acheter et télécharger pour utilisation avec NVDA, veuillez consulter la [page des voix supplémentaires](https://github.com/nvaccess/nvda/wiki/ExtraVoices) (en anglais). + +### eSpeak NG {#eSpeakNG} + +Le synthétiseur [eSpeak nG](https://github.com/espeak-ng/espeak-ng) est intégré dans NVDA et ne dépend d'aucun pilote ou programme additionnel pour être installé. +Sous Windows 8.1, NVDA utilise eSpeak NG par défaut ([Windows OneCore](#OneCore) est utilisé sous Windows 10 et versions ultérieures par défaut). +Comme ce synthétiseur est intégré dans NVDA, il est le plus indiqué quand vous voulez exécuter NVDA depuis une clé USB sur un autre système. + +Chaque voix fournie avec eSpeak NG correspond à une langue différente. +eSpeak NG prend en charge plus de 43 langues. + +Vous disposez également d'un grand choix de variantes, permettant de modifier considérablement le son de la voix. + +### Microsoft Speech API Version 4 (SAPI 4) {#SAPI4} + +SAPI 4 est un ancien standard Microsoft pour les synthétiseurs de parole logiciels. +NVDA le supporte encore pour les utilisateurs qui ont déjà des synthétiseurs SAPI 4 installés. +Cependant, Microsoft ne le supporte plus et les composants nécessaires ne sont plus disponibles chez Microsoft. + +Quand vous utilisez ce synthétiseur avec NVDA, la liste des voix disponibles (accessibles via la catégorie [Parole](#SpeechSettings)du dialogue [Paramètres](#NVDASettings), ou [la boucle des paramètres synthétiseur](#SynthSettingsRing)) contient toutes les voix de tous les synthétiseurs SAPI 4 installés sur votre système. + +### Microsoft Speech API Version 5 (SAPI 5) {#SAPI5} + +SAPI 5 est un standard Microsoft pour les synthétiseurs de parole logiciels. +Beaucoup de synthétiseurs de parole compatibles avec ce standard peuvent être achetés ou téléchargés gratuitement auprès de différentes sociétés ou sites web, mais il est probable que votre système possède déjà une voix SAPI 5 préinstallée. +Quand vous utilisez ce synthétiseur avec NVDA, la liste des voix disponibles (accessibles via la catégorie [Parole](#SpeechSettings)du dialogue [Paramètres](#NVDASettings), ou [la boucle des paramètres synthétiseur](#SynthSettingsRing)) contient toutes les voix de tous les synthétiseurs SAPI 5 installés sur votre système. + +### La Plate-forme Microsoft Speech {#MicrosoftSpeechPlatform} + +La plate-forme Microsoft Speech fournit des voix pour beaucoup de langues, normalement utilisées dans le développement de serveurs vocaux. +Ces voix peuvent également être utilisées avec NVDA. + +Pour utiliser ces voix, vous devrez installer deux composants : + +* [Microsoft Speech Platform - Runtime (Version 11), x86](https://www.microsoft.com/download/en/details.aspx?id=27225) +* [Microsoft Speech Platform - Runtime Languages (Version 11)](https://www.microsoft.com/download/en/details.aspx?id=27224) + * Cette page contient beaucoup de fichiers aussi bien pour la reconnaissance de parole que pour la synthèse vocale. + Choisissez les fichiers contenant la synthèse vocale pour la langue désirée. + Par exemple, le fichier MSSpeech_TTS_fr-FR_Hortense.msi est une voix francophone française. + +### Voix Windows OneCore {#OneCore} + +Windows 10 et les versions ultérieures incluent de nouvelles voix appelées "OneCore" ou voix "mobile". +Des voix sont fournies pour beaucoup de langues, et elles sont plus réactives que les voix Microsoft disponibles en utilisant Microsoft Speech API version 5. +Sous Windows 10 et versions ultérieures, NVDA utilise les voix Windows OneCore par défaut ([eSpeak NG](#eSpeakNG) est utilisé dans les autres versions). + +Pour ajouter de nouvelles voix Windows OneCore, rendez-vous à "Voix", dans les paramètres système de Windows. +Utilisez l'option "Ajouter des voix" et recherchez la langue désirée. +Beaucoup de langues incluent de multiples variantes. +"Royaume Uni" et "Australie" sont deux des variantes pour l'Anglais. +"France", "Canada" et "Suisse" sont des variantes disponibles pour le Français. +Recherchez la langue de base (telle que Anglais ou Français), puis trouvez la variante dans la liste. +Sélectionnez toutes les langues désirées et utilisez le bouton "Ajouter" pour les ajouter. +Une fois les langues ajoutées, redémarrez NVDA. + +Veuillez consulter [Langues et voix prises en charge](https://support.microsoft.com/fr-fr/windows/annexe-a-langues-et-voix-prises-en-charge-4486e345-7730-53da-fcfe-55cc64300f01) pour une liste de voix disponibles. + +## Terminaux Braille Pris en Charge {#SupportedBrailleDisplays} + +Cette section contient des informations sur les terminaux braille pris en charge par NVDA. + +### Terminaux supportant la détection automatique en arrière-plan {#AutomaticDetection} + +NVDA a la possibilité de détecter beaucoup de terminaux braille automatiquement en arrière-plan, via USB ou Bluetooth. +Ce comportement est activé en sélectionnant l'option Automatique comme terminal braille préféré dans le [dialogue Paramètres Braille](#BrailleSettings). +Cette option est sélectionnée par défaut. + +Les terminaux suivants supportent cette fonctionnalité de détection automatique. + +* Terminaux Handy Tech +* Terminaux braille Baum/Humanware/APH/Orbit +* Séries HumanWare Brailliant BI/B +* HumanWare BrailleNote +* SuperBraille +* Séries Optelec ALVA 6 +* HIMS Braille Sense/Braille EDGE/Smart Beetle/Sync Braille Series +* Terminaux Eurobraille Esys/Esytime/Iris +* Afficheurs Nattiq nBraille +* Seika Notetaker: MiniSeika (16, 24 cellules), V6, et V6Pro (40 cellules) +* Afficheurs Tivomatic Caiku Albatross 46/80 +* N'importe quel afficheur supportant le protocole standard HID Braille + +### Les Terminaux Focus et PAC Mate de chez Freedom Scientific {#FreedomScientificFocus} + +Tous les terminaux Focus et PAC Mate de chez [Freedom Scientific](https://www.freedomscientific.com/) sont pris en charge quand ils sont connectés en USB ou Bluetooth. +Vous devrez installer les pilotes de terminaux braille de Freedom Scientific sur votre système. +Si vous ne les avez pas déjà, vous pourrez les obtenir sur la [page du pilote d'affichage braille Focus Blue](https://support.freedomscientific.com/Downloads/Focus/FocusBlueBrailleDisplayDriver). +Bien que cette page ne mentionne que le terminal Focus 40 Blue, le pilote supporte tous les terminaux de Freedom Scientific. + +Par défaut, NVDA peut automatiquement détecter et se connecter à ces afficheurs via USB ou Bluetooth. +Cependant, lorsque vous configurez l'afficheur, vous pouvez sélectionner explicitement "USB" ou "Bluetooth" pour restreindre le type de connexion qui sera utilisée. +Cela peut être utile si vous voulez connecter l'afficheur Focus à NVDA via le Bluetooth tout en le chargeant en utilisant l'USB. +La détection automatique de terminaux braille de NVDA reconnaîtra également cet afficheur en USB ou Bluetooth. + +Voici les assignations de touches pour ces terminaux avec NVDA. +Veuillez consulter la documentation du terminal pour savoir où se situent ces touches. + + +| Nom |Touche| +|---|---| +|Défilement arrière de l'affichage braille |topRouting1 (première cellule de l'afficheur)| +|Défilement avant de l'affichage braille |topRouting20/40/80 (dernière cellule de l'afficheur)| +|Défilement arrière de l'affichage braille |barAvancerDeGauche| +|Défilement avant de l'affichage braille |barAvancerDeDroite| +|Basculer le suivi du braille |boutonGDFGauche+boutonGDFDroite| +|Choix de la fonction de la roulette magique gauche |Appui sur la roulette magique gauche| +|Retour arrière en utilisant la roulette magique gauche |roulette magique gauche vers le haut| +|Avancer en utilisant la roulette magique gauche |roulette magique gauche vers le bas| +|Choix de la fonction de la roulette magique droite |Appui sur la roulette magique droite| +|Retour arrière en utilisant la roulette magique droite |roulette magique droite vers le haut| +|Avancer en utilisant la roulette magique droite |roulette magique droite vers le bas| +|Aller à la cellule braille |routage| +|touche maj+tab |barreEspacebraille+point1+point2| +|touche tab |barreEspacebraille+point4+point5| +|touche flèche haut |barreEspacebraille+point1| +|touche flèche bas |barreEspacebraille+point4| +|touche contrôle+flèche gauche |barreEspacebraille+point2| +|touche contrôle+flèche droite |barreEspacebraille+point5| +|flèche gauche |barreEspacebraille+point3| +|flèche droite |barreEspacebraille+point6| +|touche origine |barreEspacebraille+point1+point3| +|touche fin |barreEspacebraille+point4+point6| +|touche contrôle+début |barreEspacebraille+point1+point2+point3| +|touche contrôle+fin |barreEspacebraille+point4+point5+point6| +|touche alt |barreEspacebraille+point1+point3+point4| +|touche alt+tab |barreEspacebraille+point2+point3+point4+point5| +|touche alt+maj+tab |BarreEspacebeBraille+point1+poin2+point5+point6| +|touche windows+tab |barreEspaceBraille+point2+point3+point4| +|touche échap |barreEspacebraille+point1+point5| +|touche Windows |barreEspacebraille+point2+point4+point5+point6| +|touche espace |barreEspacebraille| +|Bascule touche contrôle |barreEspaceBraille+point3+point8| +|Bascule touche alt |barreEspaceBraille+point6+point8| +|Bascule touche Windows |barreEspaceBraille+point4+point8| +|Bascule touche NVDA |barreEspaceBraille+point5+point8| +|Bascule touche majuscule |barreEspaceBraille+point7+point8| +|Bascule touches contrôle et majuscule |barreEspaceBraille+point3+point7+point8| +|Bascule touche alt et majuscule |barreEspaceBraille+point6+point7+point8| +|Bascule touches Windows et majuscule |barreEspaceBraille+point4+point7+point8| +|Bascule touches NVDA et majuscule |barreEspaceBraille+point5+point7+point8| +|Bascule touches contrôle et alt |barreEspaceBraille+point3+point6+point8| +|bascule contrôle, alt et majuscule keys |barreEspaceBraille+point3+point6+point7+point8| +|touche Windows+d (minimiser toutes les applications) |barreEspacebraille+point1+point2+point3+point4+point5+point6| +|Rapporter la ligne courante |barreEspacebraille+point1+point4| +|menu NVDA |barreEspacebraille+point1+point3+point4+point5| + +Pour les nouveaux modèles de Focus qui ont des touches de bascule (focus 40, Focus 80 et Focus Blue) : + +| Nom |Touche| +|---|---| +|Déplacer l'affichage braille vers la ligne précédente |barreBasculeGaucheeHaut, barreBasculeDroiteHaut| +|Déplacer l'affichage braille vers la ligne suivante |barreBasculeGaucheBas, barreBasculeDroiteBas| + +Pour le Focus 80 seulement : + +| Nom |Touche| +|---|---| +|Défiler le braille vers l'arrière |barreBumperHaut, barreBumperHaut| +|Défiler vers l'avant |barreBumperBas, barreBumperBas| + + + +### Séries Optelec ALVA 6/Convertisseur de Protocole {#OptelecALVA} + +Les terminaux BC640 et BC680 de chez [Optelec](https://www.optelec.com/) sont pris en charge quand ils sont connectés en USB ou Bluetooth. +Par ailleurs, vous pouvez connecter un terminal Optelec plus ancien, tel qu'un Braille Voyager, en utilisant un convertisseur de protocole fourni par Optelec. +Vous n'avez besoin d'aucun pilote particulier pour utiliser ces terminaux. +Il suffit de brancher le terminal et de configurer NVDA pour l'utiliser. + +Note : NVDA pourrait être incapable d'utiliser un terminal ALVA BC6 via Bluetooth s'il est appairé en utilisant l'utilitaire ALVA Bluetooth. +Si vous avez appairé votre terminal en utilisant cet utilitaire et que NVDA est incapable de le détecter, nous vous recommandons d'appairer votre terminal ALVA de façon standard en utilisant les paramètres Bluetooth de Windows. + +Note : Bien que certains de ces terminaux aient un clavier braille, ils prennent en charge la conversion braille vers texte par eux-mêmes par défaut. +Cela signifie que le système de saisie du braille de NVDA n'est pas utilisé dans la situation par défaut (le paramètre table de saisie braille n'a pas d'effet). +Pour les terminaux ALVA avec un microprogramme récent, il est possible de désactiver cette simulation de clavier HID en utilisant un geste de commande. + +Voici les assignations de touches pour ces terminaux avec NVDA. +Veuillez consulter la documentation du terminal pour savoir où se situent ces touches. + + +| Nom |Touche| +|---|---| +|Défilement arrière de l'affichage braille |t1, etouch1| +|Amener l'affichage braille à la ligne précédente |t2| +|Aller au focus courant |t3| +|Amener l'affichage braille à la ligne suivante |t4| +|Défilement avant de l'affichage braille |t5, etouch3| +|Aller à la cellule braille |routage| +|Annoncer la mise en forme du texte sous la cellule braille |routage secondaire| +|Activer/désactiver la simulation de clavier HID |t1+spEnter| +|Aller à la première ligne en mode revue |t1+t2| +|Aller à la dernière ligne en mode revue |t4+t5| +|Bascule du suivi braille |t1+t3| +|Annonce du titre |etouch2| +|Annonce de la barre d'état |etouch4| +|Touche maj+tab |sp1| +|Touche alt |sp2, alt| +|Touche échap |sp3| +|Touche tab |sp4| +|Flèche haut |spUp| +|Flèche bas |spDown| +|Flèche gauche |spLeft| +|Flèche droite |spRight| +|Entrée |spEnter, enter| +|date et heure |sp2+sp3| +|Menu NVDA |sp1+sp3| +|Touche Windows+d (Minimiser toutes les applications) |sp1+sp4| +|Touche Windows+b (focus sur la zone de notification) |sp3+sp4| +|Touche Windows |sp1+sp2, windows| +|Touche alt+tab |sp2+sp4| +|Touche contrôle+début |t3+spUp| +|Touche contrôle+fin |t3+spDown| +|Touche début |t3+spLeft| +|Touche fin |t3+spRight| +|touche contrôle |contrôle| + + + +### Les Terminaux Handy Tech {#HandyTech} + +NVDA prend en charge la plupart des terminaux de chez [Handy Tech](https://www.handytech.de/) quand ils sont connectés en USB, par port série ou en Bluetooth. +Pour les terminaux USB les plus anciens, vous devrez installer le pilote USB Handy Tech sur votre système. + +Les terminaux suivants ne sont pas nativement supportés, mais peuvent être utilisé via [le pilote universel Handy Tech](https://handytech.de/en/service/downloads-and-manuals/handy-tech-software/braille-display-drivers) et l'extension NVDA : + +* Braillino +* Bookworm +* Les afficheurs modulaires avec le microprogramme version 1.13 ou inférieure. Veuillez noter que le microprogramme de ces afficheurs peut être mis à jour. + +Voici les assignations de touches pour ces terminaux avec NVDA. +Veuillez consulter la documentation du terminal pour savoir où se situent ces touches. + + +| Nom |Touche| +|---|---| +|Défilement arrière de l'affichage braille |left, up, b3| +|Défilement avant de l'affichage braille |right, down, b6| +|Amener l'affichage braille à la ligne précédente |b4| +|Amener l'affichage braille à la ligne suivante |b5| +|Aller à la cellule braille |routage| +|Touche maj+tab |esc, touche triple action gauche haut+bas| +|Touche alt |b2+b4+b5| +|Touche échap |b4+b6| +|Touche tab |enter, touche triple action droite haut+bas| +|Touche entrée |esc+enter, touche triple action gauche+droite haut+bas, JoystickAction| +|Flèche haut |joystick haut| +|Flèche bas |joystick bas| +|Flèche gauche |joystick gauche| +|Flèche droite |joystick droit| +|Menu NVDA |b2+b4+b5+b6| +|Bascule braille suit |b2| +|Bascule du curseur braille |b1| +|Bascule de présentation du contexte du focus |b7| +|Bascule de la saisie braille |space+b1+b3+b4 (space+capital B)| + + + +### Le Terminal MDV Lilli {#MDVLilli} + +Le terminal braille Lilli distribué par [MDV](https://www.mdvbologna.it/) est supporté. +Vous n'avez besoin d'aucun pilote particulier pour utiliser ce terminal. +Il suffit de brancher le terminal et de configurer NVDA pour l'utiliser. + +Ce terminal ne supporte pas la détection automatique en arrière-plan. + +Voici les assignations de touches pour ce terminal avec NVDA. +Veuillez consulter la documentation du terminal pour savoir où se situent ces touches. + + +| Nom |Touche| +|---|---| +|Défilement arrière de l'affichage braille |LF| +|Défilement avant de l'affichage braille |RG| +|Amener l'affichage braille à la ligne précédente |UP| +|Amener l'affichage braille à la ligne suivante |DN| +|Aller à la cellule braille |route| +|Touche maj+tab |SLF| +|Touche tab |SRG| +|Touche alt+tab |SDN| +|Touche alt+maj+tab |SUP| + + + +### Les Terminaux Baum/Humanware/APH/Orbit {#Baum} + +Plusieurs terminaux [Baum](https://www.baum.de/cms/en/), [HumanWare](https://www.humanware.com/), [APH](https://www.aph.org/) et [Orbit](https://www.orbitresearch.com/) sont pris en charge quand ils sont connectés via USB, Bluetooth ou série. +Les terminaux suivants sont pris en charge : + +* Baum: SuperVario, PocketVario, VarioUltra, Pronto!, SuperVario2, Vario 340 +* HumanWare: Brailliant, BrailleConnect, Brailliant2 +* APH: Refreshabraille +* Orbit: Orbit Reader 20 + +Il est possible que d'autres terminaux fabriqués par Baum fonctionnent, mais cela n'a pas été testé. + +Si vous connectez via USB des terminaux qui n'utilisent pas le mode HID, vous devrez d'abord installer les pilotes USB fournis par le constructeur. +Le VarioUltra et le Pronto! utilisent HID. +Le Refreshabraille et l'Orbit Reader 20 peuvent utiliser HID si configurés de manière appropriée. + +Le mode USB série de l'Orbit Reader 20 n'est actuellement pris en charge que sous Windows 10 et versions ultérieures. +USB HID devrait en général être utilisé à la place. + +Voici les assignations de touches pour ces terminaux avec NVDA. +Veuillez consulter la documentation du terminal pour savoir où se situent ces touches. + + +| Nom |Touche| +|---|---| +|Défilement arrière affichage braille |`d2`| +|Défilement avant affichage braille |`d5`| +|Amener l'affichage sur la ligne précédente |`d1`| +|Amener l'affichage sur la ligne suivante |`d3`| +|Aller à la cellule braille |`routage`| +|touche `Maj+tab` |`espace+point1+point3`| +|touche `tab` |`espace+point4+point6`| +|touche `alt` |`espace+point1+point3+point4` (`espace+m`)| +|touche `échap` |`espace+point1+point5` (`espace+e`)| +|touche `windows` |`espace+point3+point4`| +|touche `alt+tab` |`espace+point2+point3+point4+point5` (`espace+t`)| +|Menu NVDA |`espace+point1+point3+point4+point5` (`espace+n`)| +|touche `windows+d` (minimiser toutes les applications) |`espace+point1+point4+point5` (`espace+d`)| +|Dire tout |`espace+point1+point2+point3+point4+point5+point6`| + +Pour les terminaux possédant un joystick: + +| Nom |Touche| +|---|---| +|Flèche haut |haut| +|Flèche bas |bas| +|Flèche gauche |gauche| +|Flèche droite |droite| +|Touche entrée |select| + + + +### Hedo ProfiLine USB {#HedoProfiLine} + +Le terminal Hedo ProfiLine USB de [Hedo Reha-Technik](https://www.hedo.de/) est supporté. +Vous devrez tout d'abord installer le pilote USB fourni par le constructeur. + +Ce terminal ne supporte pas encore la détection automatique en arrière-plan. + +Voici les assignations de touches pour ce terminal sous NVDA. +Veuillez consulter la documentation du terminal pour savoir où se situent ces touches. + + +| Nom |Touche| +|---|---| +|Défilement arrière de l'affichage |K1| +|Défilement avant de l'affichage |K3| +|Ligne précédente |B2| +|Ligne suivante |B5| +|Aller à la cellule braille |routage| +|Bascule braille suit |K2| +|Dire tout |B6| + + + +### Hedo MobilLine USB {#HedoMobilLine} + +Le terminal Hedo MobilLine USB de [Hedo Reha-Technik](https://www.hedo.de/) est supporté. +Vous devrez tout d'abord installer le pilote USB fourni par le constructeur. + +Ce terminal ne supporte pas encore la détection automatique en arrière-plan. + +Voici les assignations de touches pour ce terminal sous NVDA. +Veuillez consulter la documentation du terminal pour savoir où se situent ces touches. + + +| Nom |Touche| +|---|---| +|Défilement arrière de l'affichage |K1| +|Défilement avant de l'affichage |K3| +|Ligne précédente |B2| +|Ligne suivante |B5| +|Aller à la cellule braille |routage| +|Bascule braille suit |K2| +|Dire tout |B6| + + + +### HumanWare Séries Brailliant BI/B / BrailleNote Touch {#HumanWareBrailliant} + +Les terminaux des séries Brailliant BI & B de [HumanWare](https://www.humanware.com/), incluant le BI 14, BI 32, BI 20X, BI 40, BI 40X et B 80 sont supportés quand ils sont connectés via USB ou Bluetooth. +S'ils sont connectés en USB avec le protocole réglé sur HumanWare, vous devez d'abord installer le pilote USB fourni par le constructeur. +Les pilotes USB ne sont pas nécessaires si le protocole est réglé sur OpenBraille. + +Les terminaux suivants sont également supportés (et ne nécessitent aucun pilote spécial pour être installés): + +* APH Mantis Q40 +* APH Chameleon 20 +* Humanware BrailleOne +* NLS eReader + +Voici les assignations de touches pour Brailliant BI/B et BrailleNote touch sous NVDA. +Veuillez consulter la documentation du terminal pour savoir où se situent ces touches. + +#### Assignations des Touches pour tous les Modèles {#HumanWareBrailliantKeyAssignmentForAllModels} + + + +| Nom |Touche| +|---|---| +|Défilement arrière de l'affichage |gauche| +|Défilement avant de l'affichage |droite| +|Ligne précédente |haut| +|Ligne suivante |bas| +|Aller à la cellule braille |routage| +|Bascule d'attachement du braille |haut+bas| +|Touche flèche haut |espace+point1| +|Touche flèche bas |espace+point4| +|Touche flèche gauche |espace+point3| +|Touche flèche droite |espace+point6| +|Touche maj+tab |espace+point1+point3| +|Touche tab |espace+point4+point6| +|Touche alt |espace+point1+point3+point4 (espace+m)| +|Touche échap |espace+point1+point5 (espace+e)| +|Touche entrée |point8| +|Touche Windows |espace+point3+point4| +|Touche alt+tab |Espace+point2+point3+point4+point5 (espace+t)| +|Menu NVDA |c1+c3+c4+c5 (commande n)| +|Touche Windows+d (minimiser toutes les applications) |c1+c4+c5 (commande d)| +|Dire tout |c1+c2+c3+c4+c5+c6| + + + +#### Assignations de Touches pour les Brailliant BI 32, BI 40 et B 80 {#HumanWareBrailliantKeyAssignmentForBI32BI40AndB80} + + + +| Nom |Touche| +|---|---| +|Menu NVDA |c1+c3+c4+c5 (commande n)| +|Touche windows+d (minimiser toutes les applications) |c1+c4+c5 (commande d)| +|Dire tout |c1+c2+c3+c4+c5+c6| + + + +#### Assignations de Touches pour le Brailliant BI 14 {#HumanWareBrailliantKeyAssignmentForBI14} + + + +| Nom |Touche| +|---|---| +|touche flèche haut |joystick vers le haut| +|touche flèche bas |joystick vers le bas| +|touche flèche gauche |joystick vers la gauche| +|touche flèche droit |joystick vers la droite| +|touche entrée |joystick action| + + + +### HIMS Braille Sense/Braille EDGE/Smart Beetle/Sync Braille Series {#Hims} + +NVDA supporte les afficheurs braille Braille Sense, Braille EDGE, Smart Beetle et Sync Braille de [Hims](https://www.hims-inc.com/) quand ils sont connectés via USB ou Bluetooth. +Si vous connectez votre afficheur braille par USB, vous devrez installer les [pilotes USB de HIMS](http://www.himsintl.com/upload/HIMS_USB_Driver_v25.zip) sur votre système. + +Voici les assignations de touches pour ce terminal sous NVDA. +Veuillez consulter la documentation du terminal pour savoir où se situent ces touches. + + +| Nom |Touche| +|---|---| +|Aller à la cellule braille |routage| +|Défilement arrière de l'affichage braille |défilementHautDeGauche, défilementHautDeDroite, défilementDeGauche| +|Défilement avant de l'affichage braille |défilementBasDeGauche, défilementBasDeDroite, défilementDeDroite| +|Amener l'affichage à la ligne précédente |défilementHautDeGauche+défilementHautDeDroite| +|Amener l'affichage à la ligne suivante |défilementBasDeGauche+défilementBasDeDroite| +|Aller à la ligne précédente en revue |flècheHautDeDroite| +|Aller à la ligne suivante en revue |flècheBasDeDroite| +|Aller au caractère précédent en revue |flècheGaucheDeDroite| +|Aller au caractère suivant en revue |flècheDroiteDeDroite| +|Aller au focus courant |défilementHautDeGauche+défilementBasDeGauche, défilementHautDeDroite+défilementBasDeDroite, défilementDeGauche+défilementDeDroite| +|Touche contrôle |smartbeetle:f1, brailleedge:f3| +|Touche Windows |f7, smartbeetle:f2| +|Touche alt |point1+point3+point4+espace, f2, smartbeetle:f3, brailleedge:f4| +|Touche majuscule |f5| +|Touche insertion |point2+point4+espace, f6| +|Touche applications |point1+point2+point3+point4+espace, f8| +|Verrouillage majuscule |point1+point3+point6+espace| +|touche tabulation |point4+point5+espace, f3, brailleedge:f2| +|maj+alt+tab |f2+f3+f1| +|alt+tab |f2+f3| +|maj+tab |point1+point2+espace| +|Touche fin |point4+point6+espace| +|contrôle+fin |point4+point5+point6+espace| +|Touche début |point1+point3+espace, smartbeetle:f4| +|contrôle+début |point1+point2+point3+espace| +|alt+f4 |point1+point3+point5+point6+espace| +|flèche gauche |point3+espace, flècheGaucheDeGauche| +|contrôle+maj+flècheGauche |point2+point8+espace+f1| +|contrôle+flècheGauche |point2+espace| +|maj+alt+flècheGauche |point2+point7+f1| +|`alt+flècheGauche` |`point2+point7+espace`| +|flècheDroite |point6+espace, flècheDroiteDeGauche| +|contrôle+maj+flècheDroite |point5+point8+espace+f1| +|contrôle+flècheDroite |point5+espace| +|maj+alt+flècheDroite |point5+point7+f1| +|`alt+flècheDroite` |`point5+point7+espace`| +|pagePrec |point1+point2+point6+espace| +|contrôle+pagePrec |point1+point2+point6+point8+espace| +|Touche flècheHaut |point1+espace, flècheHautDeGauche| +|contrôle+maj+flècheHaut |point2+point3+point8+espace+f1| +|contrôle+flècheHaut |point2+point3+espace| +|maj+alt+flècheHaut |point2+point3+point7+f1| +|`alt+flècheHaut` |`point2+point3+point7+espace`| +|maj+flècheHaut |DéfilementBasDeGauche+espace| +|pageSuiv |point3+point4+point5+espace| +|contrôle+pageSuiv |point3+point4+point5+point8+espace| +|Touche flècheBas |point4+espace, flècheBasDeGauche| +|contrôle+maj+flècheBas |point5+point6+point8+espace+f1| +|contrôle+flècheBas |point5+point6+espace| +|maj+alt+flècheBas |point5+point6+point7+f1| +|`alt+flècheBas` |`point5+point6+point7+espace`| +|maj+flècheBas |espace+défilementBasDeDroite| +|Touche échap |point1+point5+espace, f4, brailleedge:f1| +|touche effacement |point1+point3+point5+espace, point1+point4+point5+espace| +|touche f1 |point1+point2+point5+espace| +|touche f3 |point1+point4+point8+espace| +|touche f4 |point7+f3| +|windows+b |point1+point2+f1| +|windows+d |point1+point4+point5+f1| +|contrôle+insert |smartbeetle:f1+défilementDeDroite| +|alt+insert |smartbeetle:f3+défilementDeDroite| + + + +### Seika Braille Displays {#Seika} + +Les afficheurs braille Seika suivants de Nippon Telesoft sont pris en charge en deux groupes avec des fonctionnalités différentes : + +* [Seika Version 3, 4, et 5 (40 cellules), Seika80 (80 cellules)](#SeikaBrailleDisplays) +* [MiniSeika (16, 24 cellules), V6, et V6Pro (40 cellules)](#SeikaNotetaker) + +Vous pouvez trouver plus d'informations concernant ces afficheurs sur leur [Page de téléchargement de démos et de pilotes](https://en.seika-braille.com/down/index.html). + +#### Seika Version 3, 4, et 5 (40 cellules), Seika80 (80 cellules) {#SeikaBrailleDisplays} + +* Ces terminaux ne supporte pas encore la détection automatique en arrière-plan. +* Sélectionnez "Terminaux Braille Seika" pour configurer manuellement +* Un pilote doit être installé avant d'utiliser les Seika v3/4/5/80. +Les pilotes sont [fournis par le fabriquant](https://en.seika-braille.com/down/index.html). + +Voici les assignations de touches pour le terminal Seika Braille : +Veuillez consulter la documentation du terminal pour savoir où se situent ces touches. + + +| Nom |Touche| +|---|---| +|Défilement arrière de l'affichage braille |gauche| +|Défilement avant de l'affichage braille |droite| +|Déplacer l'afficheur braille à la ligne précédente |B3| +|Déplacer l'afficheur braille à la ligne suivante |b4| +|Basculer le suivi braille |b5| +|Dire tout |b6| +|tab |b1| +|maj+tab |b2| +|alt+tab |b1+b2| +|Menu NVDA |gauche+droite| +|Aller à la cellule braille |route (amener le curseur au caractère)| + + + +#### MiniSeika (16, 24 cellules), V6, et V6Pro (40 cellules) {#SeikaNotetaker} + +* La détection automatique de l'afficheur braille en arrière-plan de NVDA est prise en charge via USB et Bluetooth. +* Sélectionnez "Seika Notetaker" ou "automatique" pour configurer. +* Aucun pilote supplémentaire n'est requis lors de l'utilisation d'un afficheur braille Seika Notetaker. + +Voici les assignation de touches pour le Seika Notetaker. +Veuillez consulter la documentation du terminal pour savoir où se situent ces touches. + + +| Nom |Touche| +|---|---| +|Défilement braille vers la gauche |gauche| +|Défilement braille vers la droite |droite| +|Dire tout |espace+RetourArrière| +|Menu NVDA |Gauche+Droite| +|Amener l'afficheur braille à la ligne précédente |LJ haut| +|Amener l'afficheur braille à la ligne suivante |LJ bas| +|Basculer le suivi braille |LJ centre| +|tab |LJ droite| +|Maj+tab |LJ gauche| +|FlècheHaut |RJ haut| +|FlècheBas |RJ bas| +|FlècheGauche |RJ gauche| +|FlècheDroite |RJ droit| +|Aller à la cellule braille |routage| +|maj+flècheHaut |Espace+RJ haut, RetourArrière+RJ haut| +|Maj+flècheBas |Espace+RJ bas, RetourArrière+RJ bas| +|maj+flèchegauche |Espace+RJ gauche, RetourArrière+RJ gauche| +|maj+flècheDroite |Espace+RJ droit, RetourArrière+RJ droit| +|touche entrée |RJ centre, point8| +|touche échap |Espace+RJ centre| +|touche windows |RetourArrière+RJ centre| +|touche espace |Espace, RetourArrière| +|touche RetourArrière |point7| +|touche pagePrec |Espace+LJ droit| +|touche pageSuiv |Espace+LJ gauche| +|touche début |espace+LJ haut| +|touche fin |espace+LJ bas| +|touche contrôle+début |retourArrière+LJ haut| +|touche contrôle+fin |retourArrière+LJ bas| + +### Nouveaux Modèles de Papenmeier brailleX {#Papenmeier} + +Les afficheurs braille suivant sont supportés : + +* BrailleX EL 40c, EL 80c, EL 20c, EL 60c (USB) +* BrailleX EL 40s, EL 80s, EL 2d80s, EL 70s, EL 66s (USB) +* BrailleX Trio (USB et Bluetooth) +* BRAILLEX Live 20, BRAILLEX Live et BRAILLEX Live Plus (USB et Bluetooth) + +Ces terminaux ne supporte pas la détection automatique en arrière-plan. +Il existe une option dans le pilote USB de l'afficheur qui peut entraîner un problème de chargement de l'afficheur. +Veuillez essayez ce qui suit: + +1. Veuillez vous assurer que vous avez installé le [dernier pilote](https://www.papenmeier-rehatechnik.de/en/service/downloadcenter/software/articles/software-braille-devices.html). +1. Ouvrez le Gestionnaire de périphériques Windows. +1. Faites défiler la liste jusqu'à "Contrôleurs USB" ou "Périphériques USB". +1. Sélectionnez "Périphérique USB Papenmeier Braillex". +1. Ouvrez les propriétés et passez à l'onglet "Avancé". +Parfois, l'onglet "Avancé" n'apparaît pas. +Si tel est le cas, déconnectez la plage braille de l'ordinateur, quittez NVDA, attendez un moment et reconnectez la plage braille. +Répétez cette opération 4 à 5 fois si nécessaire. +Si l'onglet "Avancé" ne s'affiche toujours pas, veuillez redémarrer l'ordinateur. +1. Désactivez l'option "Load VCP". + +La plupart des afficheurs ont une barre d'accès facile (EAB) qui permet des opérations intuitives et rapides. +L'EAB peut être bougé dans quatre directions et chaque direction a deux crans. +Les séries C et Live sont les seules exceptions à cette règle. + +La série-C et quelques autres afficheurs ont deux rangées de routines où celle du haut sert à rapporter les informations de mise en forme. +Garder enfoncée une des routines du haut puis appuyer sur l'EAB sur une Série-C annule le second cran. +Les terminaux des séries Live n'ont qu'une ligne de routines et l'EAB n'a qu'un cran par direction. +Le second cran peut être reproduit en pressant une des touches de routage et en pressant l'EAB dans la direction correspondante. +Appuyer et garder les touches haute, basse, gauche et droite (ou EAB) répète la dernière commande. + +Généralement, les touches suivantes sont disponibles sur ces afficheurs braille : + +| Nom |touche| +|---|---| +|l1 |touche gauche devant| +|l2 |touche gauche derrière| +|r1 |touche droite devant| +|r2 |touche droite derrière| +|haut |Monter une fois vers le haut| +|haut2 |Monter deux fois vers le haut| +|gauche |un vers la gauche| +|gauche2 |deux vers la gauche| +|droite |un vers la droite| +|droite2 |deux vers la droite| +|dn |un vers le bas| +|dn2 |deux vers le bas| + +Voici les commandes assignées pour les afficheurs Papenmeier dans NVDA : + + +| Nom |Touche| +|---|---| +|Défilement arrière de l'affichage braille |left| +|Défilement avant de l'affichage braille |right| +|Déplacer l'afficheur braille à la ligne précédente |up| +|Déplacer le braille à la ligne suivante |dn| +|Aller à la cellule braille |routage| +|Lire le caractère sous le curseur de revue |l1| +|Activer l'objet courant du navigateur |l2| +|Bascule braille suit |r2| +|Lire le titre |l1+up| +|Lire la barre d'état |l2+down| +|Aller à l'objet parent |up2| +|Aller à l'objet enfant |dn2| +|Aller à l'objet précédent |left2| +|Aller à l'objet suivant |right2| +|Annoncer l'information de mise en forme du texte sous la cellule braille |rangée de routines du haut| + + + +Le modèle Trio à quatre touches additionnelles en face du clavier braille. +Elles sont (ordonnées de gauche à droite) : + +* Touche thumb gauche (lt) +* Espace +* Espace +* Touche thumb droite (rt) + +Pour le moment, rt n'est pas utilisée. +Les touches intérieures font toutes les deux espace. + + + +| Nom |Touche| +|---|---| +|touche échap |espace avec point 7| +|touche flèche haute |espace avec point 2| +|touche flèche gauche |espace avec point 1| +|touche flèche droite |espace avec point 4| +|touche flèche basse |espace avec point 5| +|touche contrôle |lt+point 2| +|touche alt |lt+point 3| +|touches contrôle+échap |espace avec les points 1 2 3 4 5 6| +|touche tab |espace avec points 3 7| + + + +### Papenmeier Braille BrailleX Modèles Anciens {#PapenmeierOld} + +Les afficheurs braille suivants sont supportés : + +* BrailleX EL 80, EL 2D-80, EL 40 P +* BrailleX Tiny, 2D Screen + +Notez que ces afficheurs ne peuvent être connectés qu'en port série. +De ce fait, ils ne supportent pas la détection automatique en arrière-plan. +Vous devez donc sélectionner le port série où l'afficheur est connecté après avoir sélectionné le pilote dans le dialogue [Choisir l'Afficheur Braille](#SelectBrailleDisplay). + +Certains de ces périphériques ont une barre d'accès facile (EAB) qui permet une opération rapide et intuitive. +L'EAB peut être bougée dans quatre directions où chaque direction a généralement deux crans. +Garder appuyée la touche haut, basse, gauche, droite (ou EAB) répète l'action correspondante. +Les anciens modèles n'ont pas d'EAB ; les touches de façade sont utilisées à la place. + +Globalement, les touches suivantes sont disponibles sur les afficheurs braille : + +| Nom |Touche| +|---|---| +|l1 |Touche avant gauche| +|l2 |Touche arrière droite| +|r1 |Touche avant droite| +|r2 |Touche arrière droite| +|up |1 appui vers le haut| +|up2 |2 appuis vers le haut| +|left |1 appui gauche| +|left2 |2 appuis gauche| +|right |1 appui à droite| +|right2 |2 appuis à droite| +|dn |1 appui en bas| +|dn2 |2 appuis en bas| + +Les commandes Papenmeier disponibles dans NVDA sont les suivantes : + + +Périphériques avec EAB : + +| Nom |Touche| +|---|---| +|Défilement affichage braille arrière |left| +|Défilement affichage braille avant |right| +|Déplacer l'affichage braille vers la ligne précédente |up| +|Déplacer l'affichage braille vers la ligne suivante |down| +|Joindre à la cellule braille |routage| +|Annoncer le caractère courant sous la revue |l1| +|Activer l'objet courant du navigateur |l2| +|Dire titre |l1up| +|Lire barre d'état |l2down| +|Aller à l'objet contenant |up2| +|Aller au premier objet contenu |dn2| +|Aller à l'objet suivant |right2| +|Aller à l'objet précédant |left2| +|Annoncer l'information de mise en forme du texte sous la cellule braille |rangée de routines du haut| + +BRAILLEX Tiny : + +| Nom |Touche| +|---|---| +|Annoncer le caractère sous le curseur de revue |l1| +|Activer l'objet sous le navigateur |l2| +|Défiler le braille vers l'arrière |left| +|Défiler le braille vers l'avant |right| +|Déplacer le braille à la ligne précédente |up| +|Déplacer le braille à la ligne suivante |dn| +|Basculer le suivi du braille |r2| +|Aller à l'objet contenant |r1+up| +|Aller au premier objet contenu |r1+dn| +|Aller à l'objet précédent |r1+left| +|Aller à l'objet suivant |r1+right| +|Annoncer l'information de mise en forme du texte sous la cellule braille |rangée de routines du haut| +|Annoncer le titre |l1+up| +|Annoncer la barre d'état |l2+down| + +brailleX 2D Screen: + +| Nom |Touche| +|---|---| +|Annoncer le caractère sous le curseur de revue |l1| +|Activer l'objet sous le navigateur |l2| +|Basculer le suivi du braille |r2| +|Annoncer l'information de mise en forme du texte sous la cellule braille |rangée de routines du haut| +|Déplacer le braille à la ligne précédente |up| +|Défiler le braille vers l'arrière |left| +|Défiler le braille vers l'avant |right| +|Déplacer le braille à la ligne suivante |dn| +|Aller à l'objet suivant |left2| +|Aller à l'objet contenant |up2| +|Aller au premier objet contenu |dn2| +|Aller à l'objet précédent |right2| + + + +### BrailleNote de HumanWare {#HumanWareBrailleNote} + +NVDA supporte les bloc-notes BrailleNote de [HumanWare](https://www.humanware.com) lorsque ceux-ci agissent comme afficheurs braille pour un lecteur d'écran. +Les modèles suivants sont supportés : + +* BrailleNote Classic (connexion série seulement) +* BrailleNote PK (connexion Série et Bluetooth) +* BrailleNote MPower (connexion Série et Bluetooth) +* BrailleNote Apex (connexion Bluetooth et USB) + +Pour le BrailleNote Touch, Veuillez vous référer à la section [Séries Brailliant BI / BrailleNote Touch](#HumanWareBrailliant). + +Excepté pour le BrailleNote PK, les claviers braille (BT) et QWERTY (QT) sont supportés. +Pour le BrailleNote QT, l'émulation de clavier PC n'est pas supportée. +Vous pouvez également entrer les points braille en utilisant le clavier QT. +Veuillez consulter la section terminal braille du manuel BrailleNote pour plus de détails. + +Si votre périphérique supporte plusieurs types de connexion, en connectant votre BrailleNote à NVDA, vous devrez définir le port dans les options de votre afficheur braille. +Lisez le manuel de votre BrailleNote pour plus de détails. +Dans NVDA, vous devrez peut-être également configurer le port dans le dialogue [Choisir l'Afficheur Braille](#SelectBrailleDisplay). +Si vous le connectez via USB ou Bluetooth, vous pouvez le configurer sur "Automatique", "USB" ou "Bluetooth" selon ce qui est disponible. +Si vous le connectez à un port série ou un convertisseur USB-Série ou si aucune de ces dernières options n'apparaît, vous devez choisir explicitement le port de communication à utiliser dans la liste des ports matériels. + +Avant de connecter votre BrailleNote Apex en utilisant son interface client USB, vous devez installer le pilote fourni par HumanWare. + +Sur le BrailleNote Apex BT, vous pouvez utiliser la roue de défilement située entre les points 1 et 4 pour diverses commandes NVDA. +La roue consiste en 4 points directionnels, un bouton central de clic, et une roue qui peut tourner dans le sens des aiguilles d'une montre ou inversement. + +Voici les assignations de touches du BrailleNote pour NVDA. +Consultez la documentation de votre BrailleNote pour savoir où se situent ces touches. + + + +| Nom |touche| +|---|---| +|Défilement affichage braille arrière |Arrière| +|Défilement affichage braille avant |Avant| +|Déplacer l'affichage braille vers la ligne précédente |Précédent| +|Déplacer l'affichage braille vers la ligne suivante |Suivant| +|Joindre à la cellule braille |routage| +|menu NVDA |espace+point1+point3+point4+point5 (espace+n)| +|Basculer le suivi de l'affichage braille |Précédent+Suivant| +|Touche Flèche haute |Espace+Point 1| +|Touche Flèche basse |Espace+Point 4| +|Touche Flèche gauche |Espace+Point 3| +|Touche Flèche droite |Espace+Point 6| +|Touche page précédente |Espace+Point 1+Point 3| +|Touche Page Suivante |Espace+Point4+Point6| +|Touche Origine |Espace+Point1+Point2| +|Touche fin |Espace+Point4+Point5| +|Contrôle+Origine |Espace+Point1+Point2+Point3| +|Touche Espace |Espace| +|Contrôle+Fin |Espace+Point4+Point5+Point6| +|Entrée |Espace+Point8| +|Touche retour arrière |Espace+Point7| +|Touche Tab |Espace+Point2+Point3+Point4+Point5 (Espace+t)| +|Maj+Tab |Espace+Point1+Point2+Point5+Point6| +|Touche Windows |Espace+Point2+Point4+Point5+Point6| +|Touche alt |Espace+Point1+Point3+Point4 (Espace+m)| +|Basculer aide à la saisie |Espace+Point2+Point3+Point6 (Espace+h en bas)| + +Voici les commandes assignées au BrailleNote QT quand il n'est pas en mode saisie braille : + +| Nom |Touche| +|---|---| +|menu NvDA |lecture+n| +|touche flèche haut |flècheHaut| +|touche flèche bas |flècheBas| +|touche flèche gauche |flècheGauche| +|touche flèche droite |flècheDroite| +|touche pagePrec |fonction+flècheHaut| +|touche pageSuiv |fonction+flècheBas| +|touche début |fonction+flècheGauche| +|touche fin |fonction+flècheDroite| +|touche contrôle+début |lecture+t| +|touche contrôle+fin |lecture+b| +|touche entrée |entrée| +|touche retour arrière |retourArrière| +|touche tab |tab| +|touche maj+tab keys |maj+tab| +|touche windows |lecture+w| +|touche alt |lecture+m| +|bascule de l'aide à la saisie |lecture+1| + +Voici les commandes assignées à la roue de défilement : + +| Nom |Touche| +|---|---| +|touche flècheHaut |flècheHaut| +|touche flècheBas |flècheBas| +|touche flècheGauche |flècheGauche| +|touche flècheDroite |flècheDroite| +|touche entrée |bouton central| +|touche tab |tourner la roue dans le sens des aiguilles d'une montre| +|touche maj+tab |tourner la roue dans le sens inverse des aiguilles d'une montre| + + + +### EcoBraille {#EcoBraille} + +NVDA supporte Les afficheurs EcoBraille de [ONCE](https://www.once.es/). +Les modèles suivants sont supportés : + +* EcoBraille 20 +* EcoBraille 40 +* EcoBraille 80 +* EcoBraille Plus + +Sous NVDA, vous pouvez définir le port série auquel l'afficheur est connecté dans le dialogue [Choisir l'Afficheur Braille](#SelectBrailleDisplay). +Ces terminaux ne supporte pas la détection automatique en arrière-plan. + +Voici les assignations de touche pour les afficheurs EcoBraille. +Veuillez consulter [la documentation EcoBraille](ftp://ftp.once.es/pub/utt/bibliotecnia/Lineas_Braille/ECO/) pour connaître la position de ces touches. + + + +| Nom |Touche| +|---|---| +|Défilement braille arrière |T2| +|Défilement braille avant |T4| +|Amener l'afficheur braille à la ligne précédente |T1| +|Amener l'afficheur braille à la ligne suivante |T5| +|Aller à la cellule braille |Routage| +|Activer l'objet navigateur courant |T3| +|Passer au mode de revue suivant |F1| +|Aller à l'objet contenant |F2| +|Passer au mode de revue précédent |F3| +|Aller à l'objet précédent |F4| +|Annoncer l'objet courant |F5| +|Aller à l'objet suivant |F6| +|Aller à l'objet en focus |F7| +|Aller au premier objet inclus |F8| +|Amener le focus système ou le curseur à la position courante de revue |F9| +|Annoncer la position du curseur de revue |F0| +|Bascule du mode de suivi braille |A| + + + +### SuperBraille {#SuperBraille} + +L'afficheur SuperBraille, principalement disponible à Taiwan, peut être connecté en USB ou en série. +Comme le SuperBraille n'a ni clavier physique ni bouton de défilement, toutes les saisies doivent être effectuées depuis un clavier d'ordinateur standard. +Pour cette raison, et pour maintenir la compatibilité avec d'autres revues d'écran à Taiwan, deux raccourcis clavier pour le défilement de l'affichage ont été définis : + + +| Nom |touche| +|---|---| +|Défilement braille arrière |pavnumMoins| +|Défilement braille avant |pavnumPlus| + + + +### Afficheurs Eurobraille {#Eurobraille} + +Les afficheurs b.book, b.note, Esys, Esytime et Iris d'Eurobraille sont supportés par NVDA. +Ces appareils disposent d'un clavier braille à 10 touches. +Veuillez consulter la documentation de l'afficheur pour une description de ces touches. +Des deux touches placées comme une barre d'espace, la touche gauche correspond à la touche retour arrière et la touche droite à la touche espace. + +Ces appareils sont connectés via USB et disposent d'un clavier USB autonome. +Il est possible d'activer/désactiver ce clavier en basculant "simulation de clavier HID" à l'aide d'un geste de commande. +Les fonctions du clavier braille décrites directement ci-dessous sont lorsque la "simulation du clavier HID" est désactivée. + +#### Fonctions du clavier Braille {#EurobrailleBraille} + + + +| Nom |Touche| +|---|---| +|Effacer la dernière cellule ou le dernier caractère braille saisi |`retourArrière`| +|Traduire n'importe quelle entrée en braille et appuyer sur la touche Entrée |`RetourArrière+espace`| +|Basculer la touche `NVDA` |`point3+point5+espace`| +|touche `insert` |`point1+point3+point5+espace`, `point3+point4+point5+espace`| +|touche `supprimer` |`point3+point6+espace`| +|touche `début` |`point1+point2+point3+espace`| +|touche `fin` |`point4+point5+point6+espace`| +|Touche `flècheGauche` |`point2+espace`| +|Touche `flècheDroite` |`point5+espace`| +|Touche `flècheHaute` |`point1+espace`| +|Touche `flècheBas` |`point6+espace`| +|Touche `pagePrec` |`point1+point3+espace`| +|Touche `pageSuiv` |`point4+point6+espace`| +|touche `pavnum1` |`point1+point6+retourArrière`| +|touche `pavnum2` |`point1+point2+point6+retourArrière`| +|touche `pavnum3` |`point1+point4+point6+retourArrière`| +|touche `pavnum4` |`point1+point4+point5+point6+retourArrière`| +|touche `pavnum5` |`point1+point5+point6+retourArrière`| +|touche `pavnum6` |`point1+point2+point4+point6+retourArrière`| +|touche `pavnum7` |`point1+point2+point4+point5+point6+retourArrière`| +|touche `pavnum8` |`point1+point2+point5+point6+retourArrière`| +|touche `pavnum9` |`point2+point4+point6+retourArrière`| +|Touche `pavnumInser` |`point3+point4+point5+point6+retourArrière`| +|Touche `PavnumDécimal` |`point2+retourArrière`| +|touche `PavnumDiviser` |`point3+point4+retourArrière`| +|Touche `pavnumMultiplier` |`point3+point5+retourArrière`| +|Touche `pavnumMoins` |`point3+point6+retourArrière`| +|touche `PavnumPlus` |`point2+point3+point5+retourArrière`| +|Touche `pavnumEntrée` |`point3+point4+point5+retourArrière`| +|touche `échappement` |`point1+point2+point4+point5+espace`, `l2`| +|touche `tabulation` |`point2+point5+point6+espace`, `l3`| +|touches `maj+tab` |`point2+point3+point5+espace`| +|Touche `impressionÉcran` |`point1+point3+point4+point6+espace`| +|touche `pause` |`point1+point4+espace`| +|touche `applications` |`point5+point6+retourArrière`| +|touche `f1` |`point1+retourArrière`| +|touche `f2` |`point1+point2+retourArrière`| +|touche `f3` |`point1+point4+retourArrière`| +|touche `f4` |`point1+point4+point5+retourArrière`| +|touche `f5` |`point1+point5+retourArrière`| +|touche `f6` |`point1+point2+point4+retourArrière`| +|touche `f7` |`point1+point2+point4+point5+retourArrière`| +|touche `f8` |`point1+point2+point5+retourArrière`| +|touche `f9` |`point2+point4+retourArrière`| +|touche `f10` |`point2+point4+point5+retourArrière`| +|touche `f11` |`point1+point3+retourArrière`| +|touche `f12` |`point1+point2+point3+retourArrière`| +|touche `windows` |`point1+point2+point4+point5+point6+espace`| +|Basculer la touche `windows` |`point1+point2+point3+point4+retourArrière`, `point2+point4+point5+point6+espace`| +|touche `VerMaj` |`point7+retourArrière`, `point8+retourArrière`| +|Touche `VerNum` |`point3+retourArrière`, `point6+retourArrière`| +|touche `maj` |`point7+espace`| +|Basculer la touche `maj` |`point1+point7+espace`, `point4+point7+espace`| +|touche `contrôle` |`point7+point8+espace`| +|Basculer la touche `contrôle` |`point1+point7+point8+espace`, `point4+point7+point8+espace`| +|touche `alt` |`point8+espace`| +|Basculer la touche `alt` |`point1+point8+espace`, `point4+point8+espace`| +|Basculer la simulation du clavier HID |`switch1Gauche+joystick1Bas`, `switch1Droit+joystick1Bas`| + + + +#### commandes clavier b.book {#Eurobraillebbook} + + + +| Nom |Touche| +|---|---| +|Faire défiler l'affichage braille vers l'arrière |`en arrière`| +|Faire défiler l'affichage braille vers l'avant |`en avant`| +|Déplacer vers le focus actuel |`arrière+avant`| +|Route vers cellule braille |`routage`| +|Touche `flècheGauche` |`joystick2gauche`| +|Touche `flècheDroite` |`joystick2Right`| +|Touche `flècheHaut` |`joystick2Haut`| +|Touche `flècheBas` |`joystick2Bas`| +|touche `entrée` |`joystick2Centre`| +|touche `échappement` |`c1`| +|touche `tabulation` |`c2`| +|Basculer la touche `maj` |`c3`| +|Basculer la touche `contrôle` |`c4`| +|Basculer la touche `alt` |`c5`| +|Basculer la touche `NVDA` |`c6`| +|Touche `contrôle+Début` |`c1+c2+c3`| +|Touche `contrôle+Fin` |`c4+c5+c6`| + + + +#### commandes clavier b.note {#Eurobraillebnote} + + + +| Nom |Touche| +|---|---| +|Faire défiler l'affichage braille vers l'arrière |`clavierGaucheGauche`| +|Faire défiler l'affichage braille vers l'avant |`clavierGaucheDroit`| +|Route vers cellule braille |`routage`| +|Signaler la mise en forme du texte sous la cellule braille |`doubleRouting`| +|Passer à la ligne suivante dans la révision |`clavierGaucheBas`| +|Passer au mode de révision précédent |`ClavierGaucheGauche+ClavierGaucheHaut`| +|Passer au mode de révision suivant |`clavierGaucheDroit+clavierGaucheBas`| +|Touche `flèchegauche` |`ClavierDroitGauche`| +|Touche `flèchedroite` |`clavierDroitDroite`| +|Touche `flècheHaut` |`clavierDroitHaut`| +|Touche `flècheBas` |`clavierDroitBas`| +|Touche `contrôle+Début` |`clavierDroitGauche+clavierDroitHaut`| +|Touche `contrôle+fin` |`clavierDroitGauche+clavierDroitHaut`| + + + +#### Commandes clavier Esys {#Eurobrailleesys} + + + +| Nom |Touche| +|---|---| +|Faire défiler l'affichage braille vers l'arrière |`switch1Gauche`| +|Faire défiler l'affichage braille vers l'avant |`switch1Droite`| +|Déplacer vers le focus actuel |`switch1Centre`| +|Route vers cellule braille |`routage`| +|Signaler la mise en forme du texte sous la cellule braille |`doubleRouting`| +|Aller à la ligne précédente en révision |`joystick1Haut`| +|Passer à la ligne suivante dans la révision |`joystick1bas`| +|Passer au caractère précédent en revue |`joystick1gauche`| +|Passer au caractère suivant en revue |`joystick1Droite`| +|Touche `flècheGauche` |`joystick2gauche`| +|Touche `flècheDroite` |`joystick2Droite`| +|Touche `flècheHaut` |`joystick2Haut`| +|Touche `glècheBas` |`joystick2Bas`| +|touche `entrée` |`joystick2Centre`| + + + +#### Commandes clavier Esytime {#EurobrailleEsytime} + + + +| Nom |Touche| +|---|---| +|Faire défiler l'affichage braille vers l'arrière |`l1`| +|Faire défiler l'affichage braille vers l'avant |`l8`| +|Déplacer vers le focus actuel |`l1+l8`| +|Route vers cellule braille |`routage`| +|Signaler la mise en forme du texte sous la cellule braille |`doubleRouting`| +|Aller à la ligne précédente en révision |`joystick1Haut`| +|Passer à la ligne suivante dans la révision |`joystick1bas`| +|Passer au caractère précédent en revue |`joystick1gauche`| +|Passer au caractère suivant en revue |`joystick1Droite`| +|Touche `flèchegauche` |`joystick2gauche`| +|Touche `flèchedroite` |`joystick2Droite`| +|Touche `flècheHaut` |`joystick2Haut`| +|Touche `flècheBas` |`joystick2Bas`| +|touche `entrée` |`joystick2Centre`| +|touche `échappement` |`l2`| +|touche `tabulation` |`l3`| +|Basculer la touche `Maj` |`l4`| +|Basculer la touche `contrôle` |`l5`| +|Basculer la touche `alt` |`l6`| +|Basculer la touche `NVDA` |`l7`| +|Touche `contrôle+début` |`l1+l2+l3`, `l2+l3+l4`| +|Touche `contrôle+fin` |`l6+l7+l8`, `l5+l6+l7`| +|Basculer la simulation du clavier HID |`l1+joystick1Bas`, `l8+joystick1Bas`| + + + +### Afficheurs Nattiq nBraille {#NattiqTechnologies} + +NVDA supporte les afficheurs de [Nattiq Technologies](https://www.nattiq.com/) quand ils sont connectés via USB. +Windows 10 et les versions ultérieures détectent les afficheurs Braille à la connexion, il peut être nécessaire d'installer des pilotes USB si vous utilisez des versions plus anciennes de Windows (antérieures à Win10). +Vous pouvez les obtenir sur le site du fabriquant. + +Voici les assignations de touches pour les afficheurs Nattiq Technologies sous NVDA. +Veuillez consulter la documentation de l'afficheur pour connaître la position de ces touches. + + +| Nom |Touche| +|---|---| +|Défilement arrière |haut| +|Défilement avant |bas| +|Amener l'afficheur à la ligne précédente |gauche| +|amener l'afficheur à la ligne suivante |droit| +|Aller à la cellule braille |routage| + + + +### BRLTTY {#BRLTTY} + +[BRLTTY](https://www.brltty.app/) est un programme séparé qui permet de prendre en charge beaucoup plus de terminaux braille. +Pour l'utiliser, il vous faut installer [BRLTTY pour Windows](https://www.brltty.app/download.html). +Vous devez télécharger et installer la version la plus récente avec installateur qui s'appellera, par exemple, brltty-win-4.2-2.exe. +Quand vous configurerez le terminal et le port à utiliser, portez une attention particulière aux instructions, en particulier si vous utilisez un terminal USB et que le pilote du constructeur est déjà installé. + +Pour les afficheurs disposant d'un clavier braille, BRLTTY gèrent la saisie du braille. +L'option table d'entrée n'est donc pas applicable. + +BRLTTY n'est pas concerné par la détection automatique en arrière-plan. + +Voici les assignations de commandes BRLTTY pour NVDA. +Veuillez consulter les [listes des assignations des touches de BRLTTY](https://brltty.app/doc/KeyBindings/) pour des informations sur la manière dont BRLTTY lie ses commandes aux touches sur les terminaux braille. + + +| Nom |commande BRLTTY| +|---|---| +|Défilement arrière de l'affichage braille |`fwinlt` (se déplacer à gauche d'une fenêtre)| +|Défilement avant de l'affichage braille |`fwinrt` (se déplacer à droite d'une fenêtre)| +|Amener l'affichage à la ligne précédente |`lnup` (monter d'une ligne)| +|Amener l'affichage à la ligne suivante |`lndn` (descendre d'une ligne)| +|Aller à la cellule braille |`route` (amener le curseur au caractère)| +|Basculer l'aide à la saisie |`learn` (entrer/sortir du mode d'apprentissage des commandes)| +|Ouvrir le menu NVDA |`prefmenu` (ouvrir/quitter le menu des préférences)| +|Rétablir la configuration |`prefload` (restaurer les préférences à partir du disque)| +|Enregistrer la configuration |`prefsave` (enregistrer les préférences sur le disque)| +|Afficher l'heure |`hour` (afficher la date et l'heure actuelles)| +|Prononcer la ligne où se trouve le curseur de révision |`say_line` (prononcer la ligne actuelle)| +|Dire tout en utilisant le curseur de revue |`say_below` (Lire depuis la ligne actuelle jusqu'au bas de l'écran)| + + + +### Tivomatic Caiku Albatross 46/80 {#Albatross} + +Les terminaux Caiku Albatross, qui étaient fabriqués par Tivomatic et disponibles en Finlande, peuvent être connectés via USB ou série. +Vous n'avez pas besoin d'installer de pilote spécifique pour utiliser ces afficheurs. +Branchez simplement l'afficheur et configurez NVDA pour l'utiliser. + +Remarque : Un débit de 19 200 bauds est fortement recommandé. +Si nécessaire, réglez la valeur du débit en bauds sur 19200 dans le menu de l'afficheur braille. +Bien que le pilote prenne en charge un débit en bauds de 9600, il n'a aucun moyen de contrôler le débit en bauds utilisé par l'affichage. +Parce que 19200 est le débit en bauds par défaut de l'affichage, le pilote l'essaie d'abord. +Si les débits en bauds ne sont pas les mêmes, le pilote peut se comporter de manière inattendue. + +Voici les affectations de touches pour ces afficheurs avec NVDA. +Veuillez consulter la documentation de l'afficheur pour savoir où trouver ces touches. + + +| Nom |Touche| +|---|---| +|Aller à la première ligne en mode revue |`home1`, `home2`| +|Aller à la dernière ligne en mode revue |`end1`, `end2`| +|Amener l'objet navigateur au focus courant |`eCursor1`, `eCursor2`| +|Aller au focus courant |`cursor1`, `cursor2`| +|Amener le pointeur souris à l'objet navigateur courant |`home1+home2`| +|Amener l'objet navigateur à l'objet sous le pointeur souris et l'annoncer |`end1+end2`| +|Amener le focus à l'objet navigateur courant |`eCursor1+eCursor2`| +|Basculer le suivi braille |`cursor1+cursor2`| +|Amener l'affichage braille à la ligne précédente |`up1`, `up2`, `up3`| +|Amener l'affichage braille à la ligne suivante |`down1`, `down2`, `down3`| +|Faire défiler l'affichage braille en arrière |`left`, `lWheelLeft`, `rWheelLeft`| +|Faire défiler l'affichage braille en avant |`right`, `lWheelRight`, `rWheelRight`| +|Aller à la cellule braille |`routing`| +|Annoncer la mise en forme du texte sous la cellule braille |`secondary routing`| +|Choisir la manière dont l'information contextuelle est présentée en braille |`attribute1+attribute3`| +|Faire défiler les modes de parole |`attribute2+attribute4`| +|Passer au mode de revue précédent (ex : objet, document ou écran) |`f1`| +|Passer au mode de revue suivant (ex : objet, document ou écran) |`f2`| +|Amener l'objet navigateur à l'objet le contenant |`f3`| +|Amener l'objet navigateur au premier objet qu'il contient |`f4`| +|Amener l'objet navigateur à l'objet précédent |`f5`| +|Amener l'objet navigateur à l'objet suivant |`f6`| +|Annoncer l'objet navigateur courant |`f7`| +|Annoncer l'information de position du texte ou de l'objet sous le curseur de revue |`f8`| +|Afficher les paramètres braille |`f1+home1`, `f9+home2`| +|Lire la barre d'état et y amener l'objet navigateur |`f1+end1`, `f9+end2`| +|Basculer le curseur braille |`f1+cursor1`, `f9+cursor2`| +|Faire défiler les formes de curseur braille |`f1+eCursor1`, `f9+eCursor2`| +|Faire défiler le mode d'affichage des messages en braille |`f1+f2`, `f9+f10`| +|Faire défiler le mode d'affichage de la sélection braille |`f1+f5`, `f9+f14`| +|Faire défiler les modes pour l'option braille "Déplacer le curseur système lors du routage du curseur de revue" |`f1+f3`, `f9+f11`| +|Exécuter l'action par défaut sur l'objet navigateur courant |`f7+f8`| +|Annoncer date/heure |`f9`| +|Annoncer le niveau de batterie et le temps restant si l'alimentation n'est pas branchée |`f10`| +|Annoncer le titre |`f11`| +|Annoncer la barre d'état |`f12`| +|Annoncer la ligne courante sous le curseur d'application |`f13`| +|Dire tout |`f14`| +|Annoncer le caractère courant sous le curseur de revue |`f15`| +|Annoncer la ligne de l'objet navigateur courant où se situe le curseur de revue |`f16`| +|Dir le mot de l'objet navigateur courant où se situe le curseur de revue |`f15+f16`| +|Amener le curseur de revue à la ligne précédente de l'objet navigateur courant et l'annoncer |`lWheelUp`, `rWheelUp`| +|Amener le curseur de revue à la ligne suivante de l'objet navigateur courant et l'annoncer |`lWheelDown`, `rWheelDown`| +|Touche `Windows+d` (minimiser toutes les applications) |`attribute1`| +|Touche `Windows+e` (Ce PC) |`attribute2`| +|Touche `Windows+b` (focus dans la barre d'état) |`attribute3`| +|Touche `Windows+i` (Paramètres Windows) |`attribute4`| + + + +### Afficheurs braille au standard HID {#HIDBraille} + +Il s'agit d'un pilote expérimental pour la nouvelle spécification standard HID Braille, convenue en 2018 par Microsoft, Google, Apple et plusieurs sociétés de technologie d'assistance, dont NV Access. +L'espoir est que tous les futurs modèles d'afficheurs Braille créés par n'importe quel fabricant utiliseront ce protocole standard qui supprimera le besoin de pilotes Braille spécifiques au fabricant. + +La détection automatique de l'affichage braille de NVDA reconnaîtra également tout affichage prenant en charge ce protocole. + +Voici les affectations de touches actuelles pour ces affichages. + + +| Nom |Touche| +|---|---| +|Défilement arrière de l'afficheur braille |panoramique à gauche ou rocker vers le haut| +|Défilement avant de l'afficheur braille |panoramique à droite ou rocker vers le bas| +|Aller à la cellule braille |ensemble de routage 1| +|Basculer braille suit to |haut+bas| +|touche flècheHaut |joystick vers le haut, dpad ver le haut ou espace+point1| +|touche flècheBas |joystick vers le bas, dpad ver le bas ou espace+point4| +|touche flècheGauche |espace+point3, joystick vers la gauche ou dpad ver la gauche| +|touche flècheDroite |espace+point6, joystick vers la droite ou dpad ver la droite| +|Touche maj+tab |espace+point1+point3| +|Touche tab |espace+point4+point6| +|Touche alt |espace+point1+point3+point4 (espace+m)| +|Touche échap |espace+point1+poin5 (espace+e)| +|touche entrée |poin8, joystick centre ou dpad centre| +|Touche Windows |espace+point3+point4| +|Touche alt+tab |espace+point2+point3+point4+point5 (espace+t)| +|Menu NVDA |espace+point1+point3+point4+point5 (espace+n)| +|Touche windows+d (minimiser toutes les applications) |espace+point1+point4+point5 (espace+d)| +|Dire tout |espace+point1+point2+point3+point4+point5+point6| + + + +## Fonctions Avancées {#AdvancedTopics} +### Mode Sécurisé {#SecureMode} + +Les administrateurs système peuvent souhaiter configurer NVDA pour restreindre les accès non autorisés au système. +NVDA permet l'installation d'extensions personnalisées, qui peuvent exécuter du code arbitraire, y compris lorsque NVDA est élevé aux privilèges d'administrateur. +NVDA permet également aux utilisateurs d'exécuter du code arbitraire via la console NVDA Python. +Le mode sécurisé de NVDA empêche les utilisateurs de modifier leur configuration NVDA et limite par ailleurs l'accès non autorisé au système. + +NVDA s'exécute en mode sécurisé lorsqu'il est exécuté sur les [écrans sécurisés](#SecureScreens) à moins que le [paramètre à l'échelle du système](#SystemWideParameters) `serviceDebug` soit activé. +Pour forcer NVDA à toujours démarrer en mode sécurisé, définissez le [paramètre système](#SystemWideParameters) `forceSecureMode`. +NVDA peut également être démarré en mode sécurisé avec [l'option de ligne de commande](#CommandLineOptions) `-s`. + +Le mode sécurisé désactive : + +* La sauvegarde de la configuration et autres paramètres sur disque +* La sauvegarde des gestes de commande sur disque +* Les fonctionnalités de [Profil de Configuration](#ConfigurationProfiles) telles que créer, supprimer, renommer les profils etc. +* Le chargement de la configuration depuis un dossiers personnalisés à l'aide de [l'option de ligne de commande `-c`](#CommandLineOptions) +* Mettre à jour NVDA et créer des copies portables +* [L'Add-on Store](#AddonsManager) +* La [console Python NVDA](#PythonConsole) +* La [Visionneuse du journal](#LogViewer) et la journalisation +* La [Visionneuse Braille](#BrailleViewer) et la [Visionneuse de parole](#SpeechViewer) +* L'ouverture de documents externes depuis le menu NVDA, comme le guide de l'utilisateur ou le fichier des contributeurs. + +Les copies installées de NVDA stockent leur configuration, y compris les extensions, dans `%APPDATA%\nvda`. +Pour empêcher les utilisateurs de NVDA de modifier directement leur configuration ou leurs extensions, l'accès des utilisateurs à ce dossier doit également être restreint. + +Le mode sécurisé est inefficace pour les copies portables de NVDA. +Cette limitation s'applique également à la copie temporaire de NVDA qui s'exécute au lancement de l'installateur. +Dans un environnements sécurisés, le fait qu'un utilisateur puisse exécuter un exécutable portable présente le même risque de sécurité, quele mode sécurisé soit forcé ou non. +Il est attendu que les administrateurs système empêchent l'exécution de logiciels non autorisés sur leurs systèmes, y compris les copies portables de NVDA. + +Les utilisateurs de NVDA comptent souvent sur la configuration de leur profil NVDA pour répondre à leurs besoins. +Cela peut inclure l'installation et la configuration d'extensions personnalisées, qui doivent être approuvés indépendamment de NVDA. +Le mode sécurisé gèle les modifications apportées à la configuration de NVDA, veuillez donc vous assurer que NVDA est correctement configuré avant de forcer le mode sécurisé. + +### Écrans Sécurisés {#SecureScreens} + +NVDA s'exécute en [mode sécurisé](#SecureMode) lorsqu'il est exécuté sur les écrans sécurisés à moins que le [paramètre à l'échelle du système](#SystemWideParameters) `serviceDebug` soit activé. + +Lorsqu'il s'exécute sur un écran sécurisé, NVDA utilise un profil système pour les préférences. +Les préférences utilisateur de NVDA peuvent être copiées [pour une utilisation dans les écrans sécurisés](#GeneralSettingsCopySettings). + +Les écrans sécurisés incluent : + +* L'écran de connexion à Windows +* Le dialogue Contrôle d'accès utilisateur, actif lors de l'exécution d'une action en tant qu'administrateur + * Cela inclut l'installation de programmes + +### Options de Ligne de Commande {#CommandLineOptions} + +Au démarrage, NVDA peut accepter une ou plusieurs options additionnelles pour modifier son comportement. +Vous pouvez passer autant d'options que nécessaire. +Ces options peuvent être passées quand on démarre depuis un raccourci (dans les propriétés du raccourci), depuis le dialogue Exécuter (Menu Démarrer -> Exécuter ou Windows+r) ou depuis une console de commande Windows. +Les options doivent être séparées du nom de l'exécutable NVDA et des autres options par des espaces. +Par exemple, une option utile est `--disable-addons`, qui dit à NVDA d'interrompre toutes les extensions en cours d'exécution. +Cela vous permet de déterminer si un problème est causé par une extension et de vous sortir de sérieux problèmes pouvant être causés par des extensions. + +Par exemple, vous pouvez quitter la copie en cours de NVDA en entrant ce qui suit dans le dialogue Exécuter : + + nvda -q + +Certaines options de ligne de commande ont une version courte et une version longue, tandis que d'autres n'ont qu'une version longue. +Pour celles qui ont une version courte, vous pouvez les combiner ainsi : + +| . {.hideHeaderRow} |.| +|---|---| +|`nvda -mc CONFIGPATH` |Ceci démarrera NVDA avec le son et le message de démarrage désactivé, et la configuration spécifiée.| +|`nvda -mc CONFIGPATH --disable-addons` |Même chose, mais avec les extensions désactivées| + +Certaines options de ligne de commande acceptent des paramètres additionnels ; ex : le niveau de détail du journal ou le chemin du répertoire de configuration utilisateur. +Ces paramètres doivent être placés après l'option, séparés de l'option par un espace quand il s'agit d'une option en version courte ou par un signe égal (`=`) quand il s'agit d'une option en version longue; ex : + +| . {.hideHeaderRow} |.| +|---|---| +|`nvda -l 10` |Dit à NVDA de démarrer avec le niveau de journalisation sur débogage| +|`nvda --log-file=c:\nvda.log` |Dit à NVDA d'écrire le fichier journal dans `c:\nvda.log`| +|`nvda --log-level=20 -f c:\nvda.log` |Dit à NVDA de démarrer avec le niveau de journalisation sur info et d'écrire son journal dans `c:\nvda.log`| + +Voici les options de ligne de commande de NVDA : + +| Courte |Longue |Description| +|---|---|---| +|`-h` |`--help` |affiche l'aide de la ligne de commande et s'arrête| +|`-q` |`--quit` |Quitte la copie en cours d'exécution de NVDA| +|`-k` |`--check-running` |Indique si NVDA est en cours d'exécution via le code retour; 0 si oui, 1 si non| +|`-f NOMDUFICHIERJOURNAL` |`--log-file=NOMDUFICHIERJOURNAL` |Le fichier où les messages du journal doivent être écrits. La journalisation est toujours désactivée si le mode sécurisé est activé.| +|`-l NIVEAUDEJOURNALISATION` |`--log-level=NIVEAUDEJOURNALISATION` |Le niveau minimal de messages journalisés (débogage 10, entrées/sorties 12, avertissements de débogage 15, info 20, désactivé 100). La journalisation est toujours désactivée si le mode sécurisé est activé.| +|`-c CHEMINDECONFIG` |`--config-path=CHEMINDECONFIG` |Le chemin vers lequel tous les paramètres de NVDA sont stockés. La valeur par défaut est forcée si le mode sécurisé est activé.| +|Aucun |`--lang=LANGUAGE` |Remplacer la langue NVDA configurée. Choisissez "Windows" pour la langue en cours par défaut, "en" pour Anglais, etc.| +|`-m` |`--minimal` |Pas de sons, pas d'interface, pas de message de démarrage etc.| +|`-s` |`--secure` |Démarre NVDA en [Mode Sécurisé](#SecureMode)| +|Aucune |`--disable-addons` |Les extensions n'auront pas d'effet| +|Aucune |`--no-logging` |Désactive complètement la journalisation durant l'utilisation de NVDA. Ce paramètre peut être ignoré si un niveau de journalisation (`--loglevel`, `-l`) est spécifié dans la ligne de commande ou si la journalisation de débogage est activée.| +|Aucune |`--debug-logging` |Active le niveau de journalisation débogage seulement pour cette session. Ce paramètre remplacera tout autre niveau de journalisation (`--loglevel`, `-l`) argument donné, incluant l'option pas de journalisation.| +|Aucune |`--no-sr-flag` |Ne change pas l'indicateur système global de revue d'écran| +|Aucune |`--install` |Installe NVDA (en démarrant la copie nouvellement installée)| +|Aucune |`--install-silent` |Installe NVDA silencieusement (sans démarrer la copie nouvellement installée)| +|Aucune |`--enable-start-on-logon=True|False` |Durant l'installation, active le [démarrage sur l'écran de connexion](#StartAtWindowsLogon) de NVDA| +|Aucune |`--copy-portable-config` |À l'installation, copie la configuration portable depuis le chemin indiqué (`--config-path`, `-c`) vers le compte utilisateur courant| +|Aucune |`--create-portable` |Crée une copie portable de NVDA (puis démarre la copie nouvellement créée). `--portable-path` doit être spécifié| +|Aucune |`--create-portable-silent` |Crée une copie portable de NVDA (sans démarrer la copie nouvellement créée). `--portable-path` doit être spécifié| +|Aucune |`--portable-path=PORTABLEPATH` |L'emplacement où la copie portable sera créée| + +### Paramètres Système {#SystemWideParameters} + +NVDA permet de définir certaines valeurs dans la base de registre du système ce qui modifie le comportement général de NVDA. +Ces valeurs sont stockées dans la base de registres sous l'une des clés suivantes : + +* Systèmes 32-bits : `HKEY_LOCAL_MACHINE\SOFTWARE\nvda` +* Systèmes 64-bits : `HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\nvda` + +Les valeurs suivantes peuvent être définies dans ces clés de registre : + +| Nom |Type |valeurs Possibles |Description| +|---|---|---|---| +|`configInLocalAppData` |DWORD |0 (par défaut) pour désactiver, 1 pour activer |Si activé, stocke la configuration de l'utilisateur NVDA dans les données d'application locales au lieu des données d'application itinérantes| +|`serviceDebug` |DWORD |0 (par défaut) pour désactiver, 1 pour activer |S'il est activé, désactive [Secure Mode](#SecureMode) sur [secure screens](#SecureScreens). En raison de plusieurs implications majeures en matière de sécurité, l'utilisation de cette option est fortement déconseillée| +|`forceSecureMode` |DWORD |0 (par défaut) pour désactiver, 1 pour activer |Si activé, force [le mode sécurisé](#SecureMode) à être activé lors de l'exécution de NVDA.| + +## Informations Complémentaires {#FurtherInformation} + +Si vous avez besoin d'informations complémentaires ou d'aide concernant l'utilisation de NVDA, veuillez visiter le [site web de NVDA](NVDA_URL). +Sur ce site, vous pourrez trouver des informations complémentaires telles que des listes de discussion spécialisées et d'autres ressources communautaires pour vous aider à utiliser NVDA. +Ce site fournit également des informations concernant le développement de NVDA. diff --git a/tests/markdownTranslate/fr_pretranslated_2024.3beta6_userGuide.md b/tests/markdownTranslate/fr_pretranslated_2024.3beta6_userGuide.md new file mode 100644 index 00000000000..d8c74a5d031 --- /dev/null +++ b/tests/markdownTranslate/fr_pretranslated_2024.3beta6_userGuide.md @@ -0,0 +1,5110 @@ +# Guide de l'utilisateur de NVDA NVDA_VERSION + +[TOC] + + + + + +## Introduction {#Introduction} + +Bienvenue dans NVDA ! + +NonVisual Desktop Access (NVDA) est une revue d'écran gratuite et à source ouverte pour le système d'exploitation Microsoft Windows. +En donnant des informations via une voix synthétique et le braille, il permet aux personnes aveugles ou malvoyantes d'accéder à un ordinateur sans coût additionnel par rapport à une personne voyante. +NVDA est développé par [NV Access](https://www.nvaccess.org/), avec des contributions de la communauté. + +### Caractéristiques Générales {#GeneralFeatures} + +En restituant l'information par synthèse vocale ou en braille, NVDA permet aux personnes aveugles et malvoyantes d'utiliser le système d'exploitation Windows ainsi que beaucoup d'applications disponibles dans cet environnement. + +Une courte vidéo de démonstration en anglais, ["Qu'est-ce que NVDA ?"](https://www.youtube.com/watch?v=tCFyyqy9mqo) est disponible sur la chaîne Youtube de NV Access. + +Ses points forts sont : + +* La prise en charge d'applications grand-public telles que des navigateurs Web, clients e-mail, programmes de tchat sur Internet et suites bureautiques +* Un synthétiseur intégré prenant en charge plus de 80 langues +* L'annonce, quand c'est possible, d'informations de mise en forme du texte telles que le nom et la taille de la police, le style et les fautes d'orthographe +* L'annonce automatique du texte sous la souris et, en option, l'indication sonore de la position de la souris +* La prise en charge de nombreux afficheurs braille, incluant la capacité de détecter automatiquement beaucoup d'entre eux ainsi que la saisie pour les afficheurs disposant d'un clavier braille +* La possibilité de s'exécuter entièrement depuis une clé USB ou tout autre média portable sans avoir à installer +* Un installateur parlant facile à utiliser +* Une traduction dans 54 langues +* La prise en charge des environnements Windows modernes, incluant les versions 32 et 64 bits +* L'accès à l'écran de connexion à Windows et aux [autres écrans sécurisés](#SecureScreens). +* L'annonce des contrôles et du texte durant l'utilisation de gestes tactiles +* Le support des interfaces d'accessibilité communes telles que Microsoft Active Accessibility, Java Access Bridge, IAccessible2 et UI Automation +* Le support de l'invite de commandes Windows et des applications en mode console +* La possibilité de mettre en évidence le focus système + +### Configuration Système Requise {#SystemRequirements} + +#### Configuration système recommandée {#MinimumSystemRequirements} +* Systèmes d'exploitation : éditions 64 bits de Windows 10, Windows 11 et Windows Server 2022 + * Les variantes AMD64 et ARM64 de Windows sont prises en charge. +* au moins 150 Mo d'espace de stockage. +* au moins 4 Go de RAM. + +#### Configuration système minimale requise {#MinimumSystemRequirements} +* Systèmes d'Exploitation : toutes les éditions 32-bit et 64-bit de Windows 8.1, Windows 10, Windows 11, et toutes les versions serveur à partir de Windows Server 2012 R2. + * les variantes AMD64 et ARM64 de Windows sont prises en charge. + * Remarque : les systèmes d'exploitation 32 bits ne sont plus pris en charge activement. + * Veuillez noter que les versions de Windows 8.1 et Windows Server antérieures à 2022 ne sont plus prises en charge activement. +* au moins 150 Mo d'espace de stockage. + +### Internationalisation {#Internationalization} + +Il est important que chacun, partout dans le monde, quelle que soit sa langue, ait le même accès aux technologies. +Outre l'anglais, NVDA a été traduit en 52 langues : l'afrikaans, l'albanais, l'amharique, l'arabe, l'aragonais, le portugais (Brésil et Portugal), le bulgare, le birman, le catalan, l'espagnol (Colombie et Espagne), le croate, le tchèque, le danois, le néerlandais, le persan, le finnois, le français, le galicien, le Géorgien, l'allemand (Allemagne et Suisse), le grec, l'hébreu, l'hindi, le hongrois, l'islandais, l'irlandais, l'italien, le japonais, le kannada, le coréen, le kirghize, le lituanien, le macédonien, le Mongol, le népalais, le norvégien, le polonais, le portugais, le punjabi, le roumain, le russe, le serbe, le slovaque, le slovène, l'espagnol, le suédois, le tamoul, le thaï, le chinois traditionnel et simplifié, le turc, l'ukrainien et le vietnamien. + +### Support des Synthèses Vocales {#SpeechSynthesizerSupport} + +En plus de proposer ses messages et son interface en plusieurs langues, NVDA permet également à l'utilisateur de lire les contenus dans n'importe quelle langue, dans la mesure où il possède un synthétiseur parlant cette langue. + +NVDA est fourni avec [eSpeak NG](https://github.com/espeak-ng/espeak-ng), un synthétiseur de parole gratuit, à source ouverte, multilingue. + +Pour des informations concernant les autres synthétiseurs de parole pris en charge par NVDA, reportez-vous à la section [Synthétiseurs de parole pris en charge](#SupportedSpeechSynths). + +### Support du Braille {#BrailleSupport} + +Pour les utilisateurs possédant un terminal braille, NVDA peut afficher ses informations en braille. +NVDA utilise le traducteur braille à source ouverte [LibLouis](https://liblouis.io/) pour générer des séquences braille à partir de texte. +La saisie braille en intégral ou abrégé via un clavier braille est également supportée. +De plus, NVDA détectera automatiquement beaucoup de terminaux braille par défaut. +Reportez-vous à la section [Terminaux braille pris en charge](#SupportedBrailleDisplays) pour les informations concernant les terminaux braille. + +NVDA propose de nombreux codes braille couvrant un grand ensemble de langues. Dans bien des cas, le braille intégral et abrégé sont disponibles. Pour les utilisateurs francophones, le braille français unifié est disponible en intégral et abrégé. + +### Licence et Copyright {#LicenseAndCopyright} + +NVDA est Copyright (C) NVDA_COPYRIGHT_YEARS NVDA contributors. + +NVDA est disponible sous la licence GNU General Public License Version 2), avec deux exceptions spéciales. +Les exceptions sont précisées dans le document de licence dans la section "Non-GPL Components in Plugins and Drivers" et "Microsoft Distributable Code". +NVDA inclut et utilise également des composants qui sont disponibles sous différentes licences libres et open source. +Vous avez le droit de distribuer ou modifier ce logiciel comme il vous plaît pourvu que vous distribuiez la licence avec le logiciel, et rendiez disponible l'intégralité du code source pour toute personne qui le veut. +Ceci s'applique aussi bien à la version originale qu'aux copies modifiées de ce logiciel, et aussi à tout travail dérivé. + +Pour plus de détails, vous pouvez [lire l'intégralité de la licence.](https://www.gnu.org/licenses/old-licenses/gpl-2.0.html) +Pour les détails concernant les exceptions, veuillez consulter le document de licence depuis le menu NVDA dans la section "Aide". + +## Guide de Démarrage Rapide de NVDA {#NVDAQuickStartGuide} + +Ce guide de démarrage rapide contient trois sections principales : téléchargement, configuration initiale et exécution de NVDA. +Celles-ci sont suivies d'informations sur l'ajustement des préférences, l'utilisation des extensions, la participation à la communauté et l'obtention d'aide. +Les informations contenues dans ce guide sont condensées à partir d'autres parties du Guide de l'utilisateur NVDA. +Veuillez vous reporter au Guide de l'utilisateur complet pour obtenir des informations plus détaillées sur chaque sujet. + +### Télécharger NVDA {#GettingAndSettingUpNVDA} + +NVDA est entièrement gratuit pour tout le monde. +Il ne nécessite pas de clé de licence ni d'abonnement coûteux à payer. +NVDA est mis à jour, en moyenne, quatre fois par an. +La dernière version de NVDA est toujours disponible à partir de la page "Télécharger" du [site Web de NV Access](NVDA_URL). + +NVDA fonctionne avec toutes les versions récentes de Microsoft Windows. +Vérifiez les [Configurations requises](#SystemRequirements) pour plus de détails. + +#### Étapes pour Télécharger NVDA {#StepsForDownloadingNVDA} + +Ces étapes supposent une certaine familiarité avec la navigation sur une page Web. + +* Ouvrez votre navigateur Web (appuyez sur la touche `Windows`, tapez le mot "internet" sans les guillemets et appuyez sur `entrer`) +* Chargez la page de téléchargement de NV Access (Appuyez sur `alt+d`, tapez l'adresse suivante et appuyez sur `entrée`): +https://www.nvaccess.org/download +* Activez le bouton "télécharger" +* Le navigateur peut ou non demander une action à effectuer après le téléchargement, puis lancer le téléchargement +* Selon le navigateur, le fichier peut s'exécuter automatiquement après son téléchargement +* Si le fichier doit être lancé manuellement, appuyez sur `alt+n` pour accéder à la zone de notification, puis sur `alt+r` pour exécuter le fichier (ou les étapes de votre navigateur) + +### Mise en place de NVDA {#SettingUpNVDA} + +Démarrer le fichier téléchargé exécutera une version temporaire de NVDA. +Il vous sera alors demandé si vous souhaitez installer NVDA, créer une copie portable ou simplement continuer à utiliser la copie temporaire. + +NVDA n'a pas besoin d'accéder à Internet pour s'exécuter ou s'installer une fois le lanceur téléchargé. +Si elle est disponible, une connexion Internet permet à NVDA de vérifier périodiquement les mises à jour. + +#### Étapes pour exécuter le lanceur téléchargé {#StepsForRunningTheDownloadLauncher} + +Le fichier d'installation est nommé "nvda_2022.1.exe" ou similaire. +L'année et la version changent entre les mises à jour pour refléter la version actuelle. + +1. Exécutez le fichier téléchargé. +Une musique est jouée pendant le chargement d'une copie temporaire de NVDA. +Une fois chargé, NVDA parlera tout au long du processus. +1. La fenêtre du Lanceur NVDA apparaît avec le contrat de licence. +Appuyez sur `flècheBas` pour lire le contrat de licence si vous le souhaitez. +1. Appuyez sur `tab` pour passer à la case "J'accepte", puis appuyez sur la `barre d'espace` pour la cocher. +1. Appuyez sur `tab` pour parcourir les options, puis appuyez sur `entrée` sur l'option souhaitée. + +Les options sont : + +* "Installer NVDA sur cet ordinateur" : C'est l'option principale que la plupart des utilisateurs souhaitent pour une utilisation facile de NVDA. +* "Créer une copie portable" : Cela permet à NVDA d'être copié dans n'importe quel dossier sans installation. +Ceci est utile sur les ordinateurs sans droits d'administrateur ou sur une clé USB à emporter avec vous. +Lorsque cette option est sélectionnée, NVDA parcourt les étapes pour créer une copie portable. +La principale chose que NVDA doit connaître est le dossier dans lequel configurer la copie portable. +* "Continuer l'exécution" : Cela permet de maintenir la copie temporaire de NVDA en cours d'exécution. +Ceci est utile pour tester les fonctionnalités d'une nouvelle version avant de l'installer. +Lorsque cette option est sélectionnée, la fenêtre du lanceur se ferme et la copie temporaire de NVDA continue de s'exécuter jusqu'à ce qu'elle soit fermée ou que le PC soit arrêté. +Notez que les modifications apportées aux paramètres ne sont pas enregistrées. +* "Quitter" : Cela ferme NVDA sans effectuer aucune action. + +Si vous prévoyez de toujours utiliser NVDA sur cet ordinateur, vous choisirez d'installer NVDA. +L'installation de NVDA permettra des fonctionnalités supplémentaires telles que le démarrage automatique après la connexion, la possibilité de lire l'écran de connexion Windows et [les écrans sécurisés](#SecureScreens). +Cela ne peut pas être fait avec des copies portables ou temporaires. +Pour plus de détails sur les limitations lors de l'exécution d'une copie portable ou temporaire de NVDA, veuillez consulter les [Restrictions relatives aux copies portables et temporaires](#PortableAndTemporaryCopyRestrictions). + +L'installation propose également de créer des raccourcis dans le menu Démarrer et sur le bureau, et permet à NVDA d'être démarré avec `contrôle+alt+n`. + +#### Étapes pour installer NVDA depuis le lanceur {#StepsForInstallingNVDAFromTheLauncher} + +Ces étapes décrivent les options de configuration les plus courantes. +Pour plus de détails sur les options disponibles, veuillez consulter [Options d'installation](#InstallingNVDA). + +1. Depuis le lanceur, assurez-vous que la case à cocher pour accepter la licence est cochée. +1. Appuyez sur `Tab` jusqu'au bouton "Installer NVDA sur cet ordinateur" et activez-le. +1. Ensuite, viennent des options pour utiliser NVDA lors de la connexion à Windows et pour créer un raccourci sur le bureau. +Celles-ci sont cochées par défaut. +Si vous le souhaitez, appuyez sur `tabulation` et `barre d'espace` pour modifier l'une de ces options, ou laissez-les par défaut. +1. Appuyez sur `entrée` pour continuer. +1. Un dialogue Windows "Contrôle de compte d'utilisateur (UAC)" apparaît et vous demande "Voulez-vous autoriser cette application à apporter des modifications à votre PC ?". +1. Appuyez sur `alt+o` pour accepter l'invite UAC. +1. Une barre de progression se remplit au fur et à mesure de l'installation de NVDA. +Au cours de ce processus, NVDA émet un bip de plus en plus aigu. +Ce processus est souvent rapide et peut ne pas être remarqué. +1. Un dialogue apparaît confirmant que l'installation de NVDA a réussi. +Le message demande d'"Appuyer sur OK pour démarrer la copie installée". +Appuyez sur `entrée` pour démarrer la copie installée. +1. Le dialogue "Bienvenue dans NVDA" apparaît et NVDA lit un message de bienvenue. +Le focus est mis sur le menu déroulant "Disposition du clavier". +Par défaut, la disposition du clavier "Ordinateur de bureau" utilise le pavé numérique pour certaines fonctions. +Si vous le souhaitez, appuyez sur `flècheBas` pour choisir la disposition du clavier "Ordinateur portable" afin de réaffecter les fonctions du pavé numérique à d'autres touches. +1. Appuyez sur `tab` pour passer à "Utiliser `verrouillage majuscule` comme touche de modification NVDA". +`Insert` est défini comme touche de modification NVDA par défaut. +Appuyez sur `barre d'espace` pour sélectionner `verrouillage majuscule` comme touche de modification alternative. +Notez que la disposition du clavier est définie séparément de la touche de modification NVDA. +La touche de modification NVDA et la disposition du clavier peuvent être modifiées ultérieurement à partir des paramètres du clavier. +1. Utilisez `tab` et `barre d'espace` pour ajuster les autres options sur cet écran. +Celles-ci définissent si NVDA doit démarrer automatiquement. +1. Appuyez sur `entrée` pour fermer le dialogue avec NVDA en cours d'exécution. + +### Exécuter NVDA {#RunningNVDA} + +Le guide de l'utilisateur complet de NVDA contient toutes les commandes NVDA, divisées en différentes sections pour référence. +Les tableaux de commandes sont également disponibles dans le "Résumé des Commandes". +Le module de formation NVDA "Basic Training for NVDA" (en anglais) étudie chaque commande plus en profondeur avec des activités étape par étape. +"Basic Training for NVDA" est disponible dans la [boutique NV Access](http://www.nvaccess.org/shop). + +Voici quelques commandes de base fréquemment utilisées. +Toutes les commandes sont configurables, ce sont donc les frappes par défaut pour ces fonctions. + +#### La Touche de Modification NVDA {#NVDAModifierKey} + +La touche de modification NVDA par défaut est soit `pavnumZéro`, (avec `verrouillage numérique` désactivé), soit la touche `insert`, près des touches `effacement`, `début` et `fin`. +La touche de modification NVDA peut également être définie sur la touche `verrouillage majuscule`. + +#### Aide à la Saisie {#InputHelp} + +Pour apprendre et pratiquer l'emplacement des touches, appuyez sur `NVDA+1` pour activer l'aide à la saisie. +En mode d'aide à la saisie, effectuer n'importe quel geste de saisie (comme appuyer sur une touche ou effectuer un geste tactile) signalera l'action et décrira ce qu'elle fait (le cas échéant). +Les commandes réelles ne s'exécuteront pas en mode d'aide à la saisie. + +#### Démarrer et Arrêter NVDA {#StartingAndStoppingNVDA} + +| Nom |Touche ordinateur de bureau |Touche ordinateur portable |Description| +|---|---|---|---| +|Démarrer NVDA |`contrôle+alt+n` |`contrôle+alt+n` |Démarre ou redémarre NVDA| +|Quitter NVDA |`NVDA+q`, puis `entrée` |`NVDA+q`, puis `entrée` |quitte NVDA| +|Interrompre ou relancer la parole |`majuscule` |`majuscule` |Interrompt instantanément la parole. Un nouvel appui reprendra la parole là où elle s'est arrêtée| +|Arrêt de la parole |`contrôle` |`contrôle` |Interrompt instantanément la parole| + +#### Lire du texte {#ReadingText} + +| Nom |Touche ordinateur de bureau |Touche ordinateur portable |Description| +|---|---|---|---| +|Dire tout |`NVDA+flècheBas` |`NVDA+a` |Commence à lire à partir de la position courante en la déplaçant au fur et à mesure| +|Lire la ligne courante |`NVDA+flècheHaut` |`NVDA+l` |Lit la ligne. Un double appui épelle la ligne. Un triple appui épelle la ligne en utilisant la description de caractères (Alpha, Bravo, Charlie, etc)| +|Lire la sélection |`NVDA+maj+flècheHaut` |`NVDA+maj+s` |Lit tout texte sélectionné. Un double appui épelle l'information. Un triple appui l'épelle en code international| +|Lire le texte du presse-papiers |`NVDA+c` |`NVDA+c` |Lit tout texte dans le presse-papiers. Un double appui épelle l'information. Un triple appui l'épelle en code international| + +#### Annoncer la position et autres informations {#ReportingLocation} + +| Nom |Touche ordinateur de bureau |Touche ordinateur portable |Description| +|---|---|---|---| +|Titre de la fenêtre |`NVDA+t` |`NVDA+t` |Annonce le titre de la fenêtre actuellement active. Un double appui épelle l'information. Un triple appui la copie dans le presse-papiers| +|Annoncer le focus |`NVDA+tab` |`NVDA+tab` |Annonce le contrôle actuellement en focus. Un double appui épelle l'information. Un triple appui l'épelle en code international| +|Lire la fenêtre |`NVDA+b` |`NVDA+b` |Lit entièrement la fenêtre courante (utile pour les dialogues)| +|Lire la barre d'état |`NVDA+fin` |`NVDA+maj+fin` |Annonce la barre d'état si NVDA en trouve une. Un double appui épelle l'information. Un triple appui la copie dans le presse-papiers| +|Lire l'heure |`NVDA+f12` |`NVDA+f12` |Un appui annonce l'heure courante, un double appui annonce la date. L'heure et la date sont annoncées dans le format spécifié dans les paramètres Windows pour l'horloge de la barre d'état système.| +|Annoncer la mise en forme du texte |`NVDA+f` |`NVDA+f` |Annonce la mise en forme du texte. Un double appui affiche l'information dans une fenêtre| +|Annoncer la destination du lien |`NVDA+k` |`NVDA+k` |Un appui annonce l'URL de destination du lien à la position courante du curseur ou du focus. Deux appuis l'affichent dans une fenêtre pour une revue plus attentive| + +#### Choisir les informations lues par NVDA {#ToggleWhichInformationNVDAReads} + +| Nom |Touche ordinateur de bureau |Touche ordinateur portable |Description| +|---|---|---|---| +|Dire les caractères tapés |`NVDA+2` |`NVDA+2` |Lorsqu'activé, NVDA annoncera tous les caractères que vous tapez sur le clavier.| +|Dire les mots tapés |`NVDA+3` |`NVDA+3` |Lorsqu'activé, NVDA annoncera les mots que vous tapez sur le clavier.| +|Dire les touches de commande |`NVDA+4` |`NVDA+4` |Lorsqu'activé, annoncera toutes les touches n'étant pas des caractères que vous taperez sur le clavier. Cela inclut les combinaisons de touches telles que contrôle plus une autre lettre.| +|Activer le suivi de la souris |`NVDA+m` |`NVDA+m` |Lorsqu'activé, NVDA annoncera le texte actuellement sous le pointeur souris, tandis que vous le déplacez sur l'écran. Cela vous permet de trouver les choses sur l'écran, en déplaçant physiquement la souris, plutôt que d'essayer de les trouver en utilisant la navigation par objet.| + +#### La boucle des paramètres synthétiseur {#TheSynthSettingsRing} + +| Nom |Touche ordinateur de bureau |Touche ordinateur portable |Description| +|---|---|---|---| +|Aller au paramètre synthétiseur suivant |`NVDA+contrôle+flècheDroit` |`NVDA+maj+contrôle+flècheDroit` |Va au paramètre vocal suivant disponible, retournant au premier après le dernier| +|Aller au paramètre synthétiseur précédent |`NVDA+contrôle+flècheGauche` |`NVDA+maj+contrôle+flècheGauche` |Va au paramètre vocal précédent disponible, retournant au dernier après le premier| +|Augmenter le paramètre synthétiseur courant |`NVDA+contrôle+flècheHaut` |`NVDA+maj+contrôle+flècheHaut` |Augmente le paramètre vocal sur lequel vous vous trouvez. Ex. augmente le débit, choisit la voix suivante, augmente le volume| +|Augmenter le paramètre courant dans la boucle des paramètres du synthétiseur d'un interval plus important |`NVDA+contrôle+pagePrec` |`NVDA+maj+contrôle+pagePrec` |Augmente d'un pas plus important la valeur du paramètre vocal courant sur lequel vous vous trouvez. Ex. lorsque vous êtes sur le paramètre du choix de la voix, avancer de 20 voix ; lorsque vous êtes sur un paramètres avec potentiomètre (débit, hauteur, etc.), la valeur sera incrémentée de 20%| +|Diminuer le paramètre synthétiseur courant |`NVDA+contrôle+flècheBas` |`NVDA+maj+contrôle+flècheBas` |diminue le paramètre vocal sur lequel vous vous trouvez. Ex. diminue le débit, choisit la voix précédente, diminue le volume| +|Diminuer le paramètre courant dans la boucle des paramètres du synthétiseur d'un interval plus important |`NVDA+contrôle+pageSuiv` |`NVDA+maj+contrôle+pageSuiv` |Diminue d'un pas plus important la valeur du paramètre vocal courant sur lequel vous vous trouvez. Ex. lorsque vous êtes sur le paramètre du choix de la voix, reculer de 20 voix ; lorsque vous êtes sur un paramètres avec potentiomètre (débit, hauteur, etc.), la valeur sera décrémentée de 20%| + +Il est également possible de sauter à la première ou à la dernière valeur du paramètre de synthétiseur courant en attribuant des gestes personnalisés dans la [boîte de dialogue Gestes de commandes](#InputGestures), sous la catégorie parole. +Par exemple, cela signifie que lorsque le débit est le paramètre courant, le débit sera modifié à 0 ou 100. +Lorsque vous êtes sur le paramètre voix, la première ou la dernière voix sera activée. + +#### Navigation sur le web {#WebNavigation} + +La liste complète des touches de navigation à lettre unique se trouve dans la section [Mode Navigation](#BrowseMode) du guide de l'utilisateur. + +| Commande |Frappe |Description| +|---|---|---| +|Titre |`h` |Aller au titre suivant| +|Titre de niveau 1, 2, ou 3 |`1`, `2`, `3` |Aller au titre suivant au niveau spécifié| +|Champ de formulaire |`f` |Aller au champ de formulaire suivant (zone d'édition, bouton, etc)| +|Lien |`k` |Aller au lien suivant| +|Région |`d` |Aller à la région suivante| +|Liste |`l` |Aller à la liste suivante| +|Tableau |`t` |Aller au tableau suivant| +|Revenir en arrière |`maj+lettre` |Pressez `maj` et n'importe laquelle des lettres ci-dessus pour aller à l'élément précédent de ce type| +|Liste des éléments |`NVDA+f7` |Liste différents types d'éléments, tels que liens et titres| + +### Préférences {#Preferences} + +La plupart des fonctions NVDA peuvent être activées ou modifiées via les paramètres NVDA. +Les paramètres et d'autres options sont disponibles via le menu de NVDA. +Pour ouvrir le menu de NVDA, appuyez sur `NVDA+n`. +Pour ouvrir directement le dialogue des paramètres généraux de NVDA, appuyez sur `NVDA+contrôle+g`. +De nombreux écrans de paramètres ont des touches pour les ouvrir directement, comme `NVDA+contrôle+s` pour le synthétiseur, ou `NVDA+contrôle+v` pour les autres options de parole. + +### Extensions {#Addons} +Les extension sont des programmes qui fournissent des fonctionnalités nouvelles ou modifiées pour NVDA. +Les extensions sont développées par la communauté NVDA ou par des sociétés externes et ne sont pas affiliés à NV Access. +Comme pour tout logiciel, il est important de faire confiance au développeur d'une extension avant de l’utiliser. +Veuillez consulter [Installation d'extensions](#AddonStoreInstalling) pour savoir comment vérifier les extensions avant l'installation. + +La première fois que l'Add-on Store est ouvert, NVDA affiche un avertissement concernant les extensions. +Les extensions ne sont pas approuvées par NV Access et peuvent avoir des fonctionnalités et un accès aux informations sans restriction. +Appuyez sur `espace` si vous avez lu l'avertissement et que vous n'avez pas besoin de le voir la prochaine fois. +Appuyez sur `tab` pour atteindre le bouton "OK", puis sur `Entrée` pour accepter l'avertissement et accéder à l'Add-on Store. +La section "[Extensions et Add-on Store](#AddonsManager)" du guide de l'utilisateur contient des informations sur chaque fonctionnalité de l'Add-on Store. + +L'Add-on Store est disponible dans le menu Outils. +Appuyez sur `NVDA+n` pour ouvrir le menu NVDA, puis sur `o` pour Outils, puis sur `s` pour Add-on Store. +Lorsque l'Add-on Store s'ouvre, il affiche "Extensions disponibles" si aucune extension n'est installée. +Lorsque des extensions sont déjà installées, l'Add-on Store s'ouvre sur l'onglet "Extensions installées". + +#### Extensions disponibles {#AvailableAddons} +Lorsque la fenêtre s'ouvre pour la première fois, le chargement des extensions peut prendre quelques secondes. +NVDA lira le nom de la première extension une fois que le chargement de la liste des extensions est terminé. +Les extensions disponibles sont listées par ordre alphabétique dans une liste à plusieurs colonnes. +Pour parcourir la liste et trouver une extension spécifique : + +1. Utilisez les touches fléchées ou appuyez sur la première lettre du nom d'une extension pour vous déplacer dans la liste. +1. Appuyez une fois sur `tab` pour passer à une description de l'extension actuellement sélectionné. +1. Utilisez les [touches de lecture](#ReadingText) ou les touches fléchées pour lire la description complète. +1. Appuyez sur `tab` pour atteindre le bouton "Actions", qui peut être utilisé pour installer l'extension entre autres actions. +1. Appuyez sur `tab` jusqu'au champ "Autres détails", qui répertorie des détails tels que l'éditeur, la version et la page web. +1. Pour revenir à la liste des extensions, appuyez sur `alt+e`, ou `maj+tab` jusqu'à atteindre la liste. + +#### Rechercher des extensions {#SearchingForAddons} +En plus de pouvoir parcourir toutes les extensions disponibles, il est possible de filtrer les extensions affichées. +Pour effectuer une recherche, appuyez sur `alt+r` pour accéder au champ "Recherche" et tapez le texte à rechercher. +La recherche vérifie les correspondances dans les champs ID, nom affiché, éditeur, auteur ou description de l'extension. +La liste se met à jour au cours de la saisie des termes de recherche. +Une fois la saisie terminée, appuyez sur `tab` pour accéder à la liste filtrée des extensions et parcourir les résultats. + +#### Installer des extensions {#InstallingAddons} + +Pour installer une extension : + +1. Lorsque le focus se trouve sur une extension que vous souhaitez installer, appuyez sur `entrée`. +1. Le menu d'actions s'ouvre avec une liste d'actions ; la première action est "Installer". +1. Pour installer l'extension, appuyez sur `i` ou `flècheBas` pour atteindre "Installer" et appuyez sur `entrée`. +1. Le focus revient sur l'extension dans la liste et NVDA lira les détails de cette extension. +1. L'information "État" annoncée par NVDA passent de "Disponible" à "Téléchargement en cours". +1. Une fois le téléchargement de l'extension terminé, elle passe à l'état "Téléchargé, en attente d'installation". +1. Répétez cette procédure pour toutes les extensions que vous souhaitez également installer. +1. Une fois que vous avez fini, appuyez sur `tab` jusqu'à ce que le focus soit sur le bouton "Fermer", puis appuyez sur `entrée`. +1. Les extensions téléchargées démarreront leur processus d'installation dès la fermeture de l'Add-on Store. +Pendant le processus d'installation, les extensions peuvent afficher des boîtes de dialogue auxquelles vous devrez répondre. +1. Une fois que les extensions sont installées, une boîte de dialogue apparaît vous informant que des modifications ont été apportées et vous devez redémarrer NVDA pour que l'installation des extensions soit terminée. +1. Appuyez sur `entrée` pour redémarrer NVDA. + +#### Gérer les extensions {#ManagingInstalledAddons} +Appuyez sur `contrôle+tab` pour vous déplacer entre les onglets de l'Add-on Store. +Les onglets sont : "Extensions installées", "Mises à jour", "Extensions disponibles" et "Extensions incompatibles installés". +Chacun des onglets est présenté de manière similaire, sous la forme d'une liste d'extensions, d'un panneau pour plus de détails sur l'extension sélectionné et d'un bouton pour effectuer des actions pour l'extension sélectionnée. +Le menu d'actions des extensions installés comprend les actions "Désactiver" et "Supprimer" au lieu de "Installer". +La désactivation d'une extension empêche NVDA de la charger, mais la garde installée. +Pour réactiver une extension désactivée, appuyez sur "Activer" dans le menu actions. +Après avoir activé, désactivé ou supprimé des extensions, vous serez invité à redémarrer NVDA lors de la fermeture de l'Add-on Store. +Ces modifications ne prendront effet qu'une fois NVDA redémarré. +Veuillez noter que dans la fenêtre de l'Add-on Store, `échap` fonctionne de la même manière que le bouton Fermer. + +#### Mettre à jour des extensions {#UpdatingAddons} +Lorsqu'une mise à jour pour une extension que vous avez installée est disponible, elle sera listée dans l'onglet "Mises à jour". +Appuyez sur `contrôle+tab` pour accéder à cet onglet depuis n'importe où dans l'Add-on Store. +L'état de l'extension sera "Mise à jour disponible". +La liste indiquera la version actuellement installée et la version disponible. +Appuyez sur `entrée` sur l'extension pour ouvrir la liste d'actions ; choisissez "Mettre à jour". + +Par défaut, après le démarrage de NVDA, vous serez averti si des mises à jour d'extensions sont disponibles. +Pour en savoir plus et configurer ce comportement, reportez-vous à ["Notifications de mise à jour"](#AutomaticAddonUpdates). + +### Communauté {#Community} + +NVDA a une communauté d'utilisateurs dynamique. +Il existe une [liste de diffusion principale en anglais](https://nvda.groups.io/g/nvda) et une page complète de [groupes de langues locales](https://github.com/nvaccess/nvda-community/wiki/Connect) . +NV Access, développeur de NVDA, est actif sur Twitter [Twitter](https://twitter.com/nvaccess) et [Facebook](https://www.facebook.com/NVAccess). +NV Access a également un [blog In-Process](https://www.nvaccess.org/category/in-process/) régulier. + +Il existe également un programme [NVDA Certified Expert](https://certification.nvaccess.org/). +Il s'agit d'un examen en ligne que vous pouvez passer pour démontrer vos compétences dans NVDA. +[Les experts certifiés NVDA](https://certification.nvaccess.org/) peuvent répertorier leurs coordonnées et les détails commerciaux pertinents. + +### Obtenir de l'aide {#GettingHelp} + +Pour obtenir de l'aide sur NVDA, appuyez sur `NVDA+n` pour ouvrir le menu, puis sur `h` pour obtenir de l'aide. +À partir de ce sous-menu, vous pouvez accéder au Guide de l'utilisateur, à une référence rapide des commandes, à l'historique des nouvelles fonctionnalités et bien plus encore. +Ces trois premières options s'ouvrent dans le navigateur Web par défaut. +Il existe également du matériel de formation plus complet (en anglais) disponible dans la [Boutique NV Access](https://www.nvaccess.org/shop). + +Nous vous recommandons de commencer par le module "Formation de base pour NVDA". +Ce module couvre les concepts allant de la mise en route à la navigation sur le Web et à l'utilisation de la navigation par objet. +Il est disponible en : + +* [Texte électronique](https://www.nvaccess.org/product/basic-training-for-nvda-ebook/), qui inclut les formats Word DOCX, page Web HTML, eBook ePub et Kindle KFX. +* [Lecture vocale (voix humaine), audio mp3](https://www.nvaccess.org/product/basic-training-for-nvda-downloadable-audio/) +* [Version papier Braille UEB](https://www.nvaccess.org/product/basic-training-for-nvda-braille-hard-copy/) avec livraison incluse partout dans le monde. + +D'autres modules, et le [Pack de productivité NVDA](https://www.nvaccess.org/product/nvda-productivity-bundle/) à prix réduit, sont disponibles dans la [Boutique NV Access](https://www.nvaccess.org/shop/). + +NV Access vend également une [assistance téléphonique](https://www.nvaccess.org/product/nvda-telephone-support/), soit en blocs, soit dans le cadre du [Pack de Productivité NVDA](https://www.nvaccess.org/product/nvda-productivity-bundle/). +L'assistance téléphonique est disponible pour les numéros situés en Australie et aux États-Unis. + +Les [groupes d'utilisateurs par e-mail](https://github.com/nvaccess/nvda/wiki/Connect) sont une excellente source d'aide communautaire, tout comme les [experts NVDA certifiés](https://certification.nvaccess.org/). + +Vous pouvez créer des rapports de bogues ou des demandes de fonctionnalités via [GitHub](https://github.com/nvaccess/nvda/blob/master/projectDocs/issues/readme.md). +Les [contribution guidelines](https://github.com/nvaccess/nvda/blob/master/.github/CONTRIBUTING.md) (en anglais) contiennent des informations précieuses pour contribuer à la communauté. + +## Plus d'Options de Configuration {#MoreSetupOptions} +### Options d'Installation {#InstallingNVDA} + +Si vous installez NVDA directement depuis le lanceur NVDA téléchargé, appuyez sur le bouton Installer NVDA. +Si vous avez déjà fermé ce dialogue ou souhaitez installer à partir d'une copie portable, veuillez choisir l'élément de menu Installer NVDA qui se trouve sous Outils dans le menu NVDA. + +Le dialogue d'installation qui apparaît demandera de confirmer si vous souhaitez installer NVDA et vous indiquera également si cette installation mettra à jour une installation précédente. +Appuyez sur le bouton Continuer pour lancer l'installation de NVDA. +Il y a aussi quelques options dans ce dialogue qui sont expliquées ci-dessous. +Une fois l'installation terminée, un message apparaîtra vous indiquant qu'elle a réussi. +Appuyer sur OK à ce stade redémarrera la copie nouvellement installée de NVDA. + +#### Avertissement d'extensions incompatibles {#InstallWithIncompatibleAddons} + +Si vous avez déjà installé des extensions, il peut également y avoir un avertissement indiquant que les extensions incompatibles seront désactivées. +Avant de pouvoir presser le bouton Continuer, vous devrez utiliser la case à cocher pour confirmer que vous comprenez que ces extensions seront désactivées. +Il y aura également un bouton pour lister les extensions qui seront désactivées. +Veuillez consulter la section [dialogue des extensions incompatibles](#incompatibleAddonsManager) pour plus d'aide concernant ce bouton. +Après l'installation, vous pouvez réactiver les extensions incompatibles à vos risques et périls à partir de l'[Add-on Store](#AddonsManager). + +#### Utiliser NVDA lors de la connexion {#StartAtWindowsLogon} + +Cette option vous permet de choisir si NVDA doit ou non démarrer automatiquement lorsque vous êtes sur l'écran de connexion Windows, avant que vous ayez entré un mot de passe. +Cela inclut également le contrôle de compte d'utilisateur et [autres écrans sécurisés](#SecureScreens). +Cette option est activée par défaut pour les nouvelles installations. + +#### Créer un raccourci sur le bureau (ctrl+alt+n) {#CreateDesktopShortcut} + +Cette option vous permet de choisir si NVDA doit ou non créer un raccourci sur le bureau pour démarrer NVDA. +S'il est créé, ce raccourci se verra également attribuer une touche de raccourci `contrôle+alt+n`, vous permettant de démarrer NVDA à tout moment avec cette touche. + +#### Copier la configuration portable sur le compte d'utilisateur actuel {#CopyPortableConfigurationToCurrentUserAccount} + +Cette option vous permet de choisir si NVDA doit ou non copier la configuration utilisateur de NVDA en cours d'exécution dans la configuration de l'utilisateur actuellement connecté, pour la copie installée de NVDA. +Cela ne copiera pas la configuration pour les autres utilisateurs de ce système ni dans la configuration du système à utiliser lors de la connexion à Windows et [autres écrans sécurisés](#SecureScreens). +Cette option n'est disponible que lors de l'installation à partir d'une copie portable, et non lors de l'installation directement à partir du Lanceur téléchargé. + +### Création d'une copie portable {#CreatingAPortableCopy} + +Si vous créez une copie portable directement à partir du package de téléchargement NVDA, appuyez sur le bouton Créer une copie portable. +Si vous avez déjà fermé ce dialogue ou si vous exécutez une copie installée de NVDA, choisissez l'élément de menu Créer une copie portable qui se trouve sous Outils dans le menu NVDA. + +Le dialogue qui apparaît vous permet de choisir où la copie portable doit être créée. +Il peut s'agir d'un répertoire sur votre disque dur ou d'un emplacement sur une clé USB ou un autre support portable. +Par défaut, un nouveau répertoire est créé pour la copie portable. +Vous pouvez également choisir d'utiliser un répertoire existant, cela écrasera les fichiers de ce répertoire. +Si le répertoire existant est une copie portable de NVDA, cette copie sera mise à jour. + +Il existe également une option pour choisir si NVDA doit copier la configuration NVDA actuelle de l'utilisateur connecté pour l'utiliser avec la copie portable nouvellement créée. +Cela inclut également les extensions. +Cette option n'est disponible que lors de la création d'une copie portable à partir d'une copie installée, pas lors de la création à partir du package de téléchargement. + +Appuyer sur Continuer créera la copie portable. +Une fois la création terminée, un message apparaîtra vous indiquant qu'elle a réussi. +Appuyez sur OK pour fermer ce dialogue. + +### Restrictions des Versions Portables et Temporaires {#PortableAndTemporaryCopyRestrictions} + +Si vous souhaitez emporter NVDA avec vous sur une clé USB ou un autre support inscriptible, vous devez choisir de créer une copie portable. +La copie installée est également capable de créer une copie portable d'elle-même à tout moment. +La copie portable a également la capacité de s'installer sur n'importe quel ordinateur ultérieurement. +Cependant, si vous souhaitez copier NVDA sur un support en lecture seule tel qu'un CD, vous devez simplement copier le package de téléchargement. +L'exécution de la version portable directement à partir d'un support en lecture seule n'est pas prise en charge pour le moment. + +Le [programme d'installation de NVDA](#StepsForRunningTheDownloadLauncher) peut être utilisé comme une copie temporaire de NVDA. +Les copies temporaires empêchent l'enregistrement des paramètres de NVDA. +Cela inclut la désactivation de l'utilisation de l'[Add-on Store](#AddonsManager). + +Les copies portables et temporaires de NVDA ont les restrictions suivantes : + +* L'impossibilité de démarrer automatiquement pendant et/ou après la connexion. +* L'impossibilité d'interagir avec les applications démarrées avec les privilèges administrateur, sauf bien sûr si NVDA a été démarré avec ces privilèges (non recommandé) ; +* L'impossibilité de lire les écrans de contrôle de compte utilisateur (UAC) lorsque l'on tente de démarrer une application avec les privilèges administrateur ; +* L'impossibilité d'utiliser un écran tactile comme support d'entrée ; +* L'impossibilité de prendre en charge des fonctionnalités comme le mode navigation ou l'annonce des caractères saisis dans les applications du Windows Store. +* L'atténuation audio n'est pas supportée. + +## Prendre en Main NVDA {#GettingStartedWithNVDA} +### Démarrer NVDA {#LaunchingNVDA} + +Si NVDA a été installé à l'aide de l'installateur, alors il suffit, soit de frapper la combinaison contrôle+alt+n, soit de choisir dans le menu Démarrer / Programmes / NVDA / NVDA. +De plus, Vous pouvez taper NVDA dans le dialogue "Exécuter" puis appuyer sur "Entrée". +Si NVDA est déjà en cours d'exécution, il sera redémarré. +Vous pouvez aussi ajouter quelques [options de ligne de commande](#CommandLineOptions) vous permettant de quitter (-q), désactiver les extensions (--disable-addons), etc. + +Pour les copies installées, NVDA enregistre la configuration dans le dossier de données applicatives roaming de l'utilisateur courant par défaut (ex : "`C:\Users\\AppData\Roaming`"). +Il est possible de modifier cela de manière à ce que NVDA charge sa configuration depuis le dossier de données applicatives local. +Consultez la section concernant les [paramètres système](#SystemWideParameters) pour plus de détails. + +Pour démarrer la copie portable, rendez-vous dans le dossier où NVDA a été décompressé, et appuyez sur "Entrée" ou double-cliquez sur nvda.exe. +Si NVDA est déjà en cours d'exécution, il s'arrêtera pour démarrer la version portable. + +Au démarrage de NVDA, on entend d'abord une série de sons ascendants (indiquant que NVDA se charge). +Suivant la rapidité de votre ordinateur, ou si vous exécutez NVDA à partir d'une clé USB ou d'un autre périphérique lent, le démarrage peut demander un certain temps. +Si le démarrage est vraiment lent, vous entendrez le message "Chargement de NVDA, veuillez patienter...". + +Si vous n'entendez rien de tout cela, ou si vous entendez le signal sonore d'erreur de Windows, ou une série de sons descendants, cela indique un problème de NVDA et vous pourrez, si vous le voulez, envoyer un rapport d'erreur aux développeurs. +Reportez-vous au site Web de NVDA pour les détails de la procédure. + +#### Dialogue de Bienvenue {#WelcomeDialog} + +Quand NVDA démarre pour la première fois, vous êtes accueilli par un dialogue vous donnant des informations de base sur la touche NVDA et le menu NVDA. +Veuillez consulter les sections ci-après pour plus d'informations sur ces sujets. +Le dialogue contient également une liste déroulante et trois cases à cocher. +La liste déroulante vous permet de sélectionner la configuration clavier. +La première case à cocher vous permet de choisir si vous voulez utiliser la touche de verrouillage majuscules comme touche NVDA. +La deuxième spécifie si NVDA doit démarrer à l'ouverture de votre session et est disponible uniquement sur la version installée. +La troisième permet d'indiquer si ce dialogue d'accueil doit apparaître à chaque démarrage. + +#### Dialogue de statistiques d'utilisation des données {#UsageStatsDialog} + +Au premier démarrage de NVDA, un dialogue vous demandant si vous désirer envoyer des données à NV Access durant l'utilisation de NVDA apparaîtra, afin d'aider à l'amélioration de NVDA à l'avenir. +Vous pouvez obtenir plus d'informations concernant les données recueillies par NV Access dans la section paramètres généraux, [Autoriser NV Access à recueillir des statistiques d'utilisation](#GeneralSettingsGatherUsageStats). +Note : l'appui sur "oui" ou "non" sauvegardera ce choix et ce dialogue n'apparaîtra plus à moins que vous réinstalliez NVDA. +Cependant, vous pouvez activer ou désactiver le processus de collecte de données manuellement dans l'écran de paramètres généraux de NVDA. Pour modifier ce paramètre manuellement, vous pouvez cocher ou décocher la case appelée [Autoriser le projet NVDA à recueillir des statistiques d'utilisation](#GeneralSettingsGatherUsageStats). + +### À Propos des Commandes Clavier de NVDA {#AboutNVDAKeyboardCommands} +#### La Touche NVDA {#TheNVDAModifierKey} + +La plupart des commandes spécifiques de NVDA se font en appuyant sur la touche NVDA en conjonction avec une ou plusieurs autres touches. +Les fonctions de revue de texte qui n'utilisent que le pavé numérique constituent une des quelques exceptions. + +NVDA peut être configuré pour que les touches `insert`, `pavnumInsert` ou `verrouillageMajuscule` puissent être utilisées comme touche `NVDA`. +Par défaut, les touches `insert` et `pavnumInsert` sont définies comme touche NVDA. + +Si vous souhaitez que l'une des touches NVDA se comporte comme d'habitude, comme si NVDA n'était pas en cours d'exécution (par exemple si vous voulez utiliser verrouillage majuscules pour verrouiller les majuscules après l'avoir définie comme touche NVDA) vous devrez appuyer deux fois rapidement sur cette touche. + +#### Les Configurations Clavier {#KeyboardLayouts} + +NVDA comporte actuellement deux configurations clavier : une pour les ordinateurs de bureau (Desktop) et une pour les ordinateurs portables (Laptop). +Par défaut, NVDA est configuré pour un ordinateur de bureau. Pour passer en configuration ordinateur portable, allez dans la catégorie Clavier du dialogue [Paramètres](#NVDASettings) qui se trouve dans le menu Préférences de NVDA. + +La configuration pour ordinateur de bureau fait un usage intensif du pavé numérique (avec le verrouillage numérique désactivé). +Bien que la plupart des ordinateurs portables ne comportent pas de pavé numérique, certains peuvent l'émuler en maintenant enfoncée la touche "FN" puis en appuyant sur les lettres et les chiffres à la droite du clavier ( 7 8 9 u i o j k l etc.). +Si votre ordinateur portable ne peut pas le faire ou ne vous permet pas de désactiver le verrouillage numérique, vous pourrez alors basculer vers la disposition Ordinateur Portable. + +### Gestes Tactiles de NVDA {#NVDATouchGestures} + +Si vous utilisez NVDA sur un système possédant un écran tactile, vous pouvez aussi contrôler NVDA directement via l'écran tactile. +Tant que NVDA est actif, à moins que le support de l'interaction tactile soit désactivée, toutes les manipulations sur l'écran tactile vont directement à NVDA. +Ainsi, toutes les actions qui peuvent être faites normalement sans NVDA ne fonctionneront pas. + +Pour activer/désactiver le support d'interaction tactile, pressez NVDA+contrôle+alt+t. + +Vous pouvez aussi activer ou désactiver le [support d'interaction tactile](#TouchSupportEnable) depuis la catégorie Interaction Tactile des paramètres de NVDA. + +#### Explorer l'Écran {#ExploringTheScreen} + +L'action la plus basique que vous pouvez effectuer avec l'écran tactile est d'obtenir l'annonce du texte ou de l'élément à n'importe quel point de l'écran. +Pour ce faire, placez un doigt n'importe où sur l'écran. +Vous pouvez également garder votre doigt sur l'écran et le déplacer pour lire les autres éléments et textes sur lesquels votre doigt se place. + +#### Gestes Tactiles {#TouchGestures} + +Lorsque les commandes NVDA sont décrites dans ce guide utilisateur, elles peuvent comporter un geste tactile qui peut être utilisé pour activer cette commande avec l'écran tactile. +Voici quelques instructions sur la manière d'effectuer les différents gestes tactiles. + +##### Tapes {#Taps} + +Tapoter rapidement sur l'écran avec un ou plusieurs doigts. + +Tapoter une fois avec un seul doigt s'appelle une simple tape. +Tapoter une fois avec deux doigts s'appelle une tape à deux doigts et ainsi de suite. + +Si la même tape est faite une fois ou plus dans une succession rapide, NVDA la prendra comme un geste tactile multi-tape. +Tapoter deux fois sera une double-tape. +Tapoter trois fois sera une triple-tape et ainsi de suite. +Bien sûr, ces gestes à tapes multiples reconnaissent combien de doigts sont utilisés, il est donc possible d'avoir des gestes tel qu'une triple-tape à deux doigts, ou une tape à quatre doigts, etc. + +##### Glisser {#Flicks} + +Glissez rapidement votre doigt sur l'écran. + +On peut glisser dans les quatre directions : glissé gauche, glissé droite, glissé bas, glissé haut. + +Exactement comme pour les tapes, il est possible d'utiliser plusieurs doigts. +Il est donc possible d'avoir un glissé à deux doigts vers le haut ou trois vers la droite. + +#### Modes Tactiles {#TouchModes} + +Comme il y a plus de commandes NVDA que de gestes tactiles possibles, NVDA a plusieurs modes tactiles entre lesquels on peut basculer, qui rendent un certain nombre de commandes disponibles. +Les deux modes sont le mode texte et le mode objet. +Certaines commandes listées dans ce manuel peuvent avoir un mode indiqué entre parenthèses après le geste. +Par exemple, glissé haut (mode texte) signifie que cette commande sera exécutée si vous glissez vers le haut, mais seulement en mode texte. +Si la commande n'a aucun mode associé, le geste fonctionnera dans tous les modes. + + +Pour basculer entre les modes, faites une tape avec trois doigts. + + +#### Clavier Tactile {#TouchKeyboard} + +Le clavier tactile sert à entrer du texte et des commandes à partir d'un écran tactile. +Quand le focus est sur un champ de saisie, vous pouvez faire apparaître le clavier tactile d'une double-tape sur l'icône du clavier tactile au bas de l'écran. +Sur les tablettes comme la Microsoft Surface Pro, le clavier tactile est toujours disponible quand le clavier est déconnecté +Pour masquer le clavier tactile, faites une double-tape sur son icône ou quittez la zone de saisie. + +Quand le clavier tactile est activé, pour repérer une touche, placez vos doigts à l'endroit où se situe le clavier tactile (généralement au bas de l'écran), puis déplacez-vous sur le clavier avec un doigt. +Quand vous avez trouvé la touche que vous voulez presser, double-tapez la touche ou retirez votre doigt, selon les options définies dans la catégorie [Paramètres d'Interaction Tactile](#TouchInteraction)des Paramètres NVDA. + +### Aide des Commandes {#InputHelpMode} + +Des commandes clavier et tactiles sont mentionnées tout au long de ce guide utilisateur, mais une manière simple d'explorer les différentes touches de commandes est d'activer l'aide clavier. + +Pour activer l'aide clavier, appuyez sur NVDA+1. +Pour la désactiver, appuyez à nouveau sur NVDA+1. +Quand l'aide clavier est activée, l'appui sur une touche braille ou clavier, ou faire un geste à l'écran tactile annonce sa fonction (si elle en a une). +La fonction n'est pas réellement exécutée, vous pouvez donc appuyer sur n'importe quelle touche sans crainte. + +### Le Menu NVDA {#TheNVDAMenu} + +Le menu NVDA vous permet de gérer les paramètres de NVDA, d'obtenir de l'aide, sauvegarder ou recharger la configuration, modifier le dictionnaire de prononciation, accéder à des outils additionnels ou quitter NVDA. + +Pour accéder au menu NVDA depuis n'importe où dans Windows pendant que NVDA est en cours d'exécution, vous pouvez effectuer l'une des actions suivantes : + +* appuyez sur `NVDA+n` sur le clavier. +* Effectuez une double-tape à 2 doigts sur l'écran tactile. +* Accédez à la barre d'état système en appuyant sur `Windows+b`, `flècheBas` jusqu'à l'icône NVDA, et appuyez sur `entrée`. +* Alternativement, accédez à la barre d'état système en appuyant sur `Windows+b`, `flècheBas` jusqu'à l'icône NVDA, et ouvrez le menu contextuel en appuyant sur la touche `applications` située à côté de la touche de contrôle droite sur la plupart des claviers. +Sur un clavier sans touche `applications`, appuyez sur `maj+f10` à la place. +* Faites un clic droit sur l'icône NVDA située dans la barre d'état système de Windows + +Lorsque le menu apparaît, vous pouvez utiliser les touches fléchées pour naviguer dans le menu et la touche `entrée` pour activer un élément. + +### Commandes de Base {#BasicNVDACommands} + + + +| Nom |Ordinateur de bureau |Ordinateur portable |Tactile |Description| +|---|---|---|---|---| +|Démarrer ou redémarrer NVDA |Contrôle+alt+n |Contrôle+alt+n |aucun |Démarre ou redémarre NVDA depuis le bureau, si ce raccourci Windows est activé durant le processus d'installation de NVDA. Ceci est un raccourci spécifique à Windows et de ce fait il ne peut être réassigné dans le dialogue gestes de commandes.| +|Arrêt parole |Contrôle |Contrôle |tape 2 doigts |Arrêt instantané de la parole| +|Pause parole |Maj |Maj |Aucun |Pause instantanée de la parole, un second appui reprend la parole là où elle s'était arrêtée| +|Menu NVDA |NVDA+n |NVDA+n |Double-tape 2 doigts |Affiche le menu NVDA pour vous permettre d'accéder aux préférences, outils, aide etc.| +|Passage en mode aide à la saisie |NVDA+1 |NVDA+1 |Aucun |Dans ce mode, l'appui sur n'importe quelle touche donnera son nom et la description de la commande NVDA qui lui est éventuellement associée| +|Quitter NVDA |NVDA+q |NVDA+q |Aucun |Quitter NVDA| +|Ignorer la touche suivante |NVDA+f2 |NVDA+f2 |Aucun |Indique à NVDA de passer la touche suivante directement à l'application - même si cette touche correspond normalement à une commande NVDA| +|Bascule du mode veille |NVDA+maj+s |NVDA+maj+z |Aucun |Le mode veille désactive toutes les commandes NVDA ainsi que la parole et le braille pour l'application en cours. Ceci est utile dans les applications fournissant leur propre système de revue d'écran. Appuyez à nouveau la combinaison pour désactiver le mode veille.| + + + +### Annonce des Informations système {#ReportingSystemInformation} + + + +| Nom |Touche |Description| +|---|---|---| +|Annoncer date/heure |NVDA+f12 |Un appui annonce l'heure, deux appuis annoncent la date| +|Annoncer l'état de la batterie |NVDA+maj+b |Annonce le pourcentage de charge de la batterie ou si l'adaptateur secteur est connectée| +|Annoncer le contenu du presse-papiers |NVDA+c |Lit le contenu du presse-papier s'il y a lieu| + + + +### Mode de parole {#SpeechModes} + +Le mode de parole détermine la façon dont le contenu de l'écran, les notifications, les réponses aux commandes et autres sorties sont prononcés pendant le fonctionnement de NVDA. +Le mode par défaut est "activée", où la parole est utilisée dans les situations attendues lors de l'utilisation d'un lecteur d'écran. +Cependant, dans certaines circonstances, ou lors de l'exécution de programmes particuliers, l'un des autres modes de parole peut s'avérer utile. + +Les quatre modes de parole disponibles sont : + +* Activée (par défaut) : NVDA parlera normalement en réaction aux changements d'écran, aux notifications et aux actions telles que déplacer le focus ou émettre des commandes. +* À la demande : NVDA ne parlera que lorsque vous utilisez des commandes avec une fonction d'annonce (par exemple annoncer le titre de la fenêtre) ; mais il ne parlera pas en réaction à des actions telles que le déplacement du focus ou du curseur. +* Désactivée : NVDA ne dira rien, mais contrairement au mode veille, il réagira silencieusement aux commandes. +* remplacée par des bips : NVDA remplacera la parole normale par des bips courts. + +Le mode bips peut être utile lorsqu'une sortie très importante défile dans une fenêtre de terminal, mais vous ne vous souciez pas de ce que c'est, seulement du fait qu'elle continue à défiler ; ou dans d’autres circonstances où le fait qu’il y ait une sortie est plus pertinent que la production elle-même. + +Le mode À la demande peut s'avérer utile lorsque vous n'avez pas besoin d'un retour constant sur ce qui se passe à l'écran ou sur l'ordinateur, mais que vous devez périodiquement vérifier des éléments particuliers à l'aide de commandes de revue, etc. +Les exemples incluent lors d'un enregistrement audio, lors de l'utilisation d'un agrandissement de l'écran, lors d'une réunion ou d'un appel, ou comme alternative au mode bips. + +Un geste permet de parcourir les différents modes de parole : + + +| Nom |Touche |Description| +|---|---|---| +|Faire défiler les modes de parole |`NVDA+s` |Passer d’un mode vocal à l’autre| + + + +Si vous avez seulement besoin de basculer entre un sous-ensemble limité de modes de parole, voir [Modes disponibles dans la commande Faire défiler les modes de parole](#SpeechModesDisabling) pour savoir comment désactiver les modes non souhaités. + +## Naviguer avec NVDA {#NavigatingWithNVDA} + +NVDA vous permet de naviguer dans le système ou de l'explorer de différentes manières, soit en interaction normale, soit en revue. + +### Objets {#Objects} + +Chaque application et le système d'exploitation lui-même se composent d'un grand nombre d'objets. +Un objet est un élément simple tel qu'un morceau de texte, un bouton, une case à cocher, un potentiomètre, une liste ou une zone d'édition. + +### Naviguer avec le Focus Système {#SystemFocus} + +Le focus système, ou plus simplement focus, est [l'objet](#Objects) qui reçoit les touches tapées au clavier. +Par exemple, si vous tapez du texte dans une zone d'édition, cette zone d'édition a le focus. + +La manière la plus commune de naviguer dans Windows avec NVDA, est de simplement se déplacer avec des commandes clavier normales, comme "Tabulation" et "Majuscule+Tabulation" pour se déplacer entre les contrôles, "Alt" pour aller au menu puis "Flèches" pour naviguer dans les menus, utiliser "Alt+Tabulation" pour passer d'une application à l'autre. Cela déplace le focus système, c'est-à-dire l'objet qui reçoit les touches que vous tapez au clavier. +Quand vous faites cela, NVDA donne des informations sur l'objet ayant le focus, telles que son nom, son type, son état, sa valeur, sa description, son raccourci clavier et sa position. +Quand la [Mise en Évidence Visuelle](#VisionFocusHighlight) est activée, la position du focus système courant est également présentée visuellement. + +Quelques touches de commandes utiles pour naviguer avec le focus : + + +| Nom |Ordinateur de bureau |Ordinateur portable |Description| +|---|---|---|---| +|Annonce du focus courant |NVDA+tab |NVDA+tab |Annonce l'objet en cours ou le contrôle qui a le focus système. Un double appui épelle l'information| +|Annonce du titre |NVDA+t |NVDA+t |Annonce le titre de la fenêtre active. Un double appui épelle l'information, un triple appui la copie dans le presse-papiers| +|Lecture de la fenêtre active |NVDA+b |NVDA+b |lit tous les contrôles de la fenêtre active (utile pour les dialogues)| +|Annonce de la barre d'état |NVDA+fin |NVDA+maj+fin |Lit la barre d'état si NVDA en trouve une. Un double appui épelle l'information. Un triple appui la copie dans le presse-papiers| +|Annoncer le Raccourci Clavier |`maj+pavnum2` |`NVDA+contrôle+maj+point-virgule` |Annonce le raccourci clavier (accélérateur) de l'objet actuellement en focus| + + + +### Naviguer avec le Curseur Système {#SystemCaret} + +Quand un [objet](#Objects) qui autorise la navigation ou l'édition de texte a le [focus](#SystemFocus), vous pouvez vous déplacer dans le texte en utilisant le curseur système ou curseur d'édition. + +Quand le focus est sur un objet ayant un curseur d'édition, vous pouvez utiliser les flèches, les touches début, fin, page précédente, page suivante pour vous déplacer dans le texte. +Vous pouvez également modifier le texte si le champ le permet. +NVDA annonce le déplacement par caractère, mot ou ligne, et annonce aussi la sélection et la désélection de texte. + +NVDA fournit les commandes clavier suivantes relatives au curseur système : + + +| Nom |Ordinateur de bureau |Ordinateur portable |Description| +|---|---|---|---| +|Dire tout |NVDA+flèche bas |NVDA+a |Démarre la lecture depuis la position du curseur système en lui faisant suivre la lecture| +|Lire ligne courante |NVDA+flèche haut |NVDA+l |Lit la ligne où se trouve le curseur système. Un double appui épelle la ligne. Un triple appui l'épelle en code international.| +|Lire texte sélectionné |NVDA+Maj+flèche haut |NVDA+Maj+s |Lit tout le texte actuellement sélectionné| +|Annoncer la mise en forme du texte |NVDA+f |NVDA+f |annonce la mise en forme du texte à la position actuelle du curseur. Un double appui présente l'information en mode navigation| +|Annoncer la destination du lien |`NVDA+k` |`NVDA+k` |Un appui annonce l'URL de destination du lien à la position courante du curseur ou du focus. Deux appuis l'affichent dans une fenêtre pour une revue plus attentive| +|Annoncer la position du curseur |NVDA+pavnumEffacement |NVDA+effacement |Annonce des informations sur l'emplacement du texte ou de l'objet à la position du curseur système. Par exemple, cela peut inclure le pourcentage dans le document, la distance depuis le bord de la page ou la position exacte sur l'écran. Appuyer deux fois peut fournir plus de détails.| +|Phrase suivante |alt+flècheBas |alt+flècheBas |Amène le curseur à la phrase suivante et la lit. (Supporté seulement sous Microsoft Word et Outlook)| +|Phrase précédente |alt+flècheHaut |alt+flècheHaut |Amène le curseur à la phrase précédente et la lit. (Supporté seulement sous Microsoft Word et Outlook)| + +Dans un tableau, vous disposez également des touches de commandes suivantes : + +| Nom |Touche |Description| +|---|---|---| +|Aller à la colonne précédente |contrôle+alt+flèche gauche |Déplace le curseur système à la colonne précédente en restant sur la même ligne| +|Aller à la colonne suivante |contrôle+alt+flèche droite |Déplace le curseur système à la colonne suivante en restant sur la même ligne| +|Aller à la ligne précédente |contrôle+alt+flèche haut |Déplace le curseur système à la ligne précédente en restant sur la même colonne| +|Aller à la ligne suivante |contrôle+alt+flèche bas |Déplace le curseur système à la ligne suivante en restant sur la même colonne| +|Aller à la première colonne |contrôle+alt+début |Déplace le curseur système à la première colonne (en restant sur la même ligne)| +|Aller à la dernière colonne |contrôle+alt+fin |Déplace le curseur système à la dernière colonne (en restant sur la même ligne)| +|Aller à la première ligne |contrôle+alt+PagePrec |Déplace le curseur système à la première ligne (en restant sur la même colonne)| +|Aller à la dernière ligne |contrôle+alt+pageSuiv |Déplace le curseur système à la dernière ligne (en restant sur la même colonne)| +|Dire tout dans la colonne |`NVDA+contrôle+alt+flècheBas` |Lit la colonne verticalement depuis la cellule courante jusqu'à la dernière cellule de la colonne.| +|Dire tout dans la ligne |`NVDA+contrôle+alt+flècheDroit` |Lit la ligne horizontalement depuis la cellule courante jusqu'à la dernière cellule de la ligne.| +|Lire toute la colonne |`NVDA+contrôle+alt+flècheHaut` |Lit la colonne courante verticalement du début à la fin sans déplacer le curseur système.| +|Lire toute la ligne |`NVDA+contrôle+alt+flècheGauche` |Lit la ligne courante horizontalement de gauche à droite sans déplacer le curseur système.| + + + +### Naviguer par Objet {#ObjectNavigation} + +La plupart du temps, vous travaillerez avec les applications en utilisant des commandes qui déplacent le [focus](#SystemFocus) et le [curseur](#SystemCaret). +Cependant, vous pouvez parfois avoir besoin d'explorer l'application en cours ou le système sans déplacer le focus ou le curseur. +Vous pouvez aussi avoir besoin d'accéder à des [objets](#Objects) inaccessibles par les commandes clavier habituelles. +Dans ces cas, vous pouvez utiliser la navigation par objet. + +La navigation par objet vous permet de vous déplacer parmi les différents [objets](#Objects) et d'obtenir des informations à leur sujet. +Quand vous atteignez un objet, NVDA l'annoncera de la même manière qu'il annonce le focus système. +Si vous désirez explorer tout le texte tel qu'il se présente à l'écran, vous pouvez également utiliser la [revue d'écran](#ScreenReview). + +Pour ne pas avoir à errer entre tous les objets présents dans le système, ceux-ci sont groupés hiérarchiquement. +Cela signifie que vous devez entrer dans certains objets pour voir les objets qu'ils contiennent. +Par exemple, une liste contient des éléments de liste, vous devez donc entrer dans la liste pour voir ces éléments. +Si vous êtes sur un élément de liste, aller à l'élément suivant ou précédent vous amènera à un autre élément de la même liste. +Si vous allez sur l'objet contenant les éléments de la liste, vous serez ramené à la liste. +Vous pourrez alors la quitter si vous désirez accéder à d'autres objets. +De la même manière, une barre d'outils contient des contrôles, vous devrez donc entrer dans la barre d'outils pour accéder aux contrôles qu'elle contient. + +Si vous préférez plutôt vous déplacer entre chaque objet simple du système, vous pouvez utiliser des commandes pour passer à l'objet précédent/suivant dans une vue à plat. +Par exemple, si vous vous déplacez vers l'objet suivant dans cette vue à plat et que l'objet actuel contient d'autres objets, NVDA se déplacera automatiquement vers le premier objet contenu. +Au contraire, si l'objet courant ne contient aucun objet, NVDA passera à l'objet suivant au niveau courant de la hiérarchie. +S'il n'y a pas d'objet suivant de ce type, NVDA essaiera de trouver l'objet suivant dans la hiérarchie en fonction des objets contenants jusqu'à ce qu'il n'y ait plus d'objets vers lesquels se déplacer. +Les mêmes règles s'appliquent pour reculer dans la hiérarchie. + +L'objet en cours de revue s'appelle l'objet navigateur. +Quand vous atteignez un objet, vous pouvez examiner son contenu en utilisant les [commandes de revue de texte](#ReviewingText) en étant en [mode Revue d'objet](#ObjectReview). +Quand la [Mise en Évidence Visuelle](#VisionFocusHighlight) est activée, la position de l'objet navigateur courant est également présentée visuellement. +Par défaut, l'objet navigateur suit le focus système, mais ce comportement peut être désactivé. + +Note : Le suivi de la Navigation par Objet par le Braille peut être configuré via [Braille Suit](#BrailleTether). + +Pour naviguer par objet, utilisez les commandes suivantes : + + + +| Nom |Ordinateur de bureau |Ordinateur portable |Tactile |Description| +|---|---|---|---|---| +|Annonce de l'objet courant |NVDA+pavnum5 |NVDA+Maj+o |Aucun |Annonce l'objet navigateur courant, deux appuis épellent l'information, trois appuis copient le nom et le contenu de l'objet dans le presse-papiers| +|Aller à l'objet parent |NVDA+pavnum8 |NVDA+maj+flèche haut |Glisser vers le haut (mode objet) |Va à l'objet parent (qui contient l'objet navigateur courant)| +|Aller à l'objet précédent |NVDA+pavnum4 |NVDA+maj+flèchegauche |aucun |Se déplace vers l'objet avant l'objet navigateur courant| +|Aller à l'objet précédent en vue à plat |NVDA+pavnum9 |NVDA+maj+ù |glisser vers la gauche (mode objet) |Passe à l'objet précédent dans une vue à plat de la hiérarchie de navigation d'objets| +|Passer à l'objet suivant |NVDA+pavnum6 |NVDA+maj+flècheDroite |aucun |Se déplace vers l'objet après l'objet navigateur courant| +|Passer à l'objet suivant dans la vue à plat |NVDA+pavnum3 |NVDA+maj+* |glisser vers la droite (mode objet) |Passe à l'objet suivant dans une vue à plat de la hiérarchie de navigation d'objets| +|Aller au premier objet inclus |NVDA+pavnum2 |NVDA+maj+flèche bas |Glisser vers le bas (mode objet) |Va au premier objet inclus dans l'objet navigateur courant| +|Aller à l'objet en focus |NVDA+pavnumMoins |NVDA+retour arrière |Aucun |Va à l'objet ayant le focus système, et place le curseur de revue sur le curseur système s'il est présent| +|Activer l'objet navigateur courant |NVDA+pavnumEntrer |NVDA+entrée |Double tape |Active l'objet navigateur courant (similaire à un clic de souris ou à appuyer la barre d'espace quand l'objet a le focus système)| +|Amener le focus système à l'objet navigateur courant |NVDA+maj+pavnumMoins |NVDA+maj+retour arrière |Aucun |Amène le focus système à l'objet navigateur courant si c'est possible| +|Annoncer la position du curseur de revue |NVDA+pavnumEffacement |NVDA+effacement |Aucun |Annonce la position du texte ou de l'objet sous le curseur de revue. Cela peut inclure, par exemple, le pourcentage dans le document, la distance au bord de la page ou la position exacte sur l'écran. Un double appui annonce éventuellement des informations supplémentaires.| +|Amener le curseur de revue à la barre d'état |aucun |aucun |aucun |Annonce la barre d'état si NVDA en trouve une. Amène également l'objet navigateur à sa position.| + + + +Note : Les touches du pavé numérique nécessitent de désactiver le verrouillage numérique pour fonctionner correctement. + +### Revue de Texte {#ReviewingText} + +NVDA vous permet de lire le contenu de [l'écran](#ScreenReview), du [document](#DocumentReview) ou de [l'objet](#ObjectReview) par caractère, mot ou ligne. +Ceci est particulièrement utile dans la console de commandes Windows et d'autres applications où le [curseur système](#SystemCaret) est inexistant. +Par exemple, cela peut servir à consulter le texte d'un long message dans un dialogue. + +Quand vous déplacez le curseur de revue, le curseur système ne bouge pas, ainsi vous pouvez explorer un texte sans perdre votre position d'édition actuelle. +Cependant, par défaut, quand le curseur système bouge, le curseur de revue le suit. +Ceci peut être désactivé. + +Note : Le suivi de la Navigation par Objet par le Braille peut être configuré via [Braille Suit](#BrailleTether). + +Vous disposez des commandes suivantes pour explorer du texte : + + +| Nom |Ordinateur de bureau |Ordinateur portable |Tactile |Description| +|---|---|---|---|---| +|Aller à la première ligne en revue |Maj+pavnum7 |NVDA+contrôle+début |Aucun |Amène le curseur de revue à la première ligne du texte| +|Aller à la ligne précédente en revue |pavnum7 |NVDA+flèche haut |Glisser vers le haut (mode texte) |Amène le curseur de revue sur la ligne de texte précédente| +|Annoncer la ligne courante en revue |pavnum8 |NVDA+maj+point-virgule |Aucun |Lit la ligne de texte sous le curseur de revue, un double appui épelle la ligne| +|Aller à la ligne suivante en revue |pavnum9 |NVDA+flèche bas |Glisser vers le bas (mode texte) |Amène le curseur de revue à la ligne de texte suivante| +|Aller à la dernière ligne en revue |maj+pavnum9 |NVDA+contrôle+fin |Aucun |Amène le curseur de revue à la dernière ligne de texte| +|Aller au mot précédent en revue |pavnum4 |NVDA+contrôle+flèche gauche |Glisser vers la gauche 2 doigts (mode texte) |Amène le curseur de revue au mot précédent dans le texte| +|Annoncer le mot courant en revue |pavnum5 |NVDA+contrôle+point-virgule |Aucun |Lit le mot à la position du curseur de revue, un double appui épelle le mot| +|Aller au mot suivant en revue |pavnum6 |NVDA+contrôle+flèche droite |Glisser vers la droite 2 doigts (mode texte) |Amène le curseur de revue au mot suivant| +|Aller au début de la ligne en revue |maj+pavnum1 |NVDA+début |Aucun |Amène le curseur de revue au début de la ligne courante| +|Aller au caractère précédent en revue |pavnum1 |NVDA+flèche gauche |Glisser vers la gauche (mode texte) |Amène le curseur de revue au caractère précédent de la ligne courante| +|Annoncer le caractère courant en revue |pavnum2 |NVDA+point-virgule |Aucun |Annonce le caractère courant sous le curseur de revue, un double appui annonce la valeur du caractère en décimal et hexadécimal| +|Aller au caractère suivant en revue |pavnum3 |NVDA+flèche droite |Glisser vers la droite (mode texte) |Amène le curseur de revue au caractère suivant de la ligne courante| +|Aller en fin de ligne en revue |maj+pavnum3 |NVDA+fin |Aucun |Amène le curseur de revue à la fin de la ligne courante| +|Aller à la page précédente en revue |`NVDA+pagePrec` |`NVDA+maj+pagePrec` |aucune |Amène le curseur de revue à la page précédente de texte si supporté par l'application| +|Aller à la page suivante en revue |`NVDA+pageSuiv` |`NVDA+maj+pageSuiv` |aucune |Amène le curseur de revue à la page suivante de texte si supporté par l'application| +|Dire tout en revue |pavnumPlus |NVDA+maj+a |Glisser vers le bas 3 doigts (mode texte) |Lit en partant de la position du curseur de revue, celui-ci suivant la lecture| +|Sélectionner puis copier à partir du curseur de revue |NVDA+f9 |NVDA+f9 |Aucun |Commence à sélectionner puis copier le texte depuis la position du curseur de revue. La copie ne s'effectue pas tant qu'on n'a pas indiqué la fin du texte à copier| +|Sélectionner puis copier jusqu'au curseur de revue |NVDA+f10 |NVDA+f10 |Aucun |Au premier appui, le texte est sélectionné depuis la position préalablement définie par "copier à partir du curseur de revue" jusqu'à la position actuelle du curseur de revue. Si le curseur système peut atteindre le texte, il sera amené au texte sélectionné. Au second appui, le texte est copié dans le presse-papiers de Windows.| +|aller au marqueur de début de copie en mode revue |NVDA+maj+f9 |NVDA+maj+f9 |aucun |Amène le curseur de revue à la position préalablement définiee comme marqueur de début de copie| +|Annoncer la mise en forme du texte |NVDA+maj+f |NVDA+maj+f |Aucun |Annonce la mise en forme du texte à la position du curseur de revue. Un double appui affiche l'information en mode navigation| +|Annonce le remplacement du symbole courant |Aucun |Aucun |aucun |Dit le symbole à la position du curseur de revue. Un double appui montre le symbole et le texte utilisé pour le remplacer en mode navigation.| + + + +Note : Les touches du pavé numérique nécessitent de désactiver le verrouillage numérique pour fonctionner correctement. + +Pour vous aider à mémoriser les touches de commandes de la disposition ordinateur de bureau, notez que les commandes de base de revue de texte sont organisées selon une grille de 3 sur 3 avec, de haut en bas, lignes, mots, caractères et, de gauche à droite, précédent, courant, suivant. +La disposition se présente ainsi : + +| . {.hideHeaderRow} |. |.| +|---|---|---| +|Ligne précédente |Ligne courante |Ligne suivante| +|Mot précédent |Mot courant |Mot suivant| +|Caractère précédent |Caractère courant |Caractère suivant| + +### Modes de Revue {#ReviewModes} + +Les commandes de [revue](#ReviewingText) de NVDA permettent de lire le contenu de l'objet courant du navigateur, le document courant ou l'écran, selon le mode de revue sélectionné. + +Les commandes suivantes basculent entre les modes de revue : + + +| Nom |Ordinateur de bureau |Ordinateur portable |Tactile |Description| +|---|---|---|---|---| +|Passer au mode revue suivant |NVDA+pavnum7 |NVDA+PagePrec |Glisser vers le haut 2 doigts |Passe au mode de revue suivant disponible supérieur au mode actuel.| +|Passer au mode revue précédent |NVDA+pavnum1 |NVDA+PageSuiv |Glisser vers le bas 2 doigts |Passe au mode de revue suivant disponible inférieur au mode actuel.| + + + +#### Revue d'Objet {#ObjectReview} + +En mode revue d'objet, vous pouvez explorer seulement le contenu de [l'objet du navigateur](#ObjectNavigation). +Pour les objets comme les champs d'édition ou les documents basiques, cela sera généralement le texte contenu. +Pour les autres objets, cela peut être le nom ou la valeur. + +#### Revue de Document {#DocumentReview} + +Quand [l'objet du navigateur](#ObjectNavigation) est dans un document comme une page web ou un document complexe (ex : document Lotus Symphony), il est possible de passer en mode revue de document. +Le mode revue de document vous permet de relire le contenu du document en entier. + +En passant du mode revue d'objet au mode revue de document, le curseur de revue se place là où se trouve le navigateur d'objet. +En bougeant le curseur de revue, le navigateur d'objet est déplacé à la même position que le curseur de revue. + +Notez que NVDA basculera automatiquement au mode revue de document depuis le mode revue d'objet lors d'un déplacement dans le document en mode navigation. + +#### Revue de l'Écran {#ScreenReview} + +Le mode revue de l'écran vous permet de lire le texte visible tel qu'il apparaît à l'écran dans l'application courante. +Cela est très similaire aux fonctionnalités mode revue ou curseur souris des autres lecteurs d'écran sous Windows. + +En basculant en mode revue de l'écran, le curseur de revue est placé à la position de [l'objet du navigateur](#ObjectNavigation). +En se déplaçant sur l'écran avec le curseur de revue, le navigateur d'objet est déplacé à l'objet trouvé à la position du curseur de revue. + +Notez que dans certaines nouvelles applications, NVDA ne pourra pas lire tout ou partie du texte à l'écran, étant donné qu'elles utilisent des techniques d'affichage qui ne peuvent être gérées actuellement. + +### Naviguer avec la Souris {#NavigatingWithTheMouse} + +Lorsqu'on déplace la souris, NVDA annonce par défaut le texte se trouvant directement sous le pointeur de la souris. +Quand c'est possible, NVDA lira un paragraphe, cependant certains contrôles ne peuvent être lus que par ligne. + +NVDA peut être configuré pour annoncer également le type d'[objet](#Objects) sous la souris lors de son déplacement (par exemple liste, bouton, etc.). +Cela peut être utile pour les personnes complètement aveugles car le texte n'est pas toujours suffisant. + +NVDA offre à l'utilisateur un moyen d'évaluer la position de la souris sur l'écran en émettant des bips audio représentant les coordonnées de la souris. +Plus la souris est haut sur l'écran, plus les bips sont aigus. +Plus la souris va à gauche ou à droite, plus le son viendra de gauche ou de droite dans la mesure où l'utilisateur possède des haut-parleurs stéréo. + +Par défaut, ces fonctions additionnelles de la souris ne sont pas activées. +Si vous voulez en tirer profit, vous pouvez les configurer dans la catégorie [Souris](#MouseSettings) du dialogue [Paramètres](#NVDASettings) qui se trouve dans le menu "Préférences" de NVDA. + +Bien qu'une souris physique ou un pavé tactile devrait être utilisée pour naviguer à la souris, NVDA possède quelques commandes clavier liées à la souris : + + + +| Nom |Ordinateur de bureau |Ordinateur portable |Tactile |Description| +|---|---|---|---|---| +|Clic gauche |pavnumDiviser |NVDA+uAccentGrave |Aucun |Simple clic gauche. Le double clic s'obtient par deux appuis rapides| +|Verrouillage du bouton gauche de la souris |maj+pavnumDiviser |NVDA+maj+uAccentGrave |Aucun |Verrouille le bouton gauche de la souris en position enfoncée. Un second appui déverrouille le bouton. Pour glisser-déposer avec la souris, verrouillez le bouton puis déplacez la souris soit physiquement ou par l'une des commandes NVDA prévues à cet effet| +|Clic droit |pavnumMultiplier |NVDA+astérisque |Taper et maintenir |Simple clic droit| +|Verrouillage du bouton droit de la souris |maj+pavnumMultiplier |NVDA+maj+astérisque |Aucun |Verrouille le bouton droit de la souris en position enfoncée, un second appui déverrouille le bouton. Pour glisser-déposer avec la souris, verrouillez le bouton puis déplacez la souris soit physiquement ou par l'une des commandes NVDA prévues à cet effet| +|Faire défiler vers le haut à la position de la souris |aucun |aucun |aucun |Faire défiler avec la molette de la souris vers le haut à la position courante de la souris| +|Faire défiler vers le bas à la position de la souris |aucun |aucun |aucun |Faire défiler avec la molette de la souris vers le bas à la position courante de la souris| +|Faire défiler vers la gauche à la position de la souris |aucun |aucun |aucun |Faire défiler avec la molette de la souris vers la gauche à la position courante de la souris| +|Faire défiler vers la droite à la position de la souris |aucun |aucun |aucun |Faire défiler avec la molette de la souris vers la droite à la position courante de la souris| +|Amener la souris à l'objet navigateur courant |NVDA+pavnumDiviser |NVDA+maj+m |Aucun |Amène la souris à la position de l'objet navigateur courant puis au curseur de revue| +|Aller à l'objet sous la souris |NVDA+pavnumMultiplier |NVDA+maj+n |Aucun |Amène l'objet navigateur à l'objet situé à la position de la souris| + + + +## Le mode Navigation {#BrowseMode} + +Les documents complexes, tels que les pages web, sont représentés sous NVDA en utilisant le Mode Navigation. +Cela inclut les documents dans les applications suivantes : + +* Mozilla Firefox +* Microsoft Internet Explorer +* Mozilla Thunderbird +* Les messages HTML sous Microsoft Outlook +* Google Chrome +* Microsoft Edge +* Adobe Reader +* Foxit Reader +* Les livres supportés sous Amazon Kindle pour PC + +Le mode navigation est aussi disponible en option pour les documents Microsoft Word. + +Le mode navigation offre une représentation platement textuelle du document dans laquelle on peut se déplacer avec les flèches de navigation. +Dans ce mode, toutes les touches de commandes du [mode curseur](#SystemCaret) fonctionneront (ex : dire tout, annonce de la mise en forme, touches de navigation dans les tableaux etc.). +Quand la [Mise en Évidence Visuelle](#VisionFocusHighlight) est activée, la position du curseur virtuel de mode navigation est également présentée visuellement. +Des informations indiquant si le texte est un lien, un titre etc., sont annoncées avec le texte pendant que vous vous déplacez. + +Parfois, vous devrez interagir directement avec les contrôles contenus dans ces documents. +Par exemple, vous devrez le faire pour les zones d'édition et les listes pour pouvoir entrer du texte ou utiliser le curseur pour travailler avec les contrôles. +Cela se fait en passant en mode formulaire, mode dans lequel presque toutes les touches sont passées directement au contrôle. +En mode navigation, par défaut, NVDA passera automatiquement en mode formulaire si vous tabulez ou cliquez sur un champ qui le requiert. +Inversement, tabuler ou cliquer sur un contrôle qui ne requiert pas le mode formulaire rebasculera NVDA en mode navigation. +Appuyer sur la "barre d'espace" ou la touche "entrée" passera également NVDA en mode formulaire si le champ le permet. +Appuyer sur la touche "échap" repassera NVDA en mode navigation. +De plus, vous pouvez aussi passer manuellement NVDA en mode formulaire, après quoi il y restera jusqu'à ce que vous choisissiez de le désactiver. + + + +| Nom |Touche |Description| +|---|---|---| +|Bascule entre mode formulaire et mode navigation |NVDA+espace |Bascule entre le mode formulaire et le mode navigation| +|Quitter le mode formulaire |échap |Retourne en mode navigation si le mode formulaire a préalablement été activé automatiquement| +|Réactualiser le document |NVDA+f5 |Recharge le document en cours, (utile si le contenu de la page semble incomplet. Non disponible sous Microsoft Word et Outlook.)| +|Rechercher |NVDA+contrôle+f |Affiche un dialogue qui vous permet de rechercher du texte dans le document courant. Voir [chercher du texte](#SearchingForText) pour plus d'information| +|Rechercher suivant |NVDA+f3 |Recherche l'occurrence suivante du texte que vous avez préalablement recherché dans le document| +|Rechercher précédent |NVDA+maj+f3 |Recherche l'occurrence précédente du texte que vous avez préalablement recherché dans le document| + + + +### Les Touches de Navigation Rapide {#SingleLetterNavigation} + +En mode navigation, pour une navigation plus rapide, NVDA dispose de raccourcis clavier où l'appui d'une seule touche amène à certains champs dans le document. +Notez que toutes ces commandes ne sont pas disponibles dans tous les types de documents. + + +Les touches suivantes permettent d'aller à l'élément suivant. En les combinant avec maj, on retourne à l'élément précédent. + +* h : titre +* l : liste +* i : élément de liste +* t : tableau +* k : lien +* n : texte hors lien +* f : champ de formulaire +* u : lien non visité +* v : lien visité +* e : zone d'édition +* b : bouton +* x : case à cocher +* c : liste déroulante +* r : bouton radio +* q : balise de citation +* s : séparateur +* m : cadre +* g : graphique +* d : région +* o : objet embarqué (lecteur audio et vidéo, application, dialogue etc.) +* 1 ... 6 : Titres 1 ... 6. +* a: annotation (commentaire, modification de l'éditeur, etc.) +* `p` : paragraphe de texte +* w: fautes d'orthographe + +Pour se déplacer au début ou à la fin des éléments contenants comme les listes et tableaux : + +| Nom |Touche |Description| +|---|---|---| +|Aller au début du conteneur |maj+virgule |Se déplace au début du conteneur (liste, tableau etc.) où le curseur est positionné| +|Aller après la fin du conteneur |virgule |Se déplace après la fin du conteneur (liste, tableau etc.) où le curseur se trouve| + + + +Quelques applications web comme Gmail, Twitter et Facebook utilisent de simple lettres comme touches de raccourci. +Si vous voulez les utiliser tout en restant capable d'utiliser vos touches curseur en mode navigation, vous pouvez désactiver temporairement les touches de navigation rapide de NVDA. + +Pour activer ou désactiver la navigation rapide pour le document courant, pressez NVDA+maj+espace. + + +#### Commande de navigation par paragraphe de texte {#TextNavigationCommand} + +Vous pouvez passer au paragraphe de texte suivant ou précédent en appuyant sur `p` ou `maj+p`. +Les paragraphes de texte sont définis comme un groupe de texte qui semble être écrit sous forme de phrases complètes. +Cela peut être utile pour trouver le début du contenu à lire sur diverses pages Web, telles que : + +* Les sites d'actualités +* Les forums +* Les articles de blog + +Ces commandes peuvent également être utiles pour éviter certains types de contenu, tels que : + +* Les publicités +* Les menus +* Les titres + +Veuillez noter cependant que même si NVDA fait de son mieux pour identifier les paragraphes de texte, l'algorithme n'est pas parfait et peut parfois commettre des erreurs. +De plus, cette commande est différente des commandes de navigation par paragraphe `contrôle+flècheBas/flècheHaut`. +La navigation par paragraphes de texte saute uniquement entre les paragraphes de texte, tandis que les commandes de navigation par paragraphe amènent le curseur aux paragraphe précédent/suivant, qu'ils contiennent ou non du texte. + +#### Autres commandes de navigation {#OtherNavigationCommands} + +En plus des commandes de navigation rapide répertoriées ci-dessus, NVDA dispose de commandes auxquelles aucune touche par défaut n'est attribuée. +Pour utiliser ces commandes, vous devez d'abord leur attribuer des gestes à l'aide de la [boîte de dialogue Gestes de commandes](#InputGestures). +Voici une liste des commandes disponibles: + +* Article +* Figure +* Regroupement +* Onglet +* Menu item +* Bouton à bascule +* Barre de progression +* Formule mathématique +* Paragraphe aligné verticalement +* Texte de même style +* Texte de style différent + +Gardez à l'esprit qu'il existe deux commandes pour chaque type d'élément, pour avancer et reculer dans le document, et vous devez attribuer des gestes aux deux commandes afin de pouvoir naviguer rapidement dans les deux sens. +Par exemple, si vous souhaitez utiliser les touches `y` / `maj+y` pour naviguer rapidement dans les onglets, procédez comme suit: + +1. Ouvrez la boîte de dialogue des gestes de commandes à partir du mode navigation. +1. Recherchez l'élément "Aller à l'onglet suivant" dans la section Mode navigation. +1. Attribuez la touche `y` pour le geste trouvé. +1. Recherchez l'élément "Aller à l'onglet précédent". +1. Attribuez `maj+y` pour le geste trouvé. + +### La Liste d'Éléments {#ElementsList} + +La liste d'éléments donne accès à une liste de différents types d'éléments dans le document, de manière appropriée à l'application. +Par exemple, dans les navigateurs web, la liste d'éléments peut afficher les liens, les titres, les champs de formulaire, les boutons ou les régions. +Des boutons radio vous permettent de choisir entre les différents types d'éléments. +Une zone d'édition est également présente dans le dialogue, elle vous permet de filtrer la liste pour faciliter la recherche d'un élément particulier dans la page. +Quand vous avez choisi un élément, des boutons vous permettent de vous y rendre ou de l'activer. + + +| Nom |Touche |Description| +|---|---|---| +|Liste d'éléments du document |NVDA+f7 |Liste les différents types d'éléments du document courant| + + + +### Chercher du texte {#SearchingForText} + +Ce dialogue vous permet de rechercher des termes dans le document courant. +Dans le champ "Entrez le texte à rechercher", le texte à trouver peut être saisi. +La case à cocher "Respecter la casse" force la recherche à différencier les lettres majuscules et minuscules. +Par exemple, quand Respecter la casse est sélectionné, vous trouverez " NV Access " mais pas " nv access ". +Utilisez les touches suivantes pour effectuer des recherches : + + +| Nom |Touche |Description| +|---|---|---| +|Rechercher du texte |NVDA+contrôle+f |Ouvre le dialogue de recherche| +|Trouver l'occurrence suivante |NVDA+f3 |recherche l'occurrence suivante du terme en cours de recherche| +|Trouver l'occurrence précédente |NVDA+maj+f3 |recherche l'occurrence précédente du terme en cours de recherche| + + + +### Les Objets Embarqués {#ImbeddedObjects} + +Certaines pages peuvent inclure du contenu riche utilisant des technologies comme Oracle Java et HTML5, tout comme des applications ou des dialogues. +Quand il en rencontre dans un document, NVDA annonce "objet embarqué", "application", ou "dialogue" respectivement. +Vous pouvez vous y rendre rapidement en utilisant les touches de navigation rapide pour objets embarqués o et maj+o. +Pour interagir avec ces objets, vous pouvez presser Entrée sur eux. +Si l'objet est accessible, vous pourrez interagir avec lui comme n'importe quelle autre application. +Une touche de commande permet de retourner à la page contenant l'objet embarqué. + + +| Nom |Touche |Description| +|---|---|---| +|Aller au document contenant l'objet |NVDA+contrôle+espace |Retire le focus à l'objet embarqué en cours et le rend au document contenant l'objet| + + + +### Mode sélection native {#NativeSelectionMode} + +Par défaut lors de la sélection de texte avec les touches `maj+flèche` en mode navigation, la sélection est seulement effectuée dans la représentation du document en mode navigation de NVDA, et non dans l'application elle-même. +Cela signifie que la sélection n'est pas visible à l'écran, et la copie du texte avec `contrôle+c` copiera seulement la représentation du contenu en texte brut par NVDA. C'est-à-dire que le formatage des tableaux ou comme lien ne sera pas copié. +Cependant, NVDA dispose d'un mode de sélection native qui peut être activé dans certains documents en mode navigation (pour l'instant seulement dans Mozilla Firefox), ce qui fait que la sélection native dans le document suit la sélection du mode navigation de NVDA. + + + +| Nom |Touche |Description| +|---|---|---| +|Activer ou désactiver le mode de sélection native |`NVDA+maj+f10` |Active ou désactive le mode de sélection native| + + + +Lorsque le mode de sélection native est activé, la copie de la sélection avec `contrôle+c` utilisera également la fonctionnalité de copie de l'application elle-même, ce qui signifie que le contenu riche sera copié dans le presse-papiers, au lieu du texte brut. +Cela signifie que le collage de ce contenu dans un programme tel que Microsoft Word ou Excel, le formatage tel que des tableaux ou le fait qu'un élément soit un lien seront inclus. +Veuillez noter cependant qu'en mode de sélection natif, certains labels accessibles ou autres informations générées par NVDA en mode Navigation ne seront pas inclus. +De plus, bien que l'application fasse de son mieux pour faire correspondre la sélection native à la sélection du mode navigation de NVDA, elle peut ne pas toujours être complètement exacte. +Cependant, pour les scénarios dans lesquels vous souhaitez copier un tableau ou un paragraphe entier de contenu riche, cette fonctionnalité devrait s'avérer utile. + +## Lecture de Contenu Mathématique {#ReadingMath} + +NVDA peut lire et naviguer dans du contenu mathématique sur le Web et dans d'autres applications, offrant un accès à la fois en parole et en braille. +Cependant, pour que NVDA puisse lire et interagir avec le contenu mathématique, vous devrez d'abord installer un composant mathématique pour NVDA. +Il existe plusieures extensions NVDA disponibles dans l'Add-on Store de NVDA qui prennent en charge les mathématiques, notamment l'[extension MathCAT NVDA](https://nsoiffer.github.io/MathCAT/) et [Access8Math](https://github.com/tsengwoody/Access8Math). +Veuillez vous référer à la [section Add-on Store](#AddonsManager) pour savoir comment découvrir et installer les extensions disponibles dans NVDA. +NVDA peut également utiliser l'ancien logiciel [MathPlayer](https://info.wiris.com/mathplayer-info) de Wiris s'il se trouve sur votre système, bien que ce logiciel ne soit plus maintenu. + +### Contenu mathématique pris en charge {#SupportedMathContent} + +Avec un composant mathématique approprié installé, NVDA supporte les types de contenu mathématiques suivants : + +* MathML sous Mozilla Firefox, Microsoft Internet Explorer et Google Chrome. +* Microsoft Word 365 Modern Math Equations via UI automation : +NVDA est capable de lire et d'interagir avec des équations mathématiques dans Microsoft Word 365/2016 build 14326 et supérieur. +Notez cependant que toutes les équations MathType créées précédemment doivent d'abord être converties en Office Math. +Cela peut être fait en sélectionnant chaque équation et en choisissant "Options d'équation", puis "Convertir en Office Math" dans le menu contextuel. +Assurez-vous que votre version de MathType est la dernière version avant de faire cela. +Microsoft Word fournit une navigation linéaire basée sur des symboles à travers les équations elles-mêmes et prend en charge la saisie de mathématiques à l'aide de plusieurs syntaxes, y compris LateX. +Pour plus de détails, veuillez consulter [Équations au format linéaire utilisant UnicodeMath et LaTeX dans Word](https://support.microsoft.com/fr-fr/office/%C3%A9quations-au-format-lin%C3%A9aire-utilisant-unicodemath-et-latex-dans-word-2e00618d-b1fd-49d8-8cb4-8d17f25754f8) +* Microsoft Powerpoint et les anciennes versions de Microsoft Word : +NVDA peut lire et parcourir les équations MathType dans Microsoft Powerpoint et Microsoft Word. +MathType doit être installé pour que cela fonctionne. +La version de démonstration est suffisante. +Elle peut être téléchargée depuis la [page de présentation de MathType](https://www.wiris.com/en/mathtype/). +* Adobe Reader. +Notez que ceci n'est pas un standard officiel, ce qui fait qu'actuellement, il n'existe pas de logiciels grand public pouvant produire ce contenu. +* Kindle Reader pour PC : +NVDA peut lire et parcourir Math dans Kindle pour PC pour les livres avec des mathématiques accessibles. + +Durant la lecture d'un document, NVDA annoncera tout contenu mathématique supporté quand il se présente. +Si vous utilisez un afficheur braille, ce contenu sera aussi affiché en braille. + +### Navigation Interactive {#InteractiveNavigation} + +Si vous travaillez principalement à la synthèse vocale, dans la plupart des cas, vous souhaiterez probablement examiner l'expression en plus petits segments plutôt qu'entendre toute l'expression en une seule fois. + +Si vous êtes en mode navigation, vous pouvez le faire en amenant le curseur sur le contenu mathématique et en appuyant sur Entrée. + +Si vous n'êtes pas en mode navigation : + +1. Amenez le curseur de revue sur le contenu mathématique. +Par défaut, le curseur de revue suit le curseur système, vous pouvez donc généralement utiliser le curseur système pour aller au contenu désiré. +1. Ensuite, activez la commande suivante : + + + +| Nom |Touche |Description| +|---|---|---| +|Interagir avec le contenu mathématique |NVDA+alt+m |Commence l'interaction avec le contenu mathématique.| + + + +A ce stade, NVDA entrera en mode mathématiques, dans lequel vous pouvez utiliser les commandes telles que les flèches pour explorer l'expression. +Par exemple, vous pouvez vous déplacer dans l'expression avec les flèches gauche et droite puis zoomer sur une partie de l'expression telle qu'une fraction en utilisant la flèche basse. + +Quand vous voulez retourner au document, appuyez simplement sur la touche échap. + +Pour plus d'informations sur les commandes disponibles et les préférences pour la lecture et la navigation dans le contenu mathématique, veuillez vous référer à la documentation du composant mathématique particulier que vous avez installé. + +* [Documentation MathCAT](https://nsoiffer.github.io/MathCAT/users.html) +* [Documentation Access8Math](https://github.com/tsengwoody/Access8Math) +* [Documentation MathPlayer](https://docs.wiris.com/mathplayer/en/mathplayer-user-manual.html) + +Parfois le contenu mathématique peut être affiché comme un bouton ou autre type d'élément qui, quand activé, peut afficher un dialogue ou plus d'informations relatives à la formule. +Pour activer le bouton ou l'élément contenant la formule, appuyez sur ctrl+entrée. + +### Installation de MathPlayer {#InstallingMathPlayer} + +Bien qu'il soit généralement recommandé d'utiliser l'une des extensions NVDA les plus récentes pour prendre en charge les mathématiques dans NVDA, dans certains scénarios limités, MathPlayer peut toujours être un choix plus approprié. +Par exemple. MathPlayer peut prendre en charge une langue particulière ou un code braille qui n'est pas pris en charge dans les extensions plus récentes. +MathPlayer est disponible gratuitement sur le site Wiris. +[Télécharger MathPlayer](https://downloads.wiris.com/mathplayer/MathPlayerSetup.exe). +Après avoir installé MathPlayer, vous devrez redémarrer NVDA. +Veuillez noter que les informations sur MathPlayer peuvent indiquer qu'il est uniquement destiné aux navigateurs plus anciens tels qu'Internet Explorer 8. +Cela fait uniquement référence à l'utilisation de MathPlayer pour afficher visuellement du contenu mathématique et peut être ignoré par ceux qui l'utilisent pour lire ou naviguer dans les mathématiques avec NVDA. + +## Braille {#Braille} + +Si vous possédez un afficheur braille, NVDA peut afficher des informations en braille. +Si votre terminal braille possède un clavier de type Perkins, vous pouvez également saisir du texte en intégral ou abrégé. +Le Braille peut aussi être affiché à l'écran en utilisant [la Visionneuse Braille](#BrailleViewer) en remplacement ou en parallèle d'un afficheur braille physique. + +Veuillez consulter la section [Terminaux Braille Pris en Charge](#SupportedBrailleDisplays) pour des informations concernant les terminaux braille pris en charge. +Cette section contient également des informations sur les terminaux qui supportent la détection automatique de terminaux braille en arrière-plan. +Vous pouvez configurer le braille dans la catégorie [Braille](#BrailleSettings) du dialogue [Paramètres](#NVDASettings). + +### Abréviations des Types, États des Contrôles et Repères en Braille {#BrailleAbbreviations} + +Dans le but de loger autant d'informations que possible sur un afficheur braille, les abréviations suivantes ont été définies pour indiquer le type et l'état des contrôles ainsi que les repères. + +| Abréviation |Type de contrôle| +|---|---| +|app |application| +|art |article| +|ctn |citation| +|btn |bouton| +|btnd |bouton déroulant| +|btnrot |bouton rotatif| +|btnp |bouton partagé| +|bsc |bascule| +|lég |légende| +|lstd |liste déroulante| +|càc |case à cocher| +|dlg |dialogue| +|doc |document| +|éd |zone d'édition| +|édmdp |édition de mot de passe| +|objemb |objet embarqué| +|notef |note de fin| +|fig |figure| +|noteb |note de bas de page| +|gra |graphique| +|grp |groupe| +|tN |titre de niveau n, ex : t1, t2.| +|aid |bulle d'aide| +|rgn |repère| +|ln |lien| +|lnv |lien visité| +|lst |liste| +|mnu |menu| +|bmnu |barre de menu| +|btnmnu |bouton de menu| +|élmnu |élément de menu| +|pn |panneau| +|bpr |barre de progression| +|indoc |indicateur d'occupation| +|btnr |bouton radio| +|bdéf |barre de défilement| +|sect |section| +|bét |barre d'état| +|ong |Contrôle d'onglet| +|tb |tableau| +|cN |colonne n d'un tableau, ex : c1, c2.| +|lN |ligne n d'un tableau, ex : l1, l2.| +|term |terminal| +|bo |barre d'outils| +|sug |suggestion| +|arb |arborescence| +|btnarb |bouton d'arborescence| +|élarb |élément d'arborescence| +|nv N |un élément d'arborescence a un niveau hiérarchique N| +|fen |fenêtre| +|⠤⠤⠤⠤⠤ |séparateur| +|mrq |contenu marqué| + +Les indicateurs d'état suivants sont également définis : + +| Abréviation |État du contrôle| +|---|---| +|... |affiché quand un objet supporte l'autocomplétion| +|⢎⣿⡱ |affiché quand un objet (ex : une bascule) est enfoncé| +|⢎⣀⡱ |affiché quand un objet (ex : une bascule) n'est pas enfoncé| +|⣏⣿⣹ |affiché quand un objet (ex : une case à cocher) est coché| +|⣏⣸⣹ |affiché quand un objet (ex : une case à cocher) est semi-coché| +|⣏⣀⣹ |affiché quand un objet (ex : une case à cocher) n'est pas coché| +|- |affiché quand un objet tel qu'un élément d'arborescence peut être réduit| +|+ |affiché quand un objet tel qu'un élément d'arborescence peut être développé| +|*** |affiché quand on rencontre un contrôle ou un document protégé| +|clq |affiché quand un objet est cliquable| +|cmnt |affiché quand il y a un commentaire pour une cellule de feuille de travail ou un document| +|frml |affiché quand il y a une formule dans une cellule de feuille de travail| +|invl |affiché lors d'une saisie invalide| +|ldesc |affiché quand un objet, généralement un graphique, a une description longue| +|mléd |affiché quand un champ d'édition permet la frappe de plusieurs lignes de texte comme les zones de commentaire sur les sites web| +|oblg |affiché quand on rencontre un champ de saisie obligatoire| +|ls |affiché quand un objet tel qu'une zone d'édition est en lecture seule| +|sél |affiché quand un objet est sélectionné| +|nsél |affiché quand un objet n'est pas sélectionné| +|tcro |affiché quand un objet est trié en ordre croissant| +|tdéc |affiché quand un objet est trié en ordre décroissant| +|smnu |affiché quand un objet a un sous-menu| + +Enfin, les abréviations de repères suivantes sont définies : + +| Abréviation |Repère| +|---|---| +|bnr |bannière| +|cinf |information sur le contenu| +|cmp |complémentaire| +|form |formulaire| +|prc |principale| +|nav |navigation| +|rch |recherche| +|rgn |région| + +### Saisie en Braille {#BrailleInput} + +NVDA supporte la saisie de braille intégral ou abrégé via un clavier braille. +Vous pouvez sélectionner la table de conversion utilisée pour convertir le braille en texte en utilisant le paramètre [Table de saisie](#BrailleSettingsInputTable) de la catégorie Braille du dialogue [Paramètres](#NVDASettings). + +Quand on utilise le braille intégral , le texte est inséré aussitôt qu'il est entré. +Quand on utilise le braille abrégé, le texte est inséré quand on presse espace ou entrée à la fin d'un mot. +Notez que la conversion ne concerne que les mots braille que vous êtes en train de taper et ne peut pas considérer du texte existant. +Par exemple, si vous utilisez un code braille dont les nombres doivent commencer par un indicateur numérique et pressez retour arrière pour aller à la fin d'un nombre, vous devrez entrer à nouveau l'indicateur numérique pour entrer des chiffres supplémentaires. + + +L'appui sur le point 7 efface la dernière cellule ou le dernier caractère braille saisi. +Le point 8 traduit toute saisie braille puis appuie sur la touche Entrée. +L'appui simultané sur les points 7 et 8 traduit toute saisie braille sans ajouter d'espace ou actionner la touche entrée. + + +#### Saisie de raccourcis clavier {#BrailleKeyboardShortcuts} + +NVDA prend en charge la saisie de raccourcis clavier et l'émulation de touches à l'aide de l'afficheur braille. +Cette émulation se présente sous deux formes : l'attribution d'une entrée braille directement à un appui sur une touche et l'utilisation des touches de modification virtuelles. + +Les touches couramment utilisées, telles que les touches fléchées ou l'appui sur Alt pour accéder aux menus, peuvent être mappées directement sur la saisie braille. +Le pilote de chaque afficheur braille est pré-équipé avec certaines de ces affectations. +Vous pouvez modifier ces affectations ou ajouter de nouvelles touches émulées à partir du [dialogue Gestes de commandes](#InputGestures). + +Bien que cette approche soit utile pour les touches fréquemment pressées ou uniques (telles que la tabulation), vous ne souhaiterez peut-être pas attribuer un ensemble unique de touches à chaque raccourci clavier. +Pour permettre l'émulation de pression de touches lorsque les touches de modification sont maintenues enfoncées, NVDA fournit des commandes pour basculer entre les touches contrôle, alt, majuscule, windows et NVDA, ainsi que des commandes pour certaines combinaisons de ces touches. +Pour utiliser ces bascules, appuyez d'abord sur la commande (ou la séquence de commandes) des touches de modification sur lesquelles vous souhaitez appuyer. +Saisissez ensuite le caractère faisant partie du raccourci clavier que vous souhaitez saisir. +Par exemple, pour produire contrôle+f, utilisez la commande "bascule de touche contrôle" puis tapez un f, +et pour saisir contrôle+alt+t, utilisez soit les commandes "bascule de touche contrôle" et "bascule de touche alt", dans n'importe quel ordre, soit la commande "bascule de touches Contrôle et alt", suivie de la saisie d'un t. + +Si vous basculez accidentellement les touches de modification, exécuter à nouveau la commande bascule supprimera le modificateur. + +Lors de la saisie en braille abrégé, l'utilisation des touches de modification entraînera la traduction de votre entrée comme si vous aviez appuyé sur les points 7 + 8. +De plus, la touche émulée ne peut pas refléter le braille tapé avant que la touche de modification ne soit enfoncée. +Cela signifie que, pour taper alt+2 avec un code braille qui utilise un signe dièse, vous devez d'abord basculer Alt puis taper un signe dièse. + +## Vision {#Vision} + +Bien que NVDA soit en premier lieu destiné à des personnes aveugles ou malvoyantes qui utilisent principalement la parole ou le braille pour accéder à un ordinateur, il offre aussi des facilités internes pour changer le contenu de l'écran. +Sous NVDA, une telle aide visuelle est appelée un service d'amélioration visuelle. + +NVDA offre plusieurs services d'amélioration visuelle décrits ci-dessous. +Des services d'amélioration visuelle additionnels peuvent être apportés dans des [Extensions NVDA](#AddonsManager). + +Les paramètres de vision de NVDA peuvent être modifiés dans la [catégorie vision](#VisionSettings) du dialogue [Paramètres NVDA](#NVDASettings). + +### Mise en Évidence Visuelle {#VisionFocusHighlight} + +La mise en évidence Visuelle peut aider à identifier la position du [focus système](#SystemFocus), de [l'objet navigateur](#ObjectNavigation) et du [mode navigation](#BrowseMode). +Ces positions sont mises en évidence avec un contour rectangulaire coloré. + +* Le bleu continu indique la position d'un objet navigateur combiné au focus système (ex : lorsque [l'objet navigateur suit le curseur système](#ReviewCursorFollowFocus)). +* Le bleu pointillé indique juste l'objet ayant le focus système. +* Le rose continu indique juste l'objet navigateur. +* Le jaune continu indique le curseur virtuel utilisé en mode navigation (quand il n'y a pas de curseur physique comme dans les navigateurs web). + +Quand la Mise en Évidence Visuelle est activée dans la [catégorie vision](#VisionSettings) du dialogue [Paramètres de NVDA](#NVDASettings), vous pouvez [choisir de mettre en évidence ou non le focus, l'objet navigateur ou le curseur du mode navigation](#VisionSettingsFocusHighlight). + +### Le Rideau d'Écran {#VisionScreenCurtain} + +En tant qu'utilisateur aveugle ou malvoyant, il est parfois impossible ou inutile de voir le contenu de l'écran. +Par ailleurs, il peut être difficile de s'assurer que personne ne regarde par-dessus votre épaule. +Pour cette situation, NVDA contient une fonctionnalité appelée "Rideau d'Écran" qui peut être activée pour rendre l'écran noir. + +Vous pouvez activer le Rideau d'Écran dans la [catégorie vision](#VisionSettings) du dialogue [Paramètres NVDA Settings](#NVDASettings). + + + +| Nom |Touche |Description| +|---|---|---| +|Activer ou désactiver le rideau d'écran |`NVDA+contrôle+échap` |Activer pour rendre l'écran noir ou désactiver pour afficher le contenu de l'écran. Un appui active le rideau d'écran jusqu'au prochain redémarrage de NVDA. Deux appuis activent le rideau d'écran jusqu'à ce que vous le désactiviez.| + + + +Quand le Rideau d'Écran est activé, certaines tâches directement liées à ce qui apparaît sur l'écran telles que [la reconnaissance optique de caractères](#Win10Ocr) ou la prise d'une copie d'écran ne peuvent pas être effectuées. + +En raison d'un changement dans l'API de grossissement de Windows, le Rideau d'Écran a dû être mis à jour pour prendre en charge les dernières versions de Windows. +Utilisez NVDA 2021.2 pour activer le Rideau d'Écran avec Windows 10 21H2 (10.0.19044) ou une version ultérieure. +Pour des raisons de sécurité, lorsque vous utilisez une nouvelle version de Windows, obtenez une confirmation visuelle que le rideau d'écran rend l'écran entièrement noir. + +Veuillez noter que lorsque la Loupe Windows est en cours d'exécution et que les couleurs d'écran inversées sont utilisées, le rideau d'écran ne peut pas être activé. + +## Reconnaissance de Contenu {#ContentRecognition} + +Quand les auteurs ne fournissent pas assez d'informations pour qu'un utilisateur de revue d'écran puisse déterminer le contenu de quelque chose, divers outils peuvent être utilisés pour tenter de reconnaître le contenu à partir d'une image. +NVDA supporte la fonctionnalité de reconnaissance optique de caractères (OCR) disponible sous Windows 10 et versions ultérieures pour reconnaître le texte dans les images. +Des outils de reconnaissance de contenu additionnels peuvent être fournis dans des extensions de NVDA. + +Quand vous utilisez une commande de reconnaissance de contenu, NVDA reconnaît le contenu de [l'objet navigateur courant](#ObjectNavigation). +Par défaut, l'objet navigateur suit le focus système ou le curseur du mode navigation, il vous suffit donc généralement d'amener le focus ou le curseur de navigation à l'endroit désiré. +Par exemple, si vous amenez le curseur de navigation sur un graphique, la reconnaissance reconnaîtra le contenu de ce graphique par défaut. +Cependant, vous pouvez utiliser directement la navigation par objet pour, par exemple, reconnaître tout le contenu d'une fenêtre d'application. + +Une fois la reconnaissance terminée, le résultat sera présenté dans un document similaire au mode navigation, vous permettant de lire les informations avec les touches curseur, etc. +L'appui sur la touche Entrée ou Espace activera (clic normal) le texte sous le curseur si possible. +L'appui sur échap quitte et efface le résultat de reconnaissance. + +### Reconnaissance Optique de Caractères de Windows {#Win10Ocr} + +Windows 10 et les versions ultérieures incluent la reconnaissance optique de caractères pour beaucoup de langues. +NVDA peut l'utiliser pour extraire le texte d'images ou d'applications inaccessibles. + +Vous pouvez définir la langue à utiliser pour la reconnaissance de texte dans la catégorie [Reconnaissance Optique De Caractères de Windows](#Win10OcrSettings) du dialogue [Paramètres](#NVDASettings). +Des langues additionnelles peuvent être installées en ouvrant le menu Démarrer, choisir Paramètres, Sélectionner Heure et Langue -> Région & Langue puis choisir Ajouter une langue. + +Lorsque vous souhaitez surveiller un contenu en constante évolution, par exemple lorsque vous regardez une vidéo avec sous-titres, vous pouvez éventuellement activer l'actualisation automatique du contenu reconnu. +Cela peut également être fait dans la [Catégorie Reconnaissance optique de caractères de Windows](#Win10OcrSettings) de la boîte de dialogue [Paramètres NVDA](#NVDASettings). + +La reconnaissance optique de caractères de Windows peut être partiellement ou totalement incompatible avec [les améliorations visuelles de NVDA](#Vision) ou autres aides visuelles externes. Vous devrez désactiver ces aides avant de procéder à une reconnaissance. + + +Pour reconnaître le texte dans l'objet navigateur courant en utilisant la reconnaissance optique de caractères de Windows, pressez NVDA+r. + + +## Fonctionnalités Spécifiques à Certaines Applications {#ApplicationSpecificFeatures} + +NVDA fournit ses propres fonctionnalités additionnelles dans quelques applications pour rendre certaines tâches plus faciles ou pour donner accès à certaines fonctions qui ne seraient pas accessibles autrement. + +### Microsoft Word {#MicrosoftWord} +#### Lecture Automatique des En-têtes de Lignes et de Colonnes {#WordAutomaticColumnAndRowHeaderReading} + +NVDA est capable d'annoncer automatiquement les en-têtes des lignes et des colonnes quand on navigue dans un tableau sous Microsoft Word. +Ceci nécessite que l'option "En-têtes de ligne et de colonne" soit activée dans la catégorie "Mise en Forme des Documents" qui se trouve dans le dialogue [Paramètres](#NVDASettings) de NVDA. + +Si vous utilisez [UIA pour accéder aux documents Word](#MSWordUIA), qui est le choix par défaut pour les versions récentes de Word et Windows, les cellules de la première ligne seront automatiquement considérées comme en-têtes de colonnes ; de même, les cellules de la première colonne seront automatiquement considérées comme en-têtes de lignes. + +Au contraire, si vous n'utilisez pas [UIA pour accéder aux documents Word](#MSWordUIA), vous devrez indiquer à NVDA quelle ligne ou colonne contient les en-têtes pour chaque tableau. +Après vous être placé sur la première cellule dans la colonne ou la ligne contenant les titres, utilisez l'une des commandes suivantes : + + +| Nom |Touche |Description| +|---|---|---| +|Définir les titres de colonnes |NVDA+maj+c |Appuyer une fois indique à NVDA que cette cellule est la première de la ligne contenant les titres de colonnes, qui devraient être annoncés automatiquement en naviguant entre les colonnes sous cette ligne. Appuyer deux fois permet d'effacer le paramétrage.| +|Définir les titres de lignes |NVDA+maj+r |Appuyer une fois indique à NVDA que cette cellule est la première de la colonne contenant les titres de lignes, qui devraient être annoncés automatiquement en naviguant entre les lignes après cette colonne. Appuyer deux fois permet d'effacer le paramétrage.| + + +Ces paramètres seront enregistrés dans le document comme des signets, compatibles avec d'autres revues d'écran comme JAWS. +Cela signifie que d'autres utilisateurs de revues d'écran ouvrant ce document ultérieurement auront automatiquement les titres des lignes et colonnes déjà définis. + +#### Mode Navigation sous Microsoft Word {#BrowseModeInMicrosoftWord} + +Comme sur le web, le mode navigation peut être utilisé sous Microsoft Word pour vous permettre d'utiliser des fonctionnalités telles que la navigation rapide et la Liste d'éléments. + +Pour activer ou désactiver le mode navigation sous Microsoft Word, pressez NVDA+espace. + +Pour plus d'information sur le mode navigation et la navigation rapide, consultez la [section Mode navigation](#BrowseMode). + +##### La Liste d'Éléments {#WordElementsList} + + +Quand vous êtes en mode navigation sous Microsoft Word, vous pouvez accéder à la liste d'éléments en pressant NVDA+f7. + +La liste d'éléments peut lister les titres, les liens, annotations (incluant inclut les commentaires et les demandes de changement) et les erreurs (actuellement limité aux fautes d'orthographe). + +#### Annonce des Commentaires {#WordReportingComments} + + +Pour annoncer tout commentaire à la position actuelle du curseur, pressez NVDA+alt+c. + +Tous les commentaires pour le document ainsi que les autres demandes de modification peuvent aussi être listés dans la liste d'éléments de NVDA en choisissant le type Annotations. + +### Microsoft Excel {#MicrosoftExcel} +#### Lecture Automatique des En-têtes de Lignes et de Colonnes {#ExcelAutomaticColumnAndRowHeaderReading} + +NVDA est capable d'annoncer automatiquement les en-têtes des lignes et des colonnes quand on navigue dans un tableau dans une feuille de calcul Excel. +Ceci nécessite d'abord que l'option "En-têtes de ligne et de colonne" soit activée dans la catégorie "Mise en Forme des Documents" qui se trouve dans le dialogue [Paramètres](#NVDASettings) de NVDA. +Ensuite, NVDA doit savoir quelle ligne ou colonne contient les titres dans le tableau considéré. +Après vous être placé sur la première cellule dans la colonne ou la ligne contenant les titres, utilisez l'une des commandes suivantes : + + +| Nom |Touche |Description| +|---|---|---| +|Définir les titres de colonnes |NVDA+maj+c |Appuyer une fois indique à NVDA que cette cellule est la première de la ligne contenant les titres de colonnes, qui devraient être annoncés automatiquement en naviguant entre les colonnes sous cette ligne. Appuyer deux fois permet d'effacer le paramétrage.| +|Définir les titres de lignes |NVDA+maj+r |Appuyer une fois indique à NVDA que cette cellule est la première de la colonne contenant les titres de lignes, qui devraient être annoncés automatiquement en naviguant entre les lignes après cette colonne. Appuyer deux fois permet d'effacer le paramétrage.| + + +Ces paramètres seront enregistrés dans le document comme plages de noms définis, compatibles avec d'autres revues d'écran comme JAWS. +Cela signifie que d'autres utilisateurs de revues d'écran ouvrant ce document ultérieurement auront automatiquement les titres des lignes et colonnes déjà définis. + +#### La Liste d'Éléments {#ExcelElementsList} + +Comme sur le web, NVDA a une liste d'éléments pour Microsoft Excel permettant d'accéder à différents types d'informations. + +Pour accéder à la liste d'éléments sous Excel, pressez NVDA+f7. + +Les différents types d'informations disponibles dans la liste d'éléments sont : + +* Diagrammes : Ceci liste tous les diagrammes dans la feuille de travail active. +Sélectionner un diagramme et appuyer sur la touche Entrée ou le bouton "Aller à" amène le focus au diagramme pour naviguer et lire avec les flèches. +* Commentaires : Ceci liste toutes les cellules de la feuille de travail active contenant des commentaires. +L'adresse de la cellule et ses commentaires sont présentés pour chaque cellule. +L'appui sur la touche Entrée ou le bouton Aller à sur un commentaire de la liste vous amènera directement à cette cellule. +* Formules : Ceci liste toutes les cellules de la feuille de travail contenant une formule. +L'adresse de la cellule et sa formule sont présentés pour chaque cellule. +L'appui sur la touche Entrée ou le bouton Aller à sur une formule de la liste vous amènera directement à cette cellule. +* feuilles : Ceci liste toutes les feuilles du classeur. +L'appui sur f2 sur une feuille de la liste vous permet de renommer cette feuille. +L'appui sur la touche Entrée ou le bouton Aller à sur une feuille de la liste vous amènera directement à cette feuille. +* Champs de formulaire : Ceci liste tous les champs de formulaire dans la feuille de travail active. +Pour chaque champ de formulaire, la liste d'éléments présente le texte alternatif du champ avec l'adresse des cellules concernées. +La sélection d'un champ de formulaire et l'appui sur entrée ou le bouton Aller à amènent à ce champ en mode navigation. + +#### Annonce des Notes {#ExcelReportingComments} + + +Pour annoncer toute note pour la cellule actuellement en focus, pressez NVDA+alt+c. +Sous Microsoft 2016, 365 et plus récents, les commentaires classiques sous Microsoft Excel ont été renommés en "notes". + +Toutes les notes de la feuille de calcul peuvent aussi être listés dans la liste d'éléments de NVDAaprès appui sur NVDA+f7. + +NVDA peut aussi afficher un dialogue spécifique pour ajouter ou éditer une note particulière. +NVDA remplace la zone d'édition de note originale de MS Excel en raison de contraintes d'accessibilité, mais le raccourci clavier pour afficher le dialogue est hérité de MS Excel et fonctionne aussi sans que NVDA soit actif. + +Pour ajouter ou éditer une note, dans une cellule en focus, pressez maj+f2. + + +Ce raccourci n'apparaît pas et ne peut être remplacé dans le dialogue Geste de Commandes de NVDA. + +Note : il est également possible d'ouvrir la zone d'édition de note de MS Excel par le menu contextuel de n'importe quelle cellule de la feuille de calcul. +Cependant, cela ouvrira la zone d'édition de note inaccessible et non le dialogue spécifique d'édition de commentaire de NVDA. + +Sous Microsoft Office 2016, 365 et plus récents, un nouveau genre de dialogue de commentaire a été ajouté. +Ce dialogue est accessible et apporte plus de fonctionnalités telles que la réponse aux commentaires, etc. +Il peut aussi être ouvert depuis le menu contextuel d'une cellule. +Les commentaires ajoutés au cellules via le nouveau dialogue de commentaire ne sont pas liés aux "notes". + +#### Lecture des Cellules Protégées {#ExcelReadingProtectedCells} + +Si un classeur a été protégé, il peut être impossible d'amener le focus à certaines cellules ayant été protégées en écriture. + +Pour pouvoir aller aux cellules protégées, passer en mode navigation en pressant NVDA+espace, puis utilisez les commandes standards de mouvement d'Excel telles que les flèches pour vous déplacer parmi les cellules de la feuille en cours. + + +#### Champs de Formulaire {#ExcelFormFields} + +Les feuilles de travail Excel peuvent inclure des champs de formulaire. +Vous pouvez y accéder en utilisant la liste d'éléments ou les touches de navigation rapide f et maj+f. +Quand vous êtes sur un champ de formulaire en mode navigation, vous pouvez appuyer sur Entrée ou Espace pour l'activer ou passer en mode formulaire pour pouvoir interagir avec lui, selon le type de contrôle. +Pour plus d'information concernant le mode navigation et la navigation par lettre, veuillez consulter la [section Mode Navigation](#BrowseMode). + +### Microsoft PowerPoint {#MicrosoftPowerPoint} + + + +| Nom |Touche |Description| +|---|---|---| +|Basculer l'arrêt de la lecture vocale |contrôle+maj+s |Lorsque l'on est dans un diaporama en cours de lecture, cette commande basculera entre les notes du commentateur du diaporama et le contenu de celui-ci. Cela n'affecte que ce que NVDA lira, pas l'affichage à l'écran.| + + + +### Foobar2000 {#Foobar2000} + + + +| Nom |Touche |Description| +|---|---|---| +|Annonce du temps restant |contrôle+maj+r |Annonce le temps restant pour le morceau en cours.| +|Annonce du temps écoulé |contrôle+maj+e |annonce le temps écoulé de la piste en cours.| +|Annonce de la longueur de la piste |contrôle+maj+t |Annonce la longueur de la piste en cours.| + + + +Note : Les raccourcis ci-dessus fonctionnent seulement avec le format de chaîne par défaut pour la barre d'état de Foobar. + +### Miranda IM {#MirandaIM} + + + +| Nom |Touche |Description| +|---|---|---| +|Annonce de message récent |NVDA+contrôle+1-4 |Annonce un des messages récents selon le chiffre appuyé ; ex : NVDA+contrôle+2 lit le second message le plus récent.| + + + +### Poedit {#Poedit} + +NVDA offre un support amélioré pour Poedit 3.4 ou plus récent. + + + +| Nom |Touche |Description| +|---|---|---| +|Annonce des notes pour les traducteurs |`contrôle+maj+a` |Annonce les notes pour les traducteurs. Deux appuis présente les notes en mode navigation| +|Annonce de la fenêtre de commentaires |`contrôle+maj+c` |Annonce tout commentaire dans la fenêtre de commentaires. Deux appuis présente le commentaire en mode navigation| +|Annonce de l'ancien texte source |`contrôle+maj+o` |Annonce l'ancien texte source s'il y en a un. Deux appuis présente le texte en mode navigation| +|Annonce l'avertissement de traduction |`contrôle+maj+w` |Annonce l'avertissement de traduction, s'il y en a un. Deux appuis présente l'avertissement en mode navigation| + + + +### Kindle pour PC {#Kindle} + +NVDA supporte la lecture et la navigation dans les livres sous Amazon Kindle pour PC. +Cette fonctionnalité est disponible seulement dans les livres Kindle signalés par "Support des revues d'écran", ce que vous pouvez vérifier sur la page de détails du livre. + +On utilise le mode navigation pour lire les livres. +Il est activé automatiquement quand vous ouvrez un livre ou quand vous placez le focus sur la zone du livre. +La page sera tournée automatiquement quand vous déplacerez le curseur ou utiliserez la commande dire tout. + +Vous pouvez aller manuellement à la page suivante en pressant la touche PageSuiv ou à la page précédente en pressant la touche PagePrec. + + +La navigation par simple lettre est supportée pour les liens et les graphiques, mais seulement dans la page en cours. +La navigation par liens inclut également les notes de bas de page. + +NVDA fournit une ébauche de support pour la lecture et la navigation interactive de contenu mathématique pour les livres avec du contenu mathématique accessible. +Veuillez consulter la section [Lecture de Contenu Mathématique](#ReadingMath) pour plus d'informations. + +#### Sélection de Texte {#KindleTextSelection} + +Kindle vous permet d'exécuter diverses fonctions relatives au texte sélectionné, incluant l'obtention d'une définition du dictionnaire, l'ajout de notes et de surlignages, la copie du texte dans le presse-papiers et la recherche sur le web. +Pour faire cela, sélectionnez d'abord le texte comme vous le feriez normalement en mode navigation; ex: en utilisant maj et les touches curseur. + +Une fois que vous avez sélectionné le texte, pressez la touche applications ou maj+f10 pour afficher les options disponibles pour travailler avec la sélection. + +Si vous faites ceci sans avoir sélectionné de texte, les options pour le mot sous le curseur seront affichées. + +#### Notes de l'Utilisateur {#KindleUserNotes} + +Vous pouvez ajouter une note concernant un mot ou un passage du texte. +Pour faire cela, sélectionnez d'abord le texte concerné et accédez aux options de sélection comme décrit plus haut. +Ensuite, choisissez Ajouter une Note. + +Durant la lecture en mode navigation, NVDA fait référence à cette note comme un commentaire. + +Pour afficher, éditer ou effacer une note. + +1. Amenez le curseur au texte contenant la note. +1. Accédez aux options de sélection comme décrit plus haut. +1. Choisissez Éditer la Note. + +### Azardi {#Azardi} + + +Quand vous êtes dans le tableau des livres ajoutés : + +| Nom |Touche |Description| +|---|---|---| +|Entrée |entrée |Ouvre le livre sélectionné.| +|Menu contextuel |applications |Ouvre le menu contextuel pour le livre sélectionné.| + + + +### Console Windows {#WinConsole} + +NVDA fournit un support pour la console de commande de Windows utilisée par l'invite de commandes, PowerShell, et le sous-système Windows pour Linux. +La console Windows est de taille fixe, typiquement beaucoup plus petite que le tampon contenant l'affichage. +Quand du nouveau texte est écrit, le contenu défile vers le haut et le texte précédent n'est plus visible. +Sur les versions de Windows antérieures à Windows 11 22H2, le texte de la console qui n'est pas visiblement affiché dans la fenêtre n'est pas accessible avec les commandes de revue de texte de NVDA. +Ainsi, il est nécessaire de faire défiler la fenêtre de la console pour lire le texte plus ancien. +Dans les versions plus récentes de la console et dans Windows Terminal, il est possible de consulter librement l'intégralité du tampon de texte sans avoir à faire défiler la fenêtre. + +Les raccourcis clavier propres à Windows suivants peuvent être utiles pour [revoir du texte](#ReviewingText) avec NVDA dans les versions plus anciennes de la Console Windows : + +| Nom |Touche |Description| +|---|---|---| +|Défilement vers le haut |contrôle+flècheHaute |Fait défiler la fenêtre de la console vers le haut pour que le texte plus ancien puisse être lu.| +|Défilement vers le bas |contrôle+flècheBasse |Fait défiler la fenêtre de la console vers le bas pour que le texte plus récent puisse être lu.| +|Aller au début |contrôle+début |Aligne la fenêtre de la console sur le début du tampon.| +|Aller à la fin |contrôle+fin |Aligne la fenêtre de la console sur la fin du tampon.| + + + +## Configurer NVDA {#ConfiguringNVDA} + +La plupart des paramètres de NVDA peuvent être modifiés en utilisant les dialogues accessibles par le sous-menu "Préférences" du menu NVDA. +Beaucoup de ces paramètres se trouvent dans le dialogue multipage [Paramètres](#NVDASettings). +Dans tous les dialogues, appuyez sur le bouton "OK" pour valider vos modifications. +Pour annuler les modifications, appuyez sur le bouton "Annuler" ou sur la touche "échap". +Pour certains dialogues, vous pouvez activer le bouton Appliquer pour que les paramètres prennent effet immédiatement sans fermer le dialogue. +La plupart des dialogue NVDA prennent en charge l'aide contextuelle. + +Dans un dialogue, un appui sur `f1` ouvre le guide de l'utilisateur au paragraphe relatif au paramètre sélectionné ou au dialogue actuel. + +Certains paramètres peuvent aussi être modifiés en utilisant des raccourcis clavier que vous trouverez dans les sections ci-dessous. + +### Paramètres de NVDA {#NVDASettings} + + +NVDA fournit de nombreux paramètres de configuration qui peuvent être modifiés à l'aide de la boîte de dialogue des paramètres. +Pour faciliter la recherche du type de paramètres que vous souhaitez modifier, la boîte de dialogue affiche une liste de catégories de configuration parmi lesquelles choisir. +Lorsque vous sélectionnez une catégorie, tous les paramètres qui s'y rapportent s'affichent dans la boîte de dialogue. +Pour vous déplacer entre les catégories, utilisez `tab` ou `maj+tab` pour atteindre la liste des catégories, puis utilisez les touches fléchées haut et bas pour naviguer dans la liste. +De n'importe où dans la boîte de dialogue, vous pouvez également avancer d'une catégorie en appuyant sur `ctrl+tab`, ou reculer d'une catégorie en appuyant sur `maj+ctrl+tab`. + +Une fois que vous avez modifié un ou plusieurs paramètres, les paramètres peuvent être appliqués à l'aide du bouton Appliquer, auquel cas la boîte de dialogue restera ouverte, vous permettant de modifier d'autres paramètres ou de choisir une autre catégorie. +Si vous voulez sauvegarder vos paramètres et fermer le dialogue Paramètres, vous pouvez utiliser le bouton "OK". + +Certaines catégories de paramètres ont un raccourci clavier dédié. +Si on le presse, ce raccourci ouvrira le dialogue Paramètres directement dans cette catégorie particulière. +Par défaut, toutes les catégories ne peuvent pas être atteintes via un raccourci clavier. +Si vous accédez fréquemment à une catégorie qui n'a pas de raccourci dédié, utilisez le dialogue [Geste de Commandes](#InputGestures) pour ajouter un geste personnalisé tel qu'un raccourci clavier ou un geste tactile pour cette catégorie. + +Les catégories de paramètres du dialogue Paramètres sont décrite ci-dessous. + +#### Général {#GeneralSettings} + + + +##### Ouvrir les paramètres généraux {#OpenGeneralSettings} + +Raccourci clavier : `NVDA+contrôle+g` + +La catégorie Général du dialogue Paramètres définit le comportement global de NVDA tel que la langue de l'interface et la vérification des mises à jour. +Elle contient les options suivantes : + +##### Langue {#GeneralSettingsLanguage} + +C'est une liste déroulante qui permet de choisir la langue de l'interface utilisateur et des messages de NVDA. +La liste comporte de nombreuses langues et le choix par défaut est dénommé "Utilisateur par défaut". +Ce choix indique à NVDA d'utiliser la langue de Windows. + +Noter qu'il faut relancer NVDA quand on change la langue. +Quand le dialogue de confirmation apparaît, sélectionnez "redémarrer maintenant" ou "redémarrer plus tard" selon que vous voulez utiliser la nouvelle langue maintenant ou ultérieurement, respectivement. Si "redémarrer plus tard" est sélectionné, la configuration doit être sauvegardée (soit manuellement soit en utilisant la fonctionnalité sauvegarder la configuration en quittant). + +##### Sauvegarder la configuration en quittant {#GeneralSettingsSaveConfig} + +C'est une case à cocher qui, une fois cochée, indique à NVDA de sauvegarder automatiquement la configuration courante lorsqu'on arrête NVDA. + +##### Afficher les options d'arrêt avant de quitter NVDA {#GeneralSettingsShowExitOptions} + +Cette option est une case à cocher qui vous permet de décider si un dialogue doit s'afficher ou non lorsque vous quittez NVDA, pour demander quelle action vous souhaitez effectuer. +Quand elle est cochée, un dialogue apparaît lorsque vous voulez quitter NVDA, vous demandant si vous voulez quitter, redémarrer, redémarrer sans extensions ou installer des mises à jour en attente s'il y en a. +Quand elle n'est pas cochée, NVDA s'arrête immédiatement. + +##### Jouer des sons au démarrage ou à l'arrêt de NVDA {#GeneralSettingsPlaySounds} + +Cette option est une case à cocher qui, quand elle est cochée, dit à NVDA de jouer des sons lors de son démarrage ou de son arrêt. + +##### Niveau de journalisation {#GeneralSettingsLogLevel} + +C'est une liste déroulante qui vous permet de choisir la quantité d'informations que NVDA consignera dans son journal durant son exécution. +Généralement, l'utilisateur n'aura pas besoin d'y toucher dans la mesure où assez peu d'informations sont consignées. +Cependant, si vous voulez fournir des informations lors d'un rapport d'erreur, ou activer/désactiver la journalisation, cette option peut être utile. + +Les niveaux de journalisation disponibles sont : + +* Désactivé : À l'exception d'un bref message de démarrage, NVDA ne journalisera rien durant son exécution. +* Info : NVDA journalisera des informations de base telles que les messages de démarrage et des informations utiles pour les développeurs. +* Avertissements de débogage : Les messages d'avertissement qui ne sont pas causés par des erreurs graves seront journalisés. +* Entrées/sorties : Les entrées du clavier et des terminaux braille, ainsi que les sorties en parole et en braille seront journalisées. +Si la confidentialité vous préoccupe, ne définissez pas le niveau de journalisation sur cette option. +* Débogage : En plus des messages d'info, avertissements et entrées/sorties, des messages additionnels de débogage seront journalisés. +Tout comme pour entrées/sorties, si la confidentialité vous préoccupe, vous ne devez pas définir le niveau de journalisation sur cette option. + +##### Démarrer NVDA automatiquement après ma connexion à Windows {#GeneralSettingsStartAfterLogOn} + +Si cette option est activée, NVDA démarrera automatiquement dès que vous vous connecterez à Windows. +Cette option n'existe que dans les versions installées de NVDA. + +##### Utiliser NVDA sur l'écran de connexion à Windows (nécessite des privilèges administrateur) {#GeneralSettingsStartOnLogOnScreen} + +Si vous vous connectez à Windows en fournissant un nom d'utilisateur et un mot de passe, l'activation de cette option permettra à NVDA de démarrer automatiquement dès l'écran de connexion au démarrage de Windows. +Cette option n'existe que dans les versions installées de NVDA. + +##### Utiliser les paramètres actuellement sauvegardés sur l'écran de connexion et les autres écrans sécurisés {#GeneralSettingsCopySettings} + +L'appui sur ce bouton copie votre configuration utilisateur actuellement sauvegardée dans le répertoire système de NVDA, ainsi, NVDA peut l'utiliser quand il s'exécute sur l'écran de connexion et les [autres écrans sécurisés](#SecureScreens). +Pour vous assurer que tous vos paramètres sont transférés, enregistrez d'abord votre configuration avec contrôle+NVDA+c ou Enregistrer la configuration dans le menu NVDA. +Cette option n'existe que dans les versions installées de NVDA. + +##### Vérifier automatiquement les mises à jour de NVDA {#GeneralSettingsCheckForUpdates} + +Si ceci est activé, NVDA recherchera automatiquement les versions mises à jour et vous informera lorsqu'une mise à jour est disponible. +Vous pouvez également vérifier manuellement les mises à jour en sélectionnant "Recherche d'une Mise à Jour..." sous "Aide" du menu NVDA. +Lors d'une vérification manuelle ou automatique des mises à jour, NVDA doit envoyer certaines informations au serveur pour recevoir la mise à jour appropriée à votre système. +Les informations suivantes sont toujours envoyées : + +* Version courante de NVDA +* Version du système d'exploitation +* Système d'exploitation 32 ou 64 bits + +##### Autoriser NV Access à recueillir des statistiques d'utilisation {#GeneralSettingsGatherUsageStats} + +Si ceci est activé, NV Access utilisera les informations de la vérification de mises à jour pour connaître le nombre d'utilisateurs de NVDA en incluant certaines informations démographiques telles que le système d'exploitation et le pays d'origine. +Bien que votre adresse IP soit utilisée pour déterminer votre pays durant la mise à jour, elle ne sera jamais conservée. +En plus des informations obligatoires nécessaires à la mise à jour, les informations supplémentaires suivantes sont également envoyées : + +* Un identifiant unique pour l'utilisateur courant de NVDA, il change une fois par mois +* La langue d'interface de NVDA +* Copie en cours de NVDA installée ou portables +* Le nom du synthétiseur vocal actuellement utilisé (incluant le nom de l'extension dont provient le pilote) +* Le nom du terminal braille actuellement utilisé (incluant le nom de l'extension dont provient le pilote) +* La table d'affichage braille en cours (si le braille est activé) + +Ces informations aident grandement NV Access pour prioritiser les futurs développements de NVDA. + +##### Avertir des mises à jour en attente au démarrage {#GeneralSettingsNotifyPendingUpdates} + +Si ceci est activé, NVDA vous informera quand il y a une mise à jour en attente au démarrage, et vous offrira la possibilité de l'installer. +Vous pouvez aussi installer manuellement la mise à jour en attente depuis le dialogue de sortie de NVDA (si activé), depuis le menu NVDA, ou quand vous exécutez une vérification depuis le menu Aide. + +#### Parole {#SpeechSettings} + + + +##### Ouvrir les paramètres de parole {#OpenSpeechSettings} + +Raccourci clavier : `NVDA+contrôle+v` + +La catégorie "Parole" dans le dialogue Paramètres de NVDA, contient des options vous permettant de changer le synthétiseur vocal ainsi que les caractéristiques de la voix pour le synthétiseur choisi. +Pour une manière plus rapide de contrôler les paramètres vocaux depuis n'importe où, reportez-vous à la section [boucle des paramètres synthétiseur](#SynthSettingsRing). + +La catégorie Parole contient les options suivantes : + +##### Changer de synthétiseur {#SpeechSettingsChange} + +La première option dans la catégorie Parole est le bouton Changer... Ce bouton active le dialogue [Choisir le Synthétiseur](#SelectSynthesizer) qui vous permet de choisir le synthétiseur actif et le périphérique de sortie. +Ce dialogue s'ouvre par-dessus le dialogue Paramètres. +Sauvegarder ou annuler les paramètres dans le dialogue de choix du synthétiseur vous ramènera au dialogue Paramètres. + +##### Voix {#SpeechSettingsVoice} + +L'option Voix est une liste déroulante contenant, pour le synthétiseur en cours, toutes les voix que vous avez installées. +Vous pouvez utiliser les flèches pour entendre les différents choix possibles. +Les flèches gauche et haut vous font monter dans la liste et les flèches droit et bas vous font descendre. + +##### Variante {#SpeechSettingsVariant} + +Si vous utilisez le synthétiseur Espeak NG fourni avec NVDA, cette liste déroulante vous permettra de choisir la variante avec laquelle le synthétiseur doit parler. +Les variantes ESpeak NG sont comme des voix, dans la mesure où elles ajoutent des attributs légèrement différents à la voix ESpeak NG. +Certaines variantes ressembleront à un homme, d'autres à une femme, d'autres même à une grenouille. +Si vous utilisez un synthétiseur tiers, vous pourrez peut-être changer cette valeur aussi, si la voix que vous aurez choisie prend cela en charge. + +##### Débit {#SpeechSettingsRate} + +Cette option vous permet de modifier le débit de la parole. +C'est un potentiomètre qui va de 0 à 100, (0 étant la vitesse la plus lente et 100 la plus rapide). + +##### Débit augmenté {#SpeechSettingsRateBoost} + +Activer cette option augmentera significativement le débit de la parole, si le synthétiseur courant le permet. + +##### Hauteur {#SpeechSettingsPitch} + +Cette option vous permet de modifier la hauteur de la voix. +C'est un potentiomètre qui va de 0 à 100 - 0 étant le son le plus grave et 100 le plus aigu. + +##### Volume {#SpeechSettingsVolume} + +Cette option est un potentiomètre qui va de 0 à 100 - 0 étant le volume le plus bas et 100 le plus élevé. + +##### Inflexion {#SpeechSettingsInflection} + +Cette option est un potentiomètre qui vous permet de choisir le degré d'inflexion (augmentation et diminution de la hauteur) que le synthétiseur doit utiliser pour parler. + +##### Changement automatique de langue {#SpeechSettingsLanguageSwitching} + +Cette case à cocher vous permet de choisir si NVDA doit changer de langue à la volée si une balise de langue est présente dans le texte en cours de lecture. +Cette option est activée par défaut. + +##### Changement automatique de dialecte {#SpeechSettingsDialectSwitching} + +Cette case à cocher vous permet de choisir si les changements de dialecte doivent être pris en compte en plus des changements de langue réels. +Par exemple, un texte peut être en Anglais Américain et comporter des passages marqués comme Anglais Britannique. Si cette option est activée, le synthétiseur respectera les changements d'accent. +Par défaut, cette option est désactivée. + + + +##### Niveau des ponctuations et symboles {#SpeechSettingsSymbolLevel} + +Raccourci clavier : NVDA+p + +Ceci vous permet de choisir la quantité de ponctuations et autres symboles qui seront prononcés. +Par exemple, si vous choisissez "Tous", tous les symboles seront annoncés. +Cette option s'applique à tous les synthétiseurs, pas uniquement au synthétiseur courant. + +##### Se baser sur la langue de la voix pour le traitement des symboles et caractères {#SpeechSettingsTrust} + +Activée par défaut, cette option indique à NVDA si la langue de la voix en cours peut être utilisée pour le traitement des symboles et caractères. +Si vous trouvez que NVDA lit les ponctuations dans la mauvaise langue pour une voix ou un synthétiseur particulier, vous pouvez désactiver ce comportement pour forcer NVDA à utiliser ses paramètres généraux de langue à la place. + +##### Normalisation Unicode {#SpeechUnicodeNormalization} +| . {.hideHeaderRow} |.| +|---|---| +|Options |Defaut (Désactivé), Activé, Désactivé| +|Défaut |Désactivé| + +Lorsque cette option est activée, la normalisation Unicode est appliqué au texte annoncé par NVDA. +Ceci est utile lors de l'annonce de caractères pouvant être représentés sous plusieurs formes. +NVDA utilise l'algorithme NFKC (Normalization Form Compatibility Composition), qui offre, entre autres, les avantages suivants : + +1. Les versions en gras et en italique des caractères qui font partie de la norme Unicode et sont couramment utilisées sur les réseaux sociaux sont normalisées selon leur équivalent compatible le plus courant. +Par exemple, la lettre latine "h" peut également être présentée comme "𝐡" (gras), "ℎ" (italique), etc. mais sera toujours prononcée comme "h" lorsque la normalisation est activée. +Cet aspect de la normalisation facilite également la lecture des équations dans l'éditeur d'équations Microsoft Word. + +1. Normalisation appliquée aux caractères composés. +Par exemple, le caractère "é" (e avec un accent aigu), un caractère courant dans des langues comme le français et l'espagnol peut être représenté sous deux formes: + 1. Un caractère Unicode unique (é) + 1. Une décomposition en deux caractères (é), à savoir la lettre latine normale e et un modificateur accent aigu + La normalisation Unicode garantit qu'une seule forme sera utilisée pour la sortie vocale, à savoir la variante à un caractère. + +1. Décomposition de certaines ligatures, dont "ij" (ligature ij néérlandaise) en leur forme à deux lettres ("ij"). + +1. Ordre stable des modificateurs dans les caractères composites, par exemple en hébreu ancien. + +Pour activer/désactiver la normalisation Unicode depuis n'importe où, veuillez assigner un geste personnalisé en utilisant le [dialogue des Gestes de Commandes](#InputGestures). + +##### Annoncer "Normalisé" lors de la navigation par caractère {#SpeechReportNormalizedForCharacterNavigation} + +Ce paramètre est une case à cocher qui, lorsqu'elle est cochée, indique à NVDA d'annoncer explicitement qu'un caractère est normalisé lorsqu'il est prononcé comme un caractère individuel, par exemple lors de l'épellation. +Par exemple, lorsque cette option est activée, si on épelle le caractère "ij", il sera annoncé comme "i j normalisé". + +Notez que ce paramètre n'est disponible que lorsque l'option "[Normalisation Unicode](#SpeechUnicodeNormalization)" est activée. + +##### Inclure les données du Consortium Unicode (incluant les emoji) dans le traitement des caractères et symboles {#SpeechSettingsCLDR} + +Quand cette case est cochée, NVDA inclura des dictionnaires de prononciation de symboles additionels lorsqu'il prononce des caractères et des symboles. +Ces dictionnaires contiennent des descriptions de symboles (en particulier les emoji) qui sont fournies par le [Consortium Unicode](https://www.unicode.org/consortium/) comme faisant partie de leur [référentiel commun de données locales Repository](https://cldr.unicode.org/). +Si vous voulez que NVDA annonce la descriptions des caractères emoji en se basant sur ces données, vous devez activer cette option. +Cependant, si vous utilisez un synthétiseur vocal supportant nativement ces descriptions, vous pouvez la désactiver. + +Notez que les descriptions de caractères ajoutées manuellement ou modifiées sont sauvegardées dans vos paramètres personnels. +Ainsi, si vous changez la description d'un emoji particulier, votre description personnalisée sera annoncée pour cet emoji que cette option soit activée ou non. +Vous pouvez ajouter, modifier ou supprimer des descriptions de symboles par le dialogue [Prononciation des ponctuations et symboles](#SymbolPronunciation) de NVDA. + +Pour activer/désactiver l'inclusion des données du Consortium Unicode depuis n'importe où, veuillez assigner un geste personnalisé en utilisant le [dialogue des Gestes de Commandes](#InputGestures). + +##### Pourcentage de changement de la hauteur pour indiquer les majuscules {#SpeechSettingsCapPitchChange} + +Ce champ d'édition vous permet d'entrer la valeur du changement de hauteur de la voix à l'annonce d'une lettre majuscule. +Cette valeur est un pourcentage, une valeur négative réduit la hauteur, une valeur positive l'augmente. +Pour n'avoir aucun changement de hauteur, entrez la valeur 0. +D'ordinaire, NVDA augmente légèrement la tonalité pour chaque lettre majuscule, mais certains synthétiseurs peuvent ne pas supporter cela correctement. +Si le changement de hauteur pour les majuscules n'est pas supporté, optez pour [Dire "majuscule" après les majuscules](#SpeechSettingsSayCapBefore) et/ou [ Émettre un bip pour signaler les majuscules](#SpeechSettingsBeepForCaps) à la place. + +##### Dire "majuscule" après les majuscules {#SpeechSettingsSayCapBefore} + +Ce paramètre est une case à cocher qui, si cochée, indique à NVDA de dire "maj" pour une lettre en majuscule quand on l'atteint par les flèches de direction ou lors de la frappe. + +##### Annoncer les majuscules par des bips {#SpeechSettingsBeepForCaps} + +Quand cette case à cocher est cochée, NVDA émettra un petit "bip" chaque fois qu'il rencontre un caractère majuscule. + +##### Utiliser la fonction d'épellation si elle est supportée {#SpeechSettingsUseSpelling} + +Certains mots ne comportent qu'un seul caractère, mais la prononciation est différente selon que le caractère est prononcé comme un caractère unique (épellation) ou comme un mot. +Par exemple, en Français, "y" est à la fois une lettre et un mot et se prononce différemment selon le cas. +Cette option permet au synthétiseur de différencier les deux cas si le synthétiseur la supporte. +La plupart des synthétiseurs la supportent. + +En général, cette option devrait être activée. +Cependant, certains synthétiseurs utilisant les API de parole Microsoft ne l'implémentent pas correctement et se comportent bizarrement quand cette option est activée. +Les synthétiseurs de chez Code Factory, aussi bien l'extension que l'application SAPI, ne l'implémentent pas non plus correctement et provoquent une épellation indésirable du texte annoncé (par exemple dans le menu ou les boîtes de dialogue NVDA). +Si vous rencontrez des problèmes avec l'épellation de caractères, essayez de désactiver cette option. + +##### Description différée des caractères lors du mouvement du curseur {#delayedCharacterDescriptions} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Activé, Désactivé| +|Défaut |Désactivé| + +Lorsque ce paramètre est coché, NVDA dira la description du caractère lorsque vous vous déplacerez par caractère. + +Par exemple, lors de la revue d'une ligne par caractères, lorsque la lettre "b" est lue, NVDA dira "Bravo" après un délai d'une seconde. +Cela peut être utile s'il est difficile de distinguer la prononciation des symboles ou pour les utilisateurs malentendants. + +La description différée du caractère sera annulée si un autre texte est prononcé pendant ce temps, ou si vous appuyez sur la touche `contrôle`. + +##### Modes disponibles dans la commande Faire défiler les modes de parole {#SpeechModesDisabling} + +Les cases à cocher dans cette liste vous permettent de choisir quels [modes de parole](#SpeechModes) sont inclus lors du passage de l'un à l'autre en utilisant `NVDA+s`. +Les modes non cochés sont exclus. +Par défaut, tous les modes sont inclus. + +Par exemple, si vous n'avez pas besoin d'utiliser les modes "bips" et "désactivée", vous devez décocher ces deux modes et laisser cochés les modes "activée" et "à la demande". +A noter qu'il est nécessaire de cocher au moins deux modes. + +#### Choix du synthétiseur {#SelectSynthesizer} + + + +##### Ouvrir le dialogue sélection du synthétiseur {#OpenSelectSynthesizer} + +Raccourci clavier : `NVDA+contrôle+s` + +Le dialogue Synthétiseur, qui s'ouvre en activant le bouton Changer dans la catégorie Parole du dialogue Paramètres, permet de choisir le synthétiseur de parole qui sera utilisé par NVDA. +Une fois que vous aurez choisi votre synthétiseur, appuyez sur "OK" et NVDA chargera le synthétiseur choisi. +S'il y a une erreur au chargement du synthétiseur, NVDA vous en informera par un message, puis continuera à utiliser le synthétiseur précédent. + +##### Synthétiseur {#SelectSynthesizerSynthesizer} + +Cette option vous permet de choisir le synthétiseur de parole qui sera utilisé par NVDA. + +Pour une liste des synthétiseurs de parole pris en charge par NVDA, reportez-vous à la section [Synthétiseurs de parole pris en charge](#SupportedSpeechSynths). + +L'élément particulier "Pas de parole" apparaîtra toujours dans cette liste. +Cela peut être utile pour quelqu'un qui veut utiliser NVDA seulement avec le braille, ou peut-être pour un développeur voyant qui ne veut utiliser que la visionneuse de parole. + +#### Boucle des paramètres synthétiseur {#SynthSettingsRing} + +Si vous voulez changer rapidement les paramètres vocaux sans passer par la catégorie Voix du dialogue Paramètres, il y a quelques touches de commandes qui vous permettent de le faire de n'importe où quand NVDA est en fonction. + + +| Nom |Ordinateur de bureau |Ordinateur portable |Description| +|---|---|---|---| +|Aller au paramètre synthétiseur suivant |NVDA+contrôle+flèche droite |NVDA+contrôle+maj+flèche droite |Va au paramètre synthétiseur applicable suivant, retourne au premier après le dernier| +|Aller au paramètre synthétiseur précédent |NVDA+contrôle+flèche gauche |NVDA+contrôle+maj+flèche gauche |Va au paramètre synthétiseur applicable précédent, retourne au dernier après le premier| +|Augmenter le paramètre synthétiseur courant |NVDA+contrôle+flèche haut |NVDA+contrôle+maj+flèche haut |Augmente le paramètre synthétiseur sur lequel vous vous trouvez. Ex : augmente le débit, choisit la voix suivante, augmente le volume| +|Augmenter le paramètre courant dans la boucle des paramètres du synthétiseur d'un interval plus important |`NVDA+contrôle+pagePrec` |`NVDA+maj+contrôle+pagePrec` |Augmente d'un pas plus important la valeur du paramètre vocal courant sur lequel vous vous trouvez. Ex. lorsque vous êtes sur le paramètre du choix de la voix, avancer de 20 voix ; lorsque vous êtes sur un paramètres avec potentiomètre (débit, hauteur, etc.), la valeur sera incrémentée de 20%| +|Diminuer le paramètre synthétiseur courant |NVDA+contrôle+flèche bas |NVDA+contrôle+maj+flèche bas |diminue le paramètre synthétiseur sur lequel vous vous trouvez. Ex : diminue le débit, choisit la voix précédente, diminue le volume| +|Diminuer le paramètre courant dans la boucle des paramètres du synthétiseur d'un interval plus important |`NVDA+contrôle+pageSuiv` |`NVDA+maj+contrôle+pageSuiv` |Diminue d'un pas plus important la valeur du paramètre vocal courant sur lequel vous vous trouvez. Ex. lorsque vous êtes sur le paramètre du choix de la voix, reculer de 20 voix ; lorsque vous êtes sur un paramètres avec potentiomètre (débit, hauteur, etc.), la valeur sera décrémentée de 20%| + + + +#### Braille {#BrailleSettings} + +La catégorie Braille du dialogue Paramètres contient des options vous permettant de modifier différents aspect de la saisie et de l'affichage braille. +Cette catégorie contient les options suivantes : + +##### Changer de Terminal Braille {#BrailleSettingsChange} + +Dans la catégorie Braille du dialogue Paramètres, le bouton Changer... active le dialogue [Choix de l'Afficheur Braille](#SelectBrailleDisplay) qui vous permet de choisir l'afficheur braille actif. +Ce dialogue s'ouvre par-dessus le dialogue Paramètres. +Sauvegarder ouannuler les paramètres dans le dialogue de choix de l'afficheur braille vous ramènera au dialogue Paramètres. + +##### Table d'affichage {#BrailleSettingsOutputTable} + +L'option suivante est la liste déroulante des tables d'affichage. +Dans cette liste, vous trouverez des tables braille pour différentes langues, braille intégral, informatique, abrégé et autres. +La table choisie sera utilisée pour traduire le texte en braille qui sera présenté sur votre afficheur braille. +Vous pouvez vous déplacer de table en table en utilisant les flèches. + +##### Table de saisie {#BrailleSettingsInputTable} + +En complément de l'option précédente, l'option que vous trouverez ensuite est la liste déroulante des tables de saisie. +La table choisie sera utilisée pour traduire en texte le braille saisi à l'aide du clavier Perkins de votre afficheur braille. +Vous pouvez vous déplacer de table en table en utilisant les flèches. + +Notez que cette option n'est utile que si votre afficheur braille dispose d'un clavier Perkins et que le pilote de celui-ci supporte cette fonctionnalité. +Si la saisie n'est pas supportée par un afficheur qui dispose d'un clavier Perkins, cela sera noté dans la section [Afficheurs braille Supportés](#SupportedBrailleDisplays). + + + +##### Mode braille {#BrailleMode} + +Raccourci clavier : `NVDA+alt+t` + +Cette option vous permet de choisir entre les modes braille disponibles. + +Actuellement, deux modes braille sont pris en charge : "suivre les curseurs" et "afficher la parol". + +Lorsque suivre les curseurs est sélectionné, l'afficheur braille suivra soit le focus / le curseur système, soit l'objet navigateur / curseur de revue en fonction de ce que le braille doit suivre. + +Lorsque l'affichage de la parole est sélectionné, l'afficheur braille affichera ce que NVDA annonce, ou aurait annoncé si le mode de parole était réglé sur "parole activée". + +##### Afficher le mot sous le curseur en braille informatique {#BrailleSettingsExpandToComputerBraille} + +Cette option permet d'afficher le mot sous le curseur en intégral. + +##### Montrer le Curseur {#BrailleSettingsShowCursor} + +Cette option permet d'activer ou de désactiver l'affichage du curseur braille. +Elle s'applique au curseur système et au curseur de revue, mais pas à l'indicateur de sélection. + +##### Clignotement du Curseur {#BrailleSettingsBlinkCursor} + +Cette option permet au curseur braille de clignoter. +Si le clignotement est désactivé, le curseur braille sera constamment en position haute. +L'indicateur de sélection n'est pas affecté par cette option, c'est toujours les points 7 et 8 sans clignotement. + +##### Vitesse de clignotement du curseur (ms) {#BrailleSettingsBlinkRate} + +Cette option est un champ numérique qui vous permet de modifier la vitesse de clignotement du curseur en millisecondes. + +##### Forme du Curseur pour le Focus {#BrailleSettingsCursorShapeForFocus} + +Cette option vous permet de choisir la forme (combinaison de points) du curseur braille quand le braille suit le focus. +L'indicateur de sélection n'est pas affecté par cette option, c'est toujours les points 7 et 8 sans clignotement. + +##### Forme du Curseur pour la Revue {#BrailleSettingsCursorShapeForReview} + +Cette option vous permet de choisir la forme (combinaison de points) du curseur braille quand le braille suit la revue. +L'indicateur de sélection n'est pas affecté par cette option, c'est toujours les points 7 et 8 sans clignotement. + +##### Affichage des messages {#BrailleSettingsShowMessages} + +C'est une liste déroulante qui vous permet de choisir si NVDA doit afficher les messages en braille et quand ils doivent disparaître automatiquement. + +Pour basculer l'affichage des messages depuis n'importe où, veuillez attribuer un geste personnalisé à l'aide de la [boîte de dialogue Gestes de commandes](#InputGestures). + +##### Durée d'affichage des messages (sec) {#BrailleSettingsMessageTimeout} + +Cette option est un champ numérique qui contrôle la durée en secondes d'affichage des messages système sur le terminal braille. +Le message de NVDA est immédiatement supprimé à l'appui d'une touche de routage curseur sur l'afficheur braille, mais réapparaît à l'appui d'une touche correspondante qui déclenche le message. +Cette option n'apparaît que si "Affichage des message" est réglé sur "Définir une durée maximale". + + + +##### braille suit {#BrailleTether} + +Raccourci clavier : NVDA+contrôle+t + +Cette option vous permet de choisir si le braille suivra le curseur du focus système, le curseur de l'objet navigateur ou les deux. +Quand "automatiquement" est sélectionné, NVDA suivra le curseur système et le focus par défaut. +Dans ce cas, quand la position de l'objet de navigation ou du curseur de revue est modifiée par une action explicite de l'utilisateur, NVDA suivra temporairement la revue, jusqu'à ce que le focus ou le curseur système change. +Si vous voulez qu'il ne suive que le focus et le curseur, vous devez configurer le braille pour qu'il suive le focus. +Dans ce cas, le braille ne suivra pas le navigateur NVDA durant la navigation par objet ou le curseur de revue durant la revue. +Si vous voulez que le braille suive la navigation par objet et la revue de texte, vous devez configurer le braille pour qu'il suive la revue. +Dans ce cas, le braille ne suivra pas le focus système et le curseur système. + +##### Déplacer le curseur système lors du routage du curseur de revue {#BrailleSettingsReviewRoutingMovesSystemCaret} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Défaut (Jamais), Jamais, Seulement quand le braille suit automatiquement, Toujours| +|Défaut |Jamais| + +Ce paramètre détermine si le curseur système doit également être déplacé lors d'un appui sur une touche de routage du curseur. +Cette option est définie sur Jamais par défaut, ce qui signifie que le routage ne déplacera jamais le curseur système lors du routage du curseur de revue. + +Lorsque cette option est définie sur Toujours et que [Le braille suit](#BrailleTether) est défini sur "automatiquement" ou "la revue", un appui sur une touche de routage du curseur déplacera également le curseur système ou le focus lorsqu'il est pris en charge. +Lorsque le mode de revue actuel est [Revue de l'écran](#ScreenReview), il n'y a pas de curseur physique. +Dans ce cas, NVDA essaie de deplacer le focus à l'objet sous le texte vers lequel vous routez le curseur de revue. +Il en va de même pour le mode de [Revue par objet](#ObjectReview). + +Vous pouvez également définir cette option pour ne déplacer le curseur que lorsque "Le braille suit" est défini sur "automatiquement". +Dans ce cas, un appui sur une touche de routage du curseur ne déplacera le curseur système ou le focus que lorsque NVDA est automatiquement attaché au curseur de revue, alors qu'aucun mouvement ne se produira lorsqu'il sera manuellement attaché au curseur de revue. + +Cette option est uniquement active si "[Le braille suit](#BrailleTether)" est défini sur "automatiquement" ou sur "la revue". + +Pour parcourir les modes de déplacement du curseur système lors du routage du curseur de revue depuis n'importe où, veuillez attribuer un geste personnalisé à l'aide de la [boîte de dialogue Gestes de commandes](#InputGestures). + +##### Lecture par paragraphe {#BrailleSettingsReadByParagraph} + +Si cette option est activée, le braille sera affiché par paragraphe au lieu d'être affiché par ligne. +De la même manière, les commandes de ligne précédente et ligne suivante navigueront par paragraphe. +Cela signifie que vous n'aurez pas besoin de faire défiler l'afficheur à la fin de chaque ligne même si plus de texte peut entrer sur l'afficheur. +Cela permet une lecture plus fluide des textes volumineux. +Par défaut, cette option est désactivée. + +##### Ne pas couper les mots quand c'est possible {#BrailleSettingsWordWrap} + +Si cette option est activée, un mot trop long pour entrer à la fin de l'afficheur braille ne sera pas coupé. +À la place, il y aura des espaces à la fin de l'affichage. +En faisant défiler l'affichage, vous pourrez lire le mot entier. +Ceci est parfois appelé retour automatique à la ligne. +Notez que si le mot est trop long pour entrer sur l'afficheur, il devra quand-même être coupé. + +Si cette option est désactivée, le plus possible du mot sera affiché sur la ligne, mais le reste sera coupé. +En faisant défiler l'affichage, vous pourrez lire le reste du mot. + +Activer cette option peut rendre la lecture plus fluide mais vous obligera à faire défiler plus souvent. + +##### Normalisation Unicode {#BrailleUnicodeNormalization} +| . {.hideHeaderRow} |.| +|---|---| +|Options |Défaut (Désactivé), Activé, Désactivé| +|Défaut |Désactivé| + +Lorsque cette option est activée, la normalisation Unicode est appliqué au texte à afficher sur la plage braille. +Ceci est utile lorsque vous rencontrez des caractères en braille qui sont inconnus dans une table braille particulière et qui ont une alternative compatible, comme les caractères gras et italiques couramment utilisés sur les réseaux sociaux. +Les autres avantages de la normalisation Unicode sont expliqués plus en détail dans la [section relative au paramètre de parole équivalent](#SpeechUnicodeNormalization). + +Pour activer/désactiver la normalisation Unicode depuis n'importe où, veuillez assigner un geste personnalisé en utilisant le [dialogue des Gestes de Commandes](#InputGestures). + +##### Afficher le contexte du focus {#BrailleSettingsFocusContextPresentation} + +Cette option vous permet de choisir quelles informations contextuelles NVDA affiche en braille quand un objet prend le focus. +Les informations contextuelles font référence à la hiérarchie d'objets contenant le focus. +Par exemple, quand vous focalisez un élément de liste, celui-ci fait partie d'une liste. +Cette liste pourrait être contenue dans un dialogue, etc. +Veuillez consulter la section [navigation par objets](#ObjectNavigation) pour plus d'informations sur la hiérarchie qui s'applique aux objets dans NVDA. + +Quand l'option est sur "Seulement lors d'un changement de contexte", NVDA essaie d'afficher autant d'informations contextuelles que possible sur le terminal braille, mais seulement pour les parties du contexte qui ont changé. +Dans l'exemple ci-dessus, cela signifie que quand le focus est sur la liste, NVDA affiche l'élément de liste sur le terminal braille. +De plus, s'il y a assez de place libre sur le terminal braille, NVDA essaie de montrer que l'élément de liste fait partie d'une liste. +Si vous commencer à vous déplacer dans la liste avec les flèches, on suppose que vous savez que vous êtes toujours dans la liste +Ainsi, pour les autres éléments de la liste que vous focalisez, NVDA affiche seulement l'élément de liste focalisé sur le terminal. +Si vous voulez lire à nouveau le contexte (ex : si vous êtes dans une liste et que la liste fait partie d'un dialogue), vous devrez activer le défilement arrière de votre terminal braille. + +Quand l'option est sur "Toujours", NVDA essaie d'afficher autant d'informations contextuelles que possible sur le terminal braille, même si vous avez déjà vu les mêmes informations précédemment. +L'avantage est que NVDA essaie de mettre autant d'informations que possible sur le terminal. +Cependant, l'inconvénient est que le focus ne démarre pas toujours à la même position sur l'afficheur braille. +Cela peut rendre difficile le parcours d'une longue liste d'éléments, car vous devrez en permanence déplacer vos doigts pour trouver le début de chaque élément. +C'était le comportement par défaut jusqu'à NVDA 2017.2. + +Quand l'option est sur "Seulement lors du défilement arrière", NVDA ne montre jamais les informations contextuelles sur le terminal. +Ainsi, dans l'exemple ci-dessus, NVDA affiche l'élément de liste que vous avez focalisé. +Cependant, si vous voulez lire le contexte (ex : que vous êtes dans une liste et que la liste fait partie d'un dialogue), vous devrez activer le défilement arrière de votre terminal. + +Pour modifier l'option "Afficher le contexte du focus" depuis n'importe où, veuillez assigner un geste de commande personnalisé en utilisant [le dialogue Gestes de Commandes](#InputGestures). + +##### Interrompre la parole pendant le défilement {#BrailleSettingsInterruptSpeech} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Défaut (Activé), Activé, Désactivé| +|Défaut |Activé| + +Ce paramètre détermine si la parole doit être interrompue lorsque l'afficheur braille défile vers l'arrière/vers l'avant. +Les commandes de ligne précédente/suivante interrompent toujours la parole. + +La parole en cours peut être une distraction lors de la lecture du braille. +Pour cette raison, l'option est activée par défaut, interrompant la parole lors du défilement du braille. + +La désactivation de cette option permet d'entendre la parole tout en lisant simultanément le braille. + +##### Afficher la sélection {#BrailleSettingsShowSelection} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Défaut (Activé), Activé, Désactivé| +|Défaut |Activé| + +Ce réglage détermine si l'indicateur de sélection (points 7 et 8) s'affiche sur l'afficheur braille. +L'option est activée par défaut, donc l'indicateur de sélection est affiché. +L'indicateur de sélection peut être une distraction lors de la lecture. +La désactivation de cette option peut améliorer la lisibilité. + +Pour basculer l'affichage de la sélection depuis n'importe où, veuillez attribuer un geste personnalisé à l'aide de la [boîte de dialogue Gestes de commandes](#InputGestures). + +#### Choisir l'afficheur braille {#SelectBrailleDisplay} + + + +##### Ouvrir le dialogue de sélection de l'afficheur braille {#OpenSelectBrailleDisplay} + +Raccourci clavier : `NVDA+contrôle+a` + +Le dialogue Choisir l'Afficheur Braille, qui peut être ouvert en activant le bouton Changer... dans la catégorie Braille du dialogue Paramètres, vous permet de choisir l'afficheur Braille qui sera utilisé par NVDA. +Quand vous aurez choisi votre afficheur braille, vous pourrez presser le bouton OK et NVDA chargera l'afficheur sélectionné. +S'il y a une erreur au chargement du pilote de l'afficheur, NVDA vous avertira par un message et continuera à utiliser l'afficheur précédent si défini. + +##### Terminal braille {#SelectBrailleDisplayDisplay} + +Cette liste déroulante vous présente plusieurs options en fonction des pilotes d'afficheurs brailles présents sur votre système. +Déplacez-vous entre les options en utilisant les flèches. + +L'option automatique permet à NVDA de rechercher beaucoup de terminaux braille en arrière-plan. +Quand cette fonctionnalité est activée et que vous connectez un terminal braille supporté via USB ou Bluetooth, NVDA se connectera automatiquement à ce terminal. + +Pas de braille signifie que vous n'utilisez pas le braille. + +Reportez-vous à la section [Terminaux braille pris en charge](#SupportedBrailleDisplays) pour les informations concernant les terminaux braille et ceux qui supportent la détection automatique en arrière-plan. + +##### Afficheurs à détecter automatiquement {#SelectBrailleDisplayAutoDetect} + +Lorsque l'afficheur braille est réglé sur "Automatique", les cases à cocher de ce contrôle de liste vous permettent d'activer et de désactiver les pilotes d'affichage qui seront impliqués dans le processus de détection automatique. +Cela vous permet d'exclure les pilotes d'afficheur braille que vous n'utilisez pas régulièrement. +Par exemple, si vous possédez uniquement un terminal qui nécessite le pilote Baum pour fonctionner, vous pouvez laisser le pilote Baum activé tandis que les autres pilotes peuvent être désactivés. + +Par défaut, tous les pilotes prenant en charge la détection automatique sont activés. +Tout pilote ajouté, par exemple dans une future version de NVDA ou dans une extension, sera également activé par défaut. + +Veuillez consulter la documentation de votre plage braille dans la section [Afficheurs braille supportés](#SupportedBrailleDisplays) pour vérifier si le pilote prend en charge la détection automatique des afficheurs. + +##### Port {#SelectBrailleDisplayPort} + +Cette option, si disponible, vous permet de choisir quel port ou type de connexion sera utilisé pour communiquer avec l'afficheur braille sélectionné. +C'est une liste déroulante contenant les choix possibles pour votre afficheur braille. + +Par défaut, NVDA emploie la détection automatique, ce qui veut dire que la connexion avec le périphérique braille sera établie automatiquement en recherchant les périphériques USB et Bluetooth connectés à votre ordinateur. +De plus, pour certains afficheurs braille, vous pourrez choisir explicitement le port à utiliser. +Les options communes sont "automatique" (qui spécifie à NVDA d'employer la procédure par défaut), "USB", "Bluetooth" et port série si votre afficheur braille supporte ce type de communication. + +Cette option ne sera pas disponible si votre afficheur braille supporte seulement la détection automatique du port. + +Vous devrez consulter la documentation de votre afficheur braille dans la section [Afficheurs braille supportés](#SupportedBrailleDisplays) pour plus de détails sur les types de communications supportés et les ports disponibles. + +Note : Si vous connectez plusieurs Afficheurs Braille utilisant le même pilote en même temps à votre machine (Ex. connexion de deux afficheurs Seika), +il est actuellement impossible de dire à NVDA quel afficheur utiliser. +Par conséquent, il est recommandé de ne connecter qu'un seul afficheur braille d'un type/fabricant donné à votre machine à la fois. + +#### Audio {#AudioSettings} + + + +##### Ouvrir les paramètres audio {#OpenAudioSettings} + +Raccourci clavier : `NVDA+contrôle+u` + +La catégorie Audio du dialogue des Paramètres de NVDA contient des options qui vous permettent de modifier plusieurs aspects de la sortie audio. + +##### Sortie audio {#SelectSynthesizerOutputDevice} + +Cette option vous permet de choisir le périphérique audio par lequel NVDA doit indiquer au synthétiseur sélectionné de parler. + + + +##### Mode d'Atténuation Audio {#SelectSynthesizerDuckingMode} + +Raccourci clavier : `NVDA+maj+d` + +Cette option vous permet de choisir si NVDA doit baisser le volume des autres applications quand il parle, ou tout le temps quand il est en cours d'exécution. + +* Ne jamais atténuer : NVDA ne baissera jamais le volume des autres applications. +* Atténuer les autres sources quand NVDA parle : NVDA ne baissera le son des autres applications que quand il parle ou émet un son. Ceci peut ne pas fonctionner avec tous les synthétiseurs. +* Toujours atténuer : NVDA réduira le son des autres applications tout le long de son exécution. + +Cette option n'est disponible que si NVDA a été installé. +Il n'est pas possible de supporter l'atténuation audio pour les versions portables et temporaires de NVDA. + +##### Le volume des sons NVDA suit le volume de la voix {#SoundVolumeFollowsVoice} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Désactivé, Activé| +|Défaut |Désactivé| + +Lorsque cette option est activée, le volume des sons et des bips de NVDA suivra le réglage du volume de la voix que vous utilisez. +Si vous diminuez le volume de la voix, le volume des sons diminuera. +De même, si vous augmentez le volume de la voix, le volume des sons augmentera. +Cette option n'est pas disponible si vous avez démarré NVDA avec [WASAPI désactivé pour la sortie audio](#WASAPI) dans les Paramètres avancés. + +##### Volume des sons NVDA {#SoundVolume} + +Ce potentiomètre vous permet de régler le volume des sons et des bips de NVDA. +Ce paramètre ne prend effet que lorsque "Le volume des sons NVDA suit le volume de la voix" est désactivé. +Cette option n'est pas disponible si vous avez démarré NVDA avec [WASAPI désactivé pour la sortie audio](#WASAPI) dans les Paramètres avancés. + +##### Séparation du son {#SelectSoundSplitMode} + +La fonction de séparation du son permet aux utilisateurs d'utiliser leurs périphériques de sortie stéréo, tels que des écouteurs et des haut-parleurs. +La séparation du son permet d'avoir la parole de NVDA sur un canal (par exemple gauche) et de faire en sorte que toutes les autres applications diffusent leur son sur l'autre canal (par exemple droit). +Par défaut, la séparation du son est désactivée. +Un geste de commande permet de parcourir les différents modes de séparation du son : + + +| Nom |Touche |Description| +|---|---|---| +|Faire défiler les modes de séparation du son |`NVDA+alt+s` |Passer d'un mode de séparation du son à l'autre.| + + + +Par défaut, cette commande alternera entre les modes suivants : + +* Séparation du son désactivée : NVDA n'applique aucun traitement de séparation du son. +* NVDA à gauche et applications à droite : NVDA parlera dans le canal de gauche, tandis que les autres applications diffuseront leur son dans le canal de droite. +* NVDA à gauche et applications dans les deux canaux : NVDA parlera dans le canal de gauche, tandis que les autres applications diffuseront leur son dans les deux canaux, gauche et droit. + +Il existe des modes de séparation du son plus avancés disponibles dans la liste déroulante des paramètres NVDA. +Parmi ces modes, le mode "NVDA dans les deux canaux et applications dans les deux canaux" force tous les sons à être dirigés dans les deux canaux. +Ce mode peut différer du mode "Séparation du son désactivé" dans le cas où un autre traitement audio interférerait avec les volumes des canaux. + +Veuillez noter que le séparateur de son ne fonctionne pas comme un mélangeur audio. +Par exemple, si une application joue une piste audio stéréo alors que la séparation du son est définie sur "NVDA à gauche et applications à droite", alors vous n'entendrez que le canal droit de la piste audio, tandis que le canal gauche de la piste sera mis en sourdine. + +Cette option n'est pas disponible si vous avez démarré NVDA avec [WASAPI désactivé pour la sortie audio](#WASAPI) dans les Paramètres avancés. + +Veuillez noter que si NVDA plante, il ne sera pas en mesure de restaurer le volume sonore des applications et il se pourrait que ces applications continuent à diffuser leur son sur un seul canal après le crash de NVDA. +Pour corriger ce problème, veuillez redémarrer NVDA et sélectionner le mode "NVDA dans les deux canaux et applications dans les deux canaux". + +##### Personnalisation des modes de séparation du son {#CustomizeSoundSplitModes} + +Cette liste de cases à cocher permet de sélectionner quels modes de séparation du son sont inclus lors du passage de l'un à l'autre en utilisant `NVDA+alt+s`. +Les modes non cochés sont exclus. +Par défaut, seuls trois modes sont inclus. + +* Séparation du son désactivée : NVDA et les applications diffusent des sons dans les canaux gauche et droit. +* NVDA à gauche et applications à droite. +* NVDA à gauche et applications dans les deux canaux. + +Veuillez noter qu'il est nécessaire de cocher au moins un mode. +Cette option n'est pas disponible si vous avez démarré NVDA avec [WASAPI désactivé pour la sortie audio](#WASAPI) dans les Paramètres avancés. + +##### Durée de maintien en éveil du périphérique audio après la parole {#AudioAwakeTime} + +Cette zone d'édition spécifie combien de temps NVDA maintient le périphérique audio en éveil après la fin de la parole. +Cela permet à NVDA d'éviter certains problèmes de parole comme des parties de mots coupées. +Cela peut se produire lorsque des appareils audio (en particulier les appareils Bluetooth et sans fil) passent en mode veille. +Cela peut également être utile dans d'autres cas d'utilisation, par exemple lors de l'exécution de NVDA dans une machine virtuelle (par exemple Citrix Virtual Desktop) ou sur certains ordinateurs portables. + +Des valeurs faibles peuvent provoquer une coupure de l'audio plus souvent, car un appareil peut passer en mode veille trop tôt, provoquant ainsi une coupure du début de la parole suivante. +Une valeur trop élevée peut entraîner une décharge plus rapide de la batterie du périphérique de sortie audio, car il reste active plus longtemps alors qu'aucun son n'est envoyé. + +Vous pouvez mettre cette durée à zéro afin de désactiver cette fonctionnalité. + +#### Vision {#VisionSettings} + +La catégorie Vision du dialogue des paramètres NVDA vous permet d'activer, désactiver et configurer les [aides visuelles](#Vision). + +Notez que les options disponibles dans cette catégorie pourraient être étendues par des [extensions NVDA](#AddonsManager). +Par défaut, cette catégorie de paramètres contient les options suivantes : + +##### Mise en Évidence Visuelle {#VisionSettingsFocusHighlight} + +Les cases à cocher du groupe Mise en Évidence Visuelle contrôlent le comportement de la fonctionnalité interne de [Mise en Évidence Visuelle](#VisionFocusHighlight)de NVDA. + +* Activer la mise en évidence: Active/désactive la mise en évidence visuelle. +* Mettre en évidence le focus système : définit si le [focus système](#SystemFocus) sera mis en évidence. +* Mettre en évidence l'objet navigateur : définit si [l'objet navigateur](#ObjectNavigation) sera mis en évidence. +* Mettre en évidence le curseur du mode navigation : Définit si le [Curseur virtuel du mode navigation](#BrowseMode) sera mis en évidence. + +Notez que cocher ou décocher la case "Activer la Mise en évidence" changera également l'état des trois autres cases à cocher en conséquence. +Ainsi, si "Activer la Mise en évidence" n'est pas cochée et que vous la cochez, les trois autres cases seront cochées automatiquement. +Si vous voulez mettre en évidence seulement le focus et laisser les cases objet navigateur et mode navigation non cochées, l'état de la case "Activer la mise en évidence" sera semicoché. + +##### Le Rideau d'Écran {#VisionSettingsScreenCurtain} + +Vous pouvez activer le [Rideau d'Écran](#VisionScreenCurtain) en cochant la case "Rendre l'écran noir (effet immédiat)". +Un avertissement indiquant que l'écran deviendra noir après activation sera alors affiché +Avant de continuer (en sélectionnant "Oui"), vérifiez que vous avez activé la parole ou le braille et que vous serez capable de contrôler votre ordinateur sans utiliser l'écran. +Sélectionnez "Non" si vous ne souhaitez plus activer le Rideau d'Écran. +Si vous êtes sûr, vous pouvez choisir le bouton Oui pour activer le Rideau d'Écran. +Si vous ne voulez plus voir cet avertissement à chaque fois, vous pouvez changer ce comportement dans le dialogue qui affiche le message. +Vous pouvez toujours restaurer l'avertissement en cochant la case "Toujours afficher un avertissement au chargement du Rideau d'Écran" à côté de la case "Rendre l'écran noir". + +Par défaut, des sons sont émis quand le Rideau d'Écran est activé ou désactivé. +Si vous souhaitez changer ce comportement, vous pouvez décocher la case " Émettre un son lors du basculement du rideau d'écran ". + +##### Paramètres des aides visuelles tierses {#VisionSettingsThirdPartyVisualAids} + +Des services d'aide visuelle additionnels peuvent être fournis dans des [Extensions NVDA](#AddonsManager). +Si ces services ont des paramètres ajustables, ils seront affichés dans cette catégorie de paramètres dans des groupes séparés. +Pour les paramètres supportés par un service, veuillez vous référer à la documentation pour ce service. + +#### Clavier {#KeyboardSettings} + + + +##### Ouvrir les paramètres Clavier {#OpenKeyboardSettings} + +Raccourci clavier : `NVDA+contrôle+k` + +La catégorie Clavier du dialogue Paramètres de NVDA contient des options qui définissent le comportement de NVDA quand vous utilisez ou tapez sur votre clavier. +Cette catégorie de paramètres contient les options suivantes : + +##### Configuration du clavier {#KeyboardSettingsLayout} + +Cette liste déroulante vous permet de choisir la configuration de clavier utilisée par NVDA. Actuellement, les deux configurations fournies avec NVDA sont : Desktop (ordinateur de bureau) et Laptop (ordinateur portable). + +##### Choisir les Touches NVDA {#KeyboardSettingsModifiers} + +Les cases à cocher de cette liste contrôlent quelles touches peuvent être utilisées comme [touches NVDA](#TheNVDAModifierKey). Vous pouvez choisir parmi les touches suivantes : + +* La touche Verrouillage Majuscule +* La touche insertion du pavé numérique +* La touche insertion étendue (elle se trouve généralement au-dessus des flèches, près de début et fin) + +Si aucune touche n'est choisie pour être la touche NVDA, il peut être impossible d'accéder à de nombreuses commandes de NVDA, vous devez donc cocher au moins une des touches. + + + +##### Écho clavier par caractère {#KeyboardSettingsSpeakTypedCharacters} + +Raccourci clavier : NVDA+2 + +Quand cette case est cochée, NVDA prononcera chaque caractère tapé au clavier. + + + +##### Écho clavier par mot {#KeyboardSettingsSpeakTypedWords} + +Raccourci clavier : NVDA+3 + +Quand cette case est cochée, NVDA prononcera chaque mot tapé au clavier. + +##### Interruption de la parole à la frappe d'un caractère {#KeyboardSettingsSpeechInteruptForCharacters} + +Si cette option est activée, la parole sera interrompue à chaque fois qu'un caractère est saisi. Cette option est activée par défaut. + +##### Interruption de la parole à l'appui de la touche Entrée {#KeyboardSettingsSpeechInteruptForEnter} + +Si cette option est activée, la parole sera interrompue à chaque fois que la touche "Entrée" est appuyée. Cette option est activée par défaut. + +##### Permettre le survol en mode dire tout {#KeyboardSettingsSkimReading} + +Si cette option est activée, certaines commandes de navigation (telles que les touches de navigation rapide en mode navigation ou l'exploration par ligne ou par paragraphe) n'arrêtent pas dire tout, qui reprend plutôt la lecture à la nouvelle position. + +##### Émettre un bip à la frappe d'un caractère minuscule quand le verrouillage majuscule est activé {#KeyboardSettingsBeepLowercase} + +Quand cette case est cochée, on entend un bip d'avertissement si on entre une lettre en combinaison avec la touche Majuscule alors que le Verrouillage Majuscule est activé. +Généralement, la frappe des lettres en majuscule quand les Majuscules sont verrouillées n'est pas intentionnelle et est généralement due au fait qu'on a oublié que la touche Majuscule est activée. +Cela peut donc être utile d'en être averti. + + + +##### Dire les touches de commandes {#KeyboardSettingsSpeakCommandKeys} + +Raccourci clavier : NVDA+4 + +Quand cette case est cochée, NVDA annonce, lors de leur frappe, toutes les touches ne correspondant pas à des caractères. Ceci inclut les combinaisons de touches telles que "contrôle" plus une autre lettre. + +##### Jouer un son pour les fautes d'orthographe durant la frappe {#KeyboardSettingsAlertForSpellingErrors} + +Quand cette option est activée, un court son de vibreur sera émis quand un mot que vous frappez contient une faute d'orthographe. +Cette option n'est disponible que si l'annonce des fautes d'orthographe est activée dans [Mise en Forme des Documents](#DocumentFormattingSettings) qui se trouve dans le dialogue Paramètres de NVDA. + +##### Exécuter les touches d'autres applications {#KeyboardSettingsHandleKeys} + +Cette option permet à l'utilisateur de choisir si les combinaisons de touches générées par des applications telles que les claviers à l'écran et les logiciels de reconnaissance vocale doivent être traitées par NVDA. +Cette option est activée par défaut, mais certains utilisateurs souhaiteraient la désactiver, comme ceux tapant en vietnamien avec le logiciel de dactylographie UniKey, car cela causerait la saisie de caractères incorrects. + +#### Souris {#MouseSettings} + + + +##### Ouvrire les paramètres de souris {#OpenMouseSettings} + +Raccourci clavier : `NVDA+contrôle+m` + +La catégorie Souris du dialogue Paramètres de NVDA permet de définir le mode de suivi de la souris par NVDA, de sonoriser les coordonnées de la souris par des bips et de définir d'autres options d'utilisation de la souris. +Elle contient les options suivantes : + +##### Annoncer les changements de forme de la souris {#MouseSettingsShape} + +Quand cette case est cochée, NVDA annonce la forme du pointeur souris chaque fois qu'elle change. +Sous Windows, le pointeur de souris change de forme pour transmettre certaines informations comme indiquer que quelque chose devient modifiable, ou que quelque chose est en train de se charger, etc. + + + +##### Activer le suivi de la souris {#MouseSettingsTracking} + +Raccourci clavier : NVDA+m + +Quand cette case est cochée, NVDA annonce le texte présent sous le pointeur souris, lorsqu'on la déplace sur l'écran. Cela vous permet de trouver un objet sur l'écran en déplaçant la souris au lieu de recourir à la navigation par objet. + +##### Résolution d'unités de texte {#MouseSettingsTextUnit} + +Si NVDA est configuré pour annoncer le texte sous la souris quand vous la déplacez, cette option vous permet de choisir précisément la quantité de texte qui sera lue. +Les options sont caractère, mot, ligne ou paragraphe. + +Pour activer la résolution d'unités de texte depuis n'importe où, veuillez assigner un geste de commande personnalisé en utilisant le dialogue [Gestes de Commandes](#InputGestures). + +##### Annoncer l'objet quand la souris y entre {#MouseSettingsRole} + +Quand cette case est cochée, NVDA annonce des informations sur les objets quand la souris y entre. +Cela comprend le rôle (type) de l'objet ainsi que les états (coché/appuyé), les coordonnées des cellules dans les tableaux, etc. +Veuillez Noter que l'annonce de certains détails d'objet peut dépendre de la façon dont d'autres paramètres sont définis, tels que les paramètres dans les catégories [Présentation des objets](#ObjectPresentationSettings) ou [Mise en Forme des Documents](#DocumentFormattingSettings). + +##### Sonoriser les coordonnées quand la souris se déplace {#MouseSettingsAudio} + +Quand cette case est cochée, NVDA émet des bips quand la souris se déplace, pour que l'utilisateur puisse se figurer la position de la souris sur l'écran. +Plus la souris est haut sur l'écran, plus la fréquence des bips est élevée. +Plus la souris est à gauche ou à droite sur l'écran, plus le son sera émis à gauche ou à droite, dans la mesure où l'utilisateur possède des haut-parleurs ou un casque stéréophoniques. + +##### La brillance modifie le volume des coordonnées audio {#MouseSettingsBrightness} + +Si la case "Sonoriser les coordonnées quand la souris se déplace" est cochée, le volume des bips variera en fonction de la brillance de la zone sous le pointeur de la souris. +Cette case est décochée par défaut. + +##### Ignorer les entrées souris d'autres applications {#MouseSettingsHandleMouseControl} + +Cette option permet à l'utilisateur d'ignorer les événements relatifs à la souris (incluant le déplacement et l'appui sur les boutons) générés par d'autres applications telles que TeamViewer et autres logiciels de contrôle à distance. +Cette option est décochée par défaut. +Si vous cochez cette option et que l'option "suivi de la souris" est activée, NVDA n'annoncera pas ce qui est sous la souris si la souris est déplacée par une autre application. + +#### Interaction tactile {#TouchInteraction} + +Cette catégorie, disponible seulement sur un ordinateur possédant des capacités tactiles, vous permet de configurer la manière dont NVDA interagit avec l'écran tactile. +Elle contient les options suivantes : + +##### Activer le support d'interaction tactile {#TouchSupportEnable} + +Cette case à cocher active le support d'interaction tactile de NVDA. +Quand il est activé, vous pouvez utiliser vos doigts pour naviguer et interagir avec les éléments sur l'écran en utilisant un écran tactile. +Quand il est désactivé, le support d'écran tatile est désactivé tant que NVDA est en cours d'exécution. +Ce paramètre peut aussi être activé/désactivé en utilisant NVDA+contrôle+alt+t. + +##### Mode de frappe tactile {#TouchTypingMode} + +Cette case à cocher vous permet d'indiquer la méthode que vous désirez utiliser pour saisir du texte avec le clavier tactile. +Quand elle est cochée, quand vous repérez une touche sur le clavier tactile, vous pouvez retirer votre doigt et la touche sélectionnée sera pressée. +Quand elle est décochée, vous devez double-taper sur la touche du clavier tactile pour la presser. + +#### Curseur de revue {#ReviewCursorSettings} + +La catégorie Curseur de Revue du dialogue Paramètres de NVDA sert à configurer le comportement du curseur de revue de NVDA. +Elle contient les options suivantes : + + + +##### Suivre le focus système {#ReviewCursorFollowFocus} + +Raccourci clavier : NVDA+7 + +Quand cette option est activée, le curseur de revue est toujours placé dans le même objet que le focus système quand il change. + + + +##### Suivre le curseur système {#ReviewCursorFollowCaret} + +Raccourci clavier : NVDA+6 + +Quand l'option est activée, le curseur de revue suit les mouvements du curseur système. + +##### Suivre le curseur souris {#ReviewCursorFollowMouse} + +Quand l'option est activée, le curseur de revue suit les mouvements de la souris. + +##### Mode de revue simple {#ReviewCursorSimple} + +Quand l'option est activée, NVDA filtre la hiérarchie des objets que l'on peut atteindre, excluant les objets sans intérêt pour l'utilisateur ; Ex : les objets invisibles et les objets utilisés seulement à des fins de présentation. + +Pour activer ou désactiver le mode de revue simple depuis n'importe où, veuillez lui assigner un geste de commande personnalisé en utilisant le [dialogue Gestes de Commandes](#InputGestures). + +#### Présentation des objets {#ObjectPresentationSettings} + + + +##### Ouvrir les paramètres de présentation des objets {#OpenObjectPresentationSettings} + +Raccourci clavier : `NVDA+contrôle+o` + +La catégorie Présentation des Objets du dialogue Paramètres de NVDA sert à définir la quantité d'informations annoncées par NVDA pour les contrôles tels que leur description, leur position etc. +Ces options ne s'appliquent généralement pas au mode navigation. +Elles s'appliquent généralement aux annonces de focus et à la navigation par objets de NVDA, mais pas à la lecture de contenu textuel, par ex. mode navigation. + +##### Annoncer les suggestions {#ObjectPresentationReportToolTips} + +Quand cette case est cochée, NVDA annonce les suggestions à leur apparition. +De nombreuses fenêtres et commandes font apparaître un court message (ou suggestion) lorsqu'on y déplace la souris ou le focus. + +##### Annoncer les notifications {#ObjectPresentationReportNotifications} + +Quand cette case est cochée, NVDA annonce les bulles d'aide et les notifications d'invitation à leur apparition. + +* Les bulles d'aide sont semblables aux suggestions mais généralement de plus grande taille, et sont associées à des évènements système tels que le débranchement d'un câble réseau, ou bien des alertes relatives à la sécurité. +* Les notifications d'invitation ont été introduites dans Windows 10 et apparaissent dans le centre de notification dans la barre d'état système, informant sur divers événements (ex : une mise à jour a été téléchargée, un ouveau courriel est arrivé dans votre boîte de réception, etc.). + +##### Annoncer les raccourcis clavier des objets {#ObjectPresentationShortcutKeys} + +Quand cette case est cochée, NVDA inclut, à l'annonce d'un objet ou d'une commande, le raccourci clavier qui lui est associé. +Par exemple, le menu "Fichier" d'une barre de menu peut avoir pour raccourci clavier Alt+f. + +##### Annoncer le rang de l'objet dans une liste {#ObjectPresentationPositionInfo} + +Cette option vous permet de choisir si vous voulez connaître le rang de l'objet dans une liste (ex : 1 sur 4) annoncé quand vous allez sur un objet au moyen du focus ou de la navigation par objet. + +##### Deviner le rang de l'objet quand l'information n'est pas disponible {#ObjectPresentationGuessPositionInfo} + +Si l'annonce du rang de l'objet dans une liste est activée, cette option autorise NVDA à deviner le rang de l'objet si cette information n'est pas disponible pour un objet particulier. + +Quand l'option est activée, NVDA annonce le rang pour un plus grand nombre de contrôles tels que les menus et les barres d'outils. Cependant, cette information peut parfois être inexacte. + +##### Annonce de la description des objets {#ObjectPresentationReportDescriptions} + +Décochez cette case si vous pensez que vous n'avez pas besoin d'entendre leur description annoncée avec les objets. + + + +##### Suivi des barres de progression {#ObjectPresentationProgressBarOutput} + +Raccourci clavier : NVDA+u + +Cette option vous présente une liste déroulante qui contrôle la manière dont NVDA vous annonce l'évolution des barres de progression. + +Elle propose les options suivantes : + +* Désactivé : L'évolution des barres de progression ne sera pas annoncée. +* Vocal : Cette option dit à NVDA d'annoncer l'évolution des barres de progression en pourcentage. Chaque fois que la barre changera, NVDA dira la nouvelle valeur. +* Par des bips : Cette option dit à NVDA d'émettre un bip à chaque évolution de la barre de progression. Plus le bip est aigu, plus on approche de la fin de la barre. +* Vocal avec des bips : Cette option dit à NVDA de parler et d'émettre des bips lors de la mise à jour de la barre de progression. + +##### Suivre les barres de progression en arrière-plan {#ObjectPresentationReportBackgroundProgressBars} + +Quand cette case est cochée, NVDA annonce les barres de progression même si elles ne sont pas physiquement sur la fenêtre en avant-plan. +Si vous minimisez ou quittez une fenêtre qui contient une barre de progression, NVDA continuera à la surveiller, vous permettant de faire autre chose pendant ce temps. + + + +##### Annoncer les changements de contenu dynamiques {#ObjectPresentationReportDynamicContent} + +Raccourci clavier : NVDA+5 + +Active ou désactive l'annonce d'un nouveau contenu en particulier dans les applications telles que les terminaux ou l'historique des programmes de tchat. + +##### Jouer un son quand une autosuggestion apparaît {#ObjectPresentationSuggestionSounds} + +Active/désactive l'annonce de l'apparition des autosuggestions, si activé, NVDA jouera un son pour l'indiquer. +Les autosuggestions sont des listes de saisies suggérées basées sur le texte entré dans certains champs de saisie et documents. +Par exemple, quand vous entrez du texte dans la boîte de recherche du menu démarrer de Windows Vista et au-delà, Windows affiche une liste de suggestions basée sur ce que vous avez entré. +Pour certains champs d'édition comme le champ de recherche dans diverses applications Windows 10, NVDA peut vous signaler qu'une liste de suggestions est apparue quand vous tapez du texte. +La liste de suggestions se ferme quand vous quittez le champ d'édition, et pour certains champs, NVDA peut vous en avertir quand ça arrive. + +#### Composition de saisie {#InputCompositionSettings} + +La catégorie Composition de la Saisie permet de contrôler comment NVDA annonce la saisie des caractères asiatiques, avec IME ou les services de texte et langue d'entrée. +Notez que, comme les méthodes de saisie varient considérablement selon les fonctions disponibles et la façon dont elles transmettent l'information, il sera probablement nécessaire de configurer ces options différemment pour chaque méthode de saisie, pour obtenir la meilleure expérience de saisie possible. + +##### Annonce automatique de toutes les suggestions disponibles {#InputCompositionReportAllCandidates} + +Cette option, activée par défaut, permet de choisir si oui ou non toutes les suggestions visibles doivent être automatiquement rapportées quand une liste de suggestions apparaît ou quand sa page change. +Activer cette option sur les méthodes d'entrée pictographiques telles que chinois Nouveau ChangJie ou Boshiami est utile car vous pouvez entendre automatiquement tous les symboles et leurs numéros, et vous pouvez en choisir un tout de suite. +Toutefois, pour les méthodes de saisie phonétique comme le nouveau chinois phonétique, il peut être plus utile de désactiver cette option puisque tous les symboles ont les mêmes sons et vous devrez utiliser les touches fléchées pour naviguer dans les éléments de la liste individuellement pour obtenir plus d'informations de la description de caractères pour chaque suggestion. + +##### Annoncer la suggestion sélectionnée {#InputCompositionAnnounceSelectedCandidate} + +Cette option, activée par défaut, vous permet de choisir si NVDA doit ou non annoncer la suggestion sélectionnée lorsqu'une liste de suggestions apparaît ou quand la sélection est changée. +Pour les méthodes où la suggestion peut être changée en utilisant les flèches (comme chinois nouveau phonétique) cela est nécessaire, cependant pour certaines méthodes il est préférable de désactiver cette option. +Notez que même si cette option est désactivée, le curseur de revue se placera toujours sur la suggestion sélectionnée, vous permettant toujours d'utiliser la navigation par objet ou le curseur de revue pour sélectionner la suggestion. + +##### Toujours inclure une description courte du caractère pour les suggestions {#InputCompositionCandidateIncludesShortCharacterDescription} + +Cette option, activée par défaut, permet de choisir si oui ou non NVDA doit fournir une description courte de chaque caractère d'une suggestion, quand elle est sélectionnée ou lors de la lecture de la liste quand elle apparaît. +Notez que pour les langues comme le chinois, l'annonce des descriptions de caractères supplémentaires pour la suggestion sélectionnée n'est pas affectée par cette option. +Cette option est utile pour les méthodes d'entrées coréennes et japonaises. + +##### Annonce les changements dans la chaîne en cours de lecture {#InputCompositionReadingStringChanges} + +Certains modes de saisie tels que le chinois ChangJie phonétique et Nouveau ChangJie peuvent avoir une chaîne de lecture (parfois connu sous le nom de chaîne de précomposition). +Avec cette option, vous pouvez choisir si oui ou non NVDA doit annoncer les nouveaux caractères saisis dans la chaîne de lecture en cours. +Cette option est activée par défaut. +Notez que certaines anciennes méthodes comme le chinois ChangJie n'utilisent pas la chaîne en cours de lecture pour les caractères de précomposition, utilisez directement la chaîne de composition. Voyez l'option suivante pour configurer l'annonce de la chaîne de composition. + +##### Annoncer les changements dans la chaîne de composition {#InputCompositionCompositionStringChanges} + +Après que les données de lecture ou de précomposition ont été combinées en un symbole pictographique valide, la plupart des méthodes d'entrée placent ce symbole dans une chaîne de composition pour stocker temporairement avec les autres symboles combinés avant de les insérer dans le document. +Cette option permet de choisir si oui ou non NVDA doit annoncer tous les symboles quand ils apparaissent dans la chaîne de composition. +Cette option est activée par défaut. + +#### Mode navigation {#BrowseModeSettings} + + + +##### Ouvrir les paramètres du mode navigation {#OpenBrowseModeSettings} + +Raccourci clavier : `NVDA+contrôle+b` + +La catégorie Mode Navigation du dialogue Paramètres de NVDA sert à configurer le comportement de NVDA quand vous naviguez dans des documents complexes tels que des pages web. +Elle contient les options suivantes : + +##### Nombre maximum de caractères par ligne {#BrowseModeSettingsMaxLength} + +Ce champ définit, en nombre de caractères, la longueur maximum d'une ligne en mode navigation. + +##### Nombre maximum de lignes par page {#BrowseModeSettingsPageLines} + +Ce champ définit le nombre de lignes dont on se déplace par appui sur "Page Précédente" ou "Page Suivante" en mode navigation. + + + +##### Utiliser la disposition telle qu'à l'écran {#BrowseModeSettingsScreenLayout} + +Raccourci clavier : NVDA+v + +Cette option vous permet de spécifier si le mode navigation doit placer le contenu cliquable (liens, boutons et champs) sur sa propre ligne, ou s'il doit le conserver dans le flux du texte tel qu'il est affiché visuellement. +Notez que cette option ne concerne pas les applications Microsoft Office telles qu'Outlook et Word, qui utilisent toujours la disposition telle qu'à l'écran. +Lorsque la disposition telle qu'à l'écran est activée, les éléments de la page restent tels qu'ils sont affichés visuellement. +Par exemple, une ligne visuelle de plusieurs liens sera présentée vocalement et en braille comme plusieurs liens sur la même ligne. +S'il est désactivé, les éléments de la page seront placés sur leurs propres lignes. +Ceci peut être plus facile à comprendre lors de la navigation ligne par ligne dans la page et peut faciliter l'interaction avec les éléments pour certains utilisateurs. + +##### Activer le mode navigation au chargement de la page {#BrowseModeSettingsEnableOnPageLoad} + +Cette case à cocher permet de choisir si le mode navigation doit être activé automatiquement au chargement d'une page. +Quand cette option est désactivée, le mode navigation peut quand-même être activé manuellement sur les pages ou documents où il est supporté. +Veuillez consulter la section [Mode navigation](#BrowseMode) pour avoir une liste des applications supportées par le mode navigation. +Notez que cette option ne s'applique pas aux situations où le mode navigation est toujours optionnel, par exemple sous Microsoft Word. +Cette option est activée par défaut. + +##### Dire tout automatiquement au chargement des pages {#BrowseModeSettingsAutoSayAll} + +Cette case à cocher active ou désactive la lecture automatique des pages après leur chargement en mode navigation. +Cette option est activée par défaut. + +##### Annoncer les tables de disposition {#BrowseModeSettingsIncludeLayoutTables} + +Cette option affecte la façon dont NVDA gère les tableaux utilisées uniquement à des fins de mise en page. +Lorsqu'elle est activée, NVDA les traitera comme des tableaux normaux en les annonçant en fonction des [Paramètres de Mise en forme des documents](#DocumentFormattingSettings) et en les localisant par les commandes de navigation rapides. +Lorsqu'elle est désactivée, ces tableaux ne seront ni annoncés ni trouvés par la navigation rapide. +Cependant, le contenu des tableaux sera toujours inclus sous forme de texte normal. +Cette option est désactivée par défaut. + +Pour activer/désactiver l'inclusion des tables de disposition depuis n'importe où, veuillez assigner un geste personnalisé en utilisant [le dialogue Gestes de commandes](#InputGestures). + +##### Configurer l'annonce de champs tels que liens et titres {#BrowseModeLinksAndHeadings} + +Veuillez consulter les options dans [Mise en forme des Documents](#DocumentFormattingSettings) du dialogue [Paramètres de NVDA](#NVDASettings) pour configurer les champs qui sont annoncés durant la navigation tels que les liens, les titres et les tableaux. + +##### Mode formulaire automatique au changement de focus {#BrowseModeSettingsAutoPassThroughOnFocusChange} + +Cette option permet au mode formulaire d'être invoqué au changement de focus. +Par exemple, dans une page web, si vous tabulez et arrivez sur un formulaire : si cette option est cochée, le mode formulaire sera automatiquement activé. + +##### Mode formulaire automatique au déplacement du curseur {#BrowseModeSettingsAutoPassThroughOnCaretMove} + +Cette option, quand elle est cochée, permet à NVDA d'activer ou désactiver le mode formulaire quand on se déplace avec les flèches. +Par exemple, si vous naviguez dans une page web avec les flèches et que vous arrivez sur une zone d'édition, NVDA passera automatiquement en mode formulaire. +Si vous sortez de la zone d'édition, le mode formulaire sera automatiquement désactivé. + +##### Indication audio du mode formulaire ou navigation {#BrowseModeSettingsPassThroughAudioIndication} + +Si cette option est activée, NVDA émettra des sons particuliers au passage du mode formulaire au mode navigation plutôt que d'annoncer le changement verbalement. + +##### Empêcher les gestes ne correspondant pas à des commandes d'atteindre le document {#BrowseModeSettingsTrapNonCommandGestures} + +Activée par défaut, cette option vous permet de choisir si des gestes (tels que l'appui sur des touches) qui ne déclenchent pas une commande NVDA et ne sont pas considérés comme une commande en général, devraient être interceptés pour ne pas interagir avec le document actuellement en focus. +Par exemple, si l'option est activée, si la lettre j est pressée, elle sera interceptée pour ne pas atteindre le document, même si ce n'est ni une touche de navigation rapide ni une commande dans l'application elle-même. +Dans ce cas NVDA demandera à Windows de jouer un son par défaut quand une touche interceptée est pressée. + + + +##### Amener automatiquement le focus système aux éléments focalisables {#BrowseModeSettingsAutoFocusFocusableElements} + +Raccourci clavier : NVDA+8 + +Désactivée par défaut, cette option vous permet de choisir si le focus système doit être automatiquement positionné aux éléments pouvant prendre le focus système (liens, champs de saisie, etc.) quand on parcourt le contenu avec le curseur de mode navigation. +Laisser cette option désactivée ne focalisera pas automatiquement les éléments focalisables quand ils seront sélectionnés avec le curseur du mode navigation. +Cela pourrait apporter une expérience de navigation plus rapide et une meilleure réactivité en mode navigation. +Le focus sera alors mis à jour lors d'une interaction avec un élément particulier (ex : l'appui d'un bouton, le cochage d'une case à cocher). +Activer cette option peut améliorer le support de quelques sites web au détriment de la performance et de la stabilité. + +#### Mise en forme des documents (NVDA+contrôle+d) {#DocumentFormattingSettings} + + + +##### Ouvrir les paramètres de mise en forme des documents {#OpenDocumentFormattingSettings} + +Raccourci clavier : `NVDA+contrôle+d` + +La plupart des options de cette catégorie servent à définir quelles informations de mise en forme vous souhaitez entendre automatiquement lorsque vous parcourez un document. +Par exemple, si on coche la case "Annoncer le nom de la police", à chaque fois que les flèches amènent sur un texte avec une police différente, le nom de la police est annoncé. + +Les options de mise en forme des document sont organisées par groupes ; +On peut configurer les annonces suivantes : + +* Police, + * Nom de la police + * Taille de la police, + * Attributs de la police, + * Exposants et indices + * Emphase + * Texte surligné (marqué) + * Style + * Couleurs +* Informations sur le document + * Commentaires + * Signets + * Modifications de l'éditeur + * Fautes d'orthographe +* Pages et espacement + * Numéros de page + * Numéros de ligne + * Annonce du retrait de ligne [(Désactivé, Parole, Sons, Parole et Sons)](#DocumentFormattingSettingsLineIndentation) + * Ignorer les lignes vides pour l'annonce du retrait de ligne + * Retrait des paragraphes (ex. retrait négatif, retrait de première ligne) + * interligne (simple, double etc.) + * Alignement +* Informations sur les tableaux + * Tableaux + * En-têtes des lignes et colonnes (désactivé, lignes, colonnes, lignes et colonnes) + * Coordonnées des cellules + * Bordure des cellules (désactivé, Styles, Couleurs et Styles) +* Éléments + * Titres + * Liens + * Graphiques + * Listes + * Citations + * Groupes + * Régions + * Articles + * Cadres + * Figures et légendes + * Cliquable + +Pour modifier ces paramètres depuis n'importe où, veuillez assigner un geste personnalisé en utilisant le [dialogue Gestes de Commandes](#InputGestures). + +##### Annonce des changements de mise en forme après le curseur {#DocumentFormattingDetectFormatAfterCursor} + +Si on l'active, ce paramètre dit à NVDA de détecter tous les changements de mise en forme sur une ligne et de les signaler pendant la lecture. Attention, cela peut dégrader les performances de NVDA. + +Par défaut, NVDA détecte la mise en forme sous le curseur système ou le curseur de revue, et, dans certains cas, sur toute la ligne à condition que cela ne dégrade pas les performances. + +Activez cette option quand vous révisez un document dans une application telle que Wordpad et que la mise en forme est importante. + +##### Annonce des retraits de lignes {#DocumentFormattingSettingsLineIndentation} + +Cette option vous permet de configurer la manière dont les retraits en début de ligne sont annoncés. +La liste déroulante "Annoncer les retraits de ligne par" a quatre options : + +* Désactivé : NVDA ne traitera pas les retraits de lignes. +* Parole : Si parole est sélectionnée, quand le niveau de retrait change, NVDA dit quelque chose comme "douze espaces" ou "quatre tabulations.". +* Sons : Si sons est sélectionné, quand le niveau de retrait change, des sons indiquent la quantité de changement dans le retrait. +La hauteur du son montera pour chaque espace, et pour une tabulation, la hauteur montera de l'équivalent de 4 espaces. +* Parole et sons : Cette option indique les retraits en utilisant les deux méthodes ci-dessus. + +Si vous cochez la case "Ignorer les lignes vides pour l'annonce de retrait de ligne", les modifications d'indentation ne seront pas signalées pour les lignes vides. +Cela peut être utile lors de la lecture d'un document dans lequel des lignes vides sont utilisées pour séparer des blocs de texte en retrait, comme dans le code source de programmation. + +#### Navigation dans les documents {#DocumentNavigation} + +Cette catégorie vous permet d'ajuster divers aspects de la navigation dans les documents. + +##### Style des paragraphes {#ParagraphStyle} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Défaut (Géré par l' application), géré par l' application, Saut de ligne unique, Saut de ligne multiple| +|Défaut |Géré par l'application| + +Cette liste déroulante vous permet de sélectionner le style de paragraphe à utiliser lors de la navigation par paragraphes avec `contrôle+flècheHaut` et `contrôle+flècheBas`. +Les styles de paragraphe disponibles sont : + +* Géré par l'application : NVDA laissera l'application déterminer le paragraphe précédent ou suivant, et NVDA lira le nouveau paragraphe lors de la navigation. +Ce style fonctionne mieux lorsque l'application prend en charge la navigation dans les paragraphes de manière native et est la valeur par défaut. +* Saut de ligne simple : NVDA tentera de déterminer le paragraphe précédent ou suivant en utilisant un saut de ligne simple comme indicateur de paragraphe. +Ce style fonctionne mieux lors de la lecture de documents dans une application qui ne prend pas en charge nativement la navigation dans les paragraphes, et dont les paragraphes du document sont marqués par une simple pression sur la touche `entreé`. +* Saut de ligne multiple : NVDA tentera de déterminer le paragraphe précédent ou suivant en utilisant au moins une ligne vierge (deux appuis sur la touche `entreé`) comme indicateur de paragraphe. +Ce style fonctionne mieux lorsque vous travaillez avec des documents qui utilisent des paragraphes de bloc. +Notez que ce style de paragraphe ne peut pas être utilisé dans Microsoft Word ou Microsoft Outlook, sauf si vous utilisez l'UIA pour accéder aux contrôles de Microsoft Word. + +Vous pouvez basculer entre les styles de paragraphe disponibles de n'importe où en attribuant une touche dans la [boîte de dialogue Gestes de commandes](#InputGestures). + +#### Paramètres de l'Add-on Store {#AddonStoreSettings} + +Cette catégorie vous permet d'ajuster le comportement de l'Add-on Store. + +##### Notifications de mises à jour {#AutomaticAddonUpdates} + +Lorsque cette option est réglée sur "Notifier, l'Add-on Store vous avertira après le démarrage de NVDA si des mises à jour d'extension sont disponibles. +Cette vérification est effectuée toutes les 24 heures. +Les notifications ne se produiront que pour les extensions dont les mises à jour sont disponibles sur le même canal. +Par exemple, pour les extensions installés en version beta, vous ne serez informé que des mises à jour dans le canal bêta. + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Notifier (Défaut), Désactivé | +|Défaut |Notifier | + +|Option |Comportement | +|---|---| +|Notifier |Notifier lorsque des mises à jour sont disponibles pour les extensions dans le même canal | +|Désactivé |Ne pas vérifier automatiquement les mises à jour des extensions | + +#### Reconnaissance Optique de Caractères de Windows {#Win10OcrSettings} + +Les paramètres de cette catégorie vous permettent de configurer la [Reconnaissance de Caractères de Windows](#Win10Ocr). +Elle contient les options suivantes : + +##### Langue de Reconnaissance {#Win10OcrSettingsRecognitionLanguage} + +Cette liste déroulante vous permet de choisir la langue à utiliser pour la reconnaissance de texte. +Pour faire défiler les langues disponibles à partir de n'importe quel endroit, veuillez assigner un geste de commande personnalisé en utilisant [le dialogue Gestes de Commandes](#InputGestures). + +##### Actualiser périodiquement le contenu reconnu {#Win10OcrSettingsAutoRefresh} + +Lorsque cette case est cochée, NVDA actualisera automatiquement le contenu reconnu lorsqu'un résultat de reconnaissance aura le focus. +Cela peut être très utile lorsque vous souhaitez surveiller un contenu en constante évolution, par exemple lorsque vous regardez une vidéo avec sous-titres. +Le rafraîchissement a lieu toutes les secondes et demie. +Cette option est désactivée par défaut. + +#### Paramètres avancés {#AdvancedSettings} + +Avertissement ! Les paramètres dans cette catégorie sont pour les utilisateurs avancés et peuvent provoquer un mauvais fonctionnement de NVDA si mal configurés. +Ne modifiez ces paramètres que si vous êtes sûr de ce que vous faites ou si un développeur NVDA vous a demandé de le faire. + +##### Modifier les paramètres avancés {#AdvancedSettingsMakingChanges} + +Pour pouvoir modifier les paramètres avancés, les contrôles doivent être activés en confirmant, via la case à cocher, que vous comprenez les risques qu'il y a à modifier ces paramètres + +##### Rétablir les paramètres par défaut {#AdvancedSettingsRestoringDefaults} + +Le bouton rétablit les valeurs par défaut des paramètres, même si la case de confirmation n'est pas cochée. +Après avoir modifié les paramètres vous pouvez souhaiter revenir aux valeurs par défaut. +Cela peut aussi être le cas si vous n'êtes pas sûr que les paramètres ont été modifiés. + +##### Activer le chargement de code personnalisé depuis le Répertoire Bloc-notes du Développeur {#AdvancedSettingsEnableScratchpad} + +Quand vous développez des extensions pour NVDA, il est utile de pouvoir tester le code en cours d'écriture. +Cette option, lorsqu'elle est activée, permet à NVDA de charger des modules applicatifs personnalisés, des modules globaux, des pilotes d'afficheurs braille, des pilotes de synthétiseur et des fournisseurs d'amélioration visuelle, à partir d'un répertoire spécial bloc-notes du développeur dans votre répertoire de configuration utilisateur NVDA. +Comme leurs équivalents dans les extensions, ces modules sont chargés au démarrage de NVDA ou, dans le cas des modules applicatifs et globaux, lors du [rechargement des modules](#ReloadPlugins). +Cette option est désactivée par défaut, garantissant qu'aucun code non testé n'est exécuté par NVDA sans que l'utilisateur en ait explicitement connaissance. +Si vous voulez distribuer du code spécifique à d'autres personnes, vous devriez l'empaqueter sous forme d'extension pour NVDA. + +##### Ouvrir le Répertoire Bloc-notes du Développeur {#AdvancedSettingsOpenScratchpadDir} + +Ce bouton ouvre le répertoire où vous pouvez placer le code personnalisé que vous êtes en train de développer. +Ce bouton n'est disponible que si NVDA est configuré pour permettre le chargement de code personnalisé depuis le répertoire Bloc-notes du développeur. + +##### Enregistrement des événements et modifications de propriété UI Automation {#AdvancedSettingsSelectiveUIAEventRegistration} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Automatique, Sélectif, Global| +|Défaut |Automatique| + +Cette option change la façon dont NVDA enregistre les événements déclenchés par l'API d'accessibilité UI Automation de Microsoft. +La liste déroulante Enregistrement des événements et modifications de propriété UI Automation a trois options : + +* Automatique : "sélectif" sous Windows 11 Sun Valley 2 (version 22H2) et ultérieur, "global" sinon. +* Sélectif : NVDA limitera l'enregistrement des événements au focus système pour la plupart des événements +Si vous rencontrez des problèmes de performances dans une ou plusieurs applications, nous vous recommandons d'essayer cette fonctionnalité pour voir si les performances s'améliorent. +Cependant, sur les anciennes versions de Windows, NVDA peut avoir des difficultés à suivre le focus dans certains contrôles (tels que le gestionnaire de tâches et le panneau emoji). +* Global : NVDA enregistre de nombreux événements UIA qui sont traités et rejetés dans NVDA lui-même. +Bien que le suivi du focus soit plus fiable dans un plus grand nombre de situations, les performances sont considérablement dégradées, en particulier dans des applications telles que Microsoft Visual Studio. + +##### Utiliser UI automation pour accéder aux contrôles des documents Microsoft Word {#MSWordUIA} + +Configure si NVDA doit ou non utiliser l'API d'accessibilité UI Automation pour accéder aux documents Microsoft Word, plutôt que l'ancien modèle d'objet Microsoft Word. +Cela s'applique aux documents dans Microsoft Word lui-même, ainsi qu'aux messages dans Microsoft Outlook. +Ce paramètre contient les valeurs suivantes : + +* Défaut (Lorsque c'est adapté) +* Seulement si nécessaire : quand le modèle d'objet Microsoft Word n'est pas disponible du tout +* Lorsque c'est adapté : Microsoft Word version 16.0.15000 ou supérieure, ou lorsque le modèle d'objet Microsoft Word n'est pas disponible +* Toujours : partout où UI automation est disponible dans Microsoft Word (quel que soit l'avancement de son développement) + +##### Utilisez UI Automation pour accéder aux contrôles de feuille de calcul Microsoft Excel quand disponible {#UseUiaForExcel} + +Lorsque cette option est activée, NVDA essaiera d'utiliser l'API d'accessibilité de Microsoft UI Automation pour récupérer les informations depuis les contrôles de la feuille de calcul Microsoft Excel. +Il s'agit d'une fonctionnalité expérimentale et certaines fonctionnalités de Microsoft Excel peuvent ne pas être disponibles dans ce mode. +Par exemple, la liste des éléments de NVDA pour lister les formules et les commentaires, et la navigation rapide en mode navigation pour sauter aux champs de formulaire sur une feuille de calcul ne sont pas disponibles. +Cependant, pour la navigation/l'édition de base d'une feuille de calcul, cette option peut améliorer considérablement les performances. +Nous ne recommandons toujours pas que la majorité des utilisateurs l'activent par défaut, mais nous invitons les utilisateurs de Microsoft Excel version 16.0.13522.10000 ou supérieure à tester cette fonctionnalité et à nous faire part de leurs commentaires. +L'implémentation de UI Automation dans Microsoft Excel est en constante évolution et les versions de Microsoft Office antérieures à 16.0.13522.10000 peuvent ne pas exposer suffisamment d'informations pour que cette option soit d'une quelconque utilité. + +##### Utiliser le traitement des événements amélioré {#UIAEnhancedEventProcessing} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Défaut (Activé), Désactivé, Activé| +|Défaut |Activé| + +Lorsque cette option est activée, NVDA devrait rester réactif lorsqu'il est submergé de nombreux événements UI Automation, par ex. de grandes quantités de texte dans un terminal. +Après avoir modifié cette option, vous devrez redémarrer NVDA pour que la modification prenne effet. + +##### Prise en charge de la Console Windows {#AdvancedSettingsConsoleUIA} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Automatique, UIA si disponible, Héritée| +|Défaut |Automatique| + +Cette option sélectionne la façon dont NVDA interagit avec la console Windows utilisée par l'invite de commande, PowerShell et le sous-système Windows pour Linux. +Cela n'affecte pas le terminal Windows moderne. +Dans Windows 10 version 1709, Microsoft [a ajouté la prise en charge de son API UI Automation à la console](https://devblogs.microsoft.com/commandline/whats-new-in-windows-console-in-windows-10-fall-creators-update/), apportant des performances et une stabilité considérablement améliorées pour les lecteurs d'écran qui la prennent en charge. +Dans les situations où l'automatisation de l'interface utilisateur n'est pas disponible ou connue pour entraîner une expérience utilisateur inférieure, la prise en charge de la console héritée de NVDA est disponible comme solution de secours. +La liste déroulante de prise en charge de la console Windows comporte trois options : + +* Automatique : utilise UI Automation dans la version de la console Windows incluse avec Windows 11 version 22H2 et versions ultérieures. +Cette option est recommandée et définie par défaut. +* UIA si disponible : utilise l'automatisation de l'interface utilisateur dans les consoles si disponible, même pour les versions avec des implémentations incomplètes ou boguées. +Bien que cette fonctionnalité limitée puisse être utile (et même suffisante pour votre utilisation), l'utilisation de cette option est entièrement à vos risques et périls et aucune assistance ne sera fournie. +* Héritée : l'automatisation de l'interface utilisateur dans la console Windows sera complètement désactivée. +L'héritage de secours sera toujours utilisé même dans les situations où UI Automation offrirait une expérience utilisateur supérieure. +Par conséquent, le choix de cette option n'est pas recommandé, sauf si vous savez ce que vous faites. + +##### Utiliser UIA avec Microsoft Edge et autres navigateurs basés sur Chromium quand c'est possible {#ChromiumUIA} + +Cette option permet de définir quand UIA sera utilisé si disponible dans les navigateurs basés sur Chromium tels que Microsoft Edge. +Le support d'UIA pour les navigateurs basés sur Chromium est au début de son développement et peut ne pas apporter le même niveau d'accessibilité que IA2. +La liste déroulante contient les options suivantes : + +* Défaut (Seulement quand nécessaire) : C'est actuellement la valeur par défaut de NVDA. Cette valeur par défaut peut changer à l'avenir en fonction de l'amélioration de la technologie. +* Seulement quand nécessaire : Quand NVDA est incapable d'injecter dans le processus du navigateur de quoi utiliser IA2 et que UIA est disponible, NVDA utilisera UIA. +* Oui : Si le navigateur rend UIA disponible, NVDA l'utilisera. +* Non : Ne pas utiliser UIA, même si NVDA ne peut pas injecter dans le processus. Ceci peut être utile pour les développeurs corrigeant des problèmes liés à IA2 et voulant s'assurer que NVDA ne revient pas à UIA. + +##### Annotations {#Annotations} + +Ce groupe d'options est utilisé pour activer des fonctionnalités qui ajoutent une prise en charge expérimentale des annotations ARIA. +Certaines de ces fonctionnalités peuvent être incomplètes. + + +Pour "Signaler le résumé de tous les détails d'annotation au niveau du curseur système", appuyez sur NVDA+d. + + +Les options suivantes existent : + +* "Annoncer 'contient des détails' pour les annotations structurées" : active l'annonce si le texte ou le contrôle contient plus de détails. +* "Toujours annoncer aria-description" : + Lorsque la source de `accDescription` est aria-description, la description est annoncée. + Ceci est utile pour les annotations sur le web. + Note : + * Il existe de nombreuses sources pour `accDescription` plusieurs ont une sémantique mixte ou peu fiable. + Historiquement, les technologies d'assistance n'ont pas été en mesure de différencier les sources de `accDescription` généralement, elle n'a pas été annoncée en raison de la sémantique mixte. + * Cette option est en développement très précoce, elle repose sur des fonctionnalités de navigateur pas encore largement disponibles. + * Elle devrait fonctionner avec Chromium 92.0.4479.0+ + +##### Signaler les régions Actives {#BrailleLiveRegions} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Défaut (Activé), Désactivé, Activé| +|Défaut |Activé| + +Cette option définit si NVDA signale les changements dans certains contenus Web dynamiques en Braille. +Désactiver cette option équivaut au comportement de NVDA dans les versions 2023.1 et antérieures, qui ne signalaient ces changements de contenu que par la parole. + +##### Énoncer les mots de passe dans tous les terminaux améliorés {#AdvancedSettingsWinConsoleSpeakPasswords} + +Ce paramètre définit si les caractères sont prononcés en [écho clavier par caractère](#KeyboardSettingsSpeakTypedCharacters) ou [écho clavier par mot](#KeyboardSettingsSpeakTypedWords) dans les situations où l'écran ne se met pas à jour (comme la saisie du mot de passe) dans certains programmes de terminal, tels que la console Windows avec l'automatisation de l'interface utilisateur support activé et Mintty. +Pour des raisons de sécurité, ce paramètre devrait être laissé désactivé. +Cependant, vous souhaiterez peut-être l'activer si vous rencontrez des problèmes de performances ou une instabilité avec les annoncess de caractères et/ou de mots saisis dans les consoles, ou si vous travaillez dans des environnements de confiance et préférez l'annonce du mot de passe. + +##### Utiliser la prise en charge améliorée de la saisie de caractères dans l'ancienne console Windows lorsqu'elle est disponible {#AdvancedSettingsKeyboardSupportInLegacy} + +Cette option active une méthode alternative pour détecter les caractères saisis dans les anciennes consoles Windows. +Bien qu'elle améliore les performances et empêche certains affichages de console d'être épelés, elle peut être incompatible avec certains programmes de terminaux. +Cette fonctionnalité est disponible et activée par défaut sous Windows 10 versions 1607 et ultérieures quand UI Automation n'est pas disponible ou désactivée. +Avertissement : quand cette option est activée, les caractères tapés qui n'apparaissent pas à l'écran comme les mots de passe, ne seront pas supprimés. +Dans les environnement non sûrs, vous pouvez désactiver temporairement [Écho clavier par caractère](#KeyboardSettingsSpeakTypedCharacters) et [Écho clavier par mot](#KeyboardSettingsSpeakTypedWords) quand vous entrez un mot de passe. + +##### Algorithme de comparaison du texte {#DiffAlgo} + +Ce paramètre définit comment NVDA détermine le nouveau texte à annoncer dans les terminaux. +La liste déroulante Algorithme de comparaison du texte a trois options : + +* Automatique : Cette option fait que NVDA préfère Diff Match Patch dans la plupart des situations, mais se rabat sur Difflib dans les applications problématiques, telles que les anciennes versions de la console Windows et de Mintty. +* Diff Match Patch : Cette option permet à NVDA de calculer les modifications apportées au texte du terminal par caractère, même dans les situations où cela n'est pas recommandé. +Cela peut améliorer les performances quand de grandes quantités de texte sont écrites à la console et permet l'annonce plus précises des changements intervenant en milieu de ligne. +Cependant, dans certaines applications, la lecture d'un nouveau texte peut être saccadée ou incohérente. +* Difflib : cette option permet à NVDA de calculer les modifications apportées au texte du terminal par ligne, même dans les situations où cela n'est pas recommandé. +Ce comportement est identique à celui de NVDA en version 2020.4 et antérieures. +Ce paramètre peut stabiliser la lecture du texte entrant dans certaines applications. +Cependant, dans les terminaux, lors de l'insertion ou de la suppression d'un caractère au milieu d'une ligne, le texte après le curseur sera lu. + +##### Annoncez un nouveau texte dans le terminal Windows via {#WtStrategy} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Défaut (Comparaison du texte), Comparaison du texte, Notifications UIA| +|Défaut |Comparaison du texte| + +Cette option sélectionne la façon dont NVDA détermine quel texte est "nouveau" (et donc ce qu'il faut prononcer lorsque "signaler les changements de contenu dynamique" est activé) dans Windows Terminal et le contrôle WPF Windows Terminal utilisé dans Visual Studio 2022. +Elle n'affecte pas la console Windows (`conhost.exe`). +La liste déroulante annoncer le nouveau texte dans le terminal Windows comporte trois options : + +* Par défaut : cette option est actuellement équivalente à "différence", mais il est prévu qu'elle change une fois que la prise en charge des notifications UIA sera développée davantage. +* Différence : cette option utilise l'algorithme de comparaison sélectionné pour calculer les changements à chaque fois que le terminal affiche un nouveau texte. +Ceci est identique au comportement de NVDA dans les versions 2022.4 et antérieures. +* Notifications UIA : Cette option reporte la responsabilité de déterminer quel texte parler au terminal Windows lui-même, ce qui signifie que NVDA n'a plus à déterminer quel texte actuellement à l'écran est "nouveau". +Cela devrait nettement améliorer les performances et la stabilité de Windows Terminal, mais cette fonctionnalité n'est pas encore complète. +En particulier, les caractères saisis qui ne s'affichent pas à l'écran, tels que les mots de passe, sont signalés lorsque cette option est sélectionnée. +De plus, les étendues contiguës d'affichage de plus de 1 000 caractères peuvent ne pas être rapportées avec précision. + +##### Tenter d'interrompre la parole pour les événements de focus expirés {#CancelExpiredFocusSpeech} + +Cette option active un comportement qui tente d'interrompre la parole pour les événements de focus expirés. +En particulier se déplacer rapidement parmi les messages dans Gmail sous Chrome peut amener NVDA à annoncer des informations périmées. +Cette fonctionnalité est activée par défaut à partir de NVDA 2021.1. + +##### Délai d'attente de mouvement du curseur (en ms) {#AdvancedSettingsCaretMoveTimeout} + +Cette option vous permet de configurer le nombre de millisecondes durant lequel NVDA attendra le déplacement du curseur (point d'insertion) dans les contrôles de texte éditable. +Si vous trouvez que NVDA semble mal suivre le curseur ex : il semble être toujours un caractère en retard ou il répète les lignes, alors vous pouvez essayer d'accroître cette valeur. + +##### Annoncer la transparence pour les couleurs {#ReportTransparentColors} + +Cette option permet d'annoncer lorsque les couleurs sont transparentes, utile pour les développeurs d'extensions qui collectent des informations pour améliorer l'expérience utilisateur avec une application tierce. +Certaines applications GDI mettent en surbrillance le texte avec une couleur d'arrière-plan, NVDA (via le modèle d'affichage) tente de signaler cette couleur. +Dans certaines situations, l'arrière-plan du texte peut être entièrement transparent, le texte étant superposé sur un autre élément de l'interface graphique. +Pour plusieurs API GUI historiquement populaires, le texte peut être rendu avec un arrière-plan transparent, mais visuellement, la couleur d'arrière-plan est précise. + +##### Utiliser WASAPI pour la sortie audio {#WASAPI} + +| . {.hideHeaderRow} |.| +|---|---| +|Options |Défaut (Activé), Désactivé, Activé| +|Défaut |Activé| + +Cette option active la sortie audio via l'API Windows Audio Session (WASAPI). +WASAPI est une architecture audio plus moderne qui peut améliorer la réactivité, les performances et la stabilité de la sortie audio NVDA, y compris la parole et les sons. +Après avoir modifié cette option, vous devrez redémarrer NVDA pour que la modification prenne effet. +La désactivation de WASAPI désactivera les options suivantes : + +* [Le volume des sons NVDA suit le volume de la voix](#SoundVolumeFollowsVoice) +* [Volume des sons NVDA](#SoundVolume) + +##### Catégories de journalisation de débogage {#AdvancedSettingsDebugLoggingCategories} + +Les cases à cocher dans cette liste vous permettent d'activer des catégories spécifiques de messages de débogage dans le journal de NVDA. +La journalisation de ces messages peut dégrader la performance et produire de gros fichiers de journal. +N'activez l'une d'entre elle que si un développeur de NVDA vous l'a spécifiquement demandé ex : pour déboguer un pilote de terminal braille ne fonctionnant pas correctement. + +##### Jouer un son pour les erreurs journalisées {#PlayErrorSound} + +Cette option vous permet de spécifier si NVDA joue un son d'erreur au cas où une erreur est enregistrée. +En sélectionnant Uniquement dans les versions de test (par défaut), NVDA émet des sons d'erreur uniquement si la version actuelle de NVDA est une version de test (alpha, bêta ou exécutée à partir de la source). +En sélectionnant Oui les sons d'erreur sont activés quelle que soit votre version actuelle de NVDA. + +##### Expression régulière pour la navigation par paragraphes de texte {#TextParagraphRegexEdit} + +Ce champ permet aux utilisateurs de personnaliser l'expression régulière pour détecter les paragraphes de texte en mode navigation. +La [commande de navigation par paragraphe de texte](#TextNavigationCommand) recherche les paragraphes correspondant à cette expression régulière. + +### Autres paramètres {#MiscSettings} + +En plus du dialogue [Paramètres](#NVDASettings), le sous-menu Préférences du menu NVDA contient plusieurs autres éléments décrits ci-dessous. + +#### Dictionnaires de prononciation {#SpeechDictionaries} + +Le menu "Dictionnaires de prononciation" du menu "Préférences" contient des dialogues qui vous permettent de gérer la manière dont NVDA prononce certains mots ou phrases. +Il y a actuellement trois types de dictionnaires. +Ce sont : + +* Défaut : les règles de ce dictionnaire affectent la parole dans tout NVDA. +* Voix : les règles de ce dictionnaire n'affectent que la voix en cours d'utilisation. +* Temporaire : les règles de ce dictionnaire affectent tout NVDA mais seulement pour la session en cours. + +Vous devez assigner des gestes personnalisés en utilisant le [dialogue Gestes de Commandes](#InputGestures) si vous voulez ouvrir l'un de ces dialogues de dictionnaire depuis n'importe où. + +Tous les dialogues des dictionnaires contiennent une liste de règles qui seront utilisées pour produire la parole. +Le dialogue contient aussi des boutons "Ajouter", "Éditer", "Supprimer" et "Tout supprimer". + +Pour ajouter une nouvelle règle au dictionnaire, cliquez sur le bouton "Ajout", remplissez les champs dans le dialogue puis cliquez sur "OK". +Vous verrez ainsi votre nouvelle règle dans la liste des règles. +Cependant, pour être sûr que votre règle est vraiment sauvegardée, n'oubliez pas de cliquer sur le bouton "OK" pour quitter le dialogue de dictionnaire une fois que vous aurez fait toutes vos modifications. + +Les règles des dictionnaires de NVDA vous permettent de remplacer une chaîne de caractères par une autre. +Par exemple, vous pourrez vouloir que NVDA prononce le mot "grenouille" chaque fois qu'il rencontre le mot "oiseau". +Dans le dialogue d'ajout de règles, la manière la plus simple de faire cela est d'entrer le mot "oiseau" dans la zone "modèle" et le mot "grenouille" dans la zone de remplacement. +Vous pouvez aussi ajouter un commentaire décrivant la règle dans la zone commentaire, quelque chose comme "Remplacer oiseau par grenouille". + +Cependant, les dictionnaires de NVDA font bien mieux que le simple remplacement de mot. +Le dialogue "Ajout de règles" contient une case à cocher permettant de choisir si vous voulez que la règle respecte la casse pour que NVDA tienne compte des majuscules et minuscules. +Par défaut, NVDA ne tient pas compte de la casse. + +Pour finir, un ensemble de boutons radio vous permet de dire à NVDA si votre modèle devrait s'appliquer partout, seulement dans le cas d'un mot entier ou s'il devrait être traité comme une "expression régulière". +Définir le modèle comme un mot entier signifie que le remplacement ne sera fait que si le modèle n'est pas rencontré dans un mot plus grand. +Un caractère non alphanumérique ou un souligné ou pas de caractère doit être présent immédiatement avant et après le modèle. +Ainsi, en utilisant l'exemple précédent de remplacement du mot "oiseau" par le mot "grenouille", si vous le définissez comme un remplacement de mot entier, cela ne marcherait pas pour "oiseaux" ou "damoiseau". + +Une expression régulière est un modèle contenant des symboles particuliers vous permettant de trouver une correspondance sur plus d'un caractère à la fois, ou seulement sur les lettres ou les chiffres etc. +Les expressions régulières ne sont pas expliquées dans ce manuel. +Pour un tutoriel d'introduction, veuillez consulter le [Guide des expressions régulières de Python](https://docs.python.org/3.11/howto/regex.html). + +#### Prononciation des ponctuations et symboles {#SymbolPronunciation} + +Ce dialogue vous permet de modifier la façon dont les ponctuations et autres symboles sont prononcés ainsi que le niveau de symbole auquel ils sont annoncés. + +La langue pour laquelle la prononciation des symboles est en cours d'édition sera indiquée dans le titre du dialogue. +Notez que ce dialogue tient compte de l'option "Se baser sur la langue de la voix pour le traitement des caractères et symboles" qui se trouve dans la catégorie [Parole](#SpeechSettings) du dialogue [Paramètres de NVDA](#NVDASettings). Il utilise la langue de la voix plutôt que le paramètre global langue de NVDA quand cette option est activée. + +Pour modifier un symbole, sélectionnez-le d'abord dans la liste de symboles. +Vous pouvez filtrer les symboles en entrant le symbole ou une partie du remplacement du symbole dans le champ d'édition Filtrer par. + +* Le champ "Remplacement" vous permet de modifier le texte qui doit être prononcé à la place de ce symbole. +* En utilisant le champ "Niveau", vous pouvez ajuster le niveau minimum auquel ce symbole doit être annoncé (aucun, quelques-uns, la plupart ou tous). +Vous pouvez également définir le niveau sur caractère ; dans ce cas, le symbole ne sera pas prononcé quel que soit le niveau de symbole utilisé, avec les deux exceptions suivantes : + * Quand vous naviguez caractère par caractère. + * Quand NVDA épelle un texte contenant ce symbole. +* Le champ "Envoyer le symbole réel au synthétiseur" spécifie quand le symbole lui-même (au lieu de son remplacement) devrait être envoyé au synthétiseur. +Ceci est utile si le symbole force le synthétiseur à marquer une pause ou modifie l'inflexion de la voix. +Par exemple, une virgule force le synthétiseur à marquer une pause. +Il y a trois options : + * jamais : Ne jamais envoyer le symbole réel au synthétiseur. + * toujours : Toujours envoyer le symbole réel au synthétiseur. + * seulement au-dessous du niveau du symbole : N'envoyer le symbole réel que si le niveau de symboles configuré est inférieur au niveau assigné à ce symbole. + Par exemple, vous pourriez utiliser cela pour qu'un symbole ait son remplacement annoncés à hauts niveaux sans marquer de pause, tout en étant indiqué par une pause aux niveaux inférieurs. + +Vous pouvez ajouter de nouveaux symboles en pressant le bouton Ajouter. +Dans le dialogue qui apparaît, saisissez le symbole et pressez le bouton OK. +Puis, changez les champs pour le nouveau symbole comme vous le feriez pour les autres symboles. + +Vous pouvez supprimer un symbole précédemment ajouté en pressant le bouton Supprimer. + +Quand vous avez fini, cliquez sur le bouton "OK" pour sauvegarder vos modifications, ou le bouton "Annuler" pour les supprimer. + +Dans le cas de symboles complexes, le champ Remplacement peut inclure quelques références aux groupes du texte source. Par exemple, pour un modèle correspondant à une date complète, \1, \2 et \3 devraient apparaître dans le champ, pour être remplacés par les parties correspondantes de la date. +Ainsi, dans le champ Remplacement, les barres obliques normales doivent être doublées, ex : "a\\b" doit être tapé pour obtenir le remplacement de "a\b". + +#### Gestes de commandes {#InputGestures} + +Dans ce dialogue, vous pouvez configurer les gestes de commandes (raccourcis clavier, boutons d'un afficheur braille etc.) pour les commandes NVDA. + +Seules les commandes qui sont applicables immédiatement avant l'ouverture du dialogue sont affichées. +Par exemple, si vous souhaitez personnaliser des commandes liées au mode navigation, vous devez ouvrir le dialogue des gestes de commandes lorsque vous êtes en mode navigation. + +L'arborescence de ce dialogue répertorie toutes les commandes NVDA applicables regroupées par catégories. +Vous pouvez les filtrer en entrant un ou plusieurs mots du nom de la commande dans la zone d'édition Filtrer par dans n'importe quel ordre. +Tous les gestes associés à une commande sont énumérés au niveau suivant la commande. + +Pour ajouter un geste à une commande, sélectionnez la commande et appuyez sur le bouton "Ajouter". +Ensuite, effectuez le geste de commande que vous souhaitez associer, par exemple appuyez sur une touche du clavier ou un bouton sur l'afficheur braille. +Parfois, un geste peut être interprété de plusieurs façons. +Par exemple, si vous avez appuyé sur une touche du clavier, vous voudrez peut-être qu'elle soit spécifique à la configuration actuelle du clavier (par exemple, ordinateur de bureau ou ordinateur portable) ou vous voudrez peut-être l'appliquer pour toutes les configurations. +Dans ce cas, un menu apparaît, vous permettant de sélectionner l'option désirée. + +Pour supprimer un geste d'une commande, sélectionnez le geste et appuyez sur le bouton "Supprimer". + +La catégorie Touches émulées du clavier système contient des commandes NVDA qui émulent des touches sur le clavier du système. +Ces touches émulées du clavier système peuvent être utilisées pour contrôler une touche du système directement depuis votre terminal braille. +Pour ajouter un geste d'émulation, sélectionnez la catégorie Touches émulées du clavier système et pressez le bouton Ajouter. +Puis, pressez sur le clavier la touche que vous voulez émuler. +Après ça, la touche sera disponible dans la catégorie Touche émulées du clavier système et vous pourrez lui assigner un geste de commande comme décrit plus haut. + +Note : + +* Les touches émulées doivent avoir un geste assigné pour persister lors de la sauvegarde ou de la fermeture du dialogue. +* Un geste de commande avec modificateur peut ne pas pouvoir êttre assigné à un geste émulé sans modificateur +Par exemple, définir le `a` comme touche émulée et configurer un geste de commande `ctrl+m`, peut avoir comme résultat que l'application reçoit `ctrl+a`. + +Lorsque vous avez terminé vos modifications, appuyez sur le bouton "OK" pour les sauvegarder ou sur le bouton "Annuler" pour les ignorer. + +### Sauvegarder et recharger la configuration {#SavingAndReloading} + +Par défaut NVDA sauvegarde automatiquement vos paramètres. +Notez cependant que ce comportement peut être modifié dans le dialogue "Paramètres généraux" du menu "Préférences". +Pour sauvegarder manuellement les paramètres à n'importe quel moment, utilisez l'élément "Sauvegarder la configuration" dans le menu NVDA. + +Si vous faites une erreur dans vos paramètres et avez besoin de revenir aux valeurs précédentes, utilisez l'élément "Revenir à la configuration sauvegardée" dans le menu NVDA. +Vous pouvez également réinitialiser votre configuration aux valeurs d'usine en utilisant l'élément "Réinitialiser la configuration aux valeurs par défaut" également disponible dans le menu de NVDA. + +Les touches de commandes suivantes sont également utiles : + + +| Nom |Ordinateur de bureau |Ordinateur portable |Description| +|---|---|---|---| +|Sauvegarder la configuration |NVDA+contrôle+c |NVDA+contrôle+c |Sauvegarde votre configuration pour qu'elle ne soit pas perdue en quittant NVDA| +|Réinitialiser la configuration |NVDA+contrôle+r |NVDA+contrôle+r |Appuyez une fois pour réinitialiser à la configuration qui existait lors de votre dernière sauvegarde. Appuyez trois fois pour revenir à la configuration par défaut de NVDA.| + + + +### Profils de configuration {#ConfigurationProfiles} + +Parfois, vous souhaiteriez avoir des paramètres différents pour des situations différentes. +Par exemple, vous pourriez avoir l'annonce de retrait activée pendant que vous éditez ou l'annonce des attributs de la police activée pendant que vous corrigez. +NVDA vous permet de faire cela en utilisant des profils de configuration. + +Un profil de configuration contient uniquement les paramètres qui sont modifiés alors que le profil est en cours d'édition. +La plupart des paramètres peuvent être modifiés dans les profils de configuration à l'exception de ceux de la catégorie Général du dialogue [Paramètres](#NVDASettings), qui s'appliquent à l'ensemble de NVDA. + +Les profils de configuration peuvent être activés manuellement soit à partir d'un dialogue soit en utilisant un geste de commande personnalisé. +Ils peuvent également être activés automatiquement grâce à des déclencheurs tels que le passage à une application particulière. + +#### Gestion basique {#ProfilesBasicManagement} + +Vous pouvez gérer les profils de configuration en sélectionnant "Profils de configuration" dans le menu NVDA. +Vous pouvez aussi le faire en utilisant un raccourci clavier : + + +* NVDA+contrôle+p : Afficher le dialogue "Profils de configuration". + + + +Le premier élément dans ce dialogue est la liste des profils à partir de laquelle vous pouvez sélectionner un des profils disponibles. +Lorsque vous ouvrez le dialogue, le profil en cours d'édition est sélectionné. +Des informations complémentaires sont également indiquées pour les profils actifs, indiquant s'ils sont activés manuellement, déclenchés et/ou en cours d'édition. + +Pour renommer ou supprimer un profil, appuyez sur le bouton "Renommer" ou "Supprimer", respectivement. + +Appuyez sur le bouton "Fermer" pour fermer le dialogue. + +#### Création d'un profil {#ProfilesCreating} + +Pour créer un profil, appuyez sur le bouton "Nouveau". + +Dans le dialogue "Nouveau profil", vous pouvez entrer un nom pour le profil. +Vous pouvez également choisir comment ce profil doit être utilisé. +Si vous ne souhaitez utiliser ce profil que manuellement, sélectionnez activation manuelle, qui est la valeur par défaut. +Sinon, sélectionnez un déclencheur qui doit activer automatiquement ce profil. +Pour plus de commodité, si vous n'avez pas saisi un nom pour le profil, sélectionner un déclencheur le fera pour vous. +Reportez-vous [ci-dessous](#ConfigProfileTriggers) pour plus d'informations. + +Appuyer sur "OK" crée le profil et ferme le dialogue de configuration de sorte que vous pouvez le modifier. + +#### Activation manuelle {#ConfigProfileManual} + +Vous pouvez activer manuellement un profil en sélectionnant un profil et en cliquant sur le bouton "Activation manuelle". +Une fois activé, d'autres profils peuvent toujours être activés par des déclencheurs, mais les paramètres dans le profil activé manuellement remplacent ceux des profils activés par ces déclencheurs. +Par exemple, si un profil est déclenché pour l'application actuelle et que l'annonce des liens est activée dans ce profil mais désactivée dans le profil activé manuellement, les liens ne seront pas annoncés. +Toutefois, si vous avez changé la voix dans le profil déclenché mais que vous ne l'avez jamais changée dans le profil activé manuellement, la voix du profil déclenché sera utilisée. +Tous les paramètres que vous modifiez, seront sauvegardés dans le profil activé manuellement. +Pour désactiver un profil activé manuellement, sélectionnez-le dans le dialogue "Profils de configuration" et appuyez sur le bouton "Désactiver manuellement". + +#### Déclencheurs {#ConfigProfileTriggers} + +En appuyant sur le bouton "Déclencheurs" dans le dialogue "Profils de configuration", vous pouvez modifier les profils qui doivent être activés automatiquement par divers déclencheurs. + +La liste des déclencheurs affiche les déclencheurs disponibles, qui sont comme suit : + +* Application en cours : déclenché lors de l'activation de l'application en cours. +* Dire tout: déclenché lors de la lecture avec la commande "Dire Tout". + +Pour modifier le profil qui doit être automatiquement activé par un déclencheur, sélectionnez le déclencheur, puis sélectionnez le profil désiré dans la liste des profils. +Vous pouvez sélectionner "Configuration normale" si vous ne voulez pas utiliser de profil. + +Cliquez sur le bouton "Fermer" pour revenir au dialogue "Profils de configuration". + +#### Éditer un profil {#ConfigProfileEditing} + +Si vous avez activé manuellement un profil, les paramètres modifiés seront sauvegardés dans ce profil. +Autrement, tous les paramètres modifiés seront sauvegardés dans le profil le plus récemment déclenché. +Par exemple, si vous avez associé un profil avec l'application "Bloc-notes" et que vous basculez vers le "Bloc-notes", tous les paramètres modifiés seront sauvegardés dans ce profil. +Enfin, s'il n'y a ni profil activé manuellement, ni profil déclenché, tous les paramètres que vous modifierez seront sauvegardés dans votre configuration normale. + +Pour éditer le profil utilisé dans "Dire Tout", vous devez [activer manuellement](#ConfigProfileManual) ce profil. + +#### Désactiver temporairement tous les déclencheurs {#ConfigProfileDisablingTriggers} + +Parfois, il peut être utile de désactiver temporairement les déclencheurs. +Par exemple, vous voudrez peut-être modifier un profil activé manuellement ou votre configuration normale sans profils déclenchés interférents. +Vous pouvez le faire en cochant la case "Désactiver temporairement tous les déclencheurs" dans le dialogue "Profils de configuration". + +Pour activer ou désactiver les déclencheurs depuis n'importe où, veuillez assigner un geste de commande en utilisant le dialogue [Gestes de Commandes](#InputGestures). + +#### Activer un profil en utilisant les gestes de commandes {#ConfigProfileGestures} + +Pour chaque profil que vous ajoutez, vous pouvez assigner un ou plusieurs gestes de commandes pour l'activer. +Par défaut, les profils de configuration n'ont pas de geste de commande assigné. +Vous pouvez ajouter des gestes pour activer un profil en utilisant le dialogue [Gestes de Commandes](#InputGestures). +Chaque profil a sa propre entrée dans la catégorie profils de configuration. +Quand vous renommez un profil, tous les gestes que vous avez ajoutés restent disponibles. +La suppression d'un profil entraîne la suppression de tous les gestes qui lui sont associés. + +### Emplacement des fichiers de configuration {#LocationOfConfigurationFiles} + +Les versions portables de NVDA enregistrent tous les paramètres et extensions dans un répertoire nommé "userConfig" situé dans le répertoire de votre copie portable de NVDA. + +Les versions installées de NVDA enregistrent tous les paramètres et extensions dans un répertoire spécial de NVDA situé dans votre profil utilisateur Windows. +Cela signifie que chaque utilisateur du système peut avoir ses propres paramètres NVDA. +Pour ouvrir votre répertoire de paramètres de n'importe où vous pouvez utiliser [le dialogue Geste de commandes](#InputGestures) pour ajouter un geste personnalisé. +De plus, pour une version installée de NVDA, depuis le menu démarrer vous pouvez aller dans programmes -> NVDA -> explorer le répertoire de configuration utilisateur de NVDA. + +Les paramètres qu'utilise NVDA quand il s'exécute sur l'écran de connexion ou l'écran UAC sont enregistrés dans le répertoire "systemConfig" situé dans le répertoire NVDA. +En général, cette configuration n'a pas à être modifiée. +Pour modifier cette configuration, configurez NVDA à votre convenance, sauvegardez la configuration puis cliquez sur le bouton "Utiliser les paramètres NVDA actuellement sauvegardés pour l'écran de connexion à Windows (nécessite des privilèges administrateur)" dans la catégorie Général du dialogue [Paramètres](#NVDASettings). + +## Extensions et Add-on Store {#AddonsManager} + +Les extensions sont des paquets logiciels qui fournissent des fonctionnalités nouvelles ou modifiées pour NVDA. +Elles sont développées par la communauté NVDA et des organisations externes telles que des fournisseurs commerciaux. +Les extensions peuvent effectuer l'une des opérations suivantes : + +* Ajoutez ou améliorez la prise en charge de certaines applications. +* Fournir un support pour des afficheurs braille supplémentaires ou des synthétiseurs vocaux. +* Ajouter ou modifier des fonctionnalités dans NVDA. + +L'Add-on Store de NVDA vous permet de parcourir et de gérer les paquets d'extensions. +Toutes les extensions disponibles dans l'Add-on Store peuvent être téléchargées gratuitement. +Cependant, certaines d'entre elles peuvent exiger que les utilisateurs paient une licence ou un logiciel supplémentaire avant de pouvoir les utiliser. +Les synthétiseurs vocaux commerciaux sont un exemple de ce type d'extension. +Si vous installez une extension avec des composants payants et que vous changez d'avis quant à son utilisation, l'extension peut être facilement supprimée. + +L'Add-on Store est accessible depuis le sous-menu Outils du menu NVDA. +Pour accéder à l'Add-on Store depuis n'importe où, attribuez un geste personnalisé à l'aide de la [boîte de dialogue Gestes de commandes](#InputGestures). + +### Parcourir les extensions {#AddonStoreBrowsing} + +Lorsqu'il est ouvert, l'Add-on Store affiche une liste d'extensions. +Si vous n'avez pas encore installé d'extension, l'Add-on Store s'ouvrira sur une liste d'extensions disponibles à installer. +Si vous avez installé des extensions, la liste affichera les extensions actuellement installées. + +Sélectionner une extension, en vous déplaçant dessus avec les touches fléchées haut et bas, affichera les détails de l'extension. +Les extensions ont des actions associées auxquelles vous pouvez accéder via un [menu d'actions](#AddonStoreActions), telles que l'installation, l'aide, la désactivation et la suppression. +Les actions disponibles changeront selon que l'extension est installée ou non, et si elle est activée ou désactivée. + +#### Vues de la liste des extensions {#AddonStoreFilterStatus} + +Il existe différentes vues pour les extensions installées, pouvant être mis à jour, disponibles et incompatibles. +Pour changer la vue des extensions, changez l'onglet actif de la liste des extensions en utilisant `ctrl+tab`. +Vous pouvez également `tabuler` dans la liste des vues et vous déplacer à travers elles avec les touches `flècheGauche` et `flècheDroite`. + +#### Filtrage des extensions activées ou désactivées {#AddonStoreFilterEnabled} + +Normalement, une extension installée est "activée", ce qui signifie qu'elle est en cours d'exécution et disponible dans NVDA. +Cependant, certaines de vos extensions installées peuvent être définies sur l'état "désactivé". +Cela signifie qu'elles ne seront pas utilisées et que leurs fonctions ne seront pas disponibles pendant votre session NVDA en cours. +Vous avez peut-être désactivé une extension parce qu'elle était en conflit avec une autre extension ou avec une certaine application. +NVDA peut également désactiver certaines extensions, si elles s'avèrent incompatibles lors d'une mise à jour de NVDA ; mais vous serez averti si cela se produit. +Les extensions peuvent également être désactivées si vous n'en avez tout simplement pas besoin pendant une période prolongée, mais que vous ne souhaitez pas les désinstaller car vous pensez en avoir besoin à nouveau à l'avenir. + +Les listes d'extensions installées et incompatibles peuvent être filtrées par leur état activé ou désactivé. +La valeur par défaut affiche les extensions activées et désactivées. + +#### Inclure les extensions incompatibles {#AddonStoreFilterIncompatible} + +Les extensions disponibles et pouvant être mises à jour peuvent être filtrées pour inclure les [extensions incompatibles](#incompatibleAddonsManager) qui sont disponibles pour l'installation. + +#### Filtrer les extensions par canal {#AddonStoreFilterChannel} + +Les extensions peuvent être distribuées via quatre canaux : + +* Stable : le développeur a publié ceci en tant qu'extension testée avec une version publiée de NVDA. +* Bêta : Cette extension peut nécessiter des tests supplémentaires, mais elle est publiée pour les commentaires des utilisateurs. +Suggéré pour les premiers utilisateurs. +* Dev : ce canal est suggéré pour être utilisé par les développeurs d'extensions pour tester les modifications d'API non publiées. +Les testeurs alpha de NVDA peuvent avoir besoin d'utiliser une version "Dev" de leurs extensions. +* Externe : extensions installées à partir de sources externes, en dehors de l'Add-on Store. + +Pour lister les extensions uniquement pour des canaux spécifiques, modifiez la sélection du filtre "Canal". + +#### Recherche d'extensions {#AddonStoreFilterSearch} + +Pour rechercher des extensions, utilisez la zone de texte "Rechercher". +Vous pouvez y accéder en appuyant sur `maj+tab` dans la liste des extensions. +Tapez un ou deux mots-clés pour le type d'extension que vous recherchez, puis `tabulation` pour aller à la liste des extensions. +Les extensions seront répertoriées si le texte de recherche peut être trouvé dans l'ID, le nom, l'éditeur l'auteur ou la description de l'extension. + +### Actions sur les extensions {#AddonStoreActions} + +Les extensions ont des actions associées, telles que installer, aide, désactiver et supprimer. +Pour une extension de la liste des extensions, ces actions sont accessibles via un menu qu'on ouvre en appuyant sur la touche `applications`, `entrée`, un clic droit ou un double-clic sur l'extension. +Ce menu est également accessible par un bouton Actions dans les détails de l'extension sélectionnée. + +#### Installation d'extensions {#AddonStoreInstalling} + +Ce n'est pas parce qu'une extension est disponible dans l'Add-on Store de NVDA qu'elle a été approuvée ou vérifiée par NV Access ou qui que ce soit d'autre. +Il est très important de n'installer que des extensions provenant de sources de confiance. +La fonctionnalité des extensions est illimitée dans NVDA. +Cela peut inclure l'accès à vos données personnelles ou même à l'ensemble du système. + +Vous pouvez installer et mettre à jour des extensions en [parcourant les extensions disponibles](#AddonStoreBrowsing). +Sélectionnez une extension dans l'onglet "Extensions disponibles" ou "Mises à jour". +Utilisez ensuite l'action de mise à jour, d'installation ou de remplacement pour démarrer l'installation. + +Vous pouvez également installer plusieurs extensions à la fois. +Cela se fait en sélectionnant plusieurs extensions dans l'onglet des extensions disponibles, puis en activant le menu contextuel sur la sélection et en choisissant l'action "Installer les extensions sélectionnées". + +Pour installer une extension que vous avez obtenue en dehors de l'Add-on Store, appuyez sur le bouton "Installer à partir d'une source externe". +Cela vous permettra de rechercher un paquet d'extension (fichier `.nvda-addon`) quelque part sur votre ordinateur ou sur un réseau. +Une fois que vous avez ouvert le paquet d'extension le processus d'installation commencera. + +Si NVDA est installé et en cours d'exécution sur votre système, vous pouvez également ouvrir un fichier d'extension directement depuis le navigateur ou le système de fichiers pour commencer le processus d'installation. + +Lorsqu'une extension est installée depuis une source externe, NVDA vous demandera de confirmer l'installation. +Une fois l'extension installée, NVDA doit être redémarré pour que l'extension démarre, bien que vous puissiez reporter le redémarrage de NVDA si vous avez d'autres extensions à installer ou à mettre à jour. + +Par défaut, après le démarrage de NVDA, vous serez averti si des mises à jour d'extension sont disponibles. +Pour en savoir plus et configurer ce comportement, reportez-vous à ["Notifications de mises à jour"](#AutomaticAddonUpdates). + +#### Suppression des extensions {#AddonStoreRemoving} + +Pour supprimer une extension, sélectionnez-la dans la liste et utilisez l'action Supprimer. +NVDA vous demandera de confirmer la suppression. +Comme pour l'installation, NVDA doit être redémarré pour que l'extension soit complètement supprimée. +En attendant, un statut "En attente de suppression" sera affiché pour cette extension dans la liste. +Comme pour l'installation, vous pouvez également supprimer plusieurs extensions à la fois. + +#### Désactivation et activation des extensions {#AddonStoreDisablingEnabling} + +Pour désactiver une extension, utilisez l'action "désactiver". +Pour activer une extension précédemment désactivée, utilisez l'action "activer". +Vous pouvez désactiver une extension si l'état de l'extension indique qu'elle est "activée" ou l'activer si l'extension est "désactivée". +Pour chaque utilisation de l'action activer/désactiver, le statut de l'extension change pour indiquer ce qui se passera au redémarrage de NVDA. +Si l'extension était auparavant "désactivée", l'état affichera "activé après le redémarrage". +Si l'extension était précédemment "activée", l'état affichera "désactivé après le redémarrage". +Tout comme lorsque vous installez ou supprimez des extensions, vous devez redémarrer NVDA pour que les modifications prennent effet. +Vous pouvez également activer ou désactiver plusieurs extensions à la fois en sélectionnant plusieurs extensions dans l'onglet des extensions disponibles, puis en activant le menu contextuel sur la sélection et en choisissant l'action appropriée. + +#### Examiner les extension et lire les avis {#AddonStoreReviews} + +Vous souhaiterez peut-être lire les avis d'autres utilisateurs qui ont déjà utilisé une extension par exemple avant de l'installer ou pendant que vous apprenez à l'utiliser. +En outre, il est utile pour les autres utilisateurs que vous déposiez des commentaires sur les extensions que vous avez testées. +Pour lire les avis sur une extension, sélectionnez-la et utilisez l'action "Avis de la communauté". +Cela renvoie vers une page Web de discussion GitHub, où vous pourrez lire et rédiger des avis sur l'extension. +Veuillez noter que cela ne remplace pas une communication directe avec les développeurs d'extension. +Le but de cette fonctionnalité est plutôt de partager des commentaires pour aider les utilisateurs à décider si une extension peut leur être utile. + +### Extensions incompatibles {#incompatibleAddonsManager} + +Certaines extensions anciennes peuvent ne plus être compatibles avec la version de NVDA que vous possédez. +Si vous utilisez une ancienne version de NVDA, certaines nouvelles extensions peuvent ne pas être compatibles non plus. +Toute tentative d'installation d'une extension incompatible entraînera une erreur expliquant pourquoi l'extension est considérée comme incompatible. + +Pour les extensions plus anciennes, vous pouvez ignorer l'incompatibilité à vos risques et périls. +Les extensions incompatibles peuvent ne pas fonctionner avec votre version de NVDA et peuvent provoquer un comportement instable ou inattendu, y compris des plantages. +Vous pouvez ignorer la compatibilité lors de l'activation ou de l'installation d'une extension. +Si l'extension incompatible cause des problèmes ultérieurement, vous pouvez la désactiver ou la supprimer. + +Si vous rencontrez des problèmes pour exécuter NVDA et que vous avez récemment mis à jour ou installé une extension, en particulier s'il s'agit d'une extension incompatible, vous pouvez essayer d'exécuter temporairement NVDA avec toutes les extensions désactivées. +Pour redémarrer NVDA avec toutes les extensions désactivées, choisissez l'option appropriée lorsque vous quittez NVDA. +Vous pouvez également utiliser l'[option de ligne de commande](#CommandLineOptions) `--disable-addons`. + +Vous pouvez parcourir les extensions incompatibles disponibles à l'aide des [onglets d'extensions disponibles et mises à jour](#AddonStoreFilterStatus). +Vous pouvez parcourir les extensions incompatibles installées à l'aide de l'[onglet extensions incompatibles](#AddonStoreFilterStatus). + +## Outils Additionnels {#ExtraTools} +### Visionneuse du Journal {#LogViewer} + +La visionneuse du journal, située dans "Outils" du menu NVDA, vous permet de consulter les événements enregistrés depuis le démarrage de la dernière session de NVDA. + +En plus de lire le contenu, vous pouvez également sauvegarder une copie du journal ou réactualiser la visionneuse de manière à charger les nouveaux événements générés après que la visionneuse ait été ouverte. +Ces actions sont disponibles dans le menu Journal de la visionneuse. + +Le fichier qui s'affiche lorsque vous ouvrez la visionneuse de journaux est enregistré sur votre ordinateur à l'emplacement du fichier `%temp%\nvda.log`. +Un nouveau fichier de journal est créé à chaque démarrage de NVDA. +A ce moment, le fichier de journal de la session NVDA précédente est déplacé vers `%temp%\nvda-old.log`. + +Vous pouvez également copier un fragment du fichier de journal courant dans le presse-papiers sans ouvrir la visionneuse de journaux. + + +| Nom |Touche |Description| +|---|---|---| +|Ouvrir la visionneuse de journaux |`NVDA+f1` |Ouvre la visionneuse de journaux et affiche des informations pour le développeur sur l'objet navigateur courant.| +|Copier un fragment du journal dans le presse-papiers |`NVDA+contrôle+maj+f1` |Au premier appui, le point de départ pour le contenu du journal qui doit être capturé est défini. Au deuxième appui, le contenu du journal depuis le point de départ est copié dans votre presse-papiers.| + + + +### Visionneuse de Parole {#SpeechViewer} + +Pour les développeurs voyants ou les personnes présentant NVDA à un public voyant, une fenêtre flottante est disponible, affichant tout ce que dit NVDA. + +Pour activer la visionneuse de parole, cochez l'élément de menu "Visionneuse de parole" situé dans "Outils" dans le menu NVDA. +Décochez l'élément de menu pour la désactiver. + +La fenêtre de la visionneuse de parole contient une case à cocher nommée "Montrer la visionneuse de parole au démarrage". +Si elle est cochée, la visionneuse de parole s'ouvrira au démarrage de NVDA. +La fenêtre de la visionneuse de parole essaiera toujours de s'ouvrir à la même dimension et à la même position que lors de sa fermeture. + +Pendant que la visionneuse de parole est active, elle se met constamment à jour, vous permettant de voir les dernières paroles prononcées par NVDA. +Cependant, si vous déplacez la souris ou mettez le focus sur la visionneuse, NVDA arrêtera momentanément de mettre à jour le texte, vous pourrez ainsi sélectionner ou copier le contenu. + +Pour activer la visionneuse de parole depuis n'importe où, Veuillez assigner un geste personnalisé en utilisant le [dialogue Gestes de Commandes](#InputGestures). + +### Visionneuse Braille {#BrailleViewer} + +Pour les voyants développeurs de logiciel ou les personnes présentant NVDA à un public voyant, une fenêtre flottante permettant de voir la sortie braille ainsi que le texte correspondant à chaque caractère braille est disponible. +La visionneuse Braille peut être utilisée en même temps qu'un afficheur braille physique, elle s'adaptera au nombre de cellules sur l'afficheur physique. +Quand la visionneuse Braille est activée, elle se met à jour constamment pour vous montrer ce qui serait affiché sur un afficheur braille physique. + +Pour activer la visionneuse Braille, cochez l'élément de menu "Visionneuse Braille" dans Outils dans le menu de NVDA. +Décochez l'élément de menu pour la désactiver. + +Les afficheurs braille physiques ont généralement des boutons pour faire défiler le texte en avant ou en arrière, pour permettre le défilement avec la visionneuse Braille utilisez le [dialogues de Gestes de Commandes](#InputGestures) pour assigner des raccourcis clavier pour "faire défiler l'afficheur braille en arrière" et "faire défiler l'afficheur braille en avant" + +La fenêtre de la visionneuse Braille contient une case à cocher étiquetée "Montrer la visionneuse Braille au démarrage". +Si elle est cochée, la visionneuse Braille s'affichera au démarrage de NVDA. +La visionneuse Braille essaiera toujours de se rouvrir avec les mêmes dimensions et à la même position que lors de sa fermeture. + +La fenêtre de la visionneuse braille contient une case à cocher étiquetée "Survol pour le routage vers une cellule", non cochée par défaut. +Si elle est cochée, le survol d'une cellule braille par la souris permettra d'activer la commande "aller à la cellule braille" pour cette cellule. +Ceci est parfois utilisé pour déplacer le curseur ou activer l'action pour un contrôle. +Ceci peut être utile pour tester si NVDA est capable de retrouver correctement une position à l'écran depuis une cellule braille. +Pour empêcher des routages cellules non intentionnels, la commande s'exécute après un délai. +La souris doit survoler jusqu'à ce que la cellule devienne verte. +La cellule commencera avec une couleur jaune clair, virera à l'orange, puis deviendra brusquement verte. + +Pour activer/désactiver la visionneuse braille depuis n'importe où, Veuillez assigner un geste de commande personnalisé en utilisant le [dialogue Gestes de commandes](#InputGestures). + +### Console Python {#PythonConsole} + +La console Python de NVDA, disponible sous Outils dans le menu NVDA, est un outil de développement utile pour le débogage, l'inspection générale des internes de NVDA ou l'inspection de la hiérarchie d'accessibilité d'une application. +Pour plus d'informations, veuillez consulter le [Guide de développement NVDA](https://www.nvaccess.org/files/nvda/documentation/developerGuide.html). + +### Add-on Store {#AddonStoreMenuItem} + +Cela ouvrira l'[Add-on Store de NVDA](#AddonsManager). +Pour plus d'informations, lisez la section détaillée : [Extensions et Add-on Store](#AddonsManager). + +### Créer une copie portable {#CreatePortableCopy} + +Ceci ouvrira un dialogue vous permettant de créer une copie portable de NVDA à partir de la version en cours d'exécution. + +Suivez les instructions dans [Création d'une copie portable](#CreatingAPortableCopy) pour plus d'informations. + +### Exécuter l'outil de correction d'enregistrements COM... {#RunCOMRegistrationFixingTool} + +Installer et désinstaller des programmes sur un ordinateur peut, dans certains cas, causer le désenregistrement des fichiers DLL COM. +Comme les interfaces COM tels que IAccessible dépendent de l'enregistrement correct des DLL COM, des problèmes peuvent apparaître en cas d'absence d'enregistrement de celles-ci. + +Cela peut survenir par exemple après installation et désinstallation d'Adobe Reader, Math Player et autres programmes. + +Les enregistrements manquants peuvent causer des problèmes dans les navigateurs, les applications de bureau, barre des tâches et autres interfaces. + +Spécifiquement, Les problèmes suivants peuvent être réglés par l'exécution de cet outil : + +* NVDA annonce "inconnu" en navigation avec des navigateurs tels que Firefox, Thunderbird etc. +* NVDA échoue à basculer entre mode formulaire et mode navigation. +* NVDA est très lent dans les navigateurs en mode navigation. +* Et possiblement d'autres problèmes. + +### Recharger les modules {#ReloadPlugins} + +Cet élément, quand on l'active, recharge les modules applicatifs et globaux sans avoir à redémarrer NVDA, ce qui peut être utile pour les développeurs. +Les modules applicatifs (appModules) gèrent la manière dont NVDA interagit avec des applications spécifiques. +Les modules globaux (globalPlugins) gèrent la manière dont NVDA interagit avec toutes les applications. + +Les raccourcis clavier NVDA suivants peuvent également être utiles : + + +| Nom |Touche |Description| +|---|---|---| +|Recharger les modules |`NVDA+contrôle+f3` |Recharger les modules globaux et applicatifs| +|Annoncer le module applicatif chargé et l'exécutable |`NVDA+contrôle+f1` |Annoncer le nom du module applicatif, s'il y en a un, et le nom de l'exécutable associé à l'application qui a le focus clavier.| + + + +## Synthétiseurs de Parole Pris en Charge {#SupportedSpeechSynths} + +Cette section contient des informations concernant les synthétiseurs de parole pris en charge par NVDA. +Pour une liste encore plus importante de synthétiseurs gratuits ou du commerce que vous pouvez acheter et télécharger pour utilisation avec NVDA, veuillez consulter la [page des voix supplémentaires](https://github.com/nvaccess/nvda/wiki/ExtraVoices) (en anglais). + +### eSpeak NG {#eSpeakNG} + +Le synthétiseur [eSpeak nG](https://github.com/espeak-ng/espeak-ng) est intégré dans NVDA et ne dépend d'aucun pilote ou programme additionnel pour être installé. +Sous Windows 8.1, NVDA utilise eSpeak NG par défaut ([Windows OneCore](#OneCore) est utilisé sous Windows 10 et versions ultérieures par défaut). +Comme ce synthétiseur est intégré dans NVDA, il est le plus indiqué quand vous voulez exécuter NVDA depuis une clé USB sur un autre système. + +Chaque voix fournie avec eSpeak NG correspond à une langue différente. +eSpeak NG prend en charge plus de 43 langues. + +Vous disposez également d'un grand choix de variantes, permettant de modifier considérablement le son de la voix. + +### Microsoft Speech API Version 4 (SAPI 4) {#SAPI4} + +SAPI 4 est un ancien standard Microsoft pour les synthétiseurs de parole logiciels. +NVDA le supporte encore pour les utilisateurs qui ont déjà des synthétiseurs SAPI 4 installés. +Cependant, Microsoft ne le supporte plus et les composants nécessaires ne sont plus disponibles chez Microsoft. + +Quand vous utilisez ce synthétiseur avec NVDA, la liste des voix disponibles (accessibles via la catégorie [Parole](#SpeechSettings)du dialogue [Paramètres](#NVDASettings), ou [la boucle des paramètres synthétiseur](#SynthSettingsRing)) contient toutes les voix de tous les synthétiseurs SAPI 4 installés sur votre système. + +### Microsoft Speech API Version 5 (SAPI 5) {#SAPI5} + +SAPI 5 est un standard Microsoft pour les synthétiseurs de parole logiciels. +Beaucoup de synthétiseurs de parole compatibles avec ce standard peuvent être achetés ou téléchargés gratuitement auprès de différentes sociétés ou sites web, mais il est probable que votre système possède déjà une voix SAPI 5 préinstallée. +Quand vous utilisez ce synthétiseur avec NVDA, la liste des voix disponibles (accessibles via la catégorie [Parole](#SpeechSettings)du dialogue [Paramètres](#NVDASettings), ou [la boucle des paramètres synthétiseur](#SynthSettingsRing)) contient toutes les voix de tous les synthétiseurs SAPI 5 installés sur votre système. + +### La Plate-forme Microsoft Speech {#MicrosoftSpeechPlatform} + +La plate-forme Microsoft Speech fournit des voix pour beaucoup de langues, normalement utilisées dans le développement de serveurs vocaux. +Ces voix peuvent également être utilisées avec NVDA. + +Pour utiliser ces voix, vous devrez installer deux composants : + +* [Microsoft Speech Platform - Runtime (Version 11), x86](https://www.microsoft.com/download/en/details.aspx?id=27225) +* [Microsoft Speech Platform - Runtime Languages (Version 11)](https://www.microsoft.com/download/en/details.aspx?id=27224) + * Cette page contient beaucoup de fichiers aussi bien pour la reconnaissance de parole que pour la synthèse vocale. + Choisissez les fichiers contenant la synthèse vocale pour la langue désirée. + Par exemple, le fichier MSSpeech_TTS_fr-FR_Hortense.msi est une voix francophone française. + +### Voix Windows OneCore {#OneCore} + +Windows 10 et les versions ultérieures incluent de nouvelles voix appelées "OneCore" ou voix "mobile". +Des voix sont fournies pour beaucoup de langues, et elles sont plus réactives que les voix Microsoft disponibles en utilisant Microsoft Speech API version 5. +Sous Windows 10 et versions ultérieures, NVDA utilise les voix Windows OneCore par défaut ([eSpeak NG](#eSpeakNG) est utilisé dans les autres versions). + +Pour ajouter de nouvelles voix Windows OneCore, rendez-vous à "Voix", dans les paramètres système de Windows. +Utilisez l'option "Ajouter des voix" et recherchez la langue désirée. +Beaucoup de langues incluent de multiples variantes. +"Royaume Uni" et "Australie" sont deux des variantes pour l'Anglais. +"France", "Canada" et "Suisse" sont des variantes disponibles pour le Français. +Recherchez la langue de base (telle que Anglais ou Français), puis trouvez la variante dans la liste. +Sélectionnez toutes les langues désirées et utilisez le bouton "Ajouter" pour les ajouter. +Une fois les langues ajoutées, redémarrez NVDA. + +Veuillez consulter [Langues et voix prises en charge](https://support.microsoft.com/fr-fr/windows/annexe-a-langues-et-voix-prises-en-charge-4486e345-7730-53da-fcfe-55cc64300f01) pour une liste de voix disponibles. + +## Terminaux Braille Pris en Charge {#SupportedBrailleDisplays} + +Cette section contient des informations sur les terminaux braille pris en charge par NVDA. + +### Terminaux supportant la détection automatique en arrière-plan {#AutomaticDetection} + +NVDA a la possibilité de détecter beaucoup de terminaux braille automatiquement en arrière-plan, via USB ou Bluetooth. +Ce comportement est activé en sélectionnant l'option Automatique comme terminal braille préféré dans le [dialogue Paramètres Braille](#BrailleSettings). +Cette option est sélectionnée par défaut. + +Les terminaux suivants supportent cette fonctionnalité de détection automatique. + +* Terminaux Handy Tech +* Terminaux braille Baum/Humanware/APH/Orbit +* Séries HumanWare Brailliant BI/B +* HumanWare BrailleNote +* SuperBraille +* Séries Optelec ALVA 6 +* HIMS Braille Sense/Braille EDGE/Smart Beetle/Sync Braille Series +* Terminaux Eurobraille Esys/Esytime/Iris +* Afficheurs Nattiq nBraille +* Seika Notetaker: MiniSeika (16, 24 cellules), V6, et V6Pro (40 cellules) +* Afficheurs Tivomatic Caiku Albatross 46/80 +* N'importe quel afficheur supportant le protocole standard HID Braille + +### Les Terminaux Focus et PAC Mate de chez Freedom Scientific {#FreedomScientificFocus} + +Tous les terminaux Focus et PAC Mate de chez [Freedom Scientific](https://www.freedomscientific.com/) sont pris en charge quand ils sont connectés en USB ou Bluetooth. +Vous devrez installer les pilotes de terminaux braille de Freedom Scientific sur votre système. +Si vous ne les avez pas déjà, vous pourrez les obtenir sur la [page du pilote d'affichage braille Focus Blue](https://support.freedomscientific.com/Downloads/Focus/FocusBlueBrailleDisplayDriver). +Bien que cette page ne mentionne que le terminal Focus 40 Blue, le pilote supporte tous les terminaux de Freedom Scientific. + +Par défaut, NVDA peut automatiquement détecter et se connecter à ces afficheurs via USB ou Bluetooth. +Cependant, lorsque vous configurez l'afficheur, vous pouvez sélectionner explicitement "USB" ou "Bluetooth" pour restreindre le type de connexion qui sera utilisée. +Cela peut être utile si vous voulez connecter l'afficheur Focus à NVDA via le Bluetooth tout en le chargeant en utilisant l'USB. +La détection automatique de terminaux braille de NVDA reconnaîtra également cet afficheur en USB ou Bluetooth. + +Voici les assignations de touches pour ces terminaux avec NVDA. +Veuillez consulter la documentation du terminal pour savoir où se situent ces touches. + + +| Nom |Touche| +|---|---| +|Défilement arrière de l'affichage braille |topRouting1 (première cellule de l'afficheur)| +|Défilement avant de l'affichage braille |topRouting20/40/80 (dernière cellule de l'afficheur)| +|Défilement arrière de l'affichage braille |barAvancerDeGauche| +|Défilement avant de l'affichage braille |barAvancerDeDroite| +|Basculer le suivi du braille |boutonGDFGauche+boutonGDFDroite| +|Choix de la fonction de la roulette magique gauche |Appui sur la roulette magique gauche| +|Retour arrière en utilisant la roulette magique gauche |roulette magique gauche vers le haut| +|Avancer en utilisant la roulette magique gauche |roulette magique gauche vers le bas| +|Choix de la fonction de la roulette magique droite |Appui sur la roulette magique droite| +|Retour arrière en utilisant la roulette magique droite |roulette magique droite vers le haut| +|Avancer en utilisant la roulette magique droite |roulette magique droite vers le bas| +|Aller à la cellule braille |routage| +|touche maj+tab |barreEspacebraille+point1+point2| +|touche tab |barreEspacebraille+point4+point5| +|touche flèche haut |barreEspacebraille+point1| +|touche flèche bas |barreEspacebraille+point4| +|touche contrôle+flèche gauche |barreEspacebraille+point2| +|touche contrôle+flèche droite |barreEspacebraille+point5| +|flèche gauche |barreEspacebraille+point3| +|flèche droite |barreEspacebraille+point6| +|touche origine |barreEspacebraille+point1+point3| +|touche fin |barreEspacebraille+point4+point6| +|touche contrôle+début |barreEspacebraille+point1+point2+point3| +|touche contrôle+fin |barreEspacebraille+point4+point5+point6| +|touche alt |barreEspacebraille+point1+point3+point4| +|touche alt+tab |barreEspacebraille+point2+point3+point4+point5| +|touche alt+maj+tab |BarreEspacebeBraille+point1+poin2+point5+point6| +|touche windows+tab |barreEspaceBraille+point2+point3+point4| +|touche échap |barreEspacebraille+point1+point5| +|touche Windows |barreEspacebraille+point2+point4+point5+point6| +|touche espace |barreEspacebraille| +|Bascule touche contrôle |barreEspaceBraille+point3+point8| +|Bascule touche alt |barreEspaceBraille+point6+point8| +|Bascule touche Windows |barreEspaceBraille+point4+point8| +|Bascule touche NVDA |barreEspaceBraille+point5+point8| +|Bascule touche majuscule |barreEspaceBraille+point7+point8| +|Bascule touches contrôle et majuscule |barreEspaceBraille+point3+point7+point8| +|Bascule touche alt et majuscule |barreEspaceBraille+point6+point7+point8| +|Bascule touches Windows et majuscule |barreEspaceBraille+point4+point7+point8| +|Bascule touches NVDA et majuscule |barreEspaceBraille+point5+point7+point8| +|Bascule touches contrôle et alt |barreEspaceBraille+point3+point6+point8| +|bascule contrôle, alt et majuscule keys |barreEspaceBraille+point3+point6+point7+point8| +|touche Windows+d (minimiser toutes les applications) |barreEspacebraille+point1+point2+point3+point4+point5+point6| +|Rapporter la ligne courante |barreEspacebraille+point1+point4| +|menu NVDA |barreEspacebraille+point1+point3+point4+point5| + +Pour les nouveaux modèles de Focus qui ont des touches de bascule (focus 40, Focus 80 et Focus Blue) : + +| Nom |Touche| +|---|---| +|Déplacer l'affichage braille vers la ligne précédente |barreBasculeGaucheeHaut, barreBasculeDroiteHaut| +|Déplacer l'affichage braille vers la ligne suivante |barreBasculeGaucheBas, barreBasculeDroiteBas| + +Pour le Focus 80 seulement : + +| Nom |Touche| +|---|---| +|Défiler le braille vers l'arrière |barreBumperHaut, barreBumperHaut| +|Défiler vers l'avant |barreBumperBas, barreBumperBas| + + + +### Séries Optelec ALVA 6/Convertisseur de Protocole {#OptelecALVA} + +Les terminaux BC640 et BC680 de chez [Optelec](https://www.optelec.com/) sont pris en charge quand ils sont connectés en USB ou Bluetooth. +Par ailleurs, vous pouvez connecter un terminal Optelec plus ancien, tel qu'un Braille Voyager, en utilisant un convertisseur de protocole fourni par Optelec. +Vous n'avez besoin d'aucun pilote particulier pour utiliser ces terminaux. +Il suffit de brancher le terminal et de configurer NVDA pour l'utiliser. + +Note : NVDA pourrait être incapable d'utiliser un terminal ALVA BC6 via Bluetooth s'il est appairé en utilisant l'utilitaire ALVA Bluetooth. +Si vous avez appairé votre terminal en utilisant cet utilitaire et que NVDA est incapable de le détecter, nous vous recommandons d'appairer votre terminal ALVA de façon standard en utilisant les paramètres Bluetooth de Windows. + +Note : Bien que certains de ces terminaux aient un clavier braille, ils prennent en charge la conversion braille vers texte par eux-mêmes par défaut. +Cela signifie que le système de saisie du braille de NVDA n'est pas utilisé dans la situation par défaut (le paramètre table de saisie braille n'a pas d'effet). +Pour les terminaux ALVA avec un microprogramme récent, il est possible de désactiver cette simulation de clavier HID en utilisant un geste de commande. + +Voici les assignations de touches pour ces terminaux avec NVDA. +Veuillez consulter la documentation du terminal pour savoir où se situent ces touches. + + +| Nom |Touche| +|---|---| +|Défilement arrière de l'affichage braille |t1, etouch1| +|Amener l'affichage braille à la ligne précédente |t2| +|Aller au focus courant |t3| +|Amener l'affichage braille à la ligne suivante |t4| +|Défilement avant de l'affichage braille |t5, etouch3| +|Aller à la cellule braille |routage| +|Annoncer la mise en forme du texte sous la cellule braille |routage secondaire| +|Activer/désactiver la simulation de clavier HID |t1+spEnter| +|Aller à la première ligne en mode revue |t1+t2| +|Aller à la dernière ligne en mode revue |t4+t5| +|Bascule du suivi braille |t1+t3| +|Annonce du titre |etouch2| +|Annonce de la barre d'état |etouch4| +|Touche maj+tab |sp1| +|Touche alt |sp2, alt| +|Touche échap |sp3| +|Touche tab |sp4| +|Flèche haut |spUp| +|Flèche bas |spDown| +|Flèche gauche |spLeft| +|Flèche droite |spRight| +|Entrée |spEnter, enter| +|date et heure |sp2+sp3| +|Menu NVDA |sp1+sp3| +|Touche Windows+d (Minimiser toutes les applications) |sp1+sp4| +|Touche Windows+b (focus sur la zone de notification) |sp3+sp4| +|Touche Windows |sp1+sp2, windows| +|Touche alt+tab |sp2+sp4| +|Touche contrôle+début |t3+spUp| +|Touche contrôle+fin |t3+spDown| +|Touche début |t3+spLeft| +|Touche fin |t3+spRight| +|touche contrôle |contrôle| + + + +### Les Terminaux Handy Tech {#HandyTech} + +NVDA prend en charge la plupart des terminaux de chez [Handy Tech](https://www.handytech.de/) quand ils sont connectés en USB, par port série ou en Bluetooth. +Pour les terminaux USB les plus anciens, vous devrez installer le pilote USB Handy Tech sur votre système. + +Les terminaux suivants ne sont pas nativement supportés, mais peuvent être utilisé via [le pilote universel Handy Tech](https://handytech.de/en/service/downloads-and-manuals/handy-tech-software/braille-display-drivers) et l'extension NVDA : + +* Braillino +* Bookworm +* Les afficheurs modulaires avec le microprogramme version 1.13 ou inférieure. Veuillez noter que le microprogramme de ces afficheurs peut être mis à jour. + +Voici les assignations de touches pour ces terminaux avec NVDA. +Veuillez consulter la documentation du terminal pour savoir où se situent ces touches. + + +| Nom |Touche| +|---|---| +|Défilement arrière de l'affichage braille |left, up, b3| +|Défilement avant de l'affichage braille |right, down, b6| +|Amener l'affichage braille à la ligne précédente |b4| +|Amener l'affichage braille à la ligne suivante |b5| +|Aller à la cellule braille |routage| +|Touche maj+tab |esc, touche triple action gauche haut+bas| +|Touche alt |b2+b4+b5| +|Touche échap |b4+b6| +|Touche tab |enter, touche triple action droite haut+bas| +|Touche entrée |esc+enter, touche triple action gauche+droite haut+bas, JoystickAction| +|Flèche haut |joystick haut| +|Flèche bas |joystick bas| +|Flèche gauche |joystick gauche| +|Flèche droite |joystick droit| +|Menu NVDA |b2+b4+b5+b6| +|Bascule braille suit |b2| +|Bascule du curseur braille |b1| +|Bascule de présentation du contexte du focus |b7| +|Bascule de la saisie braille |space+b1+b3+b4 (space+capital B)| + + + +### Le Terminal MDV Lilli {#MDVLilli} + +Le terminal braille Lilli distribué par [MDV](https://www.mdvbologna.it/) est supporté. +Vous n'avez besoin d'aucun pilote particulier pour utiliser ce terminal. +Il suffit de brancher le terminal et de configurer NVDA pour l'utiliser. + +Ce terminal ne supporte pas la détection automatique en arrière-plan. + +Voici les assignations de touches pour ce terminal avec NVDA. +Veuillez consulter la documentation du terminal pour savoir où se situent ces touches. + + +| Nom |Touche| +|---|---| +|Défilement arrière de l'affichage braille |LF| +|Défilement avant de l'affichage braille |RG| +|Amener l'affichage braille à la ligne précédente |UP| +|Amener l'affichage braille à la ligne suivante |DN| +|Aller à la cellule braille |route| +|Touche maj+tab |SLF| +|Touche tab |SRG| +|Touche alt+tab |SDN| +|Touche alt+maj+tab |SUP| + + + +### Les Terminaux Baum/Humanware/APH/Orbit {#Baum} + +Plusieurs terminaux [Baum](https://www.baum.de/cms/en/), [HumanWare](https://www.humanware.com/), [APH](https://www.aph.org/) et [Orbit](https://www.orbitresearch.com/) sont pris en charge quand ils sont connectés via USB, Bluetooth ou série. +Les terminaux suivants sont pris en charge : + +* Baum: SuperVario, PocketVario, VarioUltra, Pronto!, SuperVario2, Vario 340 +* HumanWare: Brailliant, BrailleConnect, Brailliant2 +* APH: Refreshabraille +* Orbit: Orbit Reader 20 + +Il est possible que d'autres terminaux fabriqués par Baum fonctionnent, mais cela n'a pas été testé. + +Si vous connectez via USB des terminaux qui n'utilisent pas le mode HID, vous devrez d'abord installer les pilotes USB fournis par le constructeur. +Le VarioUltra et le Pronto! utilisent HID. +Le Refreshabraille et l'Orbit Reader 20 peuvent utiliser HID si configurés de manière appropriée. + +Le mode USB série de l'Orbit Reader 20 n'est actuellement pris en charge que sous Windows 10 et versions ultérieures. +USB HID devrait en général être utilisé à la place. + +Voici les assignations de touches pour ces terminaux avec NVDA. +Veuillez consulter la documentation du terminal pour savoir où se situent ces touches. + + +| Nom |Touche| +|---|---| +|Défilement arrière affichage braille |`d2`| +|Défilement avant affichage braille |`d5`| +|Amener l'affichage sur la ligne précédente |`d1`| +|Amener l'affichage sur la ligne suivante |`d3`| +|Aller à la cellule braille |`routage`| +|touche `Maj+tab` |`espace+point1+point3`| +|touche `tab` |`espace+point4+point6`| +|touche `alt` |`espace+point1+point3+point4` (`espace+m`)| +|touche `échap` |`espace+point1+point5` (`espace+e`)| +|touche `windows` |`espace+point3+point4`| +|touche `alt+tab` |`espace+point2+point3+point4+point5` (`espace+t`)| +|Menu NVDA |`espace+point1+point3+point4+point5` (`espace+n`)| +|touche `windows+d` (minimiser toutes les applications) |`espace+point1+point4+point5` (`espace+d`)| +|Dire tout |`espace+point1+point2+point3+point4+point5+point6`| + +Pour les terminaux possédant un joystick: + +| Nom |Touche| +|---|---| +|Flèche haut |haut| +|Flèche bas |bas| +|Flèche gauche |gauche| +|Flèche droite |droite| +|Touche entrée |select| + + + +### Hedo ProfiLine USB {#HedoProfiLine} + +Le terminal Hedo ProfiLine USB de [Hedo Reha-Technik](https://www.hedo.de/) est supporté. +Vous devrez tout d'abord installer le pilote USB fourni par le constructeur. + +Ce terminal ne supporte pas encore la détection automatique en arrière-plan. + +Voici les assignations de touches pour ce terminal sous NVDA. +Veuillez consulter la documentation du terminal pour savoir où se situent ces touches. + + +| Nom |Touche| +|---|---| +|Défilement arrière de l'affichage |K1| +|Défilement avant de l'affichage |K3| +|Ligne précédente |B2| +|Ligne suivante |B5| +|Aller à la cellule braille |routage| +|Bascule braille suit |K2| +|Dire tout |B6| + + + +### Hedo MobilLine USB {#HedoMobilLine} + +Le terminal Hedo MobilLine USB de [Hedo Reha-Technik](https://www.hedo.de/) est supporté. +Vous devrez tout d'abord installer le pilote USB fourni par le constructeur. + +Ce terminal ne supporte pas encore la détection automatique en arrière-plan. + +Voici les assignations de touches pour ce terminal sous NVDA. +Veuillez consulter la documentation du terminal pour savoir où se situent ces touches. + + +| Nom |Touche| +|---|---| +|Défilement arrière de l'affichage |K1| +|Défilement avant de l'affichage |K3| +|Ligne précédente |B2| +|Ligne suivante |B5| +|Aller à la cellule braille |routage| +|Bascule braille suit |K2| +|Dire tout |B6| + + + +### HumanWare Séries Brailliant BI/B / BrailleNote Touch {#HumanWareBrailliant} + +Les terminaux des séries Brailliant BI & B de [HumanWare](https://www.humanware.com/), incluant le BI 14, BI 32, BI 20X, BI 40, BI 40X et B 80 sont supportés quand ils sont connectés via USB ou Bluetooth. +S'ils sont connectés en USB avec le protocole réglé sur HumanWare, vous devez d'abord installer le pilote USB fourni par le constructeur. +Les pilotes USB ne sont pas nécessaires si le protocole est réglé sur OpenBraille. + +Les terminaux suivants sont également supportés (et ne nécessitent aucun pilote spécial pour être installés): + +* APH Mantis Q40 +* APH Chameleon 20 +* Humanware BrailleOne +* NLS eReader + * Notez que le Zoomax n'est actuellement pas pris en charge sans pilotes externes + +Voici les assignations de touches pour Brailliant BI/B et BrailleNote touch sous NVDA. +Veuillez consulter la documentation du terminal pour savoir où se situent ces touches. + +#### Assignations des Touches pour tous les Modèles {#HumanWareBrailliantKeyAssignmentForAllModels} + + + +| Nom |Touche| +|---|---| +|Défilement arrière de l'affichage |gauche| +|Défilement avant de l'affichage |droite| +|Ligne précédente |haut| +|Ligne suivante |bas| +|Aller à la cellule braille |routage| +|Bascule d'attachement du braille |haut+bas| +|Touche flèche haut |espace+point1| +|Touche flèche bas |espace+point4| +|Touche flèche gauche |espace+point3| +|Touche flèche droite |espace+point6| +|Touche maj+tab |espace+point1+point3| +|Touche tab |espace+point4+point6| +|Touche alt |espace+point1+point3+point4 (espace+m)| +|Touche échap |espace+point1+point5 (espace+e)| +|Touche entrée |point8| +|Touche Windows |espace+point3+point4| +|Touche alt+tab |Espace+point2+point3+point4+point5 (espace+t)| +|Menu NVDA |c1+c3+c4+c5 (commande n)| +|Touche Windows+d (minimiser toutes les applications) |c1+c4+c5 (commande d)| +|Dire tout |c1+c2+c3+c4+c5+c6| + + + +#### Assignations de Touches pour les Brailliant BI 32, BI 40 et B 80 {#HumanWareBrailliantKeyAssignmentForBI32BI40AndB80} + + + +| Nom |Touche| +|---|---| +|Menu NVDA |c1+c3+c4+c5 (commande n)| +|Touche windows+d (minimiser toutes les applications) |c1+c4+c5 (commande d)| +|Dire tout |c1+c2+c3+c4+c5+c6| + + + +#### Assignations de Touches pour le Brailliant BI 14 {#HumanWareBrailliantKeyAssignmentForBI14} + + + +| Nom |Touche| +|---|---| +|touche flèche haut |joystick vers le haut| +|touche flèche bas |joystick vers le bas| +|touche flèche gauche |joystick vers la gauche| +|touche flèche droit |joystick vers la droite| +|touche entrée |joystick action| + + + +### HIMS Braille Sense/Braille EDGE/Smart Beetle/Sync Braille Series {#Hims} + +NVDA supporte les afficheurs braille Braille Sense, Braille EDGE, Smart Beetle et Sync Braille de [Hims](https://www.hims-inc.com/) quand ils sont connectés via USB ou Bluetooth. +Si vous connectez votre afficheur braille par USB, vous devrez installer les [pilotes USB de HIMS](http://www.himsintl.com/upload/HIMS_USB_Driver_v25.zip) sur votre système. + +Voici les assignations de touches pour ce terminal sous NVDA. +Veuillez consulter la documentation du terminal pour savoir où se situent ces touches. + + +| Nom |Touche| +|---|---| +|Aller à la cellule braille |routage| +|Défilement arrière de l'affichage braille |défilementHautDeGauche, défilementHautDeDroite, défilementDeGauche| +|Défilement avant de l'affichage braille |défilementBasDeGauche, défilementBasDeDroite, défilementDeDroite| +|Amener l'affichage à la ligne précédente |défilementHautDeGauche+défilementHautDeDroite| +|Amener l'affichage à la ligne suivante |défilementBasDeGauche+défilementBasDeDroite| +|Aller à la ligne précédente en revue |flècheHautDeDroite| +|Aller à la ligne suivante en revue |flècheBasDeDroite| +|Aller au caractère précédent en revue |flècheGaucheDeDroite| +|Aller au caractère suivant en revue |flècheDroiteDeDroite| +|Aller au focus courant |défilementHautDeGauche+défilementBasDeGauche, défilementHautDeDroite+défilementBasDeDroite, défilementDeGauche+défilementDeDroite| +|Touche contrôle |smartbeetle:f1, brailleedge:f3| +|Touche Windows |f7, smartbeetle:f2| +|Touche alt |point1+point3+point4+espace, f2, smartbeetle:f3, brailleedge:f4| +|Touche majuscule |f5| +|Touche insertion |point2+point4+espace, f6| +|Touche applications |point1+point2+point3+point4+espace, f8| +|Verrouillage majuscule |point1+point3+point6+espace| +|touche tabulation |point4+point5+espace, f3, brailleedge:f2| +|maj+alt+tab |f2+f3+f1| +|alt+tab |f2+f3| +|maj+tab |point1+point2+espace| +|Touche fin |point4+point6+espace| +|contrôle+fin |point4+point5+point6+espace| +|Touche début |point1+point3+espace, smartbeetle:f4| +|contrôle+début |point1+point2+point3+espace| +|alt+f4 |point1+point3+point5+point6+espace| +|flèche gauche |point3+espace, flècheGaucheDeGauche| +|contrôle+maj+flècheGauche |point2+point8+espace+f1| +|contrôle+flècheGauche |point2+espace| +|maj+alt+flècheGauche |point2+point7+f1| +|`alt+flècheGauche` |`point2+point7+espace`| +|flècheDroite |point6+espace, flècheDroiteDeGauche| +|contrôle+maj+flècheDroite |point5+point8+espace+f1| +|contrôle+flècheDroite |point5+espace| +|maj+alt+flècheDroite |point5+point7+f1| +|`alt+flècheDroite` |`point5+point7+espace`| +|pagePrec |point1+point2+point6+espace| +|contrôle+pagePrec |point1+point2+point6+point8+espace| +|Touche flècheHaut |point1+espace, flècheHautDeGauche| +|contrôle+maj+flècheHaut |point2+point3+point8+espace+f1| +|contrôle+flècheHaut |point2+point3+espace| +|maj+alt+flècheHaut |point2+point3+point7+f1| +|`alt+flècheHaut` |`point2+point3+point7+espace`| +|maj+flècheHaut |DéfilementBasDeGauche+espace| +|pageSuiv |point3+point4+point5+espace| +|contrôle+pageSuiv |point3+point4+point5+point8+espace| +|Touche flècheBas |point4+espace, flècheBasDeGauche| +|contrôle+maj+flècheBas |point5+point6+point8+espace+f1| +|contrôle+flècheBas |point5+point6+espace| +|maj+alt+flècheBas |point5+point6+point7+f1| +|`alt+flècheBas` |`point5+point6+point7+espace`| +|maj+flècheBas |espace+défilementBasDeDroite| +|Touche échap |point1+point5+espace, f4, brailleedge:f1| +|touche effacement |point1+point3+point5+espace, point1+point4+point5+espace| +|touche f1 |point1+point2+point5+espace| +|touche f3 |point1+point4+point8+espace| +|touche f4 |point7+f3| +|windows+b |point1+point2+f1| +|windows+d |point1+point4+point5+f1| +|contrôle+insert |smartbeetle:f1+défilementDeDroite| +|alt+insert |smartbeetle:f3+défilementDeDroite| + + + +### Seika Braille Displays {#Seika} + +Les afficheurs braille Seika suivants de Nippon Telesoft sont pris en charge en deux groupes avec des fonctionnalités différentes : + +* [Seika Version 3, 4, et 5 (40 cellules), Seika80 (80 cellules)](#SeikaBrailleDisplays) +* [MiniSeika (16, 24 cellules), V6, et V6Pro (40 cellules)](#SeikaNotetaker) + +Vous pouvez trouver plus d'informations concernant ces afficheurs sur leur [Page de téléchargement de démos et de pilotes](https://en.seika-braille.com/down/index.html). + +#### Seika Version 3, 4, et 5 (40 cellules), Seika80 (80 cellules) {#SeikaBrailleDisplays} + +* Ces terminaux ne supporte pas encore la détection automatique en arrière-plan. +* Sélectionnez "Terminaux Braille Seika" pour configurer manuellement +* Un pilote doit être installé avant d'utiliser les Seika v3/4/5/80. +Les pilotes sont [fournis par le fabriquant](https://en.seika-braille.com/down/index.html). + +Voici les assignations de touches pour le terminal Seika Braille : +Veuillez consulter la documentation du terminal pour savoir où se situent ces touches. + + +| Nom |Touche| +|---|---| +|Défilement arrière de l'affichage braille |gauche| +|Défilement avant de l'affichage braille |droite| +|Déplacer l'afficheur braille à la ligne précédente |B3| +|Déplacer l'afficheur braille à la ligne suivante |b4| +|Basculer le suivi braille |b5| +|Dire tout |b6| +|tab |b1| +|maj+tab |b2| +|alt+tab |b1+b2| +|Menu NVDA |gauche+droite| +|Aller à la cellule braille |route (amener le curseur au caractère)| + + + +#### MiniSeika (16, 24 cellules), V6, et V6Pro (40 cellules) {#SeikaNotetaker} + +* La détection automatique de l'afficheur braille en arrière-plan de NVDA est prise en charge via USB et Bluetooth. +* Sélectionnez "Seika Notetaker" ou "automatique" pour configurer. +* Aucun pilote supplémentaire n'est requis lors de l'utilisation d'un afficheur braille Seika Notetaker. + +Voici les assignation de touches pour le Seika Notetaker. +Veuillez consulter la documentation du terminal pour savoir où se situent ces touches. + + +| Nom |Touche| +|---|---| +|Défilement braille vers la gauche |gauche| +|Défilement braille vers la droite |droite| +|Dire tout |espace+RetourArrière| +|Menu NVDA |Gauche+Droite| +|Amener l'afficheur braille à la ligne précédente |LJ haut| +|Amener l'afficheur braille à la ligne suivante |LJ bas| +|Basculer le suivi braille |LJ centre| +|tab |LJ droite| +|Maj+tab |LJ gauche| +|FlècheHaut |RJ haut| +|FlècheBas |RJ bas| +|FlècheGauche |RJ gauche| +|FlècheDroite |RJ droit| +|Aller à la cellule braille |routage| +|maj+flècheHaut |Espace+RJ haut, RetourArrière+RJ haut| +|Maj+flècheBas |Espace+RJ bas, RetourArrière+RJ bas| +|maj+flèchegauche |Espace+RJ gauche, RetourArrière+RJ gauche| +|maj+flècheDroite |Espace+RJ droit, RetourArrière+RJ droit| +|touche entrée |RJ centre, point8| +|touche échap |Espace+RJ centre| +|touche windows |RetourArrière+RJ centre| +|touche espace |Espace, RetourArrière| +|touche RetourArrière |point7| +|touche pagePrec |Espace+LJ droit| +|touche pageSuiv |Espace+LJ gauche| +|touche début |espace+LJ haut| +|touche fin |espace+LJ bas| +|touche contrôle+début |retourArrière+LJ haut| +|touche contrôle+fin |retourArrière+LJ bas| + +### Nouveaux Modèles de Papenmeier brailleX {#Papenmeier} + +Les afficheurs braille suivant sont supportés : + +* BrailleX EL 40c, EL 80c, EL 20c, EL 60c (USB) +* BrailleX EL 40s, EL 80s, EL 2d80s, EL 70s, EL 66s (USB) +* BrailleX Trio (USB et Bluetooth) +* BRAILLEX Live 20, BRAILLEX Live et BRAILLEX Live Plus (USB et Bluetooth) + +Ces terminaux ne supporte pas la détection automatique en arrière-plan. +Il existe une option dans le pilote USB de l'afficheur qui peut entraîner un problème de chargement de l'afficheur. +Veuillez essayez ce qui suit: + +1. Veuillez vous assurer que vous avez installé le [dernier pilote](https://www.papenmeier-rehatechnik.de/en/service/downloadcenter/software/articles/software-braille-devices.html). +1. Ouvrez le Gestionnaire de périphériques Windows. +1. Faites défiler la liste jusqu'à "Contrôleurs USB" ou "Périphériques USB". +1. Sélectionnez "Périphérique USB Papenmeier Braillex". +1. Ouvrez les propriétés et passez à l'onglet "Avancé". +Parfois, l'onglet "Avancé" n'apparaît pas. +Si tel est le cas, déconnectez la plage braille de l'ordinateur, quittez NVDA, attendez un moment et reconnectez la plage braille. +Répétez cette opération 4 à 5 fois si nécessaire. +Si l'onglet "Avancé" ne s'affiche toujours pas, veuillez redémarrer l'ordinateur. +1. Désactivez l'option "Load VCP". + +La plupart des afficheurs ont une barre d'accès facile (EAB) qui permet des opérations intuitives et rapides. +L'EAB peut être bougé dans quatre directions et chaque direction a deux crans. +Les séries C et Live sont les seules exceptions à cette règle. + +La série-C et quelques autres afficheurs ont deux rangées de routines où celle du haut sert à rapporter les informations de mise en forme. +Garder enfoncée une des routines du haut puis appuyer sur l'EAB sur une Série-C annule le second cran. +Les terminaux des séries Live n'ont qu'une ligne de routines et l'EAB n'a qu'un cran par direction. +Le second cran peut être reproduit en pressant une des touches de routage et en pressant l'EAB dans la direction correspondante. +Appuyer et garder les touches haute, basse, gauche et droite (ou EAB) répète la dernière commande. + +Généralement, les touches suivantes sont disponibles sur ces afficheurs braille : + +| Nom |touche| +|---|---| +|l1 |touche gauche devant| +|l2 |touche gauche derrière| +|r1 |touche droite devant| +|r2 |touche droite derrière| +|haut |Monter une fois vers le haut| +|haut2 |Monter deux fois vers le haut| +|gauche |un vers la gauche| +|gauche2 |deux vers la gauche| +|droite |un vers la droite| +|droite2 |deux vers la droite| +|dn |un vers le bas| +|dn2 |deux vers le bas| + +Voici les commandes assignées pour les afficheurs Papenmeier dans NVDA : + + +| Nom |Touche| +|---|---| +|Défilement arrière de l'affichage braille |left| +|Défilement avant de l'affichage braille |right| +|Déplacer l'afficheur braille à la ligne précédente |up| +|Déplacer le braille à la ligne suivante |dn| +|Aller à la cellule braille |routage| +|Lire le caractère sous le curseur de revue |l1| +|Activer l'objet courant du navigateur |l2| +|Bascule braille suit |r2| +|Lire le titre |l1+up| +|Lire la barre d'état |l2+down| +|Aller à l'objet parent |up2| +|Aller à l'objet enfant |dn2| +|Aller à l'objet précédent |left2| +|Aller à l'objet suivant |right2| +|Annoncer l'information de mise en forme du texte sous la cellule braille |rangée de routines du haut| + + + +Le modèle Trio à quatre touches additionnelles en face du clavier braille. +Elles sont (ordonnées de gauche à droite) : + +* Touche thumb gauche (lt) +* Espace +* Espace +* Touche thumb droite (rt) + +Pour le moment, rt n'est pas utilisée. +Les touches intérieures font toutes les deux espace. + + + +| Nom |Touche| +|---|---| +|touche échap |espace avec point 7| +|touche flèche haute |espace avec point 2| +|touche flèche gauche |espace avec point 1| +|touche flèche droite |espace avec point 4| +|touche flèche basse |espace avec point 5| +|touche contrôle |lt+point 2| +|touche alt |lt+point 3| +|touches contrôle+échap |espace avec les points 1 2 3 4 5 6| +|touche tab |espace avec points 3 7| + + + +### Papenmeier Braille BrailleX Modèles Anciens {#PapenmeierOld} + +Les afficheurs braille suivants sont supportés : + +* BrailleX EL 80, EL 2D-80, EL 40 P +* BrailleX Tiny, 2D Screen + +Notez que ces afficheurs ne peuvent être connectés qu'en port série. +De ce fait, ils ne supportent pas la détection automatique en arrière-plan. +Vous devez donc sélectionner le port série où l'afficheur est connecté après avoir sélectionné le pilote dans le dialogue [Choisir l'Afficheur Braille](#SelectBrailleDisplay). + +Certains de ces périphériques ont une barre d'accès facile (EAB) qui permet une opération rapide et intuitive. +L'EAB peut être bougée dans quatre directions où chaque direction a généralement deux crans. +Garder appuyée la touche haut, basse, gauche, droite (ou EAB) répète l'action correspondante. +Les anciens modèles n'ont pas d'EAB ; les touches de façade sont utilisées à la place. + +Globalement, les touches suivantes sont disponibles sur les afficheurs braille : + +| Nom |Touche| +|---|---| +|l1 |Touche avant gauche| +|l2 |Touche arrière droite| +|r1 |Touche avant droite| +|r2 |Touche arrière droite| +|up |1 appui vers le haut| +|up2 |2 appuis vers le haut| +|left |1 appui gauche| +|left2 |2 appuis gauche| +|right |1 appui à droite| +|right2 |2 appuis à droite| +|dn |1 appui en bas| +|dn2 |2 appuis en bas| + +Les commandes Papenmeier disponibles dans NVDA sont les suivantes : + + +Périphériques avec EAB : + +| Nom |Touche| +|---|---| +|Défilement affichage braille arrière |left| +|Défilement affichage braille avant |right| +|Déplacer l'affichage braille vers la ligne précédente |up| +|Déplacer l'affichage braille vers la ligne suivante |down| +|Joindre à la cellule braille |routage| +|Annoncer le caractère courant sous la revue |l1| +|Activer l'objet courant du navigateur |l2| +|Dire titre |l1up| +|Lire barre d'état |l2down| +|Aller à l'objet contenant |up2| +|Aller au premier objet contenu |dn2| +|Aller à l'objet suivant |right2| +|Aller à l'objet précédant |left2| +|Annoncer l'information de mise en forme du texte sous la cellule braille |rangée de routines du haut| + +BRAILLEX Tiny : + +| Nom |Touche| +|---|---| +|Annoncer le caractère sous le curseur de revue |l1| +|Activer l'objet sous le navigateur |l2| +|Défiler le braille vers l'arrière |left| +|Défiler le braille vers l'avant |right| +|Déplacer le braille à la ligne précédente |up| +|Déplacer le braille à la ligne suivante |dn| +|Basculer le suivi du braille |r2| +|Aller à l'objet contenant |r1+up| +|Aller au premier objet contenu |r1+dn| +|Aller à l'objet précédent |r1+left| +|Aller à l'objet suivant |r1+right| +|Annoncer l'information de mise en forme du texte sous la cellule braille |rangée de routines du haut| +|Annoncer le titre |l1+up| +|Annoncer la barre d'état |l2+down| + +brailleX 2D Screen: + +| Nom |Touche| +|---|---| +|Annoncer le caractère sous le curseur de revue |l1| +|Activer l'objet sous le navigateur |l2| +|Basculer le suivi du braille |r2| +|Annoncer l'information de mise en forme du texte sous la cellule braille |rangée de routines du haut| +|Déplacer le braille à la ligne précédente |up| +|Défiler le braille vers l'arrière |left| +|Défiler le braille vers l'avant |right| +|Déplacer le braille à la ligne suivante |dn| +|Aller à l'objet suivant |left2| +|Aller à l'objet contenant |up2| +|Aller au premier objet contenu |dn2| +|Aller à l'objet précédent |right2| + + + +### BrailleNote de HumanWare {#HumanWareBrailleNote} + +NVDA supporte les bloc-notes BrailleNote de [HumanWare](https://www.humanware.com) lorsque ceux-ci agissent comme afficheurs braille pour un lecteur d'écran. +Les modèles suivants sont supportés : + +* BrailleNote Classic (connexion série seulement) +* BrailleNote PK (connexion Série et Bluetooth) +* BrailleNote MPower (connexion Série et Bluetooth) +* BrailleNote Apex (connexion Bluetooth et USB) + +Pour le BrailleNote Touch, Veuillez vous référer à la section [Séries Brailliant BI / BrailleNote Touch](#HumanWareBrailliant). + +Excepté pour le BrailleNote PK, les claviers braille (BT) et QWERTY (QT) sont supportés. +Pour le BrailleNote QT, l'émulation de clavier PC n'est pas supportée. +Vous pouvez également entrer les points braille en utilisant le clavier QT. +Veuillez consulter la section terminal braille du manuel BrailleNote pour plus de détails. + +Si votre périphérique supporte plusieurs types de connexion, en connectant votre BrailleNote à NVDA, vous devrez définir le port dans les options de votre afficheur braille. +Lisez le manuel de votre BrailleNote pour plus de détails. +Dans NVDA, vous devrez peut-être également configurer le port dans le dialogue [Choisir l'Afficheur Braille](#SelectBrailleDisplay). +Si vous le connectez via USB ou Bluetooth, vous pouvez le configurer sur "Automatique", "USB" ou "Bluetooth" selon ce qui est disponible. +Si vous le connectez à un port série ou un convertisseur USB-Série ou si aucune de ces dernières options n'apparaît, vous devez choisir explicitement le port de communication à utiliser dans la liste des ports matériels. + +Avant de connecter votre BrailleNote Apex en utilisant son interface client USB, vous devez installer le pilote fourni par HumanWare. + +Sur le BrailleNote Apex BT, vous pouvez utiliser la roue de défilement située entre les points 1 et 4 pour diverses commandes NVDA. +La roue consiste en 4 points directionnels, un bouton central de clic, et une roue qui peut tourner dans le sens des aiguilles d'une montre ou inversement. + +Voici les assignations de touches du BrailleNote pour NVDA. +Consultez la documentation de votre BrailleNote pour savoir où se situent ces touches. + + + +| Nom |touche| +|---|---| +|Défilement affichage braille arrière |Arrière| +|Défilement affichage braille avant |Avant| +|Déplacer l'affichage braille vers la ligne précédente |Précédent| +|Déplacer l'affichage braille vers la ligne suivante |Suivant| +|Joindre à la cellule braille |routage| +|menu NVDA |espace+point1+point3+point4+point5 (espace+n)| +|Basculer le suivi de l'affichage braille |Précédent+Suivant| +|Touche Flèche haute |Espace+Point 1| +|Touche Flèche basse |Espace+Point 4| +|Touche Flèche gauche |Espace+Point 3| +|Touche Flèche droite |Espace+Point 6| +|Touche page précédente |Espace+Point 1+Point 3| +|Touche Page Suivante |Espace+Point4+Point6| +|Touche Origine |Espace+Point1+Point2| +|Touche fin |Espace+Point4+Point5| +|Contrôle+Origine |Espace+Point1+Point2+Point3| +|Touche Espace |Espace| +|Contrôle+Fin |Espace+Point4+Point5+Point6| +|Entrée |Espace+Point8| +|Touche retour arrière |Espace+Point7| +|Touche Tab |Espace+Point2+Point3+Point4+Point5 (Espace+t)| +|Maj+Tab |Espace+Point1+Point2+Point5+Point6| +|Touche Windows |Espace+Point2+Point4+Point5+Point6| +|Touche alt |Espace+Point1+Point3+Point4 (Espace+m)| +|Basculer aide à la saisie |Espace+Point2+Point3+Point6 (Espace+h en bas)| + +Voici les commandes assignées au BrailleNote QT quand il n'est pas en mode saisie braille : + +| Nom |Touche| +|---|---| +|menu NvDA |lecture+n| +|touche flèche haut |flècheHaut| +|touche flèche bas |flècheBas| +|touche flèche gauche |flècheGauche| +|touche flèche droite |flècheDroite| +|touche pagePrec |fonction+flècheHaut| +|touche pageSuiv |fonction+flècheBas| +|touche début |fonction+flècheGauche| +|touche fin |fonction+flècheDroite| +|touche contrôle+début |lecture+t| +|touche contrôle+fin |lecture+b| +|touche entrée |entrée| +|touche retour arrière |retourArrière| +|touche tab |tab| +|touche maj+tab keys |maj+tab| +|touche windows |lecture+w| +|touche alt |lecture+m| +|bascule de l'aide à la saisie |lecture+1| + +Voici les commandes assignées à la roue de défilement : + +| Nom |Touche| +|---|---| +|touche flècheHaut |flècheHaut| +|touche flècheBas |flècheBas| +|touche flècheGauche |flècheGauche| +|touche flècheDroite |flècheDroite| +|touche entrée |bouton central| +|touche tab |tourner la roue dans le sens des aiguilles d'une montre| +|touche maj+tab |tourner la roue dans le sens inverse des aiguilles d'une montre| + + + +### EcoBraille {#EcoBraille} + +NVDA supporte Les afficheurs EcoBraille de [ONCE](https://www.once.es/). +Les modèles suivants sont supportés : + +* EcoBraille 20 +* EcoBraille 40 +* EcoBraille 80 +* EcoBraille Plus + +Sous NVDA, vous pouvez définir le port série auquel l'afficheur est connecté dans le dialogue [Choisir l'Afficheur Braille](#SelectBrailleDisplay). +Ces terminaux ne supporte pas la détection automatique en arrière-plan. + +Voici les assignations de touche pour les afficheurs EcoBraille. +Veuillez consulter [la documentation EcoBraille](ftp://ftp.once.es/pub/utt/bibliotecnia/Lineas_Braille/ECO/) pour connaître la position de ces touches. + + + +| Nom |Touche| +|---|---| +|Défilement braille arrière |T2| +|Défilement braille avant |T4| +|Amener l'afficheur braille à la ligne précédente |T1| +|Amener l'afficheur braille à la ligne suivante |T5| +|Aller à la cellule braille |Routage| +|Activer l'objet navigateur courant |T3| +|Passer au mode de revue suivant |F1| +|Aller à l'objet contenant |F2| +|Passer au mode de revue précédent |F3| +|Aller à l'objet précédent |F4| +|Annoncer l'objet courant |F5| +|Aller à l'objet suivant |F6| +|Aller à l'objet en focus |F7| +|Aller au premier objet inclus |F8| +|Amener le focus système ou le curseur à la position courante de revue |F9| +|Annoncer la position du curseur de revue |F0| +|Bascule du mode de suivi braille |A| + + + +### SuperBraille {#SuperBraille} + +L'afficheur SuperBraille, principalement disponible à Taiwan, peut être connecté en USB ou en série. +Comme le SuperBraille n'a ni clavier physique ni bouton de défilement, toutes les saisies doivent être effectuées depuis un clavier d'ordinateur standard. +Pour cette raison, et pour maintenir la compatibilité avec d'autres revues d'écran à Taiwan, deux raccourcis clavier pour le défilement de l'affichage ont été définis : + + +| Nom |touche| +|---|---| +|Défilement braille arrière |pavnumMoins| +|Défilement braille avant |pavnumPlus| + + + +### Afficheurs Eurobraille {#Eurobraille} + +Les afficheurs b.book, b.note, Esys, Esytime et Iris d'Eurobraille sont supportés par NVDA. +Ces appareils disposent d'un clavier braille à 10 touches. +Veuillez consulter la documentation de l'afficheur pour une description de ces touches. +Des deux touches placées comme une barre d'espace, la touche gauche correspond à la touche retour arrière et la touche droite à la touche espace. + +Ces appareils sont connectés via USB et disposent d'un clavier USB autonome. +Il est possible d'activer/désactiver ce clavier en basculant "simulation de clavier HID" à l'aide d'un geste de commande. +Les fonctions du clavier braille décrites directement ci-dessous sont lorsque la "simulation du clavier HID" est désactivée. + +#### Fonctions du clavier Braille {#EurobrailleBraille} + + + +| Nom |Touche| +|---|---| +|Effacer la dernière cellule ou le dernier caractère braille saisi |`retourArrière`| +|Traduire n'importe quelle entrée en braille et appuyer sur la touche Entrée |`RetourArrière+espace`| +|Basculer la touche `NVDA` |`point3+point5+espace`| +|touche `insert` |`point1+point3+point5+espace`, `point3+point4+point5+espace`| +|touche `supprimer` |`point3+point6+espace`| +|touche `début` |`point1+point2+point3+espace`| +|touche `fin` |`point4+point5+point6+espace`| +|Touche `flècheGauche` |`point2+espace`| +|Touche `flècheDroite` |`point5+espace`| +|Touche `flècheHaute` |`point1+espace`| +|Touche `flècheBas` |`point6+espace`| +|Touche `pagePrec` |`point1+point3+espace`| +|Touche `pageSuiv` |`point4+point6+espace`| +|touche `pavnum1` |`point1+point6+retourArrière`| +|touche `pavnum2` |`point1+point2+point6+retourArrière`| +|touche `pavnum3` |`point1+point4+point6+retourArrière`| +|touche `pavnum4` |`point1+point4+point5+point6+retourArrière`| +|touche `pavnum5` |`point1+point5+point6+retourArrière`| +|touche `pavnum6` |`point1+point2+point4+point6+retourArrière`| +|touche `pavnum7` |`point1+point2+point4+point5+point6+retourArrière`| +|touche `pavnum8` |`point1+point2+point5+point6+retourArrière`| +|touche `pavnum9` |`point2+point4+point6+retourArrière`| +|Touche `pavnumInser` |`point3+point4+point5+point6+retourArrière`| +|Touche `PavnumDécimal` |`point2+retourArrière`| +|touche `PavnumDiviser` |`point3+point4+retourArrière`| +|Touche `pavnumMultiplier` |`point3+point5+retourArrière`| +|Touche `pavnumMoins` |`point3+point6+retourArrière`| +|touche `PavnumPlus` |`point2+point3+point5+retourArrière`| +|Touche `pavnumEntrée` |`point3+point4+point5+retourArrière`| +|touche `échappement` |`point1+point2+point4+point5+espace`, `l2`| +|touche `tabulation` |`point2+point5+point6+espace`, `l3`| +|touches `maj+tab` |`point2+point3+point5+espace`| +|Touche `impressionÉcran` |`point1+point3+point4+point6+espace`| +|touche `pause` |`point1+point4+espace`| +|touche `applications` |`point5+point6+retourArrière`| +|touche `f1` |`point1+retourArrière`| +|touche `f2` |`point1+point2+retourArrière`| +|touche `f3` |`point1+point4+retourArrière`| +|touche `f4` |`point1+point4+point5+retourArrière`| +|touche `f5` |`point1+point5+retourArrière`| +|touche `f6` |`point1+point2+point4+retourArrière`| +|touche `f7` |`point1+point2+point4+point5+retourArrière`| +|touche `f8` |`point1+point2+point5+retourArrière`| +|touche `f9` |`point2+point4+retourArrière`| +|touche `f10` |`point2+point4+point5+retourArrière`| +|touche `f11` |`point1+point3+retourArrière`| +|touche `f12` |`point1+point2+point3+retourArrière`| +|touche `windows` |`point1+point2+point4+point5+point6+espace`| +|Basculer la touche `windows` |`point1+point2+point3+point4+retourArrière`, `point2+point4+point5+point6+espace`| +|touche `VerMaj` |`point7+retourArrière`, `point8+retourArrière`| +|Touche `VerNum` |`point3+retourArrière`, `point6+retourArrière`| +|touche `maj` |`point7+espace`| +|Basculer la touche `maj` |`point1+point7+espace`, `point4+point7+espace`| +|touche `contrôle` |`point7+point8+espace`| +|Basculer la touche `contrôle` |`point1+point7+point8+espace`, `point4+point7+point8+espace`| +|touche `alt` |`point8+espace`| +|Basculer la touche `alt` |`point1+point8+espace`, `point4+point8+espace`| +|Basculer la simulation du clavier HID |`switch1Gauche+joystick1Bas`, `switch1Droit+joystick1Bas`| + + + +#### commandes clavier b.book {#Eurobraillebbook} + + + +| Nom |Touche| +|---|---| +|Faire défiler l'affichage braille vers l'arrière |`en arrière`| +|Faire défiler l'affichage braille vers l'avant |`en avant`| +|Déplacer vers le focus actuel |`arrière+avant`| +|Route vers cellule braille |`routage`| +|Touche `flècheGauche` |`joystick2gauche`| +|Touche `flècheDroite` |`joystick2Right`| +|Touche `flècheHaut` |`joystick2Haut`| +|Touche `flècheBas` |`joystick2Bas`| +|touche `entrée` |`joystick2Centre`| +|touche `échappement` |`c1`| +|touche `tabulation` |`c2`| +|Basculer la touche `maj` |`c3`| +|Basculer la touche `contrôle` |`c4`| +|Basculer la touche `alt` |`c5`| +|Basculer la touche `NVDA` |`c6`| +|Touche `contrôle+Début` |`c1+c2+c3`| +|Touche `contrôle+Fin` |`c4+c5+c6`| + + + +#### commandes clavier b.note {#Eurobraillebnote} + + + +| Nom |Touche| +|---|---| +|Faire défiler l'affichage braille vers l'arrière |`clavierGaucheGauche`| +|Faire défiler l'affichage braille vers l'avant |`clavierGaucheDroit`| +|Route vers cellule braille |`routage`| +|Signaler la mise en forme du texte sous la cellule braille |`doubleRouting`| +|Passer à la ligne suivante dans la révision |`clavierGaucheBas`| +|Passer au mode de révision précédent |`ClavierGaucheGauche+ClavierGaucheHaut`| +|Passer au mode de révision suivant |`clavierGaucheDroit+clavierGaucheBas`| +|Touche `flèchegauche` |`ClavierDroitGauche`| +|Touche `flèchedroite` |`clavierDroitDroite`| +|Touche `flècheHaut` |`clavierDroitHaut`| +|Touche `flècheBas` |`clavierDroitBas`| +|Touche `contrôle+Début` |`clavierDroitGauche+clavierDroitHaut`| +|Touche `contrôle+fin` |`clavierDroitGauche+clavierDroitHaut`| + + + +#### Commandes clavier Esys {#Eurobrailleesys} + + + +| Nom |Touche| +|---|---| +|Faire défiler l'affichage braille vers l'arrière |`switch1Gauche`| +|Faire défiler l'affichage braille vers l'avant |`switch1Droite`| +|Déplacer vers le focus actuel |`switch1Centre`| +|Route vers cellule braille |`routage`| +|Signaler la mise en forme du texte sous la cellule braille |`doubleRouting`| +|Aller à la ligne précédente en révision |`joystick1Haut`| +|Passer à la ligne suivante dans la révision |`joystick1bas`| +|Passer au caractère précédent en revue |`joystick1gauche`| +|Passer au caractère suivant en revue |`joystick1Droite`| +|Touche `flècheGauche` |`joystick2gauche`| +|Touche `flècheDroite` |`joystick2Droite`| +|Touche `flècheHaut` |`joystick2Haut`| +|Touche `glècheBas` |`joystick2Bas`| +|touche `entrée` |`joystick2Centre`| + + + +#### Commandes clavier Esytime {#EurobrailleEsytime} + + + +| Nom |Touche| +|---|---| +|Faire défiler l'affichage braille vers l'arrière |`l1`| +|Faire défiler l'affichage braille vers l'avant |`l8`| +|Déplacer vers le focus actuel |`l1+l8`| +|Route vers cellule braille |`routage`| +|Signaler la mise en forme du texte sous la cellule braille |`doubleRouting`| +|Aller à la ligne précédente en révision |`joystick1Haut`| +|Passer à la ligne suivante dans la révision |`joystick1bas`| +|Passer au caractère précédent en revue |`joystick1gauche`| +|Passer au caractère suivant en revue |`joystick1Droite`| +|Touche `flèchegauche` |`joystick2gauche`| +|Touche `flèchedroite` |`joystick2Droite`| +|Touche `flècheHaut` |`joystick2Haut`| +|Touche `flècheBas` |`joystick2Bas`| +|touche `entrée` |`joystick2Centre`| +|touche `échappement` |`l2`| +|touche `tabulation` |`l3`| +|Basculer la touche `Maj` |`l4`| +|Basculer la touche `contrôle` |`l5`| +|Basculer la touche `alt` |`l6`| +|Basculer la touche `NVDA` |`l7`| +|Touche `contrôle+début` |`l1+l2+l3`, `l2+l3+l4`| +|Touche `contrôle+fin` |`l6+l7+l8`, `l5+l6+l7`| +|Basculer la simulation du clavier HID |`l1+joystick1Bas`, `l8+joystick1Bas`| + + + +### Afficheurs Nattiq nBraille {#NattiqTechnologies} + +NVDA supporte les afficheurs de [Nattiq Technologies](https://www.nattiq.com/) quand ils sont connectés via USB. +Windows 10 et les versions ultérieures détectent les afficheurs Braille à la connexion, il peut être nécessaire d'installer des pilotes USB si vous utilisez des versions plus anciennes de Windows (antérieures à Win10). +Vous pouvez les obtenir sur le site du fabriquant. + +Voici les assignations de touches pour les afficheurs Nattiq Technologies sous NVDA. +Veuillez consulter la documentation de l'afficheur pour connaître la position de ces touches. + + +| Nom |Touche| +|---|---| +|Défilement arrière |haut| +|Défilement avant |bas| +|Amener l'afficheur à la ligne précédente |gauche| +|amener l'afficheur à la ligne suivante |droit| +|Aller à la cellule braille |routage| + + + +### BRLTTY {#BRLTTY} + +[BRLTTY](https://www.brltty.app/) est un programme séparé qui permet de prendre en charge beaucoup plus de terminaux braille. +Pour l'utiliser, il vous faut installer [BRLTTY pour Windows](https://www.brltty.app/download.html). +Vous devez télécharger et installer la version la plus récente avec installateur qui s'appellera, par exemple, brltty-win-4.2-2.exe. +Quand vous configurerez le terminal et le port à utiliser, portez une attention particulière aux instructions, en particulier si vous utilisez un terminal USB et que le pilote du constructeur est déjà installé. + +Pour les afficheurs disposant d'un clavier braille, BRLTTY gèrent la saisie du braille. +L'option table d'entrée n'est donc pas applicable. + +BRLTTY n'est pas concerné par la détection automatique en arrière-plan. + +Voici les assignations de commandes BRLTTY pour NVDA. +Veuillez consulter les [listes des assignations des touches de BRLTTY](https://brltty.app/doc/KeyBindings/) pour des informations sur la manière dont BRLTTY lie ses commandes aux touches sur les terminaux braille. + + +| Nom |commande BRLTTY| +|---|---| +|Défilement arrière de l'affichage braille |`fwinlt` (se déplacer à gauche d'une fenêtre)| +|Défilement avant de l'affichage braille |`fwinrt` (se déplacer à droite d'une fenêtre)| +|Amener l'affichage à la ligne précédente |`lnup` (monter d'une ligne)| +|Amener l'affichage à la ligne suivante |`lndn` (descendre d'une ligne)| +|Aller à la cellule braille |`route` (amener le curseur au caractère)| +|Basculer l'aide à la saisie |`learn` (entrer/sortir du mode d'apprentissage des commandes)| +|Ouvrir le menu NVDA |`prefmenu` (ouvrir/quitter le menu des préférences)| +|Rétablir la configuration |`prefload` (restaurer les préférences à partir du disque)| +|Enregistrer la configuration |`prefsave` (enregistrer les préférences sur le disque)| +|Afficher l'heure |`hour` (afficher la date et l'heure actuelles)| +|Prononcer la ligne où se trouve le curseur de révision |`say_line` (prononcer la ligne actuelle)| +|Dire tout en utilisant le curseur de revue |`say_below` (Lire depuis la ligne actuelle jusqu'au bas de l'écran)| + + + +### Tivomatic Caiku Albatross 46/80 {#Albatross} + +Les terminaux Caiku Albatross, qui étaient fabriqués par Tivomatic et disponibles en Finlande, peuvent être connectés via USB ou série. +Vous n'avez pas besoin d'installer de pilote spécifique pour utiliser ces afficheurs. +Branchez simplement l'afficheur et configurez NVDA pour l'utiliser. + +Remarque : Un débit de 19 200 bauds est fortement recommandé. +Si nécessaire, réglez la valeur du débit en bauds sur 19200 dans le menu de l'afficheur braille. +Bien que le pilote prenne en charge un débit en bauds de 9600, il n'a aucun moyen de contrôler le débit en bauds utilisé par l'affichage. +Parce que 19200 est le débit en bauds par défaut de l'affichage, le pilote l'essaie d'abord. +Si les débits en bauds ne sont pas les mêmes, le pilote peut se comporter de manière inattendue. + +Voici les affectations de touches pour ces afficheurs avec NVDA. +Veuillez consulter la documentation de l'afficheur pour savoir où trouver ces touches. + + +| Nom |Touche| +|---|---| +|Aller à la première ligne en mode revue |`home1`, `home2`| +|Aller à la dernière ligne en mode revue |`end1`, `end2`| +|Amener l'objet navigateur au focus courant |`eCursor1`, `eCursor2`| +|Aller au focus courant |`cursor1`, `cursor2`| +|Amener le pointeur souris à l'objet navigateur courant |`home1+home2`| +|Amener l'objet navigateur à l'objet sous le pointeur souris et l'annoncer |`end1+end2`| +|Amener le focus à l'objet navigateur courant |`eCursor1+eCursor2`| +|Basculer le suivi braille |`cursor1+cursor2`| +|Amener l'affichage braille à la ligne précédente |`up1`, `up2`, `up3`| +|Amener l'affichage braille à la ligne suivante |`down1`, `down2`, `down3`| +|Faire défiler l'affichage braille en arrière |`left`, `lWheelLeft`, `rWheelLeft`| +|Faire défiler l'affichage braille en avant |`right`, `lWheelRight`, `rWheelRight`| +|Aller à la cellule braille |`routing`| +|Annoncer la mise en forme du texte sous la cellule braille |`secondary routing`| +|Choisir la manière dont l'information contextuelle est présentée en braille |`attribute1+attribute3`| +|Faire défiler les modes de parole |`attribute2+attribute4`| +|Passer au mode de revue précédent (ex : objet, document ou écran) |`f1`| +|Passer au mode de revue suivant (ex : objet, document ou écran) |`f2`| +|Amener l'objet navigateur à l'objet le contenant |`f3`| +|Amener l'objet navigateur au premier objet qu'il contient |`f4`| +|Amener l'objet navigateur à l'objet précédent |`f5`| +|Amener l'objet navigateur à l'objet suivant |`f6`| +|Annoncer l'objet navigateur courant |`f7`| +|Annoncer l'information de position du texte ou de l'objet sous le curseur de revue |`f8`| +|Afficher les paramètres braille |`f1+home1`, `f9+home2`| +|Lire la barre d'état et y amener l'objet navigateur |`f1+end1`, `f9+end2`| +|Basculer le curseur braille |`f1+cursor1`, `f9+cursor2`| +|Faire défiler les formes de curseur braille |`f1+eCursor1`, `f9+eCursor2`| +|Faire défiler le mode d'affichage des messages en braille |`f1+f2`, `f9+f10`| +|Faire défiler le mode d'affichage de la sélection braille |`f1+f5`, `f9+f14`| +|Faire défiler les modes pour l'option braille "Déplacer le curseur système lors du routage du curseur de revue" |`f1+f3`, `f9+f11`| +|Exécuter l'action par défaut sur l'objet navigateur courant |`f7+f8`| +|Annoncer date/heure |`f9`| +|Annoncer le niveau de batterie et le temps restant si l'alimentation n'est pas branchée |`f10`| +|Annoncer le titre |`f11`| +|Annoncer la barre d'état |`f12`| +|Annoncer la ligne courante sous le curseur d'application |`f13`| +|Dire tout |`f14`| +|Annoncer le caractère courant sous le curseur de revue |`f15`| +|Annoncer la ligne de l'objet navigateur courant où se situe le curseur de revue |`f16`| +|Dir le mot de l'objet navigateur courant où se situe le curseur de revue |`f15+f16`| +|Amener le curseur de revue à la ligne précédente de l'objet navigateur courant et l'annoncer |`lWheelUp`, `rWheelUp`| +|Amener le curseur de revue à la ligne suivante de l'objet navigateur courant et l'annoncer |`lWheelDown`, `rWheelDown`| +|Touche `Windows+d` (minimiser toutes les applications) |`attribute1`| +|Touche `Windows+e` (Ce PC) |`attribute2`| +|Touche `Windows+b` (focus dans la barre d'état) |`attribute3`| +|Touche `Windows+i` (Paramètres Windows) |`attribute4`| + + + +### Afficheurs braille au standard HID {#HIDBraille} + +Il s'agit d'un pilote expérimental pour la nouvelle spécification standard HID Braille, convenue en 2018 par Microsoft, Google, Apple et plusieurs sociétés de technologie d'assistance, dont NV Access. +L'espoir est que tous les futurs modèles d'afficheurs Braille créés par n'importe quel fabricant utiliseront ce protocole standard qui supprimera le besoin de pilotes Braille spécifiques au fabricant. + +La détection automatique de l'affichage braille de NVDA reconnaîtra également tout affichage prenant en charge ce protocole. + +Voici les affectations de touches actuelles pour ces affichages. + + +| Nom |Touche| +|---|---| +|Défilement arrière de l'afficheur braille |panoramique à gauche ou rocker vers le haut| +|Défilement avant de l'afficheur braille |panoramique à droite ou rocker vers le bas| +|Aller à la cellule braille |ensemble de routage 1| +|Basculer braille suit to |haut+bas| +|touche flècheHaut |joystick vers le haut, dpad ver le haut ou espace+point1| +|touche flècheBas |joystick vers le bas, dpad ver le bas ou espace+point4| +|touche flècheGauche |espace+point3, joystick vers la gauche ou dpad ver la gauche| +|touche flècheDroite |espace+point6, joystick vers la droite ou dpad ver la droite| +|Touche maj+tab |espace+point1+point3| +|Touche tab |espace+point4+point6| +|Touche alt |espace+point1+point3+point4 (espace+m)| +|Touche échap |espace+point1+poin5 (espace+e)| +|touche entrée |poin8, joystick centre ou dpad centre| +|Touche Windows |espace+point3+point4| +|Touche alt+tab |espace+point2+point3+point4+point5 (espace+t)| +|Menu NVDA |espace+point1+point3+point4+point5 (espace+n)| +|Touche windows+d (minimiser toutes les applications) |espace+point1+point4+point5 (espace+d)| +|Dire tout |espace+point1+point2+point3+point4+point5+point6| + + + +## Fonctions Avancées {#AdvancedTopics} +### Mode Sécurisé {#SecureMode} + +Les administrateurs système peuvent souhaiter configurer NVDA pour restreindre les accès non autorisés au système. +NVDA permet l'installation d'extensions personnalisées, qui peuvent exécuter du code arbitraire, y compris lorsque NVDA est élevé aux privilèges d'administrateur. +NVDA permet également aux utilisateurs d'exécuter du code arbitraire via la console NVDA Python. +Le mode sécurisé de NVDA empêche les utilisateurs de modifier leur configuration NVDA et limite par ailleurs l'accès non autorisé au système. + +NVDA s'exécute en mode sécurisé lorsqu'il est exécuté sur les [écrans sécurisés](#SecureScreens) à moins que le [paramètre à l'échelle du système](#SystemWideParameters) `serviceDebug` soit activé. +Pour forcer NVDA à toujours démarrer en mode sécurisé, définissez le [paramètre système](#SystemWideParameters) `forceSecureMode`. +NVDA peut également être démarré en mode sécurisé avec [l'option de ligne de commande](#CommandLineOptions) `-s`. + +Le mode sécurisé désactive : + +* La sauvegarde de la configuration et autres paramètres sur disque +* La sauvegarde des gestes de commande sur disque +* Les fonctionnalités de [Profil de Configuration](#ConfigurationProfiles) telles que créer, supprimer, renommer les profils etc. +* Le chargement de la configuration depuis un dossiers personnalisés à l'aide de [l'option de ligne de commande `-c`](#CommandLineOptions) +* Mettre à jour NVDA et créer des copies portables +* [L'Add-on Store](#AddonsManager) +* La [console Python NVDA](#PythonConsole) +* La [Visionneuse du journal](#LogViewer) et la journalisation +* La [Visionneuse Braille](#BrailleViewer) et la [Visionneuse de parole](#SpeechViewer) +* L'ouverture de documents externes depuis le menu NVDA, comme le guide de l'utilisateur ou le fichier des contributeurs. + +Les copies installées de NVDA stockent leur configuration, y compris les extensions, dans `%APPDATA%\nvda`. +Pour empêcher les utilisateurs de NVDA de modifier directement leur configuration ou leurs extensions, l'accès des utilisateurs à ce dossier doit également être restreint. + +Le mode sécurisé est inefficace pour les copies portables de NVDA. +Cette limitation s'applique également à la copie temporaire de NVDA qui s'exécute au lancement de l'installateur. +Dans un environnements sécurisés, le fait qu'un utilisateur puisse exécuter un exécutable portable présente le même risque de sécurité, quele mode sécurisé soit forcé ou non. +Il est attendu que les administrateurs système empêchent l'exécution de logiciels non autorisés sur leurs systèmes, y compris les copies portables de NVDA. + +Les utilisateurs de NVDA comptent souvent sur la configuration de leur profil NVDA pour répondre à leurs besoins. +Cela peut inclure l'installation et la configuration d'extensions personnalisées, qui doivent être approuvés indépendamment de NVDA. +Le mode sécurisé gèle les modifications apportées à la configuration de NVDA, veuillez donc vous assurer que NVDA est correctement configuré avant de forcer le mode sécurisé. + +### Écrans Sécurisés {#SecureScreens} + +NVDA s'exécute en [mode sécurisé](#SecureMode) lorsqu'il est exécuté sur les écrans sécurisés à moins que le [paramètre à l'échelle du système](#SystemWideParameters) `serviceDebug` soit activé. + +Lorsqu'il s'exécute sur un écran sécurisé, NVDA utilise un profil système pour les préférences. +Les préférences utilisateur de NVDA peuvent être copiées [pour une utilisation dans les écrans sécurisés](#GeneralSettingsCopySettings). + +Les écrans sécurisés incluent : + +* L'écran de connexion à Windows +* Le dialogue Contrôle d'accès utilisateur, actif lors de l'exécution d'une action en tant qu'administrateur + * Cela inclut l'installation de programmes + +### Options de Ligne de Commande {#CommandLineOptions} + +Au démarrage, NVDA peut accepter une ou plusieurs options additionnelles pour modifier son comportement. +Vous pouvez passer autant d'options que nécessaire. +Ces options peuvent être passées quand on démarre depuis un raccourci (dans les propriétés du raccourci), depuis le dialogue Exécuter (Menu Démarrer -> Exécuter ou Windows+r) ou depuis une console de commande Windows. +Les options doivent être séparées du nom de l'exécutable NVDA et des autres options par des espaces. +Par exemple, une option utile est `--disable-addons`, qui dit à NVDA d'interrompre toutes les extensions en cours d'exécution. +Cela vous permet de déterminer si un problème est causé par une extension et de vous sortir de sérieux problèmes pouvant être causés par des extensions. + +Par exemple, vous pouvez quitter la copie en cours de NVDA en entrant ce qui suit dans le dialogue Exécuter : + + nvda -q + +Certaines options de ligne de commande ont une version courte et une version longue, tandis que d'autres n'ont qu'une version longue. +Pour celles qui ont une version courte, vous pouvez les combiner ainsi : + +| . {.hideHeaderRow} |.| +|---|---| +|`nvda -mc CONFIGPATH` |Ceci démarrera NVDA avec le son et le message de démarrage désactivé, et la configuration spécifiée.| +|`nvda -mc CONFIGPATH --disable-addons` |Même chose, mais avec les extensions désactivées| + +Certaines options de ligne de commande acceptent des paramètres additionnels ; ex : le niveau de détail du journal ou le chemin du répertoire de configuration utilisateur. +Ces paramètres doivent être placés après l'option, séparés de l'option par un espace quand il s'agit d'une option en version courte ou par un signe égal (`=`) quand il s'agit d'une option en version longue; ex : + +| . {.hideHeaderRow} |.| +|---|---| +|`nvda -l 10` |Dit à NVDA de démarrer avec le niveau de journalisation sur débogage| +|`nvda --log-file=c:\nvda.log` |Dit à NVDA d'écrire le fichier journal dans `c:\nvda.log`| +|`nvda --log-level=20 -f c:\nvda.log` |Dit à NVDA de démarrer avec le niveau de journalisation sur info et d'écrire son journal dans `c:\nvda.log`| + +Voici les options de ligne de commande de NVDA : + +| Courte |Longue |Description| +|---|---|---| +|`-h` |`--help` |affiche l'aide de la ligne de commande et s'arrête| +|`-q` |`--quit` |Quitte la copie en cours d'exécution de NVDA| +|`-k` |`--check-running` |Indique si NVDA est en cours d'exécution via le code retour; 0 si oui, 1 si non| +|`-f NOMDUFICHIERJOURNAL` |`--log-file=NOMDUFICHIERJOURNAL` |Le fichier où les messages du journal doivent être écrits. La journalisation est toujours désactivée si le mode sécurisé est activé.| +|`-l NIVEAUDEJOURNALISATION` |`--log-level=NIVEAUDEJOURNALISATION` |Le niveau minimal de messages journalisés (débogage 10, entrées/sorties 12, avertissements de débogage 15, info 20, désactivé 100). La journalisation est toujours désactivée si le mode sécurisé est activé.| +|`-c CHEMINDECONFIG` |`--config-path=CHEMINDECONFIG` |Le chemin vers lequel tous les paramètres de NVDA sont stockés. La valeur par défaut est forcée si le mode sécurisé est activé.| +|Aucun |`--lang=LANGUAGE` |Remplacer la langue NVDA configurée. Choisissez "Windows" pour la langue en cours par défaut, "en" pour Anglais, etc.| +|`-m` |`--minimal` |Pas de sons, pas d'interface, pas de message de démarrage etc.| +|`-s` |`--secure` |Démarre NVDA en [Mode Sécurisé](#SecureMode)| +|Aucune |`--disable-addons` |Les extensions n'auront pas d'effet| +|Aucune |`--no-logging` |Désactive complètement la journalisation durant l'utilisation de NVDA. Ce paramètre peut être ignoré si un niveau de journalisation (`--loglevel`, `-l`) est spécifié dans la ligne de commande ou si la journalisation de débogage est activée.| +|Aucune |`--debug-logging` |Active le niveau de journalisation débogage seulement pour cette session. Ce paramètre remplacera tout autre niveau de journalisation (`--loglevel`, `-l`) argument donné, incluant l'option pas de journalisation.| +|Aucune |`--no-sr-flag` |Ne change pas l'indicateur système global de revue d'écran| +|Aucune |`--install` |Installe NVDA (en démarrant la copie nouvellement installée)| +|Aucune |`--install-silent` |Installe NVDA silencieusement (sans démarrer la copie nouvellement installée)| +|Aucune |`--enable-start-on-logon=True|False` |Durant l'installation, active le [démarrage sur l'écran de connexion](#StartAtWindowsLogon) de NVDA| +|Aucune |`--copy-portable-config` |À l'installation, copie la configuration portable depuis le chemin indiqué (`--config-path`, `-c`) vers le compte utilisateur courant| +|Aucune |`--create-portable` |Crée une copie portable de NVDA (et démarre cette nouvelle copie). `--portable-path` doit être spécifié| +|Aucune |`--create-portable-silent` |Crée une copie portable de NVDA (sans démarrer cette nouvelle copie). `--portable-path` doit être spécifié. Cette option supprime les avertissements lors de l'écriture dans des répertoires non vides et peut écraser les fichiers sans avertissement.| +|Aucune |`--portable-path=PORTABLEPATH` |L'emplacement où la copie portable sera créée| + +### Paramètres Système {#SystemWideParameters} + +NVDA permet de définir certaines valeurs dans la base de registre du système ce qui modifie le comportement général de NVDA. +Ces valeurs sont stockées dans la base de registres sous l'une des clés suivantes : + +* Systèmes 32-bits : `HKEY_LOCAL_MACHINE\SOFTWARE\nvda` +* Systèmes 64-bits : `HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\nvda` + +Les valeurs suivantes peuvent être définies dans ces clés de registre : + +| Nom |Type |valeurs Possibles |Description| +|---|---|---|---| +|`configInLocalAppData` |DWORD |0 (par défaut) pour désactiver, 1 pour activer |Si activé, stocke la configuration de l'utilisateur NVDA dans les données d'application locales au lieu des données d'application itinérantes| +|`serviceDebug` |DWORD |0 (par défaut) pour désactiver, 1 pour activer |S'il est activé, désactive [Secure Mode](#SecureMode) sur [secure screens](#SecureScreens). En raison de plusieurs implications majeures en matière de sécurité, l'utilisation de cette option est fortement déconseillée| +|`forceSecureMode` |DWORD |0 (par défaut) pour désactiver, 1 pour activer |Si activé, force [le mode sécurisé](#SecureMode) à être activé lors de l'exécution de NVDA.| + +## Informations Complémentaires {#FurtherInformation} + +Si vous avez besoin d'informations complémentaires ou d'aide concernant l'utilisation de NVDA, veuillez visiter le [site web de NVDA](NVDA_URL). +Sur ce site, vous pourrez trouver des informations complémentaires telles que des listes de discussion spécialisées et d'autres ressources communautaires pour vous aider à utiliser NVDA. +Ce site fournit également des informations concernant le développement de NVDA. diff --git a/tests/unit/test_markdownTranslate.py b/tests/unit/test_markdownTranslate.py new file mode 100644 index 00000000000..c07579b6b47 --- /dev/null +++ b/tests/unit/test_markdownTranslate.py @@ -0,0 +1,135 @@ +# A part of NonVisual Desktop Access (NVDA) +# This file is covered by the GNU General Public License. +# See the file COPYING for more details. +# Copyright (C) 2024 NV Access Limited + +"""Unit tests for the markdownTranslate module.""" + +import tempfile +import unittest +import subprocess +import sys +import os + + +class TestMarkdownTranslate(unittest.TestCase): + markdownTranslateScriptPath = os.path.join( + os.path.dirname(__file__), + "..", + "..", + "user_docs", + "markdownTranslate.py", + ) + testDir = os.path.join(os.path.dirname(__file__), "..", "markdownTranslate") + + def setUp(self): + self.outDir = tempfile.TemporaryDirectory() + + def tearDown(self): + self.outDir.cleanup() + + def runMarkdownTranslateCommand(self, description: str, args: list[str]): + failed = False + try: + subprocess.run([sys.executable, self.markdownTranslateScriptPath, *args], check=True) + except subprocess.CalledProcessError: + failed = True + if failed: + message = f"Failed when trying to {description} with command: {' '.join(args)}" + self.fail(message) + + def test_markdownTranslate(self): + outDir = self.outDir.name + testDir = self.testDir + self.runMarkdownTranslateCommand( + description="Generate an xliff file from the English 2024.2 user guide markdown file", + args=[ + "generateXliff", + "-m", + os.path.join(testDir, "en_2024.2_userGuide.md"), + "-o", + os.path.join(outDir, "en_2024.2_userGuide.xliff"), + ], + ) + self.runMarkdownTranslateCommand( + description="Regenerate the 2024.2 markdown file from the generated 2024.2 xliff file", + args=[ + "generateMarkdown", + "-x", + os.path.join(outDir, "en_2024.2_userGuide.xliff"), + "-o", + os.path.join(outDir, "rebuilt_en_2024.2_userGuide.md"), + "-u", + ], + ) + self.runMarkdownTranslateCommand( + description="Ensure the regenerated 2024.2 markdown file matches the original 2024.2 markdown file", + args=[ + "ensureMarkdownFilesMatch", + os.path.join(outDir, "rebuilt_en_2024.2_userGuide.md"), + os.path.join(testDir, "en_2024.2_userGuide.md"), + ], + ) + self.runMarkdownTranslateCommand( + description="Update the 2024.2 xliff file with the changes between the English 2024.2 and 2024.3beta6 user guide markdown files", + args=[ + "updateXliff", + "-x", + os.path.join(outDir, "en_2024.2_userGuide.xliff"), + "-m", + os.path.join(testDir, "en_2024.3beta6_userGuide.md"), + "-o", + os.path.join(outDir, "en_2024.3beta6_userGuide.xliff"), + ], + ) + self.runMarkdownTranslateCommand( + description="Regenerate the 2024.3beta6 markdown file from the updated xliff file", + args=[ + "generateMarkdown", + "-x", + os.path.join(outDir, "en_2024.3beta6_userGuide.xliff"), + "-o", + os.path.join(outDir, "rebuilt_en_2024.3beta6_userGuide.md"), + "-u", + ], + ) + self.runMarkdownTranslateCommand( + description="Ensure the regenerated 2024.3beta6 markdown file matches the original 2024.3beta6 markdown", + args=[ + "ensureMarkdownFilesMatch", + os.path.join(outDir, "rebuilt_en_2024.3beta6_userGuide.md"), + os.path.join(testDir, "en_2024.3beta6_userGuide.md"), + ], + ) + self.runMarkdownTranslateCommand( + description="Translate the 2024.3beta6 xliff file to French using the existing pretranslated French 2024.3beta6 user guide markdown file", + args=[ + "translateXliff", + "-x", + os.path.join(outDir, "en_2024.3beta6_userGuide.xliff"), + "-l", + "fr", + "-p", + os.path.join(testDir, "fr_pretranslated_2024.3beta6_userGuide.md"), + "-o", + os.path.join(outDir, "fr_2024.3beta6_userGuide.xliff"), + ], + ) + self.runMarkdownTranslateCommand( + description="Regenerate the French 2024.3beta6 user guide markdown file from the French translated 2024.3beta6 xliff file", + args=[ + "generateMarkdown", + "-x", + os.path.join(outDir, "fr_2024.3beta6_userGuide.xliff"), + "-o", + os.path.join(outDir, "fr_2024.3beta6_userGuide.md"), + ], + ) + self.runMarkdownTranslateCommand( + description="Ensure the regenerated French 2024.3beta6 user guide markdown file matches the original French 2024.3beta6 user guide markdown file", + args=[ + "ensureMarkdownFilesMatch", + os.path.join(outDir, "fr_2024.3beta6_userGuide.md"), + os.path.join(testDir, "fr_pretranslated_2024.3beta6_userGuide.md"), + ], + ) diff --git a/user_docs/en/userGuide.xliff b/user_docs/en/userGuide.xliff new file mode 100644 index 00000000000..4509ae371ba --- /dev/null +++ b/user_docs/en/userGuide.xliff @@ -0,0 +1,36681 @@ + + + + +# $(ID:f5169acb-2803-46c6-8e4c-7c1aaf973723) + +[TOC] + +<!-- KC:title: $(ID:4cfb7a81-1d0d-49b0-a043-55d47443a545) --> + + + +## $(ID:bef0258d-7946-41ad-a11c-196179d241ea) {#Introduction} + +$(ID:42aa26be-eeb2-4456-acac-74e9f243fc1b) + +$(ID:b9acf197-4c6b-4708-a33a-f6616751c525) +$(ID:363a73b6-345d-4b10-9be6-19c5bdc4e7f1) +$(ID:e0f5f99a-6223-4901-9a62-adc210d59b0d) + +### $(ID:3e5e2692-cdb5-4343-b098-d50ea966f6fb) {#GeneralFeatures} + +$(ID:ac2730c9-641d-4a53-ae73-a527cddf075a) + +$(ID:d0fe1174-0c18-4cff-a583-f2b5a8c3051d) + +$(ID:344fd3e8-dbcb-47d4-a528-0d6885bc595a) + +* $(ID:8b25c405-b6a8-412d-bf42-e04b3eccacab) +* $(ID:38d609d3-25a1-477f-8dcf-24310471ff2f) +* $(ID:8157d30c-3749-4022-8319-1ae6fe38a331) +* $(ID:ca905762-edef-40f0-85d5-be2ee2d59e0d) +* $(ID:140c1b81-a550-4601-b7c6-3f53492cfff8) +* $(ID:3621dc26-377b-4133-8c66-67736611187a) +* $(ID:2150a12d-559a-4d0a-8196-f578a315e05b) +* $(ID:a963d54d-d6ab-472f-934b-6e26f0b58542) +* $(ID:e2cfcace-4626-4392-9c2a-c5ffd9315f3b) +* $(ID:c7a40820-ab3d-452a-b1d7-d045b90597a3) +* $(ID:f764b6db-1280-473f-a474-283d20038a1b) +* $(ID:ecfe7463-db01-4de1-849b-33eed45e394e) +* $(ID:7bf18fb9-a457-44ab-85e8-7f20d35c9c5e) +* $(ID:6ea5132e-3161-4f99-aa88-2daca29ba863) + +### $(ID:9e8a8992-9934-4641-98c2-b1a3fd3aaf36) {#SystemRequirements} + +#### $(ID:fae2037c-e73e-4dd4-bbfc-529075c45cb0) {#MinimumSystemRequirements} + +* $(ID:becfe653-e084-45ef-a7cd-8c42a552b711) + * $(ID:8c768a13-c0dd-4494-af7f-972ce83aa919) + * $(ID:fe98f99a-734e-4cbf-8b83-01cde553520f) + * $(ID:e2aaa002-af9c-4d41-8e44-808b0c79caec) +* $(ID:e24c9ba8-0668-4378-82a9-3a170ed73b7f) + +#### $(ID:225a3a6f-27b6-4449-a783-21278fed9657) {#RecommendedSystemRequirements} + +* $(ID:89b78f2e-a71c-46f5-949a-c542801a68bd) + * $(ID:8d665828-8c10-4e0e-af33-2bf2ed07fb5a) +* $(ID:40475f3b-9146-4909-8c10-e8e1c5bd89a0) +* $(ID:0b3dff58-0b7c-4300-b44c-85109d67260c) + +### $(ID:95525671-72cd-4e86-9c45-9871e526b8c7) {#Internationalization} + +$(ID:e65ec40a-6ec3-432f-8fb0-301fbf62034e) +$(ID:19b95bfb-1299-423a-a6ec-9f09d94b3862) + +### $(ID:6dbfeab6-d167-4f5e-9706-f501d729511e) {#SpeechSynthesizerSupport} + +$(ID:dfb80b60-c56b-4ec0-b880-eb697c723f23) + +$(ID:f25f5e2e-f45b-4ddc-93ee-00a9f1171dc7) + +$(ID:a10dc72b-f2b0-4385-8d63-790edfd2d028) + +### $(ID:7d30d9d1-9c05-4936-896b-44e7628176a5) {#BrailleSupport} + +$(ID:518c5c24-29d6-4465-a73d-2dca03748ecc) +$(ID:80815b48-814b-4f41-bd34-1d0d03333f17) +$(ID:2d05d0ba-5689-4622-838d-438a263dc067) +$(ID:8a6008ac-a7bf-4d74-bf34-2b2e28d3f91a) +$(ID:bda71da3-626d-4f7d-9b35-c2f45f852aa4) + +$(ID:496214f9-354a-44d6-8e60-c551bcf90429) + +### $(ID:e9374c34-7131-4980-a9a8-d6078cac3772) {#LicenseAndCopyright} + +$(ID:c9d1510f-7811-481f-bd85-a81a223bd61f) + +$(ID:6e473f31-13d1-4cdb-87af-6ba63c04d6e1) +$(ID:cf2fd589-25ab-4568-b27b-dc509a2e0387) +$(ID:2c109f7b-a446-483d-bdee-7a4fbae8db4f) +$(ID:a1f58b6d-e6cf-46aa-912c-5f47d88c1508) +$(ID:2845080b-1ab8-496f-b947-981b678a3dd9) + +$(ID:69a3880d-d533-4eba-8c8a-93f210208e94) +$(ID:9af8926e-983f-48d9-a915-72d85af3a860) + +## $(ID:a5187732-8518-41a7-9a6a-a209c13b3ebe) {#NVDAQuickStartGuide} + +$(ID:74159b1a-76a4-40d3-88c5-2b390d4a0a9e) +$(ID:4320f075-8756-47cb-839e-c648e8aaca7b) +$(ID:5f09ba0c-cf21-4d40-8252-2ebf07b512be) +$(ID:6b9956f2-4fd2-49f3-a297-7c7fcf138ad6) + +### $(ID:97764ce7-d2a3-4d33-ba9d-85cf5c8cf078) {#GettingAndSettingUpNVDA} + +$(ID:a8f1503c-c080-451b-ac64-27caf4e680f4) +$(ID:b1eb6d36-4bb0-4f47-96be-223a910333a4) +$(ID:2d626e3a-2d40-4288-a248-253c8de17e2c) +$(ID:3848390a-5765-487f-93e0-6ebc04853d6f) + +$(ID:567f21c1-6d3c-4811-b7d4-ce6b5b4eed7f) +$(ID:06eafd14-db39-4bd3-a630-4d004782d5f5) + +#### $(ID:cddff240-daf5-49ea-ac02-de4f010b3a3b) {#StepsForDownloadingNVDA} + +$(ID:5de1394d-8463-4919-bd0e-e230a652dcbb) + +* $(ID:49a87d38-c911-4f0d-a54e-9a0f3ff63d8b) +* $(ID:4177a1f5-de77-4bc4-8758-ad39237a6217) +$(ID:ae6109cd-b625-4506-90af-5cc92afa215b) +* $(ID:68718298-61fc-4ac1-bc68-ea388cea534b) +* $(ID:d8fe20d3-5b14-4e89-a7d9-b758875ead6e) +* $(ID:93c1fdaf-6825-4727-9f2e-ca3b21f2f89a) +* $(ID:bba08acb-ec12-41d9-b502-8bc95efdaa3c) + +### $(ID:92dd6fe9-c6f5-4013-97b6-41917db77a0e) {#SettingUpNVDA} + +$(ID:7160d5c1-999c-4680-a187-1ba774c705af) +$(ID:7ea43d55-d22e-4f30-9ae1-2482c133c65d) + +$(ID:9454f8ed-fa2f-4cd0-978b-a5fd32d5b0b9) +$(ID:3d557639-2279-4e3f-bb0b-1d0386479a41) + +#### $(ID:37a06551-6d04-4d23-b1ab-7eb27fde5ad1) {#StepsForRunningTheDownloadLauncher} + +$(ID:b58a3693-2fa2-4dfa-9b66-159dacad307c) +$(ID:a88829fd-be85-467b-9f2a-a7c92fcfcc37) + +1. $(ID:f5455ce9-c9c9-4349-8e71-c248bd6cfcff) +$(ID:9961cb70-d5d9-4c3f-a703-d1eae9a05b36) +$(ID:97e4ff0f-5201-4d72-a2a6-48230d50cb8f) +1. $(ID:ed352126-32e7-4a07-b1d7-2d45b096714a) +$(ID:d26eb399-5219-4ebd-be76-61b19845e231) +1. $(ID:6d4f6179-d738-42fc-b67f-01231764b90c) +1. $(ID:78f44bb9-7146-4317-9b35-367563ecd985) + +$(ID:12ca4886-de51-4a24-ba62-dcfc3bb992d5) + +* $(ID:c0c548e4-68ed-4103-9774-2cc03e540c1a) +* $(ID:45c15acd-0ef4-44dd-a32b-5f0f748e58ec) +$(ID:f7323fd1-0a52-470d-b262-e8fe1ac384a7) +$(ID:646459f9-c54d-4c67-a4df-d453958c5bd3) +$(ID:a4adb36d-7f4f-4336-bc1c-71907cd241f0) +* $(ID:985b8513-61a6-4cc7-b58e-22ff1d1a4d4f) +$(ID:4a2aadbb-f24d-4dd8-9e64-5f5693f124ea) +$(ID:fe7dfd42-62d0-4b5d-a715-9d9a65fa7150) +$(ID:8aa3bd80-1c0a-4da3-9492-d392445c1914) +* $(ID:8584282d-eee5-447d-837f-fe87bd90ee72) + +$(ID:147cfb03-09b7-4faa-aaad-a5d1ada8d336) +$(ID:ba34bb7d-350d-4040-8e13-6ffdffbd5fe2) +$(ID:61d205c2-29cc-4810-8300-0405727adb1b) +$(ID:c10d6009-935a-4a79-b980-f7d4304ee26f) + +$(ID:de9d6fbe-8bf6-44b6-86e2-e429cc29e418) + +#### $(ID:6e518d04-c865-440b-89f3-c10b4369eb03) {#StepsForInstallingNVDAFromTheLauncher} + +$(ID:708bf1b5-4331-488d-8504-d7708b4f01d7) +$(ID:7e61ffb0-5fc8-4183-aba3-867d293df859) + +1. $(ID:89bd4d78-f98e-4b94-8223-b8dee9918fab) +1. $(ID:0a0a137d-5f25-4871-941d-221e3ba308c7) +1. $(ID:b03c5c1d-943d-4b45-8a48-ef7ef261f6dd) +$(ID:8818225b-0f2b-412c-bd8a-0e66d2fa26b4) +$(ID:247c54f8-77d8-4950-8a75-7e0ed1eae9a8) +1. $(ID:bbb11d67-e68a-42c9-9b5f-97288d6a95a1) +1. $(ID:4cb63a3b-d01e-4d05-8706-894c56937de2) +1. $(ID:2eedd366-96a3-458f-87e5-3a39e3ae6261) +1. $(ID:32c0ccba-4015-4e38-9265-b079649929da) +$(ID:fc236677-8d50-4aca-87db-5cb7b482c162) +$(ID:dec9a271-1b3a-4e03-bcb4-2b1fd67dba7d) +1. $(ID:d8458752-c562-4aca-8eca-488d07b8211c) +$(ID:93322b99-d687-406d-bca4-6b63b0b0fd22) +$(ID:7ff0a34a-6a80-45d6-95d9-8976bd71becd) +1. $(ID:7d2826e6-e806-4183-92f1-3a02bf4b386c) +$(ID:a6c4258a-1673-4910-9843-9435d1a024d7) +$(ID:b0e7b584-a09a-4805-a286-86a5dcf4cc6e) +$(ID:ca44b4c2-fa1a-46da-b204-2f3ed4697a0a) +1. $(ID:8c03482e-7f30-4a5f-a188-da0235b8dd06) +$(ID:49e18745-0673-4c04-af4c-f8f213594abd) +$(ID:60efa13b-bfe3-4f2e-89cd-1305ced3c9d0) +$(ID:9eef3f60-3996-42f3-8dc7-61275de6bbdb) +$(ID:5cc6c082-8bbe-44fd-9887-2f36a0259bf8) +1. $(ID:fe2a1f78-0563-4820-9914-738af1cbcfb4) +$(ID:0b15b2db-4a71-4edb-b5e2-cbab27e4ccb2) +1. $(ID:2f1f07a6-946e-449a-a997-5fc48909fcbe) + +### $(ID:35b99a1d-5533-4484-9045-4cea2619562b) {#RunningNVDA} + +$(ID:addc8eef-c5ac-4525-92e9-88296f0eb7ce) +$(ID:e6e23bc7-8c74-4127-b4e6-74478e82ba5c) +$(ID:6be97ebe-0164-4d80-99b6-f5b41e3b0248) +$(ID:2b870534-1680-4663-a034-42078bc00adb) + +$(ID:5afca9fe-7098-4cf3-86fa-5006bebc946b) +$(ID:41b2d6fd-5a3a-4c75-8988-8af94adde6d4) + +#### $(ID:aa2f9c87-65dc-4e3b-bf1b-54e1f9055ee3) {#NVDAModifierKey} + +$(ID:2b6e78ef-49bf-4ee1-859d-ae4640b4292c) +$(ID:9f959b1e-cff6-4c3d-b398-f4749c8ccafa) + +#### $(ID:46c7e0c0-f7ee-46c1-8777-14f58df2a879) {#InputHelp} + +$(ID:a0b190d6-4a17-42e0-8c78-9c2162a85024) +$(ID:fedd3581-b25c-4553-b218-a3d7e1828965) +$(ID:9490cb13-fbfe-445a-aa67-aab8e658f7d5) + +#### $(ID:fc327c59-c6cc-4deb-8737-8ec141268778) {#StartingAndStoppingNVDA} + +|$(ID:e4b26ccf-f40b-4141-84b8-f35a8e12c4ce)| +|---|---|---|---| +|$(ID:ef7a279c-ecb3-4bc8-a4c4-5004a302da83)| +|$(ID:b16e6557-ca15-444c-ae9b-f03d98c5a7e6)| +|$(ID:01a6ad00-6c23-4b05-a65d-c6d0f98dd13a)| +|$(ID:10d32518-6714-4e57-b1e0-235ddbb939ae)| + +#### $(ID:da86d3ea-77ab-4ec6-ae26-7edeb52b4d80) {#ReadingText} + +|$(ID:509fff76-fe80-4de5-ab98-1dfe8645780e)| +|---|---|---|---| +|$(ID:0c3012c3-bf19-4a4b-97c3-64e71638bb79)| +|$(ID:fd3fa8cf-7c58-4704-862c-d2744715c7b1)| +|$(ID:01d3bac2-112e-48ce-b082-4259aa5a3d78)| +|$(ID:d098a3f2-5157-413c-8126-69af29d5371e)| + +#### $(ID:c4c7d16e-ae6a-440c-ae16-9fd7f68c29c6) {#ReportingLocation} + +|$(ID:2b8a76c9-22b0-4fac-883e-5df827bd9f09)| +|---|---|---|---| +|$(ID:dd80c3e1-bbbe-4c29-ba5b-a76b7b09069f)| +|$(ID:75e70ea4-6b01-4336-9dd7-defae3fc41b3)| +|$(ID:ee421381-d65d-469c-91eb-d40598555843)| +|$(ID:3be6fa84-6531-434d-af9f-dc4efc331d7d)| +|$(ID:a75f1632-754c-4439-86c6-256844758f34)| +|$(ID:dc126fc4-503c-4e99-a501-cb2817d26b60)| +|$(ID:85eb7fc3-aea0-4669-b0a9-ecb073bebfc7)| + +#### $(ID:052c9d1b-c415-4619-805e-7188225ec9c5) {#ToggleWhichInformationNVDAReads} + +|$(ID:fa8ab648-4e53-4452-beb3-792afec8f90b)| +|---|---|---|---| +|$(ID:7b4a73eb-df7f-43ca-8462-8823e2938cd3)| +|$(ID:f1562e38-89a6-49f3-a849-228460490e0c)| +|$(ID:9109e753-2205-4e8b-9054-6d39bb42d68c)| +|$(ID:08d56fc9-179e-47ec-a87a-d78148fac9c5)| + +#### $(ID:6ea752d8-0e5b-428a-bb3e-c0a478e03666) {#TheSynthSettingsRing} + +|$(ID:ea947c56-399f-4018-9a79-b68d25f7d965)| +|---|---|---|---| +|$(ID:2f58f130-769f-49fb-aed9-21b0f47d7f99)| +|$(ID:c0ab1ca9-c1d8-4f03-8f03-8a3e9107ee24)| +|$(ID:e0df8de8-bf2e-4d09-ac49-a9881e8e73a6)| +|$(ID:5cfc0b35-01be-4fad-b2b2-b953a9e0f2cc)| +|$(ID:ee4d61ba-f20f-4c72-8d33-d318defdf9ef)| +|$(ID:ad628a54-a568-4b2c-be97-75ead51cc058)| + +$(ID:e655bc09-ad42-45d1-85fb-5fd8d8db7708) +$(ID:037c3155-3b15-475a-9417-d9993cc9a7e5) +$(ID:63e47ace-6a96-4592-a78d-12ca252826d1) + +#### $(ID:65a8a832-378e-4b1b-819d-cbdefc5a11e4) {#WebNavigation} + +$(ID:f608c66c-48d3-4ce4-abf7-33fa01d14f23) + +|$(ID:82db06ac-5f02-4feb-8dfa-84a89fcb8c09)| +|---|---|---| +|$(ID:58eb2008-9544-48e5-9949-e15d6a2cb1e8)| +|$(ID:d61d0934-96d9-4c0d-9ecb-b3aa7ae44715)| +|$(ID:fa89304d-255f-4e5b-b042-1cce779b56e0)| +|$(ID:5b36583a-2459-4259-bd3b-c199bc92ce48)| +|$(ID:b6b492aa-f89c-4638-9a97-34278c02effe)| +|$(ID:c4502827-dbce-4d05-86cb-1bcee2799885)| +|$(ID:a427eb0c-0350-40f5-af5b-1e67d4b6b5e9)| +|$(ID:9ef483d3-55e8-4de6-bd93-10f112a8b151)| +|$(ID:d9295a4b-f3f1-4988-89e7-c28a4e0231d3)| + +### $(ID:0ea2b49c-b8d5-43e8-badd-712773c4491a) {#Preferences} + +$(ID:1f45d1f4-3093-4cd9-b61c-89daf092116d) +$(ID:ae979a53-a6ed-4426-8e66-11cc7c306854) +$(ID:43aaf573-6b50-403e-a07c-85327e5d884d) +$(ID:f8615438-9258-4acf-bee0-c2916d3a06fa) +$(ID:0d0ad9ac-f3db-403d-9331-b5080f827747) + +### $(ID:0de12c34-a59f-4e59-ad3b-157ea59029df) {#Addons} +$(ID:6683e072-cbd9-4030-a63b-a98b56f791ba) +$(ID:245164c4-f625-4d87-a71f-227bbf835b4e) +$(ID:08ba237c-ae1a-4b78-9259-9ea20184d55f) +$(ID:a0fe4e7b-5d5e-4a5e-be99-f54082036039) + +$(ID:e6dc77aa-9ff1-462f-a829-f59a1169851f) +$(ID:d75dd780-6da2-4bbf-8f4d-4d4f650741fd) +$(ID:a74b826b-0213-472b-84cf-bccc03193e92) +$(ID:97402faa-8b7c-4e79-b1e6-aa5d47f5667e) +$(ID:2f57e79d-0502-481c-a1f8-72f15672addd) + +$(ID:4769bb66-699f-4eff-99e3-498ee8cad086) +$(ID:64c8cf29-6b3c-4b0d-a32c-9203f9e014a1) +$(ID:f7eba436-dd46-45d9-8747-0edae146ca7c) +$(ID:48498ff0-5258-4cf9-9242-21878d398902) + +#### $(ID:719e8965-9084-40e9-a223-41395bc349eb) {#AvailableAddons} +$(ID:ee25c3cc-2bd4-46f0-8cce-964da59a86de) +$(ID:f55c245e-d14a-4e69-b0a5-383aabe93666) +$(ID:3c309114-40ef-46fa-a1a0-c08ea89e6943) +$(ID:94c6e74f-a9bf-4968-bfe2-f832cea7cd14) + +1. $(ID:41899384-9cfc-409d-84c9-7d4430e94a8e) +1. $(ID:22fbdc97-ae54-4b39-8c32-3294b06ce80e) +1. $(ID:e25bb570-8446-4824-9074-87d6acf3995e) +1. $(ID:ad774553-c893-4beb-98ef-032d4a060c1e) +1. $(ID:e3518396-2661-47b8-b000-44c13fce1685) +1. $(ID:6db64cd4-f9b0-4be3-88c8-7525079ba2cb) + +#### $(ID:e5602553-a009-41a0-86c2-61839a224161) {#SearchingForAddons} +$(ID:ab30a230-373f-4530-9879-66eceb9e3c9a) +$(ID:27211488-c1e2-4e28-a4c9-ac8f87472417) +$(ID:687f9b52-d9fb-47d7-bb40-bc915278c267) +$(ID:307582cd-0aa4-4008-a9c3-f241aaffb82f) +$(ID:00ae1862-7912-4682-962f-66ef70112ebe) + +#### $(ID:6bcf3fa0-78de-49e7-9ca1-1b8e977d6876) {#InstallingAddons} + +$(ID:c40f8753-25a6-4663-b6da-dfdf40c0aa19) + +1. $(ID:da577c5d-e5a4-4fb4-bc1d-1b344b2853d4) +1. $(ID:24440fd1-713f-4547-a9be-9109a1aca2de) +1. $(ID:9032605e-87f3-4c25-9273-dab9a16d4741) +1. $(ID:79656b9c-5ee6-4cda-ac15-8a1888ec17d2) +1. $(ID:85012b5e-5c52-4aa9-a686-954acfa5dc83) +1. $(ID:30dc8ca9-96ef-4132-9f80-fc041dcba9eb) +1. $(ID:b3b5ee99-6342-45e4-989f-b65d897650c3) +1. $(ID:7460433b-9016-44ff-bdd7-512fbc7995f8) +1. $(ID:14833f05-b85a-4430-8bb5-da18f7561796) +$(ID:9f8fa329-a371-4490-9d48-d033ecd41675) +1. $(ID:a3130126-e00e-43ef-a431-2047aeeee7a2) +1. $(ID:496325c1-92c4-4d7b-9877-16f8dd44ee40) + +#### $(ID:ffc1a458-95b1-4d70-a739-7303bf0a6e88) {#ManagingInstalledAddons} +$(ID:a804fd77-79f9-4023-9366-b86bba033680) +$(ID:bce244e5-89a6-4fbe-8ee4-b3629ed32a82) +$(ID:0f652d09-b87a-43f3-a2cd-c01df6061aeb) +$(ID:902f2bdb-da13-4e1d-b346-e9451cc0af97) +$(ID:30206a6b-41ed-4710-9610-ea6d6bcf4135) +$(ID:3ff567de-1997-428d-bca9-778d1f50b179) +$(ID:30ce67c6-07a0-498b-b5e3-146dea76540c) +$(ID:6094fa51-aa89-467a-b21a-2066c5931f39) +$(ID:e0d5c218-f7d2-4c0d-b1c0-2295ecb3cab6) + +#### $(ID:b564da00-0988-418e-a1ed-a55e1fd4616c) {#UpdatingAddons} +$(ID:13d79053-e351-4f39-9e47-542e3fdb39f4) +$(ID:385872e5-0ebc-4050-bb3f-259202dd2135) +$(ID:fdb7616e-6b9c-47c0-8e8c-4fc8f40f91aa) +$(ID:3804a125-64fd-4c13-970d-2f81857fc554) +$(ID:708f846e-a6f2-499e-817f-3288f52b6749) + +$(ID:1318394c-807b-43b5-b039-4fc7b06acd30) +$(ID:b5be3f6b-f11b-43bd-9ea0-dd1e1cfa99d0) + +### $(ID:84e4a805-e080-490b-b241-73afbffd0046) {#Community} + +$(ID:10acceab-2d34-4444-9bc5-5ce455798b4f) +$(ID:494ab762-5a17-42d1-bb8b-446326255f74) +$(ID:e91aa707-228a-4e7f-9a49-d2ed408bfeb8) +$(ID:46936321-9783-4806-9518-1464a2679946) + +$(ID:02bcb343-6948-4d57-b460-babaadd25165) +$(ID:4e0eada1-6951-487d-9d54-13660eea0c6b) +$(ID:26df5d5a-2040-4bf4-a870-8f7863774716) + +### $(ID:86de54d6-f476-409d-8451-78b3221cd20e) {#GettingHelp} + +$(ID:4962c73c-2537-4919-a24e-6265fba7bb65) +$(ID:90ce2a18-9cf3-4936-afe6-72a865e4128e) +$(ID:72358c24-4d41-42d1-a2cd-6b5d6a6c9593) +$(ID:66650ab1-b49d-4742-832b-545a9dc3227f) + +$(ID:4146ebd2-c5aa-46bd-b5d9-65fcfcb7f07b) +$(ID:35436243-99e1-4292-8f2e-5a4fbfbbcc02) +$(ID:712c1a63-e97c-49b7-bd79-a3a35747c1f3) + +* $(ID:7ab9dec8-ef41-413f-a1e6-60d4fdbe5a57) +* $(ID:070e3a52-98cb-4664-b637-74c08b2ddbdd) +* $(ID:362350a5-a177-4387-9e88-3f3febbf1d61) + +$(ID:673d0905-0773-4a1d-877d-5ce2eb9ec97a) + +$(ID:9af3c950-afba-4bdc-9310-731d17ec11a6) +$(ID:3b562889-c394-4050-9f94-c92756402dd7) + +$(ID:d91f53f4-be0d-4fbb-a4fa-68b862250fe9) + +$(ID:15dca3c1-056d-45fa-9435-e6a56def0501) +$(ID:6482cd1a-3cf0-437d-ad85-fb6b07cf08b2) + +## $(ID:57368748-64dc-4aa5-9c6c-92c6b62f701a) {#MoreSetupOptions} +### $(ID:2e441a46-db52-46b1-a541-6099c2002c82) {#InstallingNVDA} + +$(ID:5bfe7435-7451-4c53-81aa-4f9ae104b57d) +$(ID:81e453c6-ed5f-4442-a6aa-3d08ca9a7964) + +$(ID:08d3f099-74ad-4e28-a1a1-4c5a5a49bbdd) +$(ID:54faaec6-f922-4610-b1ab-784ac01df080) +$(ID:97bbee16-9bfa-489e-97c4-158bcb95f4e7) +$(ID:935763df-21eb-4e17-a659-aaa34a87a980) +$(ID:c2e97b11-e69b-445f-a64a-3c302020ea80) + +#### $(ID:eb6ea626-9696-482b-9c61-ec0bf46229b6) {#InstallWithIncompatibleAddons} + +$(ID:74e73694-1699-43eb-b399-00732d32304d) +$(ID:8c2c1750-7d87-47eb-a034-037aae8268c6) +$(ID:fa153b47-cb07-4741-a3d2-0f2926bafa8a) +$(ID:6b9fe565-47c3-4fa7-abe8-5333a1f38c09) +$(ID:756d2f0a-51e9-4b5c-8b91-76cfd794f64f) + +#### $(ID:c291671b-b568-4240-b31b-acde20349cbc) {#StartAtWindowsLogon} + +$(ID:766a674e-2e0d-4fe8-9f72-fc9f29ba12da) +$(ID:b6ea0512-8390-41f8-b99d-9d0945b1af0d) +$(ID:9027d672-f478-4234-b084-a537a4d65d0e) + +#### $(ID:9403878e-53a1-47f7-bfbb-352e91ff25fa) {#CreateDesktopShortcut} + +$(ID:f61469c5-d8a7-4c3c-b525-4d568429171f) +$(ID:f199e44f-f643-4c59-9ec3-426094a09042) + +#### $(ID:45384ec0-c6d1-431b-9618-c36df6282808) {#CopyPortableConfigurationToCurrentUserAccount} + +$(ID:a41e64e0-bffc-4dd0-bb02-3c20cbf833ba) +$(ID:d2d4b592-2bca-4e3d-8291-25f4acb51531) +$(ID:7a2c8f35-4e70-4180-a6cd-e1c4034d195a) + +### $(ID:5c2d3e8c-a066-42b6-a79e-538eb0f35c11) {#CreatingAPortableCopy} + +$(ID:964c250f-bf93-4ed1-bb4c-1912dbcca701) +$(ID:49340036-d89e-48bd-bd64-8273d9b5ea7c) + +$(ID:f4dda05c-4b51-49c7-a1d8-e4962589d4f4) +$(ID:0d26c448-0ef5-4e6e-820f-e9ca0cb495d8) +$(ID:21faeece-4886-4177-bf58-a38def299b29) +$(ID:cbd0c31f-1a66-4850-bb5c-ade8a7aab5db) +$(ID:e96ff30a-c5bc-45d5-90d9-ba49cee655cd) + +$(ID:03575707-e41f-4c99-b1b9-c449a1c0d312) +$(ID:3e88ca65-810e-488f-b76b-c86f1328d312) +$(ID:4a3e693d-121e-4285-9cba-f414fd2d69a0) + +$(ID:d98853c8-c76b-4bd3-a430-59dfca30e93f) +$(ID:e9525028-e10f-4691-8dab-79d15133b4a6) +$(ID:341fd8cb-dd2c-412f-861c-c73332979531) + +### $(ID:9f09ba41-b03d-4eff-b84b-caafa561be1c) {#PortableAndTemporaryCopyRestrictions} + +$(ID:0d29c1c6-2d3c-410f-b1f0-8e4ddea6b6b3) +$(ID:97a09c6b-3a11-4cf2-9d35-51025ca2a504) +$(ID:9cc059a1-9ad9-40fe-a0e0-b296a6c27da0) +$(ID:f625691b-08af-4ef2-b112-cfb924d08521) +$(ID:def1dac1-985f-4c65-aed2-c04c2c0bde07) + +$(ID:faa91c93-b192-44c2-ade7-de1e26f242de) +$(ID:d7bb04fc-da7d-4f44-b1fa-c2c29332fcda) +$(ID:8513f3c5-de0b-4ec5-830f-ca8dc636db6e) + +$(ID:e2f82d97-7e07-48f2-9c18-be984698797b) + +* $(ID:3e67cfc8-1c82-4386-8862-947cab5f4975) +* $(ID:e2c96e17-1a1f-4186-af59-6d7a8bce58f4) +* $(ID:9247705a-e595-4ad8-8289-e13959a42522) +* $(ID:70d96951-87d6-498d-822d-486f21192866) +* $(ID:fec543b9-d54e-4c7b-8d28-8a0d5f583062) +* $(ID:aa54a533-36c3-4580-b9b2-40a7d9dc5cc4) + +## $(ID:b3de3062-c5cb-4d43-810b-7d6445903f71) {#GettingStartedWithNVDA} +### $(ID:5a4c58ee-66a0-491f-865e-2ed3e771b7fe) {#LaunchingNVDA} + +$(ID:74c7dda8-5bc1-49ce-aa38-c6bb7fd23b31) +$(ID:7073e648-817e-450a-8a69-dc93882bb742) +$(ID:44aa566a-82e4-49fa-9e9b-38bef51067d9) +$(ID:fd22911e-22ab-4b53-aaa8-615ce980fb98) + +$(ID:702a7cc9-5070-46c4-8a54-cd35e8937123) +$(ID:b731e377-9666-442b-ab38-13a373574f87) +$(ID:3f9c06ec-78b8-40bf-b916-1e59cf60d4da) + +$(ID:9de0b938-0bcc-4519-ac0a-449297d89be7) +$(ID:48744ecd-f83b-453f-adf8-48c1a751519c) + +$(ID:07582848-7adb-4bc1-84a0-85c03abc948a) +$(ID:d973c913-f69e-4c9c-ba27-e054067b714d) +$(ID:9d800b60-f270-4050-b399-bf9a8397c899) + +$(ID:3696d0e3-a740-4d7d-8b1a-4f4f8967b87c) +$(ID:119d4dc9-395e-4590-8095-38a3f98204a8) + +#### $(ID:0ce10167-eefd-4a29-a4ca-b4c663c98500) {#WelcomeDialog} + +$(ID:8db53c04-3e8f-40b5-9826-8a9e87b60ff1) +$(ID:f50774c8-e3d5-4ff2-a3ac-9924164edc11) +$(ID:fa68d0d6-b8b8-4282-be6c-9f2d79045d5f) +$(ID:5ee2f855-0af7-4553-82be-183337092fd4) +$(ID:7991be7a-b41d-4723-aac6-dafb174d5dfa) +$(ID:216ec858-6afc-4e8a-b9d5-6e7a2e8beeba) +$(ID:1c132153-a767-4349-9d9d-acfadac3c70c) + +#### $(ID:b1ec5bf5-2c5c-4fd7-807a-8707a0713b1a) {#UsageStatsDialog} + +$(ID:331ef39b-f4e3-45fc-aeab-d7e9cbf97b3c) +$(ID:1b4bb419-985d-400a-b2b6-92fd0d60dcb3) +$(ID:90b02d06-3a61-4c23-be67-17a89cf7891e) +$(ID:32856674-0c37-47a8-bebc-9a50fc9d08ed) + +### $(ID:95b8424a-fa01-434e-b129-d79c7144c865) {#AboutNVDAKeyboardCommands} +#### $(ID:7fabb187-438d-462f-bf34-8592962e785c) {#TheNVDAModifierKey} + +$(ID:6ea169b5-8316-4f69-9101-e96c45edca96) +$(ID:7d3231f2-a116-40f3-b0ab-d0d647d7b96f) + +$(ID:905357df-7712-49ed-abdc-1cd26f431ab6) +$(ID:a47d899b-78bc-4335-8d1d-4686ef5f1408) + +$(ID:373d7526-4e07-45b8-a4d4-1d55c8ce8abc) + +#### $(ID:0ed9b14b-9fd2-467d-9075-50cb23c8a7d0) {#KeyboardLayouts} + +$(ID:3fd04229-8ad0-4303-bb5d-33f92852494e) +$(ID:57ac50c8-fee7-4215-8271-e9441caf3c0d) + +$(ID:426f73e2-908a-4304-8923-faeb0606d1b0) +$(ID:68dd0ccd-00cb-4298-9bf6-220b48472c9b) +$(ID:a65167ec-2324-48ad-a891-8a2c5c2ae42f) + +### $(ID:f9b64a2a-9341-45ba-b4e1-a55272295033) {#NVDATouchGestures} + +$(ID:e023b402-b81c-4380-b012-91225f29f6f5) +$(ID:a02cc9c4-8981-4949-9cc9-64e57603d4c4) +$(ID:82a50dab-4d6e-4452-a41c-e6c3ce443318) +<!-- KC:beginInclude --> +$(ID:42992d3a-1e68-4d1c-a6c4-9f12e56bf279) +<!-- KC:endInclude --> +$(ID:d18096a2-0659-4d25-b49e-a3dc0935d179) + +#### $(ID:f1de6617-18e0-4f1d-b1c1-5c771080502b) {#ExploringTheScreen} + +$(ID:0678db9b-1bef-498a-96d9-36754477b2e3) +$(ID:e9fdb05b-58e5-4bb6-9b67-1093b663bb85) +$(ID:b0e54165-d276-4dca-806a-d0270da0ea77) + +#### $(ID:19272bee-b11f-4215-9b1a-ff4ba89f6d61) {#TouchGestures} + +$(ID:0c6336c1-da7b-4ad8-8cbe-3574c0cd8aa8) +$(ID:d57f4b45-de3f-42d5-99a2-e566558cf1db) + +##### $(ID:60b56302-f24a-4a9c-baaa-7f6e3216fd39) {#Taps} + +$(ID:79888c84-1948-463f-afaf-5ed4b3870a85) + +$(ID:3ced9ec4-f36f-4e74-90a8-ffd6f8466476) +$(ID:fa038863-bf8d-4c6d-bc5f-b8b29c4c05b3) + +$(ID:c1009889-73f6-4b66-89ec-a5c2b8143d6f) +$(ID:53da29a9-c24d-4afa-9ac5-efde0d6a66fb) +$(ID:f4937423-16da-43a6-b830-81617916f388) +$(ID:354328d5-5e81-4eb5-9665-2c3e60d0ce09) + +##### $(ID:b24b5252-27d0-460c-92a1-594e1818c703) {#Flicks} + +$(ID:82ee155b-c64b-4fe9-a3bd-f0ff4dbead14) + +$(ID:af67a2ee-7778-481b-a054-f735244db35a) + +$(ID:04a8a613-af06-404d-b121-372eee8c3e24) +$(ID:28ff7b38-a15b-44df-bdb1-79e0961841f4) + +#### $(ID:1e3c9e38-6f8b-4303-b2ba-23fb70e702fe) {#TouchModes} + +$(ID:c2be2b9c-d443-45bf-9621-6daa2564f7ad) +$(ID:1c45a650-f3cf-4c87-9100-b89cb034bf2f) +$(ID:e57286e4-9c40-4ee4-884a-12fea8b37e8b) +$(ID:c52cb009-436d-4aee-ac8d-70b2a48ca04a) +$(ID:bc16097b-ac46-47dd-89c0-2e41f104ca27) + +<!-- KC:beginInclude --> +$(ID:3134a5f0-1a31-4394-9076-e59e638f5063) +<!-- KC:endInclude --> + +#### $(ID:fbd3a911-eb17-40cb-9fc3-1408ddaab3b0) {#TouchKeyboard} + +$(ID:c0ee6b23-5960-439b-b8b3-3b34b9e5b64f) +$(ID:a2f8557a-64c6-4f23-8f68-84a67292c855) +$(ID:de06b96d-8b66-45df-9e5e-19f71c77ee63) +$(ID:d33061f0-1509-4979-9a16-14e55a4f4ff4) + +$(ID:38c862aa-57fb-405c-9d39-36497f8ac1bb) +$(ID:c6ca5e68-afea-40eb-8f27-163eb8e90aa1) + +### $(ID:85ebe012-cc9a-4c15-aba2-ec2801aa7296) {#InputHelpMode} + +$(ID:210ce846-4ca5-43d0-b304-35814cf32254) + +$(ID:ce48d3f9-eb50-4799-85ee-caad22828e1a) +$(ID:bd39d42a-82d7-44a1-865b-8ce14c9078cc) +$(ID:67596daa-8b69-4731-9585-5a910dd00eab) +$(ID:fde4598a-781f-40c0-b77c-7692461bbca3) + +### $(ID:5b656e18-099a-4c4e-bc1f-88541d27b734) {#TheNVDAMenu} + +$(ID:8b80e4f1-1054-4c31-9738-8a449938b149) + +$(ID:6ff09011-c496-447c-b6ee-dad221dd8b92) + +* $(ID:8f64fcde-451c-4a1c-8ea9-60a28add5931) +* $(ID:828de3d0-090c-427d-8ce7-899bfbbbd2dc) +* $(ID:d0573a9d-f6f8-40f9-b37d-202d179591bc) +* $(ID:67beef39-ce82-4855-8546-c71314f5c837) +$(ID:2a033c20-f3d6-4c80-af46-c0dfd78630dd) +* $(ID:402fae73-9615-48f9-aea8-64883b9e69db) + +$(ID:7f021bf8-4f60-46f5-879b-572aaadcdc25) + +### $(ID:cdac0854-7b72-47b2-aa50-888bad215a37) {#BasicNVDACommands} + +<!-- KC:beginInclude --> + +|$(ID:8e3bf482-bfdc-44fa-b1a6-3aec1179c620)| +|---|---|---|---|---| +|$(ID:210981e1-bf54-402f-9fcc-0cd17db35d2b)| +|$(ID:73f13c07-1f79-4a49-bca7-45a7313887df)| +|$(ID:e9d4d329-01bc-451a-9fe2-cc5f1bb970b8)| +|$(ID:8b767a3a-276c-462e-a73a-66691666d7b9)| +|$(ID:3716890a-6c97-4cdf-9365-fda73b0a9c06)| +|$(ID:d38605d3-3e0e-4be8-bea1-2fbf2f8efbdb)| +|$(ID:54cbd9da-746d-46d3-857f-e326051fa61b)| +|$(ID:983321fb-27bd-4d98-aadf-d68f45cd564c)| + +<!-- KC:endInclude --> + +### $(ID:8e1f9b64-2d41-4a3d-8b01-80878e5ecd96) {#ReportingSystemInformation} + +<!-- KC:beginInclude --> + +|$(ID:2d1e4375-6a14-4df5-855f-237ec93445b5)| +|---|---|---| +|$(ID:2c8dd810-27ed-4ea0-a7cd-d192300ea74c)| +|$(ID:7e48dfd6-6c99-4fc5-9013-dd3ac5a776af)| +|$(ID:bd33763c-def7-4e8e-ae75-85a6443b17cb)| + +<!-- KC:endInclude --> + +### $(ID:e7ae8c0c-5eec-4f66-b71f-085145fa04ef) {#SpeechModes} + +$(ID:c7c1f858-ff4a-4f41-9c8e-e8b0b9bc88d0) +$(ID:4c332fb0-c81e-429c-b084-268ea73e2285) +$(ID:67c674d0-0094-4f81-affa-e8c2d4dca1c4) + +$(ID:d21ccbe3-4161-4daa-9460-a00e2862f452) + +* $(ID:01be5869-9ca8-4b3f-a363-8edb7970b017) +* $(ID:afce889e-522c-45e5-be3d-e180d5ce9ee9) +* $(ID:2cfeae2d-bb2d-4b4f-aec3-8ed28787ab2b) +* $(ID:14a36e65-e9aa-487a-ad8b-fee79537dfb5) + +$(ID:5e5b9d45-0e00-40f1-9c36-ee68a0e522ea) + +$(ID:b567e82e-00be-4bea-ba2d-7dc4faad591f) +$(ID:b405adaf-044b-44a4-b675-5e0f75b11b51) + +$(ID:85dd75ac-9511-49f2-ba1f-e6052a632fed) +<!-- KC:beginInclude --> + +|$(ID:d0442d18-5b54-4ee1-bb8b-5e16c25404e0)| +|---|---|---| +|$(ID:5f742db3-e8f2-42b8-88db-63cbd82e8d41)| + +<!-- KC:endInclude --> + +$(ID:2a5099e7-6d8c-42f6-86db-fc679c43ed82) + +## $(ID:c3cb22ee-9178-421c-b4bb-b0b252bbdc83) {#NavigatingWithNVDA} + +$(ID:84e75ff3-7f46-4631-9996-cda70c084964) + +### $(ID:c6c5623e-a90c-4cb1-8aed-9cf7d7dccef8) {#Objects} + +$(ID:052a3e3d-b5c5-4230-812a-b60e9343c5d2) +$(ID:f9bd1f18-2e8b-4767-8952-280df6b5c983) + +### $(ID:7344602d-9ab9-41fd-99d5-c9987b40738f) {#SystemFocus} + +$(ID:df117f0a-4c7d-4a7a-89f0-6a8ca9efef1e) +$(ID:23f66eb1-5ac5-41ca-9c9d-0b4f8e235a81) + +$(ID:aaee1bb9-d277-44b9-8881-45a1219b0538) +$(ID:c8a54a23-0f79-4360-8497-3afaa82f7947) +$(ID:ef507e8f-1618-4fe4-af8e-5e9911276919) + +$(ID:dfaf309e-34dd-4ad7-8e28-9418e8dbdfc3) +<!-- KC:beginInclude --> + +|$(ID:42ddeac7-88ae-49b5-a4c4-56c3b63e520b)| +|---|---|---|---| +|$(ID:cdaa12a1-29a7-4046-af91-c59a1ca00b4d)| +|$(ID:c8ce15b7-d2fa-4afc-8c80-935b7ddacaa3)| +|$(ID:86d0bd11-fd8c-47d3-8c36-2c63c876776e)| +|$(ID:bf455117-9bde-4be5-b3bd-7bacf1891231)| +|$(ID:352a4366-9b83-4eff-babb-37d3e3308fbe)| + +<!-- KC:endInclude --> + +### $(ID:5a1057d6-f6a4-4a20-b097-2ac2c5d39e52) {#SystemCaret} + +$(ID:ac853982-5546-4707-9c52-1951dc94cb40) + +$(ID:c3081147-95c8-4f8d-810f-c9e66a1fe7fe) +$(ID:01599c90-d1df-40f9-b0e3-1bb78938adc4) +$(ID:3157eeaa-51e2-4612-a3f8-f5108d401a92) + +$(ID:45c88e18-32aa-48f2-9ea6-4595ffbccbc0) +<!-- KC:beginInclude --> + +|$(ID:146a484b-fcf5-44d1-8b7a-368e3e9c7309)| +|---|---|---|---| +|$(ID:f11350cd-057a-4a49-928a-20813798230d)| +|$(ID:4c5405b9-09e7-44d7-915f-6d145a7b2b10)| +|$(ID:2ad65d11-02eb-4651-b40f-0446bb0f61af)| +|$(ID:5410c0d1-f10a-4ef4-a914-3d37e0930862)| +|$(ID:9df76723-e7c4-4e1b-aa7a-65a16cb3c311)| +|$(ID:2a490217-b233-4a4f-a523-08c5f31232a6)| +|$(ID:d1c8387b-90cf-464d-821d-583c2a373e34)| +|$(ID:18d6985b-ec14-4b1b-af15-5500989ce367)| + +$(ID:f2c5e713-d2a2-4c3e-8d24-898fa503ee8e) + +|$(ID:3721a417-e94a-4e20-97d0-c4c477d430e6)| +|---|---|---| +|$(ID:34abe082-48a8-45d1-a5aa-078536e8ca0c)| +|$(ID:cf7fd9d6-6833-4e6c-be5f-fd45b81c60c3)| +|$(ID:c1ebef62-7afe-4736-864b-79cb1d2aafc8)| +|$(ID:faf419fa-b417-492b-bbec-57c80a5acc94)| +|$(ID:86767d89-da97-4458-b94e-09822b579bf6)| +|$(ID:b5e4b078-2378-4623-acc0-fdb959a7c634)| +|$(ID:58d6aa77-614b-45ff-8cbe-3c33b060e18d)| +|$(ID:eb0028cf-84d9-4431-881e-07d8ebff5cb5)| +|$(ID:2e267e49-04e6-4706-817f-f8b0619ee70e)| +|$(ID:8057c7b0-88ed-4aa7-80a9-e5060273077f)| +|$(ID:033ef5bc-fcfb-4591-b21b-5cbc821c2c01)| +|$(ID:6cac6768-fb95-40f4-a4c6-4edaecc9a3a5)| + +<!-- KC:endInclude --> + +### $(ID:3f7a569a-ff51-4ccf-849e-629b45d1e22d) {#ObjectNavigation} + +$(ID:f2a10b89-9b31-431d-ae54-6ac9aac52788) +$(ID:7460b2f3-c8b2-4db4-b4c9-9d0de66e25e3) +$(ID:e56e77af-77b5-484b-b589-742ee079f031) +$(ID:ad953fa2-415d-4049-b3b0-53b4d7be9a92) + +$(ID:2e9c0942-9138-4aad-804f-ca9a459e404f) +$(ID:efe6eabd-cd3d-4115-bfe1-c14ab055f9e1) +$(ID:10d3b179-ed16-4ee9-a6c3-5da7e54e315a) + +$(ID:64ca7394-daf8-4300-bb0d-4198da6518fc) +$(ID:9cb9dc89-17bb-4518-aa6b-1ff1c8d83f4b) +$(ID:f64dce44-e6b2-4275-a3a3-22123377c868) +$(ID:1b334c25-257b-4b75-bb7b-ae1345830bc4) +$(ID:077e457d-6ea4-4d22-9988-344e412cb77b) +$(ID:60209728-4cc7-4dca-b6af-6beb0ddc729d) +$(ID:9f47f2a3-3490-4e05-b84b-3ed3a778668a) + +$(ID:547fcdd1-6f4f-4b19-b510-e1863b3acf55) +$(ID:be9cd6be-a321-4585-9cf1-432f07085662) +$(ID:8274ac01-60fa-4bd4-a2fa-cd370b75d04a) +$(ID:cbf9544c-ba51-40a3-9607-49abbca090af) +$(ID:fabb340a-26da-41cf-88a4-39be99e55946) + +$(ID:acd4653e-b7f4-4ff5-8e46-2ee3a89f93f0) +$(ID:bbce6dc2-c51f-44fa-9c93-bb9c94e2707f) +$(ID:eaebd3dd-cea3-4155-9627-9ce5ef40405e) +$(ID:22bf5b6f-fb3f-488f-9364-8416e2eca513) + +$(ID:a6ca5e17-cf76-41a6-b334-fba1f2fba37f) + +$(ID:556e403b-9d2a-4705-af42-70871055149c) + +<!-- KC:beginInclude --> + +|$(ID:d4d52b6d-3ad1-4632-9c5e-b85477795049)| +|---|---|---|---|---| +|$(ID:aed312a7-d5e6-4e20-a8b2-92349996d47e)| +|$(ID:63656216-1d52-479f-9911-1ed21f56c1f0)| +|$(ID:8fb6b8fa-e7b4-4937-9ef0-02ffd3f2b79d)| +|$(ID:54c108f3-9659-44ba-9387-74319d43c206)| +|$(ID:57585044-d4a0-490a-91ac-4b70b9d5fd0a)| +|$(ID:d67372e6-9150-41fc-945b-ad639d95485d)| +|$(ID:050bd906-77f4-43d3-8366-fb64c244511f)| +|$(ID:201af03b-8c31-4973-b218-202be0930980)| +|$(ID:02f43332-dbef-4a8a-831c-592667c68a02)| +|$(ID:d975a8f8-28ca-43c7-8fb5-9c7e8e5184db)| +|$(ID:ef240f08-ade8-4eac-9b4a-903acc5a149e)| +|$(ID:df3c9b12-0482-45c3-ba31-f5628f80f53c)| + +<!-- KC:endInclude --> + +$(ID:679740af-4bc1-4b98-b54e-f36f13bd742b) + +### $(ID:fd0f2f6d-3872-498c-b6c7-46b42dbf9945) {#ReviewingText} + +$(ID:9ccc9f51-9cd8-4fed-9793-5e90ca25247a) +$(ID:9892dfe3-27a8-4318-aaa3-7efa816b8b04) +$(ID:cc055480-439d-4ba5-81a2-a6155508dd91) + +$(ID:d6e2ff4f-d501-4b39-8798-89b73ad78feb) +$(ID:d416934b-ec20-475c-81ac-5de7e8fd09bc) +$(ID:54186a71-5e63-4c20-a839-bffe13b2621b) + +$(ID:143edd7b-c2fe-408d-a1c4-ddceb938f6cb) + +$(ID:c84eb5df-5f77-4e3e-b69b-d85c7dd9ffe1) +<!-- KC:beginInclude --> + +|$(ID:5f507c60-f95f-441a-87ae-e4e89cda0d42)| +|---|---|---|---|---| +|$(ID:d19c2bf7-3f32-4a9c-96f7-0f603daee902)| +|$(ID:3291f745-57a2-4fd0-8d42-a8588ab969d9)| +|$(ID:0f09458d-5583-4c88-af04-f98d600abadf)| +|$(ID:0f4a8091-c712-4667-b7f4-32a374c4636f)| +|$(ID:b73ccebf-9024-4728-830e-cd1e07daeb3e)| +|$(ID:f88b17d1-8c22-4405-89b2-a25d9fb7a14f)| +|$(ID:2d3bc5b1-1764-4ca0-863b-5d0040afa464)| +|$(ID:fb8f2ac5-ee38-46d7-85b7-c1a8a0befde7)| +|$(ID:ea10e2c1-3dc7-441b-96c6-b3aadaf2cdf2)| +|$(ID:26012fd3-5082-46b2-94b9-95cb7c7173f7)| +|$(ID:5b1be9b0-d3dc-4c53-9012-874bc1792b64)| +|$(ID:882a011e-d5f0-4226-8a00-4e703c9291d6)| +|$(ID:335ab625-868e-4d7f-8d36-adec77457dcf)| +|$(ID:4d6adb2b-60c1-4520-9dfa-0f2cc5e34be8)| +|$(ID:87b5e793-e0bd-4f10-b9f1-1d87d48ffb6b)| +|$(ID:40d87ed7-b08f-4ea9-9d21-4db08d4f0e24)| +|$(ID:025c1550-198b-4c73-9234-53de940dccf0)| +|$(ID:9c872d2e-6fb5-4a66-8b8f-52af9bd479c2)| +|$(ID:6df1fca6-062b-4ab7-b0cc-79ded1527f59)| +|$(ID:02fe8cca-514a-425e-a134-9446fd18a1f8)| +|$(ID:a3ceceb9-38ef-4589-a3b2-f5225cbdc7ee)| + +<!-- KC:endInclude --> + +$(ID:2674f466-e6b0-43a9-9729-8f2ef606f212) + +$(ID:d3405607-17b7-4a8c-8307-d473c10f583d) +$(ID:da7d30ee-9dd5-42da-9f0d-930cf1a80b1e) + +| . {.hideHeaderRow} |. |.| +|---|---|---| +|$(ID:dd657f64-9320-4216-8b58-4f6a0a809b02)| +|$(ID:18373839-8043-42ff-8c01-ab57a384a6f0)| +|$(ID:afa4f472-9f32-4e61-82e5-ca075efcbf75)| + +### $(ID:2cc21008-92ec-4f59-bbaa-ab9b8554bd0b) {#ReviewModes} + +$(ID:f72033bb-476d-4773-a0a2-e9328e279c18) + +$(ID:5a3c39ba-719b-46af-a2e8-4054d092585e) +<!-- KC:beginInclude --> + +|$(ID:237ba3c1-4c13-42cf-9fb7-57e626923f00)| +|---|---|---|---|---| +|$(ID:fdbee28b-e2b7-41a6-9a1f-7d4d18eaac67)| +|$(ID:a376f2b5-800b-4db9-a201-b8e06eac4e12)| + +<!-- KC:endInclude --> + +#### $(ID:773c7460-5fb9-4dfb-b5f3-b131021782f6) {#ObjectReview} + +$(ID:20722744-6ee8-4948-821f-49ec1cb385d8) +$(ID:cc4e6aa3-9551-454e-b72b-49d8e7453641) +$(ID:0da95a6b-c09a-4ea2-bace-4fd4983c2aec) + +#### $(ID:02218b31-cb55-43b0-b1be-aa977bc814de) {#DocumentReview} + +$(ID:56fbd73a-67cf-4ece-ba06-3fce78594726) +$(ID:988eeb27-1ed4-4fd3-bd84-6f701d939518) + +$(ID:b71a1152-6029-44ff-9c2e-f3aa30b89102) +$(ID:3ed99ebf-0fcc-4ee6-9a94-54684b733128) + +$(ID:79bd8669-57c8-412a-b972-bbcb33ef01ab) + +#### $(ID:bcd5460c-7330-42a1-a1c5-d86bbc2207ce) {#ScreenReview} + +$(ID:339122bb-5422-4d8c-b463-333235784cfd) +$(ID:3e51584a-6347-4b75-b5f7-d76c5072dec3) + +$(ID:e2118080-98c6-44bc-a5e3-06da560d3d7e) +$(ID:e900335c-26c0-483f-abec-7a143512384a) + +$(ID:73360cb3-1171-4faf-aaa1-1f6967481393) + +### $(ID:2a4128df-99f1-4842-8de4-69cd634fac80) {#NavigatingWithTheMouse} + +$(ID:9d011316-ef44-41f1-b5be-d670dbc5537b) +$(ID:c3b180de-ca8c-4eba-87b1-a12c3fa928a1) + +$(ID:6528058a-a287-460a-84c5-8daad7990bae) +$(ID:24197eaf-7453-44d3-b1b1-b9ac0cbf0e58) + +$(ID:e9b08946-5239-4427-95ec-0a79990a06a2) +$(ID:df59ed47-c10c-4082-9226-83783c79aa25) +$(ID:06e50b5e-d586-4b51-8a68-5db32cd6dd66) + +$(ID:4aec3a12-f83b-4a21-b420-3ebd77361b9f) +$(ID:f0a2feae-4c46-4509-899a-cfe777172fbf) + +$(ID:9059d4e0-8bda-4385-acee-5f7ac1e131df) + +<!-- KC:beginInclude --> + +|$(ID:a9a76997-731e-4c98-a655-d18027fe0a1e)| +|---|---|---|---|---| +|$(ID:c528dd9f-58c6-4232-99e5-cf05c6245334)| +|$(ID:0f539bba-8ff9-4b3c-845c-8d80a4275832)| +|$(ID:523c27db-b6d9-4e64-8dc5-05bfa889b7ca)| +|$(ID:e22e8e6c-18e1-4213-acd9-e439e2a04dab)| +|$(ID:14d2a644-a0ac-444b-bd04-009335c193fd)| +|$(ID:8d4d6b3b-2e88-40e2-b457-7e06b96ae374)| +|$(ID:19076bab-a9fe-4a4e-bcff-2db3d4dfd911)| +|$(ID:d8b90ba2-3470-4a0a-9db2-5c3368231cfc)| +|$(ID:f6dc2d21-0c1d-41bd-8c8e-1a02c65f6a7d)| +|$(ID:5365c824-75be-4ba1-94d8-a0293a1411d8)| + +<!-- KC:endInclude --> + +## $(ID:48c90ca3-a104-4fd4-bca4-af089a2a1848) {#BrowseMode} + +$(ID:0bb098dd-ded0-4397-8231-4da0b01c423a) +$(ID:b31808b1-9495-46e6-bc2d-162ae6501dbf) + +* $(ID:4e685c38-41a4-476b-ae16-b36eacd841ac) +* $(ID:4ceda80d-d521-4adc-82db-87b9a406fc28) +* $(ID:4f6f7334-3426-47dc-91ae-75fb8d028f0a) +* $(ID:b0c53f85-e90e-4eed-9f3b-b1e3c3d078bd) +* $(ID:b0a8b954-5bb8-49cd-b4d8-7ad4a969324d) +* $(ID:d4bf99e9-f8ff-4075-85cd-e4c29092bfed) +* $(ID:0367bd9b-f182-4302-8927-d8fc100b6db4) +* $(ID:c2a47b18-17b4-40ef-bc1e-01b5aad6da26) +* $(ID:c419a08f-8e0c-4ec4-9c69-bfe0919d115e) + +$(ID:3562d9ec-05cc-4144-95d6-bd019b242a8a) + +$(ID:3fd3db44-48cd-402c-967d-4b62b82baa4d) +$(ID:b825dbbc-398d-4ced-a35b-b6ed5e71c50e) +$(ID:92099f33-3a99-48e2-a33f-0a7e5d980f03) +$(ID:8226c429-ef7b-4529-a44c-05388ae0a0e3) + +$(ID:dcc8b04d-1ad8-4221-a57e-3bae49b4a470) +$(ID:5bb90658-6788-4706-bd6b-5120cb45b2da) +$(ID:48e25f5e-0ab3-4b21-97e1-7259f9539425) +$(ID:63760c63-9679-4d06-add3-b165630132e2) +$(ID:2875f24f-68e1-420a-b2e0-9176f9b40a48) +$(ID:250af3bd-6fd2-4e26-93f6-84a5c0472ec8) +$(ID:61bb4dbd-990e-4cc8-80da-46c2592478f4) +$(ID:f7d89255-aa54-472e-a7e2-b4947726a2f2) + +<!-- KC:beginInclude --> + +|$(ID:6782ccdb-c114-4028-aecd-5a300d3ab13b)| +|---|---|---| +|$(ID:2cdaaf6f-874d-4407-8c5b-cf9c7103ff94)| +|$(ID:067d50c1-fd1b-46fc-b40a-ea721dbe007d)| +|$(ID:2ccefbe3-14e6-40f6-8733-222d3e98e324)| +|$(ID:e3890a13-d0bb-4dc3-b111-24169873618a)| +|$(ID:7324371f-00e3-4243-9abd-a473c8d33ad8)| +|$(ID:9007384e-283e-48d7-927d-fae621607fc5)| + +<!-- KC:endInclude --> + +### $(ID:1f3491e6-1f5a-4128-9bbc-883a933a8060) {#SingleLetterNavigation} + +$(ID:e26183e1-9887-44d5-905d-8275ba5f2a5f) +$(ID:b86ff2ec-f91d-46d3-9c95-6a8f16e22088) + +<!-- KC:beginInclude --> +$(ID:52357ca9-bdc4-4590-80c6-91c09be75cfe) + +* $(ID:274afa98-537e-4fe3-91b9-e455ff976782) +* $(ID:db18378a-6678-40b0-ae6d-94086718997b) +* $(ID:c43c7aff-1bcf-4895-99c6-0b659acc0e74) +* $(ID:c1c08fc1-0731-4b25-a2e7-3b6314e2d499) +* $(ID:99f41a6a-1610-47c0-9483-9926a4de3d9d) +* $(ID:e5dfa7f0-db39-42dc-8e27-b538739be9c5) +* $(ID:9b06eeca-cea1-4fc7-8b5f-7fb0a30742c3) +* $(ID:16b17b7b-c813-4f21-808e-d2081ff768b7) +* $(ID:7a948f68-93ad-4b7f-b5ee-4c16de718288) +* $(ID:a10f3e94-da18-4e5a-afc7-1b0cc1887a8a) +* $(ID:9147a1f9-7fa4-4b63-a9e2-bae600160e29) +* $(ID:3864e4a9-cb5a-419e-92e8-a9b74ea31c2d) +* $(ID:63a67788-3170-4be7-a0a7-c6646d66f139) +* $(ID:195ee45b-d0ed-43aa-b41f-139169781e56) +* $(ID:6be46e94-23df-4fea-ade2-c6c828ba1443) +* $(ID:49cbfcca-7f03-4b92-9193-9c14cff461a3) +* $(ID:e658e3f7-bbd7-4262-87cc-ac5be66a3168) +* $(ID:40ddba63-a441-4048-bad7-e175691a9b9a) +* $(ID:05368f6e-aa24-40f7-bbc5-5383ea63cac8) +* $(ID:114ad04a-7993-47e2-a016-62a294c41c23) +* $(ID:c7826249-e12e-4af6-8eae-5daf771f29a8) +* $(ID:5fd61ba4-4f37-4269-adb8-5995c0a4c467) +* $(ID:aa2bfe0e-dedc-4423-a8e0-f8aced0797b7) +* $(ID:1b08dcdd-28a5-44a7-9474-0d471b92a8d6) + +$(ID:9f8bbfe2-d31d-4ab2-ae00-de22bb5fb56c) + +|$(ID:892eb33d-1b13-4bf2-9180-ca1496763701)| +|---|---|---| +|$(ID:30d36a07-1074-4009-9e19-a6f01377354a)| +|$(ID:80b6ff05-0ade-473d-babc-af8f5958228f)| + +<!-- KC:endInclude --> + +$(ID:33a302d1-6a82-4080-9c98-20ab42a571ae) +$(ID:b0b83668-1c19-4ae7-aacb-2dbad33e20aa) +<!-- KC:beginInclude --> +$(ID:86c92aa9-c268-4443-8fe0-785a8ecca005) +<!-- KC:endInclude --> + +#### $(ID:e816d95a-0d13-4ca4-8958-3a4ee8fff0f7) {#TextNavigationCommand} + +$(ID:089791b9-5c35-47ad-ba9d-f7959af3575f) +$(ID:2476bde4-82ba-42fe-8d7f-f9020f5e31dc) +$(ID:9496c7a8-725c-47de-9e3f-33c18d625811) + +* $(ID:61b9bdef-ee9d-445c-8a36-935212afcf3c) +* $(ID:02917e25-6ff4-40c3-bb95-c114b042256f) +* $(ID:b9510d0e-39a1-4fc3-a4de-c37acc1f0b8e) + +$(ID:6e0a2a25-cc9b-4061-8742-7c922320a12f) + +* $(ID:4456067c-7074-467d-bd82-0b6e636ab7a9) +* $(ID:f371fb6b-4766-4b68-9610-e01abdc4ecfd) +* $(ID:afef4fc8-eef4-4a6e-b232-501bfa744355) + +$(ID:fe469de2-1f2a-4e6d-a26d-682fefca02d9) +$(ID:4f4a142a-2889-4b38-9e28-10f899619443) +$(ID:0754ff78-f3c6-475a-adc3-695ec13dfe64) + +#### $(ID:988e78aa-4c59-495d-b31e-403118a33466) {#OtherNavigationCommands} + +$(ID:67f5a514-78b1-4b2c-9ce4-c4fa32cb74a5) +$(ID:420e81b4-9086-4108-ad8f-fab4ad9f9e96) +$(ID:72a94058-e94a-4cbd-a9ad-539c52eb1e9e) + +* $(ID:da99d206-b265-48e4-9045-f86f6a830823) +* $(ID:cbca7476-061f-464c-9398-a75e6f5c03a2) +* $(ID:c7c02c8c-b79c-4c90-a1fc-3717051d0d2c) +* $(ID:8e2a9e57-72a7-4540-8a8a-62bf51d45915) +* $(ID:3d96d081-0007-4ce7-a126-9b46200d6457) +* $(ID:a20fb691-a4d5-4f79-b219-9fb552ea8eb9) +* $(ID:e0607302-ff98-464e-ab84-f396be9937f0) +* $(ID:4b728462-bfed-4b53-8ba1-7f1bf08f9634) +* $(ID:b0a43e5b-1d6e-48bd-9460-0be5638bc6c8) +* $(ID:09aaa552-05ad-42d6-967e-71635bda6c3b) +* $(ID:8d0e523e-a89f-49e7-8df8-7dd7411e4cee) + +$(ID:32f75f9e-9392-47d6-a440-b28fdb8a29bd) +$(ID:76cdeba3-b25c-4ae1-9f4b-4bbe09bcb590) + +1. $(ID:21210946-7ab8-4451-82fb-ed02924ba6be) +1. $(ID:5dbc3a4f-ed8d-4ad6-9bc6-8c045607015e) +1. $(ID:d99db5dc-2b23-43b7-a43b-f138e5cab6fe) +1. $(ID:25277a4b-fda7-49b5-ad6c-5376ea421f4c) +1. $(ID:f9346a98-fa93-465a-9149-f0f5cd08f5b4) + +### $(ID:47266dc7-8442-4b33-88da-e6e1f00a0a04) {#ElementsList} + +$(ID:02e01dd2-5903-44cf-b458-d7936a243aee) +$(ID:dde3bc8b-90ea-4e89-890d-f72433d35be2) +$(ID:d2d0b08b-b2d9-47fe-bfb0-7a27ba4928d8) +$(ID:ea52ba45-9f50-4cfa-8e49-048e484fa98c) +$(ID:1f94900c-7bde-4fbb-9b2e-adbfa0c34426) +<!-- KC:beginInclude --> + +|$(ID:52bcd3d5-da88-471a-9910-9ed3bc26010e)| +|---|---|---| +|$(ID:591aca9e-4984-4bae-ba8f-9db7061446f4)| + +<!-- KC:endInclude --> + +### $(ID:730ad2d6-14ac-4abd-964f-429acdf80033) {#SearchingForText} + +$(ID:87e515d4-6e17-42d6-a797-c7b26cd97a6c) +$(ID:b98f9a73-0276-4507-94d7-49faf9b52236) +$(ID:2f5c5844-ce00-4106-8cc9-1c4a6ed4db64) +$(ID:5e7951ae-3e98-4e0c-a7ba-27d820afdcce) +$(ID:7b7daada-42a3-42a7-ae00-f3d6e097518b) +<!-- KC:beginInclude --> + +|$(ID:a1197c16-5e33-4c9b-b5d1-0824628236cb)| +|---|---|---| +|$(ID:fbfdfed3-9501-433c-aa18-5bad2ba117f4)| +|$(ID:812c76e4-840b-4efb-aa15-01970e403b58)| +|$(ID:b6211645-b188-4c3d-8156-4bcfe29988e8)| + +<!-- KC:endInclude --> + +### $(ID:d337fba7-a786-4b8a-a727-857b09989837) {#ImbeddedObjects} + +$(ID:098083df-b3a2-4128-92f5-32f58978d75a) +$(ID:cfbb3d3b-e75b-4b24-bdb3-e05c3a7efc85) +$(ID:c61adcfb-e7ad-49c2-ad91-dc28a92a22fd) +$(ID:3c8f133d-653a-4ca9-9e11-4743660c13e7) +$(ID:7571ca15-9062-4a0f-9a4b-5af64f5baa54) +$(ID:f14bb3fa-ead6-4052-9621-c40792333789) +<!-- KC:beginInclude --> + +|$(ID:8bdb4990-cf25-4562-b408-60779bf05558)| +|---|---|---| +|$(ID:d0cde02a-9fa1-4adb-ae3f-e62160ff6fc5)| + +<!-- KC:endInclude --> + +### $(ID:159c984b-8a70-40f1-8ac1-44b63934a254) {#NativeSelectionMode} + +$(ID:b9fa52f8-5c67-41c9-a02d-d3531293581a) +$(ID:549d157e-a6ef-4dee-b280-b0c8ea2fd6fe) +$(ID:6beb984d-6990-4f63-992d-cbedfe07ea08) + +<!-- KC:beginInclude --> + +|$(ID:0c220da6-bf37-40be-b1a7-95859acd96c7)| +|---|---|---| +|$(ID:e06baade-8c7b-488b-9d33-60d0096c55b5)| + +<!-- KC:endInclude --> + +$(ID:697894f9-5274-436f-b6ce-7c09c46e564d) +$(ID:b66523f3-53a5-4c1f-b7b3-8fc7db052b9a) +$(ID:cb6c5c3a-ac8e-4f16-8c03-7dee276b219a) +$(ID:2e639397-72bd-4e62-8905-ed4b444ef7d5) +$(ID:f250c741-c186-49c8-8001-6db15eddc42d) + +## $(ID:bba0bf0f-d1a1-47db-b305-01813537a026) {#ReadingMath} + +$(ID:df45a8d5-e18d-4895-86c5-aaed09ac67b2) +$(ID:dec25dfc-9d4d-41a8-8b50-7a098ec0eb92) +$(ID:a644a18d-429a-4e1b-8269-b8514b1a5d3e) +$(ID:66288934-6650-4c9b-b79e-165e4dc0992e) +$(ID:c41528e2-2b95-4730-ba00-5fbbb0e83327) + +### $(ID:ba5c585b-11ec-46fb-bf6e-c1e178998d33) {#SupportedMathContent} + +$(ID:a164b80f-68be-405b-ac06-61d42e3f4774) + +* $(ID:17ac1ca3-a707-4d2f-bdd8-c88814331933) +* $(ID:740b1de1-a008-40f9-8e47-85b67bae478b) +$(ID:72f8e0ec-c1fe-40b4-8eb0-866249f16fe5) +$(ID:8f1729a1-0171-4451-8548-7b832bcee826) +$(ID:06909833-6f96-441b-952c-9dce48acb76d) +$(ID:b3602e35-e2dc-4aec-98cb-fa89f18643af) +$(ID:887ef7a0-3825-49e7-b815-6d4994dec499) +$(ID:51afb819-3c62-4e25-8de8-7ef9feda2b95) +* $(ID:6428dc77-b527-4198-90e1-524e3f657e53) +$(ID:95feba97-a8a7-416a-9e31-f981c29e4334) +$(ID:482e0d67-748c-4d28-a098-09276c23f933) +$(ID:ee984cd9-1eb7-42e4-a449-3885538280d0) +$(ID:03ec76bd-5222-448c-b302-b97f45bd627f) +* $(ID:bb50ecfd-254e-4b35-b3a2-50c3cdb7dbdd) +$(ID:c1a815eb-7851-439b-8340-0ab85d3e70b3) +* $(ID:f7bb2783-3938-4cce-989a-14c5d6157c01) +$(ID:e91f8274-0ac0-42ad-a7b3-4dea57b73444) + +$(ID:4f01b484-c9e8-4180-a8c3-9f985d5d1a1a) +$(ID:1ad784ef-3196-4e1b-bb68-deed906b362e) + +### $(ID:61731705-5545-4c5b-abed-7196653176b5) {#InteractiveNavigation} + +$(ID:224de81e-fd54-401b-84c0-5d14a703f2df) + +$(ID:27a9b9d2-2a23-47b0-92e7-4d521b8b33bd) + +$(ID:01534204-4ed6-4c20-9223-93463627babd) + +1. $(ID:d4274c50-4e1c-4d4c-acda-e02c410a6bce) +$(ID:01b40f4f-f196-4f4c-b54b-0f5e834cf0e6) +1. $(ID:2227465e-d77d-413a-96ea-733610c468da) + +<!-- KC:beginInclude --> + +|$(ID:8ca4f20f-ce93-4731-a10b-169b76280a0b)| +|---|---|---| +|$(ID:8fc73788-52d7-4af7-8da1-9e297f505088)| + +<!-- KC:endInclude --> + +$(ID:7c856238-869a-46ae-bde0-5cd4bf628d6e) +$(ID:187c8468-29a0-40ae-962b-3e0d436ebcc7) + +$(ID:704098d5-1145-4741-bfa0-0d6755f2905f) + +$(ID:561db529-7514-4b07-849f-4e15b16abd21) + +* $(ID:b52f1470-eda7-4bdb-a927-8b39dcc11b75) +* $(ID:8226fb29-f104-468b-b65b-a6e3843a8914) +* $(ID:09af4a38-ab4b-4406-883b-1d0ffd677bdc) + +$(ID:80f459bb-3a2c-467b-a7ec-936e4736bb7e) +$(ID:7334e6d3-d2e2-47cb-9e8e-0a6593b34b57) + +### $(ID:5612969d-7d74-4693-b802-6bc1aff01d1c) {#InstallingMathPlayer} + +$(ID:0501aec0-7b0b-48aa-8524-1b1143becc4d) +$(ID:297c862b-fad5-4e65-b9c2-aaf38772995e) +$(ID:4e2d86a9-887b-444c-90ca-fea3d8825d4d) +$(ID:f766315f-abe9-4c4d-a519-8be8131af37a) +$(ID:dad73fad-397f-43c5-bf6e-6fefc7091da5) +$(ID:f5f717c0-17f1-4613-b345-be5aa93ba899) +$(ID:7e2aed60-f157-4c30-b21b-8b5cc5a99514) + +## $(ID:8fbc04ab-c5bf-4d7d-a0b8-2b1ab7d15e9b) {#Braille} + +$(ID:dd8000f3-3f55-472c-bcfd-900c7fe1590a) +$(ID:7a48e371-5ea6-4e0c-9cdb-c44cb5102ea7) +$(ID:63279352-8911-4c72-9cda-8a768fa6cc05) + +$(ID:f098f652-2c56-4ff3-ad57-50544396183c) +$(ID:009089bf-9cfe-4cb6-bda6-0c37fab9e315) +$(ID:330bbdbd-43d9-4a6b-abae-8ab9ede17d6d) + +### $(ID:deeb7889-8a35-4ae4-81cf-e50dcd9a0300) {#BrailleAbbreviations} + +$(ID:1f0c9aa5-723d-4acd-adec-c3130d71f19f) + +|$(ID:d14ef782-ddca-42d4-a11b-0b348434e4dd)| +|---|---| +|$(ID:337cb7ca-6ad0-43a3-adb8-9096e27e9764)| +|$(ID:78142bcd-3989-41e9-b486-0cc9324c3ada)| +|$(ID:da2370cf-bfe2-4cfa-84df-9e7ebc988d12)| +|$(ID:a83e5474-1f91-4df3-81cd-5940d676c7da)| +|$(ID:094b2abf-52a4-4982-91e2-fd990220b367)| +|$(ID:8eff1035-b4e0-4bf3-b548-6dfc69fb6721)| +|$(ID:cea58f9a-df56-462e-85b2-e69fbb6322d8)| +|$(ID:0acf72b5-3d5e-45a0-a2cb-e7323e48e5d6)| +|$(ID:db300701-7b78-4f45-beba-d60bef32c077)| +|$(ID:d2516363-3696-4246-8cfc-3ef101c6f43b)| +|$(ID:89e882a5-e5c7-41cb-9de1-d5a4dd4a9ef7)| +|$(ID:6e7dc292-41ad-4ee5-9ec2-296465748615)| +|$(ID:34e0515b-7e5b-4c09-ab5c-eff618eb8192)| +|$(ID:1c9d99b6-ee2e-4e41-9cc4-79babb75ac43)| +|$(ID:6c4dd764-0ef2-46f0-9409-f9560f9c046a)| +|$(ID:5a4c63b6-f590-4fef-a4ff-1f57dac900d7)| +|$(ID:453b8012-50ee-47f0-9881-5e142b4b8cb0)| +|$(ID:be86f21c-f9be-4f4d-955f-caafdf711d13)| +|$(ID:8a861064-eefb-4c63-995a-a16f4eff18c9)| +|$(ID:3c48e74e-7df2-4140-9e70-f553e1fb3381)| +|$(ID:d15dfc6e-9cb7-4533-936d-cbef13643f7d)| +|$(ID:31c8860b-cb95-4bcc-bc49-074ac3b96bc4)| +|$(ID:256836e7-19b9-4840-9977-bead3b160021)| +|$(ID:e3583590-5cb7-49eb-9afd-16bd7f157564)| +|$(ID:d4204a42-0102-491e-805f-3acfbf6e6e3a)| +|$(ID:9842069c-6f52-423a-9e2b-6291338e5b19)| +|$(ID:fe2e49c4-e80f-4ecb-b50b-96971ba0a5c5)| +|$(ID:0d3d2461-ce9b-43ec-bb01-7aee7eed5da4)| +|$(ID:90ced55d-07a5-41f4-92d5-529f43087276)| +|$(ID:ea3fe386-4562-4be7-be7b-9659fc5d3f78)| +|$(ID:3a7817b1-cbf1-4a82-bd7c-0ee437da8cc1)| +|$(ID:3842eb90-ad47-47c1-8823-133810d9d54c)| +|$(ID:fe5e7ef5-4734-4fcc-8b01-869c0fa899fe)| +|$(ID:37f37f4c-d5d7-40d9-a8df-dc9b23823e98)| +|$(ID:6782355c-0176-43fe-9243-af47ce0ded3a)| +|$(ID:42f601fb-9ca6-491e-bf43-5dbf002bee5a)| +|$(ID:4136f887-ce16-4e2b-a596-ee0a14c9e167)| +|$(ID:00c06ee0-bf13-44fc-a526-cb841ed8f0cf)| +|$(ID:f3571541-9014-4308-aa31-6336847916e1)| +|$(ID:c29ef98a-10ef-43a5-a8e9-77f06fc7f9ee)| +|$(ID:58ca7d59-f858-4e40-8851-f5d849175f5d)| +|$(ID:b7b45f3a-c0c6-4537-ab51-6bb34763b303)| +|$(ID:1bca3ef8-e0fa-490d-8fa9-1d12e15cfe07)| +|$(ID:afda8e1c-4b9d-4523-81a2-1ee94262ecbc)| +|$(ID:9603d272-03d2-485b-bc9b-7faf5d018120)| +|$(ID:aa1a9c10-79f9-41d5-beee-2963110341ca)| +|$(ID:7aded34b-6c24-44b1-9bf3-62d3630921ce)| +|$(ID:bc0ca7e2-deeb-472d-878c-8fd98803491b)| +|$(ID:e88b16d4-0e96-4f76-82f5-7f9cb2a5cd33)| +|$(ID:a4697f97-21a1-451f-acf6-690444c87a62)| +|$(ID:12ce97e9-d62e-47a6-ae83-85d091467a99)| +|$(ID:545167c7-90ac-4a2e-a592-3388ada0d756)| + +$(ID:17bce600-354e-4bce-be92-72f76a37422e) + +|$(ID:84e23569-1046-4a71-a12e-9b43cc11460e)| +|---|---| +|$(ID:faa4b45f-e5aa-4972-92f6-79cc7c1a8cd5)| +|$(ID:c19017aa-c808-4280-8787-ad870b1e3e9f)| +|$(ID:9214243d-50cf-4f41-b96f-4fe5e47b43b3)| +|$(ID:f4bef6c2-9441-4cd9-a21e-b813598f971e)| +|$(ID:0e962cd7-6a93-40e6-affd-6f53add7d56b)| +|$(ID:25790509-e60a-476b-af2f-3a2a6094fd4b)| +|$(ID:233ae5b5-0153-4d1f-8066-649a150e6ba8)| +|$(ID:8d7b8f5f-7bcb-4827-99f0-553f1af10682)| +|$(ID:9e1cf434-669b-4966-b7e5-3154d5ea65ba)| +|$(ID:ea8c2351-35c4-45be-ba1f-35a35b55133e)| +|$(ID:7d057df4-87a2-4f8a-8495-de70bad91967)| +|$(ID:09cc4c15-d8f2-4425-b996-b924a7876a4a)| +|$(ID:f176fcb4-5151-4fb5-bbc7-b266a87c79af)| +|$(ID:1c36eb04-59ad-4bcc-9455-f970f8dfd7f9)| +|$(ID:d8d8b8f0-a455-48d6-ab4c-3577ea2b2c3b)| +|$(ID:c14870bf-6f04-44b2-b699-0a7b21454719)| +|$(ID:d7d6ec84-db5d-4490-9081-45ec4b495307)| +|$(ID:887f3edf-5774-462a-b614-011772573b33)| +|$(ID:21f345f4-f7e6-415d-9520-60c5099ce910)| +|$(ID:1a25666e-fd5a-45b0-9b82-f73a84791954)| +|$(ID:bd61f326-6940-47a9-84b7-7cf4ee100d96)| +|$(ID:43f004d9-6d49-472d-8861-0e6df3164239)| + +$(ID:ed722851-82ab-467a-b25f-515d3eda5aaa) + +|$(ID:7666b42c-51ba-451b-94f8-f32ab3742156)| +|---|---| +|$(ID:0f135398-5b30-443b-a3d0-8f0684e7428d)| +|$(ID:89b2518b-0d93-4386-ba0d-6133c28bdddf)| +|$(ID:29d7bfcc-ac7b-45b5-a3b2-65d55174851e)| +|$(ID:aa41c7f8-0718-4446-ad2a-fb2ec5405631)| +|$(ID:37bcb152-460f-4699-a4d3-ac86f7a9a98b)| +|$(ID:015f9e87-834f-43d2-a188-d9f01bc23751)| +|$(ID:85803f72-63b2-4d54-9b2a-40b5ac8bc7ea)| +|$(ID:112aa266-4bb6-4537-af55-1f25a8c5ba40)| + +### $(ID:3faaa553-8795-43fb-ace6-6297bc426a7f) {#BrailleInput} + +$(ID:fbbdc55c-8b40-4f02-8078-3be887d381f9) +$(ID:58e483ef-0fa3-46f3-88a7-209f55c15344) + +$(ID:59b1bc75-ba16-41ee-9756-815fc4c03327) +$(ID:b3ed7cfd-7eb4-4e32-a81d-d454665a0481) +$(ID:cf3afa2f-e4c4-4b21-bd26-bfb7877caac9) +$(ID:33566542-af77-42d7-8541-71a0d19ad3f1) + +<!-- KC:beginInclude --> +$(ID:ecebc8d4-a662-4ec7-8b5e-7e9f0a18b24f) +$(ID:6d7208cd-542f-488c-b4e5-f0f0ea3c85c5) +$(ID:62812251-06f4-4b3a-a04d-fece961348d1) +<!-- KC:endInclude --> + +#### $(ID:b92e99ec-0095-43e5-a753-ec25069f0d9f) {#BrailleKeyboardShortcuts} + +$(ID:f14bf2b3-6572-4c02-bb2a-c9aedec450c4) +$(ID:1963285b-f0e3-437d-aa2c-19b75610a2a5) + +$(ID:3d631542-20ac-4a91-acef-c776e4c375e0) +$(ID:16a600a7-5680-4933-a07e-0da06c03e402) +$(ID:cbf69b5d-9348-4c3a-9d06-4c057e6039b1) + +$(ID:8f4363de-b19a-4b91-811d-4491f8012f1b) +$(ID:0523a6a0-acf3-4447-a95e-00897c751d35) +$(ID:c1fb7d09-16ae-4431-bf00-936f49781bf3) +$(ID:4361d772-44c4-49ee-b06c-c6b2f46d968c) +$(ID:0fe7d10a-2b91-4a78-9474-85700c51a921) +$(ID:2fe5b5c9-723c-4756-ab44-207ef3e7fc51) + +$(ID:66ce438d-72f5-41b7-9499-dcbc4231540f) + +$(ID:caebc54e-1655-4bab-ad8b-88ffcaa2f9f0) +$(ID:1e08127f-b703-4c72-a94c-d6ea94fdaa76) +$(ID:287e161d-8d3a-4810-8556-905e2608b821) + +## $(ID:cc490d20-d042-49ee-a1f4-35c35f4c0045) {#Vision} + +$(ID:55473cba-e46d-479f-97e5-63df2604a863) +$(ID:04c58d6a-9969-4c59-9122-608c25c6285e) + +$(ID:c74efd0c-ee27-4ede-b217-51a22c2e09ae) +$(ID:8feda3bd-05d2-4877-8a5f-224f79b6d3e5) + +$(ID:5761aa6f-aee2-42bc-93cb-f8f335717dd9) + +### $(ID:11fb8b6f-9062-4ace-82bc-5a98bb991100) {#VisionFocusHighlight} + +$(ID:7dc9336f-78cb-414c-95ea-d8740a4e7a05) +$(ID:6a023754-fc8c-4a8c-af24-3e600bfc9beb) + +* $(ID:e9919a4e-ff8d-46e9-8851-fbd57aa691a8) +* $(ID:71fd7fa4-6052-465e-a20b-787fd3da5391) +* $(ID:d390d099-6241-4a23-a881-8918ab043f09) +* $(ID:e2141e2d-7b59-463e-82f8-c328e69c8d9b) + +$(ID:88d4faf1-1fcf-41f2-929d-888fc923bb74) + +### $(ID:8218e0df-e9c8-4569-babe-62431a314153) {#VisionScreenCurtain} + +$(ID:a2670707-b24a-42d7-88f1-7e55535ae4d4) +$(ID:808c35be-7f1a-44a8-ba45-0fe54fc835ab) +$(ID:a2fce065-1fc3-4fce-aa91-81d0bd467a86) + +$(ID:f03f927d-f213-4697-bafd-918e35327f92) + +<!-- KC:beginInclude --> + +|$(ID:509daff7-ab17-402a-925b-6110a9cb8e0d)| +|---|---|---| +|$(ID:93421e78-55e3-4668-b636-6a33a0cd91d9)| + +<!-- KC:endInclude --> + +$(ID:33a3efe4-1d04-41be-aeed-62bb643f125e) + +$(ID:8ae1debf-8f23-4675-864a-38d67f09e172) +$(ID:f86c6959-6cbf-4dee-a61d-778fd193abe1) +$(ID:f11d3c59-5f08-48e8-b665-558ae04ae3b7) + +$(ID:8b585b33-eea5-49b3-a59f-70a1ff635373) + +## $(ID:db268119-b152-4431-bbe7-44da8add31e6) {#ContentRecognition} + +$(ID:54514250-58e5-4f2e-8e55-e7ddb8833093) +$(ID:1019d4e1-7ec1-4cf4-bbed-48bea1720036) +$(ID:b75b84fc-10ff-46ad-a261-67700b02a859) + +$(ID:5e4d025a-958e-4a52-b72b-ac91e6c63e73) +$(ID:e169b01b-1fc0-46ec-aae9-fc05c5d57038) +$(ID:0ad964f5-007a-4e33-a7d1-c77b48457727) +$(ID:0c9af0c8-8d9d-4567-a1eb-c4a80d0904e4) + +$(ID:a6330061-7d18-4736-b94a-55a5fe60d915) +$(ID:c13daf5f-1922-46e3-9a49-7b2aab64da09) +$(ID:c3034842-d429-40e8-8dfc-16493b21b530) + +### $(ID:c88b0a53-dfd1-4ac2-ba45-0ff711243952) {#Win10Ocr} + +$(ID:9c2a46d9-1d2e-4d3b-80c1-74cce79339c4) +$(ID:91e22169-3c58-4059-af47-acb40ef3abae) + +$(ID:def849b1-f8d5-4740-b51b-0eecda8fff13) +$(ID:abeeabd0-92d6-49fe-90a2-f86d595bf3b3) + +$(ID:6066c000-aea0-404a-9db6-ed85c380f2ac) +$(ID:98f55a8c-ae5a-4ec3-9cdc-72640f94b6ba) + +$(ID:74f529c9-35ab-4532-8b88-d8f8212d072b) + +<!-- KC:beginInclude --> +$(ID:0ac3a78f-d6c6-41b2-84fd-4c464189cf76) +<!-- KC:endInclude --> + +## $(ID:2b1a4fef-d044-4d09-92a0-7a471f41fbf0) {#ApplicationSpecificFeatures} + +$(ID:2ed9098d-4494-43bd-b5d5-d2deecb6ee50) + +### $(ID:2c227b4d-cc6c-4895-bb8d-1790e6f70e37) {#MicrosoftWord} +#### $(ID:ca0bebd4-fc97-4f5b-b303-b7df79e62ac2) {#WordAutomaticColumnAndRowHeaderReading} + +$(ID:387c0105-ef72-4949-9f72-649e091b0fac) +$(ID:29dcc1ea-88d4-4ba7-8c97-464fc5e8165b) + +$(ID:6379e6db-7dc8-4239-8540-bafa2755bb8a) + +$(ID:12cdeee7-302a-49c7-a8b0-ed4f77fd30a2) +$(ID:337fe599-eebe-477b-abf7-6e157e4cbb05) +<!-- KC:beginInclude --> + +|$(ID:2846516a-9712-47d8-994f-4a5c3aa1356c)| +|---|---|---| +|$(ID:57e69732-3894-4122-9496-d045da17979c)| +|$(ID:d3a1a012-cc0d-4d6c-b1c5-d02300adcf8a)| + +<!-- KC:endInclude --> +$(ID:10bbd711-e1a1-40b6-b0e3-9688c6f402dc) +$(ID:f2edf7ae-3caa-4ba0-8b94-018509c6a3ee) + +#### $(ID:d06b4120-ae35-4acf-80d0-7be851a30919) {#BrowseModeInMicrosoftWord} + +$(ID:76760fa2-80a3-40be-b528-3afe5f3cc5c4) +<!-- KC:beginInclude --> +$(ID:c7dcb282-76c4-4d30-af4c-ba9d26ac5a03) +<!-- KC:endInclude --> +$(ID:0fa4a535-73d4-4e1f-b24c-4f9b2b38883a) + +##### $(ID:b4b34612-9713-4b6e-b163-eeb0b07630be) {#WordElementsList} + +<!-- KC:beginInclude --> +$(ID:2010f90f-53b3-41cc-8be5-c2bfe28f4ec5) +<!-- KC:endInclude --> +$(ID:45ef1647-1603-4cde-89d4-ce4bd6894301) + +#### $(ID:3a466a22-e5a2-4051-af75-08aeb4d299c0) {#WordReportingComments} + +<!-- KC:beginInclude --> +$(ID:3c823bdc-5fb5-4735-8a55-b1897cb40143) +$(ID:846cb9bb-a1ca-46be-b615-34fbf38ec7a4) +<!-- KC:endInclude --> +$(ID:52536da5-dda3-4816-bfc0-4512ebfec6b3) + +### $(ID:f4e6005a-baa3-4526-8cd1-f7aa0211772e) {#MicrosoftExcel} +#### $(ID:68dac138-2790-466b-940b-9682903dbb5e) {#ExcelAutomaticColumnAndRowHeaderReading} + +$(ID:0d1e8e13-caa2-4b78-9810-6f5ecc7feb34) +$(ID:83152281-39d6-4e53-aa0a-b12de855a9f1) +$(ID:f273f0da-e4db-49f6-ba96-8a825f0dba7a) +$(ID:80b2de28-42a1-49eb-83f2-ac97e05cff0e) +<!-- KC:beginInclude --> + +|$(ID:36d6fecf-af09-447b-b5af-17cf27588a4a)| +|---|---|---| +|$(ID:ff3c1e02-c15a-4505-8396-301d497760ee)| +|$(ID:3facb821-aff6-4498-b9ec-85dec89ae282)| + +<!-- KC:endInclude --> +$(ID:9bc41658-168a-4b6c-8cb3-31e69e010c73) +$(ID:97df5793-0941-494c-9790-83f48115ab0e) + +#### $(ID:f9cd227a-e1f2-4109-b921-065a7f1d7c76) {#ExcelElementsList} + +$(ID:dc21f291-4973-4e69-8f0b-816e86436be5) +<!-- KC:beginInclude --> +$(ID:5ba61075-68ad-4535-ba33-5f8e28e0eded) +<!-- KC:endInclude --> +$(ID:740d2939-51f8-4182-abd7-d72c0cd16416) + +* $(ID:2e5b0527-ee84-4238-9fa1-7d6ebef70faf) +$(ID:f3fe0fa2-3fbc-4f1b-b510-635e44488f4d) +* $(ID:ea70be98-7025-4057-adf8-b0eaf0784e03) +$(ID:12e6ddb6-c13d-41a7-a0b1-24d1f50c4939) +$(ID:2f361cc3-6311-4950-a336-cfa3401e8aec) +* $(ID:513f368c-edad-4ff7-bccc-00b241290946) +$(ID:74a6c8fe-8165-401d-980e-cd9ff2d77ae4) +$(ID:ee6efb6b-7fde-4652-b769-a11b335c8b67) +* $(ID:1354e486-8f90-430a-a581-d5511b239fb7) +$(ID:ff1a9cbd-1def-4d56-bbea-9b9c37c56797) +$(ID:555bbf31-9b1a-45c5-b07c-79959f4df9f8) +* $(ID:4a7b46fe-aa70-4729-83f2-7f30d239a7d6) +$(ID:879701ba-7a9c-4167-ba38-c7c15cf1c16e) +$(ID:d5e11ef5-a2a5-428b-9faa-1b8260aa9c04) + +#### $(ID:77050acd-2f01-4198-96ca-ad5ccff49ff8) {#ExcelReportingComments} + +<!-- KC:beginInclude --> +$(ID:99a7f7a6-7d86-44a7-832d-6aaa6e6b1bda) +$(ID:10cc467c-5c4c-47e9-a08a-7a4a6ac9e70f) +$(ID:480be01d-d0bd-4e1d-804c-b24f7027ba32) +<!-- KC:endInclude --> +$(ID:3e3cd3a1-acb7-443b-aa2f-bf6c88467ff1) + +$(ID:a1fc2765-622f-476c-9db1-a1ff3297219a) +$(ID:ede78256-290e-4066-9ac9-151304ac266a) +<!-- KC:beginInclude --> +$(ID:714eea57-8091-41b1-8514-ad6257f70a6a) +<!-- KC:endInclude --> + +$(ID:64f34509-e7c7-4b82-8f68-0a881e1fcf7b) + +$(ID:4dbafedc-e14f-46dc-92c1-50cfabbf9609) +$(ID:6b48bd02-6ce5-4c8e-a20c-328e45ad3d0a) + +$(ID:8236d3d8-9882-4050-b03d-b3f1b7823b4d) +$(ID:f3816def-6ce2-445a-82d2-ed95108e9ce1) +$(ID:a0b2547c-699d-4656-b6dd-d652b66166b0) +$(ID:5db7ea0c-0e6c-4dac-be25-df6a3b2deb39) + +#### $(ID:64f3d645-ef46-42ab-b3af-ed0f31dbed5f) {#ExcelReadingProtectedCells} + +$(ID:91710530-cf79-46de-aeb0-6c1244d34848) +<!-- KC:beginInclude --> +$(ID:1b1d74f4-eb2f-49ac-94a7-413690ea00f9) +<!-- KC:endInclude --> + +#### $(ID:f80927bd-9222-4c20-991b-634876a79272) {#ExcelFormFields} + +$(ID:864e11e0-9cff-437d-9177-82aebdc01abc) +$(ID:5ea54c07-3747-4224-bd60-f9d92c52471d) +$(ID:cd00ae64-a00b-4402-afb9-95122e014dcf) +$(ID:5d085420-516e-47af-8963-de64c1b4511e) + +### $(ID:9e9202e1-fa19-4857-9b48-eb20975364c1) {#MicrosoftPowerPoint} + +<!-- KC:beginInclude --> + +|$(ID:ac297328-aca2-49e7-9b15-782f23b7b7f8)| +|---|---|---| +|$(ID:2849edf8-af18-4060-8ce5-93a7ea190491)| + +<!-- KC:endInclude --> + +### $(ID:ad5ff8ce-486a-49ed-82c1-3170ce64a869) {#Foobar2000} + +<!-- KC:beginInclude --> + +|$(ID:27795904-044b-4ddb-8378-ea7ec26647a9)| +|---|---|---| +|$(ID:db61d442-db8f-4905-80b1-6286a7dde3e5)| +|$(ID:90376463-2ed4-4c74-b64d-8d028f69c8f0)| +|$(ID:0cfe6ba4-89fe-4301-949e-21804608a233)| + +<!-- KC:endInclude --> + +$(ID:c97c5a26-25db-45be-8b8c-6bcc187398ff) + +### $(ID:b740adea-36d2-429b-a73b-c20601cf41bc) {#MirandaIM} + +<!-- KC:beginInclude --> + +|$(ID:b87cb773-07ac-41d6-b1e9-1ce7823c93be)| +|---|---|---| +|$(ID:cee16eea-1009-4eef-b4f5-62421a471cd8)| + +<!-- KC:endInclude --> + +### $(ID:713aa2a8-003d-48aa-b949-89246ba1c11d) {#Poedit} + +$(ID:cf90762c-fa0e-4bae-87e4-12a067a4102f) + +<!-- KC:beginInclude --> + +|$(ID:58491c19-62d7-4b65-82ae-9e33d0d4eeff)| +|---|---|---| +|$(ID:1f7f1cb2-f5b6-45e4-b5b1-0959ab0574d7)| +|$(ID:5677bc10-0777-4059-9b44-51bc2ecab1c9)| +|$(ID:9cdc4126-bc0e-42c3-9919-ccf201b566cc)| +|$(ID:efc71aaf-e7fa-4d4e-b40d-bb8cccd0f369)| + +<!-- KC:endInclude --> + +### $(ID:f109d29a-21dc-4b5b-85ad-f92d7b959cfa) {#Kindle} + +$(ID:3e811ce6-a191-443b-bce9-67d758184e2a) +$(ID:b67ab983-cd10-4e36-95d0-41e21817e676) + +$(ID:d78bb76c-62a6-4cd8-826e-b432d90d5b0c) +$(ID:38b12b4d-eae9-4695-8694-b6e8ede6eda1) +$(ID:b5fc8eb6-4cd9-4113-ae2d-baee8c14c739) +<!-- KC:beginInclude --> +$(ID:b7bc8709-2cbc-4261-ad67-c43417ac0b9d) +<!-- KC:endInclude --> + +$(ID:fe81d85f-d593-4d1e-923c-9e126412fce5) +$(ID:6e2b27c6-d672-4dcb-86c4-bed0239b8fd9) + +$(ID:779d4805-2e71-422b-9419-896099f4d815) +$(ID:a1c38484-7339-4a6c-990e-bcb6fccbd8f9) + +#### $(ID:f637acde-11e9-4b77-8393-e6a503db1b4d) {#KindleTextSelection} + +$(ID:4aafc725-29b8-47c9-9e36-9653b145440c) +$(ID:0c1ab5fd-18a5-4762-b127-45f38d38aa95) +<!-- KC:beginInclude --> +$(ID:f4f0efe9-2bb3-4299-ba1b-33d3dcce76cc) +<!-- KC:endInclude --> +$(ID:0900a3f6-fc98-4129-804b-f9192b73d4f0) + +#### $(ID:cf647783-a7ff-4f86-be7a-0059c606cf2d) {#KindleUserNotes} + +$(ID:9801aa4b-ad11-44da-a610-f6d766d6a5de) +$(ID:99f1217e-11c4-44e2-aaa1-9571bcd386ae) +$(ID:7b3c48a0-9361-493e-8e58-989bae8b95ff) + +$(ID:79494a56-a5e5-4b6d-9caf-611f602b9b63) + +$(ID:352cfd7a-d294-4774-9152-7a691b3e4589) + +1. $(ID:56b7b11c-e846-41fa-84c3-50841be59c8b) +1. $(ID:85d96c4b-d4c5-47e5-ad63-b34630446c35) +1. $(ID:ba191d81-888a-4070-ac8b-b755da8df683) + +### $(ID:17d6d640-b2d6-43d2-aea6-ca2489115377) {#Azardi} + +<!-- KC:beginInclude --> +$(ID:e37b4d13-522a-4b49-bf87-a69c94144972) + +|$(ID:b30cca4b-817f-4672-b187-7a57227cfd41)| +|---|---|---| +|$(ID:e718544d-5bfd-4a56-b64e-619f4845371d)| +|$(ID:6a42032b-4027-4d59-ad56-77be31aa8a17)| + +<!-- KC:endInclude --> + +### $(ID:48639fe5-1a4b-4f5c-9ffc-5a9f8a9d3568) {#WinConsole} + +$(ID:be1a764d-6786-4387-ae9b-50040a5f6072) +$(ID:ead2f996-4a58-471e-9ac9-f9eafc9caeb3) +$(ID:11cd9ae2-e60e-4f78-8936-48523742032b) +$(ID:2dd8b5ae-a11f-439e-a919-58048d8a2981) +$(ID:f8ea4844-fa77-46e8-a213-46f337f783d3) +$(ID:2db82dc4-2b47-4a66-879a-813d45184fa8) +<!-- KC:beginInclude --> +$(ID:8dd52f52-6113-4aed-b410-32e528650d79) + +|$(ID:61da3b86-8af6-4bd5-b4ca-b5e864aa4577)| +|---|---|---| +|$(ID:59965f5b-e71b-40d2-8366-d830449cd11c)| +|$(ID:a6b7187e-d9f5-4cbe-b3aa-f50fcac0fcda)| +|$(ID:4e74f32c-4eda-4eb3-baba-f2461cb511f7)| +|$(ID:eb0a54b8-1297-46fa-9e25-a33ac11aaeda)| + +<!-- KC:endInclude --> + +## $(ID:e6b6d600-294a-41fa-9945-7f4b67c8835a) {#ConfiguringNVDA} + +$(ID:4997a6f2-aca4-4809-874c-3c37eb480abf) +$(ID:64c84546-696c-4e4f-98c2-3313e2ca29b3) +$(ID:775eafaf-afa4-4485-9c1a-cead0b63b66b) +$(ID:6623eb91-94e4-4f08-911b-50d46ae9cfc1) +$(ID:18080303-6c48-4908-915a-7ccfeed4dddc) +$(ID:b0fdc17b-51ca-4e8f-97ff-2966f65ed295) +<!-- KC:beginInclude --> +$(ID:27784732-ee7f-4487-9591-00efd4aff346) +<!-- KC:endInclude --> +$(ID:bec7fdec-ed24-4952-a265-b9a6d981f600) + +### $(ID:659e0420-eecc-484a-b992-627ab2449505) {#NVDASettings} + +<!-- KC:settingsSection: $(ID:7c286be5-71a9-485b-aad8-3f406671e283) --> +$(ID:a611937e-b567-4b5f-b7da-27d12a86b454) +$(ID:73097e35-0ae2-4719-83a7-f28f356c5257) +$(ID:096573f6-79ff-45b3-93f0-b50004bd5fd6) +$(ID:259ffc4f-b820-4683-a677-21f694256a1e) +$(ID:e3e11fd5-ba83-489a-93c1-e9fc547ca4d4) + +$(ID:6d868ec7-38dc-46e8-ab9d-858f39e1507d) +$(ID:ad2bea8d-09e0-4811-bafe-83022df803dc) + +$(ID:4bb5e5ad-118c-411c-b208-edb61b7388a2) +$(ID:cb399963-ef05-4a22-8efd-ca43e5f544e0) +$(ID:d6cb9ace-5b70-47ec-9fa0-7d702d4fad93) +$(ID:e916b665-91dc-47a9-ae3a-5a8858d3373f) + +$(ID:15773840-160a-4cfc-ad6c-ae93b2c867a9) + +#### $(ID:81459c31-610e-4908-bed6-22c95ff057f2) {#GeneralSettings} + +<!-- KC:setting --> + +##### $(ID:00b4769b-5974-4110-8827-4d83408eaa3e) {#OpenGeneralSettings} + +$(ID:be654b38-2b9d-4773-9150-87b2c626d924) + +$(ID:ec9e0201-fe06-4fff-bf04-9d1264943f03) +$(ID:7ac42a4e-5740-4089-8810-01da2e659f7c) + +##### $(ID:c89722d2-0f55-4039-970b-a94e7d20b402) {#GeneralSettingsLanguage} + +$(ID:7401caff-f858-4fd3-9e80-a4b0b599d672) +$(ID:5583404e-2f50-4f0b-9c49-6238c05fa16d) +$(ID:63656376-78e0-4a45-9408-5f002297a34a) + +$(ID:dec12c77-6ecb-404b-9a2d-30a10de05465) +$(ID:aeca88a4-37db-4547-a7ee-cdddec38d847) + +##### $(ID:b1782921-9b3f-4f20-a643-b7386e3c1701) {#GeneralSettingsSaveConfig} + +$(ID:a867192c-356c-44c3-aa75-f2f8612a6dfb) + +##### $(ID:15a53a42-d24d-4b47-bea5-a5caabbacf13) {#GeneralSettingsShowExitOptions} + +$(ID:843932f8-f5db-4d19-9698-0bc34c2ec60f) +$(ID:1c8f88ba-ce58-4f2e-a37f-861ac52ae532) +$(ID:0e05fa1e-6bdb-4785-8c29-90924736ee6b) + +##### $(ID:8fa980b9-61ab-4059-8a0e-157e6ad148a1) {#GeneralSettingsPlaySounds} + +$(ID:44264f54-fbc3-4ab5-95c5-d71cd443df4d) + +##### $(ID:7ca4d16c-5aec-488f-ac5d-af2bdfddbdd5) {#GeneralSettingsLogLevel} + +$(ID:812102df-ef14-4260-9a9a-efd4b43b018f) +$(ID:827eec9e-439a-4289-ba33-3aee5251404f) +$(ID:6d2d1a76-540d-4dae-b61d-ba47ae89a04d) + +$(ID:2156b035-fa9b-491d-bd16-5bca66dff14e) + +* $(ID:160fec9b-bc90-4221-89fb-79e6075078aa) +* $(ID:133edd7b-76d0-46a6-9896-8e543269a30f) +* $(ID:24a1e29b-7d17-4e25-8786-fd5255611599) +* $(ID:dc288d98-fc90-4398-b41f-e37c5057ab32) +$(ID:3fe629b4-76b2-4fb6-9901-e0c6595f6f19) +* $(ID:3eadd69e-e3ee-4279-b48c-f566d22b3670) +$(ID:7ef99d21-10e7-42c9-ac71-cc184c52f6a8) + +##### $(ID:515238a5-61dd-4ca4-a0ec-2ab939cc3f8a) {#GeneralSettingsStartAfterLogOn} + +$(ID:662b4b93-3a3b-4bcc-bc11-3deff26fa851) +$(ID:365bd3e3-db1d-41a8-abf7-0e830c556ff5) + +##### $(ID:0b4656a4-6c47-495b-a365-7e038c53aa05) {#GeneralSettingsStartOnLogOnScreen} + +$(ID:2c923062-1f84-4ae0-9c8b-078d09087d21) +$(ID:96d2bc9f-697a-47dd-adc9-ab7efd140c9d) + +##### $(ID:f855351c-b6d0-40c8-8920-5858b3e1fa04) {#GeneralSettingsCopySettings} + +$(ID:f9e69ee0-9c5b-4d78-8ea4-0334565a4b3d) +$(ID:cc0924aa-2032-47ba-bd74-8ff1630014f3) +$(ID:cb2a9ad9-d7a0-4422-8691-87cde40704ec) + +##### $(ID:873ebe7c-2be2-4694-b019-839127b19b3b) {#GeneralSettingsCheckForUpdates} + +$(ID:9e6b3b84-7b25-4123-82a6-d1adfb9a40ac) +$(ID:8abe98cb-d744-409c-affe-39a43f2771cf) +$(ID:2fff41a0-0f73-4534-8b69-a79dcc22f234) +$(ID:19fb9ea9-0005-444f-80fb-0c7ac550cf21) + +* $(ID:5abebfe9-3031-4d38-a266-4f9dda7aa712) +* $(ID:ac146b3a-47fc-406d-b944-fbc3a6b17b3f) +* $(ID:73608a23-da64-4f45-a3ed-a2a3427797f1) + +##### $(ID:f7b9c226-eb04-4210-b8a2-a1170781f24e) {#GeneralSettingsGatherUsageStats} + +$(ID:7c6eaefc-196c-411c-81eb-143c1788ac90) +$(ID:369cc06e-3011-48ee-9df6-36263aade320) +$(ID:1438775c-076e-48be-9626-a81fb25d5068) + +* $(ID:f083f1ab-5ad8-4249-aef5-eb27f27378e4) +* $(ID:59a111c8-32d3-441d-9ce7-600c006357d4) +* $(ID:8ac67b1c-58a3-46d8-981a-8679adceac20) +* $(ID:326f3a2f-9343-4590-85ed-0c4f2fef8140) +* $(ID:c1aa8400-0e62-4575-9638-cdc5132966ad) +* $(ID:f2209c50-cb9c-4ccf-bfb3-62a4c2e4ddd1) + +$(ID:2040c217-9114-44d2-be78-c32cdaf74837) + +##### $(ID:db00c65c-0296-4504-8865-fc3ecf8a5d27) {#GeneralSettingsNotifyPendingUpdates} + +$(ID:e7cab999-87e3-402a-9497-b03e89e1abb6) +$(ID:91cca2e2-6474-4f24-b4ff-9279226f9f1f) + +#### $(ID:b37d4d24-25d9-4ed9-8544-aee0219cfce2) {#SpeechSettings} + +<!-- KC:setting --> + +##### $(ID:eaee68a2-affc-4ba1-b3c3-9bc690646292) {#OpenSpeechSettings} + +$(ID:cbd31746-1a29-41e5-9722-28e10e2e351c) + +$(ID:e88ecb11-692a-48b1-ab77-8ca5d7420b7e) +$(ID:a3bce64e-8364-4f6b-ba5b-46e2da10bb19) + +$(ID:d7d99b83-f532-4170-8b8b-2a3b32de1c45) + +##### $(ID:befe1061-31be-4fc5-a3b4-30b8d2893711) {#SpeechSettingsChange} + +$(ID:4dd4850b-b9dc-4b07-8692-8b7edfe6d642) +$(ID:2dede44c-2edf-4f2c-a6d1-861f5c791cfc) +$(ID:5dd3e694-f979-4e68-976e-ccdaf523780e) + +##### $(ID:750b6a44-1fbb-46a4-82d8-d874503eed8d) {#SpeechSettingsVoice} + +$(ID:84b73f92-5ede-4238-972e-6f503ff49f8e) +$(ID:27f479dd-62b2-4f43-a96b-7504090f0c90) +$(ID:7d14b648-6109-4add-ba3f-8179495c8682) + +##### $(ID:003a5d32-a214-4153-a31b-df63e2b2670d) {#SpeechSettingsVariant} + +$(ID:9782b42b-8b74-4edc-b116-c30040e3c430) +$(ID:3fc9f80d-d149-4e21-a497-0b1ff2fe9de3) +$(ID:132e2520-0b06-4685-b4a9-49c4da804dbb) +$(ID:e0bfbd19-1d4a-4087-9532-2c9270522a01) + +##### $(ID:90e0595b-141d-4a65-b58d-d5f50a2a6a5f) {#SpeechSettingsRate} + +$(ID:b6f16123-2b79-4c9d-a4f7-96f691a869a7) +$(ID:34cbe390-23cb-4798-88e4-837ab7391219) + +##### $(ID:111fde71-f9a1-4dca-a91c-95673e43cd77) {#SpeechSettingsRateBoost} + +$(ID:d4345468-4156-49cf-8fcc-9f1cb7c298d1) + +##### $(ID:5d9c0c5e-ae41-41b0-ae9c-403f7bd54f69) {#SpeechSettingsPitch} + +$(ID:c9a3906b-0a51-46c7-a782-48c2e55985b1) +$(ID:720311d4-9f65-4e71-a458-496195b689dc) + +##### $(ID:d3cd6ae2-2d6c-4ad6-b431-4fd9ee85e455) {#SpeechSettingsVolume} + +$(ID:b530aaf9-0307-4bc2-b857-416e894f172d) + +##### $(ID:c0bf8a3e-5712-4bfb-93e5-5df2bc0914e8) {#SpeechSettingsInflection} + +$(ID:3acdb542-b74f-44d7-b53e-a396901c7d51) + +##### $(ID:aefb6bcc-25d5-4cba-bc91-f2f8c73e756a) {#SpeechSettingsLanguageSwitching} + +$(ID:855f54c7-3d5f-433f-8e43-5e9bd47040e4) +$(ID:d12a2511-9274-453e-a33b-5553d5a1a0b7) + +##### $(ID:5e6383f7-94a5-41d1-a7b9-96d443442f75) {#SpeechSettingsDialectSwitching} + +$(ID:3e76b5ec-6ec3-4e86-a2c9-c50fe5feee5b) +$(ID:d628b3e4-e181-4d8b-ac05-382be5f76f9b) +$(ID:4b0e1070-81d0-46cc-982e-0fb4e012ddd6) + +<!-- KC:setting --> + +##### $(ID:d6539579-9a7c-4b8c-9a74-93f60ea36d03) {#SpeechSettingsSymbolLevel} + +$(ID:ab6d5119-2cd5-4ccf-8f04-dca2ee0cb02a) + +$(ID:9faef57a-b0b0-480e-84fa-f37ad95324e2) +$(ID:3a3e779c-9da6-4f48-9272-7dbd16b398a7) +$(ID:f21bccc8-b348-4167-9ca1-723c69b01674) + +##### $(ID:e2b03a49-1dea-4178-bdbe-b6bc91d8f7a4) {#SpeechSettingsTrust} + +$(ID:7006e05e-0c0f-4e3f-9a94-546dafefebf2) +$(ID:7c3095b0-da23-46e4-9168-bab4a30aad27) + +##### $(ID:b32b47e9-75ae-464e-a49c-6c304dad609a) {#SpeechUnicodeNormalization} +| . {.hideHeaderRow} |.| +|---|---| +|$(ID:a1575c10-0619-421d-a071-b6a5aadcaef6)| +|$(ID:c9df5e22-c922-4432-9041-37d68ffb64ef)| + +$(ID:dc243083-25bd-4f89-b008-5615664dfaac) +$(ID:2962bd52-74fb-48ea-8fa8-5d8a7defe531) +$(ID:cad92748-9690-4a66-a64f-179f4fce4825) + +1. $(ID:cb3003b2-cf3c-4c09-8af5-05e900607464) +$(ID:7127d824-e3cc-412b-8383-2aaa780b6bf0) +$(ID:95809e9d-dba1-46cf-ab64-5f16b2499444) + +1. $(ID:8296db94-a1a6-44d0-8cde-5db5cfdd7533) +$(ID:3962334c-5c49-4aab-b3d7-52e81c04ce9a) + 1. $(ID:a6165ff0-8964-4202-9c03-1b1663b1cd96) + 1. $(ID:5fbb3471-e286-4c91-9bbe-60ce02d34b21) +$(ID:f6432fc3-ffd8-4ed8-b0e6-8ac178e15105) + +1. $(ID:1eb1edea-d27b-4c3a-9625-89e115395d2f) + +1. $(ID:5072c79b-c31e-4870-a20f-e4c26e301ca9) + +$(ID:9cc6a3a5-84bc-462e-91d7-489e49f93506) + +##### $(ID:50f3a4ca-fb8b-4154-b9ed-44d4aecc86b6) {#SpeechReportNormalizedForCharacterNavigation} + +$(ID:2141f615-54cd-44c8-a3c1-52526c6e0f7a) +$(ID:862c00e3-802a-46c0-96d5-b839d2f3eb15) + +$(ID:a89f9aad-8836-4199-b0af-86b4045e26c7) + +##### $(ID:c9acee66-9fc5-46c0-9d6a-de1274c87a3c) {#SpeechSettingsCLDR} + +$(ID:20f69920-da0d-4115-b0c7-44c71acb9dc2) +$(ID:7f5ae1d8-cb91-462b-89ea-b6e4d41bc995) +$(ID:8280300f-a504-45d6-83fd-c3c9c8cdd0bc) +$(ID:9766ae57-ab2d-4876-9167-474ae4dad6f0) + +$(ID:c9c37e88-e3ab-4c00-a266-2b9baf126f23) +$(ID:184a7332-c707-4bd7-ba99-0a615448c132) +$(ID:930a5558-1ee9-4d0b-9a43-3997532dca67) + +$(ID:d65525bd-2c1d-4f59-b7ff-9c512d89e307) + +##### $(ID:8a2897b5-c60d-45b3-9182-e15bd85ab81b) {#SpeechSettingsCapPitchChange} + +$(ID:d7f7fa67-cef6-408d-b6c2-429408b389bb) +$(ID:9201057f-ee39-4099-8011-80a766379b8b) +$(ID:8ccb7890-ccb8-41a0-837d-7fdf8504b9c0) +$(ID:c4028434-6454-4e7d-aaa5-ad172063cebe) +$(ID:851593c8-3eff-4b4f-a1b7-179f1fda8fb4) + +##### $(ID:cfa5037d-a54d-4b90-b2b0-0c666f74453a) {#SpeechSettingsSayCapBefore} + +$(ID:d085dee0-6a76-410b-9588-79296f4ab6f1) + +##### $(ID:71b3205b-f2e9-4d8e-a3d8-51588033a7c8) {#SpeechSettingsBeepForCaps} + +$(ID:f406de1b-9bf9-4cad-ace6-79cb8f8d5409) + +##### $(ID:f544ceea-07c6-4c16-87a5-92c9867646ab) {#SpeechSettingsUseSpelling} + +$(ID:150d60b7-284f-4e8b-877b-717b497f709c) +$(ID:2fb581bd-2458-4b81-8487-da245622f48e) +$(ID:f80671f0-814c-40b4-bb6d-6a64e5f30a1a) +$(ID:0f914875-8ab9-49d3-9073-ad5b7720e330) + +$(ID:d887148e-1499-442e-92a3-70e566eccd61) +$(ID:806c81e1-f074-4601-83c0-ccc05edaeffe) +$(ID:70c8d519-79ae-4c8d-b628-3224b7d8531f) +$(ID:c779b936-45e4-4739-8902-f972297b44d8) + +##### $(ID:775cf0cf-af5c-40d9-af69-d17511727ba7) {#delayedCharacterDescriptions} + +| . {.hideHeaderRow} |.| +|---|---| +|$(ID:7629faf1-ed0e-472d-9745-2f5a697139ec)| +|$(ID:8f97a86f-57b8-4a66-a445-78b156164f3a)| + +$(ID:2b2a6cf4-e726-4afc-bb27-c4dc77cbf1b5) + +$(ID:0a3937c3-e3eb-462a-95ee-b878b7b3e42b) +$(ID:68b1ef13-93ce-441e-b3ee-8d430424f9bb) + +$(ID:db8660a1-a292-42a7-81d2-ecd80a3a6324) + +##### $(ID:3046bf0a-6788-49a0-8f8a-f38b07eb47f4) {#SpeechModesDisabling} + +$(ID:7b7c2670-fb06-44df-8d89-e933f08ced41) +$(ID:f13d00a3-30c5-4b3f-87c2-029e18b37a6f) +$(ID:8555f80a-03ab-4a33-805d-afb25d85b491) + +$(ID:828319b5-e072-4032-8609-050f0fa9662f) +$(ID:d4e3199b-586e-427e-a3cb-5493e041d5a9) + +#### $(ID:3bb84763-e633-401f-945e-c3b44e9e90a7) {#SelectSynthesizer} + +<!-- KC:setting --> + +##### $(ID:9f272bba-87a7-40f0-abf2-a545862b6f43) {#OpenSelectSynthesizer} + +$(ID:f164113e-051a-4171-a6a1-35953b4b2c0e) + +$(ID:dc6c6f91-b88e-492e-a4c1-c0c5441cff98) +$(ID:168b59d1-ebe1-4ac7-a180-9f7be744df12) +$(ID:d51ad96b-807a-451c-8bd6-2c6c368ef8c7) + +##### $(ID:ebce348e-520d-411f-bdfd-a9ca45a969a7) {#SelectSynthesizerSynthesizer} + +$(ID:95d00655-0748-47ca-b5a7-799c331ee6d6) + +$(ID:c5cbae30-86bb-4964-9674-4b8af9a064da) + +$(ID:e94fc11d-c799-4dc5-a910-ccbbc60aedc7) +$(ID:f625b222-026b-4130-a591-6caa9a254cbc) + +#### $(ID:8aff8acf-8923-41f0-9ffd-053f46f052f7) {#SynthSettingsRing} + +$(ID:eccc3aca-7465-4690-87eb-5ff6ae5f1635) +<!-- KC:beginInclude --> + +|$(ID:ed46d691-1a69-4200-8f54-698ee58f5673)| +|---|---|---|---| +|$(ID:7f9e0fa9-be87-412d-9dec-931f41348ce0)| +|$(ID:81d1af71-e32c-4ff8-9198-37169dc6ec71)| +|$(ID:ca76c7fe-a255-4308-82cf-45e012800854)| +|$(ID:0b644ec6-08c0-42fb-8cb2-6e5db8c1eb8f)| +|$(ID:7d520f55-8e64-4002-aff1-ec6bf01f1003)| +|$(ID:b4f4e78e-0883-42aa-87c7-1907b6377c6e)| + +<!-- KC:endInclude --> + +#### $(ID:b2785bb3-60ac-45aa-aa2d-23dcf6ab795a) {#BrailleSettings} + +$(ID:231751e3-0a22-491e-9cee-0059dde79da8) +$(ID:e7f6beba-b401-436d-9c65-dcb1786eb4a7) + +##### $(ID:cac08aa5-f020-47df-8cf8-3d526ba3d8a8) {#BrailleSettingsChange} + +$(ID:6ed9f2c0-79f1-402b-b990-710ae9c0c078) +$(ID:b1cd2cc1-a2a1-4bf9-a2c0-6197163c21f9) +$(ID:031052d1-58ea-4e58-b3fd-a4f554e4044a) + +##### $(ID:8a1150f1-0cab-407c-b0eb-c7a6319a4cba) {#BrailleSettingsOutputTable} + +$(ID:0cde56f9-2d1e-400e-8386-15b386d595cb) +$(ID:b9dd45c3-e5b2-4dae-8ec2-a017f18c6556) +$(ID:1ba403ba-0e4f-45e6-b078-d7e14f1db692) +$(ID:c6adcc2b-5cc0-452e-a9fb-d58a36b59c0c) + +##### $(ID:f6037f74-d5e6-426e-bdb2-6d0a2e64d0b7) {#BrailleSettingsInputTable} + +$(ID:46bfb39d-4c62-45f8-a99c-73cd1990e2c7) +$(ID:44a69ebe-3a46-4740-ba0b-4c76f875a1ea) +$(ID:8b938f7d-3cb9-46d5-be90-20acc4672a2f) + +$(ID:dc8da932-942f-4fa7-8f43-e1abeaf00622) +$(ID:e71c7da7-1560-4ba0-8839-e788e15f8913) + +<!-- KC:setting --> + +##### $(ID:6007b948-b057-473d-9502-8712fcb17e5b) {#BrailleMode} + +$(ID:b5d7984c-376a-47b4-8d8b-0bd69073eacb) + +$(ID:b213a0db-9017-4b29-84ae-4abe9cecaa23) + +$(ID:2ead742a-5f0c-497a-8490-f82c82c72d34) + +$(ID:8cf62e78-15c0-4955-87b3-4baaa7ec4db4) + +$(ID:52d88a5e-4e39-4a6a-93d4-8dc82422aa04) + +##### $(ID:429558b8-4745-4174-8e0d-6c86af94940b) {#BrailleSettingsExpandToComputerBraille} + +$(ID:394ec093-4b82-44ed-9b82-f64a7065135e) + +##### $(ID:3ce31c40-9d18-4a10-b518-a607b0c59cce) {#BrailleSettingsShowCursor} + +$(ID:3d00cb99-53e8-48e9-be0f-22fc0e4d97ef) +$(ID:33aed861-80f7-4705-a74a-0644115bd16b) + +##### $(ID:b02eb09c-be15-4f67-8a28-7451a4c32296) {#BrailleSettingsBlinkCursor} + +$(ID:4eaac87d-3425-490d-ade1-ed6c54827a19) +$(ID:1164d0fe-a071-4d72-b0b1-cfb765c51b84) +$(ID:59f18618-2e50-4679-a207-5f3fb1629c3e) + +##### $(ID:be0826b0-0d71-4bf9-8e38-9bb65c7c14d3) {#BrailleSettingsBlinkRate} + +$(ID:2a1d7096-b869-4dba-a7c7-dbf34cb8037b) + +##### $(ID:107cd940-be05-4104-b76e-3fa99311de6e) {#BrailleSettingsCursorShapeForFocus} + +$(ID:c7273ba8-7f59-4a98-8ffc-3d31eecae3a1) +$(ID:3b1592cd-62a2-4b97-bb15-d4a534b311e0) + +##### $(ID:83d678ab-2fc1-4f0f-822c-110e31a4708c) {#BrailleSettingsCursorShapeForReview} + +$(ID:35f7ed02-9fed-405e-b3ef-c1e57185a566) +$(ID:108f0ac7-9b53-416d-a779-dc1b2eb11201) + +##### $(ID:1c14a19c-e958-426e-9301-65c828ced0de) {#BrailleSettingsShowMessages} + +$(ID:8242b4d6-1d54-41f0-9c5c-389962f302b8) + +$(ID:fc4c1636-3d53-497d-bf08-a1fb15410da7) + +##### $(ID:e2fc18fa-d8b3-4c4d-ac9d-380a08f70cb6) {#BrailleSettingsMessageTimeout} + +$(ID:c53aa760-f1ef-478e-9b73-287117a38f0a) +$(ID:bda496ab-62b9-4965-b66b-aba19b681f9e) +$(ID:d05e3c78-fcdc-45e9-ab2a-fd92c8d9d671) + +<!-- KC:setting --> + +##### $(ID:bd10b5fd-d3e6-4e5b-9775-f0e189686e61) {#BrailleTether} + +$(ID:447ade6d-12de-4e62-b0c1-2f87094cca52) + +$(ID:efe2e770-7100-462c-a6e7-87c9e60422fd) +$(ID:e4daa63c-3a5c-41f2-8b01-a8604310d25f) +$(ID:ca25560b-db7b-444b-9841-54484d0aca6a) +$(ID:6f2884c5-d573-46d4-959f-e9e1c5e4a896) +$(ID:55b97300-83dc-4d1f-a3a3-8bd8d873fb20) +$(ID:cbbd1a7d-e72c-4b92-af24-c107d5ac2ca4) +$(ID:b3256118-e4d8-4748-b4b3-bba83a0e3caa) + +##### $(ID:8227c48e-3d11-412e-80c2-437ff9ccf394) {#BrailleSettingsReviewRoutingMovesSystemCaret} + +$(ID:b089cc37-a9d0-4b76-93d3-29b98b24d035) +$(ID:c584e728-9e32-48a9-8a4d-79c857e2e618) + +$(ID:18819352-c975-41e2-90ca-8b90ce810da5) +$(ID:46ca02cd-2af4-499f-8602-bcbd2ff791cc) +$(ID:f8faf4f6-91a5-418b-bf22-a0e188491b12) +$(ID:20f59bee-bc3f-4455-8230-f07f1ab2620c) + +$(ID:5f7f9f86-35b0-481a-889c-9dec397d6f26) +$(ID:cbb48d99-500d-4aca-a29a-ac5e1706e9b3) + +$(ID:e84a54fe-a113-409d-9f14-106f86f7c453) + +$(ID:f53030d1-3b3d-492a-b6f2-1b847302e2b6) + +| . {.hideHeaderRow} |.| +|---|---| +|$(ID:0fb5939a-9b15-4e4f-b08f-a42393f13419)| +|$(ID:5da39042-e65b-4132-9e1e-ac33e608375e)| + +##### $(ID:8dd2d3f4-5cfa-40bf-af80-e5883a7ebe74) {#BrailleSettingsReadByParagraph} + +$(ID:3a21b42d-e26f-483d-bf08-e7e5424b700c) +$(ID:cac3fa17-abd4-49a1-8e2b-381ab6c1da92) +$(ID:ec537040-106e-46e5-b60e-1b9aa48c1494) +$(ID:63f730fb-a079-4c79-bd4c-33a3f79622f3) +$(ID:8fecc2b2-b824-4a2e-8daa-5f90ae8f0a74) + +##### $(ID:98b300bb-173c-4a88-8620-807f5e663ea9) {#BrailleParagraphStartMarkers} + +$(ID:dd5b2137-41ac-4f4f-89d7-b0ca35125a52) +$(ID:92cb16b8-46f3-4d16-96b0-7a8b5bb10236) +$(ID:5afdaaa7-a4a2-4573-ad73-8b2dcafc1ed6) + +$(ID:fb7f0d7d-9ef7-447e-ac2c-b24139f66ca6) + +| . {.hideHeaderRow} |.| +|---|---| +|$(ID:fa0807bd-95b5-4938-9c0f-c695f4ef7647)| +|$(ID:a2c8dabe-13cd-4e9c-a13f-9be6eb574a2b)| + +##### $(ID:2a44a9e3-65c5-4be3-91eb-a5e49671bf7f) {#BrailleSettingsFocusContextPresentation} + +$(ID:5b35f504-79e7-4021-9d46-087159293b1f) +$(ID:1fe3e8f6-f2ee-4e5b-a2e6-66275b4edc00) +$(ID:ddfde9fc-0c5c-4d16-95a2-0901753076de) +$(ID:25f9726b-e832-4ad3-90df-ca43c58647b4) +$(ID:f3e7bbed-80aa-4cda-bf29-79cc32b6df59) + +$(ID:90de0b44-d3eb-4563-a9e7-f1abc4a5357a) +$(ID:d12bc508-6af7-4844-9fff-5a3293776fdb) +$(ID:62cc4269-ffbf-48cb-ae38-63a6ccfa37d9) +$(ID:14cb7314-d2ce-4af2-94aa-1c9ffa64a2be) +$(ID:846c3fd3-d981-49fa-82be-ed98af6e280e) +$(ID:cffebc39-a725-4701-9d36-364667cd96c1) + +$(ID:51793aa5-76f2-4f0a-81dd-4131f9d218e0) +$(ID:d4e81447-0b3c-4734-8d8f-1e680783a764) +$(ID:2c15cf8a-8b38-41b6-9310-3bcf1bf3ff25) +$(ID:49e88b74-2fb7-4541-9516-d0f3fad8f23f) +$(ID:8e08eb23-8c1b-4585-8f8f-f82f473ee321) + +$(ID:2a109d8e-1903-4aff-9016-34101a583998) +$(ID:946ac510-cd60-45e8-bc53-50955a366f3c) +$(ID:feee3dbf-dcea-43d9-b3e9-56dc64e0db46) + +$(ID:5caa6618-852f-477b-94f3-e3b99183e623) + +##### $(ID:5de1646d-48f1-4e9c-ad0b-766fa5ed10fe) {#BrailleSettingsShowSelection} + +$(ID:c63ac481-bae8-4c6c-8d07-04a1bdb858d3) +$(ID:25561a17-780a-4856-9796-2bbaaf5dd621) +$(ID:366ff4eb-c29e-43a7-a5ce-1a6b97d7b62f) +$(ID:005add5d-f559-4c2c-9239-3080f4f02cfd) + +$(ID:4fa2d68b-67b3-4b0f-b7e2-3b3cc7c647e1) + +| . {.hideHeaderRow} |.| +|---|---| +|$(ID:190ea53b-4e34-41fe-8414-cd0b170db9af)| +|$(ID:425bab72-ae8c-437b-a9d1-01c26f3cd3e2)| + +##### $(ID:350a2888-1671-4b14-85fb-e90fe05f5471) {#BrailleFormattingDisplay} + +$(ID:946696bf-c8e5-41bd-a402-7ea34e3ca39e) +$(ID:80c94a06-f0b3-42aa-a7aa-0ba016025168) + +| . {.hideHeaderRow} |.| +|---|---| +|$(ID:fb079470-4f5c-4fbe-83e7-257c06628fca)| +|$(ID:a7400b8a-51f2-4cf0-8cf6-083cbe2a551d)| + +|$(ID:e1bea9b9-17f4-479f-ae30-5d7b98dffe47)| +|---|---| +|$(ID:1a724dcd-d282-4401-b00d-1bfd3aec2b93)| +|$(ID:85d7ae4a-b10c-48f4-bedf-29c6fa06305d)| + +###### $(ID:93b99f26-4c29-42b9-9f48-2455f2cffd7c) {#BrailleFormattingDisplayTags} + +$(ID:f31667d1-befa-4406-aba7-b68bd7997bf1) +$(ID:bd0274ac-0a54-469b-94ac-43eebc6afa24) +$(ID:e41ce1a1-60b2-4fcb-b697-e8d342e054d8) +$(ID:4ffba340-ca1a-4acd-9526-e4ae13d457d3) + +|$(ID:b69d5396-bfe1-49e5-bd24-867bfa6fd7f1)| +|---|---| +|$(ID:e38d0537-75df-4e54-bca2-58ff785c45bd)| +|$(ID:5e6cc5b2-8735-4046-b064-368dc9a0f082)| +|$(ID:9bd3ee5e-2489-459b-9c31-04ed37a36fac)| +|$(ID:9d5049ae-6ced-4a32-8a75-ec1c62420a4f)| +|$(ID:812545e3-4557-45ed-bdc3-2909c1f918e4)| +|$(ID:264d0bb2-5b0c-46f3-a775-58f473004c91)| +|$(ID:4a8a3b4f-ce28-4ea3-97cc-15fbe996312a)| +|$(ID:4228d415-747b-4b4d-bee1-ad84474f2152)| + +##### $(ID:d3e37afb-f884-4413-98a7-d9195d313527) {#BrailleSpeakOnRouting} + +$(ID:ce9d14d3-37ab-4530-9a35-936260e3f028) + +$(ID:8a0854a6-0935-487b-9f7d-b1e7055e0c9a) + +##### $(ID:66416aa7-4287-44f2-aa7f-5c1d87710de1) {#BrailleSettingsWordWrap} + +$(ID:ca9f4171-7493-4813-b34f-f46089d93e5d) +$(ID:2225f79a-a139-43ad-8d56-e77db9f030e2) +$(ID:6ad37418-cc7c-49e7-87d2-46e65a003821) +$(ID:004ef303-10ee-4f81-9979-a71dc2ef536b) +$(ID:ff1794a8-6df9-4622-9147-07a3e4303a19) + +$(ID:4e405a86-11c8-4c51-9791-59aa46e02e50) +$(ID:273ea79e-d020-49b4-8cd3-5faa4dc4e0db) + +$(ID:ebf2fd63-31a9-4b81-ba3c-b563716e83ef) + +##### $(ID:4bd1a767-eada-4513-a64c-a86731f2ed02) {#BrailleUnicodeNormalization} + +$(ID:bcc743a5-d89f-45e0-975d-3a3f36c07f9f) +$(ID:fecc2432-0afc-4082-9caf-5b8f71d18ee6) +$(ID:e28fb207-0940-4148-ae3c-ed9811496440) + +$(ID:0b3c9afc-6298-4021-ab66-91bf538904c5) + +| . {.hideHeaderRow} |.| +|---|---| +|$(ID:4f8145ca-202d-436b-8f0e-2a071f9be84e)| +|$(ID:d5440f08-be46-4bb5-9611-acf62d29da8c)| + +##### $(ID:e4193edf-2a26-4d8b-9b56-822c9c9d7984) {#BrailleSettingsInterruptSpeech} + +$(ID:b888352d-990c-4e10-8222-62a92a934efe) +$(ID:fad5aa9a-5f90-4024-8d96-b64de1c13663) + +$(ID:868f56ee-2983-4560-8053-8732f07eb5f0) +$(ID:d0bb2894-fe79-4547-a38b-267b8a2d7981) + +$(ID:b1f53a44-15a6-40a5-8a30-39648bfc4564) + +| . {.hideHeaderRow} |.| +|---|---| +|$(ID:ac3c47ec-bc8e-450a-8296-1eee392803eb)| +|$(ID:1aa86ddd-74d7-4ff0-966e-0f6b5b2a5bdc)| + +#### $(ID:5b7765ac-52bc-4f3f-b358-c0fca9c5839c) {#SelectBrailleDisplay} + +<!-- KC:setting --> + +##### $(ID:e73e83c7-c91c-4006-89d0-d781dd37b487) {#OpenSelectBrailleDisplay} + +$(ID:06747dac-5f0c-4aa0-a4eb-44d5c8fce992) + +$(ID:7242715e-4967-4eb0-a9df-bf60e9cbe153) +$(ID:8a217810-55e7-4599-a1cf-9b02cba92788) +$(ID:9d1876f9-6e06-4888-86dd-ba466fe3c38d) + +##### $(ID:719668c4-2748-4b4e-a5ab-5b3b96a17a81) {#SelectBrailleDisplayDisplay} + +$(ID:457aa356-d4c8-4cf2-9a2a-f1120adbe5c4) +$(ID:9b955a0a-f6eb-4551-8870-cebb1f4ccf73) + +$(ID:dac793bd-56b7-401c-8519-3568a76ec24f) +$(ID:e859dc6c-adbe-46d1-87ae-4feb25820aa4) + +$(ID:fff7f848-33c0-40e6-a4ea-5db321979b4d) + +$(ID:80a977ee-0230-4227-8b00-0b107c96bfe5) + +##### $(ID:4189b0f4-cd83-485b-9501-5e090723a923) {#SelectBrailleDisplayAutoDetect} + +$(ID:7b499cf4-dfed-4971-9e46-bae38cf87fe8) +$(ID:230d0b32-d717-43a0-b859-f58cdf8aaf3c) +$(ID:ede00d52-0d26-4592-a302-0180f6b556a9) + +$(ID:447c56f2-1a69-4445-b21e-9422a6f9d895) +$(ID:a0581b94-4a31-4e1d-bce2-0d6344a9d36d) + +$(ID:d05c3970-0997-46c8-9190-6f8876d71518) + +##### $(ID:a9d7af37-7ca9-430b-81dd-dd4b27fabc74) {#SelectBrailleDisplayPort} + +$(ID:1a6bae59-a2b7-4abf-b2b4-83b075598a26) +$(ID:fbbe67a6-bc72-4bd3-b1c5-abe029040ee3) + +$(ID:2b67663d-bcb1-4ec8-9729-15b561a56a1e) +$(ID:02f1e72d-f963-4c8f-997e-7de17e301c5c) +$(ID:54784f3e-8d91-4ae4-a699-c6a11c83b2e8) + +$(ID:8521c220-0486-4173-a661-634aa272fc9d) + +$(ID:b4531225-8e6e-4587-a898-49ec186f2295) + +$(ID:3b4526ee-30ac-40aa-bd79-4a168d219356) +$(ID:858044ba-9f68-44c4-adae-b17dca4c687d) +$(ID:9aac95e5-61ec-42c3-b520-bd713c2a5942) + +#### $(ID:5242f8ee-5ef2-429b-9a55-5321b3c7e996) {#AudioSettings} + +<!-- KC:setting --> + +##### $(ID:f3308d13-c311-42fa-be00-ee165ce946eb) {#OpenAudioSettings} + +$(ID:ce4e08d1-e41f-4a65-9f39-367da1b63133) + +$(ID:1f762ff4-163f-4519-92cd-263e35551068) + +##### $(ID:907bfedf-8887-4b32-8241-3532b6ae3526) {#SelectSynthesizerOutputDevice} + +$(ID:bdba17df-d738-4190-aa92-d97e05d0c698) + +<!-- KC:setting --> + +##### $(ID:2b8ce944-3c7f-4c9e-9ffe-d0df04cef722) {#SelectSynthesizerDuckingMode} + +$(ID:911f6b5d-18c9-4dfd-ad40-33f539e5a6d4) + +$(ID:b8e1eba0-2ed4-4a08-a526-b3e69e2c6a2d) + +* $(ID:8212dd92-36e6-4525-8ba0-dfd5eb16fbdc) +* $(ID:30e46110-6725-4275-a94e-294911e2af02) +* $(ID:cefdec4c-4c4a-4969-ad92-8c81165a3810) + +$(ID:69f20f6e-c72e-4bd8-8190-d0bfbc134bb6) +$(ID:cd40a38d-125e-4169-80f3-81f0665fd132) + +##### $(ID:cbf8c229-6f61-41cf-9bd5-87fdca9386eb) {#SoundVolumeFollowsVoice} + +| . {.hideHeaderRow} |.| +|---|---| +|$(ID:ca264549-58bc-4b29-8217-e7144a435691)| +|$(ID:e6e6eecd-0f07-41ef-b142-8641fd359ad7)| + +$(ID:f589b7fc-11ca-438d-82a1-5f6b67672536) +$(ID:682f3133-011d-40c5-b8c3-ecf49712882c) +$(ID:d8374f52-0985-44e1-827b-2f582a8368b8) +$(ID:a15bc809-0cc9-4c4c-8561-0913c840bdd4) + +##### $(ID:fe7ae80f-9f79-43e8-98d1-2a41e76b1caf) {#SoundVolume} + +$(ID:0cfcfff0-62f1-41c8-bc69-41ce3ce9b0c8) +$(ID:e940f8f4-a484-4b7f-bc3e-20c0c2de9576) +$(ID:bc0fddd5-0938-472a-9be7-3e7d7e55ff72) + +##### $(ID:d471a2c1-ea9a-4ddd-9058-d6d3ba0b9d69) {#SelectSoundSplitMode} + +$(ID:3012a590-209a-4da7-b0cb-342f4c3083a6) +$(ID:cd70e6b8-b80f-4bfe-9e5f-4f55dc22e11f) +$(ID:9275af9c-0bfc-4f2a-ba3b-64144499928b) +$(ID:cba20ccc-fdb2-4c0d-a1d8-e8439f923599) +<!-- KC:beginInclude --> + +|$(ID:ffcd007e-af7f-4597-b0c0-400580c9cb68)| +|---|---|---| +|$(ID:eec67dab-6c74-48b5-a05c-a58a75596ea0)| + +<!-- KC:endInclude --> + +$(ID:6f97faf8-2a72-4794-ad27-2b5faff9e3ec) + +* $(ID:5fc56b48-c2e5-4e97-9a6c-217d4352ddd3) +* $(ID:eb20f115-cb88-4e1d-a2a4-f9bb886c810e) +* $(ID:1db19c0a-d899-4389-b142-c9bc1aad9eb4) + +$(ID:b8547fd4-f86b-4e86-ba9f-26c2a66b6833) +$(ID:691d6e48-0d0c-40c1-9a91-a84b704389b5) +$(ID:6ea592d1-6930-4e5b-bd0c-355914797c8f) + +$(ID:b3709965-8645-4375-8540-9ce3d583a763) +$(ID:5c7c1380-dfae-4244-91b7-486869f8af89) + +$(ID:23768b9c-f7e5-4951-9faf-698050fd26c3) + +$(ID:d5724899-e062-47a7-8937-ab2b656d02b3) +$(ID:00cda7e7-a48e-4e78-ae7e-46405c3ad3fe) + +##### $(ID:110b9d99-aa7e-42ea-9078-6c555b833097) {#CustomizeSoundSplitModes} + +$(ID:17017d7a-2069-4866-aa1e-ad645635749a) +$(ID:d23a67bf-152c-448b-bced-33dfc08455a7) +$(ID:02a7ef2f-2c7f-4d1b-a1e1-2c767b6868a8) + +* $(ID:878f74b0-a708-45d4-a578-bf66e1d758f2) +* $(ID:4d65cbaf-a3cb-4f09-a80b-9c0eab688108) +* $(ID:20c949ad-ec42-4244-8813-b652d5171827) + +$(ID:e3ac63a3-ed99-4616-963c-9d447d416d8e) +$(ID:8ddf5bed-da87-415e-8c97-d5941965bae1) + +##### $(ID:a4d05018-75b5-4e30-be2a-1b863b838633) {#AudioAwakeTime} + +$(ID:87640774-378a-4a59-af97-bcd3ac20dbac) +$(ID:f01bf509-c0b4-4e82-baef-e44da24a7368) +$(ID:f80f66e7-d269-4ed5-ab6a-3711eb04bf3d) +$(ID:8117a696-0859-4c3d-8e8f-45aca37d1cfc) + +$(ID:90e7d19b-99cd-4bb9-9500-37483dda1197) +$(ID:5a80c170-08f8-4920-81cc-c277cbaa528d) + +$(ID:4e58578c-41ce-40f9-9476-ef8e4bc581f8) + +#### $(ID:7fd83f22-c800-472c-91e9-5122f20fef81) {#VisionSettings} + +$(ID:b66a869c-7179-43f0-ba55-8f7faf738536) + +$(ID:fafcc172-5fbc-4c0c-9927-ea210ccc19d7) +$(ID:fed0a867-f55a-4cc6-9e1a-8a4bb0243532) + +##### $(ID:1015d0c4-3f44-4865-bee9-74730c570458) {#VisionSettingsFocusHighlight} + +$(ID:2c880221-4c7e-4dd2-9440-199072865da4) + +* $(ID:4cdcfc86-34f2-4887-9a55-5c1ac33db37d) +* $(ID:ad833a15-00cd-4da2-84c5-f2f0cf85c82b) +* $(ID:7f1b1286-18f9-40e9-bd7e-de12a9d9eb78) +* $(ID:e75b341a-c480-4da4-89b2-3a5168f19459) + +$(ID:8b7ea23f-18b5-414f-afde-53f303028e1b) +$(ID:ffcca5e1-fe67-4ed3-9217-396be4ee0404) +$(ID:012f6bab-27a4-4ee9-be21-dfada7a151c2) + +##### $(ID:c74993f6-df74-4e4a-a19c-7d5b0398ee7e) {#VisionSettingsScreenCurtain} + +$(ID:c9020dec-5bb0-4bbf-aed9-8c0c121257d8) +$(ID:13c84192-58bc-4b9a-acc7-974497675921) +$(ID:86d99dc9-9dfe-4ee8-8a2e-76987e834abf) +$(ID:9d88eed5-dc78-4573-b006-0c7fcd464281) +$(ID:f6964955-c35c-4bdd-9ef4-860b6aef3c27) +$(ID:a3e27ed3-f04f-4daa-83da-0ad40150e0bb) +$(ID:d63ceae4-64fe-4414-a5ff-0e6add9bcf8e) + +$(ID:cba279ff-59b5-4336-8915-0c59db20ee54) +$(ID:15d3d53e-43f9-4198-867b-3a1393960ddb) + +##### $(ID:3a1bc9fb-109f-4068-99fb-8802ca564647) {#VisionSettingsThirdPartyVisualAids} + +$(ID:e5bc4893-17e5-4533-8cea-c4faaecd178c) +$(ID:d0bb2c49-101c-43a8-a22c-f5662c233210) +$(ID:0dba8476-5056-404b-be06-d2addb878200) + +#### $(ID:5b95fdd5-6156-47cc-924e-e4f293ef74ba) {#KeyboardSettings} + +<!-- KC:setting --> + +##### $(ID:d0d444e4-bdaa-4e08-a951-8907fd6d75b4) {#OpenKeyboardSettings} + +$(ID:35d7b7a7-bd13-40ef-b043-adac4a26292b) + +$(ID:55b34fdc-fe1e-477e-a386-27819a340ec9) +$(ID:c91a0b92-6f6c-41db-b4d1-44575577e310) + +##### $(ID:6d42e0ee-c6b4-4ae5-bcfe-633ba6a27581) {#KeyboardSettingsLayout} + +$(ID:66aed737-c5a1-4081-83a2-229bd3a6e2cd) + +##### $(ID:d1f2fd7f-5db6-4bf3-b36d-9b5d08cd7181) {#KeyboardSettingsModifiers} + +$(ID:efb9f294-fa42-400d-8135-08b253bb2536) + +* $(ID:96ad23fb-05b8-4f25-a88c-fa3b0095f5bf) +* $(ID:35992ece-dfb2-41d5-a216-75f90748cf31) +* $(ID:592166c2-067a-47d2-85eb-7300aec4ee2e) + +$(ID:97811be2-76d3-4e72-a48a-301655533b31) + +<!-- KC:setting --> + +##### $(ID:dceeefe4-e9f4-4b24-b1e7-a62df9af9670) {#KeyboardSettingsSpeakTypedCharacters} + +$(ID:690696f7-c2f0-4fd9-9e3b-1f42b5402450) + +$(ID:362aa82c-57a2-4701-9a79-a0d742590c3d) + +<!-- KC:setting --> + +##### $(ID:2f4682f5-35e2-4db5-94a6-c1f76274566e) {#KeyboardSettingsSpeakTypedWords} + +$(ID:545b110f-2eb9-438f-93e5-5ebec61387c8) + +$(ID:f1be43ff-9358-4ff0-a2c4-f494e7c358e3) + +##### $(ID:b2d0d1c7-7e99-4043-8e5a-d2be8ef65ac1) {#KeyboardSettingsSpeechInteruptForCharacters} + +$(ID:26a1ab14-2605-4f28-8a17-6d81b1248ec9) + +##### $(ID:c36b4346-470e-42e8-a324-71522c127902) {#KeyboardSettingsSpeechInteruptForEnter} + +$(ID:0583b98a-edaa-4064-9570-a4b875a438d7) + +##### $(ID:07faa9fc-deb8-4f8f-9549-f754c6d006f0) {#KeyboardSettingsSkimReading} + +$(ID:a34bace8-933b-40bd-91a1-ee9158b929cb) + +##### $(ID:ae0b9467-0e3f-499d-a2f5-02138dc825a5) {#KeyboardSettingsBeepLowercase} + +$(ID:5e67aabe-9d4a-4fb3-8517-4d87ea251028) +$(ID:79060ef8-598a-453b-915f-33e43ba510ff) +$(ID:240adbaf-71b4-4baa-be65-6fe68ce3c963) + +<!-- KC:setting --> + +##### $(ID:ad048f87-2880-40a8-bb2c-c4c67c30edbd) {#KeyboardSettingsSpeakCommandKeys} + +$(ID:0d87f022-4bf9-432c-858f-79a1d91ece06) + +$(ID:4369c19d-45be-4df8-8b22-ff5a6a653d4c) + +##### $(ID:290688f5-e42e-4e2a-9ed9-906598c0fe7f) {#KeyboardSettingsAlertForSpellingErrors} + +$(ID:35239f1a-c795-4f25-b0b1-c8038c310aae) +$(ID:82cd4c96-1fc7-4dc2-8628-485c07528d57) + +##### $(ID:c6c0276b-40ff-437e-a935-b4c145f14cb4) {#KeyboardSettingsHandleKeys} + +$(ID:35efd4d2-a013-46a6-964b-0beb7ff21648) +$(ID:614705f3-8324-4528-a0ad-92f093e306e4) + +##### $(ID:b8eeaba3-5aa0-4a82-ae96-35bec64fbdf2) {#MultiPressTimeout} + +$(ID:e1f32526-2c7f-4308-9df6-fb6cbb16732f) +$(ID:7afdf47a-39b5-4c82-b3f5-9504c77e6bd0) +$(ID:536bb6b6-9ea6-46f3-b4c0-3f9aa508d376) +$(ID:1f1263df-8664-4e1d-95da-add1f011e54d) +$(ID:18fd6449-31ab-42c0-a194-9e70fc22e315) +$(ID:5bf160f9-c7da-4306-9e90-69897a450636) +$(ID:58cd1b84-846c-4119-835c-9fb142b13d33) + +#### $(ID:48e722e3-2749-4029-98d3-bcee8529a010) {#MouseSettings} + +<!-- KC:setting --> + +##### $(ID:9f7c3671-9490-4471-a01b-733e354773d1) {#OpenMouseSettings} + +$(ID:700201aa-45fc-42aa-96cf-b73b1084edd0) + +$(ID:9add66cb-a845-45a9-9903-32201bd1bdae) +$(ID:eef125b9-4c36-4ad0-ad69-7b74c11cd4e6) + +##### $(ID:5c97ccfc-c08c-4aaa-834e-654c58e8a88b) {#MouseSettingsShape} + +$(ID:2d13c237-750b-429f-a1f5-3afbcc35b7a4) +$(ID:59aafbc9-19fe-4181-8ff6-b560428ef497) + +<!-- KC:setting --> + +##### $(ID:25403b7f-b5e6-42bc-b92f-bac80ae19dbe) {#MouseSettingsTracking} + +$(ID:4b492607-1186-4fd3-b401-11944a061e22) + +$(ID:afec1ea2-2684-4b47-ae66-80f4bf0122b7) + +##### $(ID:fa2a5ff6-57f6-44ad-afda-8fe877c41660) {#MouseSettingsTextUnit} + +$(ID:8e8418ac-d226-42da-a584-466328f15fa7) +$(ID:bc0ed68b-790d-4cbf-a8f2-93eb87c9e32c) + +$(ID:e9bdb783-bad2-457f-90bd-3f820371383a) + +##### $(ID:8b770200-d17f-4718-a5b5-352e1b29904c) {#MouseSettingsRole} + +$(ID:5aeeb825-1f6b-41a4-86e4-61dee90ce929) +$(ID:c42cd974-7506-4fce-a752-e61b4542fba8) +$(ID:2c2d6fc8-c0dd-4933-8d36-924cde7d7338) + +##### $(ID:dc18804f-7df1-4079-b461-4039fd60f217) {#MouseSettingsAudio} + +$(ID:673b922a-5948-40ed-a6e7-1213975859a0) +$(ID:10c33ab5-2998-45ef-ae79-ff2de810f46e) +$(ID:73b4fc97-5fb1-4f14-a37d-b9d459eda13e) + +##### $(ID:ac7a28a4-1671-497a-981c-164122b6394d) {#MouseSettingsBrightness} + +$(ID:9045da7a-3894-47cb-a88b-9f7b1b6d349b) +$(ID:13066922-6a73-4c9a-80bb-08d6c31142a3) + +##### $(ID:a555e721-fc19-43c1-9f31-4302999b767a) {#MouseSettingsHandleMouseControl} + +$(ID:6eb40013-bcc2-4530-831c-6254efc18c3b) +$(ID:779881bf-0c75-4489-9864-b1fc9d1356c8) +$(ID:8ad64f7b-f0aa-45a9-bd9f-0823871c1544) + +#### $(ID:399467ac-e632-4d31-8bea-ae3c8e0cbc81) {#TouchInteraction} + +$(ID:5b838d56-56f8-483a-80cc-defc2aeac3d1) +$(ID:5218e4ad-9b41-42cb-a8e3-3e5b6e94d07b) + +##### $(ID:f496ad85-73a9-4e83-ade2-5c79290e89a4) {#TouchSupportEnable} + +$(ID:8d81a89c-c98c-4d8b-ab69-d2c5255b0a26) +$(ID:38bf8a7c-5518-45d9-bcae-2f7cf892ab6e) +$(ID:5c1c29c8-a1e5-4d4f-a1e3-54140690ec20) +$(ID:4cdf987b-2afb-48f0-b000-43c80e3611ed) + +##### $(ID:e74b8bfc-3f41-40e7-add4-e9877b5d00dc) {#TouchTypingMode} + +$(ID:bdfc2ba2-46ff-4cdb-867b-6b4ff5885e3c) +$(ID:054a8d00-36fb-4324-9630-1242a7c8ce9e) +$(ID:7db8ffc0-e0a8-4add-8d02-610a06e8597f) + +#### $(ID:3e08d2c9-926e-46a2-bd40-9c29501117fc) {#ReviewCursorSettings} + +$(ID:c998837f-8a80-4ff5-8243-bd61d7e51fee) +$(ID:1eba4723-e089-4aa0-a2ba-3acd289f8464) + +<!-- KC:setting --> + +##### $(ID:2f9aae03-6991-42c0-a815-0e4ea527464f) {#ReviewCursorFollowFocus} + +$(ID:16299e56-9c0c-47d8-852d-a3e0da1dca5b) + +$(ID:fb7d7b59-25a6-47f5-a19b-760afec59d16) + +<!-- KC:setting --> + +##### $(ID:426b4c9e-d3f5-46c7-814d-1148f185ef0c) {#ReviewCursorFollowCaret} + +$(ID:ea4a15be-588c-4ecf-9629-c82361bcf8c4) + +$(ID:49424867-93fd-4722-905f-ecb4989aff9f) + +##### $(ID:43321f81-8d82-486d-b275-96b570c60d2f) {#ReviewCursorFollowMouse} + +$(ID:d2fc1740-fa34-4643-9821-7b73c20fe004) + +##### $(ID:6403523a-9ab5-4d11-85e1-3f9ae12ba4c2) {#ReviewCursorSimple} + +$(ID:74b434db-32c5-48e7-a3f9-c55b6d2e4d76) + +$(ID:6b4d4559-f26b-45c9-8d4a-aefdfaa150c5) + +#### $(ID:82a997c2-7069-44fc-8b5b-8f66be68acf1) {#ObjectPresentationSettings} + +<!-- KC:setting --> + +##### $(ID:8ada86b1-7d70-4136-b871-75f9b3d681cf) {#OpenObjectPresentationSettings} + +$(ID:82f419c1-4bc0-4ed1-8439-2b2fa77f8e0c) + +$(ID:45fad5de-6a6b-4a2e-8e67-14fcd559a790) +$(ID:3f7437e5-2602-4df0-a840-be87f85a7a13) +$(ID:8c66b2d7-2f71-487f-b6cd-86c4135227e7) + +##### $(ID:5df0cae7-a2f9-4ba5-abe4-fd18eaca5a5e) {#ObjectPresentationReportToolTips} + +$(ID:c7e12384-a6c8-4e80-979f-5cccf515a3b9) +$(ID:917786be-9ec9-469a-94d6-215131ba7fa6) + +##### $(ID:d25ff2d7-8b88-4403-b3fe-e98c7620a8b4) {#ObjectPresentationReportNotifications} + +$(ID:ddeaa6a8-dbee-4679-9c2e-d52f332dc5e9) + +* $(ID:617b9866-3e4d-426f-a575-cd72ac9c6765) +* $(ID:ae21af38-0c0c-453e-a5d5-8f85fedd5b7c) + +##### $(ID:4c13200c-f3ee-40a9-a4b1-184e276017bd) {#ObjectPresentationShortcutKeys} + +$(ID:2a0ba226-84ca-473d-86d2-fb029c880383) +$(ID:74d9ae7b-e4e5-4c38-948e-6d978f305f0e) + +##### $(ID:9b2aac0a-2065-45e7-94f8-d32b44569e93) {#ObjectPresentationPositionInfo} + +$(ID:d5d52a02-5493-4008-adfe-7206da4aadaa) + +##### $(ID:37712fb4-27b0-4611-9f34-c426e54e150d) {#ObjectPresentationGuessPositionInfo} + +$(ID:ca51a1b0-8dfb-4b4f-b09a-01d4e53bbf52) + +$(ID:8d30509e-1a1a-43a8-a864-6b2a34da235b) + +##### $(ID:9516f4a2-a0f3-462b-aa6e-d277f555aaa2) {#ObjectPresentationReportDescriptions} + +$(ID:4489d1cc-4369-42f3-b290-e69606cec53d) + +<!-- KC:setting --> + +##### $(ID:fc40083d-f56b-401d-af8b-93bca1b7149e) {#ObjectPresentationProgressBarOutput} + +$(ID:dc865540-94db-4b01-ad67-e9bba4a8faec) + +$(ID:ac9408b7-4ea4-42a5-9e28-0eddb1f6eea9) + +$(ID:269c9c3d-d80f-4b6d-bb5a-e561b333bb5a) + +* $(ID:3dc11dc6-fe5c-430a-a9a5-0f6e97129969) +* $(ID:11614a1b-173f-46ae-b1c6-833e5b32fb5a) +* $(ID:7bf0fd2a-4664-472f-8c8b-60adb608cd2b) +* $(ID:b06eff59-2a9f-4358-a84b-bb5682870942) + +##### $(ID:33a012b1-a390-41a4-9145-000812fb43e7) {#ObjectPresentationReportBackgroundProgressBars} + +$(ID:54668578-9705-434e-8be1-916300dec03a) +$(ID:4f4bb3bf-5172-49f6-a0a2-f9242b60526a) + +<!-- KC:setting --> + +##### $(ID:bb6be302-55e5-487d-acd0-619d98654c56) {#ObjectPresentationReportDynamicContent} + +$(ID:d3b81eb3-381b-4379-82e9-eeca95cef0e9) + +$(ID:83246754-ffa1-4a9e-b6e6-6d154c383563) + +##### $(ID:ba088d0e-afec-40f3-b9a8-51ce8004b698) {#ObjectPresentationSuggestionSounds} + +$(ID:733a55a6-1cbc-4343-b1c4-e84517405346) +$(ID:19cc1ccb-7295-4793-b862-1500bcc6446d) +$(ID:1cdf2507-0de8-4e2b-a5da-9859046d3242) +$(ID:1aeaa605-382b-417c-86e5-36d193a3e7f9) +$(ID:dfeabe30-095b-471f-ab32-ee1bcc78edf8) + +#### $(ID:6b3af835-d5ed-4078-8d21-3ce6434e9556) {#InputCompositionSettings} + +$(ID:53920827-a7c1-4439-a65c-f81495fe1e63) +$(ID:0c759292-63be-4195-b009-a4aa98e6044a) + +##### $(ID:656be8a5-b61b-4a18-856c-f6ff1158b356) {#InputCompositionReportAllCandidates} + +$(ID:afb2f57e-03d4-47fd-8838-22387a89fe25) +$(ID:9e02c4d6-1100-420c-b385-73f1c0356f1e) +$(ID:82bdced4-7f78-4dec-88a7-326cddcbf2f8) + +##### $(ID:866b2c56-df03-4b8f-9a89-45f8a4dd7164) {#InputCompositionAnnounceSelectedCandidate} + +$(ID:83dbf229-b24e-4788-ac00-9a32a1744400) +$(ID:a2ea4abe-9c29-4e04-9e03-291c9e0bf61f) +$(ID:f64dc3b8-21d6-42b8-bd7a-bd84a1019d13) + +##### $(ID:5d127f7d-bb89-4dd4-94cf-e431064a509c) {#InputCompositionCandidateIncludesShortCharacterDescription} + +$(ID:10a12a8e-1f58-4aa9-9040-fbe2a763cc2d) +$(ID:33671715-fb71-4d68-b3be-4bf8ca0837fa) +$(ID:204c869b-f39b-4148-89cb-d999f237ee4f) + +##### $(ID:a1948880-fb3e-4c83-8aa3-b0bb57a524e2) {#InputCompositionReadingStringChanges} + +$(ID:e73cf005-e47b-4b43-a7f9-6d150a1eaedd) +$(ID:26ccd0a6-b425-4ae8-9cfd-16da25bfba6d) +$(ID:1e3209e7-4d4a-42af-b497-28b21764de5b) +$(ID:3586ef04-0ef0-4ad4-b012-a72aa469d83a) + +##### $(ID:20351a5b-3930-467d-885c-3610dbf0762e) {#InputCompositionCompositionStringChanges} + +$(ID:c0e13440-538c-439a-aaf0-7d3f2d4c48c8) +$(ID:34539fe1-e24d-462c-b0c0-02e3ee682071) +$(ID:a1b5af75-d370-4c8f-bc14-1632a5114f1a) + +#### $(ID:47334022-bb4d-4270-96c2-b510a563b810) {#BrowseModeSettings} + +<!-- KC:setting --> + +##### $(ID:da824375-719d-4ddb-a1e1-43c57ddd20e0) {#OpenBrowseModeSettings} + +$(ID:dfae2583-c80b-483c-bf4c-279078b2cc2a) + +$(ID:fa040122-830c-4acb-8302-c5fea538387d) +$(ID:f55fb9de-0e14-4813-8663-136ea25ac88e) + +##### $(ID:d4c3b8c1-4c66-4181-84b0-239a0d803c15) {#BrowseModeSettingsMaxLength} + +$(ID:f481e5c3-18c9-47b9-9408-d0e2221e58a1) + +##### $(ID:0c29f047-9435-493e-95d2-52d3b4a19405) {#BrowseModeSettingsPageLines} + +$(ID:9300b91d-defe-47a9-83ce-97be901390a9) + +<!-- KC:setting --> + +##### $(ID:c02e453c-10a0-49c0-9adc-5331a167b508) {#BrowseModeSettingsScreenLayout} + +$(ID:b0387ecf-1d41-49cf-a2d3-c104037f47d1) + +$(ID:104b30ff-0d6d-4cb6-a7b0-dacceb4a8c84) +$(ID:a4dc6de1-f4a2-4035-906b-784e9d8478ae) +$(ID:39030b90-9ae3-43ef-afa9-52d025186d58) +$(ID:7e7e87ce-8853-4510-947d-e7c02e7f6af4) +$(ID:00617728-db50-4493-8228-c01fb663ce06) +$(ID:59a0bc09-8375-4193-a781-c49e77954009) + +##### $(ID:1cf80256-e2ae-4d07-903c-4cc3a7c9c3aa) {#BrowseModeSettingsEnableOnPageLoad} + +$(ID:ce9a4204-fb24-42f5-880a-a8a55d1d3eb5) +$(ID:bf38508f-536c-4245-9773-bec7b98dd789) +$(ID:c864e06c-65f8-43bf-90e7-2c7522fd248b) +$(ID:455491fd-9eb0-471d-b660-c8f55bbbea6d) +$(ID:ceda1b94-58be-4c15-8eab-986f94626bfe) + +##### $(ID:bb643bbc-df5b-4738-ac98-1f08d3c519ad) {#BrowseModeSettingsAutoSayAll} + +$(ID:46549110-7229-4329-9d04-1ba772bb31b7) +$(ID:885c9982-3569-4881-ab19-4da4a5e6072e) + +##### $(ID:6e049b10-aa98-493e-9592-d04ae695bf7c) {#BrowseModeSettingsIncludeLayoutTables} + +$(ID:77717467-abf3-4d3a-94db-39defb34b141) +$(ID:2d9e6432-7411-4fe7-90b8-ba5af9ef8033) +$(ID:b359c37b-1873-4c0f-95d6-36ff9e83b23e) +$(ID:0985969f-ddd4-46fa-9963-fe6c6ba0f9c1) +$(ID:7d9caa5d-397a-40a1-a822-86b42cd41434) + +$(ID:a457ea2b-2567-4e7b-9866-bd67ab2149b7) + +##### $(ID:7ee7529a-bf7b-40e9-adf6-20467b84d6eb) {#BrowseModeLinksAndHeadings} + +$(ID:4632968a-d9e2-4a0a-800f-e7103402ff71) + +##### $(ID:923f37a7-b3e1-4572-80db-d3a04c74ba0c) {#BrowseModeSettingsAutoPassThroughOnFocusChange} + +$(ID:427c083e-ca32-4f5c-83cb-c985e14b45a6) +$(ID:2d37320f-68f5-4105-8807-c240aed90a58) + +##### $(ID:af402c9e-41c3-4595-9439-b543cfbc3ab0) {#BrowseModeSettingsAutoPassThroughOnCaretMove} + +$(ID:46641c37-bd81-4c45-89ba-002ea998402c) +$(ID:05d0ff35-bddb-4598-b912-34c313ecef40) +$(ID:d452658e-ff0c-484f-8708-3a9bd8da4c7d) + +##### $(ID:205e9a1f-5af9-48bd-9cf7-0373a0bb910e) {#BrowseModeSettingsPassThroughAudioIndication} + +$(ID:cbe94627-7475-4058-b8ce-7ca39e7cec26) + +##### $(ID:1c918161-320b-4604-9f35-c5dc372846b7) {#BrowseModeSettingsTrapNonCommandGestures} + +$(ID:ff367294-4a2c-470c-8728-8b2fc295e5c4) +$(ID:1ce1a74c-1667-4e51-bb57-334c7e334d51) +$(ID:5b169a35-7d7b-4409-93a6-27660bcf9fd9) + +<!-- KC:setting --> + +##### $(ID:d851a567-df45-4629-96c0-c6e129cc724f) {#BrowseModeSettingsAutoFocusFocusableElements} + +$(ID:15a8bb4c-7ccd-43c6-aec2-e850955d101b) + +$(ID:449be6be-2b79-4712-9e70-0bdea496181c) +$(ID:0135b809-5e57-4ce5-ace2-b2640ff2d26e) +$(ID:08cb94db-539f-4be1-9d7b-22c3c9bca8a1) +$(ID:01b9f1bb-c7d4-48d1-92fb-6507a55f1660) +$(ID:25ea99b7-bc96-4589-80e2-a1c6e99fee5b) + +#### $(ID:bcfc7b41-3341-4d76-aa51-068b29f9e036) {#DocumentFormattingSettings} + +<!-- KC:setting --> + +##### $(ID:6dc3d4ab-4533-4bb1-af17-99bdaab9ef13) {#OpenDocumentFormattingSettings} + +$(ID:2238bf97-1729-4426-a4f6-9a41030fcc5a) + +$(ID:2dddeb20-33a3-46f0-971f-bfab2eebc99e) +$(ID:a2eed530-61f6-46d0-a537-8b6040a05721) + +$(ID:34a985c4-29b0-4e66-bb48-2a8056413927) +$(ID:9c20c117-64ee-4553-8834-24792cb78c21) + +* $(ID:1ee8764d-f695-4050-bf22-9d52222cfd39) + * $(ID:68df8828-d004-428c-836a-bcfcf11b4ef7) + * $(ID:d7d04483-26cc-42a6-968f-bb9ce0a23c50) + * $(ID:6fb89318-1464-4596-96da-18e6dfd7a850) + * $(ID:77002280-72df-4d86-b1db-b12e0b43fa1a) + * $(ID:3f6c33bc-b0ec-4db8-9878-203e42e66589) + * $(ID:3c608f14-c9ba-440b-ba8e-aec59f6a4608) + * $(ID:ac89fea9-b26d-44e1-b4b2-eb016f376764) + * $(ID:91cda7ba-c85d-4f86-bc20-c8ad8c0567f0) +* $(ID:4986ccf0-7d69-47ac-b45e-58caf370ff76) + * $(ID:61844e61-bb2a-4165-8bc2-924b043f8bba) + * $(ID:f85c1c29-8015-476d-9ea0-fc16ee82e1c3) + * $(ID:2a44e947-3ff4-4e10-9013-b999a9ba2fbf) + * $(ID:2d5695fd-b7ad-4fd4-8042-3d18ed31c169) +* $(ID:97d0bcd4-9d76-4196-851a-d147426e4b36) + * $(ID:ec687c03-af25-46d8-9cb0-fb98efb754aa) + * $(ID:6264ee47-357a-4cab-8e13-39f6481dd0a7) + * $(ID:74734f4b-a2d9-4bcc-a4bf-974bbaad713e) + * $(ID:b3500d8e-ae50-4cdf-a4a4-52e29385dfc7) + * $(ID:c4b4d3b5-aa6e-48b1-a840-0ebcefda5aa9) + * $(ID:3c728661-5178-43cb-a53a-efd1bc301e3c) + * $(ID:4fbc08c3-6616-4efc-b46b-3cff2bb0b02c) +* $(ID:afe2ade5-adfa-4f0b-a1c2-27658258a244) + * $(ID:2f80c2d5-b7d2-4d60-8fd9-dabf839bfbf4) + * $(ID:2ba6f1b5-ec3a-4696-9d56-f30184389593) + * $(ID:e09660bd-caa5-454e-9144-7fad16c5b201) + * $(ID:a256ac4c-7794-4ee1-9d8d-94c68c7669f5) +* $(ID:c4654dea-5a3c-4091-b2c8-c74fb6f6fe5e) + * $(ID:a2095d24-590d-4a0f-bb02-2ef1d206c250) + * $(ID:8baeea0c-0d23-431a-a073-4aad9b22abbe) + * $(ID:2e38ba90-c950-45c4-8df2-91032b39ddfc) + * $(ID:ad2887e3-a500-410c-98dd-7f8e626bfdbc) + * $(ID:80611056-bf33-4372-88ae-ffb3fa7a71ef) + * $(ID:bf21a245-6435-499c-a7aa-e40a89a05eee) + * $(ID:790cf5a3-b6d8-4442-a84f-677ca6c3ee27) + * $(ID:790e4dfd-2e8d-44ef-9b80-dce90f7b4edc) + * $(ID:ddc1f24d-5e48-4b3d-8582-75bd411e1132) + * $(ID:05b8fc4b-08ef-442d-b312-12d2d81ee2b1) + * $(ID:0c528b0b-7e9d-45c2-a663-fee68dbaafbc) + +$(ID:fe7300f9-1ba1-48be-a4bc-7a73e70f0865) + +##### $(ID:14e5c335-b341-4441-9b00-62634e165c76) {#DocumentFormattingFontAttributes} + +$(ID:48376768-b6ce-432c-92f6-ac6f44e7a6f1) +$(ID:803810a6-7aa2-4e20-a29c-7a674a103ed7) + +* $(ID:40099d4b-4cdd-42f8-9fbf-6688f5e9c16b) +* $(ID:ee1788d6-eff0-43ba-8f1e-682accd589f3) +* $(ID:45284bce-2847-4a32-bc1d-e7ab64c3fd62) +$(ID:e95f51f5-ba4a-4a7f-9082-aa4f32c2933c) +* $(ID:0f8e5732-f6a9-4c12-ae33-7cd93c9b8da7) + +##### $(ID:4948b630-5f54-4a04-8a0e-e0b54cd925ac) {#DocumentFormattingDetectFormatAfterCursor} + +$(ID:afc84e08-30fb-42f4-b8b4-87f855f559be) + +$(ID:5f3428cf-047d-49ff-a54a-e50efa4affa6) + +$(ID:51cdd305-2ad1-4ec7-9213-e6920512fb91) + +##### $(ID:224870b6-bb34-4022-9bc7-828a1c3b3582) {#DocumentFormattingSettingsLineIndentation} + +$(ID:d7d3058d-b56a-41cf-9323-c95b9befe472) +$(ID:8823e5ae-c6fb-4e5d-aff7-8badfb565d7f) + +* $(ID:408b2adf-1743-4202-8561-1abd3cb8df85) +* $(ID:b5e4ce9c-e489-4169-a36d-ffa1f00c4a69) +* $(ID:42272bc1-8f04-4aab-b6c4-8c36f470862e) +$(ID:0258dc16-c4c5-4495-b685-1df54be9deb3) +* $(ID:4177a256-88fa-471e-8ef1-d4f523e02110) + +$(ID:9a9aa9cf-19d0-42a2-86bc-dbd630af91b5) +$(ID:7931416e-6c48-466d-91aa-243699c02203) + +#### $(ID:603616f5-4091-4d86-8c9a-81f9a3e2c11d) {#DocumentNavigation} + +$(ID:d04f616f-2b7d-4180-aee2-fbc4816b5e81) + +##### $(ID:61ed60b7-d63a-45bc-8001-6bf9c2698d7f) {#ParagraphStyle} + +| . {.hideHeaderRow} |.| +|---|---| +|$(ID:91678db8-458b-4852-b519-5b0be81397ab)| +|$(ID:26158e2b-cd98-4262-b91e-a10d13e86163)| + +$(ID:6eff0d74-6e5d-4d47-974a-d0d98f561d8b) +$(ID:acd75af1-c76e-4ed4-86c5-7e7a8ef1df7c) + +* $(ID:b8f040f6-461f-4c14-bb4d-38d4b9d9d645) +$(ID:cee2292d-da5b-4786-a7f2-712fc1499086) +* $(ID:eb99b3d7-a7f4-4b6a-bf39-7fe34211068c) +$(ID:3cf4e8e6-f7b5-45a9-9bf9-c60954673e96) +* $(ID:cfec5a5c-b291-4ae4-b42e-e380a9bee689) +$(ID:5cce60a1-0d9d-44d0-ae7f-669b94cef66e) +$(ID:87d0e1cd-caab-4131-8be0-11da77893f5c) + +$(ID:54c20924-af77-4b55-9603-2faa2fbe9c75) + +#### $(ID:9bdf175e-b215-4ca7-a07d-5bbdd2406bb4) {#AddonStoreSettings} + +$(ID:504c7c01-cca2-4b02-8fb6-51a3079d67ad) + +##### $(ID:8c0eece4-cf75-47aa-bbe2-5972dc41738d) {#AutomaticAddonUpdates} + +$(ID:233de393-4225-46c5-9e25-296c2de9b9e8) +$(ID:f33d027b-40a6-4768-b281-fbf11418a2c9) +$(ID:67abc0a1-a52a-4ed6-bf0b-dbdb1aba60d9) +$(ID:126d25aa-7e68-4b11-8b0f-c167a65a6da8) + +| . {.hideHeaderRow} |.| +|---|---| +|$(ID:1ed989c1-3998-48f0-a69e-7f55f5f00daa)| +|$(ID:c34bb40e-c6b2-4ca0-bb00-d067200fa417)| + +|$(ID:162148e5-ac1d-4913-95ec-22dd60115030)| +|---|---| +|$(ID:28df0e74-e829-4677-90ae-91e71deec841)| +|$(ID:83eb7c50-ecda-4938-a473-4e1c7c77b479)| + +#### $(ID:41cbd374-e298-42ab-badc-9dd6efb312c8) {#Win10OcrSettings} + +$(ID:0d2fca3f-e541-455e-82d3-fd21910f489b) +$(ID:dbda2279-9668-45d4-89c2-0ed1f0682578) + +##### $(ID:2b2ab6c0-f2d6-4b43-b8fb-13ef16aab0ef) {#Win10OcrSettingsRecognitionLanguage} + +$(ID:a22a2e0d-8085-4511-a10a-b160dc4737d8) +$(ID:064c84a8-a307-4627-9bf7-e75aff678743) + +##### $(ID:bdc7c4ce-c3fc-459c-a67f-706e05a7ecad) {#Win10OcrSettingsAutoRefresh} + +$(ID:4ed53797-cc7e-4fce-b863-0b41a68987b5) +$(ID:6cef700b-f1b8-4334-9a82-09071caca711) +$(ID:2168837d-3912-4c70-b9f7-33f0c10930d7) +$(ID:4c2518dc-03b4-4526-8ede-29d74414b5e0) + +#### $(ID:e3d0c2c5-1a59-4caf-9b4f-67e824c90639) {#AdvancedSettings} + +$(ID:b63e8360-84c2-4e9d-8ed0-330070b656c4) +$(ID:1137cf64-1e09-4f22-8642-7ee38e4531fe) + +##### $(ID:71f46a12-7066-4fd6-8e28-46d30cea501f) {#AdvancedSettingsMakingChanges} + +$(ID:04f5742c-8a76-4618-994b-0e00aedd5dee) + +##### $(ID:ee6916a0-6bce-4d95-af2a-3977e5522de4) {#AdvancedSettingsRestoringDefaults} + +$(ID:443d8a59-1562-4eeb-9a33-cf27aae5192b) +$(ID:c64e1321-a3b4-48d9-9df6-975fbcd4d1ec) +$(ID:07b12dfa-969d-4a11-b8a6-176ea4f40d11) + +##### $(ID:4741ffdb-9f1f-4b21-9257-fd32f97df5f2) {#AdvancedSettingsEnableScratchpad} + +$(ID:7022e6c6-14c4-4e9a-abb1-52468d599fae) +$(ID:003d58de-d88b-4cad-807d-7886fab95338) +$(ID:a4ac7aa0-bb9e-4ed4-a89f-4c8f6acb3c69) +$(ID:4c99b8b4-31b4-41c6-b9f0-37fb0fe32a80) +$(ID:ad321708-6e8b-40f4-9601-73ffe8bcfdd2) + +##### $(ID:a361e592-a5ea-4067-97a7-3086871d03e4) {#AdvancedSettingsOpenScratchpadDir} + +$(ID:459a5f28-d9ea-4af9-a89a-c7b09d2aa03f) +$(ID:335a5648-c8ee-40b3-b699-f857afb142a5) + +##### $(ID:0c7d2668-958f-4c18-971f-b2b7f4b59213) {#AdvancedSettingsSelectiveUIAEventRegistration} + +| . {.hideHeaderRow} |.| +|---|---| +|$(ID:99cd8a21-2a6c-4a1a-8825-76655b8b94d8)| +|$(ID:d6244fbb-aaf8-4606-8b82-72214d3775b5)| + +$(ID:b10f15c3-d85a-4aa8-aaa6-3e69c28dd2f1) +$(ID:413e1503-6ba9-44c6-83e7-c5db8efd4f2f) + +* $(ID:078ab980-b922-4dee-9dd5-e5b6dcbf51a8) +* $(ID:db09d7c9-50db-4051-96d7-2dea8ed6705d) +$(ID:9c579d2e-fd2d-46b6-bc69-0c20902aa310) +$(ID:99fb3312-91a3-4f8e-a87b-1cbb28661435) +* $(ID:b9ed6c23-d136-4e0e-bea1-84fae13d06a4) +$(ID:d774da97-cc5b-4829-9ed2-5cab82b0845f) + +##### $(ID:54f73acd-f4b8-4136-863c-778f4cd27fac) {#MSWordUIA} + +$(ID:a9554030-b8bc-4592-a45b-a0dacaed6eb0) +$(ID:f67ce7b3-de6b-4de1-916a-f1863fe2752a) +$(ID:625325c5-df89-4943-90a7-e8bcfca611c9) + +* $(ID:8a5a948b-e65c-4aab-85ae-6f4cca50642e) +* $(ID:6bcce938-7f0f-4590-b439-bb278527596f) +* $(ID:d38474d6-8394-449b-baed-21d03501240a) +* $(ID:45b2aa5d-6516-47eb-ab46-c14be0c7fa21) + +##### $(ID:b7494421-eaae-489d-ae77-62416a9900f1) {#UseUiaForExcel} + +$(ID:14844af8-7141-4a61-8067-979a40abcb2c) +$(ID:e26b2952-a7c0-47b4-9d5c-bbf31d756012) +$(ID:1f782686-af89-4549-9363-dda1df5db1d9) +$(ID:3700c8c9-9236-4e5d-b13c-d7519e6cffee) +$(ID:3429bdf3-e55e-485c-bd9e-d9b5201a1b5e) +$(ID:ace82b80-e620-4b1b-a01f-ad72ade80e1c) + +##### $(ID:cb023bf6-56c0-4179-8959-907234461c3d) {#UIAEnhancedEventProcessing} + +| . {.hideHeaderRow} |.| +|---|---| +|$(ID:22767c15-204c-4ac0-98ed-a19c589f1fbc)| +|$(ID:2bc5ae6f-7ccb-4a3c-9a41-7be50e193712)| + +$(ID:da629a99-abdc-4c7c-88de-de7930ed3ec1) +$(ID:0835d99e-610e-48db-9d70-55f315509985) + +##### $(ID:09ae9eb2-1d00-40f7-a913-da9ac5553fe1) {#AdvancedSettingsConsoleUIA} + +| . {.hideHeaderRow} |.| +|---|---| +|$(ID:78d863a5-ed7b-42f3-baf9-f1376a62d410)| +|$(ID:1dad6094-10fe-484e-9217-865ca39ea0e0)| + +$(ID:a120361e-4425-4fd9-abc0-64d32382a275) +$(ID:835f9a14-2c80-464d-81b7-8688939fb2c1) +$(ID:7edf6840-6703-4c6d-a428-29488861c816) +$(ID:e0d5cbd6-a6b8-48dd-a2e5-df252064575c) +$(ID:8a681a2b-cbb8-4d20-bd41-a0fa199f4f66) + +* $(ID:0d4bbb24-6f77-4240-b55c-5092986b357b) +$(ID:c4828c15-0c04-4907-ae19-90db1e58761f) +* $(ID:5c536de5-17e1-4efb-bbc7-0c0efe840ff0) +$(ID:a1ff534c-6fe8-4950-bbe6-ce704dd8ff1f) +* $(ID:79e96ac6-f46b-4f00-9bc0-fb8ad3014b85) +$(ID:665009f3-b193-4707-9787-6bb83b195e8a) +$(ID:09b1c809-7779-442b-85bd-f7d56afecfaf) + +##### $(ID:395a7c5d-06f6-4889-83f9-36a01b4f4a12) {#ChromiumUIA} + +$(ID:5d92437e-1a87-4cbd-84dd-1c93adb771bd) +$(ID:ae043c3c-3c91-478e-8ae5-f40b7ebd233b) +$(ID:8dd56b0f-1e61-4750-a194-4f4e3d6706ff) + +* $(ID:9e720e26-c751-4d12-a636-3f91ad00f525) +* $(ID:0234240f-3a19-49db-89cc-60df21c3b66a) +* $(ID:3f5ddbf4-75b7-4a06-ab39-996b3a3c57a0) +* $(ID:5696f813-a5c0-4024-babe-99945a3dfee1) + +##### $(ID:c51550f6-1784-499b-92ef-c334a338155c) {#Annotations} + +$(ID:be2e0189-1956-4b01-98db-36ebc0d7ec68) +$(ID:a1e3752b-1079-4514-a690-002cab27511a) + +<!-- KC:beginInclude --> +$(ID:b8dc1109-94a7-4df4-8626-3537b78c3979) +<!-- KC:endInclude --> + +$(ID:d9c402ee-7d43-494d-bb01-68e87f40dd5e) + +* $(ID:6ea49d35-0a4f-414e-8d8d-ba9d949a5b93) +* $(ID:8c03e34f-e7ed-4c1e-bc71-e830d20f33bd) +$(ID:4cd0017a-2ca3-462d-bb52-58cb7bccddcc) +$(ID:9f6778d4-fc69-42b1-9d3a-de03334fe1d2) +$(ID:f51da544-f692-4bdf-adff-76db984a8521) + * $(ID:c772e098-df58-442a-b455-3b3a85c61626) +$(ID:e607faf8-f0e7-4f2c-8c28-54007787e82c) + * $(ID:2c60188d-2bed-4ead-8366-78b462ed748e) + * $(ID:58d3d7e3-74cc-445f-bbda-5bcf9a2b4b28) + +##### $(ID:d46d3dd2-5b7f-48ce-b786-8661a186b491) {#BrailleLiveRegions} + +| . {.hideHeaderRow} |.| +|---|---| +|$(ID:1eedb9dc-f0dc-4824-b5dd-e16378b881b1)| +|$(ID:292ed75b-1f8c-4582-b6d3-15635afafc36)| + +$(ID:bc231099-ead7-4531-8662-ec83822dfd6b) +$(ID:20a07f71-ee65-416f-9adf-a27ac5b55bdb) + +##### $(ID:a89578a4-7bc1-408f-9c49-16a2ec1dc228) {#AdvancedSettingsWinConsoleSpeakPasswords} + +$(ID:238a2d0a-3fe2-4c8b-902c-1aeafe863a3b) +$(ID:c582403d-e30c-427c-aae1-7af11bf4bd95) +$(ID:49f0840c-2e92-4270-8c39-64fa67f95543) + +##### $(ID:c69088ab-26c9-40ba-a4d7-a2125aa9e271) {#AdvancedSettingsKeyboardSupportInLegacy} + +$(ID:389adb9c-5a1f-4f00-9bef-af17dc4be27d) +$(ID:dab39a3b-9c60-4b78-bef6-830c10455ee2) +$(ID:2f8619b9-2e24-4e62-92a7-5e3851e42882) +$(ID:6b52fa39-5ef7-406f-813a-4a21b1395a7f) +$(ID:e9f94245-71df-4b17-a530-ce2e11f2289d) + +##### $(ID:00ff1ee8-413e-4344-808d-4021c850aaff) {#DiffAlgo} + +$(ID:ac8c3b52-acc9-4f43-bf16-9f10735a20d4) +$(ID:8e74fc02-e0ab-4816-9d81-85874ce818fc) + +* $(ID:40d9a618-310e-4b89-a552-aa823310c25b) +* $(ID:d9489ed6-fb55-420d-bf15-9181f7416f62) +$(ID:7cf5b58f-df25-456a-941f-e541ed45bc3d) +$(ID:0b7032dc-5b7a-486b-b781-8b08c4bf5d0d) +* $(ID:b95847ad-810e-41c0-9923-71f8798ab17c) +$(ID:a6ad8cfd-f954-40ac-9784-6477b55497c1) +$(ID:29541a3a-8cfa-4a40-adf2-43df82cf89bd) +$(ID:d05cf1ff-1e89-4e87-b808-ed47d2ce09f0) + +##### $(ID:5d58df04-78b1-4f4d-b5a9-21a58ffc0b9a) {#WtStrategy} + +| . {.hideHeaderRow} |.| +|---|---| +|$(ID:3ae17983-0d04-46d4-86c4-40c44e09d1dc)| +|$(ID:f37814ed-6532-4501-bc98-9e58016319db)| + +$(ID:19ed1d1b-475f-4070-b819-fb630f7fd639) +$(ID:17a6d699-bca2-4ad4-a096-43247b461325) +$(ID:17994a05-acb5-4616-b1ae-9fbe2b2c0de9) + +* $(ID:bc46707f-db6a-4768-9379-dea4ecf48b38) +* $(ID:e3443f99-f05c-497e-9713-7a4e8f15e0b7) +$(ID:727d924b-8a55-4853-a672-11505e46a77a) +* $(ID:817869de-e4ba-4237-a047-21b64488a03f) +$(ID:4ee646a7-dc69-4527-b062-f87971870c02) +$(ID:29cac062-f5fd-4ae4-abc1-6ca70bc2526c) +$(ID:6aaa46d6-3d4e-48c1-9695-4c145f28b321) + +##### $(ID:6e346a31-6578-400b-b4ec-a32adabae663) {#CancelExpiredFocusSpeech} + +$(ID:54745f0e-05d0-4ea3-989f-68d6dcc3cfab) +$(ID:06a2d130-ddb6-4ab6-8f36-cef76c51f73a) +$(ID:aeabd315-3b51-4cbd-be1f-b4b51dc79035) + +##### $(ID:9818ec02-721e-4b97-aa0e-668e024c4ab0) {#AdvancedSettingsCaretMoveTimeout} + +$(ID:338d13d4-b98e-4d82-a871-c17b8c20e867) +$(ID:79559b39-7461-410b-bb01-cd1a7e1cb5bf) + +##### $(ID:efd8b417-ac02-4554-8d14-fb96d7ce4d54) {#ReportTransparentColors} + +$(ID:d93f3d50-6f04-493a-9884-7660a33e1b74) +$(ID:338feade-3579-41da-95b2-817f63a8a56f) +$(ID:4e2492c9-9ad2-4a52-ae63-1c2ad77c2154) +$(ID:7cbb0c35-3195-450f-adda-3781e1a7a251) + +##### $(ID:4b079888-5321-4647-b9ef-3d0ca4ceb808) {#WASAPI} + +| . {.hideHeaderRow} |.| +|---|---| +|$(ID:4af0f75b-3f91-48cf-aa5a-bab44c4b65fb)| +|$(ID:f26f353a-ff6d-410e-ab44-fadccebee0bf)| + +$(ID:ec134901-f924-4665-a0eb-59bcf1b08962) +$(ID:f419be07-dfdd-4a76-a1af-3b79379d05fe) +$(ID:555c397b-a1b9-4f60-9cd1-195f4ea4f9ca) +$(ID:5d1a1272-f69d-4862-b2f2-cefb4229f65f) + +* $(ID:59cfbe7e-b675-4bc6-bf6d-a505aa951454) +* $(ID:5a47979b-8de5-4117-9679-85ae8b5de53b) + +##### $(ID:4ebb55d5-6ca9-48dd-b462-e2941e01c8d8) {#AdvancedSettingsDebugLoggingCategories} + +$(ID:f3f831cb-7c6f-4c61-9949-09a95b6d8a46) +$(ID:b79d5111-de80-41f3-a883-344eea1d11e8) +$(ID:7761509d-d877-474e-b085-ad9464c37a5a) + +##### $(ID:2f8ec454-6730-4879-b2cf-e12459e7bc7c) {#PlayErrorSound} + +$(ID:3c055c4c-2321-43f9-9cf9-e1acfde8e36d) +$(ID:512199ff-baf9-4681-b7b3-a605ea234319) +$(ID:c3a4b7b4-d721-4998-ae64-6ad3959aff08) + +##### $(ID:3ca8ba30-8997-4dd3-b513-28dc5437a1e3) {#TextParagraphRegexEdit} + +$(ID:fa4871ed-a398-47a3-b27a-425e1d6d032b) +$(ID:92e01b8c-fe67-40a2-8bf9-d983ee2413c3) + +### $(ID:82ba5dbd-71f7-4b17-b8d7-80355f553c5c) {#MiscSettings} + +$(ID:aec5335f-fc1e-4d62-9f24-dd32753749d0) + +#### $(ID:e81c9aa1-dc26-491a-9a29-82cc253ac0f5) {#SpeechDictionaries} + +$(ID:9da81536-d569-42fc-acc6-3c05ea325178) +$(ID:dc0e68cd-a242-475e-8cf0-7074d523231c) +$(ID:ef1f1c97-662c-4693-9f03-2711381682c6) + +* $(ID:6da953b1-ea1d-4e14-9aca-1aeca569ff3c) +* $(ID:0f93d2f0-2cee-4f12-b81b-cfbf9ec68a03) +* $(ID:6daba8ea-6261-49f6-95bb-f39b1cd61382) + +$(ID:c55f65ca-d0cc-4e0d-b372-a83d05f5282f) + +$(ID:e1a2aef8-1231-4817-bc38-fb399a5abe0b) +$(ID:124fd2cf-4927-4fb6-b4b7-335d9e7d8af7) + +$(ID:1f617087-2d6f-40ca-9063-b6fa8cbb921d) +$(ID:3f786cb9-1c74-473e-b3a2-78d1c9852f47) +$(ID:2d219db3-f9dd-40a8-b669-94e7610bae84) + +$(ID:179722ec-3374-46ae-a7c0-37cc102384ab) +$(ID:f2c82c41-ad61-43e6-845c-3d4ed2902f30) +$(ID:638fe6f2-58e6-4a5f-bf1d-af1d66958e43) +$(ID:1223643d-2c74-4c4c-9c17-718ba8b52979) + +$(ID:447410f4-fee9-4276-8ecb-1fb132603be1) +$(ID:02168349-30ec-43fe-b091-243b35976612) +$(ID:7242f463-5223-466d-8ae3-9c4b0f54a6de) + +$(ID:d714aaa1-f9b9-42b1-b6b0-de516c716516) +$(ID:157c6b2d-69b8-47f9-aae4-7df08ec85b45) +$(ID:cab88864-9ff1-4037-ac03-780795e3e1b0) +$(ID:428505c5-ca01-417d-b4ca-c1102c2c46dc) + +$(ID:cba9b9f0-126d-4860-9c06-a4d8f104d5e9) +$(ID:d5b89b40-aef6-4231-906b-f3a40ce2c3d6) +$(ID:825041a5-2da0-4f4e-9f3f-4ce8c575abb2) + +#### $(ID:909761ee-4a29-4728-af07-9622d4e8ef0f) {#SymbolPronunciation} + +$(ID:c130643b-69c8-4575-8d4c-559c29a53c06) + +$(ID:40e7e349-5a98-4e29-b329-419af45cac0c) +$(ID:a8f24ac8-7208-4517-8302-1e153fd96b4a) + +$(ID:d3c1c06e-010a-4061-8ae6-61920c88464b) +$(ID:792b397d-4821-4dd0-aa98-3876f4d0d5c1) + +* $(ID:f5d9df3f-e5c8-407c-a72b-4a8907bfcc1f) +* $(ID:9bed6cd9-e7c1-44c2-bf60-49a1e57aed6e) +$(ID:7a172759-4a15-44ce-9a62-b663fedb2fd2) + * $(ID:475a8712-3da1-4721-b3b4-09d2dab207e7) + * $(ID:2401379c-9415-4663-ab3d-f9ad4811b6b3) +* $(ID:1d2e5d3d-5b06-4e06-bd1b-a9278b8522cd) +$(ID:ded76475-0fdc-454f-a804-95e6b0741a21) +$(ID:b76b37bb-8512-4279-85b8-255a1fc7d198) +$(ID:c3ff9a67-3308-4a17-b7fc-1e3fc89b38e3) + * $(ID:69b1e4e0-a488-4c0e-b909-388975bb473c) + * $(ID:c9b51b6f-a86c-418c-95b4-08b6a98bab9d) + * $(ID:56fac492-f157-471e-84db-210dce5c4998) +$(ID:85aa6e3d-43be-41af-8012-b320b97b857b) + +$(ID:4ce64815-3ca7-412d-b6b9-2ea3afacbe22) +$(ID:0bd80641-6653-4d73-aa9b-56ecce903687) +$(ID:3005f435-47db-4c56-aad1-70e318eaf011) + +$(ID:19cedc46-6fe1-45ac-aa38-0f22ae059b75) + +$(ID:dda96a3a-8969-4679-9b9d-4f01786d80f8) + +$(ID:419868db-aeb0-4108-91a5-f80e358469d0) +$(ID:e1e4a2d5-20a8-40a1-ad25-b5747e7cd56d) + +#### $(ID:f049f307-8c00-4fc7-91ce-8b2d0a9e87d1) {#InputGestures} + +$(ID:642860f4-b40b-4395-9236-e97996769bc5) + +$(ID:d5032fb3-b1ba-4488-a88d-24fa8b04d1a5) +$(ID:ac129f5e-b6ca-48af-8a45-739d997e8ea6) + +$(ID:48da6681-ebf0-4759-8133-08b862da59f8) +$(ID:49b5c85c-6416-40ec-a50e-4c34dab5ef58) +$(ID:ff639816-4f11-43eb-bfe5-c1b5240a7798) + +$(ID:d5170a1a-8f6e-4dd5-b0f3-6301714f25c0) +$(ID:15083cc3-e39e-4caa-8614-10a4fa9a5e85) +$(ID:5ee5719d-023d-413a-a321-b49f67ef110e) +$(ID:12a8e1d0-1f87-41bb-9140-067ffa6589d7) +$(ID:a9b722eb-048f-4d8d-a6cb-7fb7e8e15aaf) + +$(ID:0a4a0be0-2880-48cb-b9c1-425604cd478b) + +$(ID:d25f2974-f029-4c43-a344-97cec52bd230) +$(ID:0086c8e1-d297-4ed0-b556-d3832028a6e1) +$(ID:cf18f029-cef7-400e-9b9e-63f1918404c2) +$(ID:711e9e93-61e2-42ec-ae10-e66956958926) +$(ID:25d38424-d891-4a5c-80c0-5d50bd4a3879) + +$(ID:906c3b41-9523-4456-a559-5c9da316e813) + +* $(ID:28f85402-780a-4923-92e3-80274acce5a3) +* $(ID:dfa4e9b8-302f-4436-916f-997cc5d3b73e) +$(ID:01562631-3e20-4e37-960f-d59b44631fc9) + +$(ID:cadaeb02-a83d-457a-a49e-2bc00b315c09) + +### $(ID:747865fc-3f6b-4225-8013-9ddc660913df) {#SavingAndReloading} + +$(ID:22ad5b14-c204-42a8-85a1-a2194521aa27) +$(ID:2732cd22-7dbc-464d-8e2d-94e040eed23e) +$(ID:dfc1b5d0-707d-495c-9234-4ebbdcc0fcaa) + +$(ID:a4cc0efa-810f-487e-ad86-22888fb7b946) +$(ID:9b202611-c256-4655-8b23-b4b9df5e5957) + +$(ID:d7b53c51-1e32-4877-9bc1-612abaa66bcb) +<!-- KC:beginInclude --> + +|$(ID:6bc1333e-0393-4fa7-abba-7057585dc6ee)| +|---|---|---|---| +|$(ID:c71a8073-eb22-4195-a1c8-fa186c803fdf)| +|$(ID:b778de87-0e9a-41ed-868b-e726c80b2f19)| + +<!-- KC:endInclude --> + +### $(ID:399befd7-919a-441c-8d48-a1800124f0df) {#ConfigurationProfiles} + +$(ID:c8f7be74-b080-41ca-b1d3-a9455a240189) +$(ID:b7ddf752-bf29-4b67-a5cc-58afdea5ba13) +$(ID:49e7b4cd-0d37-48d1-bc0a-53ea379f6925) + +$(ID:42ce0221-2120-4aa3-8b3c-20a11da7ce36) +$(ID:786b7c76-3116-4e9b-b6fd-203e9c79984f) + +$(ID:f1ad1123-5c11-468a-a1af-ca0f439b9fe3) +$(ID:b5c2f59d-fa1c-4d56-8691-01e21ad6bda7) + +#### $(ID:59963414-1318-4cba-8459-56b702d0f5f3) {#ProfilesBasicManagement} + +$(ID:c1c641aa-43d8-4016-af50-1e2f00d453dd) +$(ID:ce30a41f-7a33-4fdb-9697-cf6d01a115f8) +<!-- KC:beginInclude --> + +* $(ID:fd819d8d-c564-481c-8817-d26a18aa90b3) + +<!-- KC:endInclude --> + +$(ID:2aa8c002-cf4c-4a51-bacf-6d669dfd2e9b) +$(ID:e0108fa6-e34d-4b46-8c45-2b14fff22c92) +$(ID:4697837a-9a2f-4959-be9b-57d82b3942f1) + +$(ID:e4417518-69d1-4507-8c55-0b37140cb49b) + +$(ID:bfd9e6dd-357a-45f2-97f1-3d87ee284994) + +#### $(ID:fb8c5a63-b8f7-4cc8-95b9-f7c75ee62f01) {#ProfilesCreating} + +$(ID:652912d0-0d62-41bd-bdeb-defc851c5f8c) + +$(ID:99b32682-35a1-44f7-9150-19aba217f41c) +$(ID:bb1cbcef-8223-4c59-8323-47d2566f6ad4) +$(ID:7adb2165-1aff-4bb3-bc64-72f0c0d98247) +$(ID:732cd7cc-cabe-4281-8f9a-8d72f15d27a5) +$(ID:f91fba7b-c47d-4e09-8d5e-a00753e41a4e) +$(ID:f2c7dea9-3d72-4468-a33b-505c024fbc35) + +$(ID:376b5e5f-5ea2-4cc8-9787-b933b0fbe876) + +#### $(ID:a881718c-6167-4403-8ade-9fec813b9686) {#ConfigProfileManual} + +$(ID:f550e71a-69a8-4c36-9a67-ab9e6ab8124a) +$(ID:f89abbb5-bf06-457c-a012-7da16b97562e) +$(ID:65034260-5b7c-4c0c-b68b-35848122551e) +$(ID:df7d0d57-eb79-48ce-96c5-4f95a8265702) +$(ID:7dd9eeee-da5a-4da4-9458-bd78b50e74ff) +$(ID:74f6b7e9-4ded-4629-803e-8c94d35f8034) + +#### $(ID:1b625868-c9ed-47c2-8009-ff983e77f6b2) {#ConfigProfileTriggers} + +$(ID:f7597cd1-e0fd-4cde-9945-9c35a5086fdb) + +$(ID:964ee54f-10e6-4235-8a06-07d66ed9211b) + +* $(ID:d96c0b91-aaa4-4e84-b00c-a6dff319d70e) +* $(ID:c592a1f1-94ed-46a3-aa00-6d128da4b4e2) + +$(ID:bb150724-c7ea-49d8-9fc3-f3b40a8f5567) +$(ID:e08f7aad-c3b4-4669-980a-35fa5a58170c) + +$(ID:8c0cab6a-4486-4b3e-97b3-c606140da5eb) + +#### $(ID:90a321c5-3239-4610-bdaa-45f774636462) {#ConfigProfileEditing} + +$(ID:9fe3ecdc-b462-4265-b838-ead1d94f897d) +$(ID:ce3930c0-f3cd-4d21-a34f-9158992b24f7) +$(ID:7718b2e7-d72c-4fe8-b03d-e227d922c1e6) +$(ID:d5a6e2d4-2f6f-46d3-9f14-b801bc2e09c4) + +$(ID:af55e547-3e72-4e0a-b406-095c3bb7b37c) + +#### $(ID:6bdc8413-e51a-467f-9ff8-d64968a2bded) {#ConfigProfileDisablingTriggers} + +$(ID:888cc470-13c7-43a2-a010-01bc14140e67) +$(ID:f5b5923e-7df0-4e73-85a8-3e4b57618b96) +$(ID:b60fecef-600f-4ad2-8482-36c08388756d) + +$(ID:6975831f-1626-4a69-a7f1-87bdbc1b4a80) + +#### $(ID:28166f1c-b617-467a-b028-5bf7354f78a8) {#ConfigProfileGestures} + +$(ID:779bef7a-c6bc-4605-b40f-70779c449699) +$(ID:ee80a661-151d-42ee-9359-a7a1eba1c08d) +$(ID:faf97a25-7127-46e8-86b3-653e127f0083) +$(ID:6571bef6-ab4a-4f83-9d0a-6e3ffeed61b3) +$(ID:2d9789b2-2838-41be-9752-622b9514cb69) +$(ID:03b03433-6568-44bf-ad3b-65033c6c5864) + +### $(ID:b41c552a-5ac1-4f37-aa07-1a7108e6c20e) {#LocationOfConfigurationFiles} + +$(ID:f9f79567-4657-4ff9-8017-63e3c12894b9) + +$(ID:e536a306-aa5c-434f-90a3-fa78d1f2aef6) +$(ID:1416b140-f2cb-4da1-baab-8d0e1d236203) +$(ID:234c499f-b95e-447d-8795-3ba9dbd1b4cf) +$(ID:190f6451-28a7-483a-b73b-e1dab081519d) + +$(ID:697d20a8-b12c-4d6e-96bd-011edbde503a) +$(ID:934f96e8-5425-4395-9478-9a0f05f7033d) +$(ID:c1f81b57-e24d-4484-81dd-d44b4c9d09b4) + +## $(ID:94267446-c550-43a5-80a9-d9596e6f85fd) {#AddonsManager} + +$(ID:b12e1f0c-8ac4-42a7-af15-f15000fc1dfc) +$(ID:f5e162e5-4751-4d61-911c-9fb28be579c5) +$(ID:53eb83e0-c97c-47ae-b8eb-0175977900a2) + +* $(ID:766ec6a5-32a2-4501-8bef-616b9b57de43) +* $(ID:f1ade70e-ba6c-40b6-a004-2f333a4d27d5) +* $(ID:759202e3-80a0-48a6-a593-7908f35e83da) + +$(ID:e7a4111d-5f6a-4eee-a144-ca1045141358) +$(ID:f74011b7-705d-44dd-90b3-19350c750301) +$(ID:1e52ea83-93e8-47f9-886b-25f5a7a7dd6f) +$(ID:383f837f-d964-4ec5-80d8-9ea044b475de) +$(ID:9458b1d3-cc43-4e41-b817-854b0144b364) + +$(ID:76689c02-776b-4072-9d0b-9e5dfc6651ae) +$(ID:a8898b71-981f-4b83-89a9-665e98965e10) + +### $(ID:ff714bb0-cec9-478a-849a-a808a9b6551e) {#AddonStoreBrowsing} + +$(ID:880f5d24-fbb3-4235-94c3-57719ce86c6b) +$(ID:5e3daddf-558e-47d4-8e20-0dac348927f2) +$(ID:32e4c916-0959-4f40-afea-5032d0714b18) + +$(ID:08750d43-6150-4c21-b4ae-c3051dde7fb0) +$(ID:39e3f3de-3f9c-47b4-bcef-68285d247956) +$(ID:6fb78071-8472-4c36-9d31-6221d8b913a5) + +#### $(ID:a2875fcf-3202-4e38-9f8b-35c1da0d814c) {#AddonStoreFilterStatus} + +$(ID:37b17464-7456-4653-80d2-8e5bd63fe2d0) +$(ID:d241dc90-dc0d-4899-b7e4-658f06cd1f51) +$(ID:0781c778-b792-4c64-bcf8-08ea844b5a72) + +#### $(ID:aeb0c0d4-0b56-46af-a877-9b64259a8667) {#AddonStoreFilterEnabled} + +$(ID:f515c439-33ec-4e62-9365-f8bb4572cb82) +$(ID:0a94e1d0-6b6e-47ba-ab47-dc469b63513b) +$(ID:ecef31c6-b54a-4905-afb1-78bdb8a62b95) +$(ID:2184ded7-3ec0-4fd9-9927-cb2fd9891d1a) +$(ID:59978a97-1b38-4abc-aab7-a2f14afcea85) +$(ID:dab273e0-eea6-4d3e-bb76-3a9e6edbe3c6) + +$(ID:ac27905e-d7f8-4484-9113-e9977e988fde) +$(ID:73ec033a-e988-4e84-b217-c69bf4fb65e7) + +#### $(ID:0c518bed-314b-4b0a-a3da-e0d821654973) {#AddonStoreFilterIncompatible} + +$(ID:d279fd08-f371-4e40-8f61-ec09e799917f) + +#### $(ID:c07e1930-fe22-49d8-854a-9937192ee0e5) {#AddonStoreFilterChannel} + +$(ID:c4c80580-19cc-4ba3-8d99-27fe66e8c6ab) + +* $(ID:6caa564c-1f89-4312-ae66-ee260c5ca44b) +* $(ID:bc85dace-de79-425c-94f1-b40a3bbce1d1) +$(ID:f72929b1-ad9a-4dce-9c52-a500eb0e41a4) +* $(ID:e4ea7228-5b20-4bf5-aab3-ffab045959ea) +$(ID:4b6ee9d1-0c6d-4e3d-aa27-d2a0e0dad11c) +* $(ID:2a2f4f76-3ca4-4174-a428-58e74789d90e) + +$(ID:0b28b3ed-c8d1-48dd-84bb-84b9bd2230ed) + +#### $(ID:f9c84981-dff8-46f0-8dc6-808f889b6f7f) {#AddonStoreFilterSearch} + +$(ID:557a3b3f-578e-42a3-ba33-2b4e0fc79ca3) +$(ID:2f1b655c-3429-4be1-ad25-379cde41e53c) +$(ID:47f1a38b-87a4-4aae-8e1f-e21db62c0eb3) +$(ID:4e162fe6-0485-491e-8d26-39a7eab0e0f8) + +### $(ID:10117f60-a5e0-435d-b6a0-273c46a23c9c) {#AddonStoreActions} + +$(ID:07ae8cf7-42c7-4745-9194-e26efec8f84d) +$(ID:a7272e65-6893-4808-9ddd-82a105f2c8dc) +$(ID:7077d831-0f2f-403f-bd8c-12f81f134e50) + +#### $(ID:d74cbda8-ed12-4fcb-8d52-123d585da5a5) {#AddonStoreInstalling} + +$(ID:6ea72684-b456-4e36-919d-f6982b4e5bdf) +$(ID:07d2d518-fbed-4eaa-9433-cc0b03bbf34a) +$(ID:dc626334-0d66-4490-bfae-4d917a8e4a42) +$(ID:60c64ab2-f4da-4d53-a060-58b3ba0dc31b) + +$(ID:8d21a467-edc9-484e-849d-1c0828d846e2) +$(ID:e82946ae-ec10-4cce-86c2-044012c9a311) +$(ID:8c34a9b3-63df-4a2f-905d-df398e44655d) + +$(ID:388e0839-ad45-4801-bc4d-59e6c6baeaae) +$(ID:5ae8860a-21d6-49e4-b000-576f0b1e722d) + +$(ID:5fdaf299-330e-4cf5-b1bd-ef30866e39b1) +$(ID:b05248d2-6a3a-4603-84db-35e9d8bc3a60) +$(ID:2414ca87-f249-42fc-a34b-221688caf283) + +$(ID:4a6d9605-8b99-40ff-a703-451f9bf603e1) + +$(ID:8b4d2a26-a3a2-4ec3-80c0-a03669884cf6) +$(ID:c6ac0081-50bd-4383-8692-570f83e3c6aa) + +$(ID:e7ef564a-09c3-4244-9721-7dc7b4c3fae3) +$(ID:bf8dad88-d27a-46e8-88a0-7829f6ace926) + +#### $(ID:2081aaa2-5bab-4468-878d-04c80b19d8bb) {#AddonStoreRemoving} + +$(ID:c80a15b2-929e-4bb4-a26f-099da0e33e44) +$(ID:6a59e4b1-a204-4d86-b4d8-9d3327244e7d) +$(ID:cb5759a8-b196-46a5-920e-370e2368d91a) +$(ID:c02841bb-f190-4d05-867e-e29816eebf39) +$(ID:e56c11d9-3e6b-4717-8bbc-1b0c9bb72a0e) + +#### $(ID:ffb3d767-94fe-428f-b642-bb4f7f006eae) {#AddonStoreDisablingEnabling} + +$(ID:def5493c-f649-4fcd-a5c8-d0b8556ab220) +$(ID:024ff871-181a-462f-9dd4-3ddaaea79d3d) +$(ID:6a942a51-ca68-48b4-b3b5-62a942f050a1) +$(ID:ef663cad-62aa-4910-be3c-bb85f3a5ca15) +$(ID:fe2ff47d-7f9b-4a40-9862-56383d33cae6) +$(ID:054ffafb-6811-4e43-b4d5-483bae906f54) +$(ID:5e6f7c3b-45ce-4f68-bdf9-5ebf58fa3637) +$(ID:634b2ebd-0566-4b5c-b8d8-16e940cc285b) + +#### $(ID:a68533d5-4043-4e4f-8c7e-25afebb6e79c) {#AddonStoreReviews} + +$(ID:81e7a277-3dd4-47cb-b68c-37514032a655) +$(ID:2eab2326-1a2d-452f-aa08-a3f3d68979bc) +$(ID:7399fa70-d60c-4bea-9c72-29e14e0de63d) +$(ID:d20264d5-297b-4e66-8124-fd1a5b8a23d0) +$(ID:42365e76-0ab6-47be-be84-902d055b7455) +$(ID:28068381-3f81-45ce-a585-50d27032ae3c) + +### $(ID:258db609-7d25-4412-a50d-9353188df5e7) {#incompatibleAddonsManager} + +$(ID:e52b51ea-da54-473d-9d8f-31f6ede3b7f0) +$(ID:a8ff2a14-eff2-4f4e-9db7-4b38bd16aad9) +$(ID:875a76cc-ae3f-4dbf-9320-116d26be8ecc) + +$(ID:0ed2aecf-3821-4305-93c1-c70224e5359e) +$(ID:85d37437-5e8b-4081-ab49-eca1e3a93c4b) +$(ID:2b7eb5f8-9fac-49e3-91fc-6aba5ae9fe52) +$(ID:c95285d2-77d6-47fc-845a-260c957daca6) + +$(ID:e09386d7-2898-4a94-a2cf-7b2eb721750d) +$(ID:34c730bc-8815-45a9-872c-eec55fe1a19f) +$(ID:b23eebd1-98d4-4bae-b5fd-f551cccbbada) + +$(ID:2fed30e1-3d8f-4bd0-bd5a-1bd836445093) +$(ID:4b2a64e2-4ad6-4aac-b032-7976f4fe14f9) + +## $(ID:36f2f574-a0b9-48ea-a58c-59076572f7d8) {#ExtraTools} +### $(ID:b39100d6-db40-4036-9565-a1b6d3a4cc9f) {#LogViewer} + +$(ID:479ada38-c1b9-4dc1-bd0f-83ba5002adc5) + +$(ID:e9d0c1e8-ac81-4000-9f93-f5b93003b14e) +$(ID:2f4ca502-ec84-4b6c-ab56-c8996fa190bf) + +$(ID:6140b26b-6282-4878-814b-ae6ffed04a71) +$(ID:1fa4a047-a854-448b-9aee-4a41b3d780e8) +$(ID:97f5de87-8cc9-49fb-b36c-3084b33a1cf4) + +$(ID:f65d17bd-fd70-4563-b394-1f5526af232d) +<!-- KC:beginInclude --> + +|$(ID:7de2ebdd-e2db-4238-a2eb-61192e2048e2)| +|---|---|---| +|$(ID:8303a654-5d5d-4e04-9b92-5b047c319b0f)| +|$(ID:225fb950-8c04-45da-ada6-a671afe510c4)| + +<!-- KC:endInclude --> + +### $(ID:fa737a80-b6b0-4bc4-97f7-f7714795d56b) {#SpeechViewer} + +$(ID:712b842a-a3e7-4970-aa84-a087da87bbbb) + +$(ID:20d8486b-a5fb-41fc-b2b8-cf6025d30298) +$(ID:edcfc4bf-3254-468f-a891-44229bf232ba) + +$(ID:85c067d3-cc62-42b6-8081-3b7feee7668a) +$(ID:ca6eeba3-f1cd-404b-aa8a-946db4eb1f12) +$(ID:76a6e612-0b8c-4735-b841-37b4dd2b3800) + +$(ID:d3bfd2be-89cd-4672-a33e-fb96109244ee) +$(ID:a0dc43b4-0a42-48d8-8d7d-ab11a1aa4a86) + +$(ID:7fad25aa-450e-480b-9155-7be1117fed93) + +### $(ID:bbec9dcd-aa86-4387-b927-796f8268b840) {#BrailleViewer} + +$(ID:df5919dd-ad0a-4854-839d-23c641a2f778) +$(ID:1bf7b9c1-8b3b-4465-936e-ae9af3288ab8) +$(ID:7756cd13-14cd-455e-b0ea-705e0f76b038) + +$(ID:8e6f3431-abeb-4c8f-b62a-6d4efaddfaf7) +$(ID:33491dd6-0f52-4e6a-bda0-8190bffd3080) + +$(ID:290bd8fd-eb82-4789-b009-da1907d95c93) + +$(ID:a4f51521-0b2c-498e-8dcd-fef5ac8dd2ae) +$(ID:bfa6de05-8822-4cdd-bc51-27cb65054488) +$(ID:05f0e9a8-a90d-4b26-94e2-f9cb2b256f94) + +$(ID:bdbdf442-6f55-4e2f-b79c-8c9d4aa42080) +$(ID:21e10b25-fc45-4394-af3b-21dd62e82c7c) +$(ID:a47b3f1b-74f3-4ef4-8ea0-e5d059ac8259) +$(ID:2c498646-ce2e-44fc-a3bd-40a1c8d070fb) +$(ID:1dd4d30a-8bfd-4184-8dff-2bc2646a60db) +$(ID:d58a36e9-ffd9-4fa3-b8ed-4c398ae44a7e) +$(ID:6abe29e3-d6fc-4ac6-afdb-268a89e1d128) + +$(ID:a2d9ce29-d651-45ad-ae36-8920ea51dbe4) + +### $(ID:3ed701ac-dd00-4e03-8df1-2f598c71fb04) {#PythonConsole} + +$(ID:baf5b66e-30b5-47b8-9e16-f7f83cd5ba9a) +$(ID:21a6d4bf-452a-4915-b330-d3f45dc91bc2) + +### $(ID:fbe34ff0-4e78-4297-9007-77e91341c6ec) {#AddonStoreMenuItem} + +$(ID:6b853747-95ac-4f44-bb9e-df2f44b9683d) +$(ID:51b10ead-69d9-4b1e-9bc5-4728b251c4fb) + +### $(ID:4b012e33-5188-4219-aaeb-7f2234564e50) {#CreatePortableCopy} + +$(ID:2a1b4fb4-c473-45e4-88cf-983bbc6169c1) + +$(ID:8abf432e-4556-4b44-b361-39d725a411bb) + +### $(ID:6413026b-1530-466d-9fe7-8c7fee092b39) {#RunCOMRegistrationFixingTool} + +$(ID:df6d118e-736a-45fa-be03-4101382f6c78) +$(ID:c64ff391-fdb1-4c5c-9237-32b0258841f1) + +$(ID:c1b429c4-339c-4386-8297-6178d77d2715) + +$(ID:fe02f1b2-5415-4221-a579-e27eef3f236c) + +$(ID:884022ce-094f-4774-a6f8-6b3de0cf7ee7) + +* $(ID:39cafe53-433b-44f5-958b-6af268d5dd5b) +* $(ID:e372c4ba-01f5-4798-a618-1c28608279c3) +* $(ID:942a4ecc-bb2e-4e5a-b07f-736521d66100) +* $(ID:6a3dbf33-a3f0-47f2-8680-d0b0a3ed2056) + +### $(ID:790f37d0-f3cb-4dcd-8f4b-4a12e9d9944f) {#ReloadPlugins} + +$(ID:a22e1b9e-25da-41f1-ba05-916e51c7a2c4) +$(ID:d70ca5ca-d691-4f3a-aeaa-c4371f66b1ad) +$(ID:ed337ae4-c9e6-43f0-b072-0c7ce45d9c46) + +$(ID:2c951dae-7976-4371-b841-3fc6bf4c625f) +<!-- KC:beginInclude --> + +|$(ID:8ca29697-aba4-49f2-aa1a-a52675bbf3e4)| +|---|---|---| +|$(ID:b79b132a-4efc-444e-a8a9-99d27a9dbe49)| +|$(ID:675d4c52-0ca5-4167-8254-88bbc39ade42)| + +<!-- KC:endInclude --> + +## $(ID:d85f7e62-81f5-468b-ae85-f55aecc70874) {#SupportedSpeechSynths} + +$(ID:6eb9928d-3c36-4930-8442-55063e3c26b5) +$(ID:dd6474c8-846d-4e5a-98ec-42b94c88ff5e) + +### $(ID:861cd6f6-afa0-4c1f-8a26-fa79e1125024) {#eSpeakNG} + +$(ID:e5b33826-478b-412a-8c67-9a74d9db9acd) +$(ID:2fae0319-0cc9-4271-b03f-edbcb742e9ae) +$(ID:a1d4abf9-52e3-4a04-83e2-b354829d2c83) + +$(ID:dd5813a2-b65e-4114-b9e3-a3ec6c8bb21e) +$(ID:7f953b5b-a63b-468c-bc63-92bbc1cf8b64) + +$(ID:a96c0e71-767c-4be4-bbe7-8e065729c007) + +### $(ID:3c7d2c34-7df0-49bc-a8ce-7d11476bd0e1) {#SAPI4} + +$(ID:723ce9b6-7444-4f36-8c4d-2570b11e061a) +$(ID:8915a18b-4f38-4b9d-9566-65315f96551b) +$(ID:54acafc0-b256-457b-a8f5-2c670518428d) + +$(ID:3267d99f-dcf7-42bd-8f05-153b2a52d6d9) + +### $(ID:6542e9c1-5486-4878-a6f7-c8f59d735348) {#SAPI5} + +$(ID:9e6b3880-447c-4b7e-a276-7e161c3f5820) +$(ID:58603ade-f768-4b49-9674-875490f18148) +$(ID:5f0d2005-a6e6-443c-8f2d-32e5c54f5de6) + +### $(ID:96f14247-84d5-4bec-96d0-f0d9c6751874) {#MicrosoftSpeechPlatform} + +$(ID:8007724f-f839-4c9b-8159-c5c592093b06) +$(ID:f40cc4b9-7c40-442a-8352-b18e66f5d63e) + +$(ID:c316c0ea-c6c4-4c4a-9968-e1231c95431a) + +* $(ID:4f5f6461-6d90-4ecd-9e20-38a4a5fd2a67) +* $(ID:db3b35a9-a15d-4fd1-b536-4d86d75348a7) + * $(ID:d6dfa3fd-b917-492d-8603-c29643ae5497) +$(ID:b760ca1c-b1a6-442f-bde2-022a48731398) +$(ID:b19a48a5-006e-4f2f-8fef-a26e6118f2f8) + +### $(ID:8668b0f5-6f98-46a3-9ded-501b71afa24b) {#OneCore} + +$(ID:cba3451f-8eea-4ea1-aa48-05c41cdd32c6) +$(ID:34578502-357c-429c-bd16-a4cb07f58fd9) +$(ID:22376a56-4531-44b2-a0f9-4296de4d3d42) + +$(ID:42bdcd64-0d3e-4da9-b9e8-78fdb5febf27) +$(ID:0a45bd91-857b-4602-87bb-364596929bb7) +$(ID:793309ec-8120-471b-972d-5e127569838e) +$(ID:a520deb7-34c2-43fb-91af-9fd2a4be8610) +$(ID:10b2b035-70b2-4eb4-accf-0dc3d9237606) +$(ID:02ccdc20-97c8-48c4-950e-0e3f6667bfe3) +$(ID:9a19e7b7-3674-4de2-b5ec-78a534dc4dc1) +$(ID:424fa4c5-c629-4f94-8305-2e5c3e9e2a0e) + +$(ID:a5b29cea-d13e-45bb-8d78-4b0d2d8aaf7d) + +## $(ID:c49fa812-f791-418a-b96e-786bc807695a) {#SupportedBrailleDisplays} + +$(ID:2cbd9ba6-917f-47bd-bf78-9d30d740e533) + +### $(ID:c05191e5-026b-4146-9ea7-502eb1451f91) {#AutomaticDetection} + +$(ID:cc9bfaa1-c6ca-45bf-8bcb-6e5cffe2eb0d) +$(ID:9ce4a4d9-2918-4803-983e-33caad725c46) +$(ID:25b9b852-94bc-4a31-a1b3-62d2145cf2d7) + +$(ID:e4d2a221-16ae-4e4c-9122-81a4d7acb35e) + +* $(ID:7a6a7b51-ff99-4867-acf1-1f998db9dfd7) +* $(ID:593fd58a-7e22-4df3-8f67-fea0c7faf82b) +* $(ID:380c2ede-8f03-4945-97d6-dd455f8c80dc) +* $(ID:c2d75778-75c6-46a2-bae3-758688c432aa) +* $(ID:12900638-e0d1-4777-8139-5e1cf7aaadc3) +* $(ID:c608292d-b0ce-4dbc-8297-07c664754ace) +* $(ID:98001a10-d4b2-44c3-a934-d14940173fb6) +* $(ID:79ad2448-5062-4bad-8760-ae7d611a6616) +* $(ID:577dfe73-eb53-4aea-9c2a-5f647ad9b5b9) +* $(ID:b99d9dff-2658-442f-b239-c4e92282532a) +* $(ID:92474131-d9b4-4bce-bd0a-96e8342ec392) +* $(ID:d7e1031f-650d-4665-9f85-11c88b02572e) + +### $(ID:8d2af232-1297-41ef-a577-cbf179ba2c46) {#FreedomScientificFocus} + +$(ID:10e80ee0-dcc0-4ebe-a960-c72df0f22763) +$(ID:0daad44a-3dc9-41ba-8b61-9613efeb8514) +$(ID:5485c975-46c9-4a02-abf2-f74f4a7a41bb) +$(ID:8c6818ea-c575-4bed-8b51-6485c0e8e19c) + +$(ID:707c4457-1bed-4704-85a3-dacc220ba837) +$(ID:2dc3e6cb-4805-4a17-b6f6-b534e56b3a73) +$(ID:47f65445-0a84-420b-840d-70bc63f50d83) +$(ID:2a29d421-5d7a-40f1-bfb0-ff34e02d57fd) + +$(ID:c2806374-f131-48e5-8bdf-d78c8f902c5e) +$(ID:0ef0676b-e822-4308-ba4c-7599b55b257a) +<!-- KC:beginInclude --> + +|$(ID:14667e63-e450-47b1-bce8-f46755889f8b)| +|---|---| +|$(ID:1fb0b448-dc1c-4668-8ead-ffe34d9ff2f3)| +|$(ID:66eadb22-a6b7-40ce-853f-58d09183120c)| +|$(ID:9295a30f-b980-4c66-a945-baee8a5abdbf)| +|$(ID:14abdd3f-fb0e-4748-8b8c-abea2e0210bd)| +|$(ID:f75e4eef-d8fa-4fc0-a336-8d7717d0f77d)| +|$(ID:90f773ae-3fcb-49da-967b-2a8398761a34)| +|$(ID:5ed1cf2f-cb38-498c-8550-1f75a38455c3)| +|$(ID:7dd558e6-0916-44fd-84a7-1522187145e1)| +|$(ID:33ba027a-6f83-4549-93ba-7feed66fb05f)| +|$(ID:a07ba3ab-f33e-421b-bdfb-e9c1cd81729e)| +|$(ID:156c6099-0668-4010-a83f-da144a184fb4)| +|$(ID:5312cd5e-8cd9-4551-b732-1b1782921c8e)| +|$(ID:32d4e54f-a099-49ef-b180-abeee6ceb762)| +|$(ID:7352b575-2866-4e15-91e6-2c83950cbf6d)| +|$(ID:0763eedd-34a1-4780-a21c-3570a7f4bb1c)| +|$(ID:ffaf6efb-9dcb-49f5-b4ec-54cff129bceb)| +|$(ID:bcaf80af-a3ee-45fe-8889-c757381142d5)| +|$(ID:d3705342-b382-45e9-8e3a-a6d25bc584f6)| +|$(ID:d7c34aa4-22cd-4301-a0c1-999390e9f1ce)| +|$(ID:beeabbb1-87ce-401b-ac31-cc34463228dd)| +|$(ID:2752bc4a-1fcf-4dd1-8bb9-186e6cdd3d40)| +|$(ID:9b7b6f9e-73fc-49c1-a6e6-711def149d72)| +|$(ID:fd9a8bf3-c993-4e0c-a30a-6f4a953a8659)| +|$(ID:3aeb9a28-18dd-4ae9-8ac5-ffa5855569af)| +|$(ID:2f1cc908-36df-4814-bfb3-8e27426f545a)| +|$(ID:cc0c8de6-132d-4d29-a4bb-3d7a83aa1126)| +|$(ID:113e9968-7087-4623-be33-9d5a69b2f56c)| +|$(ID:45785ac7-e80b-41cd-8b42-924cd79575a6)| +|$(ID:773a1784-0050-4386-bc48-7cb83b166c40)| +|$(ID:4a08b520-9ad7-4739-b644-0c9335b00f20)| +|$(ID:0dbff5d9-581e-48ee-8876-798d8677fa9f)| +|$(ID:7b1c3e09-c0c2-4ea8-bea6-cbe7f99c7d36)| +|$(ID:8b37faa5-cf57-4465-920e-5a0c2b74649f)| +|$(ID:f35d8faf-6e7d-4f84-9fb5-5a6c6bd70024)| +|$(ID:0fe575fe-0b8d-4c07-b03a-ab02d08efbcc)| +|$(ID:8486939d-4f90-445e-8088-980e3464c9f9)| +|$(ID:7ceb2102-22c8-487a-98ff-de11dfae310e)| +|$(ID:c5c8523b-b715-4535-8ab1-08bfaf53396a)| +|$(ID:49813b0e-fc27-4ac6-a341-688e90399cdf)| +|$(ID:5e9ca566-9d6a-4fe3-a95f-aa4bb4c3dc75)| +|$(ID:762c7643-1e0b-4a76-b9b9-e3d8f0acebba)| +|$(ID:9730f8ac-4d84-4630-99f4-762cfc9787d0)| +|$(ID:4a1f622c-3c67-49a1-80e0-6dce378bff5e)| +|$(ID:1d9cf77f-71fc-44de-838b-3a286ff98b1e)| +|$(ID:6d789cee-d040-4fd8-bdf7-1bd2951bc6e9)| + +$(ID:ff5d0a45-eb12-4687-93d3-cc2abae6c5f4) + +|$(ID:1bb695e2-9ac0-42ad-a019-61ff54b8f3dc)| +|---|---| +|$(ID:a8285d5d-7ec1-46ee-bf3d-76d42c0c1d70)| +|$(ID:3e43c0d3-5054-4565-b6d4-46e940fe6859)| + +$(ID:e079231b-d2f6-4d02-afac-5a05b6156328) + +|$(ID:be2beeb5-19a4-40d9-9d28-43d773528140)| +|---|---| +|$(ID:630bd667-6c6c-47ca-bd16-292985611ee9)| +|$(ID:b30ccceb-a0d7-4ce0-9bb5-47943a2581f8)| + +<!-- KC:endInclude --> + +### $(ID:4294870f-7a4a-4606-90eb-d085070cff61) {#OptelecALVA} + +$(ID:8e006a25-ab29-4b32-8427-0602834fd026) +$(ID:2e9aa8f1-3001-47c4-a68b-8d44b8daec6f) +$(ID:d2a1256a-f6db-4356-8bde-5b60e2ab8257) +$(ID:5b5cf11a-3a26-4ca2-b694-9aa325c0dc0f) + +$(ID:9f472d6f-c6fe-4a72-9630-e6107d79ad26) +$(ID:fffd9863-fa26-43fd-99d6-e2fe7d2cf05b) + +$(ID:674b502e-be1d-42de-b1fd-1cd05b510103) +$(ID:e071331e-3fad-47d1-810e-867d875f5b52) +$(ID:f269bfc6-1825-461d-97c1-3003ccf12270) + +$(ID:12a20731-ef84-4552-95a9-d206529fcb4d) +$(ID:fc1e1172-9497-4a83-8166-da244d9e8ba0) +<!-- KC:beginInclude --> + +|$(ID:033a921b-3b6e-4322-b95f-f48b495f8271)| +|---|---| +|$(ID:aad73dd8-701c-494b-adef-96c1af75b1c2)| +|$(ID:52b55793-1c05-4ecd-aa89-c50dcfc7f751)| +|$(ID:914f80a3-2a8e-497b-a5e5-9a14fdb23189)| +|$(ID:97bb60c5-b865-4457-bfed-504a2faf259d)| +|$(ID:2d89c226-b3f1-4fa2-9306-a9fe74841f94)| +|$(ID:e67d3c0a-f351-4c1d-882c-6335f24e6338)| +|$(ID:8ab64c83-f10c-4afb-b04e-594f7df9e9fc)| +|$(ID:aec010a7-509d-422a-b9bb-a0a88372509c)| +|$(ID:62c5e8df-86bd-46cb-948a-580f229347eb)| +|$(ID:e13d7371-b598-4517-85bd-3aa08055bdc4)| +|$(ID:3987cf36-3abb-47bb-9028-5181147b5bff)| +|$(ID:b4b0a862-2326-4dbb-b874-3236adf014bd)| +|$(ID:adac5b6e-fea2-4692-8187-8423a8a32ac4)| +|$(ID:7d60e1fb-6d22-40af-8feb-012e6c7d84c2)| +|$(ID:f8476c9b-7231-4bcd-b16b-9250b4b610bb)| +|$(ID:5a17a0dd-fed1-4f98-b9d2-e42638e9c14b)| +|$(ID:2edb6cf0-1bd8-4439-8bcf-8f0c5e6e34f9)| +|$(ID:77ed2e96-f7a6-43d8-8369-d3ba1d84e235)| +|$(ID:6095767a-8f95-495f-adaf-0ef9089bac15)| +|$(ID:347a894c-eb02-4208-b6a9-f4ed574e6f01)| +|$(ID:52163966-62fb-47cf-bdfa-63cecb102564)| +|$(ID:48197e2e-a303-411f-8462-9706b1eff3f4)| +|$(ID:8fcda430-4920-4a06-8fc2-bf16fa16cdd0)| +|$(ID:cb9cb6bc-40e6-4429-ba8c-e933941cad1f)| +|$(ID:e770053e-4665-4daf-b72d-e0c4b76a1ce7)| +|$(ID:0d322564-3b6e-4017-bd15-a1446decfbe2)| +|$(ID:d432c947-252a-40ee-ba7a-5a75695d7119)| +|$(ID:9870eb4b-074e-436a-b648-23dee64278b8)| +|$(ID:eb1e3f16-4058-4786-8d1b-d93fd3a91960)| +|$(ID:63c4cd76-90b7-4be1-ab26-2fe42ec919f0)| +|$(ID:eec3cadd-365f-453e-bc8d-d6054ac65549)| +|$(ID:953a4616-7130-4dc3-bb43-87a67bba40fe)| +|$(ID:ac22143e-f962-49af-be12-afc40081014f)| + +<!-- KC:endInclude --> + +### $(ID:0706d801-3e1d-4468-b762-7c5756d1e70c) {#HandyTech} + +$(ID:37d89db6-1ebc-42a4-b41c-8523043792a0) +$(ID:33ef6d87-4e45-4ba1-94d1-40d6126263f2) + +$(ID:d709406f-c9d6-41a3-bed6-4d4127b0a52e) + +* $(ID:a4f5d9b1-8723-4b0b-973f-bff09a897783) +* $(ID:002893da-9bb6-4d04-b93f-98d9d5ac9ba1) +* $(ID:d8964219-bcf7-4687-813a-f68f74350903) + +$(ID:03d2cfe2-514a-4269-97bb-248aad81d529) +$(ID:e0af6e14-583d-4915-a94a-afaba0eecbd4) +<!-- KC:beginInclude --> + +|$(ID:ff7f9e22-f067-4aa0-b1d9-e7d7f36d46d1)| +|---|---| +|$(ID:3ccc55de-5af7-46e4-bf18-74801da4c076)| +|$(ID:5ec5ab98-af58-46d3-8fa2-c6451c5abcf2)| +|$(ID:0954a729-5f98-483f-b60f-322d3f71a131)| +|$(ID:2806cc13-1eb5-46f1-b12c-6beb01ed36cd)| +|$(ID:463d3b8c-6a28-4faa-84ec-bd7d9df31606)| +|$(ID:bb4210a8-c1f1-4a4b-91f2-aba4c4816c2f)| +|$(ID:307072d2-bd08-480e-b37e-e5620ff4cab2)| +|$(ID:b920bb2c-ebba-4a79-9c06-fcb661c7ad15)| +|$(ID:5d3847c3-78ad-46fc-b11b-09ea791e7446)| +|$(ID:7ada73de-a529-4d03-a8e4-9d33108bd45d)| +|$(ID:7f851ca1-63a3-4a44-bedd-4a612463813c)| +|$(ID:4772eabd-8e5f-4fcf-8923-da01053eefb0)| +|$(ID:16d80234-a82a-4c49-8d5e-f27c362d47f2)| +|$(ID:0c29e5b7-17fd-4ac1-84b4-d5cd41b34631)| +|$(ID:43ac8202-2236-46dd-8aab-9e0dffa08a0c)| +|$(ID:8bbba2fa-bd3f-41f2-a3a0-1d4cf8e5810a)| +|$(ID:cf67487e-b3c5-4d86-b10c-6262065fdde6)| +|$(ID:9e285092-1af8-4998-9efe-75e1654023a5)| +|$(ID:35c5b118-d67f-42a2-9cec-d98b77faf437)| + +<!-- KC:endInclude --> + +### $(ID:5ced0aac-bcb5-4735-8b67-6e5a28c4253e) {#MDVLilli} + +$(ID:316fcc72-2ac4-4e58-b81d-8d4dfc61d273) +$(ID:9c25e4ab-b648-4a14-a594-b00ad3d38e60) +$(ID:bda9eb06-55d9-426a-ab49-9b719742ab11) + +$(ID:dc5dc9c9-23aa-441b-900a-7b29dcc54241) + +$(ID:8c56b277-6a59-4f92-962e-9fd66dec6529) +$(ID:b2a831a8-d24a-40a4-9399-fe3e71dcb05b) +<!-- KC:beginInclude --> + +|$(ID:c1b381af-5719-46b4-936e-f2c5c49aa6ff)| +|---|---| +|$(ID:00a41ada-4b3e-481f-aa7b-6a6ed9b7e502)| +|$(ID:2c59b2b1-645b-4995-afdd-9386de1d48f3)| +|$(ID:fc606233-f01a-4d2a-8200-bbf33defc629)| +|$(ID:6c0cba4c-bfd6-47cd-9fab-a4d279e34e18)| +|$(ID:20ffce56-0e59-48e9-9aca-3c47d8f52db7)| +|$(ID:13ff64b2-07d8-42e8-af31-6b16d47ac21b)| +|$(ID:4f9523c7-c7fa-4db1-9f9a-b4bb692cc01c)| +|$(ID:0b87d453-2599-44b3-8bed-e20864273664)| +|$(ID:bfb173d2-4873-4122-9dfb-711e7e1dfc3e)| + +<!-- KC:endInclude --> + +### $(ID:32f8cdbd-cf57-4263-8432-7a196144bae0) {#Baum} + +$(ID:533f7e22-6998-47f7-b22b-2e84468ae309) +$(ID:4c71caec-edc7-478a-88c0-76d5b8f27344) + +* $(ID:0d0d41d9-4336-4202-be46-212568d8cbe5) +* $(ID:a05dd715-d360-4786-b284-3e95383815f6) +* $(ID:86f4887f-0508-4c27-9a9f-23a00745c107) +* $(ID:d216f765-08b8-4c74-818d-017acc0be72b) + +$(ID:fda93a47-943f-4098-b6f0-222c787a07b5) + +$(ID:05550929-aa3c-415d-91f5-6504e55c881a) +$(ID:0a297358-4f18-42cb-8b64-77f40668e696) +$(ID:87365557-8d19-400e-8846-b3d0452d0d08) + +$(ID:2e749613-c648-475d-a642-81c242610df9) +$(ID:977c7268-485b-4922-9959-3f321c444b10) + +$(ID:792479a4-62e8-485b-aed6-cdd52ac6cf59) +$(ID:dbf190cc-13de-41dd-8660-957f69aad53b) +<!-- KC:beginInclude --> + +|$(ID:c4de78cb-7154-454c-94a4-16a3dbbd67d4)| +|---|---| +|$(ID:9e1cd01e-0194-4614-be1e-f4a5c5f15263)| +|$(ID:c4917bb2-f3b3-405e-9129-553487e31d41)| +|$(ID:f3f5f4b6-bf9c-4803-85dc-6ac3ee5bce22)| +|$(ID:a29209ab-efdd-469c-817d-7843a6cc0a9e)| +|$(ID:671de25b-c80a-4df2-880d-5d4efc759d57)| +|$(ID:72e24c2e-a0b4-4245-a9b4-4ea8c08a901b)| +|$(ID:c9ef3a10-4d46-48e9-a5b2-a12cb1c07efa)| +|$(ID:a927cb6e-fb76-47d5-8466-903428784de7)| +|$(ID:8ea6bc79-60cb-46a9-8632-bf77eb98a423)| +|$(ID:b113b2de-e169-46bd-8877-21440003749c)| +|$(ID:f0cf0064-e219-4124-ba79-9943ed9a4335)| +|$(ID:ad19f3a1-5f22-4fc9-9c7f-421ac3ebe079)| +|$(ID:e901c21f-a057-4aea-aca9-b01ad43ff890)| +|$(ID:0abbf0f7-a115-4552-ab5b-fd46100deaeb)| + +$(ID:b146f952-9c84-439b-934a-834282492eb1) + +|$(ID:c00d0f54-ae1e-4b5e-b68b-1004293b44f1)| +|---|---| +|$(ID:33e38db3-5d5e-471f-974c-5268e13ff71c)| +|$(ID:a0b8011c-fd1f-4e33-87c8-77162f2d559d)| +|$(ID:c3da31cd-b9a4-4a2c-82b3-6777a7099518)| +|$(ID:587684fc-3281-43e6-98d4-b13ea9815f91)| +|$(ID:8c17e1ee-08ec-421e-8be8-9cc59efe09c1)| + +<!-- KC:endInclude --> + +### $(ID:25ea0b3b-1c64-4840-bccc-b7fcae74baec) {#HedoProfiLine} + +$(ID:d68af1f4-1d4d-4192-bc35-cf4cfbcdeb76) +$(ID:13c9daa1-6473-4402-8b0e-7d77fb3135ad) + +$(ID:25d6dcaa-cc7e-49bc-a5b1-3f7564084600) + +$(ID:864b0d37-5f4e-4ded-bd42-ea30994f364e) +$(ID:f776294b-1f6d-43b7-b520-d8f651dafc0d) +<!-- KC:beginInclude --> + +|$(ID:05b052f7-0199-430f-9864-eff6a7fb5992)| +|---|---| +|$(ID:93195957-63fd-4a80-9544-69f92913323f)| +|$(ID:91672e86-395c-4dde-8a65-be2526f075cc)| +|$(ID:63443c82-b230-4b50-a6ff-4384f81a82bf)| +|$(ID:9c66c31c-484f-47bd-92ac-aefbb71d9caf)| +|$(ID:4159bc3a-4466-4577-a467-07fde6e45142)| +|$(ID:dfff1d93-9e2a-425e-8521-5725d572337b)| +|$(ID:3d6388c3-51cd-4df0-9a59-ecfbe4f8562d)| + +<!-- KC:endInclude --> + +### $(ID:3a1f61aa-a31d-467e-a1ff-cb1d58adf1c2) {#HedoMobilLine} + +$(ID:70ab81bb-c13f-40d7-b6c6-99b3583564f9) +$(ID:b24c56a7-304b-41a1-a6e7-38a87ec7de55) + +$(ID:89fcb87f-17c4-44b1-8ece-766321ffa56a) + +$(ID:b96296bf-310b-4fbb-87ed-03b57d168d98) +$(ID:32b0cf24-ee8c-4492-83d4-6dbf0b144ff9) +<!-- KC:beginInclude --> + +|$(ID:c76707a2-d593-4780-b246-398fbd1e224e)| +|---|---| +|$(ID:19b0335a-af7d-46b8-aa2a-9507f9351c54)| +|$(ID:5de7ef29-1174-4a0c-acc2-e1f9fa7f7b1d)| +|$(ID:d2a78cbf-db5f-4915-9b04-a81f1e5494bf)| +|$(ID:a04efb1e-8060-459a-adf1-450ac5679c6f)| +|$(ID:6eaf040c-88bf-40fe-ade9-a91e7fabb43a)| +|$(ID:7478d59c-2fba-480a-a774-7edca572dddf)| +|$(ID:6c2a1460-11ec-4a4b-b183-628334726288)| + +<!-- KC:endInclude --> + +### $(ID:1a439088-6e82-4e1a-a389-d4322a1cbf1c) {#HumanWareBrailliant} + +$(ID:9d66f1c1-95aa-4bb3-b0c3-fa5286da31f3) +$(ID:9434d525-52da-43e2-a715-7fa95cbf7eeb) +$(ID:de9a4aec-ba36-4f83-b1a9-5d982ca3087f) + +$(ID:0765c4bc-2dcc-4007-ae56-c41c870ca55d) + +* $(ID:2313d072-7a32-47fb-abdb-d56b1acc5d48) +* $(ID:82fcfec9-e860-4a16-b64d-c001be638ec4) +* $(ID:21d2c9b2-b4eb-44de-a1f7-291e736a193e) +* $(ID:c2182aeb-7a81-4cb3-a9cf-85fbafacc3f3) + * $(ID:99e8177a-826d-4547-91ef-01c1883b0519) + +$(ID:b5e297d0-46eb-4006-82ae-d8743b773b4e) +$(ID:27b0263e-9e91-45ee-8b5b-9cc4ff9679ec) + +#### $(ID:9fabe2c6-5627-4193-b24d-96771b8f3667) {#HumanWareBrailliantKeyAssignmentForAllModels} + +<!-- KC:beginInclude --> + +|$(ID:f0c95312-c5c6-4877-b713-d8905b4eae4b)| +|---|---| +|$(ID:101a6d2d-b0dd-4360-aee8-948d4e5dd15e)| +|$(ID:a8e7fe18-b4a1-411b-bf19-687e3aee3218)| +|$(ID:f1c6b93e-d081-403e-82a7-4a7022c7f54b)| +|$(ID:e5c6b1eb-1376-4a22-bfc4-56244487a3b4)| +|$(ID:f55f4c5d-8005-489c-b94c-39020e527a95)| +|$(ID:4d36c134-cc87-45ab-bd07-4fa34ce40b37)| +|$(ID:8e9e35ad-62fd-4681-9ed8-f5f1892aa424)| +|$(ID:fcddf3b4-2886-4158-8af4-7248da57fd65)| +|$(ID:a0bc5bd3-38e1-4253-974e-9ebc50fa378b)| +|$(ID:b933bebc-0c0e-4dcc-9a34-ef149a64f530)| +|$(ID:c1bd6ba8-7826-4cd8-a966-41a1bb447429)| +|$(ID:29966671-efbf-40da-854d-1888abf0447f)| +|$(ID:61b9339f-6bf1-4564-b2c1-499fad724f14)| +|$(ID:5eea8f79-879a-4081-b57f-44229bc7c78c)| +|$(ID:128ddb4b-7272-45ae-b0e9-c4f565eb00a1)| +|$(ID:91a18d69-f514-4c62-a626-57f0a32e50ae)| +|$(ID:959f589e-089c-4406-ad02-2387b3c932af)| +|$(ID:43221156-71f1-4b25-aea8-4ab90aa29991)| +|$(ID:4b97fa72-1783-4f5a-a375-01ff8dff42c3)| +|$(ID:98ede96d-a790-4897-a6ce-553eb5237121)| + +<!-- KC:endInclude --> + +#### $(ID:47103566-db0a-465c-b789-1876d774cf07) {#HumanWareBrailliantKeyAssignmentForBI32BI40AndB80} + +<!-- KC:beginInclude --> + +|$(ID:1d969676-0e1c-4d9f-82a0-fc22b6de776d)| +|---|---| +|$(ID:dc19df25-e546-47ff-852a-1cf39989ef6d)| +|$(ID:8a9549a8-5fa1-453c-b56c-bb0672a7e2bd)| +|$(ID:38756c0d-7336-4487-b1d6-fc56e09e3eda)| + +<!-- KC:endInclude --> + +#### $(ID:fae8ec4d-72f7-4744-b6ce-763368210686) {#HumanWareBrailliantKeyAssignmentForBI14} + +<!-- KC:beginInclude --> + +|$(ID:6759f592-8669-4d01-bba2-9e657d6ac6fa)| +|---|---| +|$(ID:fb37d700-1488-4549-8f48-1fb1f592d936)| +|$(ID:fbcd2c08-f193-4a90-bb7d-b3d1c5b5a9be)| +|$(ID:d5770296-923c-474a-b5c0-9be6b05d170a)| +|$(ID:e64d259a-2c92-4a6a-bb37-58f7e5a1bd92)| +|$(ID:dfe52cd1-58e0-48cc-b708-a3b03d9778f0)| + +<!-- KC:endInclude --> + +### $(ID:7b4e117a-4f8e-446a-a5c8-d46ff7fa0c0a) {#Hims} + +$(ID:741a82fe-9230-4f5f-ad33-e02cef37c85a) +$(ID:897681dc-494f-4622-89f7-be9dea644642) + +$(ID:9cce24b5-bbd6-4ec2-ac8d-ec574b21d502) +$(ID:bd041488-a2d6-4366-8ed5-819d9b602e5f) +<!-- KC:beginInclude --> + +|$(ID:c31b8ba0-c851-4993-8f7b-c6e6767b4f42)| +|---|---| +|$(ID:89e54c91-ff87-48c4-84e4-c84d95fde95b)| +|$(ID:41b291d6-10b8-4654-966c-768c5a7088bb)| +|$(ID:f78da92a-750e-4322-b4b1-4b6bf8b6db36)| +|$(ID:0b05af51-e072-4f29-b315-5315ee92463c)| +|$(ID:a9a911ed-4508-4bff-8312-5d8fe543dd00)| +|$(ID:c8e2c895-ba33-4e6c-9d9d-c669e80a417a)| +|$(ID:5f214485-2569-4324-a985-6719d57bd4af)| +|$(ID:673a9881-f79d-45fa-93fc-e8eb423e65eb)| +|$(ID:023f5df1-c61f-4797-98b5-dc94e7853b83)| +|$(ID:9164ee08-2190-4008-8a00-f66c41a33569)| +|$(ID:2f67004c-103d-4168-bb94-0a1bc630d9d6)| +|$(ID:4556ba8f-7de7-481a-a9fe-8d1c741e8fb0)| +|$(ID:ed90bd5e-d0af-4c9f-b6e1-d66d343d0d8b)| +|$(ID:69d5d5ba-99df-4b80-b2c7-36d7b7956b2b)| +|$(ID:30cc8fec-02da-49a5-aa4d-4a885432fa7d)| +|$(ID:297635c8-d6b9-41ac-8552-fd59add42670)| +|$(ID:af59e0ce-4235-43ff-becc-d210b1f7bac4)| +|$(ID:66e8da72-8c3a-415c-b4dd-ff9129b040af)| +|$(ID:cd0cb495-9169-4716-b7d7-cf1dae0d16cb)| +|$(ID:405a433d-4e49-4144-821c-6b35e0075514)| +|$(ID:28b38077-2a66-4247-a1f0-fc58834ba1a4)| +|$(ID:5418b8c4-1859-4b9a-909d-67a97371ca46)| +|$(ID:a17efbda-332f-4fef-bcbc-44738acdbf00)| +|$(ID:ccca3103-9f5d-441f-ad21-5782007cea63)| +|$(ID:1837894d-c562-44b0-9e15-ef848b535432)| +|$(ID:54478951-6f2c-4de0-96a2-881354a38192)| +|$(ID:9abf65f6-271b-4fb6-897b-5e1eff59d21f)| +|$(ID:6e9a1d6e-44f7-47f3-b7e9-bba87e99c6de)| +|$(ID:138ae3d4-78ba-4799-acac-a8c654f3121d)| +|$(ID:cab2dd3d-5ab2-4338-9adc-127030181213)| +|$(ID:2ade3e59-f767-4e4e-8eeb-3b726173df0b)| +|$(ID:ceae2a3d-4ff6-4470-a60e-a42002b4c930)| +|$(ID:040d76b1-c92c-4ead-b1ee-b522f4b8031e)| +|$(ID:d0cb88d7-d670-4d39-8438-395f929f98d6)| +|$(ID:865ab803-23cd-4495-bc35-1946376a124a)| +|$(ID:230a3db3-43db-4373-9e68-e6c0c7a6f727)| +|$(ID:466c5152-9f57-4636-bdea-6b867e95eec4)| +|$(ID:d0f90a5d-fc40-496b-a593-71fcf708c495)| +|$(ID:008d26ef-970c-452e-a259-902928ec10aa)| +|$(ID:9a12a2e4-eed5-45ae-aead-dfba09b67d26)| +|$(ID:424e4fd5-9c0b-4311-8786-4622c61ae0d2)| +|$(ID:2d62effb-c4be-4387-959e-eb0064afea21)| +|$(ID:a44ff7a6-9010-4440-9b0f-0c548c8bfdc2)| +|$(ID:97f9ecf5-e0b2-4f28-8a34-0ece5b6e4553)| +|$(ID:3efdff52-d6fe-4656-9722-ae53e1b52ffc)| +|$(ID:182d893f-de83-4212-8f42-96bbb61de62a)| +|$(ID:43b2a8eb-2e9e-4b04-b5b1-f7cac4356a1e)| +|$(ID:e0cf891c-319f-4e62-9615-36cc1e32ac00)| +|$(ID:98bef7c2-900a-4450-80a4-4d72aee3f00b)| +|$(ID:1225d5cd-060b-405b-abcd-fbae33f88e9a)| +|$(ID:f0c8c695-ce5e-45fc-97ef-9d6b0a3e43e3)| +|$(ID:e64a4593-836c-43ed-b33e-c0f1635c0f19)| +|$(ID:c37496fd-e46d-4add-bc30-39073c5f073a)| +|$(ID:238a2d11-1dea-4592-902d-67f235d3d8af)| +|$(ID:31ba8ade-a7d0-49b2-9961-f3ac357f30c3)| +|$(ID:6d257698-d9fb-4514-82db-cb3031fc6927)| +|$(ID:f3b3a24d-2ceb-4328-a44c-f3ca7616bb4a)| +|$(ID:34422a5b-6d2b-4018-b52a-f9cfdc6573ad)| +|$(ID:cb406699-5ec2-4038-8c37-4ee4401cec4c)| +|$(ID:8e44aa4e-3a30-4001-b8a5-5fff63f741fd)| +|$(ID:b3884475-4487-4ab4-8377-bfefe43d9fe5)| + +<!-- KC:endInclude --> + +### $(ID:69d40864-1eb6-411c-910e-60216aff5a93) {#Seika} + +$(ID:15c76973-5512-4ec6-9894-1bc7380770c5) + +* $(ID:a93f985e-6ec5-4ef5-8f9a-8ca5c33ad0a1) +* $(ID:6c5a28fd-27e0-475b-817a-d7e7f9c7c8ab) + +$(ID:35f0a0b4-c9e3-4db4-8045-95be39666ca1) + +#### $(ID:fa4bff7c-bbf1-4eb9-9676-b0f34de5b080) {#SeikaBrailleDisplays} + +* $(ID:355354e5-d4aa-4d49-9f0f-cdf988a8319f) +* $(ID:fce80429-597d-4c8e-9ba3-7a0ce8b1b449) +* $(ID:c5d05624-0aa0-4f43-bdca-b09ae570d0d6) +$(ID:48c94955-8110-4b94-af0f-0660ac77e627) + +$(ID:fe837443-9b15-4597-b4ed-d7d407f4532b) +$(ID:2288c457-9d97-49cb-b20e-be644eb6303e) +<!-- KC:beginInclude --> + +|$(ID:14ff15c0-01eb-4e01-b12d-558c3aa5d028)| +|---|---| +|$(ID:823ecd9d-a1d4-46a7-bb30-a611b659e7d7)| +|$(ID:c42fb6d3-3e9c-4a0e-a726-b97f8d4ea750)| +|$(ID:b02b226c-5439-4454-bb50-0dc6a7c8cddd)| +|$(ID:39c8cf58-1967-4a5b-bd97-7294e25a1103)| +|$(ID:60628f75-7691-4cae-afae-546c3726b0d9)| +|$(ID:260ff592-4d9c-4433-aa23-ea952de1193e)| +|$(ID:63b94084-6365-4583-87ca-fe8560e4a58c)| +|$(ID:cd2abc44-9b57-4b6c-bbfb-664a1ff7ec36)| +|$(ID:d0c17a54-342e-4612-95c8-7bae5a5e734b)| +|$(ID:fe43d3ac-3ec6-4099-9d00-ff505e3d24b6)| +|$(ID:6d88db70-3a96-468d-9b7d-e5db3ae8ec14)| + +<!-- KC:endInclude --> + +#### $(ID:ea4b4bdd-7ef7-41ca-adbb-99b25e9090f9) {#SeikaNotetaker} + +* $(ID:49cd7f77-6cec-467c-bde7-cbecf9e1eff5) +* $(ID:b9ee245a-266d-4369-972c-113f7b9b2b45) +* $(ID:9dd765ff-3b15-4f07-a101-bdcf51eb801d) + +$(ID:f07fb71b-d6c1-4112-8baa-13eb68c89096) +$(ID:ee032bd8-d8d9-43be-941e-050f19ef9039) +<!-- KC:beginInclude --> + +|$(ID:75535fbf-85ad-4723-b620-2d93e2df2123)| +|---|---| +|$(ID:2ad91c26-c0dc-4f56-8cca-dda0b1cb55f0)| +|$(ID:1e5bb40f-b42a-4198-9813-1392ed4145a5)| +|$(ID:15306d39-5641-4655-91f5-2c9646083367)| +|$(ID:7b52017c-2f0e-4f8b-8d5d-50f5dfd9c8a9)| +|$(ID:0337df60-3a11-466c-85c5-88d68dfcc3f1)| +|$(ID:b114feda-b66a-44f8-8ffe-846ef8f419dd)| +|$(ID:8e1a9541-ee8b-4acb-b9a5-6b18dfa46136)| +|$(ID:a57e4b72-bb5c-4352-b802-5b35bb4b642c)| +|$(ID:b3e6ab73-aed9-4ef6-a52c-3512621e0f39)| +|$(ID:80711f85-a66d-4ec1-b075-767b0af0b22c)| +|$(ID:28cdc208-8f89-4f83-b55b-9fd96325f5b0)| +|$(ID:e9298aea-9ab2-48fe-a8c4-a70fb1587b8c)| +|$(ID:cc8aeb34-e7c4-42ce-84fc-6bf9148de3d4)| +|$(ID:865d5d56-2fe4-4dd1-a86d-2c4c85c2a9a2)| +|$(ID:5df4e006-d83f-46b3-a9ae-1b4c0e5d23ac)| +|$(ID:ae153145-8281-4a05-98e2-f4df43ae5192)| +|$(ID:37356dfe-4996-4599-82bb-4cbbaa7e9288)| +|$(ID:86ebb823-ff4f-4538-9a94-6e9d1f48b69c)| +|$(ID:509e8383-69f1-451d-a0e3-e7a7347697b3)| +|$(ID:15396be7-ecb8-4ae3-a6f6-6c3bf440f9b3)| +|$(ID:139e0170-85fc-490d-b750-6f4d8a17eb4c)| +|$(ID:7d038434-d432-4b19-9efa-d70ff2e12b59)| +|$(ID:8d2abd4d-540d-4f9f-acec-680a320e127f)| +|$(ID:26326c2e-6055-4d39-8bb3-3c816563f163)| +|$(ID:05970c07-64e9-43ac-abb0-e9184df1e48f)| +|$(ID:e14dc308-26d3-432d-8e92-f19c750e1b46)| +|$(ID:57b5ee9a-75bb-46fe-89e0-3d4bcc49e755)| +|$(ID:4238101c-5b23-4fd8-b73b-fbff78620017)| +|$(ID:0157af03-ae26-4b30-aa61-7021329f0baf)| + +### $(ID:f0f325c6-2b40-4229-9ba7-f9871c40f691) {#Papenmeier} + +$(ID:2a23f637-6a85-4eea-b35b-0e265cd1e251) + +* $(ID:25260a3f-e6e2-4b84-801e-b5dec0d58e5f) +* $(ID:cbea6563-e135-4147-a4ac-19e064a71dea) +* $(ID:4858eafc-4b95-4b7c-ac5f-325c86d3599c) +* $(ID:8547c33d-7804-41b3-9f6c-669271637628) + +$(ID:7ddf09b2-0501-41f4-adc2-45702c98bcbb) +$(ID:a3c57a2a-bad4-4edf-9e38-431134b626f2) +$(ID:6e8bb496-8377-4af9-abec-7c0c30092b10) + +1. $(ID:c0b7fe2a-8ca7-4ee5-8729-61e8678171d0) +1. $(ID:a4378adc-76bb-43d8-bd13-4492b59ffffe) +1. $(ID:8432bb02-136f-4350-894f-07409ce84dd5) +1. $(ID:7e19009c-f8b9-4288-a6d5-bdfec25e46ec) +1. $(ID:cdf5dab3-7cda-4318-8ded-2c427afdae1b) +$(ID:ff4087a9-6636-43aa-9408-a4aff034a94d) +$(ID:fe0cddf3-be69-43e3-805d-1e4308fc52a1) +$(ID:52438f6c-d7e8-4116-afb9-76f3b44e6c5d) +$(ID:1a01ffc5-618a-4cfd-ad8c-7af84c92e99d) +1. $(ID:2461a481-277a-4803-8234-d00a893b0979) + +$(ID:2d0b19a0-5ea1-4f45-9e0c-bca1229f5059) +$(ID:62e2f006-9a12-494e-a672-5161691d9fb6) +$(ID:647f4c2d-f05c-4a3b-a8fd-533b16079e39) + +$(ID:84d4ad69-a24e-4b2e-9cee-ac397a79765a) +$(ID:7ff824e2-8779-46b3-a8aa-b4945f2d2897) +$(ID:f83400d8-385a-4cc9-be28-076975bf023d) +$(ID:3b972ded-b176-437f-ad33-fc2db1562c4f) +$(ID:d195c5df-c4ee-43dc-ae4d-d1ac8a428c62) + +$(ID:02ffea21-29e9-4033-bcc2-b65237eeec89) + +|$(ID:3131c75c-6b95-4d38-ab35-cd38582c6439)| +|---|---| +|$(ID:f5f477af-4e20-4a0f-b534-62d13d593ffe)| +|$(ID:9959f712-dc12-473b-89ce-de2d5f7c107e)| +|$(ID:0d7d50f6-bfb0-4ce9-abc3-d5dcd9ec9eea)| +|$(ID:f94c4c09-84ac-473f-bcbe-13e21b4cd60a)| +|$(ID:161fc17e-74f7-487a-a5a5-9c94cc7f8342)| +|$(ID:34535c2a-c178-4868-95ea-de8d7bbecc29)| +|$(ID:d9000db0-b759-4de9-a8e8-5e3250662368)| +|$(ID:91e5d524-0c58-4dc0-bceb-7e583a2fda8e)| +|$(ID:ffe8c2be-c72c-4a92-800c-f17548627dbe)| +|$(ID:8317e0b0-071d-41a8-9b02-2f7a19d186cd)| +|$(ID:5bbcb197-f88c-49ba-ac9d-5e849015fbc1)| +|$(ID:f2a48899-b0d4-4b00-b3e4-312a9c2c3068)| + +$(ID:f24b810b-dd13-45c7-bc05-db6ae0422ad2) +<!-- KC:beginInclude --> + +|$(ID:544699d3-3874-476b-b9c2-1a3d7fc43aef)| +|---|---| +|$(ID:febcf96f-95e8-4719-8731-1c215e3df59e)| +|$(ID:090096eb-c7ab-4f82-ac2a-6c9003c14dca)| +|$(ID:2f06f7ec-51be-49c7-aaf2-528e97b02371)| +|$(ID:73333590-1bd2-44f1-82d7-d0139bdc937d)| +|$(ID:0031bcf8-362f-4cd0-9d9d-0f27b2bd6dd9)| +|$(ID:3f59af2b-f8ef-4f2d-8c03-586ab93d5327)| +|$(ID:4ad7bb74-2456-416b-b3e1-51d30233d77f)| +|$(ID:77c6f9c3-305a-454d-b2aa-be1b35572ef4)| +|$(ID:2ccd6051-f8e6-4e0e-8d34-104a3c9b671f)| +|$(ID:faa1d522-99b6-431b-a882-25671c8b8ea0)| +|$(ID:c3f30c79-773e-4b0f-b350-f7790ee02e03)| +|$(ID:34007882-6e41-4674-9b7f-657533ce00a0)| +|$(ID:2a325c71-cd95-4c99-bae0-d2b1d5831842)| +|$(ID:e0ee4e01-d0ff-47c8-b1c9-3b8180785dc6)| +|$(ID:8fb2c630-18fa-46a0-a6b1-3d24415894fd)| + +<!-- KC:endInclude --> + +$(ID:0faf4053-caa9-44a8-b2c3-3dd2a44b408b) +$(ID:e08bace3-86c1-4748-8d67-49a712a80919) + +* $(ID:d94b61f8-be01-4a2c-a501-1ccf4257cb56) +* $(ID:5588e099-6dae-4084-84db-59963b1c053b) +* $(ID:76887897-4e5f-46e3-8664-69dbc9b19342) +* $(ID:5ced654c-6298-444d-91e3-877f5829d151) + +$(ID:fb3e5ae0-8c9d-48a8-95c4-3f3fff1e5384) +$(ID:57aeca3e-1aad-4179-aa42-4b613369c58f) + +<!-- KC:beginInclude --> + +|$(ID:044252aa-6608-4a9e-8051-476af4f92a8f)| +|---|---| +|$(ID:f73700bf-3706-4c1f-9fe4-ca8749c64352)| +|$(ID:b44a4ae2-1f04-467e-8086-fb148d1a8133)| +|$(ID:6dec7566-2958-408c-b023-97fc676b51fa)| +|$(ID:6c4c6dc9-0226-4554-be04-64391eedeeab)| +|$(ID:efcf5d4b-2cbe-4385-8ad5-5947fa8ae05b)| +|$(ID:aea9fd70-1375-434a-859f-2baf64150cb4)| +|$(ID:f01b7e65-89eb-40e3-a1ee-c217d41f760b)| +|$(ID:0df1fc89-0f0a-4856-b7f5-5ac130c8eb7e)| +|$(ID:bdb3eb0e-7588-45ac-974c-e8948d028729)| + +<!-- KC:endInclude --> + +### $(ID:da496fdf-d531-4783-aca2-ff0288687bcc) {#PapenmeierOld} + +$(ID:fc84df48-f78f-444b-89c8-61c2a986a8c7) + +* $(ID:7a7853ae-9d19-48b6-9c5f-8f9a3f4f057c) +* $(ID:7449a4e4-3f37-4e7b-8ea7-3991eeaf1003) + +$(ID:cc373aeb-e38b-4ed9-9f6c-87eb8401d2a2) +$(ID:665a32a0-1150-4682-b6a3-ec3ce14ed46b) +$(ID:ccd892f4-842c-40e1-bf4f-9e1e3bf50a55) + +$(ID:1b53f219-a422-457e-8f53-1fd83059fdc8) +$(ID:99798924-a899-4483-8bc5-5dfd46e14df0) +$(ID:08bc0a95-9f75-442c-9f0f-1b7ef80af738) +$(ID:c10b1e55-7d0b-4db4-848e-aab6a4db053f) + +$(ID:66b462bc-40ab-4e78-8d6b-767d43c24312) + +|$(ID:5d2ecdd3-4c99-494c-98ae-9d048d9f0643)| +|---|---| +|$(ID:8967c5e4-e81b-4ad8-b3d5-69c7fbb0d3bf)| +|$(ID:a313a9b1-dcf6-41ef-ac8a-eac9915c0b4f)| +|$(ID:7bee81d2-1a25-4a2d-bc38-8c777982ea28)| +|$(ID:64f14a1f-ffe0-4912-8a0e-35fed4167b4a)| +|$(ID:15ecea7d-52d8-47b8-a310-936d182e2d99)| +|$(ID:eb47617c-092d-4acc-8a1b-9c1e69a85b5b)| +|$(ID:4860c76f-89b3-4fd8-8bf8-09c533c0ee54)| +|$(ID:12cb31ae-c0f7-4f02-a6e5-aaf2e8cc0ef4)| +|$(ID:c3c1dec8-2007-44e9-8a2c-7d9baf25e49b)| +|$(ID:7833fe23-8196-416d-a31f-9947e454db49)| +|$(ID:69cd175e-6301-48b5-b9c0-de9531b9be80)| +|$(ID:1b3d32c5-2891-45b7-a652-21ee1736ff55)| + +$(ID:476197f1-6996-4d0d-ac35-a0dcb31bf418) + +<!-- KC:beginInclude --> +$(ID:fc63a7e8-fa74-4fad-be52-f4b27fedc989) + +|$(ID:c14925e0-5a74-42ea-a483-c979f0f02b50)| +|---|---| +|$(ID:99639052-fa04-44ac-8bbd-0c0f42a7137a)| +|$(ID:4b2ce5ba-5b6b-4ae2-84a3-c8f48fe820fc)| +|$(ID:f9a05ea4-f118-4a70-af08-54b773291269)| +|$(ID:dac4446d-9fd9-4fbe-845e-e9900bee4a0e)| +|$(ID:da50d9e0-c087-43ce-8a1b-eacc31e86821)| +|$(ID:4cb1430d-7d3f-4c36-bd66-41f32d7ec705)| +|$(ID:36df6239-f52e-4363-9988-a6c43229e503)| +|$(ID:af632660-7b23-4d88-91fa-b5e0c570d62d)| +|$(ID:333fe9dd-85fb-4dde-8b9a-e55294f70768)| +|$(ID:9295ed2c-7bd9-46b2-aa96-f73686664e3f)| +|$(ID:72fd425c-2fce-43bc-870e-0e2e2e079acc)| +|$(ID:2dbbd370-5ecb-4fed-a621-041af1a2e6be)| +|$(ID:7ba4ef68-7dba-4a2b-979e-4dde394a49bc)| +|$(ID:b5cd6974-40fc-46f3-87bc-332f252ac2b8)| + +$(ID:a4c50842-e454-4d4c-9a50-7f487c833625) + +|$(ID:fd3ef879-3af0-4e41-a76d-d3c93221e4a2)| +|---|---| +|$(ID:14e7511a-8bb1-424e-8ba1-ab2e34cd1d03)| +|$(ID:84d18f57-8a8d-4449-b4b3-feecf9d6d193)| +|$(ID:0d571f1a-d6cc-4a80-90c4-d7758848d2ad)| +|$(ID:f87bdcc8-0368-490f-a392-44e669b0620f)| +|$(ID:1f244fc1-9d2f-41f1-9cb4-0b498959e8d8)| +|$(ID:835593ea-a28f-4309-9b99-df4055d9249a)| +|$(ID:95171659-fde2-4443-bd4e-cfc25ba2b959)| +|$(ID:dc23de25-eb33-453f-9def-a5e28fdb174b)| +|$(ID:311d303f-628c-48a0-8c79-8810943a137e)| +|$(ID:ca11f17e-dfa7-4133-b034-c5f60d3dc446)| +|$(ID:227ae001-25bf-496f-b61c-8d387fe72be9)| +|$(ID:77527673-504c-4e1d-b904-2d285e26fd56)| +|$(ID:7b58f475-8504-4ab8-861d-047235e20f87)| +|$(ID:b8a4a80e-e1c2-416d-bc1a-fe16f4247c2a)| + +$(ID:d7a5fec0-9eef-4e7c-876c-2fd6d52b88ec) + +|$(ID:d5f44033-7cc6-40e7-9777-b90982cf639f)| +|---|---| +|$(ID:1a333408-09f2-46bb-a55d-a789a696b2ac)| +|$(ID:1bcb729d-0de5-4d90-b335-10a19ec8b460)| +|$(ID:8c489735-88ea-4486-8296-9161ef926f16)| +|$(ID:a02910db-d422-44c0-94f0-1e24f9e509e8)| +|$(ID:4945f837-96b5-4d7a-877c-75b62b96ac1d)| +|$(ID:86c044f8-6a10-4a06-8c9a-adccad62d885)| +|$(ID:7a16649d-0c48-45b7-95f7-a08c0b487303)| +|$(ID:8637e532-8e29-4a76-bac9-37230656f07b)| +|$(ID:72af10d8-f2ab-422e-ab89-e959a374ba2c)| +|$(ID:fa2705c8-2054-45fe-8dd3-8630111680c4)| +|$(ID:b9b24094-f329-44b1-bda6-19551fd23444)| +|$(ID:0288b9ad-be02-4393-9cb5-f28771b4812c)| + +<!-- KC:endInclude --> + +### $(ID:998222a4-d1b3-4c30-b328-53963265ac6a) {#HumanWareBrailleNote} + +$(ID:bb02fa0f-50f7-4d9e-a05b-2b65503649c4) +$(ID:84484648-68a3-4c05-9e64-bb767fc965b7) + +* $(ID:cedc7838-a27c-4cfa-83f2-38a6f509e668) +* $(ID:aae65691-9ce0-4827-9c00-aaeb2f5de4a2) +* $(ID:1148904e-7c90-4456-bfb3-deba39ced68d) +* $(ID:c6faa94e-1c1a-464d-a173-014962bed670) + +$(ID:69a2ac86-bc48-4f15-a7a1-50d05601af46) + +$(ID:6d556bc3-5777-4a38-bff1-18bde7cbb8e2) +$(ID:91e2456b-339c-4da7-9a01-ab68372ab717) +$(ID:bb33c69b-1699-4a53-a74b-839d2580fe0e) +$(ID:becaf94a-3bd0-426b-84b4-fc49d978188d) + +$(ID:8c9206eb-f38e-4c4f-8744-ef7380c4ae57) +$(ID:5092f576-fe44-4d21-b786-3cf28a4fd0dc) +$(ID:0fbd8cdc-7616-485d-bb3d-57f603222ec0) +$(ID:8a81dab5-dcbe-4576-a34c-ad9707f26c08) +$(ID:7cbe09fb-9cae-45b3-8b0d-d8c0f39f2c56) + +$(ID:d40fc624-8353-46df-85e1-870582e1c826) + +$(ID:c83931c1-9726-4d97-ab50-6eac4b21f949) +$(ID:3d263de5-75cf-4ae8-b6a1-704b55487642) + +$(ID:5587b1a5-60b3-41ef-9fba-d0a3eeb84434) +$(ID:04348651-af3e-4191-8640-a4dd2aab39a5) + +<!-- KC:beginInclude --> + +|$(ID:532720ab-42c8-4c89-ae43-acb2ae1ebc33)| +|---|---| +|$(ID:e0367b16-717c-4abe-86fd-9e023492f1b0)| +|$(ID:965047ac-9653-49a9-ba66-3ce938e5983a)| +|$(ID:69d4890c-b037-48a0-8bd5-265ad7f84f36)| +|$(ID:30214d06-58f5-4895-b9d8-6398fda580f3)| +|$(ID:24e87d8d-8ae4-4c95-9212-7b38686a29fa)| +|$(ID:567e7146-4957-4d8f-88cb-551263386be2)| +|$(ID:e24d98c8-bc82-40b7-ad39-4e99c11ca36f)| +|$(ID:bdad4801-431a-49c5-a44c-9cbdf5d46800)| +|$(ID:e7bfa2d8-c15c-47b0-927c-af2a4dc26f8c)| +|$(ID:8e70131b-ae41-42cc-a219-31514275ac65)| +|$(ID:682a75f3-528a-4791-8891-89faceb39f7f)| +|$(ID:c9264da3-8fc7-4c11-8ee2-b7083e0dc569)| +|$(ID:894c26f0-dcb1-4df7-b9db-6de17934aa0c)| +|$(ID:701b470b-33f1-4a34-a2cd-de1f94557432)| +|$(ID:751c98ca-3248-4e59-886f-5a1cca2c483c)| +|$(ID:e4aa38c7-cda9-4d03-9e1a-f73e2d7ace34)| +|$(ID:44ca17e2-05cb-49c4-9efb-4b28b364bdfb)| +|$(ID:ca368064-9dc4-4d7d-b91a-080d6f5c452f)| +|$(ID:8bd1ba9b-0796-4a46-9802-735f8c1e6a1b)| +|$(ID:d8eb399a-8e6b-4daa-9410-deca0713da77)| +|$(ID:ed6e2881-215f-4b1c-9e2a-8d88bbbfb025)| +|$(ID:11ed79be-418d-4d4f-99af-fbc655a22d2c)| +|$(ID:cf2747a5-fb6f-4a5e-91cb-98682b266a58)| +|$(ID:87337360-26e7-4d26-8ae7-daf32c1ae30f)| +|$(ID:d909cb56-1a3a-42af-97d2-9da7372d7b87)| + +$(ID:3408b648-0ee5-44f0-954f-5930bdeffd47) + +|$(ID:71aa34d0-9482-4e0c-81d3-3e3c86b2dc68)| +|---|---| +|$(ID:de46c008-47d0-4133-a2d8-9c9742ad196c)| +|$(ID:8eaad605-9a75-44a8-9dfc-6d6ba96eadf0)| +|$(ID:2d405d7b-1e04-4829-be91-17310333c8e5)| +|$(ID:0007e16c-8e92-4507-b275-f542dbdbc1fa)| +|$(ID:64e6dea7-b9be-4b59-8bb7-b4789b40609d)| +|$(ID:23c10d52-6fa4-4437-b9a4-ca907903f9c8)| +|$(ID:099ec524-ef0b-4632-96b3-762347194cbb)| +|$(ID:800d9a5c-56ab-4268-92d5-e3f5f69ec374)| +|$(ID:a05192be-a601-4651-945c-d5670106aa68)| +|$(ID:82b56604-4f47-4208-9b28-408511331024)| +|$(ID:feec004b-a29a-453e-b563-19200595ee22)| +|$(ID:8d68921d-a035-4fff-b152-34595c8b32ad)| +|$(ID:b8c9c827-43e7-413e-bb9a-4d71ca6d760a)| +|$(ID:87ba79a8-3e76-42d5-b15d-745fef0b22a7)| +|$(ID:e89d5e73-5b17-46a5-a920-b500640b2af5)| +|$(ID:54e0079e-cd1d-4012-b1b7-bd57ff6ae77c)| +|$(ID:7870571b-7d6c-4997-a662-f1730db3f4a1)| +|$(ID:3089d83e-2fac-4bd0-aace-9d6def630c80)| + +$(ID:51975a7c-26d5-43f3-9786-30676efca191) + +|$(ID:b4fc4da8-a5fa-45ce-899a-221d40ce404c)| +|---|---| +|$(ID:2d6ff54f-c45f-44af-8174-276083b9552e)| +|$(ID:baf88889-14ec-4ef4-b5e9-4dc6d9d211a1)| +|$(ID:c4786c07-529f-47bb-addf-91b21d0530ef)| +|$(ID:12873afd-b936-4bc4-a255-6d80dca05887)| +|$(ID:b52a9f7d-83f6-4a70-b1e8-fb66f444f93b)| +|$(ID:a78c3805-473a-4fa0-aee0-46168e423ca4)| +|$(ID:f7227f17-354b-4358-80fc-7e1c71d9898c)| + +<!-- KC:endInclude --> + +### $(ID:3e832d94-ce59-40cd-a2ac-e10429df71b2) {#EcoBraille} + +$(ID:253d802c-abed-4f51-b12a-f02c61be1289) +$(ID:67e0cc5c-8e14-4aa0-af7d-e83b4eaaad74) + +* $(ID:f3893bca-9580-4944-9ee9-0aebd6b1e88b) +* $(ID:9954728a-a957-4d71-a41f-55349d7b6968) +* $(ID:f619c713-9fe1-43c3-b202-93217d684921) +* $(ID:27211744-59f9-46de-81bc-031bca94fccf) + +$(ID:fa861759-efb6-4750-a80d-2bd2bb62cde0) +$(ID:3b6b60cb-58cf-4a7a-a18a-c4b86be9f0ee) + +$(ID:f2cfae5f-2986-4280-8a97-e9520cb380de) +$(ID:1a622937-a4ab-4a72-a842-171d940399ce) + +<!-- KC:beginInclude --> + +|$(ID:3c28cf67-2b4d-417a-887a-a95e968cb293)| +|---|---| +|$(ID:b70196d5-7036-4844-9af6-3c90f7b0b883)| +|$(ID:e096cefc-9a69-411e-991f-718ef9a86a72)| +|$(ID:9c24f0b3-2ea9-4d2e-b2df-10bc576115e3)| +|$(ID:0bdc451f-7965-46fc-a14b-40355df20f65)| +|$(ID:c35d4fe2-a876-4009-bb27-db4f9b34a4b1)| +|$(ID:b3ea9364-c0ca-494c-bb0b-9c7f61ad3220)| +|$(ID:4e6de57c-0a09-4ff8-b77a-38efd6fcdfd7)| +|$(ID:95a0138a-4f4c-4d6d-a274-015fbf780a5f)| +|$(ID:c367725e-460c-4e3d-b1ce-182d22f8f2ad)| +|$(ID:b97c9b2a-c003-40e2-9b45-2f7d40a6b7f6)| +|$(ID:0b52a324-1d96-40a1-81f3-cba81cbaa81b)| +|$(ID:f4ad0be6-7cfa-4d0a-9d50-694ec78a5380)| +|$(ID:832e1103-2767-4da5-aadd-65aa00bb19c6)| +|$(ID:2d2685e2-3495-44db-a1a7-1c22afc75a47)| +|$(ID:eb121236-2e4f-4b99-b2b1-7f01aa0c4e9f)| +|$(ID:0f81e010-10e8-4c73-9cdf-53af4031e0af)| +|$(ID:bb6fbefc-aa87-489f-84d6-3b8dfdf2e079)| + +<!-- KC:endInclude --> + +### $(ID:3b53254e-8658-4ca0-806d-ebb3651237ce) {#SuperBraille} + +$(ID:67944921-eee9-4466-b47b-4acb050c3318) +$(ID:977e2e08-22e1-41e2-9368-43ad7431e3e4) +$(ID:ce4c5bf3-9bad-4761-af09-7c57db3798d2) +<!-- KC:beginInclude --> + +|$(ID:0cab72b0-699a-4330-96d0-76d67d8f30c8)| +|---|---| +|$(ID:b4ef4bc2-3d9d-4052-849c-7c015f6af1da)| +|$(ID:f05f8cf5-35b4-477c-be50-bad046b9febf)| + +<!-- KC:endInclude --> + +### $(ID:fcab1dae-0caf-4e65-be83-52d2b93adb4d) {#Eurobraille} + +$(ID:143e78d1-bfe9-488b-93fc-d312ae05eded) +$(ID:d0703b72-a5d9-4961-85c0-322dc8e4b93b) +$(ID:1d4d7834-7eb6-4a36-b18c-7d498c854aad) +$(ID:d7287795-f593-4ef7-ad8d-6d1993a8300f) + +$(ID:01bf6633-fe8a-4d12-8c65-248d212e900d) +$(ID:7db00ae9-27d9-4e8c-b795-f9919cd47ba6) +$(ID:84ecee65-a88d-48c8-b7fb-0b77795b7715) + +#### $(ID:baddad85-5a7e-409f-95b3-ab243e776a12) {#EurobrailleBraille} + +<!-- KC:beginInclude --> + +|$(ID:c68523f2-fc3b-4fc9-85a2-2a34388b420d)| +|---|---| +|$(ID:4d6b0e27-2fe7-4edd-a570-a0de2b8efb36)| +|$(ID:50de5c27-a6b3-44aa-a0c3-6c8eeec3a7a0)| +|$(ID:9efba395-0172-4a38-b911-c612bbcedb3a)| +|$(ID:793b5c5d-c639-4ad8-b2cf-183d2211463c)| +|$(ID:3920b7ab-81c2-482c-8dac-a0b1605c3633)| +|$(ID:6aff9335-295a-4e24-94ce-c887333201a4)| +|$(ID:9cb9e339-59ea-48ff-af51-082d0090d0a0)| +|$(ID:78cb9ec0-6f5d-4979-aec2-77c5adc773dc)| +|$(ID:d1164c84-ab76-4278-bf76-75aa9e82752e)| +|$(ID:bd4fbae6-5d44-42d2-93e2-5c41a711b58b)| +|$(ID:5a418a2e-a422-46ab-a351-1038cc5c7417)| +|$(ID:92b2f401-2eaf-4fb7-908e-cc2d012f98fc)| +|$(ID:8ea9b667-e066-4883-adb8-ce1e1ae13d2c)| +|$(ID:9c0265c2-16d4-4be9-8f25-8be0f5632384)| +|$(ID:05173fd6-6a28-469c-9177-f9134d1ab9c0)| +|$(ID:16069a5d-4815-47e6-b0fd-d01016c8a3db)| +|$(ID:73a3f92d-295f-42dd-9aab-8dab97318e7e)| +|$(ID:b1d91cd3-cf3c-4da7-8106-9a6fc71ed635)| +|$(ID:31b6ebcb-ea58-432f-9260-e207af21ee2f)| +|$(ID:ea97b838-352c-42ed-999e-974741fbe0db)| +|$(ID:d9aeaf30-e5ed-4c02-a32a-c4905dd517e5)| +|$(ID:4be30c76-01e8-40ca-8c19-8fe61c3eca02)| +|$(ID:07947999-e40e-4809-8ae8-bae840c96246)| +|$(ID:2de5ec06-13a9-4693-a7a9-c064c1a3088a)| +|$(ID:5da77593-b36d-46e8-8bcd-79e6b2f8549a)| +|$(ID:f23fbc1d-ee2a-4944-ae92-26968646d8d4)| +|$(ID:2bffadcd-f046-40d8-aadb-9e025c93cdf2)| +|$(ID:93c1e032-72f6-47bb-9ed5-2b5e327c993a)| +|$(ID:b31c06e4-2a7c-427b-991d-f6e8752487b6)| +|$(ID:656b1e23-8be4-450f-959d-4db8ec0b17d0)| +|$(ID:3fa80fb5-b0fc-40c3-9bdb-a0bcc9780db9)| +|$(ID:d37623dd-dc0b-4fed-b280-d53ae085bd91)| +|$(ID:67b72719-0f1f-4c71-bf29-ecfd3a3d303b)| +|$(ID:4b4cc812-686a-4ec0-9b76-22876acdc502)| +|$(ID:ce0386d9-040e-48f2-8c89-a5b44e0b294d)| +|$(ID:e189a5cb-a7e6-4204-90cb-9d7c35c8f280)| +|$(ID:7c3e9d02-7316-4048-ab45-fbbd05f73050)| +|$(ID:b677ad2e-eebf-4635-8040-710efb4d95ad)| +|$(ID:b0669640-0f59-41c0-9924-29d0485c2944)| +|$(ID:d49ee23b-16fa-4774-bfa6-928cad3be7ff)| +|$(ID:39579a2e-4dd5-4ed4-a1e4-1c491d898291)| +|$(ID:8949810d-cd7c-4bc3-8165-0a7a64706fbd)| +|$(ID:70ad8f7f-936f-4561-bdce-b1c22961ec00)| +|$(ID:76824657-318d-4826-bcb1-57051edcc9d5)| +|$(ID:9ce843de-4f2c-46ba-840f-14a296817f57)| +|$(ID:965c9711-2bb2-43a0-bf19-5ed15932ae5f)| +|$(ID:eb77e784-9fe0-4f18-a9a0-8e78ce0d830a)| +|$(ID:11e389cf-2f9b-4dc7-9bac-af69867e08ec)| +|$(ID:e76da39f-5252-4083-a2ff-258109304690)| +|$(ID:2478cf84-1d07-41e8-a989-ed0e1a55fa0d)| +|$(ID:bc1274e9-c5b9-442d-9ddd-ef22f5cb1085)| +|$(ID:b6283d26-a4fe-4e04-b4c5-052ddd2b11ee)| +|$(ID:6a1144ef-b692-4427-b7d3-d108c80dc50b)| +|$(ID:c6e42fba-1e58-483f-a31b-0a6d55b1f068)| +|$(ID:64ba28f5-d211-4d70-8ac4-0e8104d16513)| +|$(ID:1be265f6-e985-4248-8c3a-984295729ead)| +|$(ID:10216e7a-8378-470c-a3ba-066f74d03079)| +|$(ID:01c26ff2-0ba0-433f-8ebc-3e5f1c47cb53)| + +<!-- KC:endInclude --> + +#### $(ID:82859db7-9db8-4bfa-a85c-40f9a608e3b0) {#Eurobraillebbook} + +<!-- KC:beginInclude --> + +|$(ID:a1903ae2-9645-4e67-8b63-35da9dfa3aef)| +|---|---| +|$(ID:674e7fa9-180f-49a4-a21b-977bf05f78b7)| +|$(ID:54b9eb7e-e37f-42b1-91bd-b49a43a9a186)| +|$(ID:d78a0cd7-ef28-427d-9bd8-fe53ee99750a)| +|$(ID:b3fd1a54-a2e0-4ac6-bce0-69226e4a20d4)| +|$(ID:c579259f-ca69-429f-8a9c-20a5b5fbf817)| +|$(ID:48ff65ee-e840-4ee2-bdd0-9469104a6e98)| +|$(ID:e266f96c-8072-4cfb-82d4-fc16a932439f)| +|$(ID:bcd6207e-1040-4134-80a5-8c3587f894a9)| +|$(ID:b1a94cd1-da86-45f7-a0fa-4ac1574bd061)| +|$(ID:0da95c7c-1552-464b-b201-9030ba630ad2)| +|$(ID:ef531f7e-fb4c-4034-87eb-bac2b3cd387f)| +|$(ID:d61b2551-6842-48c7-a0e3-195e379cdcb6)| +|$(ID:aa8c5981-5f41-476f-959d-7070864fe48c)| +|$(ID:a0b018df-1768-4186-9a98-2553f99705ec)| +|$(ID:41dc7056-9b44-43d3-90a0-0b0366a4e5a9)| +|$(ID:bde98121-6944-4407-84c6-523d7d2ea25b)| +|$(ID:c0ac6f61-9ef7-47df-837e-cea4524c6725)| + +<!-- KC:endInclude --> + +#### $(ID:9b4901a4-edd7-489f-873d-3ecd32daf869) {#Eurobraillebnote} + +<!-- KC:beginInclude --> + +|$(ID:e9ef3c39-debc-41fd-9df9-69cf7c7231a5)| +|---|---| +|$(ID:119be364-c7e3-4814-8062-c5a556f97e22)| +|$(ID:22dc2fa7-d712-4599-ba53-cbbddb82bb1f)| +|$(ID:c3762448-4aa6-4d13-9806-0d11e617b216)| +|$(ID:18c1af70-1ca8-427a-9350-fe4248493159)| +|$(ID:96ba6954-1bbd-4052-86d9-9826a55b2988)| +|$(ID:ddfd9420-31f2-4353-943b-2d0c136cf4cf)| +|$(ID:9f65afeb-36b9-4361-ae66-7454ce9cd997)| +|$(ID:8feabcef-d46b-4552-b48a-a343793b4a2a)| +|$(ID:3f31ae73-506b-44e2-a255-c30d36b41ece)| +|$(ID:15c440ff-e66d-4f32-a665-8acdbda287ea)| +|$(ID:cfb1f042-5a75-4c71-9289-1a63054cb47d)| +|$(ID:b23789ae-97e4-4c7a-961e-0fb4d9da9ee2)| +|$(ID:9a4b64ff-80e6-4b4e-ac03-7d9b57c63462)| + +<!-- KC:endInclude --> + +#### $(ID:07bd8eca-ba86-4eae-b708-575312597884) {#Eurobrailleesys} + +<!-- KC:beginInclude --> + +|$(ID:e9d3ce90-c3a9-4b16-acc2-9d3dd5962927)| +|---|---| +|$(ID:091a9a77-593c-4ea9-9c42-6c820a3805ad)| +|$(ID:e17ef544-ca5a-4b0c-a45b-ef0d3af5d837)| +|$(ID:187effb6-9d9e-436a-9121-c2c603c78553)| +|$(ID:e5b00f71-5765-418b-a6f2-82f269d8dcd5)| +|$(ID:eeba28ea-d254-49d7-a1fa-f182052ac474)| +|$(ID:f2989d6f-02be-4b13-a8b0-a7524b58c48d)| +|$(ID:8e3b6de3-fc77-4f10-86ef-33c49e174cf9)| +|$(ID:bb1f977a-677d-44f9-a29a-5de9dd423322)| +|$(ID:ffb2fa19-3650-4f8f-8f5a-01fbb7435bb0)| +|$(ID:c2dea479-ac5c-440e-8a8f-8db5390a7ec0)| +|$(ID:baea6130-e336-41bd-91c3-9bac8e8946aa)| +|$(ID:b5191016-64d8-408d-9862-70a9cd53fd82)| +|$(ID:7fd5f7b2-1189-4cb6-a79d-ed96095332e1)| +|$(ID:ebe79c71-8a8a-4370-a6f6-83c6faaa2d0c)| + +<!-- KC:endInclude --> + +#### $(ID:65a042cd-0870-4711-abdd-0cf191681ce6) {#EurobrailleEsytime} + +<!-- KC:beginInclude --> + +|$(ID:8311e5cd-f51d-4afb-95ce-83815c0a8d94)| +|---|---| +|$(ID:98413f52-bee0-4b12-ab6f-3ceb1b7735e9)| +|$(ID:d695e1ac-dc2e-4f04-b9bc-5914dcacbcdd)| +|$(ID:c0d76910-6d26-406c-ae1b-877900ea5e51)| +|$(ID:9d9feb3e-3258-4f1b-9088-ed3f090770c8)| +|$(ID:a8ad7006-66a1-4e38-a5dc-fdb60646f474)| +|$(ID:eded46d3-e1a6-4473-b431-5c98b61dd7ea)| +|$(ID:2b1867b8-828d-40d2-909e-532891609a52)| +|$(ID:a631c93f-5250-44a6-b036-314606430f08)| +|$(ID:3a6eeee5-1b85-4ae2-bf5b-897b06f6f929)| +|$(ID:b7ce6990-dff9-4cef-8705-e432713b9af5)| +|$(ID:41a54516-b9f4-47cd-869f-5c2a6186972d)| +|$(ID:b840b22b-add1-47e7-a15b-a745e01d4423)| +|$(ID:78b05c66-fcc8-4c7c-a4d6-1f20893d95fd)| +|$(ID:6e35e0fb-4789-47ec-9d4f-a7310fc0e248)| +|$(ID:7ee65615-309c-42c0-afef-15659b8f9512)| +|$(ID:d7d21d87-fd49-4f40-8708-4a4c84ceeaa0)| +|$(ID:5edeac0c-caa2-4213-b3ab-33a89c5e1925)| +|$(ID:a717040d-f6e9-4bd0-8a4c-64d3a804c5e7)| +|$(ID:19e7030c-a38f-4038-b170-4522211aef8c)| +|$(ID:4649d18f-2704-4b5a-9e5b-290124fa3998)| +|$(ID:8a020999-e7b4-456a-a6c8-cfa607019de4)| +|$(ID:76f80664-ab88-404e-9956-4ee439fbf082)| +|$(ID:a65c7b5e-c314-415f-8572-e24d844a2cc9)| + +<!-- KC:endInclude --> + +### $(ID:60171e0c-4a4c-4d5b-8459-2f1792ad7a59) {#NattiqTechnologies} + +$(ID:56091faf-e1d6-4933-9cf9-4eb807099338) +$(ID:cb9ba315-06cc-4086-8f25-a15f878f6eba) +$(ID:341b0abc-5bbc-4edc-a6b8-77cccc0b6607) + +$(ID:71909139-63f0-4860-b7cd-b5cd62e4e0b0) +$(ID:7a0faebe-adf8-40c4-b215-c14e9ecbbc22) +<!-- KC:beginInclude --> + +|$(ID:334f3a41-e478-43c2-b6df-efc923c43586)| +|---|---| +|$(ID:325d7cbd-1dd5-4ee8-9f9f-e20ee9ba388e)| +|$(ID:95c7a0c1-fec1-41a7-b885-3108d21cc140)| +|$(ID:6523d259-f7e9-4050-bfc0-ca53403e0d1d)| +|$(ID:26d54a49-50a6-4c54-a55b-81a72ee22bba)| +|$(ID:8f136485-c691-4683-bf2c-f45bc17e5f9c)| + +<!-- KC:endInclude --> + +### $(ID:4f83de5b-8d1b-4031-aa48-f37e0e298f68) {#BRLTTY} + +$(ID:04f687c2-db6d-479e-ac5e-965ae532bc74) +$(ID:730cb5c5-8e7b-41f0-a14c-191304d093f6) +$(ID:7d39a60b-c5c2-4545-9627-5facb693857e) +$(ID:f9ee01d2-c147-41f5-8303-24baaf7d7c7e) + +$(ID:6f8e0a0a-a3f9-4592-85ee-5fcc4f73135c) +$(ID:e9c69d7f-c70b-4b18-baf3-c7c6fb4bae74) + +$(ID:75ae79f4-5d1c-4fa1-9ff6-00e3a7b66bdc) + +$(ID:26bb7ba0-452e-4a24-807b-4df890de8112) +$(ID:cde1faa3-5d2a-48fd-b630-ddf3f6a030c0) +<!-- KC:beginInclude --> + +|$(ID:dbed603f-6cfb-425e-99b0-6dc3627da684)| +|---|---| +|$(ID:cf71ec19-9aad-4928-b1bb-6bf3b2b4f16b)| +|$(ID:2c99f91f-8208-4be3-a5f6-16417cf6ff34)| +|$(ID:8fab3df8-2dec-4646-b609-9a543493b1fd)| +|$(ID:423d185a-7a5d-4aad-aad2-d5cc34b0283b)| +|$(ID:4e957dde-ec08-4982-8c41-d247e7fb99af)| +|$(ID:83114918-8a75-4ad6-8964-ae41669034ec)| +|$(ID:bc730f4c-133a-45ed-ad43-925d2eb9e7b6)| +|$(ID:96f95a3b-4d91-4b46-97a9-fd2925f4a216)| +|$(ID:85577197-1590-41b7-a79f-8a8b9c71fcdd)| +|$(ID:90e00f99-80a4-49b5-b456-76b8146647f6)| +|$(ID:4245db09-e3ed-4a32-8304-2a5742ca239b)| +|$(ID:2beacfd3-919e-483f-874b-636b900e92fa)| + +<!-- KC:endInclude --> + +### $(ID:c19f69a2-c69c-4629-ab2a-e2e17c1d6e72) {#Albatross} + +$(ID:cbce77a7-50ad-41c0-b901-b3329e4f3734) +$(ID:c1ae90b4-4e6e-454b-ac82-586a816775f1) +$(ID:94ef2bd5-3c0d-4dd2-a47b-2bd74fed9a17) + +$(ID:a87fb77c-a6e8-48f3-aab2-d8a8bdf9908d) +$(ID:21de53c7-c866-42a8-81f3-cbaaa1682bb3) +$(ID:47234509-94f8-4b10-83b3-fced19bf47c1) +$(ID:8895acc8-64f1-4c81-8868-6029150c6c3d) +$(ID:f443ced0-7ebc-4cda-ba82-0f02557da6dd) + +$(ID:8edaba24-5504-4828-a8b8-3251903b79e9) +$(ID:04124778-6f34-4e29-a003-46e98d70c8cb) +<!-- KC:beginInclude --> + +|$(ID:f5a3a737-2029-450b-9e01-4674051e550b)| +|---|---| +|$(ID:09712f03-aea1-4ca0-9733-982554c6f79b)| +|$(ID:37069627-0c66-4f4b-bb36-845f166dae55)| +|$(ID:672818f6-c0f0-4cde-8dcb-0de821a38705)| +|$(ID:0819ce53-8e78-483d-9fba-0cd454947f74)| +|$(ID:eead0db5-8896-4792-ae56-c2171e164c2c)| +|$(ID:062f0ff3-c07e-435e-8cfd-76a40190c5b2)| +|$(ID:f5481986-388c-47f8-93b2-5ed6ceb6e470)| +|$(ID:b44be3a0-115c-403a-ac76-971ec77a4027)| +|$(ID:7adeb317-1919-4bd6-a4ab-092b45cb6ad8)| +|$(ID:8bf15b3a-8884-4797-8a70-4db17f1ff738)| +|$(ID:3ebadcce-939f-4140-91b3-f835268d2778)| +|$(ID:603b0bba-fcbc-4aee-8ca1-c539a66d7137)| +|$(ID:5a590ce8-0cbd-4440-9b7b-97354522d9a9)| +|$(ID:cd4d4f54-920c-4856-9458-2a8f7f17552f)| +|$(ID:a4576f61-6b36-4504-bc07-c266ac4520d5)| +|$(ID:e17ac373-a7d3-492b-b8d9-1110d03cc317)| +|$(ID:33499555-6a3f-41a1-8759-193dbd4d19bb)| +|$(ID:4610510a-cdbd-43b1-bd45-1141b081bb87)| +|$(ID:e5c91e54-68f0-42fb-ba9d-85473683cd07)| +|$(ID:830779a8-20e5-4391-a03a-1ae1e92fd5b6)| +|$(ID:26d8f6ed-856e-4922-b367-371f0b5fd6b8)| +|$(ID:bbbd3001-0c57-4e0f-acf9-298003ace006)| +|$(ID:d52ebe37-6e34-4ae7-95c0-5b461087169f)| +|$(ID:0d002374-6054-4b18-a917-177025f6b5d8)| +|$(ID:31cfa400-3e6c-475b-9eae-da7a5bef6426)| +|$(ID:f1b83a75-70a7-48f2-8ffb-80185b0fd7fa)| +|$(ID:d9767463-65ab-4b6b-97d4-49fd408bd9b6)| +|$(ID:fa7fea5e-8355-44f9-abc5-c3fd6be32067)| +|$(ID:a9b57ee6-9440-4266-a8b9-13474f79e2ee)| +|$(ID:1d322f5f-599a-4ce0-83d5-6c301648a0c3)| +|$(ID:6e9f83fb-f8ea-4cf9-8442-f5de14b6c5bc)| +|$(ID:b2fbd831-d066-428b-b0a8-5de07d26d7fc)| +|$(ID:5d8f2345-5581-4615-a2d4-26377ea84ccf)| +|$(ID:ce06cc6c-0631-4794-b682-bfec83682a25)| +|$(ID:1e9cadd6-ceaf-48d9-b189-daa0ee0a3dcb)| +|$(ID:a804680c-ed6c-4b55-9cb4-cf9369ac4bd5)| +|$(ID:211c20be-a200-4d83-93fd-88d0737344ee)| +|$(ID:346db171-3aeb-4174-95fd-74eb801bd738)| +|$(ID:8473b8ae-5dda-46e4-bc9b-dc1919c2ea8c)| +|$(ID:94137f37-5ff9-41d3-a483-bdde437c4cae)| +|$(ID:be936e93-f037-4db4-ac90-7751b7aedb0b)| +|$(ID:56a7b41c-6440-4696-85bf-8c33b24a0a7a)| +|$(ID:4cba9cfc-a618-4b6f-be72-18b6d3db92fa)| +|$(ID:1d880dca-cac7-4dcb-9702-667048ef0d4b)| +|$(ID:4a984501-30f0-42ac-aebd-3c8955552fe2)| +|$(ID:ad863585-f31a-4937-bdae-f1f0ec1defb9)| +|$(ID:5d6687cd-063a-4969-b864-6fac54d99fa1)| + +<!-- KC:endInclude --> + +### $(ID:0475738b-d227-4c2f-bc1e-1c3cdcc9bb2a) {#HIDBraille} + +$(ID:7067e223-3419-48c0-b148-47088eb94dc6) +$(ID:5096fef1-f809-42a7-b9f9-7e9a0fde3ca2) + +$(ID:c48ccf8e-0899-4112-8699-f742af73305a) + +$(ID:dfbff090-4636-4680-b793-a171707206d4) +<!-- KC:beginInclude --> + +|$(ID:38b0ce97-39ff-4c69-a0d9-a10d8df81211)| +|---|---| +|$(ID:40a7ee5c-ab51-4727-a048-8abaf5b81d0b)| +|$(ID:1033dd7e-ea03-45cf-a49a-662cc379b97b)| +|$(ID:8e59d0e2-8304-4c3f-bbae-307beb84de56)| +|$(ID:2da4f244-8e9a-4d8d-8755-617bd598b7bf)| +|$(ID:1b24f63e-d2fa-4289-8f40-d007343ef784)| +|$(ID:9faded75-e601-441d-b84f-31c146eee082)| +|$(ID:a759f31f-2470-4d51-ba64-07b95150d322)| +|$(ID:938b38fa-689b-47ee-af82-d2f783abe3f7)| +|$(ID:bf63f77c-dbae-49c4-80ee-81fb995169a9)| +|$(ID:b16a9502-25ac-4446-b0b4-3247ccdaa4bd)| +|$(ID:8fa52aae-fc70-4ac0-800f-be1634ca128a)| +|$(ID:b859a283-db7e-42bc-b34e-e7771bcdb086)| +|$(ID:acc9322f-8975-402f-b92a-07be3076bcc6)| +|$(ID:fffc0e2f-d320-4154-b011-67270666ab9a)| +|$(ID:528de4f1-53b4-4117-8c1c-2b2771d798ce)| +|$(ID:2788db54-2eca-4d89-abe0-37fbc328b254)| +|$(ID:408a5fe8-55a8-4ebf-ad63-78f459ff4b0c)| +|$(ID:624c7742-7577-403c-b516-3147cefaf0dd)| + +<!-- KC:endInclude --> + +## $(ID:b4d61299-abab-4dd4-94f4-2b490bad7b6b) {#AdvancedTopics} +### $(ID:da24b43e-c608-488d-8f00-62ffeaf33b65) {#SecureMode} + +$(ID:fc49c73a-2a70-40b2-b574-2354aa8fc2fb) +$(ID:b2619b32-96bf-450d-afaa-2a50c7919975) +$(ID:c60016eb-9320-4124-bf88-a3723ef0ccc1) +$(ID:6b6e406e-ce7a-47c5-8b19-3efbe9184e1e) + +$(ID:b4ce64ca-421a-4ec7-a79d-7fe654ec6dc3) +$(ID:9cf5cc52-f515-4df5-97c6-4dd71139ab5c) +$(ID:d0254cd7-0c6f-4535-ba6b-c7370973cd50) + +$(ID:28c56c6f-fa59-4f7d-b83e-273cc7f0d53b) + +* $(ID:9f32c8aa-f117-4dda-8571-059ba142f579) +* $(ID:32f2a306-d7bd-4070-a7b3-9ba21c4e4084) +* $(ID:7661686a-91bf-40b3-956a-7dce1d124264) +* $(ID:27889a6a-826d-40f6-805e-55897489e773) +* $(ID:ca4e6b81-208e-4dbc-8113-1312319d93ee) +* $(ID:4ae4d726-7d09-4b4c-afd1-cc62d664bdb6) +* $(ID:69d7e2f5-6e08-470b-ab00-e1d93c2dd741) +* $(ID:fb4ca59f-2596-4c87-beed-f46c1db66a03) +* $(ID:fff3e573-5de2-4497-9cb9-c4716e192af1) +* $(ID:93f4d760-aef8-4bd5-9985-3171ea27e1a6) + +$(ID:66707e65-701c-45c6-b665-372858e71fd9) +$(ID:f4a9e1af-951a-481b-8114-634280623afc) + +$(ID:4da3f06a-9706-4cc4-aa43-88459facc977) +$(ID:82950557-9906-4ee3-b7ff-9bac0a9402ba) +$(ID:114bd925-6d42-45a7-b152-694ff0044cbe) +$(ID:4c37959c-ff9f-4a8e-9b2a-9ad0a0d63367) + +$(ID:e11af7d0-3ee1-49e1-af14-24e8889ecf13) +$(ID:0c89a385-5998-418e-8acc-c05cd44d1622) +$(ID:9780fa48-8152-4d7d-b6b9-abe93a7c94d2) + +### $(ID:f4557a93-7a76-4da1-b806-3546d29ae78f) {#SecureScreens} + +$(ID:68ed8951-b195-4f6c-b8a8-df2100ec4d40) + +$(ID:caf67e26-0962-41cd-b864-0a0447331d9f) +$(ID:78dd02a2-8361-44ad-8704-a4117d99ff18) + +$(ID:0627dff2-dc87-4db5-b4b2-77beb45ed1a9) + +* $(ID:8a351f19-de50-4f7a-b822-e5847dd3d990) +* $(ID:e3b19d57-fbe4-4118-a94d-fb89b667a617) + * $(ID:9494d8ef-d96f-47dd-b758-71df83f35d50) + +### $(ID:a8007df1-6160-404f-80d7-0e43900f9bb4) {#CommandLineOptions} + +$(ID:7bbfe6c1-6302-48b6-ad00-38806b14e8fa) +$(ID:8fd80ffb-c7f5-4c6d-88b5-cc86304133d5) +$(ID:3e3cba9f-be65-4623-b7bf-095a789f18a2) +$(ID:d721e642-ca83-4203-9757-120586ab09f8) +$(ID:f5e4441c-b2bd-4849-a67e-2a2125d932df) +$(ID:5e55f1d0-c7bf-4cb0-bfb0-84a1f53f6a84) + +$(ID:2a8998cb-e508-4a6f-98c7-38fc18363751) + +$(ID:60438193-409b-49f2-bdab-85b559732b80) + +$(ID:c3de3a82-3058-4ad0-98a9-8739723f942f) +$(ID:ccc057a3-81bb-4893-a01a-0b2302710f7a) + +| . {.hideHeaderRow} |.| +|---|---| +|$(ID:8ab809da-a242-4c0c-8938-a05be1eea8c4)| +|$(ID:f32bc7dd-fccc-4369-ab94-ba14b12d2192)| + +$(ID:bf46356f-86b0-4823-9633-5ee615482ab8) +$(ID:e8e13a3a-1b72-4509-ab1b-5a8ad727676c) + +| . {.hideHeaderRow} |.| +|---|---| +|$(ID:04f3b088-ebd5-46ae-b2d7-93af658eae02)| +|$(ID:46cbc1f5-d160-44e4-a8e5-c4f309b2df23)| +|$(ID:08c11520-2046-4011-beb1-83ac99d8d00c)| + +$(ID:531ae3d4-1e18-4f7b-b17e-f8d05be6d922) + +|$(ID:45951361-ccd9-4135-9cea-ed789e0d029c)| +|---|---|---| +|$(ID:3a184504-7de6-4c5c-b900-92bf448c7641)| +|$(ID:a566999b-6103-4007-a9f4-e187a19b75ba)| +|$(ID:81737584-542e-449e-8d9b-f1e0f1e9d5a7)| +|$(ID:3656aabf-0930-49ba-9782-5b50e8550850)| +|$(ID:9ab444d4-78f5-44f7-b0e5-1e34d897706f)| +|$(ID:8fd0f754-30ff-4384-beea-588b241fa1d5)| +|$(ID:b1f9cffa-a232-485b-9553-5b83d3e10268)| +|$(ID:5cefc31a-b733-4353-9033-c3b9602e6803)| +|$(ID:8267a102-9bc4-4c3e-a46f-38a56b351a64)| +|$(ID:8f4bd79f-8b33-4ed9-b566-e4482458b10a)| +|$(ID:50707ed3-cecb-44fe-bd55-df4d4881b7ff)| +|$(ID:db00661b-bc39-4184-8eaa-4184387ecddd)| +|$(ID:d7cd7445-af1b-4bc0-b413-651d84ad1396)| +|$(ID:bea70d39-8192-4ce1-b4cc-16f53ebdf6a7)| +|$(ID:3c1b5da6-8d27-4b52-9674-0663cbf771b3)| +|$(ID:f56ba2db-19d7-47b6-bba9-62c08b23bc7d)| +|$(ID:c55692e2-bb7f-40e7-84ea-b070001d3590)| +|$(ID:175551f5-2a78-40a6-9464-43f3fa70e95b)| +|$(ID:8cc69cd0-86c0-46a6-a9ab-13697b33dedc)| +|$(ID:fce95a72-ddf4-486a-ba2e-df6635fc9198)| + +### $(ID:56e9eb75-58e9-489c-8556-1270dca7bfb2) {#SystemWideParameters} + +$(ID:a95d5465-94da-4a19-bd35-921c52ac4880) +$(ID:bfaa2c46-d498-4846-99c3-e57b32ad5203) + +* $(ID:93da3bfa-4115-437a-b0ea-cb2f8afe13d2) +* $(ID:74438595-e170-4922-bf21-6b5e8727d78f) + +$(ID:f041ba92-f068-49a1-992b-db61cb9dca29) + +|$(ID:7e735ab9-a8f8-4c81-a693-6afae699b40b)| +|---|---|---|---| +|$(ID:bb735397-b692-4550-a8d3-fa05f2d0b26d)| +|$(ID:6673d706-85f5-44a9-8718-be6a3d5d0bcf)| +|$(ID:a2146e47-14b1-4277-a904-5e504d79a166)| + +## $(ID:3d1e7d32-87f8-44c4-9d66-9ba118aa69ca) {#FurtherInformation} + +$(ID:ac3c9cdd-a866-49d9-9b44-293c73e82def) +$(ID:9f0134a0-6d7e-42b4-a650-791dea8022a4) +$(ID:061d7d61-cfab-44b3-a92c-4e65cf63213b) + + + +line: 2 +prefix: # + + +NVDA NVDA_VERSION User Guide + + + + +line: 6 +prefix: <!-- KC:title: +suffix: --> + + +NVDA NVDA_VERSION Commands Quick Reference + + + + +line: 10 +prefix: ## +suffix: {#Introduction} + + +Introduction + + + + +line: 12 + + +Welcome to NVDA! + + + + +line: 14 + + +NonVisual Desktop Access (NVDA) is a free and open source screen reader for the Microsoft Windows operating system. + + + + +line: 15 + + +Providing feedback via synthetic speech and Braille, it enables blind or vision impaired people to access computers running Windows for no more cost than a sighted person. + + + + +line: 16 + + +NVDA is developed by [NV Access](https://www.nvaccess.org/), with contributions from the community. + + + + +line: 18 +prefix: ### +suffix: {#GeneralFeatures} + + +General Features + + + + +line: 20 + + +NVDA allows blind and vision impaired people to access and interact with the Windows operating system and many third party applications. + + + + +line: 22 + + +A short video demonstration, ["What is NVDA?"](https://www.youtube.com/watch?v=tCFyyqy9mqo) is available from the NV Access YouTube channel. + + + + +line: 24 + + +Major highlights include: + + + + +line: 26 +prefix: * + + +Support for popular applications including web browsers, email clients, internet chat programs and office suites + + + + +line: 27 +prefix: * + + +Built-in speech synthesizer supporting over 80 languages + + + + +line: 28 +prefix: * + + +Reporting of textual formatting where available such as font name and size, style and spelling errors + + + + +line: 29 +prefix: * + + +Automatic announcement of text under the mouse and optional audible indication of the mouse position + + + + +line: 30 +prefix: * + + +Support for many refreshable braille displays, including the ability to detect many of them automatically as well as braille input on braille displays with a braille keyboard + + + + +line: 31 +prefix: * + + +Ability to run entirely from a USB flash drive or other portable media without the need for installation + + + + +line: 32 +prefix: * + + +Easy to use talking installer + + + + +line: 33 +prefix: * + + +Translated into 54 languages + + + + +line: 34 +prefix: * + + +Support for modern Windows Operating Systems including both 32 and 64 bit variants + + + + +line: 35 +prefix: * + + +Ability to run during Windows sign-in and [other secure screens](#SecureScreens). + + + + +line: 36 +prefix: * + + +Announcing controls and text while using touch gestures + + + + +line: 37 +prefix: * + + +Support for common accessibility interfaces such as Microsoft Active Accessibility, Java Access Bridge, IAccessible2 and UI Automation + + + + +line: 38 +prefix: * + + +Support for Windows Command Prompt and console applications + + + + +line: 39 +prefix: * + + +The ability to highlight the system focus + + + + +line: 41 +prefix: ### +suffix: {#SystemRequirements} + + +System Requirements + + + + +line: 43 +prefix: #### +suffix: {#MinimumSystemRequirements} + + +Minimum System Requirements + + + + +line: 45 +prefix: * + + +Operating Systems: all 32-bit and 64-bit editions of Windows 8.1, Windows 10, Windows 11, and all Server Operating Systems starting from Windows Server 2012 R2. + + + + +line: 46 +prefix: * + + +both AMD64 and ARM64 variants of Windows are supported. + + + + +line: 47 +prefix: * + + +Note that 32-bit operating systems are no longer under active support. + + + + +line: 48 +prefix: * + + +Note that Windows 8.1 and Windows Server versions older than 2022 are no longer under active support. + + + + +line: 49 +prefix: * + + +at least 500 MB of storage space. + + + + +line: 51 +prefix: #### +suffix: {#RecommendedSystemRequirements} + + +Recommended System Requirements + + + + +line: 53 +prefix: * + + +Operating Systems: 64-bit editions of Windows 10, Windows 11, and Windows Server 2022. + + + + +line: 54 +prefix: * + + +both AMD64 and ARM64 variants of Windows are supported. + + + + +line: 55 +prefix: * + + +at least 500 MB of storage space. + + + + +line: 56 +prefix: * + + +at least 4 GB of RAM. + + + + +line: 58 +prefix: ### +suffix: {#Internationalization} + + +Internationalization + + + + +line: 60 + + +It is important that people anywhere in the world, no matter what language they speak, get equal access to technology. + + + + +line: 61 + + +Besides English, NVDA has been translated into 54 languages including: Afrikaans, Albanian, Amharic, Arabic, Aragonese, Bulgarian, Burmese, Catalan, Chinese (simplified and traditional), Croatian, Czech, Danish, Dutch, Farsi, Finnish, French, Galician, Georgian, German (Germany and Switzerland), Greek, Hebrew, Hindi, Hungarian, Icelandic, Irish, Italian, Japanese, Kannada, Korean, Kyrgyz, Lithuanian, Macedonian, Mongolian, Nepali, Norwegian, Polish, Portuguese (Brazil and Portugal), Punjabi, Romanian, Russian, Serbian, Slovak, Slovenian, Spanish (Colombia and Spain), Swedish, Tamil, Thai, Turkish, Ukrainian and Vietnamese. + + + + +line: 63 +prefix: ### +suffix: {#SpeechSynthesizerSupport} + + +Speech Synthesizer Support + + + + +line: 65 + + +Apart from providing its messages and interface in several languages, NVDA can also enable the user to read content in any language, as long as they have a speech synthesizer that can speak that language. + + + + +line: 67 + + +NVDA is bundled with [eSpeak NG](https://github.com/espeak-ng/espeak-ng), a free, open-source, multi-lingual speech synthesizer. + + + + +line: 69 + + +Information about other speech synthesizers that NVDA supports can be found in the [Supported Speech Synthesizers](#SupportedSpeechSynths) section. + + + + +line: 71 +prefix: ### +suffix: {#BrailleSupport} + + +Braille support + + + + +line: 73 + + +For users that own a refreshable braille display, NVDA can output its information in braille. + + + + +line: 74 + + +NVDA uses the open source braille translator [LibLouis](https://liblouis.io/) to generate braille sequences from text. + + + + +line: 75 + + +Both uncontracted and contracted braille input via a braille keyboard is also supported. + + + + +line: 76 + + +Furthermore, NVDA will detect many braille displays automatically by default. + + + + +line: 77 + + +Please see the [Supported Braille Displays](#SupportedBrailleDisplays) section for information about the supported braille displays. + + + + +line: 79 + + +NVDA supports braille codes for many languages, including contracted, uncontracted and computer braille codes. + + + + +line: 81 +prefix: ### +suffix: {#LicenseAndCopyright} + + +License and Copyright + + + + +line: 83 + + +NVDA is copyright NVDA_COPYRIGHT_YEARS NVDA contributors. + + + + +line: 85 + + +NVDA is available under the GNU General Public License version 2, with two special exceptions. + + + + +line: 86 + + +The exceptions are outlined in the license document under the sections "Non-GPL Components in Plugins and Drivers" and "Microsoft Distributable Code". + + + + +line: 87 + + +NVDA also includes and uses components which are made available under different free and open source licenses. + + + + +line: 88 + + +You are free to share or change this software in any way you like as long as it is accompanied by the license and you make all source code available to anyone who wants it. + + + + +line: 89 + + +This applies to both original and modified copies of this software, plus any derivative works. + + + + +line: 91 + + +For further details, you can [view the full license.](https://www.gnu.org/licenses/old-licenses/gpl-2.0.html) + + + + +line: 92 + + +For details regarding exceptions, access the license document from the NVDA menu under the "help" section. + + + + +line: 94 +prefix: ## +suffix: {#NVDAQuickStartGuide} + + +NVDA Quick Start Guide + + + + +line: 96 + + +This quick start guide contains three main sections: downloading, initial setup, and running NVDA. + + + + +line: 97 + + +These are followed by information on adjusting preferences, using add-ons, participating in the community and getting help. + + + + +line: 98 + + +The information in this guide is condensed from other parts of the NVDA User Guide. + + + + +line: 99 + + +Please refer to the full User Guide for more detailed information on each topic. + + + + +line: 101 +prefix: ### +suffix: {#GettingAndSettingUpNVDA} + + +Downloading NVDA + + + + +line: 103 + + +NVDA is completely free for anyone to use. + + + + +line: 104 + + +There is no license key to worry about or expensive subscription to pay. + + + + +line: 105 + + +NVDA is updated, on average, four times per year. + + + + +line: 106 + + +The latest version of NVDA is always available from the "Download" page of the [NV Access website](NVDA_URL). + + + + +line: 108 + + +NVDA works with all recent versions of Microsoft Windows. + + + + +line: 109 + + +Check the [System Requirements](#SystemRequirements) for full details. + + + + +line: 111 +prefix: #### +suffix: {#StepsForDownloadingNVDA} + + +Steps for Downloading NVDA + + + + +line: 113 + + +These steps assume some familiarity with navigating a web page. + + + + +line: 115 +prefix: * + + +Open your web browser (Press the `Windows` key, type the word "internet" without quotes, and press `enter`) + + + + +line: 116 +prefix: * + + +Load the NV Access download page (Press `alt+d`, type the following address and press `enter`): + + + + +line: 117 + + +https://www.nvaccess.org/download + + + + +line: 118 +prefix: * + + +Activate the "download" button + + + + +line: 119 +prefix: * + + +The browser may or may not prompt for an action after downloading, and then start the download + + + + +line: 120 +prefix: * + + +Depending on the browser, the file may run automatically after it downloads + + + + +line: 121 +prefix: * + + +If the file needs to be manually launched, press `alt+n` to move to the notification area, then `alt+r` to run the file (or the steps for your browser) + + + + +line: 123 +prefix: ### +suffix: {#SettingUpNVDA} + + +Setting up NVDA + + + + +line: 125 + + +Running the file you have just downloaded will start a temporary copy of NVDA. + + + + +line: 126 + + +You will then be asked if you want to install NVDA, create a portable copy or just continue using the temporary copy. + + + + +line: 128 + + +NVDA does not need access to the Internet to run or install once the launcher is downloaded. + + + + +line: 129 + + +If available, an internet connection does enable NVDA to check for updates periodically. + + + + +line: 131 +prefix: #### +suffix: {#StepsForRunningTheDownloadLauncher} + + +Steps for running the downloaded launcher + + + + +line: 133 + + +The setup file is named "nvda_2022.1.exe" or similar. + + + + +line: 134 + + +The year and version changes between updates to reflect the current release. + + + + +line: 136 +prefix: 1. + + +Run the downloaded file. + + + + +line: 137 + + +Music plays while a temporary copy of NVDA loads. + + + + +line: 138 + + +Once loaded, NVDA will speak throughout the rest of the process. + + + + +line: 139 +prefix: 1. + + +The NVDA Launcher window appears with the license agreement. + + + + +line: 140 + + +Press `downArrow` to read the license agreement if desired. + + + + +line: 141 +prefix: 1. + + +Press `tab` to move to the "I agree" checkbox, then press the `spacebar` to check it. + + + + +line: 142 +prefix: 1. + + +Press `tab` to move through the options, then press `enter` on the desired option. + + + + +line: 144 + + +The options are: + + + + +line: 146 +prefix: * + + +"Install NVDA on this computer": This is the main option most users want for easy use of NVDA. + + + + +line: 147 +prefix: * + + +"Create portable copy": This allows NVDA to be setup in any folder without installing. + + + + +line: 148 + + +This is useful on computers without admin rights, or on a memory stick to carry with you. + + + + +line: 149 + + +When selected, NVDA walks through the steps to create a portable copy. + + + + +line: 150 + + +The main thing NVDA needs to know is the folder to setup the portable copy in. + + + + +line: 151 +prefix: * + + +"Continue running": This keeps the temporary copy of NVDA running. + + + + +line: 152 + + +This is useful for testing features in a new version before installing it. + + + + +line: 153 + + +When selected, the launcher window closes and the temporary copy of NVDA continues running until it is exited or the PC is shut down. + + + + +line: 154 + + +Note that changes to settings are not saved. + + + + +line: 155 +prefix: * + + +"Cancel": This closes NVDA without performing any action. + + + + +line: 157 + + +If you plan to always use NVDA on this computer, you will want to choose to install NVDA. + + + + +line: 158 + + +Installing NVDA will allow for additional functionality such as automatic starting after sign-in, the ability to read the Windows sign-in and [secure screens](#SecureScreens). + + + + +line: 159 + + +These cannot be done with portable and temporary copies. + + + + +line: 160 + + +For full details of the limitations when running a portable or temporary copy of NVDA, please see [Portable and temporary copy restrictions](#PortableAndTemporaryCopyRestrictions). + + + + +line: 162 + + +Installing also offers to create Start Menu and desktop shortcuts, and allow NVDA to be started with `control+alt+n`. + + + + +line: 164 +prefix: #### +suffix: {#StepsForInstallingNVDAFromTheLauncher} + + +Steps for installing NVDA from the launcher + + + + +line: 166 + + +These steps walk through the most common setup options. + + + + +line: 167 + + +For more details on the options available, please see [Installation options](#InstallingNVDA). + + + + +line: 169 +prefix: 1. + + +From the launcher, ensure the checkbox to agree to the license is checked. + + + + +line: 170 +prefix: 1. + + +`Tab` to, and activate the "Install NVDA on this computer" button. + + + + +line: 171 +prefix: 1. + + +Next, are options to use NVDA during Windows sign-in and to create a desktop shortcut. + + + + +line: 172 + + +These are checked by default. + + + + +line: 173 + + +If desired, press `tab` and `spaceBar` to change any of these options, or leave them at the default. + + + + +line: 174 +prefix: 1. + + +Press `enter` to continue. + + + + +line: 175 +prefix: 1. + + +A Windows "User Account Control (UAC)" dialog appears asking "Do you want to allow this app to make changes to your PC?". + + + + +line: 176 +prefix: 1. + + +Press `alt+y` to accept the UAC prompt. + + + + +line: 177 +prefix: 1. + + +A progress bar fills up as NVDA installs. + + + + +line: 178 + + +During this process NVDA sounds an increasingly higher pitched beep. + + + + +line: 179 + + +This process is often fast and may not be noticed. + + + + +line: 180 +prefix: 1. + + +A dialog box appears confirm that the install of NVDA has been successful. + + + + +line: 181 + + +The message advises to "Press OK to start the installed copy". + + + + +line: 182 + + +Press `enter` to start the installed copy. + + + + +line: 183 +prefix: 1. + + +The "Welcome to NVDA" dialog appears, and NVDA reads a welcome message. + + + + +line: 184 + + +The focus is on the "Keyboard Layout" drop-down. + + + + +line: 185 + + +By default, "Desktop" keyboard layout uses the number pad for some function. + + + + +line: 186 + + +If desired, press `downArrow` to choose "Laptop" keyboard layout to reassign number pad functions to other keys. + + + + +line: 187 +prefix: 1. + + +Press `tab` to move to "Use `capsLock` as an NVDA modifier key". + + + + +line: 188 + + +`Insert` is set as the NVDA modifier key by default. + + + + +line: 189 + + +Press `spaceBar` to select `capsLock` as an alternate modifier key. + + + + +line: 190 + + +Note that the keyboard layout is set separately from the NVDA modifier key. + + + + +line: 191 + + +The NVDA key and keyboard layout can be changed later from the Keyboard Settings. + + + + +line: 192 +prefix: 1. + + +Use `tab` and `spaceBar` to adjust the other options on this screen. + + + + +line: 193 + + +These set whether NVDA starts automatically. + + + + +line: 194 +prefix: 1. + + +Press `enter` to close the dialog box with NVDA now running. + + + + +line: 196 +prefix: ### +suffix: {#RunningNVDA} + + +Running NVDA + + + + +line: 198 + + +The full NVDA user guide has all the NVDA commands, split up into different sections for reference. + + + + +line: 199 + + +The tables of commands are also available in the "Commands Quick Reference". + + + + +line: 200 + + +The "Basic Training for NVDA" NVDA training module has each command in more depth with step-by-step activities. + + + + +line: 201 + + +"Basic Training for NVDA" is available from the [NV Access Shop](http://www.nvaccess.org/shop). + + + + +line: 203 + + +Here are some basic commands which are used frequently. + + + + +line: 204 + + +All commands are configurable, so these are the default keystrokes for these functions. + + + + +line: 206 +prefix: #### +suffix: {#NVDAModifierKey} + + +The NVDA Modifier Key + + + + +line: 208 + + +The default NVDA modifier key is either the `numpadZero`, (with `numLock` off), or the `insert` key, near the `delete`, `home` and `end` keys. + + + + +line: 209 + + +The NVDA modifier key can also be set to the `capsLock` key. + + + + +line: 211 +prefix: #### +suffix: {#InputHelp} + + +Input Help + + + + +line: 213 + + +To learn and practice the location of keys, press `NVDA+1` to turn Input help on. + + + + +line: 214 + + +While in input help mode, performing any input gesture (such as pressing a key or performing a touch gesture) will report the action and describe what it does (if anything). + + + + +line: 215 + + +The actual commands will not execute while in input help mode. + + + + +line: 217 +prefix: #### +suffix: {#StartingAndStoppingNVDA} + + +Starting and stopping NVDA + + + + +line: 219 +prefix: | +suffix: | + + + Name |Desktop key |Laptop key |Description + + + + +line: 221 +prefix: | +suffix: | + + +Start NVDA |`control+alt+n` |`control+alt+n` |Starts or restarts NVDA + + + + +line: 222 +prefix: | +suffix: | + + +Exit NVDA |`NVDA+q`, then `enter` |`NVDA+q`, then `enter` |Exits NVDA + + + + +line: 223 +prefix: | +suffix: | + + +Pause or restart speech |`shift` |`shift` |Instantly pauses speech. Pressing it again will continue speaking where it left off + + + + +line: 224 +prefix: | +suffix: | + + +Stop speech |`control` |`control` |Instantly stops speaking + + + + +line: 226 +prefix: #### +suffix: {#ReadingText} + + +Reading text + + + + +line: 228 +prefix: | +suffix: | + + + Name |Desktop key |Laptop key |Description + + + + +line: 230 +prefix: | +suffix: | + + +Say all |`NVDA+downArrow` |`NVDA+a` |Starts reading from the current position, moving it along as it goes + + + + +line: 231 +prefix: | +suffix: | + + +Read current line |`NVDA+upArrow` |`NVDA+l` |Reads the line. Pressing twice spells the line. Pressing three times spells the line using character descriptions (Alpha, Bravo, Charlie, etc) + + + + +line: 232 +prefix: | +suffix: | + + +Read selection |`NVDA+shift+upArrow` |`NVDA+shift+s` |Reads any selected text. Pressing twice will spell the information. Pressing three times will spell it using character description + + + + +line: 233 +prefix: | +suffix: | + + +Read clipboard text |`NVDA+c` |`NVDA+c` |Reads any text on the clipboard. Pressing twice will spell the information. Pressing three times will spell it using character description + + + + +line: 235 +prefix: #### +suffix: {#ReportingLocation} + + +Reporting location and other information + + + + +line: 237 +prefix: | +suffix: | + + + Name |Desktop key |Laptop key |Description + + + + +line: 239 +prefix: | +suffix: | + + +Window title |`NVDA+t` |`NVDA+t` |Reports the title of the currently active window. Pressing twice will spell the information. Pressing three times will copy it to the clipboard + + + + +line: 240 +prefix: | +suffix: | + + +Report focus |`NVDA+tab` |`NVDA+tab` |Reports the current control which has focus. Pressing twice will spell the information. Pressing three times will spell it using character description + + + + +line: 241 +prefix: | +suffix: | + + +Read window |`NVDA+b` |`NVDA+b` |Reads the entire current window (useful for dialogs) + + + + +line: 242 +prefix: | +suffix: | + + +Read status bar |`NVDA+end` |`NVDA+shift+end` |Reports the Status Bar if NVDA finds one. Pressing twice will spell the information. Pressing three times will copy it to the clipboard + + + + +line: 243 +prefix: | +suffix: | + + +Read time |`NVDA+f12` |`NVDA+f12` |Pressing once reports the current time, pressing twice reports the date. The time and date are reported in the format specified in Windows settings for the system tray clock. + + + + +line: 244 +prefix: | +suffix: | + + +Report text formatting |`NVDA+f` |`NVDA+f` |Reports text formatting. Pressing twice shows the information in a window + + + + +line: 245 +prefix: | +suffix: | + + +Report link destination |`NVDA+k` |`NVDA+k` |Pressing once speaks the destination URL of the link at the current caret or focus position. Pressing twice shows it in a window for more careful review + + + + +line: 247 +prefix: #### +suffix: {#ToggleWhichInformationNVDAReads} + + +Toggle which information NVDA reads + + + + +line: 249 +prefix: | +suffix: | + + + Name |Desktop key |Laptop key |Description + + + + +line: 251 +prefix: | +suffix: | + + +Speak typed characters |`NVDA+2` |`NVDA+2` |When enabled, NVDA will announce all characters you type on the keyboard. + + + + +line: 252 +prefix: | +suffix: | + + +Speak typed words |`NVDA+3` |`NVDA+3` |When enabled, NVDA will announce word you type on the keyboard. + + + + +line: 253 +prefix: | +suffix: | + + +Speak command keys |`NVDA+4` |`NVDA+4` |When enabled, NVDA will announce all non-character keys you type on the keyboard. This includes key combinations such as control plus another letter. + + + + +line: 254 +prefix: | +suffix: | + + +Enable mouse tracking |`NVDA+m` |`NVDA+m` |When enabled, NVDA will announce the text currently under the mouse pointer, as you move it around the screen. This allows you to find things on the screen, by physically moving the mouse, rather than trying to find them through object navigation. + + + + +line: 256 +prefix: #### +suffix: {#TheSynthSettingsRing} + + +The synth settings ring + + + + +line: 258 +prefix: | +suffix: | + + + Name |Desktop key |Laptop key |Description + + + + +line: 260 +prefix: | +suffix: | + + +Move to next synth setting |`NVDA+control+rightArrow` |`NVDA+shift+control+rightArrow` |Moves to the next available speech setting after the current, wrapping around to the first setting again after the last + + + + +line: 261 +prefix: | +suffix: | + + +Move to previous synth setting |`NVDA+control+leftArrow` |`NVDA+shift+control+leftArrow` |Moves to the next available speech setting before the current, wrapping around to the last setting after the first + + + + +line: 262 +prefix: | +suffix: | + + +Increment current synth setting |`NVDA+control+upArrow` |`NVDA+shift+control+upArrow` |increases the current speech setting you are on. E.g. increases the rate, chooses the next voice, increases the volume + + + + +line: 263 +prefix: | +suffix: | + + +Increment the current synth setting in larger steps |`NVDA+control+pageUp` |`NVDA+shift+control+pageUp` |Increases the value of the current speech setting you're on in larger steps. e.g. when you're on a voice setting, it will jump forward every 20 voices; when you're on slider settings (rate, pitch, etc) it will jump forward the value up to 20% + + + + +line: 264 +prefix: | +suffix: | + + +Decrement current synth setting |`NVDA+control+downArrow` |`NVDA+shift+control+downArrow` |decreases the current speech setting you are on. E.g. decreases the rate, chooses the previous voice, decreases the volume + + + + +line: 265 +prefix: | +suffix: | + + +Decrement the current synth setting in larger steps |`NVDA+control+pageDown` |`NVDA+shift+control+pageDown` |Decreases the value of the current speech setting you're on in larger steps. e.g. when you're on a voice setting, it will jump backward every 20 voices; when you're on a slider setting, it will jump backward the value up to 20%. + + + + +line: 267 + + +It is also possible to set the first or last value of the current synth setting by assign custom gestures in [Input Gestures dialog](#InputGestures), under the speech category. + + + + +line: 268 + + +This means, for example, when you're on a rate setting, it will set the rate to 0 or 100. + + + + +line: 269 + + +When you're on a voice setting, it will set the first or last voice. + + + + +line: 271 +prefix: #### +suffix: {#WebNavigation} + + +Web navigation + + + + +line: 273 + + +The full list of Single Letter Navigation keys is in the [Browse Mode](#BrowseMode) section of the user guide. + + + + +line: 275 +prefix: | +suffix: | + + + Command |Keystroke |Description + + + + +line: 277 +prefix: | +suffix: | + + +Heading |`h` |Move to the next heading + + + + +line: 278 +prefix: | +suffix: | + + +Heading level 1, 2, or 3 |`1`, `2`, `3` |Move to the next heading at the specified level + + + + +line: 279 +prefix: | +suffix: | + + +Form field |`f` |Move to the next form field (edit box, button, etc) + + + + +line: 280 +prefix: | +suffix: | + + +Link |`k` |Move to the next link + + + + +line: 281 +prefix: | +suffix: | + + +Landmark |`d` |Move to the next landmark + + + + +line: 282 +prefix: | +suffix: | + + +List |`l` |Move to the next list + + + + +line: 283 +prefix: | +suffix: | + + +Table |`t` |Move to the next table + + + + +line: 284 +prefix: | +suffix: | + + +Move backwards |`shift+letter` |Press `shift` and any of the above letters to move to the previous element of that type + + + + +line: 285 +prefix: | +suffix: | + + +Elements list |`NVDA+f7` |Lists various types of elements, such as links and headings + + + + +line: 287 +prefix: ### +suffix: {#Preferences} + + +Preferences + + + + +line: 289 + + +Most NVDA functions can be enabled or changed via the NVDA settings. + + + + +line: 290 + + +Settings, and other options, are available via NVDA's menu. + + + + +line: 291 + + +To open NVDA's menu, press `NVDA+n`. + + + + +line: 292 + + +To open NVDA's general settings dialog directly, press `NVDA+control+g`. + + + + +line: 293 + + +Many settings screens have keystrokes to open them directly, such as `NVDA+control+s` for synthesizer, or `NVDA+control+v` for other voice options. + + + + +line: 295 +prefix: ### +suffix: {#Addons} + + +Add-ons + + + + +line: 296 + + +Add-ons are programs which provide new or changed functionality for NVDA. + + + + +line: 297 + + +Add-ons are developed by the NVDA community, or external companies and are unaffiliated with NV Access. + + + + +line: 298 + + +As with any software, it is important to trust the developer of an add-on before using it. + + + + +line: 299 + + +Please refer to [Installing Add-ons](#AddonStoreInstalling) for ways to verify add-ons prior to installation. + + + + +line: 301 + + +The first time the Add-on Store is opened, NVDA displays a warning about add-ons. + + + + +line: 302 + + +Add-ons are not vetted by NV Access and may have unrestricted functionality and access to information. + + + + +line: 303 + + +Press `spacebar` if you have read the warning and do not need to see it next time. + + + + +line: 304 + + +Press `tab` to reach the "OK" button, then `enter` to accept the warning and proceed to the Add-on Store. + + + + +line: 305 + + +The "[Add-ons and the Add-on Store](#AddonsManager)" section of the User Guide contains information about every feature of the Add-on Store. + + + + +line: 307 + + +The Add-on Store is available from the Tools menu. + + + + +line: 308 + + +Press `NVDA+n` to open the NVDA menu, then `t` for tools, then `a` for Add-on Store. + + + + +line: 309 + + +When the Add-on Store opens, it shows "Available add-ons" if no add-ons are installed. + + + + +line: 310 + + +When add-ons are installed, the Add-on Store opens to the "Installed add-ons" tab. + + + + +line: 312 +prefix: #### +suffix: {#AvailableAddons} + + +Available add-ons + + + + +line: 313 + + +When the window first opens, add-ons may take a few seconds to load. + + + + +line: 314 + + +NVDA will read the name of the first add-on once the list of add-ons finishes loading. + + + + +line: 315 + + +Available add-ons are listed alphabetically in a multi-column list. + + + + +line: 316 + + +To browse the list and find out about a specific add-on: + + + + +line: 318 +prefix: 1. + + +Use the arrow keys or press the first letter of an add-on name to move around the list. + + + + +line: 319 +prefix: 1. + + +Press `tab` once to move to a description of the currently selected add-on. + + + + +line: 320 +prefix: 1. + + +Use the [reading keys](#ReadingText) or arrow keys to read the full description. + + + + +line: 321 +prefix: 1. + + +Press `tab` to the "Actions" button, which can be used to install the add-on, among other actions. + + + + +line: 322 +prefix: 1. + + +Press `tab` to "Other Details", which lists details such as the publisher, version and homepage. + + + + +line: 323 +prefix: 1. + + +To return to the list of add-ons, press `alt+a`, or `shift+tab` until reaching the list. + + + + +line: 325 +prefix: #### +suffix: {#SearchingForAddons} + + +Searching for add-ons + + + + +line: 326 + + +As well as browsing all available add-ons, it is possible to filter the add-ons shown. + + + + +line: 327 + + +To search, press `alt+s` to jump to the "Search" field and type the text to search for. + + + + +line: 328 + + +Searching checks for matches in the add-on ID, display name, publisher, author and description fields. + + + + +line: 329 + + +The list updates while typing the search terms. + + + + +line: 330 + + +Once done, press `tab` to go to the filtered list of add-ons and browse the results. + + + + +line: 332 +prefix: #### +suffix: {#InstallingAddons} + + +Installing add-ons + + + + +line: 334 + + +To install an add-on: + + + + +line: 336 +prefix: 1. + + +With the focus on an add-on you would like to install, press `enter`. + + + + +line: 337 +prefix: 1. + + +The actions menu opens with a list of actions; the first action is "Install". + + + + +line: 338 +prefix: 1. + + +To install the add-on, press `i` or `downArrow` to "Install" and press `enter`. + + + + +line: 339 +prefix: 1. + + +The focus returns to the add-on in the list and NVDA will read the details about the add-on. + + + + +line: 340 +prefix: 1. + + +The "Status" information reported by NVDA changes from "Available" to "Downloading". + + + + +line: 341 +prefix: 1. + + +Once the add-on has finished downloading, it will change to "Downloaded. Pending install". + + + + +line: 342 +prefix: 1. + + +Repeat with any other add-ons you would like to install at the same time. + + + + +line: 343 +prefix: 1. + + +Once finished, press `tab` until the focus is on the "Close" button, then press `enter`. + + + + +line: 344 +prefix: 1. + + +The downloaded add-ons will start the installation process once the Add-on Store is closed. + + + + +line: 345 + + +During the installation process, add-ons may display dialogs that you will need to respond to. + + + + +line: 346 +prefix: 1. + + +When the add-ons have been installed, a dialog appears advising that changes were made, and you must restart NVDA for the add-on installation to complete. + + + + +line: 347 +prefix: 1. + + +Press `enter` to restart NVDA. + + + + +line: 349 +prefix: #### +suffix: {#ManagingInstalledAddons} + + +Managing installed add-ons + + + + +line: 350 + + +Press `control+tab` to move between the tabs of the Add-on Store. + + + + +line: 351 + + +The tabs include: "Installed add-ons", "Updatable add-ons", "Available add-ons" and "Installed incompatible add-ons". + + + + +line: 352 + + +Each of the tabs are set out similar to each other, as a list of add-ons, a panel for more details on the selected add-on, and a button to perform actions for the selected add-on. + + + + +line: 353 + + +The actions menu of installed add-ons includes "Disable" and "Remove" rather than "Install". + + + + +line: 354 + + +Disabling an add-on stops NVDA from loading it, but leaves it installed. + + + + +line: 355 + + +To re-enable a disabled add-on, activate "Enable" from the actions menu. + + + + +line: 356 + + +After enabling, disabling, or removing add-ons, you will be prompted to restart NVDA when closing the Add-on Store. + + + + +line: 357 + + +These changes will only take effect once NVDA is restarted. + + + + +line: 358 + + +Note that in the Add-on Store window `escape` works the same as the Close button. + + + + +line: 360 +prefix: #### +suffix: {#UpdatingAddons} + + +Updating add-ons + + + + +line: 361 + + +When an update to an add-on you have installed is available, it will be listed in the "Updatable add-ons" tab. + + + + +line: 362 + + +Press `control+tab` to get to this tab from anywhere in the Add-on Store. + + + + +line: 363 + + +The status of the add-on will be listed as "Update available". + + + + +line: 364 + + +The list will display the currently installed version and the available version. + + + + +line: 365 + + +Press `enter` on the add-on to open the actions list; choose "Update". + + + + +line: 367 + + +By default, after NVDA startup, you will be notified if any add-on updates are available. + + + + +line: 368 + + +To learn more about and configure this behaviour, refer to ["Update Notifications"](#AutomaticAddonUpdates). + + + + +line: 370 +prefix: ### +suffix: {#Community} + + +Community + + + + +line: 372 + + +NVDA has a vibrant user community. + + + + +line: 373 + + +There is a main [English language email list](https://nvda.groups.io/g/nvda) and a page full of [local language groups](https://github.com/nvaccess/nvda/wiki/Connect). + + + + +line: 374 + + +NV Access, makers of NVDA, are active on [Twitter](https://twitter.com/nvaccess) and [Facebook](https://www.facebook.com/NVAccess). + + + + +line: 375 + + +NV Access also have a regular [In-Process blog](https://www.nvaccess.org/category/in-process/). + + + + +line: 377 + + +There is also an [NVDA Certified Expert](https://certification.nvaccess.org/) program. + + + + +line: 378 + + +This is an online exam you can complete to demonstrate your skills in NVDA. + + + + +line: 379 + + +[NVDA Certified Experts](https://certification.nvaccess.org/) can list their contact and relevant business details. + + + + +line: 381 +prefix: ### +suffix: {#GettingHelp} + + +Getting help + + + + +line: 383 + + +To get help for NVDA, press `NVDA+n` to open the menu, then `h` for help. + + + + +line: 384 + + +From this submenu you can access the User Guide, a quick reference of commands, history of new features and more. + + + + +line: 385 + + +These first three options open in the default web browser. + + + + +line: 386 + + +There is also more comprehensive Training Material available in the [NV Access Shop](https://www.nvaccess.org/shop). + + + + +line: 388 + + +We recommend starting with the "Basic Training for NVDA module". + + + + +line: 389 + + +This module covers concepts from getting started up to browsing the web and using object navigation. + + + + +line: 390 + + +It is available in: + + + + +line: 392 +prefix: * + + +[Electronic text](https://www.nvaccess.org/product/basic-training-for-nvda-ebook/), which includes Word DOCX, Web page HTML, eBook ePub and Kindle KFX formats. + + + + +line: 393 +prefix: * + + +[Human-read, MP3 audio](https://www.nvaccess.org/product/basic-training-for-nvda-downloadable-audio/) + + + + +line: 394 +prefix: * + + +[Hard-copy UEB Braille](https://www.nvaccess.org/product/basic-training-for-nvda-braille-hard-copy/) with delivery included anywhere in the world. + + + + +line: 396 + + +Other modules, and the discounted [NVDA Productivity Bundle](https://www.nvaccess.org/product/nvda-productivity-bundle/), are available in the [NV Access Shop](https://www.nvaccess.org/shop/). + + + + +line: 398 + + +NV Access also sells [telephone support](https://www.nvaccess.org/product/nvda-telephone-support/), either in blocks, or as part of the [NVDA Productivity Bundle](https://www.nvaccess.org/product/nvda-productivity-bundle/). + + + + +line: 399 + + +Telephone support includes local numbers in Australia and the USA. + + + + +line: 401 + + +The [email user groups](https://github.com/nvaccess/nvda/wiki/Connect) are a great source of community help, as are [certified NVDA experts](https://certification.nvaccess.org/). + + + + +line: 403 + + +You can make bug reports or feature requests via [GitHub](https://github.com/nvaccess/nvda/blob/master/projectDocs/issues/readme.md). + + + + +line: 404 + + +The [contribution guidelines](https://github.com/nvaccess/nvda/blob/master/.github/CONTRIBUTING.md) contain valuable information for contributing to the community. + + + + +line: 406 +prefix: ## +suffix: {#MoreSetupOptions} + + +More Setup Options + + + + +line: 407 +prefix: ### +suffix: {#InstallingNVDA} + + +Installation Options + + + + +line: 409 + + +If installing NVDA directly from the downloaded NVDA launcher, press the Install NVDA button. + + + + +line: 410 + + +If you have already closed this dialog or are wanting to install from a portable copy, please choose the Install NVDA menu item found under Tools in the NVDA menu. + + + + +line: 412 + + +The installation dialog that appears will confirm whether you wish to install NVDA and will also tell you whether this installation will be updating a previous install. + + + + +line: 413 + + +Pressing the Continue button will start installing NVDA. + + + + +line: 414 + + +There are also a few options in this dialog which are explained below. + + + + +line: 415 + + +Once the installation has completed, a message will appear telling you that it was successful. + + + + +line: 416 + + +Pressing OK at this point will restart the newly installed copy of NVDA. + + + + +line: 418 +prefix: #### +suffix: {#InstallWithIncompatibleAddons} + + +Incompatible add-ons warning + + + + +line: 420 + + +If you have add-ons already installed there may also be a warning that incompatible add-ons will be disabled. + + + + +line: 421 + + +Before you're able to press the Continue button you will have to use the checkbox to confirm that you understand that these add-ons will be disabled. + + + + +line: 422 + + +There will also be a button present to review the add-ons that will be disabled. + + + + +line: 423 + + +Refer to the [incompatible add-ons dialog section](#incompatibleAddonsManager) for more help on this button. + + + + +line: 424 + + +After installation, you are able to re-enable incompatible add-ons at your own risk from within the [Add-on Store](#AddonsManager). + + + + +line: 426 +prefix: #### +suffix: {#StartAtWindowsLogon} + + +Use NVDA during sign-in + + + + +line: 428 + + +This option allows you to choose whether or not NVDA should automatically start while at the Windows sign-in screen, before you have entered a password. + + + + +line: 429 + + +This also includes User Account Control and [other secure screens](#SecureScreens). + + + + +line: 430 + + +This option is enabled by default for fresh installations. + + + + +line: 432 +prefix: #### +suffix: {#CreateDesktopShortcut} + + +Create Desktop Shortcut (ctrl+alt+n) + + + + +line: 434 + + +This option allows you to choose whether or not NVDA should create a shortcut on the desktop to start NVDA. + + + + +line: 435 + + +If created, this shortcut will also be assigned a shortcut key of `control+alt+n`, allowing you to start NVDA at any time with this keystroke. + + + + +line: 437 +prefix: #### +suffix: {#CopyPortableConfigurationToCurrentUserAccount} + + +Copy Portable Configuration to Current User Account + + + + +line: 439 + + +This option allows you to choose whether or not NVDA should copy the user configuration from the currently running NVDA into the configuration for the currently logged on user, for the installed copy of NVDA. + + + + +line: 440 + + +This will not copy the configuration for any other users of this system nor to the system configuration for use during Windows sign-in and [other secure screens](#SecureScreens). + + + + +line: 441 + + +This option is only available when installing from a portable copy, not when installing directly from the downloaded Launcher package. + + + + +line: 443 +prefix: ### +suffix: {#CreatingAPortableCopy} + + +Creating a Portable Copy + + + + +line: 445 + + +If creating a portable copy directly from the NVDA download package, press the Create Portable Copy button. + + + + +line: 446 + + +If you have already closed this dialog or you are running an installed copy of NVDA, choose the Create Portable copy menu item found under Tools in the NVDA menu. + + + + +line: 448 + + +The dialog that appears allows you to choose where the portable copy should be created. + + + + +line: 449 + + +This can be a directory on your hard drive or a location on a USB thumb drive or other portable media. + + + + +line: 450 + + +By default, a new directory is created for the portable copy. + + + + +line: 451 + + +You can also choose to use an existing directory, this will overwrite files in the directory. + + + + +line: 452 + + +If the existing directory is a portable copy of NVDA, that copy will be updated. + + + + +line: 454 + + +There is also an option to choose whether NVDA should copy the logged on user's current NVDA configuration for use with the newly created portable copy. + + + + +line: 455 + + +This also includes add-ons. + + + + +line: 456 + + +This option is only available when creating a portable copy from an installed copy, not when creating from the download package. + + + + +line: 458 + + +Pressing Continue will create the portable copy. + + + + +line: 459 + + +Once creation is complete, a message will appear telling you it was successful. + + + + +line: 460 + + +Press OK to dismiss this dialog. + + + + +line: 462 +prefix: ### +suffix: {#PortableAndTemporaryCopyRestrictions} + + +Portable and Temporary Copy Restrictions + + + + +line: 464 + + +If you want to take NVDA with you on a USB thumb drive or other writable media, then you should choose to create a portable copy. + + + + +line: 465 + + +The installed copy is also able to create a portable copy of itself at any time. + + + + +line: 466 + + +The portable copy also has the ability to install itself on any computer at a later time. + + + + +line: 467 + + +However, if you wish to copy NVDA onto read-only media such as a CD, you should just copy the download package. + + + + +line: 468 + + +Running the portable version directly from read-only media is not supported at this time. + + + + +line: 470 + + +The [NVDA installer](#StepsForRunningTheDownloadLauncher) can be used as a temporary copy of NVDA. + + + + +line: 471 + + +Temporary copies prevent saving NVDA settings. + + + + +line: 472 + + +This includes disabling usage of the [Add-on Store](#AddonsManager). + + + + +line: 474 + + +Portable and temporary copies of NVDA have the following restrictions: + + + + +line: 476 +prefix: * + + +The inability to automatically start during and/or after log-on. + + + + +line: 477 +prefix: * + + +The inability to interact with applications running with administrative privileges, unless of course NVDA itself has been run also with these privileges (not recommended). + + + + +line: 478 +prefix: * + + +The inability to read User Account Control (UAC) screens when trying to start an application with administrative privileges. + + + + +line: 479 +prefix: * + + +The inability to support input from a touchscreen. + + + + +line: 480 +prefix: * + + +The inability to provide features such as browse mode and speaking of typed characters in Windows Store apps. + + + + +line: 481 +prefix: * + + +Audio ducking is not supported. + + + + +line: 483 +prefix: ## +suffix: {#GettingStartedWithNVDA} + + +Using NVDA + + + + +line: 484 +prefix: ### +suffix: {#LaunchingNVDA} + + +Launching NVDA + + + + +line: 486 + + +If you have installed NVDA with the installer, then starting NVDA is as simple as either pressing control+alt+n, or choosing NVDA from the NVDA menu under Programs on the Start Menu. + + + + +line: 487 + + +Additionally you can type NVDA into the Run dialog and press Enter. + + + + +line: 488 + + +If NVDA is already running, it will be restarted. + + + + +line: 489 + + +You can also pass some [command line options](#CommandLineOptions) which allows you to quit (-q), disable add-ons (--disable-addons), etc. + + + + +line: 491 + + +For installed copies, NVDA stores the configuration in the roaming application data folder of the current user by default (e.g. "`C:\Users\<user>\AppData\Roaming`"). + + + + +line: 492 + + +It is possible to change this in a way that NVDA loads its configuration from the local application data folder instead. + + + + +line: 493 + + +Consult the section about [system wide parameters](#SystemWideParameters) for more details. + + + + +line: 495 + + +To start the portable version, go to the directory you unpacked NVDA to, and press enter or double click on nvda.exe. + + + + +line: 496 + + +If NVDA was already running, it will automatically stop before starting the portable version. + + + + +line: 498 + + +As NVDA starts, you will first hear an ascending set of tones (telling you that NVDA is loading). + + + + +line: 499 + + +Depending on how fast your computer is, or if you are running NVDA off a USB key or other slow media, it may take a little while to start. + + + + +line: 500 + + +If it is taking an extra-long time to start, NVDA should say "Loading NVDA. Please wait..." + + + + +line: 502 + + +If you don't hear any of this, or you hear the Windows error sound, or a descending set of tones, then this means that NVDA has an error, and you will need to possibly report a bug to the developers. + + + + +line: 503 + + +Please check out the NVDA website for how to do this. + + + + +line: 505 +prefix: #### +suffix: {#WelcomeDialog} + + +Welcome Dialog + + + + +line: 507 + + +When NVDA starts for the first time, you will be greeted by a dialog box which provides you with some basic information about the NVDA modifier key and the NVDA menu. + + + + +line: 508 + + +(Please see further sections about these topics.) + + + + +line: 509 + + +The dialog box also contains a combo box and three checkboxes. + + + + +line: 510 + + +The combo box lets you select the keyboard layout. + + + + +line: 511 + + +The first checkbox lets you control if NVDA should use the Caps Lock as an NVDA modifier key. + + + + +line: 512 + + +The second specifies whether NVDA should start automatically after you log on to Windows and is only available for installed copies of NVDA. + + + + +line: 513 + + +The third lets you control if this Welcome dialog should appear each time NVDA starts. + + + + +line: 515 +prefix: #### +suffix: {#UsageStatsDialog} + + +Data usage statistics dialog + + + + +line: 517 + + +When starting NVDA for the first time, a dialog will appear which will ask you if you want to accept sending data to NV Access while using NVDA, in order to help improve NVDA in the future. + + + + +line: 518 + + +You can read more info about the data gathered by NV Access in the general settings section, [Allow NV Access to gather NVDA usage statistics](#GeneralSettingsGatherUsageStats). + + + + +line: 519 + + +Note: pressing on "yes" or "no" will save this setting and the dialog will never appear again unless you reinstall NVDA. + + + + +line: 520 + + +However, you can enable or disable the data gathering process manually in NVDA's general settings panel. For changing this setting manually, you can check or uncheck the checkbox called [Allow the NVDA project to gather NVDA usage statistics](#GeneralSettingsGatherUsageStats). + + + + +line: 522 +prefix: ### +suffix: {#AboutNVDAKeyboardCommands} + + +About NVDA keyboard commands + + + + +line: 523 +prefix: #### +suffix: {#TheNVDAModifierKey} + + +The NVDA Modifier Key + + + + +line: 525 + + +Most NVDA-specific keyboard commands consist of pressing a particular key called the NVDA modifier key in conjunction with one or more other keys. + + + + +line: 526 + + +Notable exceptions to this are the text review commands for the desktop keyboard layout which just use the numpad keys by themselves, but there are some other exceptions as well. + + + + +line: 528 + + +NVDA can be configured so that the `insert`, `numpadInsert`, and/or `capsLock` key can be used as the `NVDA` modifier key. + + + + +line: 529 + + +By default, both the `insert` and `numpadInsert` keys are set as NVDA modifier keys. + + + + +line: 531 + + +If you wish to cause one of the NVDA modifier keys to behave as it usually would if NVDA were not running (e.g. you wish to turn Caps Lock on when you have set Caps Lock to be an NVDA modifier key), you can press the key twice in quick succession. + + + + +line: 533 +prefix: #### +suffix: {#KeyboardLayouts} + + +Keyboard Layouts + + + + +line: 535 + + +NVDA currently comes with two sets of key commands (known as keyboard layouts): the desktop layout and the laptop layout. + + + + +line: 536 + + +By default, NVDA is set to use the Desktop layout, though you can switch to the Laptop layout in the Keyboard category of the [NVDA Settings](#NVDASettings) dialog, found under Preferences in the NVDA menu. + + + + +line: 538 + + +The Desktop layout makes heavy use of the numpad (with Num Lock off). + + + + +line: 539 + + +Although most laptops do not have a physical numpad, some laptops can emulate one by holding down the FN key and pressing letters and numbers on the right-hand side of the keyboard (7, 8, 9, u, i, o, j, k, l, etc.). + + + + +line: 540 + + +If your laptop cannot do this or does not allow you to turn Num Lock off, you may want to switch to the Laptop layout instead. + + + + +line: 542 +prefix: ### +suffix: {#NVDATouchGestures} + + +NVDA Touch Gestures + + + + +line: 544 + + +If you are running NVDA on a device with a touchscreen, you can also control NVDA directly via touch commands. + + + + +line: 545 + + +While NVDA is running, unless touch interaction support is disabled, all touch input will go directly to NVDA. + + + + +line: 546 + + +Therefore, actions that can be performed normally without NVDA will not work. + + + + +line: 548 + + +To toggle touch interaction support, press NVDA+control+alt+t. + + + + +line: 550 + + +You can also enable or disable [touch interaction support](#TouchSupportEnable) from the Touch Interaction category of the NVDA settings. + + + + +line: 552 +prefix: #### +suffix: {#ExploringTheScreen} + + +Exploring the Screen + + + + +line: 554 + + +The most basic action you can perform with the touch screen is to announce the control or text at any point on the screen. + + + + +line: 555 + + +To do this, place one finger anywhere on the screen. + + + + +line: 556 + + +You can also keep your finger on the screen and move it around to read other controls and text that your finger moves over. + + + + +line: 558 +prefix: #### +suffix: {#TouchGestures} + + +Touch Gestures + + + + +line: 560 + + +When NVDA commands are described later in this user guide, they may list a touch gesture which can be used to activate that command with the touchscreen. + + + + +line: 561 + + +Following are some instructions on how to perform the various touch gestures. + + + + +line: 563 +prefix: ##### +suffix: {#Taps} + + +Taps + + + + +line: 565 + + +Tap the screen quickly with one or more fingers. + + + + +line: 567 + + +Tapping once with one finger is simply known as a tap. + + + + +line: 568 + + +Tapping with 2 fingers at the same time is a 2-finger tap and so on. + + + + +line: 570 + + +If the same tap is performed one or more times again in quick succession, NVDA will instead treat this as a multi-tap gesture. + + + + +line: 571 + + +Tapping twice will result in a double-tap. + + + + +line: 572 + + +Tapping 3 times will result in a triple-tap and so on. + + + + +line: 573 + + +Of course, these multi-tap gestures also recognize how many fingers were used, so it's possible to have gestures like a 2-finger triple-tap, a 4-finger tap, etc. + + + + +line: 575 +prefix: ##### +suffix: {#Flicks} + + +Flicks + + + + +line: 577 + + +Quickly swipe your finger across the screen. + + + + +line: 579 + + +There are 4 possible flick gestures depending on the direction: flick left, flick right, flick up and flick down. + + + + +line: 581 + + +Just like taps, more than one finger can be used to perform the gesture. + + + + +line: 582 + + +Therefore, gestures such as 2-finger flick up and 4-finger flick left are all possible. + + + + +line: 584 +prefix: #### +suffix: {#TouchModes} + + +Touch Modes + + + + +line: 586 + + +As there are many more NVDA commands than possible touch gestures, NVDA has several touch modes you can switch between which make certain subsets of commands available. + + + + +line: 587 + + +The two modes are text mode and object mode. + + + + +line: 588 + + +Certain NVDA commands listed in this document may have a touch mode listed in brackets after the touch gesture. + + + + +line: 589 + + +For example, flick up (text mode) means that the command will be performed if you flick up, but only while in text mode. + + + + +line: 590 + + +If the command does not have a mode listed, it will work in any mode. + + + + +line: 593 + + +To toggle touch modes, perform a 3-finger tap. + + + + +line: 596 +prefix: #### +suffix: {#TouchKeyboard} + + +Touch keyboard + + + + +line: 598 + + +The touch keyboard is used to enter text and commands from a touchscreen. + + + + +line: 599 + + +When focused on an edit field, you can bring up the touch keyboard by double-tapping the touch keyboard icon on the bottom of the screen. + + + + +line: 600 + + +For tablets such as Microsoft Surface Pro, the touch keyboard is always available when the keyboard is undocked. + + + + +line: 601 + + +To dismiss the touch keyboard, double-tap the touch keyboard icon or move away from the edit field. + + + + +line: 603 + + +While the touch keyboard is active, to locate keys on the touch keyboard, move your finger to where the touch keyboard is located (typically at the bottom of the screen), then move around the keyboard with one finger. + + + + +line: 604 + + +When you find the key you wish to press, double-tap the key or lift your finger, depending on options chosen from the [Touch Interaction Settings category](#TouchInteraction) of the NVDA Settings. + + + + +line: 606 +prefix: ### +suffix: {#InputHelpMode} + + +Input Help Mode + + + + +line: 608 + + +Many NVDA commands are mentioned throughout the rest of this user guide, but an easy way to explore all the different commands is to turn on input help. + + + + +line: 610 + + +To turn on input help, press NVDA+1. + + + + +line: 611 + + +To turn it off, press NVDA+1 again. + + + + +line: 612 + + +While in input help, performing any input gesture (such as pressing a key or performing a touch gesture) will report the action and describe what it does (if anything). + + + + +line: 613 + + +The actual commands will not execute while in input help mode. + + + + +line: 615 +prefix: ### +suffix: {#TheNVDAMenu} + + +The NVDA menu + + + + +line: 617 + + +The NVDA menu allows you to control NVDA's settings, access help, save/revert your configuration, Modify speech dictionaries, access additional tools and exit NVDA. + + + + +line: 619 + + +To get to the NVDA menu from anywhere in Windows while NVDA is running, you may do any of the following: + + + + +line: 621 +prefix: * + + +press `NVDA+n` on the keyboard. + + + + +line: 622 +prefix: * + + +Perform a 2-finger double-tap on the touch screen. + + + + +line: 623 +prefix: * + + +Access the system tray by pressing `Windows+b`, `downArrow` to the NVDA icon, and press `enter`. + + + + +line: 624 +prefix: * + + +Alternatively, access the system tray by pressing `Windows+b`, `downArrow` to the NVDA icon, and open the context menu by pressing the `applications` key located next to the right control key on most keyboards. + + + + +line: 625 + + +On a keyboard without an `applications` key, press `shift+f10` instead. + + + + +line: 626 +prefix: * + + +Right-click on the NVDA icon located in the Windows system tray + + + + +line: 628 + + +When the menu comes up, You can use the arrow keys to navigate the menu, and the `enter` key to activate an item. + + + + +line: 630 +prefix: ### +suffix: {#BasicNVDACommands} + + +Basic NVDA commands + + + + +line: 634 +prefix: | +suffix: | + + + Name |Desktop key |Laptop key |Touch |Description + + + + +line: 636 +prefix: | +suffix: | + + +Starts or restarts NVDA |Control+alt+n |Control+alt+n |none |Starts or restarts NVDA from the Desktop, if this Windows shortcut is enabled during NVDA's installation process. This is a Windows specific shortcut and therefore it cannot be reassigned in the input gestures dialog. + + + + +line: 637 +prefix: | +suffix: | + + +Stop speech |Control |control |2-finger tap |Instantly stops speaking + + + + +line: 638 +prefix: | +suffix: | + + +Pause Speech |shift |shift |none |Instantly pauses speech. Pressing it again will continue speaking where it left off (if pausing is supported by the current synthesizer) + + + + +line: 639 +prefix: | +suffix: | + + +NVDA Menu |NVDA+n |NVDA+n |2-finger double-tap |Pops up the NVDA menu to allow you to access preferences, tools, help, etc. + + + + +line: 640 +prefix: | +suffix: | + + +Toggle Input Help Mode |NVDA+1 |NVDA+1 |none |Pressing any key in this mode will report the key, and the description of any NVDA command associated with it + + + + +line: 641 +prefix: | +suffix: | + + +Quit NVDA |NVDA+q |NVDA+q |none |Exits NVDA + + + + +line: 642 +prefix: | +suffix: | + + +Pass next key through |NVDA+f2 |NVDA+f2 |none |Tells NVDA to pass the next key press straight through to the active application - even if it is normally treated as an NVDA key command + + + + +line: 643 +prefix: | +suffix: | + + +Toggle application sleep mode on and off |NVDA+shift+s |NVDA+shift+z |none |sleep mode disables all NVDA commands and speech/braille output for the current application. This is most useful in applications that provide their own speech or screen reading features. Press this command again to disable sleep mode - note that NVDA will only retain the Sleep Mode setting until it is restarted. + + + + +line: 647 +prefix: ### +suffix: {#ReportingSystemInformation} + + +Reporting System Information + + + + +line: 651 +prefix: | +suffix: | + + + Name |key |Description + + + + +line: 653 +prefix: | +suffix: | + + +Report date/time |NVDA+f12 |Pressing once reports the current time, pressing twice reports the date + + + + +line: 654 +prefix: | +suffix: | + + +Report battery status |NVDA+shift+b |Reports the battery status i.e. whether AC power is in use or the current charge percentage. + + + + +line: 655 +prefix: | +suffix: | + + +Report clipboard text |NVDA+c |Reports the Text on the clipboard if there is any. + + + + +line: 659 +prefix: ### +suffix: {#SpeechModes} + + +Speech modes + + + + +line: 661 + + +The speech mode governs how screen content, notifications, responses to commands, and other output is spoken during operation of NVDA. + + + + +line: 662 + + +The default mode is "talk", which speaks in situations that are expected when using a screen reader. + + + + +line: 663 + + +However, under certain circumstances, or when running particular programs, you may find one of the other speech modes valuable. + + + + +line: 665 + + +The four available speech modes are: + + + + +line: 667 +prefix: * + + +Talk (Default): NVDA will speak normally in reaction to screen changes, notifications, and actions such as moving the focus, or issuing commands. + + + + +line: 668 +prefix: * + + +On-demand: NVDA will only speak when you use commands with a reporting function (e.g. report the title of the window); but it will not speak in reaction to actions such as moving the focus or the cursor. + + + + +line: 669 +prefix: * + + +Off: NVDA will not speak anything, however unlike sleep mode, it will silently react to commands. + + + + +line: 670 +prefix: * + + +Beeps: NVDA will replace normal speech with short beeps. + + + + +line: 672 + + +The Beeps mode may be useful when some very verbose output is scrolling in a terminal window, but you don't care what it is, only that it is continuing to scroll; or in other circumstances when the fact that there is output is more relevant than the output itself. + + + + +line: 674 + + +The On-demand mode may be valuable when you don't need constant feedback about what is happening on screen or on the computer, but you periodically need to check particular things using review commands, etc. + + + + +line: 675 + + +Examples include while recording audio, when using screen magnification, during a meeting or a call, or as an alternative to beeps mode. + + + + +line: 677 + + +A gesture allows cycling through the various speech modes: + + + + +line: 680 +prefix: | +suffix: | + + + Name |Key |Description + + + + +line: 682 +prefix: | +suffix: | + + +Cycle Speech Mode |`NVDA+s` |Cycles between speech modes. + + + + +line: 686 + + +If you only need to switch between a limited subset of speech modes, see [Modes available in the Cycle speech mode command](#SpeechModesDisabling) for a way to disable unwanted modes. + + + + +line: 688 +prefix: ## +suffix: {#NavigatingWithNVDA} + + +Navigating with NVDA + + + + +line: 690 + + +NVDA allows you to explore and navigate the system in several ways, including both normal interaction and review. + + + + +line: 692 +prefix: ### +suffix: {#Objects} + + +Objects + + + + +line: 694 + + +Each Application and the operating system itself consist of many objects. + + + + +line: 695 + + +An object is a single item such as a piece of text, button, checkbox, slider, list or editable text field. + + + + +line: 697 +prefix: ### +suffix: {#SystemFocus} + + +Navigating with the System Focus + + + + +line: 699 + + +The system focus, also known simply as the focus, is the [object](#Objects) which receives keys typed on the keyboard. + + + + +line: 700 + + +For example, if you are typing into an editable text field, the editable text field has the focus. + + + + +line: 702 + + +The most common way of navigating around Windows with NVDA is to simply move the system focus using standard Windows keyboard commands, such as pressing tab and shift+tab to move forward and back between controls, pressing alt to get to the menu bar and then using the arrows to navigate menus, and using alt+tab to move between running applications. + + + + +line: 703 + + +As you do this, NVDA will report information about the object with focus, such as its name, type, value, state, description, keyboard shortcut and positional information. + + + + +line: 704 + + +When [Visual Highlight](#VisionFocusHighlight) is enabled, the location of the current system focus is also exposed visually. + + + + +line: 706 + + +There are some key commands that are useful when moving with the System focus: + + + + +line: 709 +prefix: | +suffix: | + + + Name |Desktop key |Laptop key |Description + + + + +line: 711 +prefix: | +suffix: | + + +Report current focus |NVDA+tab |NVDA+tab |announces the current object or control that has the System focus. Pressing twice will spell the information + + + + +line: 712 +prefix: | +suffix: | + + +Report title |NVDA+t |NVDA+t |Reports the title of the currently active window. Pressing twice will spell the information. Pressing three times will copy it to the clipboard + + + + +line: 713 +prefix: | +suffix: | + + +Read active window |NVDA+b |NVDA+b |reads all the controls in the currently active window (useful for dialogs) + + + + +line: 714 +prefix: | +suffix: | + + +Report Status Bar |NVDA+end |NVDA+shift+end |Reports the Status Bar if NVDA finds one. Pressing twice will spell the information. Pressing three times will copy it to the clipboard + + + + +line: 715 +prefix: | +suffix: | + + +Report Shortcut Key |`shift+numpad2` |`NVDA+control+shift+.` |Reports the shortcut (accelerator) key of the currently focused object + + + + +line: 719 +prefix: ### +suffix: {#SystemCaret} + + +Navigating with the System Caret + + + + +line: 721 + + +When an [object](#Objects) that allows navigation and/or editing of text is [focused](#SystemFocus), you can move through the text using the system caret, also known as the edit cursor. + + + + +line: 723 + + +When the focus is on an object that has the system caret, you can use the arrow keys, page up, page down, home, end, etc. to move through the text. + + + + +line: 724 + + +You can also change the text if the control supports editing. + + + + +line: 725 + + +NVDA will announce as you move by character, word and line, and will also announce as you select and unselect text. + + + + +line: 727 + + +NVDA provides the following key commands in relation to the system caret: + + + + +line: 730 +prefix: | +suffix: | + + + Name |Desktop key |Laptop key |Description + + + + +line: 732 +prefix: | +suffix: | + + +Say all |NVDA+downArrow |NVDA+a |Starts reading from the current position of the system caret, moving it along as it goes + + + + +line: 733 +prefix: | +suffix: | + + +Read current line |NVDA+upArrow |NVDA+l |Reads the line where the system caret is currently situated. Pressing twice spells the line. Pressing three times spells the line using character descriptions. + + + + +line: 734 +prefix: | +suffix: | + + +Read current text selection |NVDA+Shift+upArrow |NVDA+shift+s |Reads any currently selected text + + + + +line: 735 +prefix: | +suffix: | + + +Report text formatting |NVDA+f |NVDA+f |Reports the formatting of the text where the caret is currently situated. Pressing twice shows the information in browse mode + + + + +line: 736 +prefix: | +suffix: | + + +Report link destination |`NVDA+k` |`NVDA+k` |Pressing once speaks the destination URL of the link at the current caret or focus position. Pressing twice shows it in a window for more careful review + + + + +line: 737 +prefix: | +suffix: | + + +Report caret location |NVDA+numpadDelete |NVDA+delete |Reports information about the location of the text or object at the position of system caret. For example, this might include the percentage through the document, the distance from the edge of the page or the exact screen position. Pressing twice may provide further detail. + + + + +line: 738 +prefix: | +suffix: | + + +Next sentence |alt+downArrow |alt+downArrow |Moves the caret to the next sentence and announces it. (only supported in Microsoft Word and Outlook) + + + + +line: 739 +prefix: | +suffix: | + + +Previous sentence |alt+upArrow |alt+upArrow |Moves the caret to the previous sentence and announces it. (only supported in Microsoft Word and Outlook) + + + + +line: 741 + + +When within a table, the following key commands are also available: + + + + +line: 743 +prefix: | +suffix: | + + + Name |Key |Description + + + + +line: 745 +prefix: | +suffix: | + + +Move to previous column |control+alt+leftArrow |Moves the system caret to the previous column (staying in the same row) + + + + +line: 746 +prefix: | +suffix: | + + +Move to next column |control+alt+rightArrow |Moves the system caret to the next column (staying in the same row) + + + + +line: 747 +prefix: | +suffix: | + + +Move to previous row |control+alt+upArrow |Moves the system caret to the previous row (staying in the same column) + + + + +line: 748 +prefix: | +suffix: | + + +Move to next row |control+alt+downArrow |Moves the system caret to the next row (staying in the same column) + + + + +line: 749 +prefix: | +suffix: | + + +Move to first column |control+alt+home |Moves the system caret to the first column (staying in the same row) + + + + +line: 750 +prefix: | +suffix: | + + +Move to last column |control+alt+end |Moves the system caret to the last column (staying in the same row) + + + + +line: 751 +prefix: | +suffix: | + + +Move to first row |control+alt+pageUp |Moves the system caret to the first row (staying in the same column) + + + + +line: 752 +prefix: | +suffix: | + + +Move to last row |control+alt+pageDown |Moves the system caret to the last row (staying in the same column) + + + + +line: 753 +prefix: | +suffix: | + + +Say all in column |`NVDA+control+alt+downArrow` |Reads the column vertically from the current cell downwards to the last cell in the column. + + + + +line: 754 +prefix: | +suffix: | + + +Say all in row |`NVDA+control+alt+rightArrow` |Reads the row horizontally from the current cell rightwards to the last cell in the row. + + + + +line: 755 +prefix: | +suffix: | + + +Read entire column |`NVDA+control+alt+upArrow` |Reads the current column vertically from top to bottom without moving the system caret. + + + + +line: 756 +prefix: | +suffix: | + + +Read entire row |`NVDA+control+alt+leftArrow` |Reads the current row horizontally from left to right without moving the system caret. + + + + +line: 760 +prefix: ### +suffix: {#ObjectNavigation} + + +Object Navigation + + + + +line: 762 + + +Most of the time, you will work with applications using commands which move the [focus](#SystemFocus) and the [caret](#SystemCaret). + + + + +line: 763 + + +However, sometimes, you may wish to explore the current application or the Operating System without moving the focus or caret. + + + + +line: 764 + + +You may also wish to work with [objects](#Objects) that cannot be accessed normally using the keyboard. + + + + +line: 765 + + +In these cases, you can use object navigation. + + + + +line: 767 + + +Object navigation allows you to move between and obtain information about individual [objects](#Objects). + + + + +line: 768 + + +When you move to an object, NVDA will report it similarly to the way it reports the system focus. + + + + +line: 769 + + +For a way to review all text as it appears on the screen, you can instead use [screen review](#ScreenReview). + + + + +line: 771 + + +Rather than having to move back and forth between every single object on the system, the objects are organized hierarchically. + + + + +line: 772 + + +This means that some objects contain other objects and you must move inside them to access the objects they contain. + + + + +line: 773 + + +For example, a list contains list items, so you must move inside the list in order to access its items. + + + + +line: 774 + + +If you have moved to a list item, moving next and previous will take you to other list items in the same list. + + + + +line: 775 + + +Moving to a list item's containing object will take you back to the list. + + + + +line: 776 + + +You can then move past the list if you wish to access other objects. + + + + +line: 777 + + +Similarly, a toolbar contains controls, so you must move inside the toolbar to access the controls in the toolbar. + + + + +line: 779 + + +If you yet prefer to move back and forth between every single object on the system, you can use commands to move to the previous/next object in a flattened view. + + + + +line: 780 + + +For example, if you move to the next object in this flattened view and the current object contains other objects, NVDA will automatically move to the first object that it contains. + + + + +line: 781 + + +Alternatively, if the current object doesn't contain any objects, NVDA will move to the next object at the current level of the hierarchy. + + + + +line: 782 + + +If there is no such next object, NVDA will try to find the next object in the hierarchy based on containing objects until there are no more objects to move to. + + + + +line: 783 + + +The same rules apply to moving backwards in the hierarchy. + + + + +line: 785 + + +The object currently being reviewed is called the navigator object. + + + + +line: 786 + + +Once you navigate to an object, you can review its content using the [text review commands](#ReviewingText) while in [Object review mode](#ObjectReview). + + + + +line: 787 + + +When [Visual Highlight](#VisionFocusHighlight) is enabled, the location of the current navigator object is also exposed visually. + + + + +line: 788 + + +By default, the navigator object moves along with the System focus, though this behaviour can be toggled on and off. + + + + +line: 790 + + +Note: Braille following Object Navigation can be configured via [Braille Tether](#BrailleTether). + + + + +line: 792 + + +To navigate by object, use the following commands: + + + + +line: 796 +prefix: | +suffix: | + + + Name |Desktop key |Laptop key |Touch |Description + + + + +line: 798 +prefix: | +suffix: | + + +Report current object |NVDA+numpad5 |NVDA+shift+o |none |Reports the current navigator object. Pressing twice spells the information, and pressing 3 times copies this object's name and value to the clipboard. + + + + +line: 799 +prefix: | +suffix: | + + +Move to containing object |NVDA+numpad8 |NVDA+shift+upArrow |flick up (object mode) |Moves to the object containing the current navigator object + + + + +line: 800 +prefix: | +suffix: | + + +Move to previous object |NVDA+numpad4 |NVDA+shift+leftArrow |none |Moves to the object before the current navigator object + + + + +line: 801 +prefix: | +suffix: | + + +Move to previous object in flattened view |NVDA+numpad9 |NVDA+shift+[ |flick left (object mode) |Moves to the previous object in a flattened view of the object navigation hierarchy + + + + +line: 802 +prefix: | +suffix: | + + +Move to next object |NVDA+numpad6 |NVDA+shift+rightArrow |none |Moves to the object after the current navigator object + + + + +line: 803 +prefix: | +suffix: | + + +Move to next object in flattened view |NVDA+numpad3 |NVDA+shift+] |flick right (object mode) |Moves to the next object in a flattened view of the object navigation hierarchy + + + + +line: 804 +prefix: | +suffix: | + + +Move to first contained object |NVDA+numpad2 |NVDA+shift+downArrow |flick down (object mode) |Moves to the first object contained by the current navigator object + + + + +line: 805 +prefix: | +suffix: | + + +Move to focus object |NVDA+numpadMinus |NVDA+backspace |none |Moves to the object that currently has the system focus, and also places the review cursor at the position of the System caret, if it is showing + + + + +line: 806 +prefix: | +suffix: | + + +Activate current navigator object |NVDA+numpadEnter |NVDA+enter |double-tap |Activates the current navigator object (similar to clicking with the mouse or pressing space when it has the system focus) + + + + +line: 807 +prefix: | +suffix: | + + +Move System focus or caret to current review position |NVDA+shift+numpadMinus |NVDA+shift+backspace |none |pressed once Moves the System focus to the current navigator object, pressed twice moves the system caret to the position of the review cursor + + + + +line: 808 +prefix: | +suffix: | + + +Report review cursor location |NVDA+shift+numpadDelete |NVDA+shift+delete |none |Reports information about the location of the text or object at the review cursor. For example, this might include the percentage through the document, the distance from the edge of the page or the exact screen position. Pressing twice may provide further detail. + + + + +line: 809 +prefix: | +suffix: | + + +Move review cursor to status bar |none |none |none |Reports the Status Bar if NVDA finds one. It also moves the navigator object to this location. + + + + +line: 813 + + +Note: numpad keys require the Num Lock to be turned off to work properly. + + + + +line: 815 +prefix: ### +suffix: {#ReviewingText} + + +Reviewing Text + + + + +line: 817 + + +NVDA allows you to read the contents of the [screen](#ScreenReview), current [document](#DocumentReview) or current [object](#ObjectReview) by character, word or line. + + + + +line: 818 + + +This is mostly useful in places (including Windows command consoles) where there is no [system caret](#SystemCaret). + + + + +line: 819 + + +For example, you might use it to review the text of a long information message in a dialog. + + + + +line: 821 + + +When moving the review cursor, the System caret does not follow along, so you can review text without losing your editing position. + + + + +line: 822 + + +However, by default, when the System caret moves, the review cursor follows along. + + + + +line: 823 + + +This can be toggled on and off. + + + + +line: 825 + + +Note: Braille following the review cursor can be configured via [Braille Tether](#BrailleTether). + + + + +line: 827 + + +The following commands are available for reviewing text: + + + + +line: 830 +prefix: | +suffix: | + + + Name |Desktop key |Laptop key |Touch |Description + + + + +line: 832 +prefix: | +suffix: | + + +Move to top line in review |shift+numpad7 |NVDA+control+home |none |Moves the review cursor to the top line of the text + + + + +line: 833 +prefix: | +suffix: | + + +Move to previous line in review |numpad7 |NVDA+upArrow |flick up (text mode) |Moves the review cursor to the previous line of text + + + + +line: 834 +prefix: | +suffix: | + + +Report current line in review |numpad8 |NVDA+shift+. |none |Announces the current line of text where the review cursor is positioned. Pressing twice spells the line. Pressing three times spells the line using character descriptions. + + + + +line: 835 +prefix: | +suffix: | + + +Move to next line in review |numpad9 |NVDA+downArrow |flick down (text mode) |Move the review cursor to the next line of text + + + + +line: 836 +prefix: | +suffix: | + + +Move to bottom line in review |shift+numpad9 |NVDA+control+end |none |Moves the review cursor to the bottom line of text + + + + +line: 837 +prefix: | +suffix: | + + +Move to previous word in review |numpad4 |NVDA+control+leftArrow |2-finger flick left (text mode) |Moves the review cursor to the previous word in the text + + + + +line: 838 +prefix: | +suffix: | + + +Report current word in review |numpad5 |NVDA+control+. |none |Announces the current word in the text where the review cursor is positioned. Pressing twice spells the word. Pressing three times spells the word using character descriptions. + + + + +line: 839 +prefix: | +suffix: | + + +Move to next word in review |numpad6 |NVDA+control+rightArrow |2-finger flick right (text mode) |Move the review cursor to the next word in the text + + + + +line: 840 +prefix: | +suffix: | + + +Move to start of line in review |shift+numpad1 |NVDA+home |none |Moves the review cursor to the start of the current line in the text + + + + +line: 841 +prefix: | +suffix: | + + +Move to previous character in review |numpad1 |NVDA+leftArrow |flick left (text mode) |Moves the review cursor to the previous character on the current line in the text + + + + +line: 842 +prefix: | +suffix: | + + +Report current character in review |numpad2 |NVDA+. |none |Announces the current character on the line of text where the review cursor is positioned. Pressing twice reports a description or example of that character. Pressing three times reports the numeric value of the character in decimal and hexadecimal. + + + + +line: 843 +prefix: | +suffix: | + + +Move to next character in review |numpad3 |NVDA+rightArrow |flick right (text mode) |Move the review cursor to the next character on the current line of text + + + + +line: 844 +prefix: | +suffix: | + + +Move to end of line in review |shift+numpad3 |NVDA+end |none |Moves the review cursor to the end of the current line of text + + + + +line: 845 +prefix: | +suffix: | + + +Move to previous page in review |`NVDA+pageUp` |`NVDA+shift+pageUp` |none |Moves the review cursor to the previous page of text if supported by the application + + + + +line: 846 +prefix: | +suffix: | + + +Move to next page in review |`NVDA+pageDown` |`NVDA+shift+pageDown` |none |Moves the review cursor to the next page of text if supported by the application + + + + +line: 847 +prefix: | +suffix: | + + +Say all with review |numpadPlus |NVDA+shift+a |3-finger flick down (text mode) |Reads from the current position of the review cursor, moving it as it goes + + + + +line: 848 +prefix: | +suffix: | + + +Select then Copy from review cursor |NVDA+f9 |NVDA+f9 |none |Starts the select then copy process from the current position of the review cursor. The actual action is not performed until you tell NVDA where the end of the text range is + + + + +line: 849 +prefix: | +suffix: | + + +Select then Copy to review cursor |NVDA+f10 |NVDA+f10 |none |On the first press, text is selected from the position previously set as start marker up to and including the review cursor's current position. If the system caret can reach the text, it will be moved to the selected text. After pressing this key stroke a second time, the text will be copied to the Windows clipboard + + + + +line: 850 +prefix: | +suffix: | + + +Move to marked start for copy in review |NVDA+shift+f9 |NVDA+shift+f9 |none |Moves the review cursor to the position previously set start marker for copy + + + + +line: 851 +prefix: | +suffix: | + + +Report text formatting |NVDA+shift+f |NVDA+shift+f |none |Reports the formatting of the text where the review cursor is currently situated. Pressing twice shows the information in browse mode + + + + +line: 852 +prefix: | +suffix: | + + +Report current symbol replacement |None |None |none |Speaks the symbol where the review cursor is positioned. Pressed twice, shows the symbol and the text used to speak it in browse mode. + + + + +line: 856 + + +Note: numpad keys require the Num Lock to be turned off to work properly. + + + + +line: 858 + + +A good way to remember the basic text review commands when using the Desktop layout is to think of them as being in a grid of three by three, with top to bottom being line, word and character and left to right being previous, current and next. + + + + +line: 859 + + +The layout is illustrated as follows: + + + + +line: 863 +prefix: | +suffix: | + + +Previous line |Current line |Next line + + + + +line: 864 +prefix: | +suffix: | + + +Previous word |Current word |Next word + + + + +line: 865 +prefix: | +suffix: | + + +Previous character |Current character |Next character + + + + +line: 867 +prefix: ### +suffix: {#ReviewModes} + + +Review Modes + + + + +line: 869 + + +NVDA's [text review commands](#ReviewingText) can review content within the current navigator object, current document or screen, depending on the review mode selected. + + + + +line: 871 + + +The following commands switch between review modes: + + + + +line: 874 +prefix: | +suffix: | + + + Name |Desktop key |Laptop key |Touch |Description + + + + +line: 876 +prefix: | +suffix: | + + +Switch to next review mode |NVDA+numpad7 |NVDA+pageUp |2-finger flick up |switches to the next available review mode + + + + +line: 877 +prefix: | +suffix: | + + +Switch to previous review mode |NVDA+numpad1 |NVDA+pageDown |2-finger flick down |switches to the previous available review mode + + + + +line: 881 +prefix: #### +suffix: {#ObjectReview} + + +Object Review + + + + +line: 883 + + +While in object review mode, you are able to only review the content of the current [navigator object](#ObjectNavigation). + + + + +line: 884 + + +For objects such as editable text fields or other basic text controls, this will generally be the text content. + + + + +line: 885 + + +For other objects, this may be the name and/or value. + + + + +line: 887 +prefix: #### +suffix: {#DocumentReview} + + +Document Review + + + + +line: 889 + + +When the [navigator object](#ObjectNavigation) is within a browse mode document (e.g. web page) or other complex document (e.g. a Lotus Symphony document), it is possible to switch to the document review mode. + + + + +line: 890 + + +The document review mode allows you to review the text of the entire document. + + + + +line: 892 + + +When switching from object review to document review, the review cursor is placed in the document at the position of the navigator object. + + + + +line: 893 + + +When moving around the document with review commands, the navigator object is automatically updated to the object found at the current review cursor position. + + + + +line: 895 + + +Note that NVDA will switch to document review from object review automatically when moving around browse mode documents. + + + + +line: 897 +prefix: #### +suffix: {#ScreenReview} + + +Screen Review + + + + +line: 899 + + +The screen review mode allows you to review the text of the screen as it appears visually within the current application. + + + + +line: 900 + + +This is similar to the screen review or mouse cursor functionality in many other Windows screen readers. + + + + +line: 902 + + +When switching to screen review mode, the review cursor is placed at the screen position of the current [navigator object](#ObjectNavigation). + + + + +line: 903 + + +When moving around the screen with review commands, the navigator object is automatically updated to the object found at the screen position of the review cursor. + + + + +line: 905 + + +Note that in some newer applications, NVDA may not see some or all text displayed on the screen due to the use of newer screen drawing technologies which are impossible to support at this time. + + + + +line: 907 +prefix: ### +suffix: {#NavigatingWithTheMouse} + + +Navigating with the Mouse + + + + +line: 909 + + +When you move the mouse, NVDA by default reports the text that is directly under the mouse pointer as the pointer moves over it. + + + + +line: 910 + + +Where supported, NVDA will read the surrounding paragraph of text, though some controls may only read by line. + + + + +line: 912 + + +NVDA can be configured to also announce the type of [object](#Objects) under the mouse as it moves (e.g. list, button, etc.). + + + + +line: 913 + + +This may be useful for totally blind users, as sometimes, the text isn't enough. + + + + +line: 915 + + +NVDA provides a way for users to understand where the mouse is located relative to the dimensions of the screen by playing the current mouse coordinates as audio beeps. + + + + +line: 916 + + +The higher the mouse is on the screen, the higher the pitch of the beeps. + + + + +line: 917 + + +The further left or right the mouse is located on the screen, the further left or right the sound will be played (assuming the user has stereo speakers or headphones). + + + + +line: 919 + + +These extra mouse features are not turned on by default in NVDA. + + + + +line: 920 + + +If you wish to take advantage of them, you can configure them from the [Mouse settings](#MouseSettings) category of the [NVDA Settings](#NVDASettings) dialog, found in the NVDA Preferences menu. + + + + +line: 922 + + +Although a physical mouse or trackpad should be used to navigate with the mouse, NVDA provides some commands related to the mouse: + + + + +line: 926 +prefix: | +suffix: | + + + Name |Desktop key |Laptop key |Touch |Description + + + + +line: 928 +prefix: | +suffix: | + + +Left mouse button click |numpadDivide |NVDA+[ |none |Clicks the left mouse button once. The common double click can be performed by pressing this key twice in quick succession + + + + +line: 929 +prefix: | +suffix: | + + +Left mouse button lock |shift+numpadDivide |NVDA+control+[ |none |Locks the left mouse button down. Press again to release it. To drag the mouse, press this key to lock the left button down and then move the mouse either physically or use one of the other mouse routing commands + + + + +line: 930 +prefix: | +suffix: | + + +Right mouse click |numpadMultiply |NVDA+] |tap and hold |Clicks the right mouse button once, mostly used to open context menu at the location of the mouse. + + + + +line: 931 +prefix: | +suffix: | + + +Right mouse button lock |shift+numpadMultiply |NVDA+control+] |none |Locks the right mouse button down. Press again to release it. To drag the mouse, press this key to lock the right button down and then move the mouse either physically or use one of the other mouse routing commands + + + + +line: 932 +prefix: | +suffix: | + + +Scroll up at the mouse position |none |none |none |Scrolls the mouse wheel up at the current mouse position + + + + +line: 933 +prefix: | +suffix: | + + +Scroll down at the mouse position|none |none |none |Scrolls the mouse wheel down at the current mouse position + + + + +line: 934 +prefix: | +suffix: | + + +Scroll left at the mouse position |none |none |none |Scrolls the mouse wheel left at the current mouse position + + + + +line: 935 +prefix: | +suffix: | + + +Scroll right at the mouse position |none |none |none |Scrolls the mouse wheel right at the current mouse position + + + + +line: 936 +prefix: | +suffix: | + + +Move mouse to current navigator object |NVDA+numpadDivide |NVDA+shift+m |none |Moves the mouse to the location of the current navigator object and review cursor + + + + +line: 937 +prefix: | +suffix: | + + +Navigate to the object under the mouse |NVDA+numpadMultiply |NVDA+shift+n |none |Set the navigator object to the object located at the position of the mouse + + + + +line: 941 +prefix: ## +suffix: {#BrowseMode} + + +Browse Mode + + + + +line: 943 + + +Complex read-only documents such as web pages are browsed in NVDA using browse mode. + + + + +line: 944 + + +This includes documents in the following applications: + + + + +line: 946 +prefix: * + + +Mozilla Firefox + + + + +line: 947 +prefix: * + + +Microsoft Internet Explorer + + + + +line: 948 +prefix: * + + +Mozilla Thunderbird + + + + +line: 949 +prefix: * + + +HTML messages in Microsoft Outlook + + + + +line: 950 +prefix: * + + +Google Chrome + + + + +line: 951 +prefix: * + + +Microsoft Edge + + + + +line: 952 +prefix: * + + +Adobe Reader + + + + +line: 953 +prefix: * + + +Foxit Reader + + + + +line: 954 +prefix: * + + +Supported books in Amazon Kindle for PC + + + + +line: 956 + + +Browse mode is also optionally available for Microsoft Word documents. + + + + +line: 958 + + +In browse mode, the content of the document is made available in a flat representation that can be navigated with the cursor keys as if it were a normal text document. + + + + +line: 959 + + +All of NVDA's [system caret](#SystemCaret) key commands will work in this mode; e.g. say all, report formatting, table navigation commands, etc. + + + + +line: 960 + + +When [Visual Highlight](#VisionFocusHighlight) is enabled, the location of the virtual browse mode caret is also exposed visually. + + + + +line: 961 + + +Information such as whether text is a link, heading, etc. is reported along with the text as you move. + + + + +line: 963 + + +Sometimes, you will need to interact directly with controls in these documents. + + + + +line: 964 + + +For example, you will need to do this for editable text fields and lists so that you can type characters and use the cursor keys to work with the control. + + + + +line: 965 + + +You do this by switching to focus mode, where almost all keys are passed to the control. + + + + +line: 966 + + +When in Browse mode, by default, NVDA will automatically switch to focus mode if you tab to or click on a particular control that requires it. + + + + +line: 967 + + +Conversely, tabbing to or clicking on a control that does not require focus mode will switch back to browse mode. + + + + +line: 968 + + +You can also press enter or space to switch to focus mode on controls that require it. + + + + +line: 969 + + +Pressing escape will switch back to browse mode. + + + + +line: 970 + + +In addition, you can manually force focus mode, after which it will remain in effect until you choose to disable it. + + + + +line: 974 +prefix: | +suffix: | + + + Name |Key |Description + + + + +line: 976 +prefix: | +suffix: | + + +Toggle browse/focus modes |NVDA+space |Toggles between focus mode and browse mode + + + + +line: 977 +prefix: | +suffix: | + + +Exit focus mode |escape |Switches back to browse mode if focus mode was previously switched to automatically + + + + +line: 978 +prefix: | +suffix: | + + +Refresh browse mode document |NVDA+f5 |Reloads the current document content (useful if certain content seems to be missing from the document. Not available in Microsoft Word and Outlook.) + + + + +line: 979 +prefix: | +suffix: | + + +Find |NVDA+control+f |Pops up a dialog in which you can type some text to find in the current document. See [searching for text](#SearchingForText) for more information. + + + + +line: 980 +prefix: | +suffix: | + + +Find next |NVDA+f3 |Finds the next occurrence of the text in the document that you previously searched for + + + + +line: 981 +prefix: | +suffix: | + + +Find previous |NVDA+shift+f3 |Finds the previous occurrence of the text in the document you previously searched for + + + + +line: 985 +prefix: ### +suffix: {#SingleLetterNavigation} + + +Single Letter Navigation + + + + +line: 987 + + +While in browse mode, for quicker navigation, NVDA also provides single character keys to jump to certain fields in the document. + + + + +line: 988 + + +Note that not all of these commands are supported in every type of document. + + + + +line: 991 + + +The following keys by themselves jump to the next available element, while adding the shift key causes them to jump to the previous element: + + + + +line: 993 +prefix: * + + +h: heading + + + + +line: 994 +prefix: * + + +l: list + + + + +line: 995 +prefix: * + + +i: list item + + + + +line: 996 +prefix: * + + +t: table + + + + +line: 997 +prefix: * + + +k: link + + + + +line: 998 +prefix: * + + +n: nonLinked text + + + + +line: 999 +prefix: * + + +f: form field + + + + +line: 1000 +prefix: * + + +u: unvisited link + + + + +line: 1001 +prefix: * + + +v: visited link + + + + +line: 1002 +prefix: * + + +e: edit field + + + + +line: 1003 +prefix: * + + +b: button + + + + +line: 1004 +prefix: * + + +x: checkbox + + + + +line: 1005 +prefix: * + + +c: combo box + + + + +line: 1006 +prefix: * + + +r: radio button + + + + +line: 1007 +prefix: * + + +q: block quote + + + + +line: 1008 +prefix: * + + +s: separator + + + + +line: 1009 +prefix: * + + +m: frame + + + + +line: 1010 +prefix: * + + +g: graphic + + + + +line: 1011 +prefix: * + + +d: landmark + + + + +line: 1012 +prefix: * + + +o: embedded object (audio and video player, application, dialog, etc.) + + + + +line: 1013 +prefix: * + + +1 to 6: headings at levels 1 to 6 respectively + + + + +line: 1014 +prefix: * + + +a: annotation (comment, editor revision, etc.) + + + + +line: 1015 +prefix: * + + +`p`: text paragraph + + + + +line: 1016 +prefix: * + + +w: spelling error + + + + +line: 1018 + + +To move to the beginning or end of containing elements such as lists and tables: + + + + +line: 1020 +prefix: | +suffix: | + + + Name |Key |Description + + + + +line: 1022 +prefix: | +suffix: | + + +Move to start of container |shift+comma |Moves to the start of the container (list, table, etc.) where the caret is positioned + + + + +line: 1023 +prefix: | +suffix: | + + +Move past end of container |comma |Moves past the end of the container (list, table, etc.) where the caret is positioned + + + + +line: 1027 + + +Some web applications such as Gmail, Twitter and Facebook use single letters as shortcut keys. + + + + +line: 1028 + + +If you want to use these while still being able to use your cursor keys to read in browse mode, you can temporarily disable NVDA's single letter navigation keys. + + + + +line: 1030 + + +To toggle single letter navigation on and off for the current document, press NVDA+shift+space. + + + + +line: 1033 +prefix: #### +suffix: {#TextNavigationCommand} + + +Text paragraph navigation command + + + + +line: 1035 + + +You can jump to the next or previous text paragraph by pressing `p` or `shift+p`. + + + + +line: 1036 + + +Text paragraphs are defined by a group of text that appears to be written in complete sentences. + + + + +line: 1037 + + +This can be useful to find the beginning of readable content on various webpages, such as: + + + + +line: 1039 +prefix: * + + +News websites + + + + +line: 1040 +prefix: * + + +Forums + + + + +line: 1041 +prefix: * + + +Blog posts + + + + +line: 1043 + + +These commands can also be helpful for skipping certain kinds of clutter, such as: + + + + +line: 1045 +prefix: * + + +Ads + + + + +line: 1046 +prefix: * + + +Menus + + + + +line: 1047 +prefix: * + + +Headers + + + + +line: 1049 + + +Please note, however, that while NVDA tries its best to identify text paragraphs, the algorithm is not perfect and at times can make mistakes. + + + + +line: 1050 + + +Additionally, this command is different from paragraph navigation commands `control+downArrow/upArrow`. + + + + +line: 1051 + + +Text paragraph navigation only jumps between text paragraphs, while paragraph navigation commands take the cursor to the previous/next paragraphs regardless of whether they contain text or not. + + + + +line: 1053 +prefix: #### +suffix: {#OtherNavigationCommands} + + +Other navigation commands + + + + +line: 1055 + + +In addition to the quick navigation commands listed above, NVDA has commands that have no default keys assigned. + + + + +line: 1056 + + +To use these commands, you first need to assign gestures to them using the [Input Gestures dialog](#InputGestures). + + + + +line: 1057 + + +Here is a list of available commands: + + + + +line: 1059 +prefix: * + + +Article + + + + +line: 1060 +prefix: * + + +Figure + + + + +line: 1061 +prefix: * + + +Grouping + + + + +line: 1062 +prefix: * + + +Tab + + + + +line: 1063 +prefix: * + + +Menu item + + + + +line: 1064 +prefix: * + + +Toggle button + + + + +line: 1065 +prefix: * + + +Progress bar + + + + +line: 1066 +prefix: * + + +Math formula + + + + +line: 1067 +prefix: * + + +Vertically aligned paragraph + + + + +line: 1068 +prefix: * + + +Same style text + + + + +line: 1069 +prefix: * + + +Different style text + + + + +line: 1071 + + +Keep in mind that there are two commands for each type of element, for moving forward in the document and backward in the document, and you must assign gestures to both commands in order to be able to quickly navigate in both directions. + + + + +line: 1072 + + +For example, if you want to use the `y` / `shift+y` keys to quickly navigate through tabs, you would do the following: + + + + +line: 1074 +prefix: 1. + + +Open input gestures dialog from browse mode. + + + + +line: 1075 +prefix: 1. + + +Find "moves to the next tab" item in the Browse mode section. + + + + +line: 1076 +prefix: 1. + + +Assign `y` key for found gesture. + + + + +line: 1077 +prefix: 1. + + +Find "moves to the previous tab" item. + + + + +line: 1078 +prefix: 1. + + +Assign `shift+y` for found gesture. + + + + +line: 1080 +prefix: ### +suffix: {#ElementsList} + + +The Elements List + + + + +line: 1082 + + +The elements list provides access to a list of various types of elements in the document as appropriate for the application. + + + + +line: 1083 + + +For example, in web browsers, the elements list can list links, headings, form fields, buttons or landmarks. + + + + +line: 1084 + + +Radio buttons allow you to switch between the different types of elements. + + + + +line: 1085 + + +An edit field is also provided in the dialog which allows you to filter the list to help you search for a particular item on the page. + + + + +line: 1086 + + +Once you have chosen an item, you can use the provided buttons in the dialog to move to or activate that item. + + + + +line: 1089 +prefix: | +suffix: | + + + Name |Key |Description + + + + +line: 1091 +prefix: | +suffix: | + + +Browse mode elements list |NVDA+f7 |Lists various types of elements in the current document + + + + +line: 1095 +prefix: ### +suffix: {#SearchingForText} + + +Searching for text + + + + +line: 1097 + + +This dialog allows you to search for terms in the current document. + + + + +line: 1098 + + +In the "Type the text you wish to find" field, the text to be found can be entered. + + + + +line: 1099 + + +The "Case sensitive" checkbox makes the search consider uppercase and lowercase letters differently. + + + + +line: 1100 + + +For example, with "Case sensitive" selected you can find "NV Access" but not "nv access". + + + + +line: 1101 + + +Use the following keys for performing searches: + + + + +line: 1104 +prefix: | +suffix: | + + + Name |Key |Description + + + + +line: 1106 +prefix: | +suffix: | + + +Find text |NVDA+control+f |Opens the search dialog + + + + +line: 1107 +prefix: | +suffix: | + + +Find next |NVDA+f3 |searches the next occurrence of the current search term + + + + +line: 1108 +prefix: | +suffix: | + + +Find previous |NVDA+shift+f3 |searches the previous occurrence of the current search term + + + + +line: 1112 +prefix: ### +suffix: {#ImbeddedObjects} + + +Embedded Objects + + + + +line: 1114 + + +Pages can include rich content using technologies such as Oracle Java and HTML5, as well as applications and dialogs. + + + + +line: 1115 + + +Where these are encountered in browse mode, NVDA will report "embedded object", "application" or "dialog", respectively. + + + + +line: 1116 + + +You can quickly move to them using the o and shift+o embedded object single letter navigation keys. + + + + +line: 1117 + + +To interact with these objects, you can press enter on them. + + + + +line: 1118 + + +If it is accessible, you can then tab around it and interact with it like any other application. + + + + +line: 1119 + + +A key command is provided to return to the original page containing the embedded object: + + + + +line: 1122 +prefix: | +suffix: | + + + Name |Key |Description + + + + +line: 1124 +prefix: | +suffix: | + + +Move to containing browse mode document |NVDA+control+space |Moves the focus out of the current embedded object and into the document that contains it + + + + +line: 1128 +prefix: ### +suffix: {#NativeSelectionMode} + + +Native Selection Mode + + + + +line: 1130 + + +By default when selecting text with the `shift+arrow` keys in Browse Mode, a selection is only made within NVDA's Browse Mode representation of the document, and not within the application itself. + + + + +line: 1131 + + +This means that the selection is not visible on screen, and copying text with `control+c` will only copy NVDA's plain text representation of the content. i.e. formatting of tables, or whether something is a link will not be copied. + + + + +line: 1132 + + +However, NVDA has a Native Selection Mode which can be turned on in particular Browse Mode documents (so far only Mozilla Firefox) which causes the document's native selection to follow NVDA's Browse Mode selection. + + + + +line: 1136 +prefix: | +suffix: | + + + Name |Key |Description + + + + +line: 1138 +prefix: | +suffix: | + + +Toggle Native Selection Mode on and off |`NVDA+shift+f10` |Toggles native selection mode on and off + + + + +line: 1142 + + +When Native Selection Mode is turned on, copying the selection with `control+c` will also use the application's own copy functionality, meaning that rich content will be copied to the clipboard, rather than plain text. + + + + +line: 1143 + + +This means that pasting this content into a program such as Microsoft Word or Excel, formatting such as tables, or whether something is a link will be included. + + + + +line: 1144 + + +Please note however that in native selection mode, some accessible labels or other information that NVDA generates in Browse Mode will not be included. + + + + +line: 1145 + + +Also, although the application will try its best to match the native selection to NVDA's Browse Mode selection, it may not always be completely accurate. + + + + +line: 1146 + + +However, for scenarios where you wish to copy an entire table or paragraph of rich content, this feature should prove useful. + + + + +line: 1148 +prefix: ## +suffix: {#ReadingMath} + + +Reading Mathematical Content + + + + +line: 1150 + + +NVDA can read and navigate mathematical content on the web and in other applications, providing access in both speech and braille. + + + + +line: 1151 + + +However, in order for NVDA to read and interact with mathematical content, you will first need to install a Math component for NvDA. + + + + +line: 1152 + + +There are several NVDA add-ons available in the NVDA Add-on Store that provide support for math, including the [MathCAT NVDA add-on](https://nsoiffer.github.io/MathCAT/) and [Access8Math](https://github.com/tsengwoody/Access8Math). + + + + +line: 1153 + + +Please refer to the [Add-on Store section](#AddonsManager) to learn how to browse and install available add-ons in NVDA. + + + + +line: 1154 + + +NVDA also can make use of the older [MathPlayer](https://info.wiris.com/mathplayer-info) software from Wiris if found on your system, though this software is no longer maintained. + + + + +line: 1156 +prefix: ### +suffix: {#SupportedMathContent} + + +Supported math content + + + + +line: 1158 + + +With an appropriate math component installed, NVDA supports the following types of mathematical content: + + + + +line: 1160 +prefix: * + + +MathML in Mozilla Firefox, Microsoft Internet Explorer and Google Chrome. + + + + +line: 1161 +prefix: * + + +Microsoft Word 365 Modern Math Equations via UI automation: + + + + +line: 1162 + + +NVDA is able to read and interact with math equations in Microsoft Word 365/2016 build 14326 and higher. + + + + +line: 1163 + + +Note however that any previously created MathType equations must be first converted to Office Math. + + + + +line: 1164 + + +This can be done by selecting each and choosing "Equation Options", then "Convert to Office Math" in the context menu. + + + + +line: 1165 + + +Ensure your version of MathType is the latest version before doing this. + + + + +line: 1166 + + +Microsoft Word provides linear symbol-based navigation through the equations itself and supports inputting math using several syntaxes, including LateX. + + + + +line: 1167 + + +For further details, please see [Linear format equations using UnicodeMath and LaTeX in Word](https://support.microsoft.com/en-us/office/linear-format-equations-using-unicodemath-and-latex-in-word-2e00618d-b1fd-49d8-8cb4-8d17f25754f8) + + + + +line: 1168 +prefix: * + + +Microsoft Powerpoint, and older versions of Microsoft Word: + + + + +line: 1169 + + +NVDA can read and navigate MathType equations in both Microsoft Powerpoint and Microsoft word. + + + + +line: 1170 + + +MathType needs to be installed in order for this to work. + + + + +line: 1171 + + +The trial version is sufficient. + + + + +line: 1172 + + +It can be downloaded from the [MathType presentation page](https://www.wiris.com/en/mathtype/). + + + + +line: 1173 +prefix: * + + +Adobe Reader: + + + + +line: 1174 + + +Note that this is not an official standard yet, so there is currently no publicly available software that can produce this content. + + + + +line: 1175 +prefix: * + + +Kindle Reader for PC: + + + + +line: 1176 + + +NVDA can read and navigate Math in Kindle for PC for books with accessible math. + + + + +line: 1178 + + +When reading a document, NVDA will speak any supported mathematical content where it occurs. + + + + +line: 1179 + + +If you are using a braille display, it will also be displayed in braille. + + + + +line: 1181 +prefix: ### +suffix: {#InteractiveNavigation} + + +Interactive Navigation + + + + +line: 1183 + + +If you are working primarily with speech, in most cases, you will probably wish to examine the expression in smaller segments, rather than hearing the entire expression at once. + + + + +line: 1185 + + +If you are in browse mode, you can do this by moving the cursor to the mathematical content and pressing enter. + + + + +line: 1187 + + +If you are not in browse mode: + + + + +line: 1189 +prefix: 1. + + +move the review cursor to the mathematical content. + + + + +line: 1190 + + +By default, the review cursor follows the system caret, so you can usually use the system caret to move to the desired content. + + + + +line: 1191 +prefix: 1. + + +Then, activate the following command: + + + + +line: 1195 +prefix: | +suffix: | + + + Name |Key |Description + + + + +line: 1197 +prefix: | +suffix: | + + +Interact with math content |NVDA+alt+m |Begins interaction with math content. + + + + +line: 1201 + + +At this point, NVDA will enter Math mode, where you can use commands such as the arrow keys to explore the expression. + + + + +line: 1202 + + +For example, you can move through the expression with the left and right arrow keys and zoom into a portion of the expression such as a fraction using the down arrow key. + + + + +line: 1204 + + +When you wish to return to the document, simply press the escape key. + + + + +line: 1206 + + +For more information on available commands and preferences for reading and navigating within math content, please refer to the documentation for your particular math component you have installed. + + + + +line: 1208 +prefix: * + + +[MathCAT documentation](https://nsoiffer.github.io/MathCAT/users.html) + + + + +line: 1209 +prefix: * + + +[Access8Math documentation](https://github.com/tsengwoody/Access8Math) + + + + +line: 1210 +prefix: * + + +[MathPlayer documentation](https://docs.wiris.com/mathplayer/en/mathplayer-user-manual.html) + + + + +line: 1212 + + +Sometimes mathematical content might be displayed as a button or other type of element which, when activated, can display a dialog or more information related to the formula. + + + + +line: 1213 + + +To activate the button or the element containing the formula, press ctrl+enter. + + + + +line: 1215 +prefix: ### +suffix: {#InstallingMathPlayer} + + +Installing MathPlayer + + + + +line: 1217 + + +Although it is generally recommended to use one of the newer NVDA add-ons to support math in NVDA, in certain limited scenarios MathPlayer may still be a more suitable choice. + + + + +line: 1218 + + +E.g. MathPlayer may support a particular language or Braille code that is unsupported in newer add-ons. + + + + +line: 1219 + + +MathPlayer is available for free from the Wiris website. + + + + +line: 1220 + + +[Download MathPlayer](https://downloads.wiris.com/mathplayer/MathPlayerSetup.exe). + + + + +line: 1221 + + +After installing MathPlayer, you will need to restart NVDA. + + + + +line: 1222 + + +Please note that information about MathPlayer may state that it is only for older browsers such as Internet Explorer 8. + + + + +line: 1223 + + +This is only referring to using MathPlayer to display mathematical content visually, and can be ignored by those using it to read or navigate math with NVDA. + + + + +line: 1225 +prefix: ## +suffix: {#Braille} + + +Braille + + + + +line: 1227 + + +If you own a braille display, NVDA can display information in braille. + + + + +line: 1228 + + +If your braille display has a Perkins-style keyboard, you can also enter contracted or uncontracted braille. + + + + +line: 1229 + + +Braille can also be displayed on screen using the [Braille Viewer](#BrailleViewer) instead of, or at the same time as, using a physical braille display. + + + + +line: 1231 + + +Please see the [Supported Braille Displays](#SupportedBrailleDisplays) section for information about the supported braille displays. + + + + +line: 1232 + + +This section also contains information about what displays support NVDA's automatic background braille display detection functionality. + + + + +line: 1233 + + +You can configure braille using the [Braille category](#BrailleSettings) of the [NVDA Settings](#NVDASettings) dialog. + + + + +line: 1235 +prefix: ### +suffix: {#BrailleAbbreviations} + + +Control Type, State and Landmark abbreviations + + + + +line: 1237 + + +In order to fit as much information as possible on a braille display, the following abbreviations have been defined to indicate control type and state as well as landmarks. + + + + +line: 1239 +prefix: | +suffix: | + + + Abbreviation |Control type + + + + +line: 1241 +prefix: | +suffix: | + + +app |application + + + + +line: 1242 +prefix: | +suffix: | + + +art |article + + + + +line: 1243 +prefix: | +suffix: | + + +bqt |block quote + + + + +line: 1244 +prefix: | +suffix: | + + +btn |button + + + + +line: 1245 +prefix: | +suffix: | + + +drbtn |drop down button + + + + +line: 1246 +prefix: | +suffix: | + + +spnbtn |spin button + + + + +line: 1247 +prefix: | +suffix: | + + +splbtn |split button + + + + +line: 1248 +prefix: | +suffix: | + + +tgbtn |toggle button + + + + +line: 1249 +prefix: | +suffix: | + + +cap |caption + + + + +line: 1250 +prefix: | +suffix: | + + +cbo |combo box + + + + +line: 1251 +prefix: | +suffix: | + + +chk |checkbox + + + + +line: 1252 +prefix: | +suffix: | + + +dlg |dialog + + + + +line: 1253 +prefix: | +suffix: | + + +doc |document + + + + +line: 1254 +prefix: | +suffix: | + + +edt |editable text field + + + + +line: 1255 +prefix: | +suffix: | + + +pwdedt |password edit + + + + +line: 1256 +prefix: | +suffix: | + + +embedded |embedded object + + + + +line: 1257 +prefix: | +suffix: | + + +enote |end note + + + + +line: 1258 +prefix: | +suffix: | + + +fig |figure + + + + +line: 1259 +prefix: | +suffix: | + + +fnote |foot note + + + + +line: 1260 +prefix: | +suffix: | + + +gra |graphic + + + + +line: 1261 +prefix: | +suffix: | + + +grp |grouping + + + + +line: 1262 +prefix: | +suffix: | + + +hN |heading at level n, e.g. h1, h2. + + + + +line: 1263 +prefix: | +suffix: | + + +hlp |help balloon + + + + +line: 1264 +prefix: | +suffix: | + + +lmk |landmark + + + + +line: 1265 +prefix: | +suffix: | + + +lnk |link + + + + +line: 1266 +prefix: | +suffix: | + + +vlnk |visited link + + + + +line: 1267 +prefix: | +suffix: | + + +lst |list + + + + +line: 1268 +prefix: | +suffix: | + + +mnu |menu + + + + +line: 1269 +prefix: | +suffix: | + + +mnubar |menu bar + + + + +line: 1270 +prefix: | +suffix: | + + +mnubtn |menu button + + + + +line: 1271 +prefix: | +suffix: | + + +mnuitem |menu item + + + + +line: 1272 +prefix: | +suffix: | + + +pnl |panel + + + + +line: 1273 +prefix: | +suffix: | + + +prgbar |progress bar + + + + +line: 1274 +prefix: | +suffix: | + + +bsyind |busy indicator + + + + +line: 1275 +prefix: | +suffix: | + + +rbtn |radio button + + + + +line: 1276 +prefix: | +suffix: | + + +scrlbar |scroll bar + + + + +line: 1277 +prefix: | +suffix: | + + +sect |section + + + + +line: 1278 +prefix: | +suffix: | + + +stbar |status bar + + + + +line: 1279 +prefix: | +suffix: | + + +tabctl |tab control + + + + +line: 1280 +prefix: | +suffix: | + + +tbl |table + + + + +line: 1281 +prefix: | +suffix: | + + +cN |table column number n, e.g. c1, c2. + + + + +line: 1282 +prefix: | +suffix: | + + +rN |table row number n, e.g. r1, r2. + + + + +line: 1283 +prefix: | +suffix: | + + +term |terminal + + + + +line: 1284 +prefix: | +suffix: | + + +tlbar |tool bar + + + + +line: 1285 +prefix: | +suffix: | + + +tltip |tool tip + + + + +line: 1286 +prefix: | +suffix: | + + +tv |tree view + + + + +line: 1287 +prefix: | +suffix: | + + +tvbtn |tree view button + + + + +line: 1288 +prefix: | +suffix: | + + +tvitem |tree view item + + + + +line: 1289 +prefix: | +suffix: | + + +lv N |a tree view item has a hierarchical level N + + + + +line: 1290 +prefix: | +suffix: | + + +wnd |window + + + + +line: 1291 +prefix: | +suffix: | + + +⠤⠤⠤⠤⠤ |separator + + + + +line: 1292 +prefix: | +suffix: | + + +mrkd |marked content + + + + +line: 1294 + + +The following state indicators are also defined: + + + + +line: 1296 +prefix: | +suffix: | + + + Abbreviation |Control state + + + + +line: 1298 +prefix: | +suffix: | + + +... |displayed when an object supports autocompletion + + + + +line: 1299 +prefix: | +suffix: | + + +⢎⣿⡱ |displayed when an object (e.g. a toggle button) is pressed + + + + +line: 1300 +prefix: | +suffix: | + + +⢎⣀⡱ |displayed when an object (e.g. a toggle button) is not pressed + + + + +line: 1301 +prefix: | +suffix: | + + +⣏⣿⣹ |displayed when an object (e.g. a checkbox) is checked + + + + +line: 1302 +prefix: | +suffix: | + + +⣏⣸⣹ |displayed when an object (e.g. a checkbox) is half checked + + + + +line: 1303 +prefix: | +suffix: | + + +⣏⣀⣹ |displayed when an object (e.g. a checkbox) is not checked + + + + +line: 1304 +prefix: | +suffix: | + + +- |displayed when an object (e.g. a tree view item) is collapsible + + + + +line: 1305 +prefix: | +suffix: | + + ++ |displayed when an object (e.g. a tree view item) is Expandable + + + + +line: 1306 +prefix: | +suffix: | + + +*** |displayed when a protected control or document is encountered + + + + +line: 1307 +prefix: | +suffix: | + + +clk |displayed when an object is clickable + + + + +line: 1308 +prefix: | +suffix: | + + +cmnt |displayed when there is a comment for a spreadsheet cell or piece of text in a document + + + + +line: 1309 +prefix: | +suffix: | + + +frml |displayed when there is a formula on a spreadsheet cell + + + + +line: 1310 +prefix: | +suffix: | + + +invalid |displayed when an invalid entry has been made + + + + +line: 1311 +prefix: | +suffix: | + + +ldesc |displayed when an object (usually a graphic) has a long description + + + + +line: 1312 +prefix: | +suffix: | + + +mln |displayed when an edit field allows typing multiple lines of text such as comment fields on websites + + + + +line: 1313 +prefix: | +suffix: | + + +req |displayed when a required form field is encountered + + + + +line: 1314 +prefix: | +suffix: | + + +ro |displayed when an object (e.g. an editable text field) is read-only + + + + +line: 1315 +prefix: | +suffix: | + + +sel |displayed when an object is selected + + + + +line: 1316 +prefix: | +suffix: | + + +nsel |displayed when an object is not selected + + + + +line: 1317 +prefix: | +suffix: | + + +sorted asc |displayed when an object is sorted ascending + + + + +line: 1318 +prefix: | +suffix: | + + +sorted desc |displayed when an object is sorted descending + + + + +line: 1319 +prefix: | +suffix: | + + +submnu |displayed when an object has a popup (usually a sub-menu) + + + + +line: 1321 + + +Finally, the following abbreviations for landmarks are defined: + + + + +line: 1323 +prefix: | +suffix: | + + + Abbreviation |Landmark + + + + +line: 1325 +prefix: | +suffix: | + + +bnnr |banner + + + + +line: 1326 +prefix: | +suffix: | + + +cinf |content info + + + + +line: 1327 +prefix: | +suffix: | + + +cmpl |complementary + + + + +line: 1328 +prefix: | +suffix: | + + +form |form + + + + +line: 1329 +prefix: | +suffix: | + + +main |main + + + + +line: 1330 +prefix: | +suffix: | + + +navi |navigation + + + + +line: 1331 +prefix: | +suffix: | + + +srch |search + + + + +line: 1332 +prefix: | +suffix: | + + +rgn |region + + + + +line: 1334 +prefix: ### +suffix: {#BrailleInput} + + +Braille Input + + + + +line: 1336 + + +NVDA supports entry of both uncontracted and contracted braille via a braille keyboard. + + + + +line: 1337 + + +You can select the translation table used to translate braille into text using the [Input table](#BrailleSettingsInputTable) setting in the Braille category of the [NVDA Settings](#NVDASettings) dialog. + + + + +line: 1339 + + +When uncontracted braille is being used, text is inserted as soon as it is entered. + + + + +line: 1340 + + +When using contracted braille, text is inserted when you press space or enter at the end of a word. + + + + +line: 1341 + + +Note that translation can only reflect the braille word you are typing and cannot consider existing text. + + + + +line: 1342 + + +For example, if you are using a braille code that begins numbers with a number sign and you press backspace to move to the end of a number, you will need to type the number sign again to enter additional numbers. + + + + +line: 1345 + + +Pressing dot 7 erases the last entered braille cell or character. + + + + +line: 1346 + + +Dot 8 translates any braille input and presses the enter key. + + + + +line: 1347 + + +Pressing dot 7 + dot 8 translates any braille input, but without adding a space or pressing enter. + + + + +line: 1350 +prefix: #### +suffix: {#BrailleKeyboardShortcuts} + + +Inputting keyboard shortcuts + + + + +line: 1352 + + +NVDA supports inputting keyboard shortcuts and emulating keypresses using the braille display. + + + + +line: 1353 + + +This emulation comes in two forms: assigning a Braille input directly to some key press and using the virtual modifier keys. + + + + +line: 1355 + + +Commonly-used keys, such as the arrow keys or pressing Alt to reach menus, can be mapped directly to Braille inputs. + + + + +line: 1356 + + +The driver for each Braille display comes pre-equipped with some of these assignments. + + + + +line: 1357 + + +You can change these assignments or add new emulated keys from the [Input Gestures dialog](#InputGestures). + + + + +line: 1359 + + +While this approach is useful for commonly-pressed or unique keys (such as Tab), you may not want to assign a unique set of keys to each keyboard shortcut. + + + + +line: 1360 + + +To allow emulating keypresses where modifier keys are held down, NVDA provides commands to toggle the control, alt, shift, windows, and NVDA keys, along with commands for some combinations of those keys. + + + + +line: 1361 + + +To use these toggles, first press the command (or sequence of commands) for the modifier keys you want pressed. + + + + +line: 1362 + + +Then input the character that's part of the keyboard shortcut you want to input. + + + + +line: 1363 + + +For example, to produce control+f, use the "Toggle control key" command and then type an f, + + + + +line: 1364 + + +and to input control+alt+t, use either the "Toggle control key" and "Toggle alt key" commands, in either order, or the "Toggle control and alt keys" command, followed by typing a t. + + + + +line: 1366 + + +If you accidentally toggle modifier keys, running the toggle command again will remove the modifier. + + + + +line: 1368 + + +When typing in contracted Braille, using the modifier toggle keys will cause your input to be translated just as if you had pressed dots 7+8. + + + + +line: 1369 + + +In addition, the emulated keypress cannot reflect Braille typed before the modifier key was pressed. + + + + +line: 1370 + + +This means that, to type alt+2 with a Braille code that uses a number sign, you must first toggle Alt and then type a number sign. + + + + +line: 1372 +prefix: ## +suffix: {#Vision} + + +Vision + + + + +line: 1374 + + +While NVDA is primarily aimed at blind or vision impaired people who primarily use speech and/or braille to operate a computer, it also provides built-in facilities to change the contents of the screen. + + + + +line: 1375 + + +Within NVDA, such a visual aid is called a vision enhancement provider. + + + + +line: 1377 + + +NVDA offers several built-in vision enhancement providers which are described below. + + + + +line: 1378 + + +Additional vision enhancement providers can be provided in [NVDA add-ons](#AddonsManager). + + + + +line: 1380 + + +NVDA's vision settings can be changed in the [vision category](#VisionSettings) of the [NVDA Settings](#NVDASettings) dialog. + + + + +line: 1382 +prefix: ### +suffix: {#VisionFocusHighlight} + + +Visual Highlight + + + + +line: 1384 + + +Visual Highlight can help to identify the [system focus](#SystemFocus), [navigator object](#ObjectNavigation) and [browse mode](#BrowseMode) positions. + + + + +line: 1385 + + +These positions are highlighted with a coloured rectangle outline. + + + + +line: 1387 +prefix: * + + +Solid blue highlights a combined navigator object and system focus location (e.g. because [the navigator object follows the system focus](#ReviewCursorFollowFocus)). + + + + +line: 1388 +prefix: * + + +Dashed blue highlights just the system focus object. + + + + +line: 1389 +prefix: * + + +Solid pink highlights just the navigator object. + + + + +line: 1390 +prefix: * + + +Solid yellow highlights the virtual caret used in browse mode (where there is no physical caret such as in web browsers). + + + + +line: 1392 + + +When Visual Highlight is enabled in the [vision category](#VisionSettings) of the [NVDA Settings](#NVDASettings) dialog, you can [change whether or not to highlight the focus, navigator object or browse mode caret](#VisionSettingsFocusHighlight). + + + + +line: 1394 +prefix: ### +suffix: {#VisionScreenCurtain} + + +Screen Curtain + + + + +line: 1396 + + +As a blind or vision impaired user, it is often not possible or necessary to see the contents of the screen. + + + + +line: 1397 + + +Furthermore, it might be hard to ensure that there isn't someone looking over your shoulder. + + + + +line: 1398 + + +For this situation, NVDA contains a feature called "Screen Curtain" which can be enabled to make the screen black. + + + + +line: 1400 + + +You can enable the Screen Curtain in the [vision category](#VisionSettings) of the [NVDA Settings](#NVDASettings) dialog. + + + + +line: 1404 +prefix: | +suffix: | + + + Name |Key |Description + + + + +line: 1406 +prefix: | +suffix: | + + +Toggles the state of the screen curtain |`NVDA+control+escape` |Enable to make the screen black or disable to show the contents of the screen. Pressed once, screen curtain is enabled until you restart NVDA. Pressed twice, screen curtain is enabled until you disable it. + + + + +line: 1410 + + +When the Screen Curtain is active some tasks directly based on what appears on the screen such as performing [OCR](#Win10Ocr) or taking a screenshot cannot be achieved. + + + + +line: 1412 + + +Due to a change in the Windows Magnification API, Screen Curtain had to be updated to support the newest versions of Windows. + + + + +line: 1413 + + +Use NVDA 2021.2 to activate Screen Curtain with Windows 10 21H2 (10.0.19044) or later. + + + + +line: 1414 + + +For security purposes, when using a new version of Windows, get visual confirmation that the Screen Curtain makes the screen entirely black. + + + + +line: 1416 + + +Please note that while Windows Magnifier is running and inverted screen colors are being used, the screen curtain cannot be enabled. + + + + +line: 1418 +prefix: ## +suffix: {#ContentRecognition} + + +Content Recognition + + + + +line: 1420 + + +When authors don't provide sufficient information for a screen reader user to determine the content of something, various tools can be used to attempt to recognize the content from an image. + + + + +line: 1421 + + +NVDA supports the optical character recognition (OCR) functionality built into Windows 10 and later to recognize text from images. + + + + +line: 1422 + + +Additional content recognizers can be provided in NVDA add-ons. + + + + +line: 1424 + + +When you use a content recognition command, NVDA recognizes content from the current [navigator object](#ObjectNavigation). + + + + +line: 1425 + + +By default, the navigator object follows the system focus or browse mode cursor, so you can usually just move the focus or browse mode cursor where desired. + + + + +line: 1426 + + +For example, if you move the browse mode cursor to a graphic, recognition will recognize content from the graphic by default. + + + + +line: 1427 + + +However, you may wish to use object navigation directly to, for example, recognize the content of an entire application window. + + + + +line: 1429 + + +Once recognition is complete, the result will be presented in a document similar to browse mode, allowing you to read the information with cursor keys, etc. + + + + +line: 1430 + + +Pressing enter or space will activate (normally click) the text at the cursor if possible. + + + + +line: 1431 + + +Pressing escape dismisses the recognition result. + + + + +line: 1433 +prefix: ### +suffix: {#Win10Ocr} + + +Windows OCR + + + + +line: 1435 + + +Windows 10 and later includes OCR for many languages. + + + + +line: 1436 + + +NVDA can use this to recognize text from images or inaccessible applications. + + + + +line: 1438 + + +You can set the language to use for text recognition in the [Windows OCR category](#Win10OcrSettings) of the [NVDA Settings](#NVDASettings) dialog. + + + + +line: 1439 + + +Additional languages can be installed by opening the Start menu, choosing Settings, selecting Time & Language -> Region & Language and then choosing Add a language. + + + + +line: 1441 + + +When you want to monitor constantly changing content, such as when watching a video with subtitles, you can optionally enable automatic refresh of the recognized content. + + + + +line: 1442 + + +This can also be done in the [Windows OCR category](#Win10OcrSettings) of the [NVDA Settings](#NVDASettings) dialog. + + + + +line: 1444 + + +Windows OCR may be partially or fully incompatible with [NVDA vision enhancements](#Vision) or other external visual aids. You will need to disable these aids before proceeding to a recognition. + + + + +line: 1447 + + +To recognize the text in the current navigator object using Windows OCR, press NVDA+r. + + + + +line: 1450 +prefix: ## +suffix: {#ApplicationSpecificFeatures} + + +Application Specific Features + + + + +line: 1452 + + +NVDA provides its own extra features for some applications to make certain tasks easier or to provide access to functionality which is not otherwise accessible to screen reader users. + + + + +line: 1454 +prefix: ### +suffix: {#MicrosoftWord} + + +Microsoft Word + + + + +line: 1455 +prefix: #### +suffix: {#WordAutomaticColumnAndRowHeaderReading} + + +Automatic Column and Row Header Reading + + + + +line: 1457 + + +NVDA is able to automatically announce appropriate row and column headers when navigating around tables in Microsoft Word. + + + + +line: 1458 + + +This requires that the Report Table row / column headers option in NVDA's Document Formatting settings, found in the [NVDA Settings](#NVDASettings) dialog, be turned on. + + + + +line: 1460 + + +If you use [UIA to access Word documents](#MSWordUIA), which is default in recent versions of Word and Windows, the cells of the first row will automatically be considered as column headers; similarly, the cells of the first column will automatically be considered as row headers. + + + + +line: 1462 + + +On the contrary, if you do not use [UIA to access Word documents](#MSWordUIA), you will have to indicate to NVDA which row or column contains the headers in any given table. + + + + +line: 1463 + + +After moving to the first cell in the column or row containing the headers, use one of the following commands: + + + + +line: 1466 +prefix: | +suffix: | + + + Name |Key |Description + + + + +line: 1468 +prefix: | +suffix: | + + +Set column headers |NVDA+shift+c |Pressing this once tells NVDA this is the first header cell in the row that contains column headers, which should be automatically announced when moving between columns below this row. Pressing twice will clear the setting. + + + + +line: 1469 +prefix: | +suffix: | + + +Set row headers |NVDA+shift+r |Pressing this once tells NVDA this is the first header cell in the column that contains row headers, which should be automatically announced when moving between rows after this column. Pressing twice will clear the setting. + + + + +line: 1472 + + +These settings will be stored in the document as bookmarks compatible with other screen readers such as JAWS. + + + + +line: 1473 + + +This means that users of other screen readers who open this document at a later date will automatically have the row and column headers already set. + + + + +line: 1475 +prefix: #### +suffix: {#BrowseModeInMicrosoftWord} + + +Browse Mode in Microsoft Word + + + + +line: 1477 + + +Similar to the web, Browse mode can be used in Microsoft Word to allow you to use features such as Quick navigation and the Elements List. + + + + +line: 1479 + + +To toggle Browse mode on and off in Microsoft Word, press NVDA+space. + + + + +line: 1481 + + +For further information about Browse mode and Quick Navigation, see the [Browse Mode section](#BrowseMode). + + + + +line: 1483 +prefix: ##### +suffix: {#WordElementsList} + + +The Elements List + + + + +line: 1486 + + +While in Browse mode in Microsoft Word, you can access the Elements List by pressing NVDA+f7. + + + + +line: 1488 + + +The Elements List can list headings, links, annotations (which includes comments and track changes) and errors (currently limited to spelling errors). + + + + +line: 1490 +prefix: #### +suffix: {#WordReportingComments} + + +Reporting Comments + + + + +line: 1493 + + +To report any comments at the current caret position, press `NVDA+alt+c`. + + + + +line: 1494 + + +Pressing twice shows the information in a browsable message. + + + + +line: 1496 + + +All comments for the document, along with other tracked changes, can also be listed in the NVDA Elements List when selecting Annotations as the type. + + + + +line: 1498 +prefix: ### +suffix: {#MicrosoftExcel} + + +Microsoft Excel + + + + +line: 1499 +prefix: #### +suffix: {#ExcelAutomaticColumnAndRowHeaderReading} + + +Automatic Column and Row Header Reading + + + + +line: 1501 + + +NVDA is able to automatically announce appropriate row and column headers when navigating around Excel worksheets. + + + + +line: 1502 + + +This firstly requires that the Report Table row / column headers option in NVDA's Document Formatting settings, found in the [NVDA Settings](#NVDASettings) dialog, be turned on. + + + + +line: 1503 + + +Secondly, NVDA needs to know which row or column contains the headers. + + + + +line: 1504 + + +After moving to the first cell in the column or row containing the headers, use one of the following commands: + + + + +line: 1507 +prefix: | +suffix: | + + + Name |Key |Description + + + + +line: 1509 +prefix: | +suffix: | + + +Set column headers |NVDA+shift+c |Pressing this once tells NVDA this is the first header cell in the row that contains column headers, which should be automatically announced when moving between columns below this row. Pressing twice will clear the setting. + + + + +line: 1510 +prefix: | +suffix: | + + +Set row headers |NVDA+shift+r |Pressing this once tells NVDA this is the first header cell in the column that contains row headers, which should be automatically announced when moving between rows after this column. Pressing twice will clear the setting. + + + + +line: 1513 + + +These settings will be stored in the workbook as defined name ranges compatible with other screen readers such as JAWS. + + + + +line: 1514 + + +This means that users of other screen readers who open this workbook at a later date will automatically have the row and column headers already set. + + + + +line: 1516 +prefix: #### +suffix: {#ExcelElementsList} + + +The Elements List + + + + +line: 1518 + + +Similar to the web, NVDA has an Elements List for Microsoft Excel that allows you to list and access several different types of information. + + + + +line: 1520 + + +To access the Elements List in Excel, press NVDA+f7. + + + + +line: 1522 + + +The various types of information available in the Elements List are: + + + + +line: 1524 +prefix: * + + +Charts: This lists all charts in the active worksheet. + + + + +line: 1525 + + +Selecting a chart and pressing enter or the Move to button focuses the chart for navigating and reading with the arrow keys. + + + + +line: 1526 +prefix: * + + +Comments: This lists all cells in the active worksheet containing comments. + + + + +line: 1527 + + +The cell address along with its comments are shown for each cell. + + + + +line: 1528 + + +Pressing enter or the Move To button when on a listed comment will move directly to that cell. + + + + +line: 1529 +prefix: * + + +Formulas: This lists all cells in the worksheet containing a formula. + + + + +line: 1530 + + +The cell address along with its formula are shown for each cell. + + + + +line: 1531 + + +Pressing enter or the Move To button on a listed formula will move directly to that cell. + + + + +line: 1532 +prefix: * + + +Sheets: This lists all sheets in the workbook. + + + + +line: 1533 + + +Pressing f2 when on a listed sheet allows you to rename the sheet. + + + + +line: 1534 + + +Pressing enter or the Move To button while on the listed sheet will switch to that sheet. + + + + +line: 1535 +prefix: * + + +Form fields: This lists all form fields in the active worksheet. + + + + +line: 1536 + + +For each form field, the Elements List shows the alternative text of the field along with the addresses of the cells it covers. + + + + +line: 1537 + + +Selecting a form field and pressing enter or the Move to button moves to that field in browse mode. + + + + +line: 1539 +prefix: #### +suffix: {#ExcelReportingComments} + + +Reporting Notes + + + + +line: 1542 + + +To report any notes for the currently focused cell, press `NVDA+alt+c`. + + + + +line: 1543 + + +Pressing twice shows the information in a browsable message. + + + + +line: 1544 + + +In Microsoft 2016, 365 and newer, the classic comments in Microsoft Excel have been renamed to "notes". + + + + +line: 1546 + + +All notes for the worksheet can also be listed in the NVDA Elements List after pressing NVDA+f7. + + + + +line: 1548 + + +NVDA can also display a specific dialog for adding or editing a certain note. + + + + +line: 1549 + + +NVDA overrides the native MS Excel notes editing region due to accessibility constraints, but the key stroke for displaying the dialog is inherited from MS Excel and therefore works also without NVDA running. + + + + +line: 1551 + + +To add or edit a certain note, in a focused cell, press shift+f2. + + + + +line: 1554 + + +This key stroke does not appear and cannot be changed in NVDA's input gesture dialog. + + + + +line: 1556 + + +Note: it is possible to open the note editing region in MS Excel also from the context menu of any cell of the work sheet. + + + + +line: 1557 + + +However, this will open the inaccessible note editing region and not the NVDA specific note editing dialog. + + + + +line: 1559 + + +In Microsoft Office 2016, 365 and newer, a new style comment dialog has been added. + + + + +line: 1560 + + +This dialog is accessible and provides more features such as replying to comments, etc. + + + + +line: 1561 + + +It can also be opened from the context menu of a certain cell. + + + + +line: 1562 + + +The comments added to the cells via the new style comment dialog are not related to "notes". + + + + +line: 1564 +prefix: #### +suffix: {#ExcelReadingProtectedCells} + + +Reading Protected Cells + + + + +line: 1566 + + +If a workbook has been protected, it may not be possible to move focus to particular cells that have been locked for editing. + + + + +line: 1568 + + +To allow moving to locked cells, switch to Browse Mode by pressing NVDA+space, and then use standard Excel movement commands such as the arrow keys to move around all cells on the current worksheet. + + + + +line: 1571 +prefix: #### +suffix: {#ExcelFormFields} + + +Form Fields + + + + +line: 1573 + + +Excel worksheets can include form fields. + + + + +line: 1574 + + +You can access these using the Elements List or the f and shift+f form field single letter navigation keys. + + + + +line: 1575 + + +Once you move to a form field in browse mode, you can press enter or space to either activate it or switch to focus mode so you can interact with it, depending on the control. + + + + +line: 1576 + + +For further information about Browse mode and single letter navigation, see the [Browse Mode section](#BrowseMode). + + + + +line: 1578 +prefix: ### +suffix: {#MicrosoftPowerPoint} + + +Microsoft PowerPoint + + + + +line: 1582 +prefix: | +suffix: | + + + Name |Key |Description + + + + +line: 1584 +prefix: | +suffix: | + + +Toggle speaker notes reading |control+shift+s |When in a running slide show, this command will toggle between the speaker notes for the slide and the content for the slide. This only affects what NVDA reads, not what is displayed on screen. + + + + +line: 1588 +prefix: ### +suffix: {#Foobar2000} + + +foobar2000 + + + + +line: 1592 +prefix: | +suffix: | + + + Name |Key |Description + + + + +line: 1594 +prefix: | +suffix: | + + +Report remaining time |control+shift+r |Reports the remaining time of the currently playing track, if any. + + + + +line: 1595 +prefix: | +suffix: | + + +Report elapsed time |control+shift+e |Reports the elapsed time of the currently playing track, if any. + + + + +line: 1596 +prefix: | +suffix: | + + +Report track length |control+shift+t |Reports the length of the currently playing track, if any. + + + + +line: 1600 + + +Note: The above shortcuts work only with the default formatting string for foobar's status line. + + + + +line: 1602 +prefix: ### +suffix: {#MirandaIM} + + +Miranda IM + + + + +line: 1606 +prefix: | +suffix: | + + + Name |Key |Description + + + + +line: 1608 +prefix: | +suffix: | + + +Report recent message |NVDA+control+1-4 |Reports one of the recent messages, depending on the number pressed; e.g. NVDA+control+2 reads the second most recent message. + + + + +line: 1612 +prefix: ### +suffix: {#Poedit} + + +Poedit + + + + +line: 1614 + + +NVDA offers enhanced support for Poedit 3.4 or newer. + + + + +line: 1618 +prefix: | +suffix: | + + + Name |Key |Description + + + + +line: 1620 +prefix: | +suffix: | + + +Report notes for translators |`control+shift+a` |Reports any notes for translators. If pressed twice, presents the notes in browse mode + + + + +line: 1621 +prefix: | +suffix: | + + +Report Comment |`control+shift+c` |Reports any comment in the comments window. If pressed twice, presents the comment in browse mode + + + + +line: 1622 +prefix: | +suffix: | + + +Report Old Source Text |`control+shift+o` |Reports the old source text, if any. If pressed twice, presents the text in browse mode + + + + +line: 1623 +prefix: | +suffix: | + + +Report Translation Warning |`control+shift+w` |Reports a translation warning, if any. If pressed twice, presents the warning in browse mode + + + + +line: 1627 +prefix: ### +suffix: {#Kindle} + + +Kindle for PC + + + + +line: 1629 + + +NVDA supports reading and navigating books in Amazon Kindle for PC. + + + + +line: 1630 + + +This functionality is only available in Kindle books designated with "Screen Reader: Supported" which you can check on the details page for the book. + + + + +line: 1632 + + +Browse mode is used to read books. + + + + +line: 1633 + + +It is enabled automatically when you open a book or focus the book area. + + + + +line: 1634 + + +The page will be turned automatically as appropriate when you move the cursor or use the say all command. + + + + +line: 1636 + + +You can manually turn to the next page with the pageDown key and turn to the previous page with the pageUp key. + + + + +line: 1639 + + +Single letter navigation is supported for links and graphics, but only within the current page. + + + + +line: 1640 + + +Navigating by link also includes footnotes. + + + + +line: 1642 + + +NVDA provides early support for reading and interactive navigation of mathematical content for books with accessible math. + + + + +line: 1643 + + +Please see the [Reading Mathematical Content](#ReadingMath) section for further information. + + + + +line: 1645 +prefix: #### +suffix: {#KindleTextSelection} + + +Text Selection + + + + +line: 1647 + + +Kindle allows you to perform various functions on selected text, including obtaining a dictionary definition, adding notes and highlights, copying the text to the clipboard and searching the web. + + + + +line: 1648 + + +To do this, first select text as you normally would in browse mode; e.g. by using shift and the cursor keys. + + + + +line: 1650 + + +Once you have selected text, press the applications key or shift+f10 to show the available options for working with the selection. + + + + +line: 1652 + + +If you do this with no text selected, options will be shown for the word at the cursor. + + + + +line: 1654 +prefix: #### +suffix: {#KindleUserNotes} + + +User Notes + + + + +line: 1656 + + +You can add a note regarding a word or passage of text. + + + + +line: 1657 + + +To do this, first select the relevant text and access the selection options as described above. + + + + +line: 1658 + + +Then, choose Add Note. + + + + +line: 1660 + + +When reading in browse mode, NVDA refers to these notes as comments. + + + + +line: 1662 + + +To view, edit or delete a note: + + + + +line: 1664 +prefix: 1. + + +Move the cursor to the text containing the note. + + + + +line: 1665 +prefix: 1. + + +Access the options for the selection as described above. + + + + +line: 1666 +prefix: 1. + + +Choose Edit Note. + + + + +line: 1668 +prefix: ### +suffix: {#Azardi} + + +Azardi + + + + +line: 1671 + + +When in the table view of added books: + + + + +line: 1673 +prefix: | +suffix: | + + + Name |Key |Description + + + + +line: 1675 +prefix: | +suffix: | + + +Enter |enter |Opens the selected book. + + + + +line: 1676 +prefix: | +suffix: | + + +Context menu |applications |Opens the context menu for the selected book. + + + + +line: 1680 +prefix: ### +suffix: {#WinConsole} + + +Windows Console + + + + +line: 1682 + + +NVDA provides support for the Windows command console used by Command Prompt, PowerShell, and the Windows Subsystem for Linux. + + + + +line: 1683 + + +The console window is of fixed size, typically much smaller than the buffer that holds the output. + + + + +line: 1684 + + +As new text is written, the content scroll upwards and previous text is no longer visible. + + + + +line: 1685 + + +On Windows versions before Windows 11 22H2, text in the console that is not visibly displayed in the window is not accessible with NVDA's text review commands. + + + + +line: 1686 + + +Therefore, it is necessary to scroll the console window to read earlier text. + + + + +line: 1687 + + +In newer versions of the console and in Windows Terminal, it is possible to review the entire text buffer freely without the need to scroll the window. + + + + +line: 1689 + + +The following built-in Windows Console keyboard shortcuts may be useful when [reviewing text](#ReviewingText) with NVDA in older versions of Windows Console: + + + + +line: 1691 +prefix: | +suffix: | + + + Name |Key |Description + + + + +line: 1693 +prefix: | +suffix: | + + +Scroll up |control+upArrow |Scrolls the console window up, so earlier text can be read. + + + + +line: 1694 +prefix: | +suffix: | + + +Scroll down |control+downArrow |Scrolls the console window down, so later text can be read. + + + + +line: 1695 +prefix: | +suffix: | + + +Scroll to start |control+home |Scrolls the console window to the beginning of the buffer. + + + + +line: 1696 +prefix: | +suffix: | + + +Scroll to end |control+end |Scrolls the console window to the end of the buffer. + + + + +line: 1700 +prefix: ## +suffix: {#ConfiguringNVDA} + + +Configuring NVDA + + + + +line: 1702 + + +Most configuration can be performed using dialog boxes accessed through the Preferences sub-menu of the NVDA menu. + + + + +line: 1703 + + +Many of these settings can be found in the multi-page [NVDA Settings dialog](#NVDASettings). + + + + +line: 1704 + + +In all dialog boxes, press the OK button to accept any changes you have made. + + + + +line: 1705 + + +To cancel any changes, press the Cancel button or the escape key. + + + + +line: 1706 + + +For certain dialogs, you can press the Apply button to let the settings take effect immediately without closing the dialog. + + + + +line: 1707 + + +Most NVDA dialogs support context help. + + + + +line: 1709 + + +When in a dialog, pressing `f1` opens the User Guide at the paragraph related to the focused setting or the current dialog. + + + + +line: 1711 + + +Some settings can also be changed using shortcut keys, which are listed where relevant in the sections below. + + + + +line: 1713 +prefix: ### +suffix: {#NVDASettings} + + +NVDA Settings + + + + +line: 1715 +prefix: <!-- KC:settingsSection: +suffix: --> + + +|| Name | Desktop key | Laptop key | Description | + + + + +line: 1716 + + +NVDA provides many configuration parameters that can be changed using the settings dialog. + + + + +line: 1717 + + +To make it easier to find the kind of settings you want to change, the dialog displays a list of configuration categories to choose from. + + + + +line: 1718 + + +When you select a category, all of the settings related to it will be shown in the dialog. + + + + +line: 1719 + + +To move between categories, use `tab` or `shift+tab` to reach the list of categories, and then use the up and down arrow keys to navigate the list. + + + + +line: 1720 + + +From anywhere in the dialog, you may also move forward one category by pressing `ctrl+tab`, or back one category by pressing `shift+ctrl+tab`. + + + + +line: 1722 + + +Once you change one or more settings, the settings can be applied using the apply button, in which case the dialog will stay open, allowing you to change more settings or choose another category. + + + + +line: 1723 + + +If you want to save your settings and close the NVDA Settings dialog, you can use the OK button. + + + + +line: 1725 + + +Some settings categories have dedicated shortcut keys. + + + + +line: 1726 + + +If pressed, the shortcut key will open the NVDA Settings dialog directly to that particular category. + + + + +line: 1727 + + +By default, not all categories can be accessed with keyboard commands. + + + + +line: 1728 + + +If you frequently access categories that do not have dedicated shortcut keys, you may wish to use the [Input Gestures dialog](#InputGestures) to add a custom gesture such as a keyboard command or touch gesture for that category. + + + + +line: 1730 + + +The settings categories found in the NVDA Settings dialog will be outlined below. + + + + +line: 1732 +prefix: #### +suffix: {#GeneralSettings} + + +General + + + + +line: 1736 +prefix: ##### +suffix: {#OpenGeneralSettings} + + +Open General settings + + + + +line: 1738 + + +Key: `NVDA+control+g` + + + + +line: 1740 + + +The General category of the NVDA Settings dialog sets NVDA's overall behaviour such as interface language and whether or not it should check for updates. + + + + +line: 1741 + + +This category contains the following options: + + + + +line: 1743 +prefix: ##### +suffix: {#GeneralSettingsLanguage} + + +Language + + + + +line: 1745 + + +This is a combo box which allows you to select the language that NVDA's user interface and messages should be shown in. + + + + +line: 1746 + + +There are many languages, however the default option is "User Default, Windows". + + + + +line: 1747 + + +This option tells NVDA to use the language that Windows is currently set to. + + + + +line: 1749 + + +Please note that NVDA must be restarted when changing the language. + + + + +line: 1750 + + +When the confirmation dialog appears, select "restart now" or "restart later" if you wish to use the new language now or at a later time, respectively. If "restart later" is selected, the configuration must be saved (either manually or using the save on exit functionality). + + + + +line: 1752 +prefix: ##### +suffix: {#GeneralSettingsSaveConfig} + + +Save configuration on exit + + + + +line: 1754 + + +This option is a checkbox that, when checked, tells NVDA to automatically save the current configuration when you exit NVDA. + + + + +line: 1756 +prefix: ##### +suffix: {#GeneralSettingsShowExitOptions} + + +Show exit options when exiting NVDA + + + + +line: 1758 + + +This option is a checkbox that allows you to choose whether or not a dialog appears when you exit NVDA that asks what action you want to perform. + + + + +line: 1759 + + +When checked, a dialog will appear when you attempt to exit NVDA asking whether you want to exit, restart, restart with add-ons disabled or install pending updates (if any). + + + + +line: 1760 + + +When unchecked, NVDA will exit immediately. + + + + +line: 1762 +prefix: ##### +suffix: {#GeneralSettingsPlaySounds} + + +Play sounds when starting or exiting NVDA + + + + +line: 1764 + + +This option is a checkbox that, when checked, tells NVDA to play sounds when it starts or exits. + + + + +line: 1766 +prefix: ##### +suffix: {#GeneralSettingsLogLevel} + + +Logging level + + + + +line: 1768 + + +This is a combo box that lets you choose how much NVDA will log as it's running. + + + + +line: 1769 + + +Generally users should not need to touch this as not too much is logged. + + + + +line: 1770 + + +However, if you wish to provide information in a bug report, or enable or disable logging altogether, then it may be a useful option. + + + + +line: 1772 + + +The available logging levels are: + + + + +line: 1774 +prefix: * + + +Disabled: Apart from a brief startup message, NVDA will not log anything while it runs. + + + + +line: 1775 +prefix: * + + +Info: NVDA will log basic information such as startup messages and information useful for developers. + + + + +line: 1776 +prefix: * + + +Debug warning: Warning messages that are not caused by severe errors will be logged. + + + + +line: 1777 +prefix: * + + +Input/output: Input from keyboard and braille displays, as well as speech and braille output will be logged. + + + + +line: 1778 + + +If you are concerned about privacy, do not set the logging level to this option. + + + + +line: 1779 +prefix: * + + +Debug: In addition to info, warning, and input/output messages, additional debug messages will be logged. + + + + +line: 1780 + + +Just like input/output, if you are concerned about privacy, you should not set the logging level to this option. + + + + +line: 1782 +prefix: ##### +suffix: {#GeneralSettingsStartAfterLogOn} + + +Start NVDA after I sign in + + + + +line: 1784 + + +If this option is enabled, NVDA will start automatically as soon as you sign in to Windows. + + + + +line: 1785 + + +This option is only available for installed copies of NVDA. + + + + +line: 1787 +prefix: ##### +suffix: {#GeneralSettingsStartOnLogOnScreen} + + +Use NVDA during sign-in (requires administrator privileges) + + + + +line: 1789 + + +If you sign in to Windows by providing a user name and password, then enabling this option will make NVDA start automatically at the sign-in screen when Windows starts. + + + + +line: 1790 + + +This option is only available for installed copies of NVDA. + + + + +line: 1792 +prefix: ##### +suffix: {#GeneralSettingsCopySettings} + + +Use currently saved settings during sign-in and on secure screens (requires administrator privileges) + + + + +line: 1794 + + +Pressing this button copies your currently saved NVDA user configuration to NVDA's system configuration directory, so that NVDA will use it during sign-in and when running on User Account Control (UAC) and other [secure screens](#SecureScreens). + + + + +line: 1795 + + +To make sure that all your settings are transferred, make sure to save your configuration first with control+NVDA+c or Save configuration in the NVDA menu. + + + + +line: 1796 + + +This option is only available for installed copies of NVDA. + + + + +line: 1798 +prefix: ##### +suffix: {#GeneralSettingsCheckForUpdates} + + +Automatically check for updates to NVDA + + + + +line: 1800 + + +If this is enabled, NVDA will automatically check for updated versions and inform you when an update is available. + + + + +line: 1801 + + +You can also manually check for updates by selecting Check for updates under Help in the NVDA menu. + + + + +line: 1802 + + +When manually or automatically checking for updates, it is necessary for NVDA to send some information to the update server in order to receive the correct update for your system. + + + + +line: 1803 + + +The following information is always sent: + + + + +line: 1805 +prefix: * + + +Current NVDA version + + + + +line: 1806 +prefix: * + + +Operating System version + + + + +line: 1807 +prefix: * + + +Whether the Operating System is 64 or 32 bit + + + + +line: 1809 +prefix: ##### +suffix: {#GeneralSettingsGatherUsageStats} + + +Allow NV Access to gather NVDA usage statistics + + + + +line: 1811 + + +If this is enabled, NV Access will use the information from update checks in order to track the number of NVDA users including particular demographics such as the operating system and country of origin. + + + + +line: 1812 + + +Note that although your IP address will be used to calculate your country during the update check, the IP address is never kept. + + + + +line: 1813 + + +Apart from the mandatory information required to check for updates, the following extra information is also currently sent: + + + + +line: 1815 +prefix: * + + +A unique ID for the current NVDA user, this changes once a month + + + + +line: 1816 +prefix: * + + +NVDA interface language + + + + +line: 1817 +prefix: * + + +Whether this copy of NVDA is portable or installed + + + + +line: 1818 +prefix: * + + +Name of the current speech synthesizer in use (including the name of the add-on the driver comes from) + + + + +line: 1819 +prefix: * + + +Name of the current Braille display in use (including the name of the add-on the driver comes from) + + + + +line: 1820 +prefix: * + + +The current output Braille table (if Braille is in use) + + + + +line: 1822 + + +This information greatly aides NV Access to prioritize future development of NVDA. + + + + +line: 1824 +prefix: ##### +suffix: {#GeneralSettingsNotifyPendingUpdates} + + +Notify for pending updates on startup + + + + +line: 1826 + + +If this is enabled, NVDA will inform you when there is a pending update on startup, offering you the possibility to install it. + + + + +line: 1827 + + +You can also manually install the pending update from the Exit NVDA dialog (if enabled), from the NVDA menu, or when you perform a new check from the Help menu. + + + + +line: 1829 +prefix: #### +suffix: {#SpeechSettings} + + +Speech Settings + + + + +line: 1833 +prefix: ##### +suffix: {#OpenSpeechSettings} + + +Open Speech settings + + + + +line: 1835 + + +Key: `NVDA+control+v` + + + + +line: 1837 + + +The Speech category in the NVDA Settings dialog contains options that lets you change the speech synthesizer as well as voice characteristics for the chosen synthesizer. + + + + +line: 1838 + + +For a quicker alternative way of controlling speech parameters from anywhere, please see the [Synth Settings Ring](#SynthSettingsRing) section. + + + + +line: 1840 + + +The Speech Settings category contains the following options: + + + + +line: 1842 +prefix: ##### +suffix: {#SpeechSettingsChange} + + +Change synthesizer + + + + +line: 1844 + + +The first option in the Speech Settings category is the Change... button. This button activates the [Select Synthesizer](#SelectSynthesizer) dialog, which allows you to select the active speech synthesizer and output device. + + + + +line: 1845 + + +This dialog opens on top of the NVDA Settings dialog. + + + + +line: 1846 + + +Saving or dismissing the settings in the Select Synthesizer dialog will return you to the NVDA Settings dialog. + + + + +line: 1848 +prefix: ##### +suffix: {#SpeechSettingsVoice} + + +Voice + + + + +line: 1850 + + +The Voice option is a combo box listing all the voices of the current synthesizer that you have installed. + + + + +line: 1851 + + +You can use the arrow keys to listen to all the various choices. + + + + +line: 1852 + + +Left and Up arrow take you up in the list, while right and down arrow move you down in the list. + + + + +line: 1854 +prefix: ##### +suffix: {#SpeechSettingsVariant} + + +Variant + + + + +line: 1856 + + +If you are using the Espeak NG synthesizer which is packaged with NVDA, this is a combo box that allows you to select the Variant the synthesizer should speak with. + + + + +line: 1857 + + +ESpeak NG's Variants are rather like voices, as they provide slightly different attributes to the eSpeak NG voice. + + + + +line: 1858 + + +Some variants will sound like a male, some like a female, and some even like a frog. + + + + +line: 1859 + + +If using a third-party synthesizer, you may also be able to change this value if your chosen voice supports it. + + + + +line: 1861 +prefix: ##### +suffix: {#SpeechSettingsRate} + + +Rate + + + + +line: 1863 + + +This option allows you to change the rate of your voice. + + + + +line: 1864 + + +This is a slider that goes from 0 to 100 - 0 being the slowest, 100 being the fastest. + + + + +line: 1866 +prefix: ##### +suffix: {#SpeechSettingsRateBoost} + + +Rate boost + + + + +line: 1868 + + +Enabling this option will significantly increase the speech rate, if supported by the current synthesizer. + + + + +line: 1870 +prefix: ##### +suffix: {#SpeechSettingsPitch} + + +Pitch + + + + +line: 1872 + + +This option allows you to change the pitch of the current voice. + + + + +line: 1873 + + +It is a slider which goes from 0 to 100 - 0 being the lowest pitch and 100 being the highest. + + + + +line: 1875 +prefix: ##### +suffix: {#SpeechSettingsVolume} + + +Volume + + + + +line: 1877 + + +This option is a slider which goes from 0 to 100 - 0 being the lowest volume and 100 being the highest. + + + + +line: 1879 +prefix: ##### +suffix: {#SpeechSettingsInflection} + + +Inflection + + + + +line: 1881 + + +This option is a slider that lets you choose how much inflection (rise and fall in pitch) the synthesizer should use to speak with. + + + + +line: 1883 +prefix: ##### +suffix: {#SpeechSettingsLanguageSwitching} + + +Automatic Language switching + + + + +line: 1885 + + +This checkbox allows you to toggle whether NVDA should switch speech synthesizer languages automatically if the text being read specifies its language. + + + + +line: 1886 + + +This option is enabled by default. + + + + +line: 1888 +prefix: ##### +suffix: {#SpeechSettingsDialectSwitching} + + +Automatic Dialect switching + + + + +line: 1890 + + +This checkbox allows you to toggle whether or not dialect changes should be made, rather than just actual language changes. + + + + +line: 1891 + + +For example, if reading in an English U.S. voice but a document specifies that some text is in English U.K., then the synthesizer will switch accents if this option is enabled. + + + + +line: 1892 + + +This option is disabled by default. + + + + +line: 1896 +prefix: ##### +suffix: {#SpeechSettingsSymbolLevel} + + +Punctuation/Symbol Level + + + + +line: 1898 + + +Key: NVDA+p + + + + +line: 1900 + + +This allows you to choose the amount of punctuation and other symbols that should be spoken as words. + + + + +line: 1901 + + +For example, when set to all, all symbols will be spoken as words. + + + + +line: 1902 + + +This option applies to all synthesizers, not just the currently active synthesizer. + + + + +line: 1904 +prefix: ##### +suffix: {#SpeechSettingsTrust} + + +Trust voice's language when processing characters and symbols + + + + +line: 1906 + + +On by default, this option tells NVDA if the current voice's language can be trusted when processing symbols and characters. + + + + +line: 1907 + + +If you find that NVDA is reading punctuation in the wrong language for a particular synthesizer or voice, you may wish to turn this off to force NVDA to use its global language setting instead. + + + + +line: 1909 +prefix: ##### +suffix: {#SpeechUnicodeNormalization} + + +Unicode normalization + + + + +line: 1912 +prefix: | +suffix: | + + +Options |Default (Disabled), Enabled, Disabled + + + + +line: 1913 +prefix: | +suffix: | + + +Default |Disabled + + + + +line: 1915 + + +When this option is enabled, unicode normalization is performed on the text that is spoken by NVDA. + + + + +line: 1916 + + +This is beneficial when speaking characters that can be represented in several forms. + + + + +line: 1917 + + +NVDA uses the NFKC (Normalization Form Compatibility Composition) algorithm, which provides the following benefits, among others: + + + + +line: 1919 +prefix: 1. + + +The bold and italic versions of characters that are part of the unicode standard and are commonly used on social media are normalized to their most common compatible equivalent. + + + + +line: 1920 + + +For example, the latin letter "h" can also be presented as "𝐡" (bold), "ℎ" (itallic), etc. but will always be spoken as "h" when normalization is enabled. + + + + +line: 1921 + + +This aspect of normalization also aids in reading equations in the Microsoft Word equation editor. + + + + +line: 1923 +prefix: 1. + + +Normalization to composed characters. + + + + +line: 1924 + + +For example, the character "ü" (u with umlaut/diaeresis), a common character in languages like German and Turkish can be represented in two forms: + + + + +line: 1925 +prefix: 1. + + +One stand alone unicode character (ü) + + + + +line: 1926 +prefix: 1. + + +A decomposition into two characters (ü), namely the normal latin letter u and a diaeresis modifier + + + + +line: 1927 + + + Unicode normalization ensures that only one form will be used throughout all speech output, which is the one character variant. + + + + +line: 1929 +prefix: 1. + + +Decomposition of some ligatures, Including "ij" (ligature ij) to their two letter form ("ij"). + + + + +line: 1931 +prefix: 1. + + +Stable ordering of modifiers in composite characters, for example in ancient Hebrew. + + + + +line: 1933 + + +To toggle Unicode normalization from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + + + + +line: 1935 +prefix: ##### +suffix: {#SpeechReportNormalizedForCharacterNavigation} + + +Report "Normalized" when navigating by character + + + + +line: 1937 + + +This setting is a checkbox that, when checked, tells NVDA to explicitly report that a character is normalized when spoken as an individual character such as when spelling. + + + + +line: 1938 + + +For example, when this option is enabled, spelling the character "ij" will pronounce it as "i j normalized". + + + + +line: 1940 + + +Note that this setting is only available when "[Unicode normalization](#SpeechUnicodeNormalization)" is enabled. + + + + +line: 1942 +prefix: ##### +suffix: {#SpeechSettingsCLDR} + + +Include Unicode Consortium data (including emoji) when processing characters and symbols + + + + +line: 1944 + + +When this checkbox is checked, NVDA will include additional symbol pronunciation dictionaries when pronouncing characters and symbols. + + + + +line: 1945 + + +These dictionaries contain descriptions for symbols (particularly emoji) that are provided by the [Unicode Consortium](https://www.unicode.org/consortium/) as part of their [Common Locale Data Repository](http://cldr.unicode.org/). + + + + +line: 1946 + + +If you want NVDA to speak descriptions of emoji characters based on this data, you should enable this option. + + + + +line: 1947 + + +However, if you are using a speech synthesizer that supports speaking emoji descriptions natively, you may wish to turn this off. + + + + +line: 1949 + + +Note that manually added or edited character descriptions are saved as part of your user settings. + + + + +line: 1950 + + +Therefore, if you change the description of a particular emoji, your custom description will be spoken for that emoji regardless of whether this option is enabled. + + + + +line: 1951 + + +You can add, edit or remove symbol descriptions in NVDA's [punctuation/symbol pronunciation dialog](#SymbolPronunciation). + + + + +line: 1953 + + +To toggle Unicode Consortium data inclusion from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + + + + +line: 1955 +prefix: ##### +suffix: {#SpeechSettingsCapPitchChange} + + +Capital pitch change percentage + + + + +line: 1957 + + +This edit field allows you to type the amount that the pitch of the voice will change when speaking a capital letter. + + + + +line: 1958 + + +This value is a percentage, where a negative value lowers the pitch and a positive value raises it. + + + + +line: 1959 + + +For no pitch change you would use 0. + + + + +line: 1960 + + +Usually, NVDA raises the pitch slightly for any capital letter, but some synthesizers may not support this well. + + + + +line: 1961 + + +In case pitch change for capitals is not supported, consider [Say "cap" before capitals](#SpeechSettingsSayCapBefore) and/or [ Beep for capitals](#SpeechSettingsBeepForCaps) instead. + + + + +line: 1963 +prefix: ##### +suffix: {#SpeechSettingsSayCapBefore} + + +Say "cap" before capitals + + + + +line: 1965 + + +This setting is a checkbox that, when checked, tells NVDA to say the word "cap" before any capital letter when spoken as an individual character such as when spelling. + + + + +line: 1967 +prefix: ##### +suffix: {#SpeechSettingsBeepForCaps} + + +Beep for capitals + + + + +line: 1969 + + +If this checkbox is checked, NVDA will make a small beep each time it encounters a capitalized character by itself. + + + + +line: 1971 +prefix: ##### +suffix: {#SpeechSettingsUseSpelling} + + +Use spelling functionality if supported + + + + +line: 1973 + + +Some words consist of only one character, but the pronunciation is different depending on whether the character is being spoken as an individual character (such as when spelling) or a word. + + + + +line: 1974 + + +For example, in English, "a" is both a letter and a word and is pronounced differently in each case. + + + + +line: 1975 + + +This option allows the synthesizer to differentiate between these two cases if the synthesizer supports this. + + + + +line: 1976 + + +Most synthesizers do support it. + + + + +line: 1978 + + +This option should generally be enabled. + + + + +line: 1979 + + +However, some Microsoft Speech API synthesizers do not implement this correctly and behave strangely when it is enabled. + + + + +line: 1980 + + +Synthesizers from Code Factory, both the add-on and the SAPI application, do not implement it correctly either and cause unwanted spelling of the spoken text (e.g. in NVDA menu or dialogs). + + + + +line: 1981 + + +If you are having problems with the pronunciation of individual characters, try disabling this option. + + + + +line: 1983 +prefix: ##### +suffix: {#delayedCharacterDescriptions} + + +Delayed descriptions for characters on cursor movement + + + + +line: 1987 +prefix: | +suffix: | + + +Options |Enabled, Disabled + + + + +line: 1988 +prefix: | +suffix: | + + +Default |Disabled + + + + +line: 1990 + + +When this setting is checked, NVDA will say the character description when you move by characters. + + + + +line: 1992 + + +For example, while reviewing a line by characters, when the letter "b" is read NVDA will say "Bravo" after a 1 second delay. + + + + +line: 1993 + + +This can be useful if it is hard to distinguish between pronunciation of symbols, or for hearing impaired users. + + + + +line: 1995 + + +The delayed character description will be cancelled if other text is spoken during that time, or if you press the `control` key. + + + + +line: 1997 +prefix: ##### +suffix: {#SpeechModesDisabling} + + +Modes available in the Cycle speech mode command + + + + +line: 1999 + + +This checkable list allows selecting which [speech modes](#SpeechModes) are included when cycling between them using `NVDA+s`. + + + + +line: 2000 + + +Modes which are unchecked are excluded. + + + + +line: 2001 + + +By default all modes are included. + + + + +line: 2003 + + +For example if you do not need to use "beeps" and "off" mode you should uncheck these two, and keep both "talk" and "on-demand" checked. + + + + +line: 2004 + + +Note that it is necessary to check at least two modes. + + + + +line: 2006 +prefix: #### +suffix: {#SelectSynthesizer} + + +Select Synthesizer + + + + +line: 2010 +prefix: ##### +suffix: {#OpenSelectSynthesizer} + + +Open Select Synthesizer dialog + + + + +line: 2012 + + +Key: `NVDA+control+s` + + + + +line: 2014 + + +The Synthesizer dialog, which can be opened by activating the Change... button in the speech category of the NVDA settings dialog, allows you to select which Synthesizer NVDA should use to speak with. + + + + +line: 2015 + + +Once you have selected your synthesizer of choice, you can press Ok and NVDA will load the selected Synthesizer. + + + + +line: 2016 + + +If there is an error loading the synthesizer, NVDA will notify you with a message, and continue using the previous synthesizer. + + + + +line: 2018 +prefix: ##### +suffix: {#SelectSynthesizerSynthesizer} + + +Synthesizer + + + + +line: 2020 + + +This option allows you to choose the synthesizer you wish NVDA to use for speech output. + + + + +line: 2022 + + +For a list of the Synthesizers that NVDA supports, please see the [Supported Speech Synthesizers](#SupportedSpeechSynths) section. + + + + +line: 2024 + + +One special item that will always appear in this list is "No speech", which allows you to use NVDA with no speech output whatsoever. + + + + +line: 2025 + + +This may be useful for someone who wishes to only use NVDA with braille, or perhaps to sighted developers who only wish to use the Speech Viewer. + + + + +line: 2027 +prefix: #### +suffix: {#SynthSettingsRing} + + +Synth settings ring + + + + +line: 2029 + + +If you wish to quickly change speech settings without going to the Speech category of the NVDA settings dialog, there are some NVDA key commands that allow you to move through the most common speech settings from anywhere while running NVDA: + + + + +line: 2032 +prefix: | +suffix: | + + + Name |Desktop key |Laptop key |Description + + + + +line: 2034 +prefix: | +suffix: | + + +Move to next synth setting |NVDA+control+rightArrow |NVDA+shift+control+rightArrow |Moves to the next available speech setting after the current, wrapping around to the first setting again after the last + + + + +line: 2035 +prefix: | +suffix: | + + +Move to previous synth setting |NVDA+control+leftArrow |NVDA+shift+control+leftArrow |Moves to the next available speech setting before the current, wrapping around to the last setting after the first + + + + +line: 2036 +prefix: | +suffix: | + + +Increment current synth setting |NVDA+control+upArrow |NVDA+shift+control+upArrow |increases the current speech setting you are on. E.g. increases the rate, chooses the next voice, increases the volume + + + + +line: 2037 +prefix: | +suffix: | + + +Increment the current synth setting in a larger step |`NVDA+control+pageUp` |`NVDA+shift+control+pageUp` |Increases the value of the current speech setting you're on in larger steps. e.g. when you're on a voice setting, it will jump forward every 20 voices; when you're on slider settings (rate, pitch, etc) it will jump forward the value up to 20% + + + + +line: 2038 +prefix: | +suffix: | + + +Decrement current synth setting |NVDA+control+downArrow |NVDA+shift+control+downArrow |decreases the current speech setting you are on. E.g. decreases the rate, chooses the previous voice, decreases the volume + + + + +line: 2039 +prefix: | +suffix: | + + +Decrement the current synth setting in a larger step |`NVDA+control+pageDown` |`NVDA+shift+control+pageDown` |Decreases the value of the current speech setting you're on in larger steps. e.g. when you're on a voice setting, it will jump backward every 20 voices; when you're on a slider setting, it will jump backward the value up to 20% + + + + +line: 2043 +prefix: #### +suffix: {#BrailleSettings} + + +Braille + + + + +line: 2045 + + +The Braille category in the NVDA Settings dialog contains options that let you change several aspects of braille input and output. + + + + +line: 2046 + + +This category contains the following options: + + + + +line: 2048 +prefix: ##### +suffix: {#BrailleSettingsChange} + + +Change braille display + + + + +line: 2050 + + +The Change... button in the Braille category of the NVDA Settings dialog activates the [Select Braille Display](#SelectBrailleDisplay) dialog, which allows you to select the active braille display. + + + + +line: 2051 + + +This dialog opens on top of the NVDA Settings dialog. + + + + +line: 2052 + + +Saving or dismissing the settings in the Select Braille Display dialog will return you to the NVDA Settings dialog. + + + + +line: 2054 +prefix: ##### +suffix: {#BrailleSettingsOutputTable} + + +Output Table + + + + +line: 2056 + + +The next option you will come to in this category is the braille output table combo box. + + + + +line: 2057 + + +In this combo box, you will find braille tables for different languages, braille standards and grades. + + + + +line: 2058 + + +The chosen table will be used to translate text into braille to be presented on your braille display. + + + + +line: 2059 + + +You can move from braille table to braille table in the list by using the arrow keys. + + + + +line: 2061 +prefix: ##### +suffix: {#BrailleSettingsInputTable} + + +Input Table + + + + +line: 2063 + + +Complementary to the previous option, the next setting you will find is the braille input table combo box. + + + + +line: 2064 + + +The chosen table will be used to translate braille entered on your braille display's Perkins-style keyboard into text. + + + + +line: 2065 + + +You can move from braille table to braille table in the list by using the arrow keys. + + + + +line: 2067 + + +Note that this option is only useful if your braille display has a Perkins-style keyboard and this feature is supported by the braille display driver. + + + + +line: 2068 + + +If input is not supported on a display which does have a braille keyboard, this will be noted in the [Supported Braille Displays](#SupportedBrailleDisplays) section. + + + + +line: 2072 +prefix: ##### +suffix: {#BrailleMode} + + +Braille mode + + + + +line: 2074 + + +Key: `NVDA+alt+t` + + + + +line: 2076 + + +This option allows you to select between the available braille modes. + + + + +line: 2078 + + +Currently, two braille modes are supported, "follow cursors" and "display speech output". + + + + +line: 2080 + + +When follow cursors is selected, the braille display will follow either the system focus/caret or the navigator object/review cursor, depending on what braille is tethered to. + + + + +line: 2082 + + +When display speech output is selected, the braille display will show what NVDA speaks, or would have spoken if speech mode was set to "talk". + + + + +line: 2084 +prefix: ##### +suffix: {#BrailleSettingsExpandToComputerBraille} + + +Expand to computer braille for the word at the cursor + + + + +line: 2086 + + +This option allows the word that is under the cursor to be displayed in non-contracted computer braille. + + + + +line: 2088 +prefix: ##### +suffix: {#BrailleSettingsShowCursor} + + +Show Cursor + + + + +line: 2090 + + +This option allows the braille cursor to be turned on and off. + + + + +line: 2091 + + +It applies to the system caret and review cursor, but not to the selection indicator. + + + + +line: 2093 +prefix: ##### +suffix: {#BrailleSettingsBlinkCursor} + + +Blink Cursor + + + + +line: 2095 + + +This option allows the braille cursor to blink. + + + + +line: 2096 + + +If blinking is turned off, the braille cursor will constantly be in the "up" position. + + + + +line: 2097 + + +The selection indicator is not affected by this option, it is always dots 7 and 8 without blinking. + + + + +line: 2099 +prefix: ##### +suffix: {#BrailleSettingsBlinkRate} + + +Cursor Blink Rate (ms) + + + + +line: 2101 + + +This option is a numerical field that allows you to change the blink rate of the cursor in milliseconds. + + + + +line: 2103 +prefix: ##### +suffix: {#BrailleSettingsCursorShapeForFocus} + + +Cursor Shape for Focus + + + + +line: 2105 + + +This option allows you to choose the shape (dot pattern) of the braille cursor when braille is tethered to focus. + + + + +line: 2106 + + +The selection indicator is not affected by this option, it is always dots 7 and 8 without blinking. + + + + +line: 2108 +prefix: ##### +suffix: {#BrailleSettingsCursorShapeForReview} + + +Cursor Shape for Review + + + + +line: 2110 + + +This option allows you to choose the shape (dot pattern) of the braille cursor when braille is tethered to review. + + + + +line: 2111 + + +The selection indicator is not affected by this option, it is always dots 7 and 8 without blinking. + + + + +line: 2113 +prefix: ##### +suffix: {#BrailleSettingsShowMessages} + + +Show Messages + + + + +line: 2115 + + +This is a combobox that allows you to select if NVDA should display braille messages and when they should disappear automatically. + + + + +line: 2117 + + +To toggle show messages from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + + + + +line: 2119 +prefix: ##### +suffix: {#BrailleSettingsMessageTimeout} + + +Message Timeout (sec) + + + + +line: 2121 + + +This option is a numerical field that controls how long NVDA messages are displayed on the braille display. + + + + +line: 2122 + + +The NVDA message is immediately dismissed when pressing a routing key on the braille display, but appears again when pressing a corresponding key which triggers the message. + + + + +line: 2123 + + +This option is shown only if "Show Messages" is set to "Use timeout". + + + + +line: 2127 +prefix: ##### +suffix: {#BrailleTether} + + +Tether Braille + + + + +line: 2129 + + +Key: NVDA+control+t + + + + +line: 2131 + + +This option allows you to choose whether the braille display will follow the system focus / caret, the navigator object / review cursor, or both. + + + + +line: 2132 + + +When "automatically" is selected, NVDA will follow the system focus and caret by default. + + + + +line: 2133 + + +In this case, when the navigator object or the review cursor position is changed by means of explicit user interaction, NVDA will tether to review temporarily, until the focus or the caret changes. + + + + +line: 2134 + + +If you want it to follow the focus and caret only, you need to configure braille to be tethered to focus. + + + + +line: 2135 + + +In this case, braille will not follow the NVDA navigator during object navigation or the review cursor during review. + + + + +line: 2136 + + +If you want braille to follow object navigation and text review instead, you need to configure braille to be tethered to review. + + + + +line: 2137 + + +In this case, Braille will not follow system focus and system caret. + + + + +line: 2139 +prefix: ##### +suffix: {#BrailleSettingsReviewRoutingMovesSystemCaret} + + +Move system caret when routing review cursor + + + + +line: 2141 + + +This setting determines if the system caret should also be moved with a routing button press. + + + + +line: 2142 + + +This option is set to Never by default, meaning that routing will never move the caret when routing the review cursor. + + + + +line: 2144 + + +When this option is set to Always, and [braille tethering](#BrailleTether) is set to "automatically" or "to review", pressing a cursor routing key will also move the system caret or focus when supported. + + + + +line: 2145 + + +When the current review mode is [Screen Review](#ScreenReview), there is no physical caret. + + + + +line: 2146 + + +In this case, NVDA tries to focus the object under the text you're routing to. + + + + +line: 2147 + + +The same applies to [object review](#ObjectReview). + + + + +line: 2149 + + +You can also set this option to only move the caret when tethered automatically. + + + + +line: 2150 + + +In that case, pressing a cursor routing key will only move the system caret or focus when NVDA is tethered to the review cursor automatically, whereas no movement will occur when manually tethered to the review cursor. + + + + +line: 2152 + + +This option is shown only if "[tether braille](#BrailleTether)" is set to "automatically" or "to review". + + + + +line: 2154 + + +To toggle move system caret when routing review cursor from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + + + + +line: 2158 +prefix: | +suffix: | + + +Options |Default (Never), Never, Only when tethered automatically, Always + + + + +line: 2159 +prefix: | +suffix: | + + +Default |Never + + + + +line: 2161 +prefix: ##### +suffix: {#BrailleSettingsReadByParagraph} + + +Read by Paragraph + + + + +line: 2163 + + +If enabled, braille will be displayed by paragraphs instead of lines. + + + + +line: 2164 + + +Also, the next and previous line commands will move by paragraph accordingly. + + + + +line: 2165 + + +This means that you do not have to scroll the display at the end of each line even where more text would fit on the display. + + + + +line: 2166 + + +This may allow for more fluent reading of large amounts of text. + + + + +line: 2167 + + +It is disabled by default. + + + + +line: 2169 +prefix: ##### +suffix: {#BrailleParagraphStartMarkers} + + +Paragraph start marker + + + + +line: 2171 + + +If "Read by paragraph" is checked, the selected start marker will be displayed to indicate the start of a paragraph. + + + + +line: 2172 + + +This can be especially helpful in applications used to read large pieces of text, like structured documents or books. + + + + +line: 2173 + + +In such documents, knowing where paragraphs start may be useful to understand the structure of the content, or to set bookmarks or annotations based on paragraph position. + + + + +line: 2175 + + +The options include using two spaces as a subtle paragraph break, and the paragraph symbol, pilcrow (¶), as a more obvious one. + + + + +line: 2179 +prefix: | +suffix: | + + +Options |No paragraph start marker, Double space ( ), Pilcrow (¶) + + + + +line: 2180 +prefix: | +suffix: | + + +Default |No paragraph start marker + + + + +line: 2182 +prefix: ##### +suffix: {#BrailleSettingsFocusContextPresentation} + + +Focus context presentation + + + + +line: 2184 + + +This option allows you to choose what context information NVDA will show on the braille display when an object gets focus. + + + + +line: 2185 + + +Context information refers to the hierarchy of objects containing the focus. + + + + +line: 2186 + + +For example, when you focus a list item, this list item is part of a list. + + + + +line: 2187 + + +This list might be contained by a dialog, etc. + + + + +line: 2188 + + +Please consult the section about [object navigation](#ObjectNavigation) for more information about the hierarchy that applies to objects in NVDA. + + + + +line: 2190 + + +When set to fill display for context changes, NVDA will try to display as much context information as possible on the braille display, but only for the parts of the context that have changed. + + + + +line: 2191 + + +For the example above, this means that when changing focus to the list, NVDA will show the list item on the braille display. + + + + +line: 2192 + + +Furthermore, if there is enough space left on the braille display, NVDA will try to show that the list item is part of a list. + + + + +line: 2193 + + +If you then start moving through the list with your arrow keys, it is assumed that you are aware that you are still in the list. + + + + +line: 2194 + + +Thus, for the remaining list items you focus, NVDA will only show the focused list item on the display. + + + + +line: 2195 + + +In order for you to read the context again (i.e. that you are in a list and that the list is part of a dialog), you will have to scroll your braille display back. + + + + +line: 2197 + + +When this option is set to always fill the display, NVDA will try to show as much context information as possible on the braille display, regardless of whether you have seen the same context information before. + + + + +line: 2198 + + +This has the advantage that NVDA will fit as much information as possible on the display. + + + + +line: 2199 + + +However, the downside is that there is always a difference in the position where the focus starts on the braille display. + + + + +line: 2200 + + +This can make it difficult to skim a long list of items, for example, as you will need to continually move your finger to find the start of the item. + + + + +line: 2201 + + +This was the default behaviour for NVDA 2017.2 and before. + + + + +line: 2203 + + +When you set the focus context presentation option to only show the context information when scrolling back, NVDA never shows context information on your braille display by default. + + + + +line: 2204 + + +Thus, in the example above, NVDA will display that you focused a list item. + + + + +line: 2205 + + +However, in order for you to read the context (i.e. that you are in a list and that the list is part of a dialog), you will have to scroll your braille display back. + + + + +line: 2207 + + +To toggle focus context presentation from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + + + + +line: 2209 +prefix: ##### +suffix: {#BrailleSettingsShowSelection} + + +Show selection + + + + +line: 2211 + + +This setting determines if selection indicator (dots 7 and 8) is shown by the braille display. + + + + +line: 2212 + + +The option is enabled by default so the selection indicator is shown. + + + + +line: 2213 + + +The selection indicator might be a distraction while reading. + + + + +line: 2214 + + +Disabling this option may improve readability. + + + + +line: 2216 + + +To toggle show selection from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + + + + +line: 2220 +prefix: | +suffix: | + + +Options |Default (Enabled), Enabled, Disabled + + + + +line: 2221 +prefix: | +suffix: | + + +Default |Enabled + + + + +line: 2223 +prefix: ##### +suffix: {#BrailleFormattingDisplay} + + +Formatting display + + + + +line: 2225 + + +This setting determines how NVDA will display text formatting in braille. + + + + +line: 2226 + + +This option only has an effect if NVDA is set to [display font attributes in braille](#DocumentFormattingFontAttributes). + + + + +line: 2230 +prefix: | +suffix: | + + + Options | Default (Liblouis), Liblouis, Tags + + + + +line: 2231 +prefix: | +suffix: | + + + Default | Liblouis + + + + +line: 2233 +prefix: | +suffix: | + + + Option | Behaviour + + + + +line: 2235 +prefix: | +suffix: | + + + Liblouis | Use native Braille formatting. Note that this option will only indicate bold, italic and underlined text, and only if the selected braille table supports indicating these attributes. + + + + +line: 2236 +prefix: | +suffix: | + + + [Tags](#BrailleFormattingDisplayTags) | Use tags that describe how and where text formatting changes. + + + + +line: 2238 +prefix: ###### +suffix: {#BrailleFormattingDisplayTags} + + +Tags + + + + +line: 2240 + + +When "Formatting display" is set to "Tags", a formatting tag is displayed in braille when a change in formatting is detected. + + + + +line: 2241 + + +These tags start with ⣋ and end with ⣙. + + + + +line: 2242 + + +A formatting tag will contain one or more symbols which describe the text formatting. + + + + +line: 2243 + + +The following symbols are defined: + + + + +line: 2245 +prefix: | +suffix: | + + + Symbol | Meaning + + + + +line: 2247 +prefix: | +suffix: | + + + ⠃ ("b") | Start bold + + + + +line: 2248 +prefix: | +suffix: | + + + ⡃ ("b" with dot 7) | End bold + + + + +line: 2249 +prefix: | +suffix: | + + + ⠊ ("i") | Start italic + + + + +line: 2250 +prefix: | +suffix: | + + + ⡊ ("i" with dot 7) | End italic + + + + +line: 2251 +prefix: | +suffix: | + + + ⠥ ("u") | Start underline + + + + +line: 2252 +prefix: | +suffix: | + + + ⡥ ("u" with dot 7) | End underline + + + + +line: 2253 +prefix: | +suffix: | + + + ⠎ ("s")| Start strikethrough + + + + +line: 2254 +prefix: | +suffix: | + + + ⡎ ("s" with dot 7) | End strikethrough + + + + +line: 2256 +prefix: ##### +suffix: {#BrailleSpeakOnRouting} + + +Speak character when routing cursor in text + + + + +line: 2258 + + +If this is enabled, NVDA will automatically speak the character at the cursor when routing to it with braille cursor routing keys. + + + + +line: 2260 + + +To toggle this option from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + + + + +line: 2262 +prefix: ##### +suffix: {#BrailleSettingsWordWrap} + + +Avoid splitting words when possible + + + + +line: 2264 + + +If this is enabled, a word which is too large to fit at the end of the braille display will not be split. + + + + +line: 2265 + + +Instead, there will be some blank space at the end of the display. + + + + +line: 2266 + + +When you scroll the display, you will be able to read the entire word. + + + + +line: 2267 + + +This is sometimes called "word wrap". + + + + +line: 2268 + + +Note that if the word is too large to fit on the display even by itself, the word must still be split. + + + + +line: 2270 + + +If this is disabled, as much of the word as possible will be displayed, but the rest will be cut off. + + + + +line: 2271 + + +When you scroll the display, you will then be able to read the rest of the word. + + + + +line: 2273 + + +Enabling this may allow for more fluent reading, but generally requires you to scroll the display more. + + + + +line: 2275 +prefix: ##### +suffix: {#BrailleUnicodeNormalization} + + +Unicode normalization + + + + +line: 2277 + + +When this option is enabled, unicode normalization is performed on the text that is brailled on the braille display. + + + + +line: 2278 + + +This is beneficial when coming across characters in braille that are unknown in a particular braille table and which have a compatible alternative, like the bold and italic characters commonly used on social media. + + + + +line: 2279 + + +Other benefits of unicode normalization are explained in greater detail in the [section for the equivalent speech setting](#SpeechUnicodeNormalization). + + + + +line: 2281 + + +To toggle Unicode normalization from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + + + + +line: 2285 +prefix: | +suffix: | + + +Options |Default (Disabled), Enabled, Disabled + + + + +line: 2286 +prefix: | +suffix: | + + +Default |Disabled + + + + +line: 2288 +prefix: ##### +suffix: {#BrailleSettingsInterruptSpeech} + + +Interrupt speech while scrolling + + + + +line: 2290 + + +This setting determines if speech should be interrupted when the Braille display is scrolled backwards/forwards. + + + + +line: 2291 + + +Previous/next line commands always interrupt speech. + + + + +line: 2293 + + +On-going speech might be a distraction while reading Braille. + + + + +line: 2294 + + +For this reason the option is enabled by default, interrupting speech when scrolling braille. + + + + +line: 2296 + + +Disabling this option allows speech to be heard while simultaneously reading Braille. + + + + +line: 2300 +prefix: | +suffix: | + + +Options |Default (Enabled), Enabled, Disabled + + + + +line: 2301 +prefix: | +suffix: | + + +Default |Enabled + + + + +line: 2303 +prefix: #### +suffix: {#SelectBrailleDisplay} + + +Select Braille Display + + + + +line: 2307 +prefix: ##### +suffix: {#OpenSelectBrailleDisplay} + + +Open Select Braille Display dialog + + + + +line: 2309 + + +Key: `NVDA+control+a` + + + + +line: 2311 + + +The Select Braille Display dialog, which can be opened by activating the Change... button in the Braille category of the NVDA settings dialog, allows you to select which Braille display NVDA should use for braille output. + + + + +line: 2312 + + +Once you have selected your braille display of choice, you can press Ok and NVDA will load the selected display. + + + + +line: 2313 + + +If there is an error loading the display driver, NVDA will notify you with a message, and continue using the previous display, if any. + + + + +line: 2315 +prefix: ##### +suffix: {#SelectBrailleDisplayDisplay} + + +Braille Display + + + + +line: 2317 + + +This combo box presents you with several options depending on what braille display drivers are available on your system. + + + + +line: 2318 + + +Move between these options with the arrow keys. + + + + +line: 2320 + + +The automatic option will allow NVDA to search for many supported braille displays in the background. + + + + +line: 2321 + + +When this feature is enabled and you connect a supported display using USB or bluetooth, NVDA will automatically connect with this display. + + + + +line: 2323 + + +No braille means that you are not using braille. + + + + +line: 2325 + + +Please see the [Supported Braille Displays](#SupportedBrailleDisplays) section for more information about supported braille displays and which of these support automatic detection in the background. + + + + +line: 2327 +prefix: ##### +suffix: {#SelectBrailleDisplayAutoDetect} + + +Displays to detect automatically + + + + +line: 2329 + + +When braille display is set to "Automatic", the check boxes in this list control allows you to enable and disable display drivers that will be involved in the automatic detection process. + + + + +line: 2330 + + +This allows you to exclude braille display drivers you do not use on a regular basis. + + + + +line: 2331 + + +For example, if you only own a display that requires the Baum driver to function, you may leave the Baum driver enabled whereas the other drivers can be disabled. + + + + +line: 2333 + + +By default, all drivers that support automatic detection are enabled. + + + + +line: 2334 + + +Any driver added, for example in a future version of NVDA or in an add-on, will also be enabled by default. + + + + +line: 2336 + + +You may consult the documentation for your braille display in the section [Supported Braille Displays](#SupportedBrailleDisplays) to check whether the driver supports automatic detection of displays. + + + + +line: 2338 +prefix: ##### +suffix: {#SelectBrailleDisplayPort} + + +Port + + + + +line: 2340 + + +This option, if available, allows you to choose what port or type of connection will be used to communicate with the braille display you have selected. + + + + +line: 2341 + + +It is a combo box containing the possible choices for your braille display. + + + + +line: 2343 + + +By default, NVDA employs automatic port detection, which means the connection with the braille device will be established automatically by scanning for available USB and bluetooth devices on your system. + + + + +line: 2344 + + +However, for some braille displays, you may be able to explicitly choose what port should be used. + + + + +line: 2345 + + +Common options are "Automatic" (which tells NVDA to employ the default automatic port selection procedure), "USB", "Bluetooth" and legacy serial communication ports if your braille display supports this type of communication. + + + + +line: 2347 + + +This option won't be available if your braille display only supports automatic port detection. + + + + +line: 2349 + + +You may consult the documentation for your braille display in the section [Supported Braille Displays](#SupportedBrailleDisplays) to check for more details on the supported types of communication and available ports. + + + + +line: 2351 + + +Please note: If you connect multiple Braille Displays to your machine at the same time which use the same driver (E.g. connecting two Seika displays), + + + + +line: 2352 + + +it is currently impossible to tell NVDA which display to use. + + + + +line: 2353 + + +Therefore it is recommended to only connect one Braille Display of a given type / manufacturer to your machine at a time. + + + + +line: 2355 +prefix: #### +suffix: {#AudioSettings} + + +Audio + + + + +line: 2359 +prefix: ##### +suffix: {#OpenAudioSettings} + + +Open Audio settings + + + + +line: 2361 + + +Key: `NVDA+control+u` + + + + +line: 2363 + + +The Audio category in the NVDA Settings dialog contains options that let you change several aspects of audio output. + + + + +line: 2365 +prefix: ##### +suffix: {#SelectSynthesizerOutputDevice} + + +Output device + + + + +line: 2367 + + +This option allows you to choose the audio device that NVDA should instruct the selected synthesizer to speak through. + + + + +line: 2371 +prefix: ##### +suffix: {#SelectSynthesizerDuckingMode} + + +Audio Ducking Mode + + + + +line: 2373 + + +Key: `NVDA+shift+d` + + + + +line: 2375 + + +This option allows you to choose if NVDA should lower the volume of other applications while NVDA is speaking, or all the time while NVDA is running. + + + + +line: 2377 +prefix: * + + +No Ducking: NVDA will never lower the volume of other audio. + + + + +line: 2378 +prefix: * + + +Duck when outputting speech and sounds: NVDA will only lower the volume of other audio when NVDA is speaking or playing sounds. This may not work for all synthesizers. + + + + +line: 2379 +prefix: * + + +Always duck: NVDA will keep the volume of other audio lower the whole time NVDA is running. + + + + +line: 2381 + + +This option is only available if NVDA has been installed. + + + + +line: 2382 + + +It is not possible to support audio ducking for portable and temporary copies of NVDA. + + + + +line: 2384 +prefix: ##### +suffix: {#SoundVolumeFollowsVoice} + + +Volume of NVDA sounds follows voice volume + + + + +line: 2388 +prefix: | +suffix: | + + +Options |Disabled, Enabled + + + + +line: 2389 +prefix: | +suffix: | + + +Default |Disabled + + + + +line: 2391 + + +When this option is enabled, the volume of NVDA sounds and beeps will follow the volume setting of the voice you are using. + + + + +line: 2392 + + +If you decrease the volume of the voice, the volume of sounds will decrease. + + + + +line: 2393 + + +Similarly, if you increase the volume of the voice, the volume of sounds will increase. + + + + +line: 2394 + + +This option is not available if you have started NVDA with [WASAPI disabled for audio output](#WASAPI) in Advanced Settings. + + + + +line: 2396 +prefix: ##### +suffix: {#SoundVolume} + + +Volume of NVDA sounds + + + + +line: 2398 + + +This slider allows you to set the volume of NVDA sounds and beeps. + + + + +line: 2399 + + +This setting only takes effect when "Volume of NVDA sounds follows voice volume" is disabled. + + + + +line: 2400 + + +This option is not available if you have started NVDA with [WASAPI disabled for audio output](#WASAPI) in Advanced Settings. + + + + +line: 2402 +prefix: ##### +suffix: {#SelectSoundSplitMode} + + +Sound split + + + + +line: 2404 + + +The sound split feature allows users to make use of their stereo output devices, such as headphones and speakers. + + + + +line: 2405 + + +Sound split makes it possible to have NVDA speech in one channel (e.g. left) and have all other applications play their sounds in the other channel (e.g. right). + + + + +line: 2406 + + +By default sound split is disabled. + + + + +line: 2407 + + +A gesture allows cycling through the various sound split modes: + + + + +line: 2410 +prefix: | +suffix: | + + + Name |Key |Description + + + + +line: 2412 +prefix: | +suffix: | + + +Cycle Sound Split Mode |`NVDA+alt+s` |Cycles between sound split modes. + + + + +line: 2416 + + +By default this command will cycle between the following modes: + + + + +line: 2418 +prefix: * + + +Sound split disabled: NVDA does not apply any sound split processing. + + + + +line: 2419 +prefix: * + + +NVDA on the left and applications on the right: NVDA will speak in the left channel, while other applications will play sounds in the right channel. + + + + +line: 2420 +prefix: * + + +NVDA on the left and applications in both channels: NVDA will speak in the left channel, while other applications will play sounds in both left and right channels. + + + + +line: 2422 + + +There are more advanced sound split modes available in NVDA setting combo box. + + + + +line: 2423 + + +Among these modes, "NVDA in both channels and applications in both channels" forces all the sounds to be directed in both channels. + + + + +line: 2424 + + +This mode may differ from "Sound split disabled" mode in case other audio processing interfers with channel volumes. + + + + +line: 2426 + + +Please note, that sound split doesn't work as a mixer. + + + + +line: 2427 + + +For example, if an application is playing a stereo sound track while sound split is set to "NVDA on the left and applications on the right", then you will only hear the right channel of the sound track, while the left channel of the sound track will be muted. + + + + +line: 2429 + + +This option is not available if you have started NVDA with [WASAPI disabled for audio output](#WASAPI) in Advanced Settings. + + + + +line: 2431 + + +Please note, that if NVDA crashes, then it won't be able to restore application sounds volume, and those applications might still output sound only in one channel after NVDA crash. + + + + +line: 2432 + + +In order to mitigate this, please restart NVDA and select the mode "NVDA in both channels and applications in both channels". + + + + +line: 2434 +prefix: ##### +suffix: {#CustomizeSoundSplitModes} + + +Customizing Sound split modes + + + + +line: 2436 + + +This checkable list allows selecting which sound split modes are included when cycling between them using `NVDA+alt+s`. + + + + +line: 2437 + + +Modes which are unchecked are excluded. + + + + +line: 2438 + + +By default only three modes are included. + + + + +line: 2440 +prefix: * + + +Sound split disabled. + + + + +line: 2441 +prefix: * + + +NVDA on the left and applications on the right. + + + + +line: 2442 +prefix: * + + +NVDA on the left and applications in both channels. + + + + +line: 2444 + + +Note that it is necessary to check at least one mode. + + + + +line: 2445 + + +This option is not available if you have started NVDA with [WASAPI disabled for audio output](#WASAPI) in Advanced Settings. + + + + +line: 2447 +prefix: ##### +suffix: {#AudioAwakeTime} + + +Time to keep audio device awake after speech + + + + +line: 2449 + + +This edit box specifies how long NVDA keeps the audio device awake after speech ends. + + + + +line: 2450 + + +This allows NVDA to avoid certain speech glitches like dropped parts of words. + + + + +line: 2451 + + +This can happen due to audio devices (especially Bluetooth and wireless devices) entering standby mode. + + + + +line: 2452 + + +This might also be helpful in other use cases, such as when running NVDA inside a virtual machine (e.g. Citrix Virtual Desktop), or on certain laptops. + + + + +line: 2454 + + +Lower values may allow audio to be cut-off more often, as a device may enter standby mode too soon, causing the start of the following speech to be clipped. + + + + +line: 2455 + + +Setting the value too high may cause the battery of the sound output device to discharge faster, as it stays active for longer while no sound is being sent. + + + + +line: 2457 + + +You can set the time to zero in order to disable this feature. + + + + +line: 2459 +prefix: #### +suffix: {#VisionSettings} + + +Vision + + + + +line: 2461 + + +The Vision category in the NVDA Settings dialog allows you to enable, disable and configure [visual aids](#Vision). + + + + +line: 2463 + + +Note that the available options in this category could be extended by [NVDA add-ons](#AddonsManager). + + + + +line: 2464 + + +By default, this settings category contains the following options: + + + + +line: 2466 +prefix: ##### +suffix: {#VisionSettingsFocusHighlight} + + +Visual Highlight + + + + +line: 2468 + + +The check boxes in the Visual Highlight grouping control the behaviour of NVDA's built-in [Visual Highlight](#VisionFocusHighlight) facility. + + + + +line: 2470 +prefix: * + + +Enable Highlighting: Toggles Visual Highlight on and off. + + + + +line: 2471 +prefix: * + + +Highlight system focus: toggles whether the [system focus](#SystemFocus) will be highlighted. + + + + +line: 2472 +prefix: * + + +Highlight navigator object: toggles whether the [navigator object](#ObjectNavigation) will be highlighted. + + + + +line: 2473 +prefix: * + + +Highlight browse mode cursor: Toggles whether the [virtual browse mode cursor](#BrowseMode) will be highlighted. + + + + +line: 2475 + + +Note that checking and unchecking the "Enable Highlighting" check box wil also change the state of the tree other check boxes accordingly. + + + + +line: 2476 + + +Therefore, if "Enable Highlighting" is off and you check this check box, the other tree check boxes will also be checked automatically. + + + + +line: 2477 + + +If you only want to highlight the focus and leave the navigator object and browse mode check boxes unchecked, the state of the "Enable Highlighting" check box will be half checked. + + + + +line: 2479 +prefix: ##### +suffix: {#VisionSettingsScreenCurtain} + + +Screen Curtain + + + + +line: 2481 + + +You can enable the [Screen Curtain](#VisionScreenCurtain) by checking the "Make screen black (immediate effect)" check box. + + + + +line: 2482 + + +A warning that your screen will become black after activation will be displayed. + + + + +line: 2483 + + +Before continuing (selecting "Yes"), ensure you have enabled speech / braille and will be able to control your computer without the use of the screen. + + + + +line: 2484 + + +Select "No" if you no longer wish to enable the Screen Curtain. + + + + +line: 2485 + + +If you are sure, you can choose the Yes button to enable the screen curtain. + + + + +line: 2486 + + +If you no longer want to see this warning message every time, you can change this behaviour in the dialog that displays the message. + + + + +line: 2487 + + +You can always restore the warning by checking the "Always show a warning when loading Screen Curtain" check box next to the "Make screen black" check box. + + + + +line: 2489 + + +By default, sounds are played when the Screen Curtain is toggled. + + + + +line: 2490 + + +When you want to change this behaviour, you can uncheck the "Play sound when toggling Screen Curtain" check box. + + + + +line: 2492 +prefix: ##### +suffix: {#VisionSettingsThirdPartyVisualAids} + + +Settings for third party visual aids + + + + +line: 2494 + + +Additional vision enhancement providers can be provided in [NVDA add-ons](#AddonsManager). + + + + +line: 2495 + + +When these providers have adjustable settings, they will be shown in this settings category in separate groupings. + + + + +line: 2496 + + +For the supported settings per provider, please refer to the documentation for that provider. + + + + +line: 2498 +prefix: #### +suffix: {#KeyboardSettings} + + +Keyboard + + + + +line: 2502 +prefix: ##### +suffix: {#OpenKeyboardSettings} + + +Open Keyboard settings + + + + +line: 2504 + + +Key: `NVDA+control+k` + + + + +line: 2506 + + +The Keyboard category in the NVDA Settings dialog contains options that set how NVDA behaves as you use and type on your keyboard. + + + + +line: 2507 + + +This settings category contains the following options: + + + + +line: 2509 +prefix: ##### +suffix: {#KeyboardSettingsLayout} + + +Keyboard layout + + + + +line: 2511 + + +This combo box lets you choose what type of keyboard layout NVDA should use. Currently the two that come with NVDA are Desktop and Laptop. + + + + +line: 2513 +prefix: ##### +suffix: {#KeyboardSettingsModifiers} + + +Select NVDA Modifier Keys + + + + +line: 2515 + + +The checkboxes in this list control what keys can be used as [NVDA modifier keys](#TheNVDAModifierKey). The following keys are available to choose from: + + + + +line: 2517 +prefix: * + + +The Caps Lock key + + + + +line: 2518 +prefix: * + + +The insert key on the number pad + + + + +line: 2519 +prefix: * + + +The extended insert key (usually found above the arrow keys, near home and end) + + + + +line: 2521 + + +If no key is chosen as the NVDA key it may be impossible to access many NVDA commands, therefore you are required to check at least one of the modifiers. + + + + +line: 2525 +prefix: ##### +suffix: {#KeyboardSettingsSpeakTypedCharacters} + + +Speak Typed Characters + + + + +line: 2527 + + +Key: NVDA+2 + + + + +line: 2529 + + +When enabled, NVDA will announce all characters you type on the keyboard. + + + + +line: 2533 +prefix: ##### +suffix: {#KeyboardSettingsSpeakTypedWords} + + +Speak Typed Words + + + + +line: 2535 + + +Key: NVDA+3 + + + + +line: 2537 + + +When enabled, NVDA will announce all words you type on the keyboard. + + + + +line: 2539 +prefix: ##### +suffix: {#KeyboardSettingsSpeechInteruptForCharacters} + + +Speech interrupt for typed characters + + + + +line: 2541 + + +If on, this option will cause speech to be interrupted each time a character is typed. This is on by default. + + + + +line: 2543 +prefix: ##### +suffix: {#KeyboardSettingsSpeechInteruptForEnter} + + +Speech interrupt for Enter key + + + + +line: 2545 + + +If on, this option will cause speech to be interrupted each time the Enter key is pressed. This is on by default. + + + + +line: 2547 +prefix: ##### +suffix: {#KeyboardSettingsSkimReading} + + +Allow skim reading in Say All + + + + +line: 2549 + + +If on, certain navigation commands (such as quick navigation in browse mode or moving by line or paragraph) do not stop Say All, rather Say All jumps to the new position and continues reading. + + + + +line: 2551 +prefix: ##### +suffix: {#KeyboardSettingsBeepLowercase} + + +Beep if Typing Lowercase Letters when Caps Lock is On + + + + +line: 2553 + + +When enabled, a warning beep will be heard if a letter is typed with the shift key while Caps Lock is on. + + + + +line: 2554 + + +Generally, typing shifted letters with Caps Lock is unintentional and is usually due to not realizing that Caps Lock is enabled. + + + + +line: 2555 + + +Therefore, it can be quite helpful to be warned about this. + + + + +line: 2559 +prefix: ##### +suffix: {#KeyboardSettingsSpeakCommandKeys} + + +Speak Command Keys + + + + +line: 2561 + + +Key: NVDA+4 + + + + +line: 2563 + + +When enabled, NVDA will announce all non-character keys you type on the keyboard. This includes key combinations such as control plus another letter. + + + + +line: 2565 +prefix: ##### +suffix: {#KeyboardSettingsAlertForSpellingErrors} + + +Play sound for spelling errors while typing + + + + +line: 2567 + + +When enabled, a short buzzer sound will be played when a word you type contains a spelling error. + + + + +line: 2568 + + +This option is only available if reporting of spelling errors is enabled in NVDA's [Document Formatting Settings](#DocumentFormattingSettings), found in the NVDA Settings dialog. + + + + +line: 2570 +prefix: ##### +suffix: {#KeyboardSettingsHandleKeys} + + +Handle keys from other applications + + + + +line: 2572 + + +This option allows the user to control if key presses generated by applications such as on-screen keyboards and speech recognition software should be processed by NVDA. + + + + +line: 2573 + + +This option is on by default, though certain users may wish to turn this off, such as those typing Vietnamese with the UniKey typing software as it will cause incorrect character input. + + + + +line: 2575 +prefix: ##### +suffix: {#MultiPressTimeout} + + +Multiple key press timeout + + + + +line: 2577 + + +Some NVDA keyboard gestures perform different actions based upon how many times the same key is pressed in rapid succession. + + + + +line: 2578 + + +An example of this is the "Report current character of navigator object" command. + + + + +line: 2579 + + +This command reports the character if pressed once, a phonetic description of the character if pressed twice, and the numeric value of the character if pressed three times. + + + + +line: 2580 + + +This option configures the timeout after which an additional press of the same key will start a new gesture, rather than being taken as a subsequent press of the first one. + + + + +line: 2581 + + +For the example command, a too short timeout will cause two presses to report the current character twice, rather than the phonetic description. + + + + +line: 2582 + + +The default timeout is 500 ms, i.e. half a second. + + + + +line: 2583 + + +Increasing this timeout may be especially useful for people using sticky keys, or who have a physical disability. + + + + +line: 2585 +prefix: #### +suffix: {#MouseSettings} + + +Mouse + + + + +line: 2589 +prefix: ##### +suffix: {#OpenMouseSettings} + + +Open Mouse settings + + + + +line: 2591 + + +Key: `NVDA+control+m` + + + + +line: 2593 + + +The Mouse category in the NVDA Settings dialog allows NVDA to track the mouse, play mouse coordinate beeps and sets other mouse usage options. + + + + +line: 2594 + + +This category contains the following options: + + + + +line: 2596 +prefix: ##### +suffix: {#MouseSettingsShape} + + +Report Mouse Shape Changes + + + + +line: 2598 + + +A checkbox, that when checked means that NVDA will announce the shape of the mouse pointer each time it changes. + + + + +line: 2599 + + +The mouse pointer in Windows changes shape to convey certain information such as when something is editable, or when something is loading etc. + + + + +line: 2603 +prefix: ##### +suffix: {#MouseSettingsTracking} + + +Enable mouse tracking + + + + +line: 2605 + + +Key: NVDA+m + + + + +line: 2607 + + +When enabled, NVDA will announce the text currently under the mouse pointer, as you move it around the screen. This allows you to find things on the screen, by physically moving the mouse, rather than trying to find them through object navigation. + + + + +line: 2609 +prefix: ##### +suffix: {#MouseSettingsTextUnit} + + +Text unit resolution + + + + +line: 2611 + + +If NVDA is set to announce the text under the mouse as you move it, this option allows you to choose exactly how much text will be spoken. + + + + +line: 2612 + + +The options are character, word, line and paragraph. + + + + +line: 2614 + + +To toggle text unit resolution from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + + + + +line: 2616 +prefix: ##### +suffix: {#MouseSettingsRole} + + +Report object when mouse enters it + + + + +line: 2618 + + +If this checkbox is checked, NVDA will announce information about objects as the mouse moves inside them. + + + + +line: 2619 + + +This includes the role (type) of the object as well as states (checked/pressed), cell coordinates in tables, etc. + + + + +line: 2620 + + +Note that the announcement of some object details might be dependent on how other settings are set, such as in the [object presentation](#ObjectPresentationSettings) or [Document Formatting](#DocumentFormattingSettings) categories. + + + + +line: 2622 +prefix: ##### +suffix: {#MouseSettingsAudio} + + +Play audio coordinates when mouse moves + + + + +line: 2624 + + +Checking this checkbox makes NVDA play beeps as the mouse moves, so that the user can work out where the mouse is in regards to the dimensions of the screen. + + + + +line: 2625 + + +The higher the mouse is on the screen, the higher the pitch of the beeps. + + + + +line: 2626 + + +The further left or right the mouse is located on the screen, the further left or right the sound will be played (assuming the user has stereo speakers or headphones). + + + + +line: 2628 +prefix: ##### +suffix: {#MouseSettingsBrightness} + + +Brightness controls audio coordinates volume + + + + +line: 2630 + + +If the "play audio coordinates when mouse moves" checkbox is checked, then checking this checkbox means that the volume of the audio coordinates beeps is controlled by how bright the screen is under the mouse. + + + + +line: 2631 + + +This setting is unchecked by default. + + + + +line: 2633 +prefix: ##### +suffix: {#MouseSettingsHandleMouseControl} + + +Ignore mouse input from other applications + + + + +line: 2635 + + +This option allows the user to ignore mouse events (including mouse movement and button presses) generated by other applications such as TeamViewer and other remote control software. + + + + +line: 2636 + + +This option is unchecked by default. + + + + +line: 2637 + + +If you check this option and you have the "Enable mouse tracking" option enabled, NVDA will not announce what is under the mouse if the mouse is moved by another application. + + + + +line: 2639 +prefix: #### +suffix: {#TouchInteraction} + + +Touch Interaction + + + + +line: 2641 + + +This settings category, only available on computers with touch capabilities, allows you to configure how NVDA interacts with touchscreens. + + + + +line: 2642 + + +This category contains the following options: + + + + +line: 2644 +prefix: ##### +suffix: {#TouchSupportEnable} + + +Enable touch interaction support + + + + +line: 2646 + + +This checkbox enables NVDA's touch interaction support. + + + + +line: 2647 + + +If enabled, you can use your fingers to navigate and interact with items on screen using a touchscreen device. + + + + +line: 2648 + + +If disabled, touchscreen support will be disabled as though NVDA is not running. + + + + +line: 2649 + + +This setting can also be toggled using NVDA+control+alt+t. + + + + +line: 2651 +prefix: ##### +suffix: {#TouchTypingMode} + + +Touch typing mode + + + + +line: 2653 + + +This checkbox allows you to specify the method you wish to use when entering text using the touch keyboard. + + + + +line: 2654 + + +If this checkbox is checked, when you locate a key on the touch keyboard, you can lift your finger and the selected key will be pressed. + + + + +line: 2655 + + +If this is unchecked, you need to double-tap on the key of the touch keyboard to press the key. + + + + +line: 2657 +prefix: #### +suffix: {#ReviewCursorSettings} + + +Review Cursor + + + + +line: 2659 + + +The Review Cursor category in the NVDA Settings dialog is used to configure NVDA's review cursor behaviour. + + + + +line: 2660 + + +This category contains the following options: + + + + +line: 2664 +prefix: ##### +suffix: {#ReviewCursorFollowFocus} + + +Follow System Focus + + + + +line: 2666 + + +Key: NVDA+7 + + + + +line: 2668 + + +When enabled, The review cursor will always be placed in the same object as the current system focus whenever the focus changes. + + + + +line: 2672 +prefix: ##### +suffix: {#ReviewCursorFollowCaret} + + +Follow System Caret + + + + +line: 2674 + + +Key: NVDA+6 + + + + +line: 2676 + + +When enabled, the review cursor will automatically be moved to the position of the System caret each time it moves. + + + + +line: 2678 +prefix: ##### +suffix: {#ReviewCursorFollowMouse} + + +Follow mouse cursor + + + + +line: 2680 + + +When enabled, the review cursor will follow the mouse as it moves. + + + + +line: 2682 +prefix: ##### +suffix: {#ReviewCursorSimple} + + +Simple Review mode + + + + +line: 2684 + + +When enabled, NVDA will filter the hierarchy of objects that can be navigated to exclude objects that aren't of interest to the user; e.g. invisible objects and objects used only for layout purposes. + + + + +line: 2686 + + +To toggle simple review mode from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + + + + +line: 2688 +prefix: #### +suffix: {#ObjectPresentationSettings} + + +Object Presentation + + + + +line: 2692 +prefix: ##### +suffix: {#OpenObjectPresentationSettings} + + +Open Object Presentation settings + + + + +line: 2694 + + +Key: `NVDA+control+o` + + + + +line: 2696 + + +The Object Presentation category in the NVDA Settings dialog is used to set how much information NVDA will present about controls such as description, position information and so on. + + + + +line: 2697 + + +These options don't typically apply to browse mode. + + + + +line: 2698 + + +These options typically apply to focus reporting and NVDA object navigation, but not reading text content e.g. browse mode. + + + + +line: 2700 +prefix: ##### +suffix: {#ObjectPresentationReportToolTips} + + +Report tooltips + + + + +line: 2702 + + +A checkbox that when checked tells NVDA to report tooltips as they appear. + + + + +line: 2703 + + +Many Windows and controls show a small message (or tooltip) when you move the mouse pointer over them, or sometimes when you move the focus to them. + + + + +line: 2705 +prefix: ##### +suffix: {#ObjectPresentationReportNotifications} + + +Report notifications + + + + +line: 2707 + + +This checkbox, when checked, tells NVDA to report help balloons and toast notifications as they appear. + + + + +line: 2709 +prefix: * + + +Help Balloons are like tooltips, but are usually larger in size, and are associated with system events such as a network cable being unplugged, or perhaps to alert you about Windows security issues. + + + + +line: 2710 +prefix: * + + +Toast notifications have been introduced in Windows 10 and appear in the notification centre in the system tray, informing about several events (i.e. if an update has been downloaded, a new e-mail arrived in your inbox, etc.). + + + + +line: 2712 +prefix: ##### +suffix: {#ObjectPresentationShortcutKeys} + + +Report Object Shortcut Keys + + + + +line: 2714 + + +When this checkbox is checked, NVDA will include the shortcut key that is associated with a certain object or control when it is reported. + + + + +line: 2715 + + +For example the File menu on a menu bar may have a shortcut key of alt+f. + + + + +line: 2717 +prefix: ##### +suffix: {#ObjectPresentationPositionInfo} + + +Report object position information + + + + +line: 2719 + + +This option lets you choose whether you wish to have an object's position (e.g. 1 of 4) reported when moving to the object with the focus or object navigation. + + + + +line: 2721 +prefix: ##### +suffix: {#ObjectPresentationGuessPositionInfo} + + +Guess Object Position Information when unavailable + + + + +line: 2723 + + +If reporting of object position information is turned on, this option allows NVDA to guess object position information when it is otherwise unavailable for a particular control. + + + + +line: 2725 + + +When on, NVDA will report position information for more controls such as menus and toolbars, however this information may be slightly inaccurate. + + + + +line: 2727 +prefix: ##### +suffix: {#ObjectPresentationReportDescriptions} + + +Report Object descriptions + + + + +line: 2729 + + +Uncheck this checkbox if you don't wish to have the description reported along with objects (i.e. search suggestions, reporting of whole dialog window right after the dialog opens, etc.). + + + + +line: 2733 +prefix: ##### +suffix: {#ObjectPresentationProgressBarOutput} + + +Progress bar output + + + + +line: 2735 + + +Key: NVDA+u + + + + +line: 2737 + + +This option controls how NVDA reports progress bar updates to you. + + + + +line: 2739 + + +It has the following options: + + + + +line: 2741 +prefix: * + + +Off: Progress bars will not be reported as they change. + + + + +line: 2742 +prefix: * + + +Speak: This option tells NVDA to speak the progress bar in percentages. Each time the progress bar changes, NVDA will speak the new value. + + + + +line: 2743 +prefix: * + + +Beep: This tells NVDA to beep each time the progress bar changes. The higher the beep, the closer the progress bar is to completion. + + + + +line: 2744 +prefix: * + + +Beep and speak: This option tells NVDA to both beep and speak when a progress bar updates. + + + + +line: 2746 +prefix: ##### +suffix: {#ObjectPresentationReportBackgroundProgressBars} + + +Report background progress bars + + + + +line: 2748 + + +This is an option that, when checked, tells NVDA to keep reporting a progress bar, even if it is not physically in the foreground. + + + + +line: 2749 + + +If you minimize or switch away from a window that contains a progress bar, NVDA will keep track of it, allowing you to do other things while NVDA tracks the progress bar. + + + + +line: 2753 +prefix: ##### +suffix: {#ObjectPresentationReportDynamicContent} + + +Report dynamic content changes + + + + +line: 2755 + + +Key: NVDA+5 + + + + +line: 2757 + + +Toggles the announcement of new content in particular objects such as terminals and the history control in chat programs. + + + + +line: 2759 +prefix: ##### +suffix: {#ObjectPresentationSuggestionSounds} + + +Play a sound when auto-suggestions appear + + + + +line: 2761 + + +Toggles announcement of appearance of auto-suggestions, and if enabled, NVDA will play a sound to indicate this. + + + + +line: 2762 + + +Auto-suggestions are lists of suggested entries based on text entered into certain edit fields and documents. + + + + +line: 2763 + + +For example, when you enter text into the search box in Start menu in Windows Vista and later, Windows displays a list of suggestions based on what you typed. + + + + +line: 2764 + + +For some edit fields such as search fields in various Windows 10 apps, NVDA can notify you that a list of suggestions has appeared when you type text. + + + + +line: 2765 + + +The auto-suggestions list will close once you move away from the edit field, and for some fields, NVDA can notify you of this when this happens. + + + + +line: 2767 +prefix: #### +suffix: {#InputCompositionSettings} + + +Input Composition + + + + +line: 2769 + + +The Input Composition category allows you to control how NVDA reports the input of Asian characters, such as with IME or Text Service input methods. + + + + +line: 2770 + + +Note that due to the fact that input methods vary greatly by available features and by how they convey information, it will most likely be necessary to configure these options differently for each input method to get the most efficient typing experience. + + + + +line: 2772 +prefix: ##### +suffix: {#InputCompositionReportAllCandidates} + + +Automatically report all available candidates + + + + +line: 2774 + + +This option, which is on by default, allows you to choose whether or not all visible candidates should be reported automatically when a candidate list appears or its page is changed. + + + + +line: 2775 + + +Having this option on for pictographic input methods such as Chinese New ChangJie or Boshiami is useful, as you can automatically hear all symbols and their numbers and you can choose one right away. + + + + +line: 2776 + + +However, for phonetic input methods such as Chinese New Phonetic, it may be more useful to turn this option off, as all the symbols will sound the same and you will have to use the arrow keys to navigate the list items individually to gain more information from the character descriptions for each candidate. + + + + +line: 2778 +prefix: ##### +suffix: {#InputCompositionAnnounceSelectedCandidate} + + +Announce Selected Candidate + + + + +line: 2780 + + +This option, which is on by default, allows you to choose whether NVDA should announce the selected candidate when a candidate list appears or when the selection is changed. + + + + +line: 2781 + + +For input methods where the selection can be changed with the arrow keys (such as Chinese New Phonetic) this is necessary, but for some input methods it may be more efficient typing with this option turned off. + + + + +line: 2782 + + +Note that even with this option off, the review cursor will still be placed on the selected candidate allowing you to use object navigation / review to manually read this or other candidates. + + + + +line: 2784 +prefix: ##### +suffix: {#InputCompositionCandidateIncludesShortCharacterDescription} + + +Always include short character descriptions for candidates + + + + +line: 2786 + + +This option, which is on by default, allows you to choose whether or not NVDA should provide a short description for each character in a candidate, either when it's selected or when it's automatically read when the candidate list appears. + + + + +line: 2787 + + +Note that for locales such as Chinese, the announcement of extra character descriptions for the selected candidate is not affected by this option. + + + + +line: 2788 + + +This option may be useful for Korean and Japanese input methods. + + + + +line: 2790 +prefix: ##### +suffix: {#InputCompositionReadingStringChanges} + + +Report changes to the reading string + + + + +line: 2792 + + +Some input methods such as Chinese New Phonetic and New ChangJie have a reading string (sometimes known as a precomposition string). + + + + +line: 2793 + + +You can choose whether or not NVDA should announce new characters being typed into this reading string with this option. + + + + +line: 2794 + + +This option is on by default. + + + + +line: 2795 + + +Note some older input methods such as Chinese ChangJie may not use the reading string to hold precomposition characters, but instead use the composition string directly. Please see the next option for configuring reporting of the composition string. + + + + +line: 2797 +prefix: ##### +suffix: {#InputCompositionCompositionStringChanges} + + +Report changes to the composition string + + + + +line: 2799 + + +After reading or precomposition data has been combined into a valid pictographic symbol, most input methods place this symbol into a composition string for temporary storage along with other combined symbols before they are finally inserted into the document. + + + + +line: 2800 + + +This option allows you to choose whether or not NVDA should report new symbols as they appear in the composition string. + + + + +line: 2801 + + +This option is on by default. + + + + +line: 2803 +prefix: #### +suffix: {#BrowseModeSettings} + + +Browse Mode + + + + +line: 2807 +prefix: ##### +suffix: {#OpenBrowseModeSettings} + + +Open Browse Mode settings + + + + +line: 2809 + + +Key: `NVDA+control+b` + + + + +line: 2811 + + +The Browse Mode category in the NVDA Settings dialog is used to configure NVDA's behaviour when you read and navigate complex documents such as web pages. + + + + +line: 2812 + + +This category contains the following options: + + + + +line: 2814 +prefix: ##### +suffix: {#BrowseModeSettingsMaxLength} + + +Maximum Number of Characters on One Line + + + + +line: 2816 + + +This field sets the maximum length of a line in browse mode (in characters). + + + + +line: 2818 +prefix: ##### +suffix: {#BrowseModeSettingsPageLines} + + +Maximum Lines Per Page + + + + +line: 2820 + + +This field sets the amount of lines you will move by when pressing page up or page down while in browse mode. + + + + +line: 2824 +prefix: ##### +suffix: {#BrowseModeSettingsScreenLayout} + + +Use screen layout + + + + +line: 2826 + + +Key: NVDA+v + + + + +line: 2828 + + +This option allows you to specify whether browse mode should place clickable content (links, buttons and fields) on its own line, or if it should keep it in the flow of text as it is visually shown. + + + + +line: 2829 + + +Note that this option doesn't apply to Microsoft Office apps such as Outlook and Word, which always use screen layout. + + + + +line: 2830 + + +When screen layout is enabled, page elements will stay as they are visually shown. + + + + +line: 2831 + + +For example, a visual line of multiple links will be presented in speech and braille as multiple links on the same line. + + + + +line: 2832 + + +If it is disabled, then page elements will be placed on their own lines. + + + + +line: 2833 + + +This may be easier to understand during line by line page navigation and make items easier to interact with for some users. + + + + +line: 2835 +prefix: ##### +suffix: {#BrowseModeSettingsEnableOnPageLoad} + + +Enable browse mode on page load + + + + +line: 2837 + + +This checkbox toggles whether browse mode should be automatically enabled when loading a page. + + + + +line: 2838 + + +When this option is disabled, browse mode can still be manually activated on pages or in documents where browse mode is supported. + + + + +line: 2839 + + +See the [Browse Mode section](#BrowseMode) for a list of applications supported by browse mode. + + + + +line: 2840 + + +Note that this option does not apply to situations where browse mode is always optional, e.g. in Microsoft Word. + + + + +line: 2841 + + +This option is enabled by default. + + + + +line: 2843 +prefix: ##### +suffix: {#BrowseModeSettingsAutoSayAll} + + +Automatic Say All on page load + + + + +line: 2845 + + +This checkbox toggles the automatic reading of a page after it loads in browse mode. + + + + +line: 2846 + + +This option is enabled by default. + + + + +line: 2848 +prefix: ##### +suffix: {#BrowseModeSettingsIncludeLayoutTables} + + +Include layout tables + + + + +line: 2850 + + +This option affects how NVDA handles tables used purely for layout purposes. + + + + +line: 2851 + + +When on, NVDA will treat these as normal tables, reporting them based on [Document Formatting Settings](#DocumentFormattingSettings) and locating them with quick navigation commands. + + + + +line: 2852 + + +When off, they will not be reported nor found with quick navigation. + + + + +line: 2853 + + +However, the content of the tables will still be included as normal text. + + + + +line: 2854 + + +This option is turned off by default. + + + + +line: 2856 + + +To toggle inclusion of layout tables from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + + + + +line: 2858 +prefix: ##### +suffix: {#BrowseModeLinksAndHeadings} + + +Configuring reporting of fields such as links and headings + + + + +line: 2860 + + +Please see the options in the [Document Formatting category](#DocumentFormattingSettings) of the [NVDA Settings](#NVDASettings) dialog to configure the fields that are reported when navigating, such as links, headings and tables. + + + + +line: 2862 +prefix: ##### +suffix: {#BrowseModeSettingsAutoPassThroughOnFocusChange} + + +Automatic focus mode for focus changes + + + + +line: 2864 + + +This option allows focus mode to be invoked if focus changes. + + + + +line: 2865 + + +For example, when on a web page, if you press tab and you land on a form, if this option is checked, focus mode will automatically be invoked. + + + + +line: 2867 +prefix: ##### +suffix: {#BrowseModeSettingsAutoPassThroughOnCaretMove} + + +Automatic focus mode for caret movement + + + + +line: 2869 + + +This option, when checked, allows NVDA to enter and leave focus mode when using arrow keys. + + + + +line: 2870 + + +For example, if arrowing down a web page and you land on an edit box, NVDA will automatically bring you into focus mode. + + + + +line: 2871 + + +If you arrow out of the edit box, NVDA will put you back in browse mode. + + + + +line: 2873 +prefix: ##### +suffix: {#BrowseModeSettingsPassThroughAudioIndication} + + +Audio indication of Focus and Browse modes + + + + +line: 2875 + + +If this option is enabled, NVDA will play special sounds when it switches between browse mode and focus mode, rather than speaking the change. + + + + +line: 2877 +prefix: ##### +suffix: {#BrowseModeSettingsTrapNonCommandGestures} + + +Trap non-command gestures from reaching the document + + + + +line: 2879 + + +Enabled by default, this option allows you to choose if gestures (such as key presses) that do not result in an NVDA command and are not considered to be a command key in general, should be trapped from going through to the document you are currently focused on. + + + + +line: 2880 + + +As an example, if enabled and the letter j was pressed, it would be trapped from reaching the document, even though it is not a quick navigation command nor is it likely to be a command in the application itself. + + + + +line: 2881 + + +In this case NVDA will tell Windows to play a default sound whenever a key which gets trapped is pressed. + + + + +line: 2885 +prefix: ##### +suffix: {#BrowseModeSettingsAutoFocusFocusableElements} + + +Automatically set system focus to focusable elements + + + + +line: 2887 + + +Key: NVDA+8 + + + + +line: 2889 + + +Disabled by default, this option allows you to choose if the system focus should automatically be set to elements that can take the system focus (links, form fields, etc.) when navigating content with the browse mode caret. + + + + +line: 2890 + + +Leaving this option disabled will not automatically focus focusable elements when they are selected with the browse mode caret. + + + + +line: 2891 + + +This might result in faster browsing experience and better responsiveness in browse mode. + + + + +line: 2892 + + +The focus will yet be updated to the particular element when interacting with it (e.g. pressing a button, checking a check box). + + + + +line: 2893 + + +Enabling this option may improve support for some websites at the cost of performance and stability. + + + + +line: 2895 +prefix: #### +suffix: {#DocumentFormattingSettings} + + +Document Formatting + + + + +line: 2899 +prefix: ##### +suffix: {#OpenDocumentFormattingSettings} + + +Open Document Formatting settings + + + + +line: 2901 + + +Key: `NVDA+control+d` + + + + +line: 2903 + + +Most of the options in this category are for configuring what type of formatting you wish to have reported as you move the cursor around documents. + + + + +line: 2904 + + +For example, if you check the report font name checkbox, each time you arrow onto text with a different font, the name of the font will be announced. + + + + +line: 2906 + + +The document formatting options are organized into groups. + + + + +line: 2907 + + +You can configure reporting of: + + + + +line: 2909 +prefix: * + + +Font + + + + +line: 2910 +prefix: * + + +Font name + + + + +line: 2911 +prefix: * + + +Font size + + + + +line: 2912 +prefix: * + + +Font attributes [(Off, Speech, Braille, Speech and braille)](#DocumentFormattingFontAttributes) + + + + +line: 2913 +prefix: * + + +Superscripts and subscripts + + + + +line: 2914 +prefix: * + + +Emphasis + + + + +line: 2915 +prefix: * + + +Highlighted (Marked) text + + + + +line: 2916 +prefix: * + + +Style + + + + +line: 2917 +prefix: * + + +Colours + + + + +line: 2918 +prefix: * + + +Document information + + + + +line: 2919 +prefix: * + + +Comments + + + + +line: 2920 +prefix: * + + +Bookmarks + + + + +line: 2921 +prefix: * + + +Editor revisions + + + + +line: 2922 +prefix: * + + +Spelling errors + + + + +line: 2923 +prefix: * + + +Pages and spacing + + + + +line: 2924 +prefix: * + + +Page numbers + + + + +line: 2925 +prefix: * + + +Line numbers + + + + +line: 2926 +prefix: * + + +Line indentation reporting [(Off, Speech, Tones, Both Speech and Tones)](#DocumentFormattingSettingsLineIndentation) + + + + +line: 2927 +prefix: * + + +Ignore blank lines for line indentation reporting + + + + +line: 2928 +prefix: * + + +Paragraph indentation (e.g. hanging indent, first line indent) + + + + +line: 2929 +prefix: * + + +Line spacing (single, double, etc.) + + + + +line: 2930 +prefix: * + + +Alignment + + + + +line: 2931 +prefix: * + + +Table information + + + + +line: 2932 +prefix: * + + +Tables + + + + +line: 2933 +prefix: * + + +Row/column headers (Off, Rows, Columns, Rows and columns) + + + + +line: 2934 +prefix: * + + +Cell coordinates + + + + +line: 2935 +prefix: * + + +Cell borders (Off, Styles, Both Colours and Styles) + + + + +line: 2936 +prefix: * + + +Elements + + + + +line: 2937 +prefix: * + + +Headings + + + + +line: 2938 +prefix: * + + +Links + + + + +line: 2939 +prefix: * + + +Graphics + + + + +line: 2940 +prefix: * + + +Lists + + + + +line: 2941 +prefix: * + + +Block quotes + + + + +line: 2942 +prefix: * + + +Groupings + + + + +line: 2943 +prefix: * + + +Landmarks + + + + +line: 2944 +prefix: * + + +Articles + + + + +line: 2945 +prefix: * + + +Frames + + + + +line: 2946 +prefix: * + + +Figures and captions + + + + +line: 2947 +prefix: * + + +Clickable + + + + +line: 2949 + + +To toggle these settings from anywhere, please assign custom gestures using the [Input Gestures dialog](#InputGestures). + + + + +line: 2951 +prefix: ##### +suffix: {#DocumentFormattingFontAttributes} + + +Font attributes + + + + +line: 2953 + + +This option allows you to select how certain font attributes, such as bold, italics, underline and strikethrough are reported. + + + + +line: 2954 + + +The font attributes combo box has four options: + + + + +line: 2956 +prefix: * + + +Off: NVDA will not report these font attributes. + + + + +line: 2957 +prefix: * + + +Speech: NVDA will announce when these font attributes change. + + + + +line: 2958 +prefix: * + + +Braille: NVDA will display these attributes in braille. + + + + +line: 2959 + + +Exactly how they are displayed can be configured in [NVDA's braille settings](#BrailleFormattingDisplay). + + + + +line: 2960 +prefix: * + + +Speech and braille: NVDA will report font attributes using both of the above methods. + + + + +line: 2962 +prefix: ##### +suffix: {#DocumentFormattingDetectFormatAfterCursor} + + +Report formatting changes after the cursor + + + + +line: 2964 + + +If enabled, this setting tells NVDA to try and detect all the formatting changes on a line as it reports it, even if doing this may slow down NVDA's performance. + + + + +line: 2966 + + +By default, NVDA will detect the formatting at the position of the System caret / Review Cursor, and in some instances may detect formatting on the rest of the line, only if it is not going to cause a performance decrease. + + + + +line: 2968 + + +Enable this option while proof reading documents in applications such as WordPad, where formatting is important. + + + + +line: 2970 +prefix: ##### +suffix: {#DocumentFormattingSettingsLineIndentation} + + +Line indentation reporting + + + + +line: 2972 + + +This option allows you to configure how indentation at the beginning of lines is reported. + + + + +line: 2973 + + +The Report line indentation with combo box has four options. + + + + +line: 2975 +prefix: * + + +Off: NVDA will not treat indentation specially. + + + + +line: 2976 +prefix: * + + +Speech: If speech is selected, when the amount of indentation changes, NVDA will say something like "twelve space" or "four tab." + + + + +line: 2977 +prefix: * + + +Tones: If Tones is selected, when the amount of indentation changes, tones indicate the amount of change in indent. + + + + +line: 2978 + + +The tone will increase in pitch every space, and for a tab, it will increase in pitch the equivalent of 4 spaces. + + + + +line: 2979 +prefix: * + + +Both Speech and Tones: This option reads indentation using both of the above methods. + + + + +line: 2981 + + +If you tick the "Ignore blank lines for line indentation reporting" checkbox, then indentation changes won't be reported for blank lines. + + + + +line: 2982 + + +This may be useful when reading a document where blank lines are used to separate indented bloks of text, such as in programming source code. + + + + +line: 2984 +prefix: #### +suffix: {#DocumentNavigation} + + +Document Navigation + + + + +line: 2986 + + +This category allows you to adjust various aspects of document navigation. + + + + +line: 2988 +prefix: ##### +suffix: {#ParagraphStyle} + + +Paragraph Style + + + + +line: 2992 +prefix: | +suffix: | + + +Options |Default (Handled by application), Handled by application, Single line break, Multi line break + + + + +line: 2993 +prefix: | +suffix: | + + +Default |Handled by application + + + + +line: 2995 + + +This combo box allows you to select the paragraph style to be used when navigating by paragraphs with `control+upArrow` and `control+downArrow`. + + + + +line: 2996 + + +The available paragraph styles are: + + + + +line: 2998 +prefix: * + + +Handled by application: NVDA will let the application determine the previous or next paragraph, and NVDA will read the new paragraph when navigating. + + + + +line: 2999 + + +This style works best when the application supports paragraph navigation natively, and is the default. + + + + +line: 3000 +prefix: * + + +Single line break: NVDA will attempt to determine the previous or next paragraph using a single line break as the paragraph indicator. + + + + +line: 3001 + + +This style works best when reading documents in an application which does not natively support paragraph navigation, and paragraphs in the document are marked by a single press of the `enter` key. + + + + +line: 3002 +prefix: * + + +Multi line break: NVDA will attempt to determine the previous or next paragraph using at least one blank line (two presses of the `enter` key) as the paragraph indicator. + + + + +line: 3003 + + +This style works best when working with documents which use block paragraphs. + + + + +line: 3004 + + +Note that this paragraph style cannot be used in Microsoft Word or Microsoft Outlook, unless you are using UIA to access Microsoft Word controls. + + + + +line: 3006 + + +You may toggle through the available paragraph styles from anywhere by assigning a key in the [Input Gestures dialog](#InputGestures). + + + + +line: 3008 +prefix: #### +suffix: {#AddonStoreSettings} + + +Add-on Store Settings + + + + +line: 3010 + + +This category allows you to adjust the behaviour of the Add-on Store. + + + + +line: 3012 +prefix: ##### +suffix: {#AutomaticAddonUpdates} + + +Update Notifications + + + + +line: 3014 + + +When this option is set to "Notify", the Add-on Store will notify you after NVDA startup if any add-on updates are available. + + + + +line: 3015 + + +This check is performed every 24 hours. + + + + +line: 3016 + + +Notifications will only occur for add-ons with updates available within the same channel. + + + + +line: 3017 + + +For example, for installed beta add-ons, you will only be notified of updates within the beta channel. + + + + +line: 3021 +prefix: | +suffix: | + + +Options |Notify (Default), Disabled + + + + +line: 3022 +prefix: | +suffix: | + + +Default |Notify + + + + +line: 3024 +prefix: | +suffix: | + + +Option |Behaviour + + + + +line: 3026 +prefix: | +suffix: | + + +Notify |Notify when updates are available to add-ons within the same channel + + + + +line: 3027 +prefix: | +suffix: | + + +Disabled |Do not automatically check for updates to add-ons + + + + +line: 3029 +prefix: #### +suffix: {#Win10OcrSettings} + + +Windows OCR Settings + + + + +line: 3031 + + +The settings in this category allow you to configure [Windows OCR](#Win10Ocr). + + + + +line: 3032 + + +This category contains the following options: + + + + +line: 3034 +prefix: ##### +suffix: {#Win10OcrSettingsRecognitionLanguage} + + +Recognition language + + + + +line: 3036 + + +This combo box allows you to choose the language to be used for text recognition. + + + + +line: 3037 + + +To cycle through available languages from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + + + + +line: 3039 +prefix: ##### +suffix: {#Win10OcrSettingsAutoRefresh} + + +Periodically refresh recognized content + + + + +line: 3041 + + +When this checkbox is enabled, NVDA will automatically refresh the recognized content when a recognition result has focus. + + + + +line: 3042 + + +This can be very useful when you want to monitor constantly changing content, such as when watching a video with subtitles. + + + + +line: 3043 + + +The refresh takes place every one and a half seconds. + + + + +line: 3044 + + +This option is disabled by default. + + + + +line: 3046 +prefix: #### +suffix: {#AdvancedSettings} + + +Advanced Settings + + + + +line: 3048 + + +Warning! The settings in this category are for advanced users and may cause NVDA to not function correctly if configured in the wrong way. + + + + +line: 3049 + + +Only make changes to these settings if you are sure you know what you are doing or if you have been specifically instructed to by an NVDA developer. + + + + +line: 3051 +prefix: ##### +suffix: {#AdvancedSettingsMakingChanges} + + +Making changes to advanced settings + + + + +line: 3053 + + +In order to make changes to the advanced settings, the controls must be enabled by confirming, with the checkbox, that you understand the risks of modifying these settings + + + + +line: 3055 +prefix: ##### +suffix: {#AdvancedSettingsRestoringDefaults} + + +Restoring the default settings + + + + +line: 3057 + + +The button restores the default values for the settings, even if the confirmation checkbox is not ticked. + + + + +line: 3058 + + +After changing settings you may wish to revert to the default values. + + + + +line: 3059 + + +This may also be the case if you are unsure if the settings have been changed. + + + + +line: 3061 +prefix: ##### +suffix: {#AdvancedSettingsEnableScratchpad} + + +Enable loading custom code from Developer Scratchpad Directory + + + + +line: 3063 + + +When developing add-ons for NVDA, it is useful to be able to test code as you are writing it. + + + + +line: 3064 + + +This option when enabled, allows NVDA to load custom appModules, globalPlugins, brailleDisplayDrivers, synthDrivers and vision enhancement providers, from a special developer scratchpad directory in your NVDA user configuration directory. + + + + +line: 3065 + + +As their equivalents in add-ons, these modules are loaded when starting NVDA or, in the case of appModules and globalPlugins, when [reloading plugins](#ReloadPlugins). + + + + +line: 3066 + + +This option is off by default, ensuring that no untested code is ever run in NVDA with out the user's explicit knowledge. + + + + +line: 3067 + + +If you wish to distribute custom code to others, you should package it as an NVDA add-on. + + + + +line: 3069 +prefix: ##### +suffix: {#AdvancedSettingsOpenScratchpadDir} + + +Open Developer Scratchpad Directory + + + + +line: 3071 + + +This button opens the directory where you can place custom code while developing it. + + + + +line: 3072 + + +This button is only enabled if NVDA is configured to enable loading custom code from the Developer Scratchpad Directory. + + + + +line: 3074 +prefix: ##### +suffix: {#AdvancedSettingsSelectiveUIAEventRegistration} + + +Registration for UI Automation events and property changes + + + + +line: 3078 +prefix: | +suffix: | + + +Options |Automatic, Selective, Global + + + + +line: 3079 +prefix: | +suffix: | + + +Default |Automatic + + + + +line: 3081 + + +This option changes how NVDA registers for events fired by the Microsoft UI Automation accessibility API. + + + + +line: 3082 + + +The registration for UI Automation events and property changes combo box has three options: + + + + +line: 3084 +prefix: * + + +Automatic: "selective" on Windows 11 Sun Valley 2 (version 22H2) and later, "global" otherwise. + + + + +line: 3085 +prefix: * + + +Selective: NVDA will limit event registration to the system focus for most events. + + + + +line: 3086 + + +If you suffer from performance issues in one or more applications, We recommend you to try this functionality to see whether performance improves. + + + + +line: 3087 + + +However, on older versions of Windows, NVDA may have trouble tracking focus in some controls (such as the task manager and emoji panel). + + + + +line: 3088 +prefix: * + + +Global: NVDA registers for many UIA events that are processed and discarded within NVDA itself. + + + + +line: 3089 + + +While focus tracking is more reliable in more situations, performance is significantly degraded, especially in applications like Microsoft Visual Studio. + + + + +line: 3091 +prefix: ##### +suffix: {#MSWordUIA} + + +Use UI automation to access Microsoft Word document controls + + + + +line: 3093 + + +Configures whether or not NVDA should use the UI Automation accessibility API to access Microsoft Word documents, rather than the older Microsoft Word object model. + + + + +line: 3094 + + +This applies to documents in Microsoft word itself, plus messages in Microsoft Outlook. + + + + +line: 3095 + + +This setting contains the following values: + + + + +line: 3097 +prefix: * + + +Default (where suitable) + + + + +line: 3098 +prefix: * + + +Only where necessary: where the Microsoft Word object model is not available at all + + + + +line: 3099 +prefix: * + + +Where suitable: Microsoft Word version 16.0.15000 or higher, or where the Microsoft Word object model is unavailable + + + + +line: 3100 +prefix: * + + +Always: where ever UI automation is available in Microsoft word (no matter how complete). + + + + +line: 3102 +prefix: ##### +suffix: {#UseUiaForExcel} + + +Use UI automation to access Microsoft Excel spreadsheet controls when available + + + + +line: 3104 + + +When this option is enabled, NVDA will try to use the Microsoft UI Automation accessibility API in order to fetch information from Microsoft Excel Spreadsheet controls. + + + + +line: 3105 + + +This is an experimental feature, and some features of Microsoft Excel may not be available in this mode. + + + + +line: 3106 + + +For instance, NVDA's Elements List for listing formulas and comments, and Browse mode quick navigation to jump to form fields on a spreadsheet features are not available. + + + + +line: 3107 + + +However, for basic spreadsheet navigating / editing, this option may provide a vast performance improvement. + + + + +line: 3108 + + +We still do not recommend that the majority of users turn this on by default, though we do welcome users of Microsoft Excel build 16.0.13522.10000 or higher to test this feature and provide feedback. + + + + +line: 3109 + + +Microsoft Excel's UI automation implementation is ever changing, and versions of Microsoft Office older than 16.0.13522.10000 may not expose enough information for this option to be of any use. + + + + +line: 3111 +prefix: ##### +suffix: {#UIAEnhancedEventProcessing} + + +Use enhanced event processing + + + + +line: 3115 +prefix: | +suffix: | + + +Options |Default (Enabled), Disabled, Enabled + + + + +line: 3116 +prefix: | +suffix: | + + +Default |Enabled + + + + +line: 3118 + + +When this option is enabled, NVDA should remain responsive when being flooded with many UI Automation events, e.g. large amounts of text in a terminal. + + + + +line: 3119 + + +After changing this option, you will need to restart NVDA for the change to take effect. + + + + +line: 3121 +prefix: ##### +suffix: {#AdvancedSettingsConsoleUIA} + + +Windows Console support + + + + +line: 3125 +prefix: | +suffix: | + + +Options |Automatic, UIA when available, Legacy + + + + +line: 3126 +prefix: | +suffix: | + + +Default |Automatic + + + + +line: 3128 + + +This option selects how NVDA interacts with the Windows Console used by command prompt, PowerShell, and the Windows Subsystem for Linux. + + + + +line: 3129 + + +It does not affect the modern Windows Terminal. + + + + +line: 3130 + + +In Windows 10 version 1709, Microsoft [added support for its UI Automation API to the console](https://devblogs.microsoft.com/commandline/whats-new-in-windows-console-in-windows-10-fall-creators-update/), bringing vastly improved performance and stability for screen readers that support it. + + + + +line: 3131 + + +In situations where UI Automation is unavailable or known to result in an inferior user experience, NVDA's legacy console support is available as a fallback. + + + + +line: 3132 + + +The Windows Console support combo box has three options: + + + + +line: 3134 +prefix: * + + +Automatic: Uses UI Automation in the version of Windows Console included with Windows 11 version 22H2 and later. + + + + +line: 3135 + + +This option is recommended and set by default. + + + + +line: 3136 +prefix: * + + +UIA when available: Uses UI Automation in consoles if available, even for versions with incomplete or buggy implementations. + + + + +line: 3137 + + +While this limited functionality may be useful (and even sufficient for your usage), use of this option is entirely at your own risk and no support for it will be provided. + + + + +line: 3138 +prefix: * + + +Legacy: UI Automation in the Windows Console will be completely disabled. + + + + +line: 3139 + + +The legacy fallback will always be used even in situations where UI Automation would provide a superior user experience. + + + + +line: 3140 + + +Therefore, selecting this option is not recommended unless you know what you are doing. + + + + +line: 3142 +prefix: ##### +suffix: {#ChromiumUIA} + + +Use UIA with Microsoft Edge and other Chromium based browsers when available + + + + +line: 3144 + + +Allows specifying when UIA will be used when it is available in Chromium based browsers such as Microsoft Edge. + + + + +line: 3145 + + +UIA support for Chromium based browsers is early in development and may not provide the same level of access as IA2. + + + + +line: 3146 + + +The combo box has the following options: + + + + +line: 3148 +prefix: * + + +Default (Only when necessary): The NVDA default, currently this is "Only when necessary". This default may change in the future as the technology matures. + + + + +line: 3149 +prefix: * + + +Only when necessary: When NVDA is unable to inject into the browser process in order to use IA2 and UIA is available, then NVDA will fall back to using UIA. + + + + +line: 3150 +prefix: * + + +Yes: If the browser makes UIA available, NVDA will use it. + + + + +line: 3151 +prefix: * + + +No: Don't use UIA, even if NVDA is unable to inject in process. This may be useful for developers debugging issues with IA2 and want to ensure that NVDA does not fall back to UIA. + + + + +line: 3153 +prefix: ##### +suffix: {#Annotations} + + +Annotations + + + + +line: 3155 + + +This group of options is used to enable features which add experimental support for ARIA annotations. + + + + +line: 3156 + + +Some of these features may be incomplete. + + + + +line: 3159 + + +To "Report summary of any annotation details at the system caret", press NVDA+d. + + + + +line: 3162 + + +The following options exist: + + + + +line: 3164 +prefix: * + + +"Report 'has details' for structured annotations": enables reporting if the text or control has further details. + + + + +line: 3165 +prefix: * + + +"Report aria-description always": + + + + +line: 3166 + + + When the source of `accDescription` is aria-description, the description is reported. + + + + +line: 3167 + + + This is useful for annotations on the web. + + + + +line: 3168 + + + Note: + + + + +line: 3169 +prefix: * + + +There are many sources for `accDescription` several have mixed or unreliable semantics. + + + + +line: 3170 + + + Historically AT has not been able to differentiate sources of `accDescription` typically it wasn't spoken due to the mixed semantics. + + + + +line: 3171 +prefix: * + + +This option is in very early development, it relies on browser features not yet widely available. + + + + +line: 3172 +prefix: * + + +Expected to work with Chromium 92.0.4479.0+ + + + + +line: 3174 +prefix: ##### +suffix: {#BrailleLiveRegions} + + +Report live regions + + + + +line: 3178 +prefix: | +suffix: | + + +Options |Default (Enabled), Disabled, Enabled + + + + +line: 3179 +prefix: | +suffix: | + + +Default |Enabled + + + + +line: 3181 + + +This option selects whether NVDA reports changes in some dynamic web content in Braille. + + + + +line: 3182 + + +Disabling this option is equivalent to NVDA's behaviour in versions 2023.1 and earlier, which only reported these content changes in speech. + + + + +line: 3184 +prefix: ##### +suffix: {#AdvancedSettingsWinConsoleSpeakPasswords} + + +Speak passwords in all enhanced terminals + + + + +line: 3186 + + +This setting controls whether characters are spoken by [speak typed characters](#KeyboardSettingsSpeakTypedCharacters) or [speak typed words](#KeyboardSettingsSpeakTypedWords) in situations where the screen does not update (such as password entry) in some terminal programs, such as the Windows Console with UI automation support enabled and Mintty. + + + + +line: 3187 + + +For security purposes, this setting should be left disabled. + + + + +line: 3188 + + +However, you may wish to enable it if you experience performance issues or instability with typed character and/or word reporting in consoles, or work in trusted environments and prefer password announcement. + + + + +line: 3190 +prefix: ##### +suffix: {#AdvancedSettingsKeyboardSupportInLegacy} + + +Use enhanced typed character support in legacy Windows Console when available + + + + +line: 3192 + + +This option enables an alternative method for detecting typed characters in legacy Windows consoles. + + + + +line: 3193 + + +While it improves performance and prevents some console output from being spelled out, it may be incompatible with some terminal programs. + + + + +line: 3194 + + +This feature is available and enabled by default on Windows 10 versions 1607 and later when UI Automation is unavailable or disabled. + + + + +line: 3195 + + +Warning: with this option enabled, typed characters that do not appear onscreen, such as passwords, will not be suppressed. + + + + +line: 3196 + + +In untrusted environments, you may temporarily disable [speak typed characters](#KeyboardSettingsSpeakTypedCharacters) and [speak typed words](#KeyboardSettingsSpeakTypedWords) when entering passwords. + + + + +line: 3198 +prefix: ##### +suffix: {#DiffAlgo} + + +Diff algorithm + + + + +line: 3200 + + +This setting controls how NVDA determines the new text to speak in terminals. + + + + +line: 3201 + + +The diff algorithm combo box has three options: + + + + +line: 3203 +prefix: * + + +Automatic: This option causes NVDA to prefer Diff Match Patch in most situations, but fall back to Difflib in problematic applications, such as older versions of the Windows Console and Mintty. + + + + +line: 3204 +prefix: * + + +Diff Match Patch: This option causes NVDA to calculate changes to terminal text by character, even in situations where it is not recommended. + + + + +line: 3205 + + +It may improve performance when large volumes of text are written to the console and allow more accurate reporting of changes made in the middle of lines. + + + + +line: 3206 + + +However, in some applications, reading of new text may be choppy or inconsistent. + + + + +line: 3207 +prefix: * + + +Difflib: this option causes NVDA to calculate changes to terminal text by line, even in situations where it is not recommended. + + + + +line: 3208 + + +It is identical to NVDA's behaviour in versions 2020.4 and earlier. + + + + +line: 3209 + + +This setting may stabilize reading of incoming text in some applications. + + + + +line: 3210 + + +However, in terminals, when inserting or deleting a character in the middle of a line, the text after the caret will be read out. + + + + +line: 3212 +prefix: ##### +suffix: {#WtStrategy} + + +Speak new text in Windows Terminal via + + + + +line: 3216 +prefix: | +suffix: | + + +Options |Default (Diffing), Diffing, UIA notifications + + + + +line: 3217 +prefix: | +suffix: | + + +Default |Diffing + + + + +line: 3219 + + +This option selects how NVDA determines what text is "new" (and thus what to speak when "report dynamic content changes" is enabled) in Windows Terminal and the WPF Windows Terminal control used in Visual Studio 2022. + + + + +line: 3220 + + +It does not affect the Windows Console (`conhost.exe`). + + + + +line: 3221 + + +The Speak new text in Windows Terminal combo box has three options: + + + + +line: 3223 +prefix: * + + +Default: This option is currently equivalent to "diffing", but it is anticipated to change once support for UIA notifications is further developed. + + + + +line: 3224 +prefix: * + + +Diffing: This option uses the selected diff algorithm to calculate changes each time the terminal renders new text. + + + + +line: 3225 + + +This is identical to NVDA's behaviour in versions 2022.4 and earlier. + + + + +line: 3226 +prefix: * + + +UIA notifications: This option defers the responsibility of determining what text to speak to Windows Terminal itself, meanning that NVDA no longer has to determine what text currently on-screen is "new". + + + + +line: 3227 + + +This should markedly improve performance and stability of Windows Terminal, but this feature is not yet complete. + + + + +line: 3228 + + +In particular, typed characters that are not displayed on-screen, such as passwords, are reported when this option is selected. + + + + +line: 3229 + + +Additionally, contiguous spans of output of over 1,000 characters may not be reported accurately. + + + + +line: 3231 +prefix: ##### +suffix: {#CancelExpiredFocusSpeech} + + +Attempt to cancel speech for expired focus events + + + + +line: 3233 + + +This option enables behaviour which attempts to cancel speech for expired focus events. + + + + +line: 3234 + + +In particular moving quickly through messages in Gmail with Chrome can cause NVDA to speak outdated information. + + + + +line: 3235 + + +This functionality is enabled by default as of NVDA 2021.1. + + + + +line: 3237 +prefix: ##### +suffix: {#AdvancedSettingsCaretMoveTimeout} + + +Caret move timeout (in MS) + + + + +line: 3239 + + +This option allows you to configure the number of milliseconds NVDA will wait for the caret (insertion point) to move in editable text controls. + + + + +line: 3240 + + +If you find that NVDA seems to be incorrectly tracking the caret E.g. it seems to be always one character behind or is repeating lines, then you may wish to try increasing this value. + + + + +line: 3242 +prefix: ##### +suffix: {#ReportTransparentColors} + + +Report transparency for colors + + + + +line: 3244 + + +This option enables reporting when colors are transparent, useful for addon/appModule developers gathering information to improve user experience with a 3rd party application. + + + + +line: 3245 + + +Some GDI applications will highlight text with a background color, NVDA (via display model) attempts to report this color. + + + + +line: 3246 + + +In some situations, the text background may be entirely transparent, with the text layered on some other GUI element. + + + + +line: 3247 + + +With several historically popular GUI APIs, the text may be rendered with a transparent background, but visually the background color is accurate. + + + + +line: 3249 +prefix: ##### +suffix: {#WASAPI} + + +Use WASAPI for audio output + + + + +line: 3253 +prefix: | +suffix: | + + +Options |Default (Enabled), Disabled, Enabled + + + + +line: 3254 +prefix: | +suffix: | + + +Default |Enabled + + + + +line: 3256 + + +This option enables audio output via the Windows Audio Session API (WASAPI). + + + + +line: 3257 + + +WASAPI is a more modern audio framework which may improve the responsiveness, performance and stability of NVDA audio output, including both speech and sounds. + + + + +line: 3258 + + +After changing this option, you will need to restart NVDA for the change to take effect. + + + + +line: 3259 + + +Disabling WASAPI will disable the following options: + + + + +line: 3261 +prefix: * + + +[Volume of NVDA sounds follows voice volume](#SoundVolumeFollowsVoice) + + + + +line: 3262 +prefix: * + + +[Volume of NVDA sounds](#SoundVolume) + + + + +line: 3264 +prefix: ##### +suffix: {#AdvancedSettingsDebugLoggingCategories} + + +Debug logging categories + + + + +line: 3266 + + +The checkboxes in this list allow you to enable specific categories of debug messages in NVDA's log. + + + + +line: 3267 + + +Logging these messages can result in decreased performance and large log files. + + + + +line: 3268 + + +Only turn one of these on if specifically instructed to by an NVDA developer e.g. when debugging why a braille display driver is not functioning correctly. + + + + +line: 3270 +prefix: ##### +suffix: {#PlayErrorSound} + + +Play a sound for logged errors + + + + +line: 3272 + + +This option allows you to specify if NVDA will play an error sound in case an error is logged. + + + + +line: 3273 + + +Choosing Only in test versions (default) makes NVDA play error sounds only if the current NVDA version is a test version (alpha, beta or run from source). + + + + +line: 3274 + + +Choosing Yes allows to enable error sounds whatever your current NVDA version is. + + + + +line: 3276 +prefix: ##### +suffix: {#TextParagraphRegexEdit} + + +Regular expression for text paragraph quick navigation commands + + + + +line: 3278 + + +This field allows users to customize regular expression for detecting text paragraphs in browse mode. + + + + +line: 3279 + + +The [text paragraph navigation command](#TextNavigationCommand) searches for paragraphs matched by this regular expression. + + + + +line: 3281 +prefix: ### +suffix: {#MiscSettings} + + +miscellaneous Settings + + + + +line: 3283 + + +Besides the [NVDA Settings](#NVDASettings) dialog, The Preferences sub-menu of the NVDA Menu contains several other items which are outlined below. + + + + +line: 3285 +prefix: #### +suffix: {#SpeechDictionaries} + + +Speech dictionaries + + + + +line: 3287 + + +The speech dictionaries menu (found in the Preferences menu) contains dialogs that allow you to manage the way NVDA pronounces particular words or phrases. + + + + +line: 3288 + + +There are currently three different types of speech dictionaries. + + + + +line: 3289 + + +They are: + + + + +line: 3291 +prefix: * + + +Default: rules in this dictionary affect all speech in NVDA. + + + + +line: 3292 +prefix: * + + +Voice: rules in this dictionary affect speech for the synthesizer voice currently being used. + + + + +line: 3293 +prefix: * + + +Temporary: rules in this dictionary affect all speech in NVDA, but only for the current session. These rules are temporary and will be lost if NVDA is restarted. + + + + +line: 3295 + + +You need to assign custom gestures using the [Input Gestures dialog](#InputGestures) if you wish to open any of these dictionary dialogs from anywhere. + + + + +line: 3297 + + +All dictionary dialogs contain a list of rules which will be used for processing the speech. + + + + +line: 3298 + + +The dialog also contains Add, Edit, Remove and Remove all buttons. + + + + +line: 3300 + + +To add a new rule to the dictionary, press the Add button, and fill in the fields in the dialog box that appears and then press Ok. + + + + +line: 3301 + + +You will then see your new rule in the list of rules. + + + + +line: 3302 + + +However, to make sure your rule is actually saved, make sure to press Ok to exit the dictionary dialog completely once you have finished adding/editing rules. + + + + +line: 3304 + + +The rules for NVDA's speech dictionaries allow you to change one string of characters into another. + + + + +line: 3305 + + +For example, you could create a rule which causes NVDA to say the word "frog" instead of "bird" whenever the word "bird" is encountered. + + + + +line: 3306 + + +In the Add rule dialog, the easiest way to do this is to type the word bird in the Pattern field, and the word frog in the Replacement field. + + + + +line: 3307 + + +You may also want to type a description of the rule in the Comment field (something like: changes bird to frog). + + + + +line: 3309 + + +NVDA's speech dictionaries however are much more powerful than simple word replacement. + + + + +line: 3310 + + +The Add rule dialog also contains a checkbox to say whether or not you want the rule to be case sensitive (meaning that NVDA should care whether the characters are uppercase or lowercase. + + + + +line: 3311 + + +NVDA ignores case by default). + + + + +line: 3313 + + +Finally, a set of radio buttons allows you to tell NVDA whether your pattern should match anywhere, should only match if it is a complete word or should be treated as a "Regular expression". + + + + +line: 3314 + + +Setting the pattern to match as a whole word means that the replacement will only be made if the pattern does not occur as part of a larger word. + + + + +line: 3315 + + +This condition is met if the characters immediately before and after the word are anything other than a letter, a number, or an underscore, or if there are no characters at all. + + + + +line: 3316 + + +Thus, using the earlier example of replacing the word "bird" with "frog", if you were to make this a whole word replacement, it would not match "birds" or "bluebird". + + + + +line: 3318 + + +A regular expression is a pattern containing special symbols that allow you to match on more than one character at a time, or match on just numbers, or just letters, as a few examples. + + + + +line: 3319 + + +Regular expressions are not covered in this user guide. + + + + +line: 3320 + + +For an introductory tutorial, please refer to [Python's Regular Expression Guide](https://docs.python.org/3.11/howto/regex.html). + + + + +line: 3322 +prefix: #### +suffix: {#SymbolPronunciation} + + +Punctuation/symbol pronunciation + + + + +line: 3324 + + +This dialog allows you to change the way punctuation and other symbols are pronounced, as well as the symbol level at which they are spoken. + + + + +line: 3326 + + +The language for which symbol pronunciation is being edited will be shown in the dialog's title. + + + + +line: 3327 + + +Note that this dialog respects the "Trust voice's language for processing symbols and characters" option found in the [Speech category](#SpeechSettings) of the [NVDA Settings](#NVDASettings) dialog; i.e. it uses the voice language rather than the NVDA global language setting when this option is enabled. + + + + +line: 3329 + + +To change a symbol, first select it in the Symbols list. + + + + +line: 3330 + + +You can filter the symbols by entering the symbol or a part of the symbol's replacement into the Filter by edit box. + + + + +line: 3332 +prefix: * + + +The Replacement field allows you to change the text that should be spoken in place of this symbol. + + + + +line: 3333 +prefix: * + + +Using the Level field, you can adjust the lowest symbol level at which this symbol should be spoken (none, some, most or all). + + + + +line: 3334 + + +You can also set the level to character; in this case the symbol will not be spoken regardless of the symbol level in use, with the following two exceptions: + + + + +line: 3335 +prefix: * + + +When navigating character by character. + + + + +line: 3336 +prefix: * + + +When NVDA is spelling any text containing that symbol. + + + + +line: 3337 +prefix: * + + +The Send actual symbol to synthesizer field specifies when the symbol itself (in contrast to its replacement) should be sent to the synthesizer. + + + + +line: 3338 + + +This is useful if the symbol causes the synthesizer to pause or change the inflection of the voice. + + + + +line: 3339 + + +For example, a comma causes the synthesizer to pause. + + + + +line: 3340 + + +There are three options: + + + + +line: 3341 +prefix: * + + +never: Never send the actual symbol to the synthesizer. + + + + +line: 3342 +prefix: * + + +always: Always send the actual symbol to the synthesizer. + + + + +line: 3343 +prefix: * + + +only below symbols' level: Send the actual symbol only if the configured speech symbol level is lower than the level set for this symbol. + + + + +line: 3344 + + + For example, you might use this so that a symbol will have its replacement spoken at higher levels without pausing, while still being indicated with a pause at lower levels. + + + + +line: 3346 + + +You can add new symbols by pressing the Add button. + + + + +line: 3347 + + +In the dialog that appears, enter the symbol and press the OK button. + + + + +line: 3348 + + +Then, change the fields for the new symbol as you would for other symbols. + + + + +line: 3350 + + +You can remove a symbol you previously added by pressing the Remove button. + + + + +line: 3352 + + +When you are finished, press the OK button to save your changes or the Cancel button to discard them. + + + + +line: 3354 + + +In the case of complex symbols, the Replacement field may have to include some group references of the matched text. For instance, for a pattern matching a whole date, \1, \2, and \3 would need to appear in the field, to be replaced by the corresponding parts of the date. + + + + +line: 3355 + + +Normal backslashes in the Replacement field should thus be doubled, e.g. "a\\b" should be typed in order to get the "a\b" replacement. + + + + +line: 3357 +prefix: #### +suffix: {#InputGestures} + + +Input Gestures + + + + +line: 3359 + + +In this dialog, you can customize the input gestures (keys on the keyboard, buttons on a braille display, etc.) for NVDA commands. + + + + +line: 3361 + + +Only commands that are applicable immediately before the dialog is opened are shown. + + + + +line: 3362 + + +For example, if you want to customize commands related to browse mode, you should open the Input Gestures dialog while you are in browse mode. + + + + +line: 3364 + + +The tree in this dialog lists all of the applicable NVDA commands grouped by category. + + + + +line: 3365 + + +You can filter them by entering one or more words from the command's name into the Filter by edit box in any order. + + + + +line: 3366 + + +Any gestures associated with a command are listed beneath the command. + + + + +line: 3368 + + +To add an input gesture to a command, select the command and press the Add button. + + + + +line: 3369 + + +Then, perform the input gesture you wish to associate; e.g. press a key on the keyboard or a button on a braille display. + + + + +line: 3370 + + +Often, a gesture can be interpreted in more than one way. + + + + +line: 3371 + + +For example, if you pressed a key on the keyboard, you may wish it to be specific to the current keyboard layout (e.g. desktop or laptop) or you may wish it to apply for all layouts. + + + + +line: 3372 + + +In this case, a menu will appear allowing you to select the desired option. + + + + +line: 3374 + + +To remove a gesture from a command, select the gesture and press the Remove button. + + + + +line: 3376 + + +The Emulated system keyboard keys category contains NVDA commands that emulate keys on the system keyboard. + + + + +line: 3377 + + +These emulated system keyboard keys can be used to control a system keyboard right from your braille display. + + + + +line: 3378 + + +To add an emulated input gesture, select the Emulated system keyboard keys category and press the Add button. + + + + +line: 3379 + + +Then, press the key on the keyboard you wish to emulate. + + + + +line: 3380 + + +After that, the key will be available from the Emulated system keyboard keys category and you will be able to assign an input gesture to it as described above. + + + + +line: 3382 + + +Note: + + + + +line: 3384 +prefix: * + + +Emulated keys must have gestures assigned in order to persist when saving / closing the dialog. + + + + +line: 3385 +prefix: * + + +An input gesture with modifier keys may not be able to be mapped to an emulated gesture without modifier keys. + + + + +line: 3386 + + +For instance, setting the emulated input `a` and configuring an input gesture of `ctrl+m`, may result in the application receiving `ctrl+a`. + + + + +line: 3388 + + +When you are finished making changes, press the OK button to save them or the Cancel button to discard them. + + + + +line: 3390 +prefix: ### +suffix: {#SavingAndReloading} + + +Saving and Reloading the configuration + + + + +line: 3392 + + +By default NVDA will automatically save your settings on exit. + + + + +line: 3393 + + +Note, however, that this option can be changed under the general options in the preferences menu. + + + + +line: 3394 + + +To save the settings manually at any time, choose the Save configuration item in the NVDA menu. + + + + +line: 3396 + + +If you ever make a mistake with your settings and need to revert back to the saved settings, choose the "revert to saved configuration" item in the NVDA menu. + + + + +line: 3397 + + +You can also reset your settings to their original factory defaults by choosing Reset Configuration To Factory Defaults, which is also found in the NVDA menu. + + + + +line: 3399 + + +The following NVDA key commands are also useful: + + + + +line: 3402 +prefix: | +suffix: | + + + Name |Desktop key |Laptop key |Description + + + + +line: 3404 +prefix: | +suffix: | + + +Save configuration |NVDA+control+c |NVDA+control+c |Saves your current configuration so that it is not lost when you exit NVDA + + + + +line: 3405 +prefix: | +suffix: | + + +Revert configuration |NVDA+control+r |NVDA+control+r |Pressing once resets your configuration to when you last saved it. Pressing three times will reset it back to factory defaults. + + + + +line: 3409 +prefix: ### +suffix: {#ConfigurationProfiles} + + +Configuration Profiles + + + + +line: 3411 + + +Sometimes, you may wish to have different settings for different situations. + + + + +line: 3412 + + +For example, you may wish to have reporting of indentation enabled while you are editing or reporting of font attributes enabled while you are proofreading. + + + + +line: 3413 + + +NVDA allows you to do this using configuration profiles. + + + + +line: 3415 + + +A configuration profile contains only those settings which are changed while the profile is being edited. + + + + +line: 3416 + + +Most settings can be changed in configuration profiles except for those in the General category of the [NVDA Settings](#NVDASettings) dialog, which apply to the entirety of NVDA. + + + + +line: 3418 + + +Configuration profiles can be manually activated either from a dialog or using custom added gestures. + + + + +line: 3419 + + +They can also be activated automatically due to triggers such as switching to a particular application. + + + + +line: 3421 +prefix: #### +suffix: {#ProfilesBasicManagement} + + +Basic Management + + + + +line: 3423 + + +You manage configuration profiles by selecting "Configuration profiles" in the NVDA menu. + + + + +line: 3424 + + +You can also do this using a key command: + + + + +line: 3427 +prefix: * + + +NVDA+control+p: Show the Configuration Profiles dialog. + + + + +line: 3431 + + +The first control in this dialog is the profile list from which you can select one of the available profiles. + + + + +line: 3432 + + +When you open the dialog, the profile you are currently editing is selected. + + + + +line: 3433 + + +Additional information is also shown for active profiles, indicating whether they are manually activated, triggered and/or being edited. + + + + +line: 3435 + + +To rename or delete a profile, press the Rename or Delete buttons, respectively. + + + + +line: 3437 + + +Press the Close button to close the dialog. + + + + +line: 3439 +prefix: #### +suffix: {#ProfilesCreating} + + +Creating a Profile + + + + +line: 3441 + + +To create a profile, press the New button. + + + + +line: 3443 + + +In the New Profile dialog, you can enter a name for the profile. + + + + +line: 3444 + + +You can also select how this profile should be used. + + + + +line: 3445 + + +If you only want to use this profile manually, select Manual activation, which is the default. + + + + +line: 3446 + + +Otherwise, select a trigger which should automatically activate this profile. + + + + +line: 3447 + + +For convenience, if you haven't entered a name for the profile, selecting a trigger will fill in the name accordingly. + + + + +line: 3448 + + +See [below](#ConfigProfileTriggers) for more information about triggers. + + + + +line: 3450 + + +Pressing OK will create the profile and close the Configuration Profiles dialog so you can edit it. + + + + +line: 3452 +prefix: #### +suffix: {#ConfigProfileManual} + + +Manual Activation + + + + +line: 3454 + + +You can manually activate a profile by selecting a profile and pressing the Manual activate button. + + + + +line: 3455 + + +Once activated, other profiles can still be activated due to triggers, but any settings in the manually activated profile will override them. + + + + +line: 3456 + + +For example, if a profile is triggered for the current application and reporting of links is enabled in that profile but disabled it in the manually activated profile, links will not be reported. + + + + +line: 3457 + + +However, if you have changed the voice in the triggered profile but have never changed it in the manually activated profile, the voice from the triggered profile will be used. + + + + +line: 3458 + + +Any settings you change will be saved in the manually activated profile. + + + + +line: 3459 + + +To deactivate a manually activated profile, select it in the Configuration Profiles dialog and press the Manual deactivate button. + + + + +line: 3461 +prefix: #### +suffix: {#ConfigProfileTriggers} + + +Triggers + + + + +line: 3463 + + +Pressing the Triggers button in the Configuration Profiles dialog allows you to change the profiles which should be automatically activated for various triggers. + + + + +line: 3465 + + +The Triggers list shows the available triggers, which are as follows: + + + + +line: 3467 +prefix: * + + +Current application: Triggered when you switch to the current application. + + + + +line: 3468 +prefix: * + + +Say all: Triggered while reading with the say all command. + + + + +line: 3470 + + +To change the profile which should be automatically activated for a trigger, select the trigger and then select the desired profile from the Profile list. + + + + +line: 3471 + + +You can select "(normal configuration)" if you don't want a profile to be used. + + + + +line: 3473 + + +Press the Close button to return to the Configuration Profiles dialog. + + + + +line: 3475 +prefix: #### +suffix: {#ConfigProfileEditing} + + +Editing a Profile + + + + +line: 3477 + + +If you have manually activated a profile, any settings you change will be saved to that profile. + + + + +line: 3478 + + +Otherwise, any settings you change will be saved to the most recently triggered profile. + + + + +line: 3479 + + +For example, if you have associated a profile with the Notepad application and you switch to Notepad, any changed settings will be saved to that profile. + + + + +line: 3480 + + +Finally, if there is neither a manually activated nor a triggered profile, any settings you change will be saved to your normal configuration. + + + + +line: 3482 + + +To edit the profile associated with say all, you must [manually activate](#ConfigProfileManual) that profile. + + + + +line: 3484 +prefix: #### +suffix: {#ConfigProfileDisablingTriggers} + + +Temporarily Disabling Triggers + + + + +line: 3486 + + +Sometimes, it is useful to temporarily disable all triggers. + + + + +line: 3487 + + +For example, you might wish to edit a manually activated profile or your normal configuration without triggered profiles interfering. + + + + +line: 3488 + + +You can do this by checking the Temporarily disable all triggers checkbox in the Configuration Profiles dialog. + + + + +line: 3490 + + +To toggle disabling triggers from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + + + + +line: 3492 +prefix: #### +suffix: {#ConfigProfileGestures} + + +Activating a profile using input gestures + + + + +line: 3494 + + +For every profile you add, you are able to assign one or more input gestures to activate it. + + + + +line: 3495 + + +By default, configuration profiles do not have input gestures assigned. + + + + +line: 3496 + + +You can add gestures to activate a profile using the [Input Gestures dialog](#InputGestures). + + + + +line: 3497 + + +Every profile has its own entry under the configuration profiles category. + + + + +line: 3498 + + +When you rename a profile, any gesture you added previously will still be available. + + + + +line: 3499 + + +Removing a profile will automatically delete the gestures associated with it. + + + + +line: 3501 +prefix: ### +suffix: {#LocationOfConfigurationFiles} + + +Location of Configuration files + + + + +line: 3503 + + +Portable versions of NVDA store all settings and add-ons in a directory called userConfig, found in the NVDA directory. + + + + +line: 3505 + + +Installed versions of NVDA store all settings and add-ons in a special NVDA directory located in your Windows user profile. + + + + +line: 3506 + + +This means that each user on the system can have their own NVDA settings. + + + + +line: 3507 + + +To open your settings directory from anywhere you can use [Input Gestures dialog](#InputGestures) to add a custom gesture. + + + + +line: 3508 + + +In addition for an installed version of NVDA, on the start menu you can go to programs -> NVDA -> explore user configuration directory. + + + + +line: 3510 + + +Settings for NVDA when running during sign-in or on UAC screens are stored in the systemConfig directory in NVDA's installation directory. + + + + +line: 3511 + + +Usually, this configuration should not be touched. + + + + +line: 3512 + + +To change NVDA's configuration during sign-in or on UAC screens, configure NVDA as you wish while signed into Windows, save the configuration, and then press the "use currently saved settings during sign-in and on secure screens" button in the General category of the [NVDA Settings](#NVDASettings) dialog. + + + + +line: 3514 +prefix: ## +suffix: {#AddonsManager} + + +Add-ons and the Add-on Store + + + + +line: 3516 + + +Add-ons are software packages which provide new or altered functionality for NVDA. + + + + +line: 3517 + + +They are developed by the NVDA community, and external organisations such as commercial vendors. + + + + +line: 3518 + + +Add-ons may do any of the following: + + + + +line: 3520 +prefix: * + + +Add or enhance support for certain applications. + + + + +line: 3521 +prefix: * + + +Provide support for extra Braille displays or speech synthesizers. + + + + +line: 3522 +prefix: * + + +Add or change features in NVDA. + + + + +line: 3524 + + +NVDA's Add-on Store allows you to browse and manage add-on packages. + + + + +line: 3525 + + +All add-ons that are available in the Add-on Store can be downloaded for free. + + + + +line: 3526 + + +However, some of them may require users to pay for a license or additional software before they can be used. + + + + +line: 3527 + + +Commercial speech synthesizers are an example of this type of add-on. + + + + +line: 3528 + + +If you install an add-on with paid components and change your mind about using it, the add-on can be easily removed. + + + + +line: 3530 + + +The Add-on Store is accessed from the Tools submenu of the NVDA menu. + + + + +line: 3531 + + +To access the Add-on Store from anywhere, assign a custom gesture using the [Input Gestures dialog](#InputGestures). + + + + +line: 3533 +prefix: ### +suffix: {#AddonStoreBrowsing} + + +Browsing add-ons + + + + +line: 3535 + + +When opened, the Add-on Store displays a list of add-ons. + + + + +line: 3536 + + +If you have not installed an add-on before, the Add-on Store will open to a list of add-ons available to install. + + + + +line: 3537 + + +If you have installed add-ons, the list will display currently installed add-ons. + + + + +line: 3539 + + +Selecting an add-on, by moving to it with the up and down arrow keys, will display the details for the add-on. + + + + +line: 3540 + + +Add-ons have associated actions that you can access through an [actions menu](#AddonStoreActions), such as install, help, disable, and remove. + + + + +line: 3541 + + +Available actions will change based on whether the add-on is installed or not, and whether it is enabled or disabled. + + + + +line: 3543 +prefix: #### +suffix: {#AddonStoreFilterStatus} + + +Add-on list views + + + + +line: 3545 + + +There are different views for installed, updatable, available and incompatible add-ons. + + + + +line: 3546 + + +To change the view of add-ons, change the active tab of the add-ons list using `ctrl+tab`. + + + + +line: 3547 + + +You can also `tab` to the list of views, and move through them with the `leftArrow` and `rightArrow` keys. + + + + +line: 3549 +prefix: #### +suffix: {#AddonStoreFilterEnabled} + + +Filtering for enabled or disabled add-ons + + + + +line: 3551 + + +Normally, an installed add-on is "enabled", meaning that it is running and available within NVDA. + + + + +line: 3552 + + +However, some of your installed add-ons may be set to the "disabled" state. + + + + +line: 3553 + + +This means that they will not be used, and their functions won't be available during your current NVDA session. + + + + +line: 3554 + + +You may have disabled an add-on because it conflicted with another add-on, or with a certain application. + + + + +line: 3555 + + +NVDA may also disable certain add-ons, if they are found to be incompatible during an NVDA upgrade; though you will be warned if this is going to happen. + + + + +line: 3556 + + +Add-ons can also be disabled if you simply don't need them for a prolonged period, but don't want to uninstall them because you expect to want them again in the future. + + + + +line: 3558 + + +The lists of installed and incompatible add-ons can be filtered by their enabled or disabled state. + + + + +line: 3559 + + +The default shows both enabled and disabled add-ons. + + + + +line: 3561 +prefix: #### +suffix: {#AddonStoreFilterIncompatible} + + +Include incompatible add-ons + + + + +line: 3563 + + +Available and updatable add-ons can be filtered to include [incompatible add-ons](#incompatibleAddonsManager) that are available to install. + + + + +line: 3565 +prefix: #### +suffix: {#AddonStoreFilterChannel} + + +Filter add-ons by channel + + + + +line: 3567 + + +Add-ons can be distributed through up to four channels: + + + + +line: 3569 +prefix: * + + +Stable: The developer has released this as a tested add-on with a released version of NVDA. + + + + +line: 3570 +prefix: * + + +Beta: This add-on may need further testing, but is released for user feedback. + + + + +line: 3571 + + +Suggested for early adopters. + + + + +line: 3572 +prefix: * + + +Dev: This channel is suggested to be used by add-on developers to test unreleased API changes. + + + + +line: 3573 + + +NVDA alpha testers may need to use a "Dev" version of their add-ons. + + + + +line: 3574 +prefix: * + + +External: Add-ons installed from external sources, outside of the Add-on Store. + + + + +line: 3576 + + +To list add-ons only for specific channels, change the "Channel" filter selection. + + + + +line: 3578 +prefix: #### +suffix: {#AddonStoreFilterSearch} + + +Searching for add-ons + + + + +line: 3580 + + +To search add-ons, use the "Search" text box. + + + + +line: 3581 + + +You can reach it by pressing `shift+tab` from the list of add-ons. + + + + +line: 3582 + + +Type a keyword or two for the kind of add-on you're looking for, then `tab` to the list of add-ons. + + + + +line: 3583 + + +Add-ons will be listed if the search text can be found in the add-on ID, display name, publisher, author or description. + + + + +line: 3585 +prefix: ### +suffix: {#AddonStoreActions} + + +Add-on actions + + + + +line: 3587 + + +Add-ons have associated actions, such as install, help, disable, and remove. + + + + +line: 3588 + + +For an add-on in the add-on list, these actions can be accessed through a menu opened by pressing the `applications` key, `enter`, right clicking or double clicking the add-on. + + + + +line: 3589 + + +This menu can also be accessed through an Actions button in the selected add-on's details. + + + + +line: 3591 +prefix: #### +suffix: {#AddonStoreInstalling} + + +Installing add-ons + + + + +line: 3593 + + +Just because an add-on is available in the NVDA Add-on Store, does not mean that it has been approved or vetted by NV Access or anyone else. + + + + +line: 3594 + + +It is very important to only install add-ons from sources you trust. + + + + +line: 3595 + + +The functionality of add-ons is unrestricted inside NVDA. + + + + +line: 3596 + + +This could include accessing your personal data or even the entire system. + + + + +line: 3598 + + +You can install and update add-ons by [browsing Available add-ons](#AddonStoreBrowsing). + + + + +line: 3599 + + +Select an add-on from the "Available add-ons" or "Updatable add-ons" tab. + + + + +line: 3600 + + +Then use the update, install, or replace action to start the installation. + + + + +line: 3602 + + +You can also install multiple add-ons at once. + + + + +line: 3603 + + +This can be done by selecting multiple add-ons in the available add-ons tab, then activating the context menu on the selection and choosing the "Install selected add-ons" action. + + + + +line: 3605 + + +To install an add-on you have obtained outside of the Add-on Store, press the "Install from external source" button. + + + + +line: 3606 + + +This will allow you to browse for an add-on package (`.nvda-addon` file) somewhere on your computer or on a network. + + + + +line: 3607 + + +Once you open the add-on package, the installation process will begin. + + + + +line: 3609 + + +If NVDA is installed and running on your system, you can also open an add-on file directly from the browser or file system to begin the installation process. + + + + +line: 3611 + + +When an add-on is being installed from an external source, NVDA will ask you to confirm the installation. + + + + +line: 3612 + + +Once the add-on is installed, NVDA must be restarted for the add-on to start running, although you may postpone restarting NVDA if you have other add-ons to install or update. + + + + +line: 3614 + + +By default, after NVDA startup, you will be notified if any add-on updates are available. + + + + +line: 3615 + + +To learn more about and configure this behaviour, refer to ["Update Notifications"](#AutomaticAddonUpdates). + + + + +line: 3617 +prefix: #### +suffix: {#AddonStoreRemoving} + + +Removing Add-ons + + + + +line: 3619 + + +To remove an add-on, select the add-on from the list and use the Remove action. + + + + +line: 3620 + + +NVDA will ask you to confirm removal. + + + + +line: 3621 + + +As with installing, NVDA must be restarted for the add-on to be fully removed. + + + + +line: 3622 + + +Until you do, a status of "Pending removal" will be shown for that add-on in the list. + + + + +line: 3623 + + +As with installing, you can also remove multiple add-ons at once. + + + + +line: 3625 +prefix: #### +suffix: {#AddonStoreDisablingEnabling} + + +Disabling and Enabling Add-ons + + + + +line: 3627 + + +To disable an add-on, use the "disable" action. + + + + +line: 3628 + + +To enable a previously disabled add-on, use the "enable" action. + + + + +line: 3629 + + +You can disable an add-on if the add-on status indicates it is "enabled", or enable it if the add-on is "disabled". + + + + +line: 3630 + + +For each use of the enable/disable action, add-on status changes to indicate what will happen when NVDA restarts. + + + + +line: 3631 + + +If the add-on was previously "disabled", the status will show "enabled after restart". + + + + +line: 3632 + + +If the add-on was previously "enabled", the status will show "disabled after restart". + + + + +line: 3633 + + +Just like when you install or remove add-ons, you need to restart NVDA in order for changes to take effect. + + + + +line: 3634 + + +You can also enable or disable multiple add-ons at once by selecting multiple add-ons in the available add-ons tab, then activating the context menu on the selection and choosing the appropriate action. + + + + +line: 3636 +prefix: #### +suffix: {#AddonStoreReviews} + + +Reviewing add-ons and reading reviews + + + + +line: 3638 + + +You may want to read reviews by other users who have experienced an add-on, for example before you install it, or as you are learning to use it. + + + + +line: 3639 + + +Also, it is helpful to other users to provide feedback about add-ons you have tried. + + + + +line: 3640 + + +To read reviews for an add-on, select it, and use the "Community reviews" action. + + + + +line: 3641 + + +This links to a GitHub Discussion webpage, where you will be able to read and write reviews for the add-on. + + + + +line: 3642 + + +Please be aware that this doesn't replace direct communication with add-on developers. + + + + +line: 3643 + + +Instead, the purpose of this feature is to share feedback to help users decide if an add-on may be useful for them. + + + + +line: 3645 +prefix: ### +suffix: {#incompatibleAddonsManager} + + +Incompatible Add-ons + + + + +line: 3647 + + +Some older add-ons may no longer be compatible with the version of NVDA that you have. + + + + +line: 3648 + + +If you are using an older version of NVDA, some newer add-ons may not be compatible either. + + + + +line: 3649 + + +Attempting to install an incompatible add-on will result in an error explaining why the add-on is considered incompatible. + + + + +line: 3651 + + +For older add-ons, you can override the incompatibility at your own risk. + + + + +line: 3652 + + +Incompatible add-ons may not work with your version of NVDA, and can cause unstable or unexpected behaviour including crashing. + + + + +line: 3653 + + +You can override compatibility when enabling or installing an add-on. + + + + +line: 3654 + + +If the incompatible add-on causes issues later, you can disable or remove it. + + + + +line: 3656 + + +If you are having trouble running NVDA, and you have recently updated or installed an add-on, especially if it is an incompatible add-on, you may want to try running NVDA temporarily with all add-ons disabled. + + + + +line: 3657 + + +To restart NVDA with all add-ons disabled, choose the appropriate option when quitting NVDA. + + + + +line: 3658 + + +Alternatively, use the [command line option](#CommandLineOptions) `--disable-addons`. + + + + +line: 3660 + + +You can browse available incompatible add-ons using the [available and updatable add-ons tabs](#AddonStoreFilterStatus). + + + + +line: 3661 + + +You can browse installed incompatible add-ons using the [incompatible add-ons tab](#AddonStoreFilterStatus). + + + + +line: 3663 +prefix: ## +suffix: {#ExtraTools} + + +Extra Tools + + + + +line: 3664 +prefix: ### +suffix: {#LogViewer} + + +Log Viewer + + + + +line: 3666 + + +The log viewer, found under Tools in the NVDA menu, allows you to view the logging output that has occurred since the latest session of NVDA was started. + + + + +line: 3668 + + +Apart from reading the content, you can also Save a copy of the log file, or refresh the viewer so that it loads new log output generated after the Log viewer was opened. + + + + +line: 3669 + + +These actions are available under the Log menu in the log viewer. + + + + +line: 3671 + + +The file which is displayed when you open the log viewer is saved on your computer at the file location `%temp%\nvda.log`. + + + + +line: 3672 + + +A new log file is created each time NVDA is started. + + + + +line: 3673 + + +When this happens, the previous NVDA session's log file is moved to `%temp%\nvda-old.log`. + + + + +line: 3675 + + +You can also copy a fragment of the current log file to the clipboard without opening the log viewer. + + + + +line: 3678 +prefix: | +suffix: | + + + Name |Key |Description + + + + +line: 3680 +prefix: | +suffix: | + + +Open log viewer |`NVDA+f1` |Opens the log viewer and displays developer information about the current navigator object. + + + + +line: 3681 +prefix: | +suffix: | + + +Copy a fragment of the log to the clipboard |`NVDA+control+shift+f1` |When this command is pressed once, it sets a starting point for the log content that should be captured. When pressed a second time, it copies the log content since the start point to your clipboard. + + + + +line: 3685 +prefix: ### +suffix: {#SpeechViewer} + + +Speech Viewer + + + + +line: 3687 + + +For sighted software developers or people demoing NVDA to sighted audiences, a floating window is available that allows you to view all the text that NVDA is currently speaking. + + + + +line: 3689 + + +To enable the speech viewer, check the "Speech Viewer" menu item under Tools in the NVDA menu. + + + + +line: 3690 + + +Uncheck the menu item to disable it. + + + + +line: 3692 + + +The speech viewer window contains a check box labelled "Show speech viewer on startup". + + + + +line: 3693 + + +If this is checked, the speech viewer will open when NVDA is started. + + + + +line: 3694 + + +The speech viewer window will always attempt to re-open with the same dimensions and location as when it was closed. + + + + +line: 3696 + + +While the speech viewer is enabled, it constantly updates to show you the most current text being spoken. + + + + +line: 3697 + + +However, if you hover your mouse over or focus inside the viewer, NVDA will temporarily stop updating the text, so that you are able to easily select or copy the existing content. + + + + +line: 3699 + + +To toggle the speech viewer from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + + + + +line: 3701 +prefix: ### +suffix: {#BrailleViewer} + + +Braille Viewer + + + + +line: 3703 + + +For sighted software developers or people demoing NVDA to sighted audiences, a floating window is available that allows you to view braille output, and the text equivalent for each braille character. + + + + +line: 3704 + + +The braille viewer can be used at the same time as a physical braille display, it will match the number of cells on the physical device. + + + + +line: 3705 + + +While the braille viewer is enabled, it constantly updates to show you the braille that would be displayed on a physical braille display. + + + + +line: 3707 + + +To enable the braille viewer, check the "Braille Viewer" menu item under Tools in the NVDA menu. + + + + +line: 3708 + + +Uncheck the menu item to disable it. + + + + +line: 3710 + + +Physical braille displays typically have buttons to scroll forwards or backwards, to enable scrolling with the braille viewer tool use the [Input Gestures dialog](#InputGestures) to assign keyboard shortcuts which "Scrolls the braille display back" and "Scrolls the braille display forward" + + + + +line: 3712 + + +The braille viewer window contains a check box labelled "Show braille viewer on startup". + + + + +line: 3713 + + +If this is checked, the braille viewer will open when NVDA is started. + + + + +line: 3714 + + +The braille viewer window will always attempt to re-open with the same dimensions and location as when it was closed. + + + + +line: 3716 + + +The braille viewer window contains a check box labeled "Hover for cell routing", the default is unchecked. + + + + +line: 3717 + + +If checked, hovering the mouse over a braille cell will enable trigger the "route to braille cell" command for that cell. + + + + +line: 3718 + + +This is often used to move the caret or trigger the action for a control. + + + + +line: 3719 + + +This can be useful for testing NVDA is able to correctly reverse map a from braille cell. + + + + +line: 3720 + + +To prevent unintentionally routing to cells, the command is delayed. + + + + +line: 3721 + + +The mouse must hover until the cell turns green. + + + + +line: 3722 + + +The cell will start as a light yellow colour, transition to orange, then suddenly become green. + + + + +line: 3724 + + +To toggle the braille viewer from anywhere, please assign a custom gesture using the [Input Gestures dialog](#InputGestures). + + + + +line: 3726 +prefix: ### +suffix: {#PythonConsole} + + +Python Console + + + + +line: 3728 + + +The NVDA Python console, found under Tools in the NVDA menu, is a development tool which is useful for debugging, general inspection of NVDA internals or inspection of the accessibility hierarchy of an application. + + + + +line: 3729 + + +For more information, please see the [NVDA Developer Guide](https://www.nvaccess.org/files/nvda/documentation/developerGuide.html). + + + + +line: 3731 +prefix: ### +suffix: {#AddonStoreMenuItem} + + +Add-on Store + + + + +line: 3733 + + +This will open the [NVDA Add-on Store](#AddonsManager). + + + + +line: 3734 + + +For more information, read the in-depth section: [Add-ons and the Add-on Store](#AddonsManager). + + + + +line: 3736 +prefix: ### +suffix: {#CreatePortableCopy} + + +Create portable copy + + + + +line: 3738 + + +This will open a dialog which allows you to create a portable copy of NVDA out of the currently running version. + + + + +line: 3740 + + +Follow the directions in [Creating a portable copy](#CreatingAPortableCopy) for more information. + + + + +line: 3742 +prefix: ### +suffix: {#RunCOMRegistrationFixingTool} + + +Run COM registration fixing tool... + + + + +line: 3744 + + +Installing and uninstalling programs on a computer can, in certain cases, cause COM DLL files to get unregistered. + + + + +line: 3745 + + +As COM Interfaces such as IAccessible depend on correct COM DLL registrations, issues can appear in case the correct registration is missing. + + + + +line: 3747 + + +This can happen i.e. after installing and uninstalling Adobe Reader, Math Player and other programs. + + + + +line: 3749 + + +The missing registration can cause issues in browsers, desktop apps, task bar and other interfaces. + + + + +line: 3751 + + +Specifically, following issues can be solved by running this tool: + + + + +line: 3753 +prefix: * + + +NVDA reports "unknown" when navigating in browsers such as Firefox, Thunderbird etc. + + + + +line: 3754 +prefix: * + + +NVDA fails to switch between focus mode and browse mode + + + + +line: 3755 +prefix: * + + +NVDA is very slow when navigating in browsers while using browse mode + + + + +line: 3756 +prefix: * + + +And possibly other issues. + + + + +line: 3758 +prefix: ### +suffix: {#ReloadPlugins} + + +Reload plugins + + + + +line: 3760 + + +This item, once activated, reloads app modules and global plugins without restarting NVDA, which can be useful for developers. + + + + +line: 3761 + + +App modules manage how NVDA interacts with specific applications. + + + + +line: 3762 + + +Global plugins manage how NVDA interacts with all applications. + + + + +line: 3764 + + +The following NVDA key commands may also be useful: + + + + +line: 3767 +prefix: | +suffix: | + + + Name |Key |Description + + + + +line: 3769 +prefix: | +suffix: | + + +Reload plugins |`NVDA+control+f3` |Reloads NVDA's global plugins and app modules. + + + + +line: 3770 +prefix: | +suffix: | + + +Report loaded app module and executable |`NVDA+control+f1` |Report the name of the app module, if any, and the name of the executable associated with the application which has the keyboard focus. + + + + +line: 3774 +prefix: ## +suffix: {#SupportedSpeechSynths} + + +Supported Speech Synthesizers + + + + +line: 3776 + + +This section contains information about the speech synthesizers supported by NVDA. + + + + +line: 3777 + + +For an even more extensive list of free and commercial synthesizers that you can purchase and download for use with NVDA, please see the [extra voices page](https://github.com/nvaccess/nvda/wiki/ExtraVoices). + + + + +line: 3779 +prefix: ### +suffix: {#eSpeakNG} + + +eSpeak NG + + + + +line: 3781 + + +The [eSpeak NG](https://github.com/espeak-ng/espeak-ng) synthesizer is built directly into NVDA and does not require any other special drivers or components to be installed. + + + + +line: 3782 + + +On Windows 8.1 NVDA uses eSpeak NG by default ([Windows OneCore](#OneCore) is used in Windows 10 and later by default). + + + + +line: 3783 + + +As this synthesizer is built into NVDA, this is a great choice for when running NVDA off a USB thumb drive on other systems. + + + + +line: 3785 + + +Each voice that comes with eSpeak NG speaks a different language. + + + + +line: 3786 + + +There are over 43 different languages supported by eSpeak NG. + + + + +line: 3788 + + +There are also many variants which can be chosen to alter the sound of the voice. + + + + +line: 3790 +prefix: ### +suffix: {#SAPI4} + + +Microsoft Speech API version 4 (SAPI 4) + + + + +line: 3792 + + +SAPI 4 is an older Microsoft standard for software speech synthesizers. + + + + +line: 3793 + + +NVDA still supports this for users who already have SAPI 4 synthesizers installed. + + + + +line: 3794 + + +However, Microsoft no longer support this and needed components are no longer available from Microsoft. + + + + +line: 3796 + + +When using this synthesizer with NVDA, the available voices (accessed from the [Speech category](#SpeechSettings) of the [NVDA Settings](#NVDASettings) dialog or by the [Synth Settings Ring](#SynthSettingsRing)) will contain all the voices from all the installed SAPI 4 engines found on your system. + + + + +line: 3798 +prefix: ### +suffix: {#SAPI5} + + +Microsoft Speech API version 5 (SAPI 5) + + + + +line: 3800 + + +SAPI 5 is a Microsoft standard for software speech synthesizers. + + + + +line: 3801 + + +Many speech synthesizers that comply with this standard may be purchased or downloaded for free from various companies and websites, though your system will probably already come with at least one SAPI 5 voice preinstalled. + + + + +line: 3802 + + +When using this synthesizer with NVDA, the available voices (accessed from the [Speech category](#SpeechSettings) of the [NVDA Settings](#NVDASettings) dialog or by the [Synth Settings Ring](#SynthSettingsRing)) will contain all the voices from all the installed SAPI 5 engines found on your system. + + + + +line: 3804 +prefix: ### +suffix: {#MicrosoftSpeechPlatform} + + +Microsoft Speech Platform + + + + +line: 3806 + + +The Microsoft Speech Platform provides voices for many languages which are normally used in the development of server-based speech applications. + + + + +line: 3807 + + +These voices can also be used with NVDA. + + + + +line: 3809 + + +To use these voices, you will need to install two components: + + + + +line: 3811 +prefix: * + + +[Microsoft Speech Platform - Runtime (Version 11), x86](https://www.microsoft.com/download/en/details.aspx?id=27225) + + + + +line: 3812 +prefix: * + + +[Microsoft Speech Platform - Runtime Languages (Version 11)](https://www.microsoft.com/download/en/details.aspx?id=27224) + + + + +line: 3813 +prefix: * + + +This page includes many files for both speech recognition and text-to-speech. + + + + +line: 3814 + + + Choose the files containing the TTS data for the desired languages/voices. + + + + +line: 3815 + + + For example, the file MSSpeech_TTS_en-US_ZiraPro.msi is a U.S. English voice. + + + + +line: 3817 +prefix: ### +suffix: {#OneCore} + + +Windows OneCore Voices + + + + +line: 3819 + + +Windows 10 and later includes voices known as "OneCore" or "mobile" voices. + + + + +line: 3820 + + +Voices are provided for many languages, and they are more responsive than the Microsoft voices available using Microsoft Speech API version 5. + + + + +line: 3821 + + +On Windows 10 and later, NVDA uses Windows OneCore voices by default ([eSpeak NG](#eSpeakNG) is used in other releases). + + + + +line: 3823 + + +To add new Windows OneCore voices, go to "Speech Settings", within Windows system settings. + + + + +line: 3824 + + +Use the "Add voices" option and search for the desired language. + + + + +line: 3825 + + +Many languages include multiple variants. + + + + +line: 3826 + + +"United Kingdom" and "Australia" are two of the English variants. + + + + +line: 3827 + + +"France", "Canada" and "Switzerland" are French variants available. + + + + +line: 3828 + + +Search for the broader language (such as English or French), then locate the variant in the list. + + + + +line: 3829 + + +Select any languages desired and use the "add" button to add them. + + + + +line: 3830 + + +Once added, restart NVDA. + + + + +line: 3832 + + +Please see [Supported languages and voices](https://support.microsoft.com/en-us/windows/appendix-a-supported-languages-and-voices-4486e345-7730-53da-fcfe-55cc64300f01) for a list of available voices. + + + + +line: 3834 +prefix: ## +suffix: {#SupportedBrailleDisplays} + + +Supported Braille Displays + + + + +line: 3836 + + +This section contains information about the Braille displays supported by NVDA. + + + + +line: 3838 +prefix: ### +suffix: {#AutomaticDetection} + + +Displays supporting automatic detection in the background + + + + +line: 3840 + + +NVDA has the ability to detect many braille displays in the background automatically, either via USB or bluetooth. + + + + +line: 3841 + + +This behaviour is achieved by selecting the Automatic option as the preferred braille display from NVDA's [Braille Settings dialog](#BrailleSettings). + + + + +line: 3842 + + +This option is selected by default. + + + + +line: 3844 + + +The following displays support this automatic detection functionality. + + + + +line: 3846 +prefix: * + + +Handy Tech displays + + + + +line: 3847 +prefix: * + + +Baum/Humanware/APH/Orbit braille displays + + + + +line: 3848 +prefix: * + + +HumanWare Brailliant BI/B series + + + + +line: 3849 +prefix: * + + +HumanWare BrailleNote + + + + +line: 3850 +prefix: * + + +SuperBraille + + + + +line: 3851 +prefix: * + + +Optelec ALVA 6 series + + + + +line: 3852 +prefix: * + + +HIMS Braille Sense/Braille EDGE/Smart Beetle/Sync Braille Series + + + + +line: 3853 +prefix: * + + +Eurobraille Esys/Esytime/Iris displays + + + + +line: 3854 +prefix: * + + +Nattiq nBraille displays + + + + +line: 3855 +prefix: * + + +Seika Notetaker: MiniSeika (16, 24 cells), V6, and V6Pro (40 cells) + + + + +line: 3856 +prefix: * + + +Tivomatic Caiku Albatross 46/80 displays + + + + +line: 3857 +prefix: * + + +Any Display that supports the Standard HID Braille protocol + + + + +line: 3859 +prefix: ### +suffix: {#FreedomScientificFocus} + + +Freedom Scientific Focus/PAC Mate Series + + + + +line: 3861 + + +All Focus and PAC Mate displays from [Freedom Scientific](https://www.freedomscientific.com/) are supported when connected via USB or bluetooth. + + + + +line: 3862 + + +You will need the Freedom Scientific braille display drivers installed on your system. + + + + +line: 3863 + + +If you do not have them already, you can obtain them from the [Focus Blue Braille Display Driver page](https://support.freedomscientific.com/Downloads/Focus/FocusBlueBrailleDisplayDriver). + + + + +line: 3864 + + +Although this page only mentions the Focus Blue display, the drivers support all Freedom Scientific Focus and Pacmate displays. + + + + +line: 3866 + + +By default, NVDA can automatically detect and connect to these displays either via USB or bluetooth. + + + + +line: 3867 + + +However, when configuring the display, you can explicitly select "USB" or "Bluetooth" ports to restrict the connection type to be used. + + + + +line: 3868 + + +This might be useful if you want to connect the focus display to NVDA using bluetooth, but still be able to charge it using USB power from your computer. + + + + +line: 3869 + + +NVDA's automatic braille display detection will also recognize the display on USB or Bluetooth. + + + + +line: 3871 + + +Following are the key assignments for this display with NVDA. + + + + +line: 3872 + + +Please see the display's documentation for descriptions of where these keys can be found. + + + + +line: 3875 +prefix: | +suffix: | + + + Name |Key + + + + +line: 3877 +prefix: | +suffix: | + + +Scroll braille display back |topRouting1 (first cell on display) + + + + +line: 3878 +prefix: | +suffix: | + + +Scroll braille display forward |topRouting20/40/80 (last cell on display) + + + + +line: 3879 +prefix: | +suffix: | + + +Scroll braille display back |leftAdvanceBar + + + + +line: 3880 +prefix: | +suffix: | + + +Scroll braille display forward |rightAdvanceBar + + + + +line: 3881 +prefix: | +suffix: | + + +Toggle braille tethered to |leftGDFButton+rightGDFButton + + + + +line: 3882 +prefix: | +suffix: | + + +Toggle left wiz wheel action |leftWizWheelPress + + + + +line: 3883 +prefix: | +suffix: | + + +Move back using left wiz wheel action |leftWizWheelUp + + + + +line: 3884 +prefix: | +suffix: | + + +Move forward using left wiz wheel action |leftWizWheelDown + + + + +line: 3885 +prefix: | +suffix: | + + +Toggle right wiz wheel action |rightWizWheelPress + + + + +line: 3886 +prefix: | +suffix: | + + +Move back using right wiz wheel action |rightWizWheelUp + + + + +line: 3887 +prefix: | +suffix: | + + +Move forward using right wiz wheel action |rightWizWheelDown + + + + +line: 3888 +prefix: | +suffix: | + + +Route to braille cell |routing + + + + +line: 3889 +prefix: | +suffix: | + + +shift+tab key |brailleSpaceBar+dot1+dot2 + + + + +line: 3890 +prefix: | +suffix: | + + +tab key |brailleSpaceBar+dot4+dot5 + + + + +line: 3891 +prefix: | +suffix: | + + +upArrow key |brailleSpaceBar+dot1 + + + + +line: 3892 +prefix: | +suffix: | + + +downArrow key |brailleSpaceBar+dot4 + + + + +line: 3893 +prefix: | +suffix: | + + +control+leftArrow key |brailleSpaceBar+dot2 + + + + +line: 3894 +prefix: | +suffix: | + + +control+rightArrow key |brailleSpaceBar+dot5 + + + + +line: 3895 +prefix: | +suffix: | + + +leftArrow |brailleSpaceBar+dot3 + + + + +line: 3896 +prefix: | +suffix: | + + +rightArrow key |brailleSpaceBar+dot6 + + + + +line: 3897 +prefix: | +suffix: | + + +home key |brailleSpaceBar+dot1+dot3 + + + + +line: 3898 +prefix: | +suffix: | + + +end key |brailleSpaceBar+dot4+dot6 + + + + +line: 3899 +prefix: | +suffix: | + + +control+home key |brailleSpaceBar+dot1+dot2+dot3 + + + + +line: 3900 +prefix: | +suffix: | + + +control+end key |brailleSpaceBar+dot4+dot5+dot6 + + + + +line: 3901 +prefix: | +suffix: | + + +alt key |brailleSpaceBar+dot1+dot3+dot4 + + + + +line: 3902 +prefix: | +suffix: | + + +alt+tab key |brailleSpaceBar+dot2+dot3+dot4+dot5 + + + + +line: 3903 +prefix: | +suffix: | + + +alt+shift+tab key |brailleSpaceBar+dot1+dot2+dot5+dot6 + + + + +line: 3904 +prefix: | +suffix: | + + +windows+tab key |brailleSpaceBar+dot2+dot3+dot4 + + + + +line: 3905 +prefix: | +suffix: | + + +escape key |brailleSpaceBar+dot1+dot5 + + + + +line: 3906 +prefix: | +suffix: | + + +windows key |brailleSpaceBar+dot2+dot4+dot5+dot6 + + + + +line: 3907 +prefix: | +suffix: | + + +space key |brailleSpaceBar + + + + +line: 3908 +prefix: | +suffix: | + + +Toggle control key |brailleSpaceBar+dot3+dot8 + + + + +line: 3909 +prefix: | +suffix: | + + +Toggle alt key |brailleSpaceBar+dot6+dot8 + + + + +line: 3910 +prefix: | +suffix: | + + +Toggle windows key |brailleSpaceBar+dot4+dot8 + + + + +line: 3911 +prefix: | +suffix: | + + +Toggle NVDA key |brailleSpaceBar+dot5+dot8 + + + + +line: 3912 +prefix: | +suffix: | + + +Toggle shift key |brailleSpaceBar+dot7+dot8 + + + + +line: 3913 +prefix: | +suffix: | + + +Toggle control and shift keys |brailleSpaceBar+dot3+dot7+dot8 + + + + +line: 3914 +prefix: | +suffix: | + + +Toggle alt and shift keys |brailleSpaceBar+dot6+dot7+dot8 + + + + +line: 3915 +prefix: | +suffix: | + + +Toggle windows and shift keys |brailleSpaceBar+dot4+dot7+dot8 + + + + +line: 3916 +prefix: | +suffix: | + + +Toggle NVDA and shift keys |brailleSpaceBar+dot5+dot7+dot8 + + + + +line: 3917 +prefix: | +suffix: | + + +Toggle control and alt keys |brailleSpaceBar+dot3+dot6+dot8 + + + + +line: 3918 +prefix: | +suffix: | + + +Toggle control, alt, and shift keys |brailleSpaceBar+dot3+dot6+dot7+dot8 + + + + +line: 3919 +prefix: | +suffix: | + + +windows+d key (minimize all applications) |brailleSpaceBar+dot1+dot2+dot3+dot4+dot5+dot6 + + + + +line: 3920 +prefix: | +suffix: | + + +Report Current Line |brailleSpaceBar+dot1+dot4 + + + + +line: 3921 +prefix: | +suffix: | + + +NVDA menu |brailleSpaceBar+dot1+dot3+dot4+dot5 + + + + +line: 3923 + + +For newer Focus models that contain rocker bar keys (focus 40, focus 80 and focus blue): + + + + +line: 3925 +prefix: | +suffix: | + + + Name |Key + + + + +line: 3927 +prefix: | +suffix: | + + +Move braille display to previous line |leftRockerBarUp, rightRockerBarUp + + + + +line: 3928 +prefix: | +suffix: | + + +Move braille display to next line |leftRockerBarDown, rightRockerBarDown + + + + +line: 3930 + + +For Focus 80 only: + + + + +line: 3932 +prefix: | +suffix: | + + + Name |Key + + + + +line: 3934 +prefix: | +suffix: | + + +Scroll braille display back |leftBumperBarUp, rightBumperBarUp + + + + +line: 3935 +prefix: | +suffix: | + + +Scroll braille display forward |leftBumperBarDown, rightBumperBarDown + + + + +line: 3939 +prefix: ### +suffix: {#OptelecALVA} + + +Optelec ALVA 6 series/protocol converter + + + + +line: 3941 + + +Both the ALVA BC640 and BC680 displays from [Optelec](https://www.optelec.com/) are supported when connected via USB or bluetooth. + + + + +line: 3942 + + +Alternatively, you can connect an older Optelec display, such as a Braille Voyager, using a protocol converter supplied by Optelec. + + + + +line: 3943 + + +You do not need any specific drivers to be installed to use these displays. + + + + +line: 3944 + + +Just plug in the display and configure NVDA to use it. + + + + +line: 3946 + + +Note: NVDA might be unable to use an ALVA BC6 display over Bluetooth when it is paired using the ALVA Bluetooth utility. + + + + +line: 3947 + + +When you have paired your device using this utility and NVDA is unable to detect your device, we recommend you to pair your ALVA display the regular way using the Windows Bluetooth settings. + + + + +line: 3949 + + +Note: while some of these displays do have a braille keyboard, they handle translation from braille to text themselves by default. + + + + +line: 3950 + + +This means that NVDA's braille input system is not in use in the default situation (i.e. the input braille table setting has no effect). + + + + +line: 3951 + + +For ALVA displays with recent firmware, it is possible to disable this HID keyboard simulation using an input gesture. + + + + +line: 3953 + + +Following are key assignments for this display with NVDA. + + + + +line: 3954 + + +Please see the display's documentation for descriptions of where these keys can be found. + + + + +line: 3957 +prefix: | +suffix: | + + + Name |Key + + + + +line: 3959 +prefix: | +suffix: | + + +Scroll braille display back |t1, etouch1 + + + + +line: 3960 +prefix: | +suffix: | + + +Move braille display to previous line |t2 + + + + +line: 3961 +prefix: | +suffix: | + + +Move to current focus |t3 + + + + +line: 3962 +prefix: | +suffix: | + + +Move braille display to next line |t4 + + + + +line: 3963 +prefix: | +suffix: | + + +Scroll braille display forward |t5, etouch3 + + + + +line: 3964 +prefix: | +suffix: | + + +Route to braille cell |routing + + + + +line: 3965 +prefix: | +suffix: | + + +Report text formatting under braille cell |secondary routing + + + + +line: 3966 +prefix: | +suffix: | + + +Toggle HID keyboard simulation |t1+spEnter + + + + +line: 3967 +prefix: | +suffix: | + + +Move to top line in review |t1+t2 + + + + +line: 3968 +prefix: | +suffix: | + + +Move to bottom line in review |t4+t5 + + + + +line: 3969 +prefix: | +suffix: | + + +Toggle braille tethered to |t1+t3 + + + + +line: 3970 +prefix: | +suffix: | + + +Report title |etouch2 + + + + +line: 3971 +prefix: | +suffix: | + + +Report status bar |etouch4 + + + + +line: 3972 +prefix: | +suffix: | + + +shift+tab key |sp1 + + + + +line: 3973 +prefix: | +suffix: | + + +alt key |sp2, alt + + + + +line: 3974 +prefix: | +suffix: | + + +escape key |sp3 + + + + +line: 3975 +prefix: | +suffix: | + + +tab key |sp4 + + + + +line: 3976 +prefix: | +suffix: | + + +upArrow key |spUp + + + + +line: 3977 +prefix: | +suffix: | + + +downArrow key |spDown + + + + +line: 3978 +prefix: | +suffix: | + + +leftArrow key |spLeft + + + + +line: 3979 +prefix: | +suffix: | + + +rightArrow key |spRight + + + + +line: 3980 +prefix: | +suffix: | + + +enter key |spEnter, enter + + + + +line: 3981 +prefix: | +suffix: | + + +Report date/time |sp2+sp3 + + + + +line: 3982 +prefix: | +suffix: | + + +NVDA Menu |sp1+sp3 + + + + +line: 3983 +prefix: | +suffix: | + + +windows+d key (minimize all applications) |sp1+sp4 + + + + +line: 3984 +prefix: | +suffix: | + + +windows+b key (focus system tray) |sp3+sp4 + + + + +line: 3985 +prefix: | +suffix: | + + +windows key |sp1+sp2, windows + + + + +line: 3986 +prefix: | +suffix: | + + +alt+tab key |sp2+sp4 + + + + +line: 3987 +prefix: | +suffix: | + + +control+home key |t3+spUp + + + + +line: 3988 +prefix: | +suffix: | + + +control+end key |t3+spDown + + + + +line: 3989 +prefix: | +suffix: | + + +home key |t3+spLeft + + + + +line: 3990 +prefix: | +suffix: | + + +end key |t3+spRight + + + + +line: 3991 +prefix: | +suffix: | + + +control key |control + + + + +line: 3995 +prefix: ### +suffix: {#HandyTech} + + +Handy Tech Displays + + + + +line: 3997 + + +NVDA supports most displays from [Handy Tech](https://www.handytech.de/) when connected via USB, serial port or bluetooth. + + + + +line: 3998 + + +For older USB displays, you will need to install the USB drivers from Handy Tech on your system. + + + + +line: 4000 + + +The following displays are not supported out of the box, but can be used via [Handy Tech's universal driver](https://handytech.de/en/service/downloads-and-manuals/handy-tech-software/braille-display-drivers) and NVDA add-on: + + + + +line: 4002 +prefix: * + + +Braillino + + + + +line: 4003 +prefix: * + + +Bookworm + + + + +line: 4004 +prefix: * + + +Modular displays with firmware version 1.13 or lower. Please note that the firmware of this displays can be updated. + + + + +line: 4006 + + +Following are the key assignments for Handy Tech displays with NVDA. + + + + +line: 4007 + + +Please see the display's documentation for descriptions of where these keys can be found. + + + + +line: 4010 +prefix: | +suffix: | + + + Name |Key + + + + +line: 4012 +prefix: | +suffix: | + + +Scroll braille display back |left, up, b3 + + + + +line: 4013 +prefix: | +suffix: | + + +Scroll braille display forward |right, down, b6 + + + + +line: 4014 +prefix: | +suffix: | + + +Move braille display to previous line |b4 + + + + +line: 4015 +prefix: | +suffix: | + + +Move braille display to next line |b5 + + + + +line: 4016 +prefix: | +suffix: | + + +Route to braille cell |routing + + + + +line: 4017 +prefix: | +suffix: | + + +shift+tab key |esc, left triple action key up+down + + + + +line: 4018 +prefix: | +suffix: | + + +alt key |b2+b4+b5 + + + + +line: 4019 +prefix: | +suffix: | + + +escape key |b4+b6 + + + + +line: 4020 +prefix: | +suffix: | + + +tab key |enter, right triple action key up+down + + + + +line: 4021 +prefix: | +suffix: | + + +enter key |esc+enter, left+right triple action key up+down, joystickAction + + + + +line: 4022 +prefix: | +suffix: | + + +upArrow key |joystickUp + + + + +line: 4023 +prefix: | +suffix: | + + +downArrow key |joystickDown + + + + +line: 4024 +prefix: | +suffix: | + + +leftArrow key |joystickLeft + + + + +line: 4025 +prefix: | +suffix: | + + +rightArrow key |joystickRight + + + + +line: 4026 +prefix: | +suffix: | + + +NVDA Menu |b2+b4+b5+b6 + + + + +line: 4027 +prefix: | +suffix: | + + +Toggle braille tethered to |b2 + + + + +line: 4028 +prefix: | +suffix: | + + +Toggle the braille cursor |b1 + + + + +line: 4029 +prefix: | +suffix: | + + +Toggle focus context presentation |b7 + + + + +line: 4030 +prefix: | +suffix: | + + +Toggle braille input |space+b1+b3+b4 (space+capital B) + + + + +line: 4034 +prefix: ### +suffix: {#MDVLilli} + + +MDV Lilli + + + + +line: 4036 + + +The Lilli braille display available from [MDV](https://www.mdvbologna.it/) is supported. + + + + +line: 4037 + + +You do not need any specific drivers to be installed to use this display. + + + + +line: 4038 + + +Just plug in the display and configure NVDA to use it. + + + + +line: 4040 + + +This display does not support NVDA's automatic background braille display detection functionality. + + + + +line: 4042 + + +Following are the key assignments for this display with NVDA. + + + + +line: 4043 + + +Please see the display's documentation for descriptions of where these keys can be found. + + + + +line: 4046 +prefix: | +suffix: | + + + Name |Key + + + + +line: 4048 +prefix: | +suffix: | + + +Scroll braille display backward |LF + + + + +line: 4049 +prefix: | +suffix: | + + +Scroll braille display forward |RG + + + + +line: 4050 +prefix: | +suffix: | + + +Move braille display to previous line |UP + + + + +line: 4051 +prefix: | +suffix: | + + +Move braille display to next line |DN + + + + +line: 4052 +prefix: | +suffix: | + + +Route to braille cell |route + + + + +line: 4053 +prefix: | +suffix: | + + +shift+tab key |SLF + + + + +line: 4054 +prefix: | +suffix: | + + +tab key |SRG + + + + +line: 4055 +prefix: | +suffix: | + + +alt+tab key |SDN + + + + +line: 4056 +prefix: | +suffix: | + + +alt+shift+tab key |SUP + + + + +line: 4060 +prefix: ### +suffix: {#Baum} + + +Baum/Humanware/APH/Orbit Braille Displays + + + + +line: 4062 + + +Several [Baum](https://www.visiobraille.de/index.php?article_id=1&clang=2), [HumanWare](https://www.humanware.com/), [APH](https://www.aph.org/) and [Orbit](https://www.orbitresearch.com/) displays are supported when connected via USB, bluetooth or serial. + + + + +line: 4063 + + +These include: + + + + +line: 4065 +prefix: * + + +Baum: SuperVario, PocketVario, VarioUltra, Pronto!, SuperVario2, Vario 340 + + + + +line: 4066 +prefix: * + + +HumanWare: Brailliant, BrailleConnect, Brailliant2 + + + + +line: 4067 +prefix: * + + +APH: Refreshabraille + + + + +line: 4068 +prefix: * + + +Orbit: Orbit Reader 20 + + + + +line: 4070 + + +Some other displays manufactured by Baum may also work, though this has not been tested. + + + + +line: 4072 + + +If connecting via USB to displays which do not use HID, you must first install the USB drivers provided by the manufacturer. + + + + +line: 4073 + + +The VarioUltra and Pronto! use HID. + + + + +line: 4074 + + +The Refreshabraille and Orbit Reader 20 can use HID if configured appropriately. + + + + +line: 4076 + + +The USB serial mode of the Orbit Reader 20 is currently only supported in Windows 10 and later. + + + + +line: 4077 + + +USB HID should generally be used instead. + + + + +line: 4079 + + +Following are the key assignments for these displays with NVDA. + + + + +line: 4080 + + +Please see your display's documentation for descriptions of where these keys can be found. + + + + +line: 4083 +prefix: | +suffix: | + + + Name |Key + + + + +line: 4085 +prefix: | +suffix: | + + +Scroll braille display back |`d2` + + + + +line: 4086 +prefix: | +suffix: | + + +Scroll braille display forward |`d5` + + + + +line: 4087 +prefix: | +suffix: | + + +Move braille display to previous line |`d1` + + + + +line: 4088 +prefix: | +suffix: | + + +Move braille display to next line |`d3` + + + + +line: 4089 +prefix: | +suffix: | + + +Route to braille cell |`routing` + + + + +line: 4090 +prefix: | +suffix: | + + +`shift+tab` key |`space+dot1+dot3` + + + + +line: 4091 +prefix: | +suffix: | + + +`tab` key |`space+dot4+dot6` + + + + +line: 4092 +prefix: | +suffix: | + + +`alt` key |`space+dot1+dot3+dot4` (`space+m`) + + + + +line: 4093 +prefix: | +suffix: | + + +`escape` key |`space+dot1+dot5` (`space+e`) + + + + +line: 4094 +prefix: | +suffix: | + + +`windows` key |`space+dot3+dot4` + + + + +line: 4095 +prefix: | +suffix: | + + +`alt+tab` key |`space+dot2+dot3+dot4+dot5` (`space+t`) + + + + +line: 4096 +prefix: | +suffix: | + + +NVDA Menu |`space+dot1+dot3+dot4+dot5` (`space+n`) + + + + +line: 4097 +prefix: | +suffix: | + + +`windows+d` key (minimize all applications) |`space+dot1+dot4+dot5` (`space+d`) + + + + +line: 4098 +prefix: | +suffix: | + + +Say all |`space+dot1+dot2+dot3+dot4+dot5+dot6` + + + + +line: 4100 + + +For displays which have a joystick: + + + + +line: 4102 +prefix: | +suffix: | + + + Name |Key + + + + +line: 4104 +prefix: | +suffix: | + + +upArrow key |up + + + + +line: 4105 +prefix: | +suffix: | + + +downArrow key |down + + + + +line: 4106 +prefix: | +suffix: | + + +leftArrow key |left + + + + +line: 4107 +prefix: | +suffix: | + + +rightArrow key |right + + + + +line: 4108 +prefix: | +suffix: | + + +enter key |select + + + + +line: 4112 +prefix: ### +suffix: {#HedoProfiLine} + + +hedo ProfiLine USB + + + + +line: 4114 + + +The hedo ProfiLine USB from [hedo Reha-Technik](https://www.hedo.de/) is supported. + + + + +line: 4115 + + +You must first install the USB drivers provided by the manufacturer. + + + + +line: 4117 + + +This display does not yet support NVDA's automatic background braille display detection functionality. + + + + +line: 4119 + + +Following are the key assignments for this display with NVDA. + + + + +line: 4120 + + +Please see the display's documentation for descriptions of where these keys can be found. + + + + +line: 4123 +prefix: | +suffix: | + + + Name |Key + + + + +line: 4125 +prefix: | +suffix: | + + +Scroll braille display back |K1 + + + + +line: 4126 +prefix: | +suffix: | + + +Scroll braille display forward |K3 + + + + +line: 4127 +prefix: | +suffix: | + + +Move braille display to previous line |B2 + + + + +line: 4128 +prefix: | +suffix: | + + +Move braille display to next line |B5 + + + + +line: 4129 +prefix: | +suffix: | + + +Route to braille cell |routing + + + + +line: 4130 +prefix: | +suffix: | + + +Toggle braille tethered to |K2 + + + + +line: 4131 +prefix: | +suffix: | + + +Say all |B6 + + + + +line: 4135 +prefix: ### +suffix: {#HedoMobilLine} + + +hedo MobilLine USB + + + + +line: 4137 + + +The hedo MobilLine USB from [hedo Reha-Technik](https://www.hedo.de/) is supported. + + + + +line: 4138 + + +You must first install the USB drivers provided by the manufacturer. + + + + +line: 4140 + + +This display does not yet support NVDA's automatic background braille display detection functionality. + + + + +line: 4142 + + +Following are the key assignments for this display with NVDA. + + + + +line: 4143 + + +Please see the display's documentation for descriptions of where these keys can be found. + + + + +line: 4146 +prefix: | +suffix: | + + + Name |Key + + + + +line: 4148 +prefix: | +suffix: | + + +Scroll braille display back |K1 + + + + +line: 4149 +prefix: | +suffix: | + + +Scroll braille display forward |K3 + + + + +line: 4150 +prefix: | +suffix: | + + +Move braille display to previous line |B2 + + + + +line: 4151 +prefix: | +suffix: | + + +Move braille display to next line |B5 + + + + +line: 4152 +prefix: | +suffix: | + + +Route to braille cell |routing + + + + +line: 4153 +prefix: | +suffix: | + + +Toggle braille tethered to |K2 + + + + +line: 4154 +prefix: | +suffix: | + + +Say all |B6 + + + + +line: 4158 +prefix: ### +suffix: {#HumanWareBrailliant} + + +HumanWare Brailliant BI/B Series / BrailleNote Touch + + + + +line: 4160 + + +The Brailliant BI and B series of displays from [HumanWare](https://www.humanware.com/), including the BI 14, BI 32, BI 20X, BI 40, BI 40X and B 80, are supported when connected via USB or bluetooth. + + + + +line: 4161 + + +If connecting via USB with the protocol set to HumanWare, you must first install the USB drivers provided by the manufacturer. + + + + +line: 4162 + + +USB drivers are not required if the protocol is set to OpenBraille. + + + + +line: 4164 + + +The following extra devices are also supported (and do not require any special drivers to be installed): + + + + +line: 4166 +prefix: * + + +APH Mantis Q40 + + + + +line: 4167 +prefix: * + + +APH Chameleon 20 + + + + +line: 4168 +prefix: * + + +Humanware BrailleOne + + + + +line: 4169 +prefix: * + + +NLS eReader + + + + +line: 4170 +prefix: * + + +Note that the Zoomax is currently not supported without external drivers + + + + +line: 4172 + + +Following are the key assignments for the Brailliant BI/B and BrailleNote touch displays with NVDA. + + + + +line: 4173 + + +Please see the display's documentation for descriptions of where these keys can be found. + + + + +line: 4175 +prefix: #### +suffix: {#HumanWareBrailliantKeyAssignmentForAllModels} + + +Key assignments for All models + + + + +line: 4179 +prefix: | +suffix: | + + + Name |Key + + + + +line: 4181 +prefix: | +suffix: | + + +Scroll braille display back |left + + + + +line: 4182 +prefix: | +suffix: | + + +Scroll braille display forward |right + + + + +line: 4183 +prefix: | +suffix: | + + +Move braille display to previous line |up + + + + +line: 4184 +prefix: | +suffix: | + + +Move braille display to next line |down + + + + +line: 4185 +prefix: | +suffix: | + + +Route to braille cell |routing + + + + +line: 4186 +prefix: | +suffix: | + + +Toggle braille tethered to |up+down + + + + +line: 4187 +prefix: | +suffix: | + + +upArrow key |space+dot1 + + + + +line: 4188 +prefix: | +suffix: | + + +downArrow key |space+dot4 + + + + +line: 4189 +prefix: | +suffix: | + + +leftArrow key |space+dot3 + + + + +line: 4190 +prefix: | +suffix: | + + +rightArrow key |space+dot6 + + + + +line: 4191 +prefix: | +suffix: | + + +shift+tab key |space+dot1+dot3 + + + + +line: 4192 +prefix: | +suffix: | + + +tab key |space+dot4+dot6 + + + + +line: 4193 +prefix: | +suffix: | + + +alt key |space+dot1+dot3+dot4 (space+m) + + + + +line: 4194 +prefix: | +suffix: | + + +escape key |space+dot1+dot5 (space+e) + + + + +line: 4195 +prefix: | +suffix: | + + +enter key |dot8 + + + + +line: 4196 +prefix: | +suffix: | + + +windows key |space+dot3+dot4 + + + + +line: 4197 +prefix: | +suffix: | + + +alt+tab key |space+dot2+dot3+dot4+dot5 (space+t) + + + + +line: 4198 +prefix: | +suffix: | + + +NVDA Menu |space+dot1+dot3+dot4+dot5 (space+n) + + + + +line: 4199 +prefix: | +suffix: | + + +windows+d key (minimize all applications) |space+dot1+dot4+dot5 (space+d) + + + + +line: 4200 +prefix: | +suffix: | + + +Say all |space+dot1+dot2+dot3+dot4+dot5+dot6 + + + + +line: 4204 +prefix: #### +suffix: {#HumanWareBrailliantKeyAssignmentForBI32BI40AndB80} + + +Key assignments for Brailliant BI 32, BI 40 and B 80 + + + + +line: 4208 +prefix: | +suffix: | + + + Name |Key + + + + +line: 4210 +prefix: | +suffix: | + + +NVDA Menu |c1+c3+c4+c5 (command n) + + + + +line: 4211 +prefix: | +suffix: | + + +windows+d key (minimize all applications) |c1+c4+c5 (command d) + + + + +line: 4212 +prefix: | +suffix: | + + +Say all |c1+c2+c3+c4+c5+c6 + + + + +line: 4216 +prefix: #### +suffix: {#HumanWareBrailliantKeyAssignmentForBI14} + + +Key assignments for Brailliant BI 14 + + + + +line: 4220 +prefix: | +suffix: | + + + Name |Key + + + + +line: 4222 +prefix: | +suffix: | + + +up arrow key |joystick up + + + + +line: 4223 +prefix: | +suffix: | + + +down arrow key |joystick down + + + + +line: 4224 +prefix: | +suffix: | + + +left arrow key |joystick left + + + + +line: 4225 +prefix: | +suffix: | + + +right arrow key |joystick right + + + + +line: 4226 +prefix: | +suffix: | + + +enter key |joystick action + + + + +line: 4230 +prefix: ### +suffix: {#Hims} + + +HIMS Braille Sense/Braille EDGE/Smart Beetle/Sync Braille Series + + + + +line: 4232 + + +NVDA supports Braille Sense, Braille EDGE, Smart Beetle and Sync Braille displays from [Hims](https://www.hims-inc.com/) when connected via USB or bluetooth. + + + + +line: 4233 + + +If connecting via USB, you will need to install the [USB drivers from HIMS](http://www.himsintl.com/upload/HIMS_USB_Driver_v25.zip) on your system. + + + + +line: 4235 + + +Following are the key assignments for these displays with NVDA. + + + + +line: 4236 + + +Please see the display's documentation for descriptions of where these keys can be found. + + + + +line: 4239 +prefix: | +suffix: | + + + Name |Key + + + + +line: 4241 +prefix: | +suffix: | + + +Route to braille cell |routing + + + + +line: 4242 +prefix: | +suffix: | + + +Scroll braille display back |leftSideScrollUp, rightSideScrollUp, leftSideScroll + + + + +line: 4243 +prefix: | +suffix: | + + +Scroll braille display forward |leftSideScrollDown, rightSideScrollDown, rightSideScroll + + + + +line: 4244 +prefix: | +suffix: | + + +Move braille display to previous line |leftSideScrollUp+rightSideScrollUp + + + + +line: 4245 +prefix: | +suffix: | + + +Move braille display to next line |leftSideScrollDown+rightSideScrollDown + + + + +line: 4246 +prefix: | +suffix: | + + +Move to previous line in review |rightSideUpArrow + + + + +line: 4247 +prefix: | +suffix: | + + +Move to next line in review |rightSideDownArrow + + + + +line: 4248 +prefix: | +suffix: | + + +Move to previous character in review |rightSideLeftArrow + + + + +line: 4249 +prefix: | +suffix: | + + +Move to next character in review |rightSideRightArrow + + + + +line: 4250 +prefix: | +suffix: | + + +Move to current focus |leftSideScrollUp+leftSideScrollDown, rightSideScrollUp+rightSideScrollDown, leftSideScroll+rightSideScroll + + + + +line: 4251 +prefix: | +suffix: | + + +control key |smartbeetle:f1, brailleedge:f3 + + + + +line: 4252 +prefix: | +suffix: | + + +windows key |f7, smartbeetle:f2 + + + + +line: 4253 +prefix: | +suffix: | + + +alt key |dot1+dot3+dot4+space, f2, smartbeetle:f3, brailleedge:f4 + + + + +line: 4254 +prefix: | +suffix: | + + +shift key |f5 + + + + +line: 4255 +prefix: | +suffix: | + + +insert key |dot2+dot4+space, f6 + + + + +line: 4256 +prefix: | +suffix: | + + +applications key |dot1+dot2+dot3+dot4+space, f8 + + + + +line: 4257 +prefix: | +suffix: | + + +Caps Lock key |dot1+dot3+dot6+space + + + + +line: 4258 +prefix: | +suffix: | + + +tab key |dot4+dot5+space, f3, brailleedge:f2 + + + + +line: 4259 +prefix: | +suffix: | + + +shift+alt+tab key |f2+f3+f1 + + + + +line: 4260 +prefix: | +suffix: | + + +alt+tab key |f2+f3 + + + + +line: 4261 +prefix: | +suffix: | + + +shift+tab key |dot1+dot2+space + + + + +line: 4262 +prefix: | +suffix: | + + +end key |dot4+dot6+space + + + + +line: 4263 +prefix: | +suffix: | + + +control+end key |dot4+dot5+dot6+space + + + + +line: 4264 +prefix: | +suffix: | + + +home key |dot1+dot3+space, smartbeetle:f4 + + + + +line: 4265 +prefix: | +suffix: | + + +control+home key |dot1+dot2+dot3+space + + + + +line: 4266 +prefix: | +suffix: | + + +alt+f4 key |dot1+dot3+dot5+dot6+space + + + + +line: 4267 +prefix: | +suffix: | + + +leftArrow key |dot3+space, leftSideLeftArrow + + + + +line: 4268 +prefix: | +suffix: | + + +control+shift+leftArrow key |dot2+dot8+space+f1 + + + + +line: 4269 +prefix: | +suffix: | + + +control+leftArrow key |dot2+space + + + + +line: 4270 +prefix: | +suffix: | + + +shift+alt+leftArrow key |dot2+dot7+f1 + + + + +line: 4271 +prefix: | +suffix: | + + +`alt+leftArrow` |`dot2+dot7+space` + + + + +line: 4272 +prefix: | +suffix: | + + +rightArrow key |dot6+space, leftSideRightArrow + + + + +line: 4273 +prefix: | +suffix: | + + +control+shift+rightArrow key |dot5+dot8+space+f1 + + + + +line: 4274 +prefix: | +suffix: | + + +control+rightArrow key |dot5+space + + + + +line: 4275 +prefix: | +suffix: | + + +shift+alt+rightArrow key |dot5+dot7+f1 + + + + +line: 4276 +prefix: | +suffix: | + + +`alt+rightArrow` |`dot5+dot7+space` + + + + +line: 4277 +prefix: | +suffix: | + + +pageUp key |dot1+dot2+dot6+space + + + + +line: 4278 +prefix: | +suffix: | + + +control+pageUp key |dot1+dot2+dot6+dot8+space + + + + +line: 4279 +prefix: | +suffix: | + + +upArrow key |dot1+space, leftSideUpArrow + + + + +line: 4280 +prefix: | +suffix: | + + +control+shift+upArrow key |dot2+dot3+dot8+space+f1 + + + + +line: 4281 +prefix: | +suffix: | + + +control+upArrow key |dot2+dot3+space + + + + +line: 4282 +prefix: | +suffix: | + + +shift+alt+upArrow key |dot2+dot3+dot7+f1 + + + + +line: 4283 +prefix: | +suffix: | + + +`alt+upArrow` |`dot2+dot3+dot7+space` + + + + +line: 4284 +prefix: | +suffix: | + + +shift+upArrow key |leftSideScrollDown+space + + + + +line: 4285 +prefix: | +suffix: | + + +pageDown key |dot3+dot4+dot5+space + + + + +line: 4286 +prefix: | +suffix: | + + +control+pageDown key |dot3+dot4+dot5+dot8+space + + + + +line: 4287 +prefix: | +suffix: | + + +downArrow key |dot4+space, leftSideDownArrow + + + + +line: 4288 +prefix: | +suffix: | + + +control+shift+downArrow key |dot5+dot6+dot8+space+f1 + + + + +line: 4289 +prefix: | +suffix: | + + +control+downArrow key |dot5+dot6+space + + + + +line: 4290 +prefix: | +suffix: | + + +shift+alt+downArrow key |dot5+dot6+dot7+f1 + + + + +line: 4291 +prefix: | +suffix: | + + +`alt+downArrow` |`dot5+dot6+dot7+space` + + + + +line: 4292 +prefix: | +suffix: | + + +shift+downArrow key |space+rightSideScrollDown + + + + +line: 4293 +prefix: | +suffix: | + + +escape key |dot1+dot5+space, f4, brailleedge:f1 + + + + +line: 4294 +prefix: | +suffix: | + + +delete key |dot1+dot3+dot5+space, dot1+dot4+dot5+space + + + + +line: 4295 +prefix: | +suffix: | + + +f1 key |dot1+dot2+dot5+space + + + + +line: 4296 +prefix: | +suffix: | + + +f3 key |dot1+dot4+dot8+space + + + + +line: 4297 +prefix: | +suffix: | + + +f4 key |dot7+f3 + + + + +line: 4298 +prefix: | +suffix: | + + +windows+b key |dot1+dot2+f1 + + + + +line: 4299 +prefix: | +suffix: | + + +windows+d key |dot1+dot4+dot5+f1 + + + + +line: 4300 +prefix: | +suffix: | + + +control+insert key |smartbeetle:f1+rightSideScroll + + + + +line: 4301 +prefix: | +suffix: | + + +alt+insert key |smartbeetle:f3+rightSideScroll + + + + +line: 4305 +prefix: ### +suffix: {#Seika} + + +Seika Braille Displays + + + + +line: 4307 + + +The following Seika Braille displays from Nippon Telesoft are supported in two groups with different functionality: + + + + +line: 4309 +prefix: * + + +[Seika Version 3, 4, and 5 (40 cells), Seika80 (80 cells)](#SeikaBrailleDisplays) + + + + +line: 4310 +prefix: * + + +[MiniSeika (16, 24 cells), V6, and V6Pro (40 cells)](#SeikaNotetaker) + + + + +line: 4312 + + +You can find more information about the displays on their [Demo and Driver Download page](https://en.seika-braille.com/down/index.html). + + + + +line: 4314 +prefix: #### +suffix: {#SeikaBrailleDisplays} + + +Seika Version 3, 4, and 5 (40 cells), Seika80 (80 cells) + + + + +line: 4316 +prefix: * + + +These displays do not yet support NVDA's automatic background braille display detection functionality. + + + + +line: 4317 +prefix: * + + +Select "Seika Braille Displays" to manually configure + + + + +line: 4318 +prefix: * + + +A device drivers must be installed before using Seika v3/4/5/80. + + + + +line: 4319 + + +The drivers are [provided by the manufacturer](https://en.seika-braille.com/down/index.html). + + + + +line: 4321 + + +The Seika Braille Display key assignments follow. + + + + +line: 4322 + + +Please see the display's documentation for descriptions of where these keys can be found. + + + + +line: 4325 +prefix: | +suffix: | + + + Name |Key + + + + +line: 4327 +prefix: | +suffix: | + + +Scroll braille display back |left + + + + +line: 4328 +prefix: | +suffix: | + + +Scroll braille display forward |right + + + + +line: 4329 +prefix: | +suffix: | + + +Move braille display to previous line |b3 + + + + +line: 4330 +prefix: | +suffix: | + + +Move braille display to next line |b4 + + + + +line: 4331 +prefix: | +suffix: | + + +Toggle braille tethered to |b5 + + + + +line: 4332 +prefix: | +suffix: | + + +Say all |b6 + + + + +line: 4333 +prefix: | +suffix: | + + +tab |b1 + + + + +line: 4334 +prefix: | +suffix: | + + +shift+tab |b2 + + + + +line: 4335 +prefix: | +suffix: | + + +alt+tab |b1+b2 + + + + +line: 4336 +prefix: | +suffix: | + + +NVDA Menu |left+right + + + + +line: 4337 +prefix: | +suffix: | + + +Route to braille cell |routing + + + + +line: 4341 +prefix: #### +suffix: {#SeikaNotetaker} + + +MiniSeika (16, 24 cells), V6, and V6Pro (40 cells) + + + + +line: 4343 +prefix: * + + +NVDA's automatic background braille display detection functionality is supported via USB and Bluetooth. + + + + +line: 4344 +prefix: * + + +Select "Seika Notetaker" or "auto" to configure. + + + + +line: 4345 +prefix: * + + +No extra drivers are required when using a Seika Notetaker braille display. + + + + +line: 4347 + + +The Seika Notetaker key assignments follow. + + + + +line: 4348 + + +Please see the display's documentation for descriptions of where these keys can be found. + + + + +line: 4351 +prefix: | +suffix: | + + + Name |Key + + + + +line: 4353 +prefix: | +suffix: | + + +Scroll braille display back |left + + + + +line: 4354 +prefix: | +suffix: | + + +Scroll braille display forward |right + + + + +line: 4355 +prefix: | +suffix: | + + +Say all |space+Backspace + + + + +line: 4356 +prefix: | +suffix: | + + +NVDA Menu |Left+Right + + + + +line: 4357 +prefix: | +suffix: | + + +Move braille display to previous line |LJ up + + + + +line: 4358 +prefix: | +suffix: | + + +Move braille display to next line |LJ down + + + + +line: 4359 +prefix: | +suffix: | + + +Toggle braille tethered to |LJ center + + + + +line: 4360 +prefix: | +suffix: | + + +tab |LJ right + + + + +line: 4361 +prefix: | +suffix: | + + +shift+tab |LJ left + + + + +line: 4362 +prefix: | +suffix: | + + +upArrow key |RJ up + + + + +line: 4363 +prefix: | +suffix: | + + +downArrow key |RJ down + + + + +line: 4364 +prefix: | +suffix: | + + +leftArrow key |RJ left + + + + +line: 4365 +prefix: | +suffix: | + + +rightArrow key |RJ right + + + + +line: 4366 +prefix: | +suffix: | + + +Route to braille cell |routing + + + + +line: 4367 +prefix: | +suffix: | + + +shift+upArrow key |Space+RJ up, Backspace+RJ up + + + + +line: 4368 +prefix: | +suffix: | + + +shift+downArrow key |Space+RJ down, Backspace+RJ down + + + + +line: 4369 +prefix: | +suffix: | + + +shift+leftArrow key |Space+RJ left, Backspace+RJ left + + + + +line: 4370 +prefix: | +suffix: | + + +shift+rightArrow key |Space+RJ right, Backspace+RJ right + + + + +line: 4371 +prefix: | +suffix: | + + +enter key |RJ center, dot8 + + + + +line: 4372 +prefix: | +suffix: | + + +escape key |Space+RJ center + + + + +line: 4373 +prefix: | +suffix: | + + +windows key |Backspace+RJ center + + + + +line: 4374 +prefix: | +suffix: | + + +space key |Space, Backspace + + + + +line: 4375 +prefix: | +suffix: | + + +backspace key |dot7 + + + + +line: 4376 +prefix: | +suffix: | + + +pageup key |space+LJ right + + + + +line: 4377 +prefix: | +suffix: | + + +pagedown key |space+LJ left + + + + +line: 4378 +prefix: | +suffix: | + + +home key |space+LJ up + + + + +line: 4379 +prefix: | +suffix: | + + +end key |space+LJ down + + + + +line: 4380 +prefix: | +suffix: | + + +control+home key |backspace+LJ up + + + + +line: 4381 +prefix: | +suffix: | + + +control+end key |backspace+LJ down + + + + +line: 4383 +prefix: ### +suffix: {#Papenmeier} + + +Papenmeier BRAILLEX Newer Models + + + + +line: 4385 + + +The following Braille displays are supported: + + + + +line: 4387 +prefix: * + + +BRAILLEX EL 40c, EL 80c, EL 20c, EL 60c (USB) + + + + +line: 4388 +prefix: * + + +BRAILLEX EL 40s, EL 80s, EL 2d80s, EL 70s, EL 66s (USB) + + + + +line: 4389 +prefix: * + + +BRAILLEX Trio (USB and bluetooth) + + + + +line: 4390 +prefix: * + + +BRAILLEX Live 20, BRAILLEX Live and BRAILLEX Live Plus (USB and bluetooth) + + + + +line: 4392 + + +These displays do not support NVDA's automatic background braille display detection functionality. + + + + +line: 4393 + + +There is an option in the display's USB driver which can cause an issue with loading the display. + + + + +line: 4394 + + +Please try the following: + + + + +line: 4396 +prefix: 1. + + +Please make sure that you have installed the [latest driver](https://www.papenmeier-rehatechnik.de/en/service/downloadcenter/software/articles/software-braille-devices.html). + + + + +line: 4397 +prefix: 1. + + +Open the Windows Device Manager. + + + + +line: 4398 +prefix: 1. + + +Scroll down the list to "USB Controllers" or "USB Devices". + + + + +line: 4399 +prefix: 1. + + +Select "Papenmeier Braillex USB Device". + + + + +line: 4400 +prefix: 1. + + +Open the properties and switch to the "Advanced" tab. + + + + +line: 4401 + + +Sometimes the "Advanced" tab doesn't appear. + + + + +line: 4402 + + +If this is the case, disconnect the braille display from the computer, exit NVDA, wait a moment and reconnect the braille display. + + + + +line: 4403 + + +Repeat this 4 to 5 times if necessary. + + + + +line: 4404 + + +If the "Advanced" tab is still not displayed, please restart the computer. + + + + +line: 4405 +prefix: 1. + + +Disable the "Load VCP" option. + + + + +line: 4407 + + +Most devices have an Easy Access Bar (EAB) that allows intuitive and fast operation. + + + + +line: 4408 + + +The EAB can be moved in four directions where generally each direction has two switches. + + + + +line: 4409 + + +The C and Live series are the only exceptions to this rule. + + + + +line: 4411 + + +The c-series and some other displays have two routing rows whereby the upper row is used to report formatting information. + + + + +line: 4412 + + +Holding one of the upper routing keys and pressing the EAB on c-series devices emulates the second switch state. + + + + +line: 4413 + + +The live series displays have one routing row only and the EAB has one step per direction. + + + + +line: 4414 + + +The second step may be emulated by pressing one of the routing keys and pressing the EAB in the corresponding direction. + + + + +line: 4415 + + +Pressing and holding the up, down, right and left keys (or EAB) causes the corresponding action to be repeated. + + + + +line: 4417 + + +Generally, the following keys are available on these braille displays: + + + + +line: 4419 +prefix: | +suffix: | + + + Name |Key + + + + +line: 4421 +prefix: | +suffix: | + + +l1 |Left front key + + + + +line: 4422 +prefix: | +suffix: | + + +l2 |Left rear key + + + + +line: 4423 +prefix: | +suffix: | + + +r1 |Right front key + + + + +line: 4424 +prefix: | +suffix: | + + +r2 |Right rear key + + + + +line: 4425 +prefix: | +suffix: | + + +up |1 Step up + + + + +line: 4426 +prefix: | +suffix: | + + +up2 |2 Steps up + + + + +line: 4427 +prefix: | +suffix: | + + +left |1 Step left + + + + +line: 4428 +prefix: | +suffix: | + + +left2 |2 Steps left + + + + +line: 4429 +prefix: | +suffix: | + + +right |1 Step right + + + + +line: 4430 +prefix: | +suffix: | + + +right2 |2 Steps right + + + + +line: 4431 +prefix: | +suffix: | + + +dn |1 Step down + + + + +line: 4432 +prefix: | +suffix: | + + +dn2 |2 Steps down + + + + +line: 4434 + + +Following are the Papenmeier command assignments for NVDA: + + + + +line: 4437 +prefix: | +suffix: | + + + Name |Key + + + + +line: 4439 +prefix: | +suffix: | + + +Scroll braille display back |left + + + + +line: 4440 +prefix: | +suffix: | + + +Scroll braille display forward |right + + + + +line: 4441 +prefix: | +suffix: | + + +Move braille display to previous line |up + + + + +line: 4442 +prefix: | +suffix: | + + +Move braille display to next line |dn + + + + +line: 4443 +prefix: | +suffix: | + + +Route to braille cell |routing + + + + +line: 4444 +prefix: | +suffix: | + + +Report current character in review |l1 + + + + +line: 4445 +prefix: | +suffix: | + + +Activate current navigator object |l2 + + + + +line: 4446 +prefix: | +suffix: | + + +Toggle braille tethered to |r2 + + + + +line: 4447 +prefix: | +suffix: | + + +Report title |l1+up + + + + +line: 4448 +prefix: | +suffix: | + + +Report Status Bar |l2+down + + + + +line: 4449 +prefix: | +suffix: | + + +Move to containing object |up2 + + + + +line: 4450 +prefix: | +suffix: | + + +Move to first contained object |dn2 + + + + +line: 4451 +prefix: | +suffix: | + + +Move to previous object |left2 + + + + +line: 4452 +prefix: | +suffix: | + + +Move to next object |right2 + + + + +line: 4453 +prefix: | +suffix: | + + +Report text formatting under braille cell |upper routing row + + + + +line: 4457 + + +The Trio model has four additional keys which are in front of the braille keyboard. + + + + +line: 4458 + + +These are (ordered from left to right): + + + + +line: 4460 +prefix: * + + +left thumb key (lt) + + + + +line: 4461 +prefix: * + + +space + + + + +line: 4462 +prefix: * + + +space + + + + +line: 4463 +prefix: * + + +right thumb key (rt) + + + + +line: 4465 + + +Currently, the right thumb key is not in use. + + + + +line: 4466 + + +The inner keys are both mapped to space. + + + + +line: 4470 +prefix: | +suffix: | + + + Name |Key + + + + +line: 4472 +prefix: | +suffix: | + + +escape key |space with dot 7 + + + + +line: 4473 +prefix: | +suffix: | + + +upArrow key |space with dot 2 + + + + +line: 4474 +prefix: | +suffix: | + + +leftArrow key |space with dot 1 + + + + +line: 4475 +prefix: | +suffix: | + + +rightArrow key |space with dot 4 + + + + +line: 4476 +prefix: | +suffix: | + + +downArrow |space with dot 5 + + + + +line: 4477 +prefix: | +suffix: | + + +control key |lt+dot2 + + + + +line: 4478 +prefix: | +suffix: | + + +alt key |lt+dot3 + + + + +line: 4479 +prefix: | +suffix: | + + +control+escape key |space with dot 1 2 3 4 5 6 + + + + +line: 4480 +prefix: | +suffix: | + + +tab key |space with dot 3 7 + + + + +line: 4484 +prefix: ### +suffix: {#PapenmeierOld} + + +Papenmeier Braille BRAILLEX Older Models + + + + +line: 4486 + + +The following Braille displays are supported: + + + + +line: 4488 +prefix: * + + +BRAILLEX EL 80, EL 2D-80, EL 40 P + + + + +line: 4489 +prefix: * + + +BRAILLEX Tiny, 2D Screen + + + + +line: 4491 + + +Note that these displays can only be connected via a serial port. + + + + +line: 4492 + + +Due to this, these displays do not support NVDA's automatic background braille display detection functionality. + + + + +line: 4493 + + +You should select the port to which the display is connected after you have chosen this driver in the [Select Braille Display](#SelectBrailleDisplay) dialog. + + + + +line: 4495 + + +Some of these devices have an Easy Access Bar (EAB) that allows intuitive and fast operation. + + + + +line: 4496 + + +The EAB can be moved in four directions where generally each direction has two switches. + + + + +line: 4497 + + +Pressing and holding the up, down, right and left keys (or EAB) causes the corresponding action to be repeated. + + + + +line: 4498 + + +Older devices do not have an EAB; front keys are used instead. + + + + +line: 4500 + + +Generally, the following keys are available on braille displays: + + + + +line: 4502 +prefix: | +suffix: | + + + Name |Key + + + + +line: 4504 +prefix: | +suffix: | + + +l1 |Left front key + + + + +line: 4505 +prefix: | +suffix: | + + +l2 |Left rear key + + + + +line: 4506 +prefix: | +suffix: | + + +r1 |Right front key + + + + +line: 4507 +prefix: | +suffix: | + + +r2 |Right rear key + + + + +line: 4508 +prefix: | +suffix: | + + +up |1 Step up + + + + +line: 4509 +prefix: | +suffix: | + + +up2 |2 Steps up + + + + +line: 4510 +prefix: | +suffix: | + + +left |1 Step left + + + + +line: 4511 +prefix: | +suffix: | + + +left2 |2 Steps left + + + + +line: 4512 +prefix: | +suffix: | + + +right |1 Step right + + + + +line: 4513 +prefix: | +suffix: | + + +right2 |2 Steps right + + + + +line: 4514 +prefix: | +suffix: | + + +dn |1 Step down + + + + +line: 4515 +prefix: | +suffix: | + + +dn2 |2 Steps down + + + + +line: 4517 + + +Following are the Papenmeier command assignments for NVDA: + + + + +line: 4520 + + +Devices with EAB: + + + + +line: 4522 +prefix: | +suffix: | + + + Name |Key + + + + +line: 4524 +prefix: | +suffix: | + + +Scroll braille display back |left + + + + +line: 4525 +prefix: | +suffix: | + + +Scroll braille display forward |right + + + + +line: 4526 +prefix: | +suffix: | + + +Move braille display to previous line |up + + + + +line: 4527 +prefix: | +suffix: | + + +Move braille display to next line |dn + + + + +line: 4528 +prefix: | +suffix: | + + +Route to braille cell |routing + + + + +line: 4529 +prefix: | +suffix: | + + +Report current character in review |l1 + + + + +line: 4530 +prefix: | +suffix: | + + +Activate current navigator object |l2 + + + + +line: 4531 +prefix: | +suffix: | + + +Report title |l1up + + + + +line: 4532 +prefix: | +suffix: | + + +Report Status Bar |l2down + + + + +line: 4533 +prefix: | +suffix: | + + +Move to containing object |up2 + + + + +line: 4534 +prefix: | +suffix: | + + +Move to first contained object |dn2 + + + + +line: 4535 +prefix: | +suffix: | + + +Move to next object |right2 + + + + +line: 4536 +prefix: | +suffix: | + + +Move to previous object |left2 + + + + +line: 4537 +prefix: | +suffix: | + + +Report text formatting under braille cell |upper routing strip + + + + +line: 4539 + + +BRAILLEX Tiny: + + + + +line: 4541 +prefix: | +suffix: | + + + Name |Key + + + + +line: 4543 +prefix: | +suffix: | + + +Report current character in review |l1 + + + + +line: 4544 +prefix: | +suffix: | + + +Activate current navigator object |l2 + + + + +line: 4545 +prefix: | +suffix: | + + +Scroll braille display back |left + + + + +line: 4546 +prefix: | +suffix: | + + +Scroll braille display forward |right + + + + +line: 4547 +prefix: | +suffix: | + + +Move braille display to previous line |up + + + + +line: 4548 +prefix: | +suffix: | + + +Move braille display to next line |dn + + + + +line: 4549 +prefix: | +suffix: | + + +Toggle braille tethered to |r2 + + + + +line: 4550 +prefix: | +suffix: | + + +Move to containing object |r1+up + + + + +line: 4551 +prefix: | +suffix: | + + +Move to first contained object |r1+dn + + + + +line: 4552 +prefix: | +suffix: | + + +Move to previous object |r1+left + + + + +line: 4553 +prefix: | +suffix: | + + +Move to next object |r1+right + + + + +line: 4554 +prefix: | +suffix: | + + +Report text formatting under braille cell |upper routing strip + + + + +line: 4555 +prefix: | +suffix: | + + +Report title |l1+up + + + + +line: 4556 +prefix: | +suffix: | + + +Report status bar |l2+down + + + + +line: 4558 + + +BRAILLEX 2D Screen: + + + + +line: 4560 +prefix: | +suffix: | + + + Name |Key + + + + +line: 4562 +prefix: | +suffix: | + + +Report current character in review |l1 + + + + +line: 4563 +prefix: | +suffix: | + + +Activate current navigator object |l2 + + + + +line: 4564 +prefix: | +suffix: | + + +Toggle braille tethered to |r2 + + + + +line: 4565 +prefix: | +suffix: | + + +Report text formatting under braille cell |upper routing strip + + + + +line: 4566 +prefix: | +suffix: | + + +Move braille display to previous line |up + + + + +line: 4567 +prefix: | +suffix: | + + +Scroll braille display back |left + + + + +line: 4568 +prefix: | +suffix: | + + +Scroll braille display forward |right + + + + +line: 4569 +prefix: | +suffix: | + + +Move braille display to next line |dn + + + + +line: 4570 +prefix: | +suffix: | + + +Move to next object |left2 + + + + +line: 4571 +prefix: | +suffix: | + + +Move to containing object |up2 + + + + +line: 4572 +prefix: | +suffix: | + + +Move to first contained object |dn2 + + + + +line: 4573 +prefix: | +suffix: | + + +Move to previous object |right2 + + + + +line: 4577 +prefix: ### +suffix: {#HumanWareBrailleNote} + + +HumanWare BrailleNote + + + + +line: 4579 + + +NVDA supports the BrailleNote notetakers from [Humanware](https://www.humanware.com) when acting as a display terminal for a screen reader. + + + + +line: 4580 + + +The following models are supported: + + + + +line: 4582 +prefix: * + + +BrailleNote Classic (serial connection only) + + + + +line: 4583 +prefix: * + + +BrailleNote PK (Serial and bluetooth connections) + + + + +line: 4584 +prefix: * + + +BrailleNote MPower (Serial and bluetooth connections) + + + + +line: 4585 +prefix: * + + +BrailleNote Apex (USB and Bluetooth connections) + + + + +line: 4587 + + +For BrailleNote Touch, please refer to the [Brailliant BI Series / BrailleNote Touch](#HumanWareBrailliant) section. + + + + +line: 4589 + + +Except for BrailleNote PK, both braille (BT) and QWERTY (QT) keyboards are supported. + + + + +line: 4590 + + +For BrailleNote QT, PC keyboard emulation isn't supported. + + + + +line: 4591 + + +You can also enter braille dots using the QT keyboard. + + + + +line: 4592 + + +Please check the braille terminal section of the BrailleNote manual guide for details. + + + + +line: 4594 + + +If your device supports more than one type of connection, when connecting your BrailleNote to NVDA, you must set the braille terminal port in braille terminal options. + + + + +line: 4595 + + +Please check the BrailleNote manual for details. + + + + +line: 4596 + + +In NVDA, you may also need to set the port in the [Select Braille Display](#SelectBrailleDisplay) dialog. + + + + +line: 4597 + + +If you are connecting via USB or bluetooth, you can set the port to "Automatic", "USB" or "Bluetooth", depending on the available choices. + + + + +line: 4598 + + +If connecting using a legacy serial port (or a USB to serial converter) or if none of the previous options appear, you must explicitly choose the communication port to be used from the list of hardware ports. + + + + +line: 4600 + + +Before connecting your BrailleNote Apex using its USB client interface, you must install the drivers provided by HumanWare. + + + + +line: 4602 + + +On the BrailleNote Apex BT, you can use the scroll wheel located between dots 1 and 4 for various NVDA commands. + + + + +line: 4603 + + +The wheel consists of four directional dots, a centre click button, and a wheel that spins clockwise or counterclockwise. + + + + +line: 4605 + + +Following are the BrailleNote command assignments for NVDA. + + + + +line: 4606 + + +Please check your BrailleNote's documentation to find where these keys are located. + + + + +line: 4610 +prefix: | +suffix: | + + + Name |Key + + + + +line: 4612 +prefix: | +suffix: | + + +Scroll braille display back |back + + + + +line: 4613 +prefix: | +suffix: | + + +Scroll braille display forward |advance + + + + +line: 4614 +prefix: | +suffix: | + + +Move braille display to previous line |previous + + + + +line: 4615 +prefix: | +suffix: | + + +Move braille display to next line |next + + + + +line: 4616 +prefix: | +suffix: | + + +Route to braille cell |routing + + + + +line: 4617 +prefix: | +suffix: | + + +NVDA menu |space+dot1+dot3+dot4+dot5 (space+n) + + + + +line: 4618 +prefix: | +suffix: | + + +Toggle braille tethered to |previous+next + + + + +line: 4619 +prefix: | +suffix: | + + +Up arrow key |space+dot1 + + + + +line: 4620 +prefix: | +suffix: | + + +Down arrow key |space+dot4 + + + + +line: 4621 +prefix: | +suffix: | + + +Left Arrow key |space+dot3 + + + + +line: 4622 +prefix: | +suffix: | + + +Right arrow key |space+dot6 + + + + +line: 4623 +prefix: | +suffix: | + + +Page up key |space+dot1+dot3 + + + + +line: 4624 +prefix: | +suffix: | + + +Page down key |space+dot4+dot6 + + + + +line: 4625 +prefix: | +suffix: | + + +Home key |space+dot1+dot2 + + + + +line: 4626 +prefix: | +suffix: | + + +End key |space+dot4+dot5 + + + + +line: 4627 +prefix: | +suffix: | + + +Control+home keys |space+dot1+dot2+dot3 + + + + +line: 4628 +prefix: | +suffix: | + + +Control+end keys |space+dot4+dot5+dot6 + + + + +line: 4629 +prefix: | +suffix: | + + +Space key |space + + + + +line: 4630 +prefix: | +suffix: | + + +Enter |space+dot8 + + + + +line: 4631 +prefix: | +suffix: | + + +Backspace |space+dot7 + + + + +line: 4632 +prefix: | +suffix: | + + +Tab key |space+dot2+dot3+dot4+dot5 (space+t) + + + + +line: 4633 +prefix: | +suffix: | + + +Shift+tab keys |space+dot1+dot2+dot5+dot6 + + + + +line: 4634 +prefix: | +suffix: | + + +Windows key |space+dot2+dot4+dot5+dot6 (space+w) + + + + +line: 4635 +prefix: | +suffix: | + + +Alt key |space+dot1+dot3+dot4 (space+m) + + + + +line: 4636 +prefix: | +suffix: | + + +Toggle input help |space+dot2+dot3+dot6 (space+lower h) + + + + +line: 4638 + + +Following are commands assigned to BrailleNote QT when it is not in braille input mode. + + + + +line: 4640 +prefix: | +suffix: | + + + Name |Key + + + + +line: 4642 +prefix: | +suffix: | + + +NVDA menu |read+n + + + + +line: 4643 +prefix: | +suffix: | + + +Up arrow key |upArrow + + + + +line: 4644 +prefix: | +suffix: | + + +Down arrow key |downArrow + + + + +line: 4645 +prefix: | +suffix: | + + +Left Arrow key |leftArrow + + + + +line: 4646 +prefix: | +suffix: | + + +Right arrow key |rightArrow + + + + +line: 4647 +prefix: | +suffix: | + + +Page up key |function+upArrow + + + + +line: 4648 +prefix: | +suffix: | + + +Page down key |function+downArrow + + + + +line: 4649 +prefix: | +suffix: | + + +Home key |function+leftArrow + + + + +line: 4650 +prefix: | +suffix: | + + +End key |function+rightArrow + + + + +line: 4651 +prefix: | +suffix: | + + +Control+home keys |read+t + + + + +line: 4652 +prefix: | +suffix: | + + +Control+end keys |read+b + + + + +line: 4653 +prefix: | +suffix: | + + +Enter key |enter + + + + +line: 4654 +prefix: | +suffix: | + + +Backspace key |backspace + + + + +line: 4655 +prefix: | +suffix: | + + +Tab key |tab + + + + +line: 4656 +prefix: | +suffix: | + + +Shift+tab keys |shift+tab + + + + +line: 4657 +prefix: | +suffix: | + + +Windows key |read+w + + + + +line: 4658 +prefix: | +suffix: | + + +Alt key |read+m + + + + +line: 4659 +prefix: | +suffix: | + + +Toggle input help |read+1 + + + + +line: 4661 + + +Following are commands assigned to the scroll wheel: + + + + +line: 4663 +prefix: | +suffix: | + + + Name |Key + + + + +line: 4665 +prefix: | +suffix: | + + +Up arrow key |upArrow + + + + +line: 4666 +prefix: | +suffix: | + + +Down arrow key |downArrow + + + + +line: 4667 +prefix: | +suffix: | + + +Left Arrow key |leftArrow + + + + +line: 4668 +prefix: | +suffix: | + + +Right arrow key |rightArrow + + + + +line: 4669 +prefix: | +suffix: | + + +Enter key |centre button + + + + +line: 4670 +prefix: | +suffix: | + + +Tab key |scroll wheel clockwise + + + + +line: 4671 +prefix: | +suffix: | + + +Shift+tab keys |scroll wheel counterclockwise + + + + +line: 4675 +prefix: ### +suffix: {#EcoBraille} + + +EcoBraille + + + + +line: 4677 + + +NVDA supports EcoBraille displays from [ONCE](https://www.once.es/). + + + + +line: 4678 + + +The following models are supported: + + + + +line: 4680 +prefix: * + + +EcoBraille 20 + + + + +line: 4681 +prefix: * + + +EcoBraille 40 + + + + +line: 4682 +prefix: * + + +EcoBraille 80 + + + + +line: 4683 +prefix: * + + +EcoBraille Plus + + + + +line: 4685 + + +In NVDA, you can set the serial port to which the display is connected in the [Select Braille Display](#SelectBrailleDisplay) dialog. + + + + +line: 4686 + + +These displays do not support NVDA's automatic background braille display detection functionality. + + + + +line: 4688 + + +Following are the key assignments for EcoBraille displays. + + + + +line: 4689 + + +Please see the [EcoBraille documentation](ftp://ftp.once.es/pub/utt/bibliotecnia/Lineas_Braille/ECO/) for descriptions of where these keys can be found. + + + + +line: 4693 +prefix: | +suffix: | + + + Name |Key + + + + +line: 4695 +prefix: | +suffix: | + + +Scroll braille display back |T2 + + + + +line: 4696 +prefix: | +suffix: | + + +Scroll braille display forward |T4 + + + + +line: 4697 +prefix: | +suffix: | + + +Move braille display to previous line |T1 + + + + +line: 4698 +prefix: | +suffix: | + + +Move braille display to next line |T5 + + + + +line: 4699 +prefix: | +suffix: | + + +Route to braille cell |Routing + + + + +line: 4700 +prefix: | +suffix: | + + +Activate current navigator object |T3 + + + + +line: 4701 +prefix: | +suffix: | + + +Switch to next review mode |F1 + + + + +line: 4702 +prefix: | +suffix: | + + +Move to containing object |F2 + + + + +line: 4703 +prefix: | +suffix: | + + +Switch to previous review mode |F3 + + + + +line: 4704 +prefix: | +suffix: | + + +Move to previous object |F4 + + + + +line: 4705 +prefix: | +suffix: | + + +Report current object |F5 + + + + +line: 4706 +prefix: | +suffix: | + + +Move to next object |F6 + + + + +line: 4707 +prefix: | +suffix: | + + +Move to focus object |F7 + + + + +line: 4708 +prefix: | +suffix: | + + +Move to first contained object |F8 + + + + +line: 4709 +prefix: | +suffix: | + + +Move System focus or caret to current review position |F9 + + + + +line: 4710 +prefix: | +suffix: | + + +Report review cursor location |F0 + + + + +line: 4711 +prefix: | +suffix: | + + +Toggle braille tethered to |A + + + + +line: 4715 +prefix: ### +suffix: {#SuperBraille} + + +SuperBraille + + + + +line: 4717 + + +The SuperBraille device, mostly available in Taiwan, can be connected to by either USB or serial. + + + + +line: 4718 + + +As the SuperBraille does not have any physical typing keys or scrolling buttons, all input must be performed via a standard computer keyboard. + + + + +line: 4719 + + +Due to this, and to maintain compatibility with other screen readers in Taiwan, two key bindings for scrolling the braille display have been provided: + + + + +line: 4722 +prefix: | +suffix: | + + + Name |Key + + + + +line: 4724 +prefix: | +suffix: | + + +Scroll braille display back |numpadMinus + + + + +line: 4725 +prefix: | +suffix: | + + +Scroll braille display forward |numpadPlus + + + + +line: 4729 +prefix: ### +suffix: {#Eurobraille} + + +Eurobraille displays + + + + +line: 4731 + + +The b.book, b.note, Esys, Esytime and Iris displays from Eurobraille are supported by NVDA. + + + + +line: 4732 + + +These devices have a braille keyboard with 10 keys. + + + + +line: 4733 + + +Please refer to the display's documentation for descriptions of these keys. + + + + +line: 4734 + + +Of the two keys placed like a space bar, the left key is corresponding to the backspace key and the right key to the space key. + + + + +line: 4736 + + +These devices are connected via USB and have one stand-alone USB keyboard. + + + + +line: 4737 + + +It is possible to enable/disable this keyboard by toggling "HID Keyboard simulation" using an input gesture. + + + + +line: 4738 + + +The braille keyboard functions described directly below is when "HID Keyboard simulation" is disabled. + + + + +line: 4740 +prefix: #### +suffix: {#EurobrailleBraille} + + +Braille keyboard functions + + + + +line: 4744 +prefix: | +suffix: | + + + Name |Key + + + + +line: 4746 +prefix: | +suffix: | + + +Erase the last entered braille cell or character |`backspace` + + + + +line: 4747 +prefix: | +suffix: | + + +Translate any braille input and press the enter key |`backspace+space` + + + + +line: 4748 +prefix: | +suffix: | + + +Toggle `NVDA` key |`dot3+dot5+space` + + + + +line: 4749 +prefix: | +suffix: | + + +`insert` key |`dot1+dot3+dot5+space`, `dot3+dot4+dot5+space` + + + + +line: 4750 +prefix: | +suffix: | + + +`delete` key |`dot3+dot6+space` + + + + +line: 4751 +prefix: | +suffix: | + + +`home` key |`dot1+dot2+dot3+space` + + + + +line: 4752 +prefix: | +suffix: | + + +`end` key |`dot4+dot5+dot6+space` + + + + +line: 4753 +prefix: | +suffix: | + + +`leftArrow` key |`dot2+space` + + + + +line: 4754 +prefix: | +suffix: | + + +`rightArrow` key |`dot5+space` + + + + +line: 4755 +prefix: | +suffix: | + + +`upArrow` key |`dot1+space` + + + + +line: 4756 +prefix: | +suffix: | + + +`downArrow` key |`dot6+space` + + + + +line: 4757 +prefix: | +suffix: | + + +`pageUp` key |`dot1+dot3+space` + + + + +line: 4758 +prefix: | +suffix: | + + +`pageDown` key |`dot4+dot6+space` + + + + +line: 4759 +prefix: | +suffix: | + + +`numpad1` key |`dot1+dot6+backspace` + + + + +line: 4760 +prefix: | +suffix: | + + +`numpad2` key |`dot1+dot2+dot6+backspace` + + + + +line: 4761 +prefix: | +suffix: | + + +`numpad3` key |`dot1+dot4+dot6+backspace` + + + + +line: 4762 +prefix: | +suffix: | + + +`numpad4` key |`dot1+dot4+dot5+dot6+backspace` + + + + +line: 4763 +prefix: | +suffix: | + + +`numpad5` key |`dot1+dot5+dot6+backspace` + + + + +line: 4764 +prefix: | +suffix: | + + +`numpad6` key |`dot1+dot2+dot4+dot6+backspace` + + + + +line: 4765 +prefix: | +suffix: | + + +`numpad7` key |`dot1+dot2+dot4+dot5+dot6+backspace` + + + + +line: 4766 +prefix: | +suffix: | + + +`numpad8` key |`dot1+dot2+dot5+dot6+backspace` + + + + +line: 4767 +prefix: | +suffix: | + + +`numpad9` key |`dot2+dot4+dot6+backspace` + + + + +line: 4768 +prefix: | +suffix: | + + +`numpadInsert` key |`dot3+dot4+dot5+dot6+backspace` + + + + +line: 4769 +prefix: | +suffix: | + + +`numpadDecimal` key |`dot2+backspace` + + + + +line: 4770 +prefix: | +suffix: | + + +`numpadDivide` key |`dot3+dot4+backspace` + + + + +line: 4771 +prefix: | +suffix: | + + +`numpadMultiply` key |`dot3+dot5+backspace` + + + + +line: 4772 +prefix: | +suffix: | + + +`numpadMinus` key |`dot3+dot6+backspace` + + + + +line: 4773 +prefix: | +suffix: | + + +`numpadPlus` key |`dot2+dot3+dot5+backspace` + + + + +line: 4774 +prefix: | +suffix: | + + +`numpadEnter` key |`dot3+dot4+dot5+backspace` + + + + +line: 4775 +prefix: | +suffix: | + + +`escape` key |`dot1+dot2+dot4+dot5+space`, `l2` + + + + +line: 4776 +prefix: | +suffix: | + + +`tab` key |`dot2+dot5+dot6+space`, `l3` + + + + +line: 4777 +prefix: | +suffix: | + + +`shift+tab` keys |`dot2+dot3+dot5+space` + + + + +line: 4778 +prefix: | +suffix: | + + +`printScreen` key |`dot1+dot3+dot4+dot6+space` + + + + +line: 4779 +prefix: | +suffix: | + + +`pause` key |`dot1+dot4+space` + + + + +line: 4780 +prefix: | +suffix: | + + +`applications` key |`dot5+dot6+backspace` + + + + +line: 4781 +prefix: | +suffix: | + + +`f1` key |`dot1+backspace` + + + + +line: 4782 +prefix: | +suffix: | + + +`f2` key |`dot1+dot2+backspace` + + + + +line: 4783 +prefix: | +suffix: | + + +`f3` key |`dot1+dot4+backspace` + + + + +line: 4784 +prefix: | +suffix: | + + +`f4` key |`dot1+dot4+dot5+backspace` + + + + +line: 4785 +prefix: | +suffix: | + + +`f5` key |`dot1+dot5+backspace` + + + + +line: 4786 +prefix: | +suffix: | + + +`f6` key |`dot1+dot2+dot4+backspace` + + + + +line: 4787 +prefix: | +suffix: | + + +`f7` key |`dot1+dot2+dot4+dot5+backspace` + + + + +line: 4788 +prefix: | +suffix: | + + +`f8` key |`dot1+dot2+dot5+backspace` + + + + +line: 4789 +prefix: | +suffix: | + + +`f9` key |`dot2+dot4+backspace` + + + + +line: 4790 +prefix: | +suffix: | + + +`f10` key |`dot2+dot4+dot5+backspace` + + + + +line: 4791 +prefix: | +suffix: | + + +`f11` key |`dot1+dot3+backspace` + + + + +line: 4792 +prefix: | +suffix: | + + +`f12` key |`dot1+dot2+dot3+backspace` + + + + +line: 4793 +prefix: | +suffix: | + + +`windows` key |`dot1+dot2+dot4+dot5+dot6+space` + + + + +line: 4794 +prefix: | +suffix: | + + +Toggle `windows` key |`dot1+dot2+dot3+dot4+backspace`, `dot2+dot4+dot5+dot6+space` + + + + +line: 4795 +prefix: | +suffix: | + + +`capsLock` key |`dot7+backspace`, `dot8+backspace` + + + + +line: 4796 +prefix: | +suffix: | + + +`numLock` key |`dot3+backspace`, `dot6+backspace` + + + + +line: 4797 +prefix: | +suffix: | + + +`shift` key |`dot7+space` + + + + +line: 4798 +prefix: | +suffix: | + + +Toggle `shift` key |`dot1+dot7+space`, `dot4+dot7+space` + + + + +line: 4799 +prefix: | +suffix: | + + +`control` key |`dot7+dot8+space` + + + + +line: 4800 +prefix: | +suffix: | + + +Toggle `control` key |`dot1+dot7+dot8+space`, `dot4+dot7+dot8+space` + + + + +line: 4801 +prefix: | +suffix: | + + +`alt` key |`dot8+space` + + + + +line: 4802 +prefix: | +suffix: | + + +Toggle `alt` key |`dot1+dot8+space`, `dot4+dot8+space` + + + + +line: 4803 +prefix: | +suffix: | + + +Toggle HID Keyboard simulation |`switch1Left+joystick1Down`, `switch1Right+joystick1Down` + + + + +line: 4807 +prefix: #### +suffix: {#Eurobraillebbook} + + +b.book keyboard commands + + + + +line: 4811 +prefix: | +suffix: | + + + Name |Key + + + + +line: 4813 +prefix: | +suffix: | + + +Scroll braille display back |`backward` + + + + +line: 4814 +prefix: | +suffix: | + + +Scroll braille display forward |`forward` + + + + +line: 4815 +prefix: | +suffix: | + + +Move to current focus |`backward+forward` + + + + +line: 4816 +prefix: | +suffix: | + + +Route to braille cell |`routing` + + + + +line: 4817 +prefix: | +suffix: | + + +`leftArrow` key |`joystick2Left` + + + + +line: 4818 +prefix: | +suffix: | + + +`rightArrow` key |`joystick2Right` + + + + +line: 4819 +prefix: | +suffix: | + + +`upArrow` key |`joystick2Up` + + + + +line: 4820 +prefix: | +suffix: | + + +`downArrow` key |`joystick2Down` + + + + +line: 4821 +prefix: | +suffix: | + + +`enter` key |`joystick2Center` + + + + +line: 4822 +prefix: | +suffix: | + + +`escape` key |`c1` + + + + +line: 4823 +prefix: | +suffix: | + + +`tab` key |`c2` + + + + +line: 4824 +prefix: | +suffix: | + + +Toggle `shift` key |`c3` + + + + +line: 4825 +prefix: | +suffix: | + + +Toggle `control` key |`c4` + + + + +line: 4826 +prefix: | +suffix: | + + +Toggle `alt` key |`c5` + + + + +line: 4827 +prefix: | +suffix: | + + +Toggle `NVDA` key |`c6` + + + + +line: 4828 +prefix: | +suffix: | + + +`control+Home` key |`c1+c2+c3` + + + + +line: 4829 +prefix: | +suffix: | + + +`control+End` key |`c4+c5+c6` + + + + +line: 4833 +prefix: #### +suffix: {#Eurobraillebnote} + + +b.note keyboard commands + + + + +line: 4837 +prefix: | +suffix: | + + + Name |Key + + + + +line: 4839 +prefix: | +suffix: | + + +Scroll braille display back |`leftKeypadLeft` + + + + +line: 4840 +prefix: | +suffix: | + + +Scroll braille display forward |`leftKeypadRight` + + + + +line: 4841 +prefix: | +suffix: | + + +Route to braille cell |`routing` + + + + +line: 4842 +prefix: | +suffix: | + + +Report text formatting under braille cell |`doubleRouting` + + + + +line: 4843 +prefix: | +suffix: | + + +Move to next line in review |`leftKeypadDown` + + + + +line: 4844 +prefix: | +suffix: | + + +Switch to previous review mode |`leftKeypadLeft+leftKeypadUp` + + + + +line: 4845 +prefix: | +suffix: | + + +Switch to next review mode |`leftKeypadRight+leftKeypadDown` + + + + +line: 4846 +prefix: | +suffix: | + + +`leftArrow` key |`rightKeypadLeft` + + + + +line: 4847 +prefix: | +suffix: | + + +`rightArrow` key |`rightKeypadRight` + + + + +line: 4848 +prefix: | +suffix: | + + +`upArrow` key |`rightKeypadUp` + + + + +line: 4849 +prefix: | +suffix: | + + +`downArrow` key |`rightKeypadDown` + + + + +line: 4850 +prefix: | +suffix: | + + +`control+home` key |`rightKeypadLeft+rightKeypadUp` + + + + +line: 4851 +prefix: | +suffix: | + + +`control+end` key |`rightKeypadLeft+rightKeypadUp` + + + + +line: 4855 +prefix: #### +suffix: {#Eurobrailleesys} + + +Esys keyboard commands + + + + +line: 4859 +prefix: | +suffix: | + + + Name |Key + + + + +line: 4861 +prefix: | +suffix: | + + +Scroll braille display back |`switch1Left` + + + + +line: 4862 +prefix: | +suffix: | + + +Scroll braille display forward |`switch1Right` + + + + +line: 4863 +prefix: | +suffix: | + + +Move to current focus |`switch1Center` + + + + +line: 4864 +prefix: | +suffix: | + + +Route to braille cell |`routing` + + + + +line: 4865 +prefix: | +suffix: | + + +Report text formatting under braille cell |`doubleRouting` + + + + +line: 4866 +prefix: | +suffix: | + + +Move to previous line in review |`joystick1Up` + + + + +line: 4867 +prefix: | +suffix: | + + +Move to next line in review |`joystick1Down` + + + + +line: 4868 +prefix: | +suffix: | + + +Move to previous character in review |`joystick1Left` + + + + +line: 4869 +prefix: | +suffix: | + + +Move to next character in review |`joystick1Right` + + + + +line: 4870 +prefix: | +suffix: | + + +`leftArrow` key |`joystick2Left` + + + + +line: 4871 +prefix: | +suffix: | + + +`rightArrow` key |`joystick2Right` + + + + +line: 4872 +prefix: | +suffix: | + + +`upArrow` key |`joystick2Up` + + + + +line: 4873 +prefix: | +suffix: | + + +`downArrow` key |`joystick2Down` + + + + +line: 4874 +prefix: | +suffix: | + + +`enter` key |`joystick2Center` + + + + +line: 4878 +prefix: #### +suffix: {#EurobrailleEsytime} + + +Esytime keyboard commands + + + + +line: 4882 +prefix: | +suffix: | + + + Name |Key + + + + +line: 4884 +prefix: | +suffix: | + + +Scroll braille display back |`l1` + + + + +line: 4885 +prefix: | +suffix: | + + +Scroll braille display forward |`l8` + + + + +line: 4886 +prefix: | +suffix: | + + +Move to current focus |`l1+l8` + + + + +line: 4887 +prefix: | +suffix: | + + +Route to braille cell |`routing` + + + + +line: 4888 +prefix: | +suffix: | + + +Report text formatting under braille cell |`doubleRouting` + + + + +line: 4889 +prefix: | +suffix: | + + +Move to previous line in review |`joystick1Up` + + + + +line: 4890 +prefix: | +suffix: | + + +Move to next line in review |`joystick1Down` + + + + +line: 4891 +prefix: | +suffix: | + + +Move to previous character in review |`joystick1Left` + + + + +line: 4892 +prefix: | +suffix: | + + +Move to next character in review |`joystick1Right` + + + + +line: 4893 +prefix: | +suffix: | + + +`leftArrow` key |`joystick2Left` + + + + +line: 4894 +prefix: | +suffix: | + + +`rightArrow` key |`joystick2Right` + + + + +line: 4895 +prefix: | +suffix: | + + +`upArrow` key |`joystick2Up` + + + + +line: 4896 +prefix: | +suffix: | + + +`downArrow` key |`joystick2Down` + + + + +line: 4897 +prefix: | +suffix: | + + +`enter` key |`joystick2Center` + + + + +line: 4898 +prefix: | +suffix: | + + +`escape` key |`l2` + + + + +line: 4899 +prefix: | +suffix: | + + +`tab` key |`l3` + + + + +line: 4900 +prefix: | +suffix: | + + +Toggle `shift` key |`l4` + + + + +line: 4901 +prefix: | +suffix: | + + +Toggle `control` key |`l5` + + + + +line: 4902 +prefix: | +suffix: | + + +Toggle `alt` key |`l6` + + + + +line: 4903 +prefix: | +suffix: | + + +Toggle `NVDA` key |`l7` + + + + +line: 4904 +prefix: | +suffix: | + + +`control+home` key |`l1+l2+l3`, `l2+l3+l4` + + + + +line: 4905 +prefix: | +suffix: | + + +`control+end` key |`l6+l7+l8`, `l5+l6+l7` + + + + +line: 4906 +prefix: | +suffix: | + + +Toggle HID Keyboard simulation |`l1+joystick1Down`, `l8+joystick1Down` + + + + +line: 4910 +prefix: ### +suffix: {#NattiqTechnologies} + + +Nattiq nBraille Displays + + + + +line: 4912 + + +NVDA supports displays from [Nattiq Technologies](https://www.nattiq.com/) when connected via USB. + + + + +line: 4913 + + +Windows 10 and later detects the Braille Displays once connected, you may need to install USB drivers if using older versions of Windows (below Win10). + + + + +line: 4914 + + +You can get them from the manufacturer's website. + + + + +line: 4916 + + +Following are the key assignments for Nattiq Technologies displays with NVDA. + + + + +line: 4917 + + +Please see the display's documentation for descriptions of where these keys can be found. + + + + +line: 4920 +prefix: | +suffix: | + + + Name |Key + + + + +line: 4922 +prefix: | +suffix: | + + +Scroll braille display back |up + + + + +line: 4923 +prefix: | +suffix: | + + +Scroll braille display forward |down + + + + +line: 4924 +prefix: | +suffix: | + + +Move braille display to previous line |left + + + + +line: 4925 +prefix: | +suffix: | + + +Move braille display to next line |right + + + + +line: 4926 +prefix: | +suffix: | + + +Route to braille cell |routing + + + + +line: 4930 +prefix: ### +suffix: {#BRLTTY} + + +BRLTTY + + + + +line: 4932 + + +[BRLTTY](https://www.brltty.app/) is a separate program which can be used to support many more braille displays. + + + + +line: 4933 + + +In order to use this, you need to install [BRLTTY for Windows](https://www.brltty.app/download.html). + + + + +line: 4934 + + +You should download and install the latest installer package, which will be named, for example, brltty-win-4.2-2.exe. + + + + +line: 4935 + + +When configuring the display and port to use, be sure to pay close attention to the instructions, especially if you are using a USB display and already have the manufacturer's drivers installed. + + + + +line: 4937 + + +For displays which have a braille keyboard, BRLTTY currently handles braille input itself. + + + + +line: 4938 + + +Therefore, NVDA's braille input table setting is not relevant. + + + + +line: 4940 + + +BRLTTY is not involved in NVDA's automatic background braille display detection functionality. + + + + +line: 4942 + + +Following are the BRLTTY command assignments for NVDA. + + + + +line: 4943 + + +Please see the [BRLTTY key binding lists](https://brltty.app/doc/KeyBindings/) for information about how BRLTTY commands are mapped to controls on braille displays. + + + + +line: 4946 +prefix: | +suffix: | + + + Name |BRLTTY command + + + + +line: 4948 +prefix: | +suffix: | + + +Scroll braille display back |`fwinlt` (go left one window) + + + + +line: 4949 +prefix: | +suffix: | + + +Scroll braille display forward |`fwinrt` (go right one window) + + + + +line: 4950 +prefix: | +suffix: | + + +Move braille display to previous line |`lnup` (go up one line) + + + + +line: 4951 +prefix: | +suffix: | + + +Move braille display to next line |`lndn` (go down one line) + + + + +line: 4952 +prefix: | +suffix: | + + +Route to braille cell |`route` (bring cursor to character) + + + + +line: 4953 +prefix: | +suffix: | + + +Toggle input help |`learn` (enter/leave command learn mode) + + + + +line: 4954 +prefix: | +suffix: | + + +Open the NVDA menu |`prefmenu` (enter/leave preferences menu) + + + + +line: 4955 +prefix: | +suffix: | + + +Revert configuration |`prefload` (restore preferences from disk) + + + + +line: 4956 +prefix: | +suffix: | + + +Save configuration |`prefsave` (save preferences to disk) + + + + +line: 4957 +prefix: | +suffix: | + + +Report time |`time` (show current date and time) + + + + +line: 4958 +prefix: | +suffix: | + + +Speak the line where the review cursor is located |`say_line` (speak current line) + + + + +line: 4959 +prefix: | +suffix: | + + +Say all using review cursor |`say_below` (speak from current line through bottom of screen) + + + + +line: 4963 +prefix: ### +suffix: {#Albatross} + + +Tivomatic Caiku Albatross 46/80 + + + + +line: 4965 + + +The Caiku Albatross devices, which were manufactured by Tivomatic and available in Finland, can be connected to by either USB or serial. + + + + +line: 4966 + + +You do not need any specific drivers to be installed to use these displays. + + + + +line: 4967 + + +Just plug in the display and configure NVDA to use it. + + + + +line: 4969 + + +Note: Baud rate 19200 is strongly recommended. + + + + +line: 4970 + + +If required, switch Baud rate setting value to 19200 from the braille device's menu. + + + + +line: 4971 + + +Although the driver supports 9600 baud rate, it has no way to control what baud rate the display uses. + + + + +line: 4972 + + +Because 19200 is the display default baud rate, the driver tries it at first. + + + + +line: 4973 + + +If baud rates are not the same, the driver may behave unexpectedly. + + + + +line: 4975 + + +Following are key assignments for these displays with NVDA. + + + + +line: 4976 + + +Please see the display's documentation for descriptions of where these keys can be found. + + + + +line: 4979 +prefix: | +suffix: | + + + Name |Key + + + + +line: 4981 +prefix: | +suffix: | + + +Move to top line in review |`home1`, `home2` + + + + +line: 4982 +prefix: | +suffix: | + + +Move to bottom line in review |`end1`, `end2` + + + + +line: 4983 +prefix: | +suffix: | + + +Sets the navigator object to the current focus |`eCursor1`, `eCursor2` + + + + +line: 4984 +prefix: | +suffix: | + + +Move to current focus |`cursor1`, `cursor2` + + + + +line: 4985 +prefix: | +suffix: | + + +Moves the mouse pointer to the current navigator object |`home1+home2` + + + + +line: 4986 +prefix: | +suffix: | + + +Sets the navigator object to the current object under the mouse pointer and speaks it |`end1+end2` + + + + +line: 4987 +prefix: | +suffix: | + + +Moves focus to current navigator object |`eCursor1+eCursor2` + + + + +line: 4988 +prefix: | +suffix: | + + +Toggle braille tethered to |`cursor1+cursor2` + + + + +line: 4989 +prefix: | +suffix: | + + +Move braille display to previous line |`up1`, `up2`, `up3` + + + + +line: 4990 +prefix: | +suffix: | + + +Move braille display to next line |`down1`, `down2`, `down3` + + + + +line: 4991 +prefix: | +suffix: | + + +Scroll braille display back |`left`, `lWheelLeft`, `rWheelLeft` + + + + +line: 4992 +prefix: | +suffix: | + + +Scroll braille display forward |`right`, `lWheelRight`, `rWheelRight` + + + + +line: 4993 +prefix: | +suffix: | + + +Route to braille cell |`routing` + + + + +line: 4994 +prefix: | +suffix: | + + +Report text formatting under braille cell |`secondary routing` + + + + +line: 4995 +prefix: | +suffix: | + + +Toggle the way context information is presented in braille |`attribute1+attribute3` + + + + +line: 4996 +prefix: | +suffix: | + + +Cycles between speech modes |`attribute2+attribute4` + + + + +line: 4997 +prefix: | +suffix: | + + +Switches to the previous review mode (e.g. object, document or screen) |`f1` + + + + +line: 4998 +prefix: | +suffix: | + + +Switches to the next review mode (e.g. object, document or screen) |`f2` + + + + +line: 4999 +prefix: | +suffix: | + + +Moves the navigator object to the object containing it |`f3` + + + + +line: 5000 +prefix: | +suffix: | + + +Moves the navigator object to the first object inside it |`f4` + + + + +line: 5001 +prefix: | +suffix: | + + +Moves the navigator object to the previous object |`f5` + + + + +line: 5002 +prefix: | +suffix: | + + +Moves the navigator object to the next object |`f6` + + + + +line: 5003 +prefix: | +suffix: | + + +Reports the current navigator object |`f7` + + + + +line: 5004 +prefix: | +suffix: | + + +Reports information about the location of the text or object at the review cursor |`f8` + + + + +line: 5005 +prefix: | +suffix: | + + +Shows braille settings |`f1+home1`, `f9+home2` + + + + +line: 5006 +prefix: | +suffix: | + + +Reads status bar and moves navigator object into it |`f1+end1`, `f9+end2` + + + + +line: 5007 +prefix: | +suffix: | + + +Cycle the braille cursor shape |`f1+eCursor1`, `f9+eCursor2` + + + + +line: 5008 +prefix: | +suffix: | + + +Toggle the braille cursor |`f1+cursor1`, `f9+cursor2` + + + + +line: 5009 +prefix: | +suffix: | + + +Cycle the braille show messages mode |`f1+f2`, `f9+f10` + + + + +line: 5010 +prefix: | +suffix: | + + +Cycle the braille show selection state |`f1+f5`, `f9+f14` + + + + +line: 5011 +prefix: | +suffix: | + + +Cycle the "braille move system caret when routing review cursor" states |`f1+f3`, `f9+f11` + + + + +line: 5012 +prefix: | +suffix: | + + +Performs the default action on the current navigator object |`f7+f8` + + + + +line: 5013 +prefix: | +suffix: | + + +Reports date/time |`f9` + + + + +line: 5014 +prefix: | +suffix: | + + +Reports battery status and time remaining if AC is not plugged in |`f10` + + + + +line: 5015 +prefix: | +suffix: | + + +Reports title |`f11` + + + + +line: 5016 +prefix: | +suffix: | + + +Reports status bar |`f12` + + + + +line: 5017 +prefix: | +suffix: | + + +Reports the current line under the application cursor |`f13` + + + + +line: 5018 +prefix: | +suffix: | + + +Say all |`f14` + + + + +line: 5019 +prefix: | +suffix: | + + +Reports current character under review cursor |`f15` + + + + +line: 5020 +prefix: | +suffix: | + + +Reports the line of the current navigator object where the review cursor is situated |`f16` + + + + +line: 5021 +prefix: | +suffix: | + + +Speaks the word of the current navigator object where the review cursor is situated |`f15+f16` + + + + +line: 5022 +prefix: | +suffix: | + + +Moves the review cursor to the previous line of the current navigator object and speaks it |`lWheelUp`, `rWheelUp` + + + + +line: 5023 +prefix: | +suffix: | + + +Moves the review cursor to the next line of the current navigator object and speaks it |`lWheelDown`, `rWheelDown` + + + + +line: 5024 +prefix: | +suffix: | + + +`Windows+d` key (minimize all applications) |`attribute1` + + + + +line: 5025 +prefix: | +suffix: | + + +`Windows+e` key (this computer) |`attribute2` + + + + +line: 5026 +prefix: | +suffix: | + + +`Windows+b` key (focus system tray) |`attribute3` + + + + +line: 5027 +prefix: | +suffix: | + + +`Windows+i` key (Windows settings) |`attribute4` + + + + +line: 5031 +prefix: ### +suffix: {#HIDBraille} + + +Standard HID Braille displays + + + + +line: 5033 + + +This is an experimental driver for the new Standard HID Braille Specification, agreed upon in 2018 by Microsoft, Google, Apple and several assistive technology companies including NV Access. + + + + +line: 5034 + + +The hope is that all future Braille Display models created by any manufacturer, will use this standard protocol which will remove the need for manufacturer-specific Braille drivers. + + + + +line: 5036 + + +NVDA's automatic braille display detection will also recognize any display that supports this protocol. + + + + +line: 5038 + + +Following are the current key assignments for these displays. + + + + +line: 5041 +prefix: | +suffix: | + + + Name |Key + + + + +line: 5043 +prefix: | +suffix: | + + +Scroll braille display back |pan left or rocker up + + + + +line: 5044 +prefix: | +suffix: | + + +Scroll braille display forward |pan right or rocker down + + + + +line: 5045 +prefix: | +suffix: | + + +Route to braille cell |routing set 1 + + + + +line: 5046 +prefix: | +suffix: | + + +Toggle braille tethered to |up+down + + + + +line: 5047 +prefix: | +suffix: | + + +upArrow key |joystick up, dpad up or space+dot1 + + + + +line: 5048 +prefix: | +suffix: | + + +downArrow key |joystick down, dpad down or space+dot4 + + + + +line: 5049 +prefix: | +suffix: | + + +leftArrow key |space+dot3, joystick left or dpad left + + + + +line: 5050 +prefix: | +suffix: | + + +rightArrow key |space+dot6, joystick right or dpad right + + + + +line: 5051 +prefix: | +suffix: | + + +shift+tab key |space+dot1+dot3 + + + + +line: 5052 +prefix: | +suffix: | + + +tab key |space+dot4+dot6 + + + + +line: 5053 +prefix: | +suffix: | + + +alt key |space+dot1+dot3+dot4 (space+m) + + + + +line: 5054 +prefix: | +suffix: | + + +escape key |space+dot1+dot5 (space+e) + + + + +line: 5055 +prefix: | +suffix: | + + +enter key |dot8, joystick center or dpad center + + + + +line: 5056 +prefix: | +suffix: | + + +windows key |space+dot3+dot4 + + + + +line: 5057 +prefix: | +suffix: | + + +alt+tab key |space+dot2+dot3+dot4+dot5 (space+t) + + + + +line: 5058 +prefix: | +suffix: | + + +NVDA Menu |space+dot1+dot3+dot4+dot5 (space+n) + + + + +line: 5059 +prefix: | +suffix: | + + +windows+d key (minimize all applications) |space+dot1+dot4+dot5 (space+d) + + + + +line: 5060 +prefix: | +suffix: | + + +Say all |space+dot1+dot2+dot3+dot4+dot5+dot6 + + + + +line: 5064 +prefix: ## +suffix: {#AdvancedTopics} + + +Advanced Topics + + + + +line: 5065 +prefix: ### +suffix: {#SecureMode} + + +Secure Mode + + + + +line: 5067 + + +System administrators may wish to configure NVDA to restrict unauthorized system access. + + + + +line: 5068 + + +NVDA allows the installation of custom add-ons, which can execute arbitrary code, including when NVDA is elevated to administrator privileges. + + + + +line: 5069 + + +NVDA also allows users to execute arbitrary code through the NVDA Python Console. + + + + +line: 5070 + + +NVDA secure mode prevents users from modifying their NVDA configuration, and otherwise limits unauthorized system access. + + + + +line: 5072 + + +NVDA runs in secure mode when executed on [secure screens](#SecureScreens), unless the `serviceDebug` [system wide parameter](#SystemWideParameters) is enabled. + + + + +line: 5073 + + +To force NVDA to always start in secure mode, set the `forceSecureMode` [system wide parameter](#SystemWideParameters). + + + + +line: 5074 + + +NVDA can also be started in secure mode with the `-s` [command line option](#CommandLineOptions). + + + + +line: 5076 + + +Secure mode disables: + + + + +line: 5078 +prefix: * + + +Saving configuration and other settings to disk + + + + +line: 5079 +prefix: * + + +Saving the gesture map to disk + + + + +line: 5080 +prefix: * + + +[Configuration Profile](#ConfigurationProfiles) features such as creation, deletion, renaming profiles etc. + + + + +line: 5081 +prefix: * + + +Loading custom configuration folders using [the `-c` command line option](#CommandLineOptions) + + + + +line: 5082 +prefix: * + + +Updating NVDA and creating portable copies + + + + +line: 5083 +prefix: * + + +The [Add-on Store](#AddonsManager) + + + + +line: 5084 +prefix: * + + +The [NVDA Python console](#PythonConsole) + + + + +line: 5085 +prefix: * + + +The [Log Viewer](#LogViewer) and logging + + + + +line: 5086 +prefix: * + + +The [Braille Viewer](#BrailleViewer) and [Speech Viewer](#SpeechViewer) + + + + +line: 5087 +prefix: * + + +Opening external documents from the NVDA menu, such as the user guide or contributors file. + + + + +line: 5089 + + +Installed copies of NVDA store their configuration including add-ons in `%APPDATA%\nvda`. + + + + +line: 5090 + + +To prevent NVDA users from modifying their configuration or add-ons directly, user access to this folder must also be restricted. + + + + +line: 5092 + + +Secure mode is ineffective for portable copies of NVDA. + + + + +line: 5093 + + +This limitation also applies to the temporary copy of NVDA which runs when launching the installer. + + + + +line: 5094 + + +In secure environments, a user being able to run a portable executable is the same security risk regardless of secure mode. + + + + +line: 5095 + + +It is expected that system administrators restrict unauthorized software from running on their systems, including portable copies of NVDA. + + + + +line: 5097 + + +NVDA users often rely on configuring their NVDA profile to suit their needs. + + + + +line: 5098 + + +This may include installing and configuring custom add-ons, which should be vetted independently to NVDA. + + + + +line: 5099 + + +Secure mode freezes changes to NVDA configuration, so please ensure that NVDA is configured appropriately before forcing secure mode. + + + + +line: 5101 +prefix: ### +suffix: {#SecureScreens} + + +Secure Screens + + + + +line: 5103 + + +NVDA runs in [secure mode](#SecureMode) when executed on secure screens unless the `serviceDebug` [system wide parameter](#SystemWideParameters) is enabled. + + + + +line: 5105 + + +When running from a secure screen, NVDA uses a system profile for preferences. + + + + +line: 5106 + + +NVDA user preferences can be copied [for use in secure screens](#GeneralSettingsCopySettings). + + + + +line: 5108 + + +Secure screens include: + + + + +line: 5110 +prefix: * + + +The Windows sign-in screen + + + + +line: 5111 +prefix: * + + +The User Access Control dialog, active when performing an action as an administrator + + + + +line: 5112 +prefix: * + + +This includes installing programs + + + + +line: 5114 +prefix: ### +suffix: {#CommandLineOptions} + + +Command Line Options + + + + +line: 5116 + + +NVDA can accept one or more additional options when it starts which alter its behaviour. + + + + +line: 5117 + + +You can pass as many options as you need. + + + + +line: 5118 + + +These options can be passed when starting from a shortcut (in the shortcut properties), from the Run dialog (Start Menu -> Run or Windows+r) or from a Windows command console. + + + + +line: 5119 + + +Options should be separated from the name of NVDA's executable file and from other options by spaces. + + + + +line: 5120 + + +For example, a useful option is `--disable-addons`, which tells NVDA to suspend all running add-ons. + + + + +line: 5121 + + +This allows you to determine whether a problem is caused by an add-on and to recover from serious problems caused by add-ons. + + + + +line: 5123 + + +As an example, you can exit the currently running copy of NVDA by entering the following in the Run dialog: + + + + +line: 5125 + + + nvda -q + + + + +line: 5127 + + +Some of the command line options have a short and a long version, while some of them have only a long version. + + + + +line: 5128 + + +For those which have a short version, you can combine them like this: + + + + +line: 5132 +prefix: | +suffix: | + + +`nvda -mc CONFIGPATH` |This will start NVDA with startup sounds and message disabled, and the specified configuration + + + + +line: 5133 +prefix: | +suffix: | + + +`nvda -mc CONFIGPATH --disable-addons` |Same as above, but with add-ons disabled + + + + +line: 5135 + + +Some of the command line options accept additional parameters; e.g. how detailed the logging should be or the path to the user configuration directory. + + + + +line: 5136 + + +Those parameters should be placed after the option, separated from the option by a space when using the short version or an equals sign (`=`) when using the long version; e.g.: + + + + +line: 5140 +prefix: | +suffix: | + + +`nvda -l 10` |Tells NVDA to start with log level set to debug + + + + +line: 5141 +prefix: | +suffix: | + + +`nvda --log-file=c:\nvda.log` |Tells NVDA to write its log to `c:\nvda.log` + + + + +line: 5142 +prefix: | +suffix: | + + +`nvda --log-level=20 -f c:\nvda.log` |Tells NVDA to start with log level set to info and to write its log to `c:\nvda.log` + + + + +line: 5144 + + +Following are the command line options for NVDA: + + + + +line: 5146 +prefix: | +suffix: | + + + Short |Long |Description + + + + +line: 5148 +prefix: | +suffix: | + + +`-h` |`--help` |show command line help and exit + + + + +line: 5149 +prefix: | +suffix: | + + +`-q` |`--quit` |Quit already running copy of NVDA + + + + +line: 5150 +prefix: | +suffix: | + + +`-k` |`--check-running` |Report whether NVDA is running via the exit code; 0 if running, 1 if not running + + + + +line: 5151 +prefix: | +suffix: | + + +`-f LOGFILENAME` |`--log-file=LOGFILENAME` |The file where log messages should be written to. Logging is always disabled if secure mode is enabled. + + + + +line: 5152 +prefix: | +suffix: | + + +`-l LOGLEVEL` |`--log-level=LOGLEVEL` |The lowest level of message logged (debug 10, input/output 12, debug warning 15, info 20, disabled 100). Logging is always disabled if secure mode is enabled. + + + + +line: 5153 +prefix: | +suffix: | + + +`-c CONFIGPATH` |`--config-path=CONFIGPATH` |The path where all settings for NVDA are stored. The default value is forced if secure mode is enabled. + + + + +line: 5154 +prefix: | +suffix: | + + +None |`--lang=LANGUAGE` |Override the configured NVDA language. Set to "Windows" for current user default, "en" for English, etc. + + + + +line: 5155 +prefix: | +suffix: | + + +`-m` |`--minimal` |No sounds, no interface, no start message, etc. + + + + +line: 5156 +prefix: | +suffix: | + + +`-s` |`--secure` |Starts NVDA in [Secure Mode](#SecureMode) + + + + +line: 5157 +prefix: | +suffix: | + + +None |`--disable-addons` |Add-ons will have no effect + + + + +line: 5158 +prefix: | +suffix: | + + +None |`--debug-logging` |Enable debug level logging just for this run. This setting will override any other log level ( `--loglevel`, `-l`) argument given, including no logging option. + + + + +line: 5159 +prefix: | +suffix: | + + +None |`--no-logging` |Disable logging altogether while using NVDA. This setting can be overridden if a log level (`--loglevel`, `-l`) is specified from command line or if debug logging is turned on. + + + + +line: 5160 +prefix: | +suffix: | + + +None |`--no-sr-flag` |Don't change the global system screen reader flag + + + + +line: 5161 +prefix: | +suffix: | + + +None |`--install` |Installs NVDA (starting the newly installed copy) + + + + +line: 5162 +prefix: | +suffix: | + + +None |`--install-silent` |Silently installs NVDA (does not start the newly installed copy) + + + + +line: 5163 +prefix: | +suffix: | + + +None |`--enable-start-on-logon=True|False` |When installing, enable NVDA's [Use NVDA during Windows sign-in](#StartAtWindowsLogon) + + + + +line: 5164 +prefix: | +suffix: | + + +None |`--copy-portable-config` |When installing, copy the portable configuration from the provided path (`--config-path`, `-c`) to the current user account + + + + +line: 5165 +prefix: | +suffix: | + + +None |`--create-portable` |Creates a portable copy of NVDA (and starts the new copy). Requires `--portable-path` to be specified + + + + +line: 5166 +prefix: | +suffix: | + + +None |`--create-portable-silent` |Creates a portable copy of NVDA (without starting the new copy). Requires `--portable-path` to be specified. This option suppresses warnings when writing to non-empty directories and may overwrite files without warning. + + + + +line: 5167 +prefix: | +suffix: | + + +None |`--portable-path=PORTABLEPATH` |The path where a portable copy will be created + + + + +line: 5169 +prefix: ### +suffix: {#SystemWideParameters} + + +System Wide Parameters + + + + +line: 5171 + + +NVDA allows some values to be set in the system registry which alter the system wide behaviour of NVDA. + + + + +line: 5172 + + +These values are stored in the registry under one of the following keys: + + + + +line: 5174 +prefix: * + + +32-bit system: `HKEY_LOCAL_MACHINE\SOFTWARE\nvda` + + + + +line: 5175 +prefix: * + + +64-bit system: `HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\nvda` + + + + +line: 5177 + + +The following values can be set under this registry key: + + + + +line: 5179 +prefix: | +suffix: | + + + Name |Type |Possible values |Description + + + + +line: 5181 +prefix: | +suffix: | + + +`configInLocalAppData` |DWORD |0 (default) to disable, 1 to enable |If enabled, stores the NVDA user configuration in the local application data instead of the roaming application data + + + + +line: 5182 +prefix: | +suffix: | + + +`serviceDebug` |DWORD |0 (default) to disable, 1 to enable |If enabled, disables [Secure Mode](#SecureMode) on [secure screens](#SecureScreens). Due to several major security implications, the use of this option is strongly discouraged + + + + +line: 5183 +prefix: | +suffix: | + + +`forceSecureMode` |DWORD |0 (default) to disable, 1 to enable |If enabled, forces [Secure Mode](#SecureMode) to be enabled when running NVDA. + + + + +line: 5185 +prefix: ## +suffix: {#FurtherInformation} + + +Further Information + + + + +line: 5187 + + +If you require further information or assistance regarding NVDA, please visit the [NVDA web site](NVDA_URL). + + + + +line: 5188 + + +Here, you can find additional documentation, as well as technical support and community resources. + + + + +line: 5189 + + +This site also provides information and resources concerning NVDA development. + + + + \ No newline at end of file diff --git a/user_docs/markdownTranslate.py b/user_docs/markdownTranslate.py new file mode 100644 index 00000000000..c70353a0e60 --- /dev/null +++ b/user_docs/markdownTranslate.py @@ -0,0 +1,673 @@ +# A part of NonVisual Desktop Access (NVDA) +# Copyright (C) 2024 NV Access Limited. +# This file is covered by the GNU General Public License. +# See the file COPYING for more details. + +from typing import Generator +import tempfile +import os +import contextlib +import lxml.etree +import argparse +import uuid +import re +from itertools import zip_longest +from xml.sax.saxutils import escape as xmlEscape +from xml.sax.saxutils import unescape as xmlUnescape +import difflib +from dataclasses import dataclass +import subprocess + +RAW_GITHUB_REPO_URL = "https://raw.githubusercontent.com/nvaccess/nvda" +re_kcTitle = re.compile(r"^()$") +re_kcSettingsSection = re.compile(r"^()$") +re_comment = re.compile(r"^$") +re_heading = re.compile(r"^(#+\s+)(.+?)((?:\s+\{#.+\})?)$") +re_bullet = re.compile(r"^(\s*\*\s+)(.+)$") +re_number = re.compile(r"^(\s*[0-9]+\.\s+)(.+)$") +re_hiddenHeaderRow = re.compile(r"^\|\s*\.\s*\{\.hideHeaderRow\}\s*(\|\s*\.\s*)*\|$") +re_postTableHeaderLine = re.compile(r"^(\|\s*-+\s*)+\|$") +re_tableRow = re.compile(r"^(\|)(.+)(\|)$") +re_translationID = re.compile(r"^(.*)\$\(ID:([0-9a-f-]+)\)(.*)$") + + +def prettyPathString(path: str) -> str: + return os.path.relpath(path, os.getcwd()) + + +@contextlib.contextmanager +def createAndDeleteTempFilePath_contextManager( + dir: str | None = None, prefix: str | None = None, suffix: str | None = None +) -> Generator[str, None, None]: + """A context manager that creates a temporary file and deletes it when the context is exited""" + with tempfile.NamedTemporaryFile(dir=dir, prefix=prefix, suffix=suffix, delete=False) as tempFile: + tempFilePath = tempFile.name + tempFile.close() + yield tempFilePath + os.remove(tempFilePath) + + +def getLastCommitID(filePath: str) -> str: + # Run the git log command to get the last commit ID for the given file + result = subprocess.run( + ["git", "log", "-n", "1", "--pretty=format:%H", "--", filePath], + capture_output=True, + text=True, + check=True, + ) + commitID = result.stdout.strip() + if not re.match(r"[0-9a-f]{40}", commitID): + raise ValueError(f"Invalid commit ID: '{commitID}' for file '{filePath}'") + return commitID + + +def getGitDir() -> str: + # Run the git rev-parse command to get the root of the git directory + result = subprocess.run( + ["git", "rev-parse", "--show-toplevel"], capture_output=True, text=True, check=True + ) + gitDir = result.stdout.strip() + if not os.path.isdir(gitDir): + raise ValueError(f"Invalid git directory: '{gitDir}'") + return gitDir + + +def getRawGithubURLForPath(filePath: str) -> str: + gitDirPath = getGitDir() + commitID = getLastCommitID(filePath) + relativePath = os.path.relpath(os.path.abspath(filePath), gitDirPath) + relativePath = relativePath.replace("\\", "/") + return f"{RAW_GITHUB_REPO_URL}/{commitID}/{relativePath}" + + +def skeletonizeLine(mdLine: str) -> str | None: + prefix = "" + suffix = "" + if ( + mdLine.isspace() + or mdLine.strip() == "[TOC]" + or re_hiddenHeaderRow.match(mdLine) + or re_postTableHeaderLine.match(mdLine) + ): + return None + elif m := re_heading.match(mdLine): + prefix, content, suffix = m.groups() + elif m := re_bullet.match(mdLine): + prefix, content = m.groups() + elif m := re_number.match(mdLine): + prefix, content = m.groups() + elif m := re_tableRow.match(mdLine): + prefix, content, suffix = m.groups() + elif m := re_kcTitle.match(mdLine): + prefix, content, suffix = m.groups() + elif m := re_kcSettingsSection.match(mdLine): + prefix, content, suffix = m.groups() + elif re_comment.match(mdLine): + return None + ID = str(uuid.uuid4()) + return f"{prefix}$(ID:{ID}){suffix}\n" + + +@dataclass +class Result_generateSkeleton: + numTotalLines: int = 0 + numTranslationPlaceholders: int = 0 + + +def generateSkeleton(mdPath: str, outputPath: str) -> Result_generateSkeleton: + print(f"Generating skeleton file {prettyPathString(outputPath)} from {prettyPathString(mdPath)}...") + res = Result_generateSkeleton() + with ( + open(mdPath, "r", encoding="utf8") as mdFile, + open(outputPath, "w", encoding="utf8", newline="") as outputFile, + ): + for mdLine in mdFile.readlines(): + res.numTotalLines += 1 + skelLine = skeletonizeLine(mdLine) + if skelLine: + res.numTranslationPlaceholders += 1 + else: + skelLine = mdLine + outputFile.write(skelLine) + print( + f"Generated skeleton file with {res.numTotalLines} total lines and {res.numTranslationPlaceholders} translation placeholders" + ) + return res + + +@dataclass +class Result_updateSkeleton: + numAddedLines: int = 0 + numAddedTranslationPlaceholders: int = 0 + numRemovedLines: int = 0 + numRemovedTranslationPlaceholders: int = 0 + numUnchangedLines: int = 0 + numUnchangedTranslationPlaceholders: int = 0 + + +def extractSkeleton(xliffPath: str, outputPath: str): + print(f"Extracting skeleton from {prettyPathString(xliffPath)} to {prettyPathString(outputPath)}...") + with contextlib.ExitStack() as stack: + outputFile = stack.enter_context(open(outputPath, "w", encoding="utf8", newline="")) + xliff = lxml.etree.parse(xliffPath) + xliffRoot = xliff.getroot() + namespace = {"xliff": "urn:oasis:names:tc:xliff:document:2.0"} + if xliffRoot.tag != "{urn:oasis:names:tc:xliff:document:2.0}xliff": + raise ValueError("Not an xliff file") + skeletonNode = xliffRoot.find("./xliff:file/xliff:skeleton", namespaces=namespace) + if skeletonNode is None: + raise ValueError("No skeleton found in xliff file") + skeletonContent = skeletonNode.text.strip() + outputFile.write(xmlUnescape(skeletonContent)) + print(f"Extracted skeleton to {prettyPathString(outputPath)}") + + +def updateSkeleton( + origMdPath: str, newMdPath: str, origSkelPath: str, outputPath: str +) -> Result_updateSkeleton: + print( + f"Creating updated skeleton file {prettyPathString(outputPath)} from {prettyPathString(origSkelPath)} with changes from {prettyPathString(origMdPath)} to {prettyPathString(newMdPath)}..." + ) + res = Result_updateSkeleton() + with contextlib.ExitStack() as stack: + origMdFile = stack.enter_context(open(origMdPath, "r", encoding="utf8")) + newMdFile = stack.enter_context(open(newMdPath, "r", encoding="utf8")) + origSkelFile = stack.enter_context(open(origSkelPath, "r", encoding="utf8")) + outputFile = stack.enter_context(open(outputPath, "w", encoding="utf8", newline="")) + mdDiff = difflib.ndiff(origMdFile.readlines(), newMdFile.readlines()) + origSkelLines = iter(origSkelFile.readlines()) + for mdDiffLine in mdDiff: + if mdDiffLine.startswith("?"): + continue + if mdDiffLine.startswith(" "): + res.numUnchangedLines += 1 + skelLine = next(origSkelLines) + if re_translationID.match(skelLine): + res.numUnchangedTranslationPlaceholders += 1 + outputFile.write(skelLine) + elif mdDiffLine.startswith("+"): + res.numAddedLines += 1 + skelLine = skeletonizeLine(mdDiffLine[2:]) + if skelLine: + res.numAddedTranslationPlaceholders += 1 + else: + skelLine = mdDiffLine[2:] + outputFile.write(skelLine) + elif mdDiffLine.startswith("-"): + res.numRemovedLines += 1 + origSkelLine = next(origSkelLines) + if re_translationID.match(origSkelLine): + res.numRemovedTranslationPlaceholders += 1 + else: + raise ValueError(f"Unexpected diff line: {mdDiffLine}") + print( + f"Updated skeleton file with {res.numAddedLines} added lines " + f"({res.numAddedTranslationPlaceholders} translation placeholders), " + f"{res.numRemovedLines} removed lines ({res.numRemovedTranslationPlaceholders} translation placeholders), " + f"and {res.numUnchangedLines} unchanged lines ({res.numUnchangedTranslationPlaceholders} translation placeholders)" + ) + return res + + +@dataclass +class Result_generateXliff: + numTranslatableStrings: int = 0 + + +def generateXliff( + mdPath: str, + outputPath: str, + skelPath: str | None = None, +) -> Result_generateXliff: + # If a skeleton file is not provided, first generate one + with contextlib.ExitStack() as stack: + if not skelPath: + skelPath = stack.enter_context( + createAndDeleteTempFilePath_contextManager( + dir=os.path.dirname(outputPath), + prefix=os.path.basename(mdPath), + suffix=".skel", + ) + ) + generateSkeleton(mdPath=mdPath, outputPath=skelPath) + with open(skelPath, "r", encoding="utf8") as skelFile: + skelContent = skelFile.read() + res = Result_generateXliff() + print( + f"Generating xliff file {prettyPathString(outputPath)} from {prettyPathString(mdPath)} and {prettyPathString(skelPath)}..." + ) + with contextlib.ExitStack() as stack: + mdFile = stack.enter_context(open(mdPath, "r", encoding="utf8")) + outputFile = stack.enter_context(open(outputPath, "w", encoding="utf8", newline="")) + fileID = os.path.basename(mdPath) + mdUri = getRawGithubURLForPath(mdPath) + print(f"Including Github raw URL: {mdUri}") + outputFile.write( + '\n' + f'\n' + f'\n' + ) + outputFile.write(f"\n{xmlEscape(skelContent)}\n\n") + res.numTranslatableStrings = 0 + for lineNo, (mdLine, skelLine) in enumerate( + zip_longest(mdFile.readlines(), skelContent.splitlines(keepends=True)), start=1 + ): + mdLine = mdLine.rstrip() + skelLine = skelLine.rstrip() + if m := re_translationID.match(skelLine): + res.numTranslatableStrings += 1 + prefix, ID, suffix = m.groups() + if prefix and not mdLine.startswith(prefix): + raise ValueError(f'Line {lineNo}: does not start with "{prefix}", {mdLine=}, {skelLine=}') + if suffix and not mdLine.endswith(suffix): + raise ValueError(f'Line {lineNo}: does not end with "{suffix}", {mdLine=}, {skelLine=}') + source = mdLine[len(prefix) : len(mdLine) - len(suffix)] + outputFile.write( + f'\n' "\n" f'line: {lineNo + 1}\n' + ) + if prefix: + outputFile.write(f'prefix: {xmlEscape(prefix)}\n') + if suffix: + outputFile.write(f'suffix: {xmlEscape(suffix)}\n') + outputFile.write( + "\n" + f"\n" + f"{xmlEscape(source)}\n" + "\n" + "\n" + ) + else: + if mdLine != skelLine: + raise ValueError(f"Line {lineNo}: {mdLine=} does not match {skelLine=}") + outputFile.write("\n" "") + print(f"Generated xliff file with {res.numTranslatableStrings} translatable strings") + return res + + +@dataclass +class Result_translateXliff: + numTranslatedStrings: int = 0 + + +def updateXliff( + xliffPath: str, + mdPath: str, + outputPath: str, +): + # uses generateMarkdown, extractSkeleton, updateSkeleton, and generateXliff to generate an updated xliff file. + outputDir = os.path.dirname(outputPath) + print( + f"Generating updated xliff file {prettyPathString(outputPath)} from {prettyPathString(xliffPath)} and {prettyPathString(mdPath)}..." + ) + with contextlib.ExitStack() as stack: + origMdPath = stack.enter_context( + createAndDeleteTempFilePath_contextManager(dir=outputDir, prefix="generated_", suffix=".md") + ) + generateMarkdown(xliffPath=xliffPath, outputPath=origMdPath, translated=False) + origSkelPath = stack.enter_context( + createAndDeleteTempFilePath_contextManager(dir=outputDir, prefix="extracted_", suffix=".skel") + ) + extractSkeleton(xliffPath=xliffPath, outputPath=origSkelPath) + updatedSkelPath = stack.enter_context( + createAndDeleteTempFilePath_contextManager(dir=outputDir, prefix="updated_", suffix=".skel") + ) + updateSkeleton( + origMdPath=origMdPath, + newMdPath=mdPath, + origSkelPath=origSkelPath, + outputPath=updatedSkelPath, + ) + generateXliff( + mdPath=mdPath, + skelPath=updatedSkelPath, + outputPath=outputPath, + ) + print(f"Generated updated xliff file {prettyPathString(outputPath)}") + + +def translateXliff( + xliffPath: str, + lang: str, + pretranslatedMdPath: str, + outputPath: str, + allowBadAnchors: bool = False, +) -> Result_translateXliff: + print( + f"Creating {lang} translated xliff file {prettyPathString(outputPath)} from {prettyPathString(xliffPath)} using {prettyPathString(pretranslatedMdPath)}..." + ) + res = Result_translateXliff() + with contextlib.ExitStack() as stack: + pretranslatedMdFile = stack.enter_context(open(pretranslatedMdPath, "r", encoding="utf8")) + xliff = lxml.etree.parse(xliffPath) + xliffRoot = xliff.getroot() + namespace = {"xliff": "urn:oasis:names:tc:xliff:document:2.0"} + if xliffRoot.tag != "{urn:oasis:names:tc:xliff:document:2.0}xliff": + raise ValueError("Not an xliff file") + xliffRoot.set("trgLang", lang) + skeletonNode = xliffRoot.find("./xliff:file/xliff:skeleton", namespaces=namespace) + if skeletonNode is None: + raise ValueError("No skeleton found in xliff file") + skeletonContent = xmlUnescape(skeletonNode.text).strip() + for lineNo, (skelLine, pretranslatedLine) in enumerate( + zip_longest(skeletonContent.splitlines(), pretranslatedMdFile.readlines()), + start=1, + ): + skelLine = skelLine.rstrip() + pretranslatedLine = pretranslatedLine.rstrip() + if m := re_translationID.match(skelLine): + prefix, ID, suffix = m.groups() + if prefix and not pretranslatedLine.startswith(prefix): + raise ValueError( + f'Line {lineNo} of translation does not start with "{prefix}", {pretranslatedLine=}, {skelLine=}' + ) + if suffix and not pretranslatedLine.endswith(suffix): + if allowBadAnchors and (m := re_heading.match(pretranslatedLine)): + print(f"Warning: ignoring bad anchor in line {lineNo}: {pretranslatedLine}") + suffix = m.group(3) + if suffix and not pretranslatedLine.endswith(suffix): + raise ValueError( + f'Line {lineNo} of translation: does not end with "{suffix}", {pretranslatedLine=}, {skelLine=}' + ) + translation = pretranslatedLine[len(prefix) : len(pretranslatedLine) - len(suffix)] + unit = xliffRoot.find(f'./xliff:file/xliff:unit[@id="{ID}"]', namespaces=namespace) + if unit is not None: + segment = unit.find("./xliff:segment", namespaces=namespace) + if segment is not None: + target = lxml.etree.Element("target") + target.text = xmlEscape(translation) + target.tail = "\n" + segment.append(target) + res.numTranslatedStrings += 1 + else: + raise ValueError(f"No segment found for unit {ID}") + else: + raise ValueError(f"Cannot locate Unit {ID} in xliff file") + xliff.write(outputPath, encoding="utf8", xml_declaration=True) + print(f"Translated xliff file with {res.numTranslatedStrings} translated strings") + return res + + +@dataclass +class Result_generateMarkdown: + numTotalLines = 0 + numTranslatableStrings = 0 + numTranslatedStrings = 0 + + +def generateMarkdown(xliffPath: str, outputPath: str, translated: bool = True) -> Result_generateMarkdown: + print(f"Generating markdown file {prettyPathString(outputPath)} from {prettyPathString(xliffPath)}...") + res = Result_generateMarkdown() + with contextlib.ExitStack() as stack: + outputFile = stack.enter_context(open(outputPath, "w", encoding="utf8", newline="")) + xliff = lxml.etree.parse(xliffPath) + xliffRoot = xliff.getroot() + namespace = {"xliff": "urn:oasis:names:tc:xliff:document:2.0"} + if xliffRoot.tag != "{urn:oasis:names:tc:xliff:document:2.0}xliff": + raise ValueError("Not an xliff file") + skeletonNode = xliffRoot.find("./xliff:file/xliff:skeleton", namespaces=namespace) + if skeletonNode is None: + raise ValueError("No skeleton found in xliff file") + skeletonContent = xmlUnescape(skeletonNode.text).strip() + for line in skeletonContent.splitlines(keepends=True): + res.numTotalLines += 1 + if m := re_translationID.match(line): + prefix, ID, suffix = m.groups() + res.numTranslatableStrings += 1 + unit = xliffRoot.find(f'./xliff:file/xliff:unit[@id="{ID}"]', namespaces=namespace) + if unit is not None: + segment = unit.find("./xliff:segment", namespaces=namespace) + if segment is not None: + source = segment.find("./xliff:source", namespaces=namespace) + if translated: + target = segment.find("./xliff:target", namespaces=namespace) + else: + target = None + if target is not None and target.text: + res.numTranslatedStrings += 1 + translation = xmlUnescape(target.text) + elif source is not None and source.text: + translation = xmlUnescape(source.text) + else: + raise ValueError(f"No source or target found for unit {ID}") + else: + raise ValueError(f"No segment found for unit {ID}") + else: + raise ValueError(f"Cannot locate Unit {ID} in xliff file") + outputFile.write(f"{prefix}{translation}{suffix}\n") + else: + outputFile.write(line) + print( + f"Generated markdown file with {res.numTotalLines} total lines, {res.numTranslatableStrings} translatable strings, and {res.numTranslatedStrings} translated strings" + ) + return res + + +def ensureMarkdownFilesMatch(path1: str, path2: str, allowBadAnchors: bool = False): + print(f"Ensuring files {prettyPathString(path1)} and {prettyPathString(path2)} match...") + with contextlib.ExitStack() as stack: + file1 = stack.enter_context(open(path1, "r", encoding="utf8")) + file2 = stack.enter_context(open(path2, "r", encoding="utf8")) + for lineNo, (line1, line2) in enumerate(zip_longest(file1.readlines(), file2.readlines()), start=1): + line1 = line1.rstrip() + line2 = line2.rstrip() + if line1 != line2: + if ( + re_postTableHeaderLine.match(line1) + and re_postTableHeaderLine.match(line2) + and line1.count("|") == line2.count("|") + ): + print( + f"Warning: ignoring cell padding of post table header line at line {lineNo}: {line1}, {line2}" + ) + continue + if ( + re_hiddenHeaderRow.match(line1) + and re_hiddenHeaderRow.match(line2) + and line1.count("|") == line2.count("|") + ): + print( + f"Warning: ignoring cell padding of hidden header row at line {lineNo}: {line1}, {line2}" + ) + continue + if allowBadAnchors and (m1 := re_heading.match(line1)) and (m2 := re_heading.match(line2)): + print(f"Warning: ignoring bad anchor in headings at line {lineNo}: {line1}, {line2}") + line1 = m1.group(1) + m1.group(2) + line2 = m2.group(1) + m2.group(2) + if line1 != line2: + raise ValueError(f"Files do not match at line {lineNo}: {line1=} {line2=}") + print("Files match") + + +def markdownTranslateCommand(command: str, *args): + print(f"Running markdownTranslate command: {command} {' '.join(args)}") + subprocess.run(["python", __file__, command, *args], check=True) + + +def pretranslateAllPossibleLanguages(langsDir: str, mdBaseName: str): + # This function walks through all language directories in the given directory, skipping en (English) and translates the English xlif and skel file along with the lang's pretranslated md file + enXliffPath = os.path.join(langsDir, "en", f"{mdBaseName}.xliff") + if not os.path.exists(enXliffPath): + raise ValueError(f"English xliff file {enXliffPath} does not exist") + allLangs = set() + succeededLangs = set() + skippedLangs = set() + for langDir in os.listdir(langsDir): + if langDir == "en": + continue + langDirPath = os.path.join(langsDir, langDir) + if not os.path.isdir(langDirPath): + continue + langPretranslatedMdPath = os.path.join(langDirPath, f"{mdBaseName}.md") + if not os.path.exists(langPretranslatedMdPath): + continue + allLangs.add(langDir) + langXliffPath = os.path.join(langDirPath, f"{mdBaseName}.xliff") + if os.path.exists(langXliffPath): + print(f"Skipping {langDir} as the xliff file already exists") + skippedLangs.add(langDir) + continue + try: + translateXliff( + xliffPath=enXliffPath, + lang=langDir, + pretranslatedMdPath=langPretranslatedMdPath, + outputPath=langXliffPath, + allowBadAnchors=True, + ) + except Exception as e: + print(f"Failed to translate {langDir}: {e}") + continue + rebuiltLangMdPath = os.path.join(langDirPath, f"rebuilt_{mdBaseName}.md") + try: + generateMarkdown( + xliffPath=langXliffPath, + outputPath=rebuiltLangMdPath, + ) + except Exception as e: + print(f"Failed to rebuild {langDir} markdown: {e}") + os.remove(langXliffPath) + continue + try: + ensureMarkdownFilesMatch(rebuiltLangMdPath, langPretranslatedMdPath, allowBadAnchors=True) + except Exception as e: + print(f"Rebuilt {langDir} markdown does not match pretranslated markdown: {e}") + os.remove(langXliffPath) + continue + os.remove(rebuiltLangMdPath) + print(f"Successfully pretranslated {langDir}") + succeededLangs.add(langDir) + if len(skippedLangs) > 0: + print(f"Skipped {len(skippedLangs)} languages already pretranslated.") + print(f"Pretranslated {len(succeededLangs)} out of {len(allLangs) - len(skippedLangs)} languages.") + + +if __name__ == "__main__": + mainParser = argparse.ArgumentParser() + commandParser = mainParser.add_subparsers(title="commands", dest="command", required=True) + generateXliffParser = commandParser.add_parser("generateXliff") + generateXliffParser.add_argument( + "-m", + "--markdown", + dest="md", + type=str, + required=True, + help="The markdown file to generate the xliff file for", + ) + generateXliffParser.add_argument( + "-o", "--output", dest="output", type=str, required=True, help="The file to output the xliff file to" + ) + updateXliffParser = commandParser.add_parser("updateXliff") + updateXliffParser.add_argument( + "-x", "--xliff", dest="xliff", type=str, required=True, help="The original xliff file" + ) + updateXliffParser.add_argument( + "-m", "--newMarkdown", dest="md", type=str, required=True, help="The new markdown file" + ) + updateXliffParser.add_argument( + "-o", + "--output", + dest="output", + type=str, + required=True, + help="The file to output the updated xliff to", + ) + translateXliffParser = commandParser.add_parser("translateXliff") + translateXliffParser.add_argument( + "-x", "--xliff", dest="xliff", type=str, required=True, help="The xliff file to translate" + ) + translateXliffParser.add_argument( + "-l", "--lang", dest="lang", type=str, required=True, help="The language to translate to" + ) + translateXliffParser.add_argument( + "-p", + "--pretranslatedMarkdown", + dest="pretranslatedMd", + type=str, + required=True, + help="The pretranslated markdown file to use", + ) + translateXliffParser.add_argument( + "-o", + "--output", + dest="output", + type=str, + required=True, + help="The file to output the translated xliff file to", + ) + generateMarkdownParser = commandParser.add_parser("generateMarkdown") + generateMarkdownParser.add_argument( + "-x", + "--xliff", + dest="xliff", + type=str, + required=True, + help="The xliff file to generate the markdown file for", + ) + generateMarkdownParser.add_argument( + "-o", + "--output", + dest="output", + type=str, + required=True, + help="The file to output the markdown file to", + ) + generateMarkdownParser.add_argument( + "-u", + "--untranslated", + dest="translated", + action="store_false", + help="Generate the markdown file with the untranslated strings", + ) + ensureMarkdownFilesMatchParser = commandParser.add_parser("ensureMarkdownFilesMatch") + ensureMarkdownFilesMatchParser.add_argument( + dest="path1", + type=str, + help="The first markdown file", + ) + ensureMarkdownFilesMatchParser.add_argument( + dest="path2", + type=str, + help="The second markdown file", + ) + pretranslateLangsParser = commandParser.add_parser("pretranslateLangs") + pretranslateLangsParser.add_argument( + "-d", + "--langs-dir", + dest="langsDir", + type=str, + required=True, + help="The directory containing the language directories", + ) + pretranslateLangsParser.add_argument( + "-b", + "--md-base-name", + dest="mdBaseName", + type=str, + required=True, + help="The base name of the markdown files to pretranslate", + ) + args = mainParser.parse_args() + match args.command: + case "generateXliff": + generateXliff(mdPath=args.md, outputPath=args.output) + case "updateXliff": + updateXliff( + xliffPath=args.xliff, + mdPath=args.md, + outputPath=args.output, + ) + case "generateMarkdown": + generateMarkdown(xliffPath=args.xliff, outputPath=args.output, translated=args.translated) + case "translateXliff": + translateXliff( + xliffPath=args.xliff, + lang=args.lang, + pretranslatedMdPath=args.pretranslatedMd, + outputPath=args.output, + ) + case "pretranslateLangs": + pretranslateAllPossibleLanguages(langsDir=args.langsDir, mdBaseName=args.mdBaseName) + case "ensureMarkdownFilesMatch": + ensureMarkdownFilesMatch(path1=args.path1, path2=args.path2) + case _: + raise ValueError(f"Unknown command: {args.command}")