URL: https://github.com/paulber19/NVDAExtensionGlobalPlugin.git
Preuzimanje:
Kompatibilnost:
Preveo: Nikola Jović
Prevod u toku
Ovaj dodatak dodaje globalne funkcije u NVDA:
In NVDA's "Preferences" sub-menu, the "NVDA global commands extension" sub-menu has been added which offers the following choices, depending on the case:
This configuration is saved in two ways depending on the functionality or option concerned:
NVDA offers the option "Save configuration on exiting" (see NVDA user manual) which allows to automatically save NVDA configuration when exiting or restarting NVDA. If this option is not checked, the configuration is only saved upon user action or upon modification of a parameter that requires restarting NVDA.
This add-on follows this mode of operation.
Some add-on setting changes require saving the configuration and restarting NVDA. In this case, the user is offered to save and immediately restart as NVDA does when there is a change of language.
When uninstalling the add-on, its configuration file is deleted and the add-on's configuration is cleared from all configuration profiles.
When uninstalling a feature, its configuration, if any, is completely deleted.
In the case of an update, installing the add-on offers the possibility of keeping (as far as possible) or not the previous configuration.
Using the "Reset configuration" submenu, it is possible to restore the configuration to the same state as when the add-on was first installed, including the one saved in the configuration profiles.
This allows you to start from scratch without having to uninstall and reinstall the add-on in case of possible problems.
The update of the add-on is, by default, automatically a short time after the start of NVDA (between 20 and 600 seconds) and a maximum of once per day. It is possible to disable this update by unchecking the option "automatically check for updates" of "Update" category in the add-on's settings. The version of the add-on can be:
By default, the stable version is updated with a stable version more recent (higher version number). But it is possible to update the stable version running with a development version of the next stable version. Just check the option "Update also update the stable release to the versions of development" located in the "Update" category of add-on's settings.
A development version is updated:
The button "Search for update" placed in the add-on's settings, menu item "Update", allows you to search immediately for an update.
The "View history" button, placed in this same category, allows you to display the history of the current version in the browser.
In the case of an automatic update and if a new version is detected, the "Update" dialog box is displayed to suggest:
In the case of an update to a stable version, the "What's new" button offers the possibility of opening, in the browser, the history of the add-on and thus being able to know the new features of the proposed version.
In this mode, the operation of the add-on is degraded.
Like NVDA, it is not possible to save configuration changes.
Some features are no longer available, such as:
The configuration of the "Voice profile switching" functionality having changed, it is deleted during an update from a version of the add-on older than 9.0. All selectors are released and the associated voice profiles are deleted.
The version history of this add-on is in the "changes.html" file
This add-on allows you to install or not install a particular feature. The installation status of each feature of the add-on is presented in the "features's installation" category of the "Settings" dialog.
This state can be:
By default, this add-on does not install all features.
In general, each script can be activated in two ways:
In NVDA's "Input gestures" dialog, the scripts provided by the add-on are placed in their own category.
The vast majority of scripts fall into the categories: "NVDA global commands extension", "Voice Profile Switching", "Configuration", "Tools" and Speech.
For scripts that can be started by an interpreter command, thiscommand is indicated after the description of the script.
Depending on the choice of installing a feature ("Install" or "Install without input gesture"), the input gestures provided by default are assigned or not to the scripts of this feature.
By default, the vast majority of scripts that can be started by the command interpreter are not assigned to any input gestures.
This is started using the "NVDA+j" input gesture. A beep is then audible.
It is then possible to activate the scripts of the functionalities using commands.Today, these commands cannot be changed.
The "h" command of the interpreter lists all the scripts of the installed functionalities accessible by a command of the interpreter. In this list, it is possible to launch the selected script by pressing the "Enter" key.
The "g" command of the interpreter opens the add-on's user guide.
The command interpreter stops either:
++ Prikazivanje ikonica na sistemskoj traci i prozora pokrenutih aplikacija ++ [hdr1] This feature is, by default, installed with input gestures.
It adds the following scripts:
These scripts are placed in the "NVDA global commands extension" category of the NVDA "Input gestures" dialog.
This script initially created by Yannick Maillot and Daniel Poiraud was installed using the independent add-on "ListIconesZoneNotification_v1.2.nvda-addon" which must therefore be uninstalled.
Its description is: "Shows the list of buttons on the System Tray "
It is started by the command "F11" of the command interpreter. It is the counterpart of the Jaws script "Insert + f11".
No input gesture is assigned to it by default.
It displays a dialog box which contains:
Navigation in the dialog box is by "Tab" or upper case + Tab "and in the list with the up and down arrows.
Pressing the "Esc" key closes the dialog box.
In the list of icons, pressing the "Enter" key triggers the pressing of the "Single left click" button.
The description of this script is: "Display the running application windows's list with opportunity to put one of them on the foreground or destroy it ".
It is the counterpart of the Jaws script "Insert + f10".
It is started by the command "F10" of the command interpreter.
No input gesture is assigned to it by default.
It displays a dialog box which contains:
Navigation in the dialog box is by "Tab" or upper case + Tab "and in the list with the up and down arrows.
In the list, it is possible to select by typing the beginning of the title of the desired window.
Pressing the "Esc" key closes the dialog box.
In the list, windows are marked as maximized or minimized.
Pressing the "Switch to" button or the "Enter" key when you are in the list of windows, closes the dialog box and brings the window of the selected application to the foreground, giving it the focus.
Pressing the "Destroy" button closes the window of the selected application and returns the focus to the updated list of application windows.
Pressing the "Destroy all" button closes all the windows and the dialog box.
The description of this script is: "Shows the list of buttons on the System Tray. Twice, Display the running application windows's list with opportunity to put one of ".
By default, the "NVDA + F11" input gesture is assigned to it.
No interpreter command is assigned to it.
A simple press of the "NVDA + F11" input gesture launches the "Display of the list of icons in the notification zone" script (see above).
Pressing twice launches the script "Displaying the list of windows of the applications launched" (see above).
This feature is by default, installed without input gesture.
It adds the following two scripts:
These scripts are stored in the "NVDA global commands extension" section of the NVDA "Input gestures" dialog.
This script is launched:
It displays the "Help for the composition of complex symbols" dialog box made up of:
We move in the dialog box by "Tab" or "Shift + Tab".
Pressing the "Esc" key closes the dialog box.
When you are in the list of categories, pressing the "Enter" or "Tab" key brings the focus to the list of symbols of the selected category.
These symbols are listed in the order of the "symbolCategories.dic" file (see below).
On the other hand, if you are in the list of symbols and a symbol is selected, pressing the "Enter" key causes the "Paste" button to be pressed.
Positioned on a symbol, pressing the "Space" key causes the symbol code to be vocalized in the form: decimal code followed by the spelled hexadecimal code. This can be useful if you want to manually compose the symbol by the Windows command "Alt + 0" followed by the decimal code dialed on the numeric keypad.
Pressing one of the three buttons closes the dialog box.
The "Manage your symbols" button presents the dialog box which offers the possibility of completing the basic categories of the add-on with your own symbols. This dialog box displays:
Empty or comment lines (starting with "#") are accepted.
These files are kept during an add-on update, even if the user asks not to keep their own settings. The installation of the add-on adds, for each language, the pronunciation of certain symbols found in the basic categories and which NVDA does not have. The" symbols-xx.dic "file in the userConfig folder is either created, be modified to add the new pronunciations.
This add-on stores the last 20 symbols dialed for the current configuration profile.
This script allows them to be displayed and to recompose a commonly used symbol. This avoids going to search for it in its category with the previous script.
This script is started by the command control+f4 "of the command interpreter. No input gesture is assigned to it by default.
It presents the same kind of dialog box as the previous script without the button to manage its own symbols.
The maximum number of last symbols can be configured with the option "Maximum number of last recorded compound symbols" placed in the "Advanced" category of the "Settings" dialog of the add-on.
This feature is installed by default without input gesture.
It installs, according to its state of installation, the following scripts:
And in any case, the scripts:
These scripts are stored in the "Tools" section of the NVDA "input gestures" dialog.
The description of this script is: "Speaks the filename of the active application along with the name of the currently loaded appModule python file. Pressing this key twice,speak the name and state of the current configuration profile".
By default, the "NVDA+ control +F1" input gesture is assigned to it.A single press of the input gesture triggers the basic NVDA script which announces the name of the application file and if there is one, the name of the loaded python appModule's name.
Pressing twice announces the name of the configuration profile and its status.
The description of this script is: "Announce the name and version number of the application under focus".
By default, the "NVDA + shift + f1" input gesture is assigned to it.
The input gesture triggers the announcement of the name and version number of the application placed under focus.
The description of this script is: "Display informations about the focused application".
It is started with the "a" command of the interpreter.
By default, No input gesture is assigned to it.
It displays the "NVDA global commands extension - Information" dialog box which presents the following information:
The description of this script is: "Announce the name and version number of the add-on activated for the application under focus".
By default, no input gesture is assigned to it, nor any interpreter command.
This feature is installed by default.
It concerns Mozilla Firefox, Microsoft Internet Explorer, Google Chrome, Microsoft Edge (partially) browsers and provides:
This add-on adds the following commands for the browse mode:
Except for the first four, these commands are not implemented in the Microsoft Edge browser.
Basically, the script integrated into NVDA and triggered by the "NVDA + f7" input gesture, allows you to display the "List of elements" dialog box presenting the list of certain elements found in a Web page. This add-on increases the number of item types that can be chosen and displayed in the title of the dialog,the selected type.
The list of these types becomes:
Basic types:
Types added by the add-on:
These types are presented as a list instead of a radio button (in the basic version).
A type can be reached by typing the first letter of its label.
At each change of type, the number of elements found is announced or if no element is found, the voice indication "no element" is broadcast.
A repeating beep sound is heard while searching for items.
The status "checked" or not checked "is signaled for the checked boxes.
The "edit" type gives the list of the document's edit zones, and each element is presented vocally as follows:
Likewise, each form field is presented vocally according to its type.
For Microsoft Internet Explorer, Microsoft Edge, Mozilla Firefox, GoogleChrome browsers, it is possible when the cursor is on a table cell of:
All of these scripts are stored in the "Table" category in the tree view of the NVDA "input gestures" dialog.
This add-on also moves NVDA base scripts that used to be under the "Miscellaneous" category into this category. Those are:
The input gesture "NVDA+a", (desktop computer) or "NVDA+shift+a" (laptop) typed in Mozilla FireFox, Microsoft Internet Explorer, Microsoft Edge or Gooble Chrome browsers, announces the address (URL) of the document. With a double press, this address is copied to the clipboard.
In browse mode, the search for the next or previous item stops at the end or the beginning of the document.
This add-on adds, as an option, the possibility of cyclically browsing the document, that is to say:
The passage through the beginning or the end of the document is signaled by a sound and a voice message.
The "Loop navigation" option in the "NVDA Add-ons" category of the add-on's "Settings" dialog allows you to enable or disable this operation.
This option is only shown if the "Extend virtual buffer functionality" feature is installed.
By default, this option is not checked. The basic operation of NVDA is retained.
This feature is installed by default.
The functions triggered by the shortcuts "control + v", "control + c", "control + x", "control + z" are not vocalized by NVDA, this add-on takes care of them.
No check on the result of the function is made.
But for the "control + c", "control + x" shortcuts, the absence of text selection is indicated in the trees and the lists.
If the fakeClipboardAnnouncement add-on is installed (which performs the same function), it must be uninstalled.
This feature is installed by default without input gesture.
It adds, for the dialog boxes of the style "Open", "Save", "Save as", "Find in",scripts which allow to know the name and the path of the folder which is selected to define the location where the file will be searched where to save.
These scripts are placed in the "NVDA global commands extension" category of the NVDA "input gestures" dialog. Those are:
No input gesture is associated with the last two scripts, but it is possible to associate one to them using NVDA's "input gesture" dialog.
Please note, these scripts only work in dialog boxes conforming to the Windows standard.
This feature is by default, installed without input gesture.
It adds the scripts:
These Scripts are stored in the "Tools" category of the NVDA "input gestures" dialog.
The description of this script is: "Open a dialog to manage NVDA logs".
It is started using the "j" command of the interpreter. No input gesture is assigned to it by default.
This script displays the "NVDA Log Management" dialog box showing:
The log opens in the program associated with the .log add-on. If there is not yet the association of a program with this add-on, you will have to define it (choose the notepad for example).
The description of this script is: "Open current NVDA log file. Pressing this key twice, open the old NVDA log file. Pressing third, copy current log path to the clipboard".
It is launched using the "NVDA+shift+j" input gesture which is assigned to it by default.
A simple press triggers the opening of the current NVDA log.
A double press opening the old log.
A triple press, copying the path of the current log to the clipboard.
The log opens in the program associated with the .log add-on. If there is not yet the association of a program with this add-on, you will have to define it (choose the notepad for example).
This feature is installed by default without input gesture. In order to be able to listen to voice announcements that are poorly understood or heard badly, this add-on records a limited history of speech strings sent to the synthesizer. The number of records is limited to 200.
To listen to these recordings again, the following scripts, placed in the "Speech" category of the NVDA "input gestures" dialog, are provided by this functionality:
This script is started using the input gesture, "NVDA+control+f8" assigned by default.
The input gesture triggers the announcement of the previous recording compared to the last announced recording and copy it to the clipboard.
This script is launched using the input gesture, "NVDA+control+f10" assigned by default.
The input gesture triggers the announcement of the next recording compared to the last announced recording and copy it to the clipboard
The description of this script is: "Report current record of the speech history and copy it to clipboard. Twice: display speech history".
This script is started using "NVDA+control+f9" input gesture assigned by default.
A simple press triggers the announcement of the last recorded recording and its copy to the clipboard
A double press, displays the entire history.
The description of this script is: "display speech history records".
This script is started using the "f9" command of the interpreter. No control gesture is assigned to it by default.
It presents the "Speech history" dialog box which lists these recordings in descending order of their age. A button is used to copy the selected recording to the clipboard.
By default:
This feature is installed by default.
It allows you to rename certain keyboard keys as "Caps lock" or "Numeric lock" using a dialog box which presents:
When a replacement label is defined for the selected key, the read-only edit box, reachable by "Tab", displays this replacement label. This label is announced when the key is focused.
The "Delete" button allows you to delete this replacement label.
It is also possible to delete this label by entering an empty or full string in the input box.
The "Delete all" button allows you to delete all the replacement labels to return to the basic labels provided by NVDA.
The "OK" button is used to apply the overrides and to save the keyboard keys and their replacement label in the add-on configuration file in the "RedefinedKeyLabels" section and the corresponding NVDA language subsection (" fr "for example for French). It is thus possible to have key renames for different languages.
To display this dialog, three possibilities:
It is possible to not install this feature by selecting, in the "Installed features" category and for the "Keyboard keys renaming" feature, the "Do not install" status.
This feature is installed by default.
NVDA allows the command keys to be spoken by voice using the "Speek command keys" option located in the "Keyboard" category of the NVDA "Settings" dialog or by the "NVDA + 4" input gesture.
This functionality provides, by configuration and using a dialog box, the possibility of:
To display this dialog, three possibilities:
The dialogue presents:
Pressing the space bar checks or unchecks the selected key or combination.
If the "Speek command keys" box in the dialog box is not checked, checking a key will cause that key to announce anyway when NVDA is configured not to announce them.
The list of modifier key combinations is then accessible and all the elements in this list are checked by default.
To prevent the key typed with a particular combination from being announced, it suffices to uncheck this combination.
If the "none" item in the combination list is checked, the key will be announced even when pressed without a modifier key combination.
On the other hand, if the "Speek command keys" check box is checked, checking a key prevents this key from being announced when NVDA is configured to announce them.
The list of modifier key combinations is then accessible and all the elements of this list are checked by default. This means that the key typed with or without a combination will not be announced.
The action of unchecking a combination then makes it possible to announce the key with this combination.
The "none" element in the list of combinations makes it possible not to have the same key announced without a combination of modifier keys.
The "Uncheck all" and "Check all" buttons allow you to uncheck or check all the elements in the list of modifier key combinations.
The first item "any key with modifier key combination" in the list of keys allows, without designating a particular key, to select a set of modifier key combinations. Any key typed with one of these combinations will be announced or not, depending on the configuration mode chosen.
The "OK" button saves the choices made for the current configuration profile, while the "Cancel" button forgets them.
In the lists, the "F2" key and the "shift + F2" key combination allow you to move respectively to the next or previous checked item.
It is possible to not install this functionality by selecting, in the "Installed functionalities" category and for the "Selective announcement of command keys" functionality, the "Do not install" status.
This feature is installed by default.
It allows you to start a timer for a programmable duration.
When the timer expires, a dialog box appears displaying a programmable announcement and the emission of a ringtone.
It installs a script which starts:
If the timer is stopped, the script displays the "Launch timer" dialog box which presents:
The duration, the announcement and the time to be warned before the timer expires are recorded each time the timer is started and displayed by default the next time the timer is started.
If the timer is in progress, the script then displays the "Timer in progress" dialog box allowing you to know the remaining duration of the timer and possibly to stop the timer.
The duration is refreshed every 5 seconds and is announced when the focus is in the edit zone (read-only) displaying it.
This dialog box closes automatically when the timer expires.
This feature is not installed by default.
It installs a script that allows restarting NVDA in debug logging level without modifying NVDA configuration.
The description of this script is: "Restart NVDA. Twice: restart with log levelset to debug".
It is placed in the "Miscellaneous" category of the NVDA "input gestures" dialog.
The "NVDA+control+f4" input gesture is assigned to it by default.
A simple press of this gesture triggers a restart of NVDA with the logging level configured in the general preferences.
Double pressing of this input gesture restarts NVDA with the debug logging level without changing the logging level configured in NVDA general preferences.
By default, this feature is installed with input gesture.
It installs two scripts stored in the "System focus" category of the NVDA "input gestures" dialog:
The description of this script is: "Display the list's visible items making up current foreground object".
It is started using the "b" command of the interpreter.
No input gesture is attributed to it.
The script starts searching for these items. This can take a long time. An audible signal every two seconds is emitted during this search.
To limit this search time, limits are put in place for certain types of elements:
When the search is complete, the elements are displayed in the "List of visible elements making up the foreground object" dialog box, according to their type.
This dialog box presents:
In the list of elements, it is possible to change the type of objects to list without leaving the list:
Also in this list, it is possible to reach an element by typing the first letters of its label.
For an element of type:
The description of this script is: "Reads all controls in the active window. If pressed twice: display the list's visible items making up it".
It is launched using the "NVDA+b" input gesture which is assigned to it by default.
A single press launches the basic NVDA script which announces all objects of the object in the foreground.
Pressing twice launches the previous script "Display of visible elements of the object in the foreground".
This feature is installed by default without input gesture.
It allows you to quickly change voice profile by giving the possibility of memorizing up to 8 voice profiles and quickly selecting one of these voice profiles.
A voice profile is defined by:
It installs the following scripts under the "Voice Profile Switching" category of the NVDA "input gestures" dialog:
The description of this script is: "Display dialog to manage voice profile selectors".
It can be activated by:
This script displays the " Voice profile selectors's management of the ProfileName configuration profile" dialog box (where ProfileName is the name of the triggered configuration profile).
This dialog box is used to manage the selector-voice profile association and presents:
The "Selectors" list shows the list of free selectors or those associated with a voice profile. The associated selectors are:
When the selector is indicated as "free", the "Associate voice profile" button allows you to associate the current voice profile with this selector. This button brings up a dialog box allowing you to give a name to this voice profile. A default name is proposed. The "Default" button allows you to return to this proposal.
When a selector is already associated with a voice profile, it is then possible:
If the selected selector is an associated selector under the normal configuration profile, then it is not possible to release it, but it can be associated with the current profile.
Only the selectors associated under the current configuration profile can be released.
To quickly change voice profile, the "Voice profile switching" mode is set up.
To activate or deactivate this mode, the "p" command of the interpreter must be typed.
This mode activated,the right or left arrows are used to move to the first next or previous selector associated with a voice profile and thus define the voice profile associated with this selector as the current voice profile.
The selectors taken into account are the selectors from the "Selectors" list which are associated with a voice profile.
To quickly change voice profile, the "Voice profile switching" mode is set up and a script is used to activate or deactivate it.
The description of this script is: "Activate or deactivate Voice profile switching mode".
To run this script, two possibilities:
When this mode is activated, the right or left arrows are used to move to the first next or previous selector associated with a voice profile and thus define the voice profile associated with this selector as the current voice profile.
The selectors taken into account are the selectors from the "Selectors" list which are associated with a voice profile.
The description of this script is: "Go backward to the first selector associated to a voice profile and set this voice profile as current voice profile".
It is launched using the "nvda+shift+control+left arrow" input gesture which is assigned to it by default.
The script searches for, in the "Selectors" list, the first selector preceding the current selector associated with a voice profile. Then he positions this voice profile as the current voice profile.
The description of this script is: "Go to forward to the first selector associated to a voice profile and set this voice profile as current voice profile".
It is launched using the "nvda+shift+control+right arrow" input gesture which is assigned to it by default.
The script searches for, in the "Selectors" list, the first voice profile selector following the current selector associated with a voice profile. Then he positions this voice profile as the current voice profile.
8 scripts are installed. The description of these scripts is: "Set selector x as current selector and Sets , if possible, it associated voice profile as current voice profile" (where x is the number of the selector).
Each script is launched using the "nvda+shift+control+ selector number" input gesture assigned by default.
The script selects the selector x and if it is associated with a voice profile, positions this voice profile as the current voice profile.
The following 3 scripts allow you to know the current speech settings without having to use the "Speech" NVDA menu.
They are stored in the "Speech" category of the "Input Gestures" NVDA dialog and are installed even if the "Voice Profile Switching" feature is not installed.
No input gesture is associated with them, but it is possible to assign one to each.
Their descriptions are:
They are checked by default.
During this time delay, any further press on one of these keys restarts the time delay and this new key is also memorized, but no beep is emitted.
Pressing any other key on the keyboard executes the input gesture made up of the combination of all the keys memorized with this last key.
Each time this last key is pressed again during the timeout, the input gesture will be executed again.
If this key is typed out of time, it is executed alone and the memorized keys are forgotten.
Warning: You have to wait for the end of afterglow to have any new key treated individually. For example: "Alt" to display a menu then expand the menu items.
It is however possible to stop the remanence before the end of the time delay, by re-entering the last key in remanence.
This remanence is specifically set up for the gmail.com site and is only active in the "https://mail.google.com/mail/#i" page.
It is not active by default. A checkbox "Special remanence for Gmail.com" is provided in the "Keystroke persistence" grouping.
In this page, it is possible to type shortcuts to launch commands but some of them chain two letters. In particular, the letters "g", "h", "*" must be followed by another letter. This sequence must be fast enough to trigger the execution of the associated command. This is problematic for people who do not have sufficient dexterity.
The objective of this remanence is therefore to retain the first letter while waiting for the second to be struck.
When the first letter is struck, a time delay is started (a dull beep is heard) and the letter is stored.
Typing the second letter within the configured remanence delay will send both letters to the browser and the timeout is stopped.If no new letter is entered, the first letter is sent to the browser at the end of the time-out (a high-pitched beep is audible).
In order for NVDA to send the letters to the browser, it is necessary to switch to form mode first.
This feature cannot be uninstalled.
It installs a script whose description is: "Display dialog to shut down, reboot or hibernate the computer".
It is started using the "r" command of the interpreter. This script displays a dialog consisting of the following elements:
This feature also installs scripts corresponding to the functions of the three buttons.
All scripts are placed in the "NVDA global commands extension" category of the NVDA "input gestures" dialog, but no gestures are assigned to them.
This feature cannot be uninstalled.
Basically, NVDA allows you to add or remove input gestures using the "Input gestures" dialog. But there is no way to know which gestures are added or removed by the user.
This is what this functionality wants to meet.
To do this, it adds the script whose description is "Displays the dialog to manage the input gestures configured by user" and placed in the "NVDA global commands extension" category of the "input gestures" dialog of NVDA.
It is started using the "u" command of the interpreter. No control gesture is assigned to it by default.
This script displays an NVDA "input gestures" style dialog by selecting only the input gestures deleted or modified by the user.
The dialogue presents:
input gestures removed from a category are shown with the description: "input gestures removed".
As it is not possible to know the category and description of a deleted input gesture or of an added input gesture associated with a script of an add-on that is not activated or not installed at the time of the display of the dialogue, this gesture is presented like this:
As for the classic "input gestures" dialog, it is only by pressing the "OK" button that all gesture deletions will be taken into account.
Cancellation of all changes using the "Delete all" button is subject to confirmation. Upon acceptance, all changes are canceled and the dialogue closes.
By default, this feature is installed without input gesture.
It can only work under Windows 10 operating system.
If it is installed with or without a input gesture, it places the "Volume control" grouping in the "Computer" category of the "Settings" add-on dialog.
It installs the following scripts stored under the "Volume control" category in the "input gestures" NVDA dialog:
This script is launched:
It sets the main and NVDA volume and forces the levels of each to the values of the recovery levels configured in the "Volume control" grouping of the "Computer" category of add-on settings.
This script is launched:
This command mutes the volume of the audio stream of the focused application if it is established or restores it if it is muted.
These scripts are used to increase, decrease or fix the volume of the audio stream of the focused application.
They are installed without input gestures. But it is still possible to assign them with the "input gestures" dialog.
They are started using the following interpreter commands:
These commands, unlike the other interpreter commands, can be repeated without having to restart the interpreter. The interpreter is always active. Once the volume level is reached, press the "Escape" key to exit the interpreter.
The increase or decrease in volume is done in steps.It is possible to adjust the size of these steps in the parameters of the add-on under the "Computer" category, "Volume control" grouping, by choosing the size of the step.
Size 1 is the smallest step, size 20 is the largest step. The size is set to 5 by default.
However, it should be understood that this pitch corresponds to a percentage increase or decrease in relation to the main volume.
So if the main volume is 100, the increase in application volume with a step of 5 will be 5 steps in the level of the Windows mixer.
Whereas if the main volume volume is 60, a step of 5 will increase the application volume by 3 steps.
The app volume level cannot exceed the master volume level.
These scripts allow to increase, decrease, or fix the main volume.
They are installed without input gestures. But it is still possible to assign them with the "input gestures" dialog.
They are started using the following interpreter commands:
These commands, unlike the other interpreter commands, can be repeated without having to restart the interpreter. The interpreter is always active.
Once the volume level is reached, press the "Escape" key to exit the interpreter.
The increase or decrease in volume is done in steps. It is possible to adjust the size of these steps in the settings of the add-on under the "Computer" category, grouping "Sound control", by choosing the size of the step. Size 1 is the smallest step, size 20 is the largest step. By default, the size is set to 5, which corresponds to 5 steps of varying the volume in the Windows mixer.
The primary volume cannot fall below the configured recovery threshold.
When using the preceding commands, the volume level is recorded before the execution of each command, for the main volume and for each application.
To return to this level, the following commands are available:
The previous level is also saved when these commands are executed.
These records are not kept when restarting NVDA.
Volume level changes are announced by default.But it is possible to deactivate this announcement using the "Report volume changes" option in the "Volume change" grouping of the "Computer" category.
For the volume of applications, this can be said:
The choice is made using the "Announce application volume level in percent" option in the "Volume change" grouping in the "Computer" category.
This function is used to restore, when loading this extension, the main volume and that of NVDA and to set the level of each volume to a value defined by configuration if it is lower than the minimum threshold defined by configuration.
For this, the "Sound control" group of the "Computer" category of the "Parameters" dialog of the extension, presents the following configuration elements:
When launched, this extension verifies that the primary volume and the NVDA volume are above the recovery threshold configured for each.
If this is not the case, this extension then fixes the volume level to the value of the level to restore configured.
When installing this extension, the current levels of the main volume and NVDA are taken into account when setting the values for the levels to be restored.
These scripts allow you to do, with the right or left mouse button, a single or a double click at the current position of the navigator object.
They actually chain two types of NVDA scripts:
The input gestures of these scripts are:
These input gestures can be changed and can be found in the "Mouse" category of the NVDA "input gestures" dialog.
This feature is installed by default without input gesture.
Warning: installed with a input gesture, this functionality may conflict with the "Clock" add-on because the "nvda + f12" input gesture is common.
This feature brings:
The description of this script is: "Copy date and time to clipboard". This script is stored in the "System Status" category of the NVDA "input gestures" dialog.
It is started using the "c" command of the interpreter. No input gesture is attributed to it.
As its description indicates, it allows you to copy the date and time to the clipboard.
The extension installs a script whose description is: "Reports the current time. Twice, reports the current date. Third: copy date and time to the clipboard".
This script is stored in the "System status" category of the "input gestures" NVDA dialog.
No interpreter command is associated with it.
If the extension's install status is "Install", this script replaces the NVDA script and is started using the "NVDA + f12" command gesture.
Otherwise no command gesture is assigned to it, but it is still possible to assign it using the NVDA "Command gestures" dialog.
This script allows:
It also brings:
The basic command gesture "NVDA + f12" gives the time with a simple press, but the time is not announced in the same way depending on the Level of punctuation and symbols selected in the voice parameters.
This script corrects this small flaw by announcing the time with the Level of punctuation and symbols forced to "None" without modifying the level defined in the "Speech" category's parameters.
By default, NVDA's command gesture "nvda + f12" announces the time without the seconds.
This script offers the possibility of announcing the time in seconds.
All you have to do is check the "Report windows clock's time with seconds" checkbox in the "Computer" category of the add-on's Settings dialog. This option is not checked by default.
This option is not present if the installation status of the feature is "Do not install".
To compensate for the absence of the "Applications" key on some computers and not knowing whether the "upper case + f10" shortcut fulfills the same function, the add-on installs a script without a input gesture in the "Emulated keys of the keyboard" category system "with the description"Emulate key press: applications".
To use it, all you need to do is assign it a input gesture or a keyboard key that is rarely used, such as the "print screen" key, the "Pause" key.
The add-on installs a script to close all open windows.
This script is placed in the add-on scripts category and under the description "Close all opened windows".
It is started with the command "k" from the command interpreter. No control gesture is assigned to it by default.
The add-on manager displays the list of installed add-on and their status: activated or deactivated.
But even though it is enabled, an add-on may not be loaded by NVDA. Usually the NVDA log reports this, but nothing in the Extensions Manager.
It can be interesting at some point to know which add-on are actually running.
To do this, the add-on installs a script under the description "Display running add-ons list" in the category of add-on in the "input gestures" dialog.
This script is started with the "e" command of the command interpreter. No control gesture is assigned to it.
add-on are listed by type:
This feature is not installed by default.
It installs the script whose description is "Display tools for add-on development dialog".
This script is stored in the "Tools" category of the NVDA "input gestures" dialog.
This script is started using the "t" command of the interpreter. No control gesture is assigned to it.
Activating this script brings up a dialog presenting:
To package an add-on (create the add-on installation file), we recommend that you use the "nvda adon scons template". This model uses a "buildVars.py" file which defines, for an add-on, all the necessary information such as: its internal name, its version, its name and its description to be translated into each language supported by it. This model is also used to allow the translation of add-on strings with the translation system set up by the "NVDA-addon.org" community.
The objective of this model is, when an add-on has been developed, by a simple command and after having informed the "buildVars.py" file of:
When we create an add-on, there is nothing. You must create the "manifest.ini" file yourself, possibly the localization "manifest.ini" file and the documentation file.The objective of these tools is placed in this condition and is:
The first step is to create the "buildVars.py" file from the information in the "manifest.ini" file that we created for the development of the add-on.
The "Create the buildVars.py file" button starts this operation.
It is only this file that we will then modify to update the "manifest.ini" file (change of version or description for example).
To be used with the "adon scons template", it will have to be completed by filling in the information which is not found in the "manifest.ini" file.
The "Update add-on version" button allows you to modify the version defined in the buildVars.py file of the selected add-on.
It presents a dialog box containing an edit zone initialized with the current version of the file.
Pressing the "OK" button saves the new version in the file.
The "manifest.ini" file must be updated as soon as the "buildVars.py" file is modified.
Use the "Update manifest.ini file" button for this.
Any modification of the "addon_summary" or "addon_description" information of the "buildVars.py" file requires the translation of this description into each language supported by the extension (taken into account in the nvda.po file and compilation of this file) .
In order for the add-ons' Manager to present this information to the user for the language chosen for NVDA, you must create or update the localization "manifest.ini" file for that language.
The button "Create the localization manifest.ini file" allows this. It is possible to update the file for the selected language or for all languages.
Add-oon documentation files can be either in "markdown" (. Md) or "txt2tags" (.t2t) format.
To be presented to the user in a browser, these files must be converted to HTML.
This is possible simply using the "Create HTML documentation files" button after selecting the add-on in the list of add-ons and choosing a language or all the languages in the list of languages.
Opened in the browser, these HTML files need style files (style.css for Markdown files and style_t2t.css for txt2tags files) placed in the add-on's "doc" folder.
The "Create POT file" button is used to create the catalog file for the selected add-on.
Once created, this file is placed in the add-on's "locale\en" folder and is named "version-name.pot" where "name" is the name of the extension and "version" is its version.
The "Prepare add-on" button launches, for the selected add-on, the execution of the following actions:
+++ Exploration of the add-on +++ folder The "Explore add-on folder" button opens Windows Explorer in the selected add-on folder.
In Windows ribbons, NVDA is too chatty unnecessarily. By default, this add-on prevents the advertisement of the description which seems quite unnecessary.
But this can be disabled using the "No object description inWindows ribbons" option found in the "Computer" category of the "add-on settings" dialog.
A restart of NVDA will then be necessary for the option to be taken into account.
In some applications such as WordPad, Microsoft Word, it is possible to delete the following word with the command "control + Del", but versions of NVDA prior to 2020.3 do not pronounce the word following the cursor position after the deletion.
By default, this add-on allows these versions of NVDA to speak this word.
For these versions, this can be prevented by unchecking the "Report next word on deletion" option from the "NVDA enhancement" category of the add-on's "Settings" dialog.
This option automatically maximizes windows that are brought to the foreground.
By default, it is enabled.
You can deactivate it by unchecking the option "Automatically maximize windows " in the "Computer" category of the "Settings" dialog of the add-on.
NVDA allows you to move word by word in documents using the "control + right arrow" and "control + left arrow" keyboard commands.
The symbols and punctuation marks are then said according to the level of punctuation and symbols configured for the current configuration profile.
This option allows you to configure the level of symbols and punctuation that will be used only when moving by word.
This choice is saved for the current configuration profile.It is configured in the "NVDA enhancement" category of the add-on's "Settings" dialog and named "Punctuation/symbol level on word movement".
It is only present if the "Announcement of the function associated with the" copy "," Paste "style editing commands is installed.
It is presented in the form of a combobox which allows you to choose:
Experienced users may have noticed that when using a development version of NVDA (snapshot master or next version), any error entered in the NVDA log is signaled with a sound. But with final versions or candidate releases, this signal is not emitted.
This option offers the choice between:
To make this choice, all you have to do is select the option in the combobox list named "Play sound on logged errors" in the "Advanced" category of the "Settings" dialog of the add-on. By default, the option "Only for development versions" is selected.
This option allows you to title or not the dialog boxes of this add-on with its name. It can be found in the "Advanced" category of the "Settings" dialog.
By default, this option is checked and the title of the boxes is in the form: "NVDA global commands extension - NVDA - dialog title".
Some scripts in this add-on perform different actions depending on the number of times the input gesture associated with the script is dialed. The repetition of the control gesture must be done within a short time (500 ms by default).
For a script performing three different actions, the mechanism is:
Depending on the user's dexterity or the hardware configuration, this timeout may be too long or too short.
The option entitled "Delay between repeat of same gesture" in the "Advanced" category of the "Settings" dialog of the add-on allows you to adjust this timeout as needed.
By default, NVDA uses certain keys on the numeric keypad, such as the arrow keys, the "multiply", "divide" keys, and the "plus" key, to activate scripts.
The objective is to restore to each key of the numeric keypad, temporarily or permanently, its normal functioning, composed alone or with a modification key such as "control", "Alt", "capital" (The "NVDA" key is excluded).
These keys are:
To enable or disable the use of the numeric keypad in standard operation and if the option "allow the standard use of the numeric keypad" in the "Numeric keypad" grouping of the "Keyboard" category is checked, the add-on offers:
The "Enable the standard use of the numeric keypad at NVDA's start" option ("Numeric keypad" grouping, " Keyboard " category), allows, if it is checked, to use the numeric keypad as standard from the start of NVDA , but the option that allows standard use of the numeric keypad must also be checked.
This add-on adds in the "tools" menu of NVDA a sub-menu "Explore NVDA" which offers two choice items:
Two scripts, placed in the "NVDA global commands extension" category of the NVDA "input gestures" dialog, are provided to perform these same actions and with the following descriptions:
By default, no input gesture is associated with them.
Basically, a double press of the "NVDA + f" input gesture presents the formatting information in the form of an HTML document.
This script aims to complete them and display them instead in a dialog box so that they can be read using the arrows keys.
It is started using the "f" command of the interpreter.
The description of the script is: "Display formatting info for the current review cursor position within a document in dialog box".
It is stored under the "NVDA global commands extension" heading of the "NVDA input gestures" dialog.
No input gesture is assigned to it by default.
NVDA considers some dialog boxes, such as confirmation dialogs, that the text they contain is a description.
So if the "Announce object description" option in the "Object overview" category of the NVDA "Settings" dialog is not checked, the text is not announced by NVDA.
This add-on implements the "Do not take account of the option called Report object descriptions during the display of the dialog box style confirmation" option in the "Advanced" category of the "Settings" dialog of the add-on to force, if checked, the announcement of the text of these boxes in all cases. This option is checked by default.
Name | Desktop computer | Laptop | Touch | Description |
NVDA+j | NVDA+j | None | Start the add-on command interpreter |
Order | Description |
a | Display informations about the focused application |
b | Display the list's visible items making up current foreground object |
c | Copy date and time to the clipboard |
e | Display running add-ons list |
f | Display formatting info for the current review cursor position within a document in dialog box |
f1 | Display add-on settings dialog |
f2 | Display keyboard key renaming dialog |
f3 | Display command key selective announcement dialog |
f4 | Allow you to copy or type complex symbol |
control+f4 | Display the list of last used symbols |
f5 | Enable or disable the standard use of numeric keypad |
f9 | display speech history records |
F10 | Display the running application windows's list with opportunity to put one of them on the foreground or destroy it |
F11 | Shows the list of buttons on the System Tray |
f12 | Display dialog to start the minute timer.If minute timer already started, display dialog to report duration |
k | Close all opened windows |
g | Display add-on user's guide |
h | Display the commands of the commands interpreter |
j | Open a dialog to manage NVDA logs |
o | report the name of current selected folder in the open or Save dialog box |
p | Toggle voice profile switch mode |
r | Display dialog to shut down, reboot or hibernate the computer |
s | Toggle current focused application volume mute |
control+s | Set on main and NVDA volume |
t | Display tools for add-on development dialog |
u | Displays the dialog to manage the input gestures configured by user |
v | Display dialog to manage voice profile selectors |
v | Display the dialog to manage the voice profile selectors |
z | Report current speech settings |
control+z | Display current speech settings |
up arrow | Increase the volume of the application under focus |
control+up arrow | Increase master volume |
down arrow | Decrease the volume of the application under focus |
control+down arrow | Decrease the main volume |
page up | Maximize the volume of the application under focus |
control+page up | Maximize the main volume |
page down | Minimize the volume of the application under focus |
control+page down | Minimize the main volume |
backspace | Set the volume of the application under focus to the previous level |
control+backspace | Set main volume to previous level |
number from 1 to 9 | Set the volume of the application under focus to x percent of the main volume (x equal to 10 multiplied by the number) |
control + number from 1 to 9 | Set to x the main volume (x equal to 10 multiplied by the figure) |
Name | Desktop computer | Laptop | Touch | Description |
List of icons and active windows | NVDA + F11 | NVDA + F11 | None | Shows the list of buttons on the System Tray. Twice, Display the running application windows's list with opportunity to put one of them on the foreground or destroy it |
Name | Desktop computer | Laptop | Touch | Description |
Help with the composition of complex Symbols | NVDA + shift + f4 | NVDA + shift + f4 | None | Allow you to copy or type complex symbol |
Name | Desktop computer | Laptop | Touch | Description |
Report the Name and Version of the focused application | NVDA + shift + f1 | NVDA + shift + f1 | None | Report the application 's name and version |
Report Configuration Profile | NVDA+ control +F1 | NVDA+ control +F1 | None | Speaks the filename of the active application along with the name of the currently loaded appModule python file. Pressing this key twice,speak the name and state of the current configuration profile |
Desktop computer | Laptop | Touch | Description |
NVDA+alt+j | NVDA+alt+j | none | Report current table row's cells |
NVDA+alt+l | NVDA+alt+l | none | Report current table column's cells |
NVDA+alt+down arrow | NVDA+alt+down arrow | none | Move to and report next table row |
NVDA+up arrow | NVDA+up arrow | none | Move to and report previous table row |
NVDA+alt+right arrow | NVDA+alt+right arrow | none | Move to and report next table column |
NVDA+alt+left arrow | NVDA+alt+left arrow | none | Move to and report previous table column |
NVDA+alt+numpad5 | NVDA+alt+; | none | Report current table cell position |
control+alt+shift+left arrow | control+alt+shift+left arrow | none | Move to first cell of table row |
control+alt+shift+right arrow | control+alt+shift+right arrow | none | Move to last cell of table row |
control+alt+shift+up arrow | control+alt+shift+up arrow | none | Move to first cell of table column |
control+alt+shift+down arrow | control+alt+shift+down arrow | none | Move to last cell of table column |
NVDA+a | NVDA+shift+a | none | Report document 's address (URL). Twice: copy it to clipboard |
Name | Desktop computer | Laptop | Touch | Description |
Announce the preselected Folder | NVDA+o | NVDA+o | None | report the name of current selected folder in the open or Save dialog box. Twice: report full path |
Name | Desktop computer | Laptop | Touch | Description |
Open Journal | NVDA+shift+j | NVDA+shift+j | None | Open current NVDA log file. Pressing this key twice, open the old NVDA log file. Pressing third, copy current log path to the clipboard |
Name | Desktop computer | Laptop | Touch | Description |
Report the previous record | NVDA+control+f8 | NVDA+control+f8 | None | Report previous record of the speech history and copy it to clipboard |
Report the next record | NVDA+control+f10 | NVDA+control+f10 | None | Report next record of the speech history and copy it to clipboard |
Report current record | NVDA+control+f9 | NVDA+control+f9 | None | Report current record of the speech history and copy it to clipboard. Twice: display speech history |
Name | Desktop computer | Laptop | Touch | Description |
Timer | NVDA+shift+f12 | NVDA+shift+f12 | None | Display dialog to start the minute timer.If minute timer already started, display dialog to report duration |
Name | Desktop computer | Laptop | Touch | Description |
Restarting NVDA | NVDA+control+f4 | NVDA+control+f4 | None | Restart NVDA. Twice: restart with log levelset to debug |
Name | Desktop computer | Laptop | Touch | Description |
Display of objects | NVDA+b | NVDA+b | None | Reads all controls in the active window. If pressed twice: display the list's visible items making up it |
Name | Desktop computer | Laptop | Touch | Description |
Choosing the selector | nvda+shift+control+ selector number | nvda+shift+control+ selector number | None | Set selector x as current selector and Sets , if possible, it associated voice profile as current voice profile (x equals number 1 to 8) |
Next voice profile | nvda+shift+control+right arrow | nvda+shift+control+right arrow | None | Go to forward to the first selector associated to a voice profile and set this voice profile as current voice profile |
Previous voice profile | nvda+shift+control+left arrow | nvda+shift+control+left arrow | None | Go backward to the first selector associated to a voice profile and set this voice profile as current voice profile |
Voice profile management | nvda+shift+control+m | nvda+shift+control+m | None | Display dialog to manage voice profile selectors (command: v) |
Activation / deactivation of voice profile switching mode | nvda+majuscule+control+p | nvda+majuscule+control+p | none | Activate or deactivate Voice profile switching mode |
Name | Desktop computer | Laptop | Touch | Description |
Date and time | NVDA + F12 | NVDA + F12 | none | Reports the current time. Twice, reports the current date. Third: copy date and time to the clipboard |