Welcome to NVDA Quick Dictionary addon, which will allow you to quickly get a dictionary article with the translation of a word or phrase into your chosen language by pressing a key combination. There are few basic keyboard shortcuts and they are all intuitive and convenient so you will remember them quickly.
Dictionary articles contain detailed information about a word, such as part of speech, gender, plural or singular, translation options, list of meanings, synonyms and detailed examples. Such information will be useful for people who are learning foreign languages, or seek to use in communication all the richness and diversity of their own language.
The add-on supports several online dictionary services. You can select the desired remote dictionary in the appropriate dialog box or by using keyboard shortcuts. Each available service has its own settings panel.
There are also advanced opportunities for working with profiles of the voice synthesizers. You can associate a voice synthesizer profile with a specific language, after that translations into this language will be automatically voiced by the selected synthesizer.
Below are all the features of the add-on and keyboard shortcuts to control them. By default all functions are called using two-layer commands. But for any of these methods you can always assign convenient for you keyboard shortcuts. You can do it in the NVDA "Preferences" -> "Input gestures..." dialog.
In order to get an article from the dictionary, you must first select the word you are interested in or copy it to the clipboard. Then just press NVDA+Y twice.
There is also another way to get a dictionary entry: pressing NVDA+Y once switches the keyboard to add-on control mode, then just use the D key.
Note: Before making a request to a remote service, the add-on must receive a word or phrase that interests the user. The sequence of actions that add-on performs each time before accessing the dictionary:
To access all the features of the add-on, you need to switch to add-on control mode, you can do this by pressing NVDA+Y once. You will hear a short low beep and will be able to use the other commands described below. When you press a key that is not used in the add-on, you will hear another signal notifying you of an erroneous command and the add-on control mode will be automatically turned off.
To determine the current source language and destination language, follow these steps:
This can be done quickly as follows:
You will hear a message that the languages have been swapped and the available information from the dictionary.
Note: Each time you swap languages, the add-on checks to see if a new pair of languages is available for translation in the remote dictionary. If there is no such language combination, you will hear a warning.
An article from the dictionary can also be displayed in a separate window as a formatted web page:
Note: In this window, you can use standard commands to navigate web page elements. To close the window just press Escape or Alt+F4.
Sometimes it is necessary to change the text before sending it for translation, or just enter the text yourself.
To do this, you can use the text pre-edit command - press the E key in the add-on control mode (NVDA+Y). A dialog box opens with a multi-line field for editing text. After editing, just press Ctrl+Enter or the corresponding button.
The following commands are also available in the edit field:
Note: If before calling the dialog for editing text, the text was previously selected or copied to the clipboard, then it will be placed in the editor field in this dialog.
This can be done by following the steps below:
You will then hear a message that the data has been successfully copied and the dictionary entry itself.
Note: If you haven't previously made any requests to the remote dictionary, you will hear a warning.
If option "Copy dictionary response to clipboard" in the add-on settings is enabled, the data will be automatically copied after each successful request.
Use the U key in add-on control mode to download from the online dictionary and save current list of available source and target languages.
After that you will hear a message about the status of the command.
There are several ways to select a remote dictionary to send queries from the add-on.
Note: Each online service has its own settings panel and all its parameters are stored separately.
By pressing Q in the add-on control mode, you can listen to the following data:
To change the add-on parameters you need to open the dialog box of its settings. This can be done this way: press NVDA+Y and then the key O.
The standard NVDA settings dialog with the open section of our add-on will appear on the screen.
You can also open this dialog via the NVDA menu: press NVDA+N, go to the "Tools" submenu, then "Quick Dictionary" and activate menu item "Options...".
When you open the add-on settings dialog, the NVDA cursor is immediately placed on the drop-down list of online service selection. You can select the service from the list and press Enter or Tab to go to the next parameter.
As mentioned above - each service has its own settings panel. Therefore, all subsequent parameters for each service may be different. Consider the most common of them.
In the list of source languages, use the up or down keys to select the desired language and press Tab to move to the selection of the target language.
Note:
After checking this box, the data received from the dictionary will be copied to the clipboard after each request.
After enabling this option, the add-on will try to retrieve the data a second time by swapping the source and target language if the dictionary query didn't return any results.
Note: If the reverse language combination isn't available, you will hear a warning each time.
After enabling this option, the add-on will not send requests directly to the remote dictionary, but will use an alternate intermediate server that forwards all requests further.
To use the remote dictionary service, it is recommended to get your own access token. By default, the add-on already uses a pre-registered access code. But the remote dictionary service used in the add-on imposes certain restrictions and query limits on each free user. Therefore, with the mass use of one access token - sooner or later it can be blocked. To avoid this, it is recommended to register your own access code and specify it in the add-on settings.
You will find a link to register below the field for entering the access token, by clicking on it, you will go to the appropriate web page.
Note: The registration link is displayed only when using the default access token. Once you enter your own access code in the settings, this link will be hidden. To restore the default access token, simply clear the field for entering it and click "OK". The default access code will be restored in the add-on configuration and you will see it the next time you open the settings dialog.
This add-on implements the ability to voice the received dictionary articles using associated and pre-configured voice synthesizers.
To take advantage of this feature, you must first create and save voice synthesizers profiles, and then associate these profiles with the languages in the add-on settings dialog.
After that, upon receipt of the translation, associated voice synthesizers will be automatically switched for each specified language.
To manage the profiles, you can use keyboard commands or the corresponding dialog box. To open a dialog with a list of voice synthesizers profiles - press NVDA+N, go to the "Tools" submenu, then - "Quick Dictionary" and activate the command "Voice synthesizers profiles..." or just press the P key in the add-on control mode (NVDA+Y).
You can create up to 9 configuration profiles for the various voice synthesizers available in NVDA.
To switch between profiles, use the number keys 1 to 9 in the add-on control mode.
For example, to create a profile number 5, follow these steps:
Note: You can also perform this and other operations in the dialog "Voice Synthesizers Profiles...".
To return to using the voice synthesizer that was set when NVDA started, press NVDA+Y, then press R. This will restore the default voice synthesizer and you will hear its name and the selected voice.
As mentioned earlier, you can switch between voice synthesizers profiles using the number keys in the add-on control mode.
If the profile already has previously saved voice synthesizer settings, the corresponding voice will be activated and you will hear a message with information about the number of the activated profile, the name of the synthesizer and the name of the voice. Otherwise, if the selected profile does not yet contain any data - a message will be displayed only about its number and the synthesizer will not switch.
Note: In either case, you can return to default voice using the R key in add-on control mode (NVDA+Y).
You can quickly return to the previous voice synthesizer by pressing the B key in the addon control mode.
To hear which profile is currently selected, use the G key in add-on control mode (NVDA+Y).
If the profile contains voice synthesizer settings, the name of the synthesizer and voice will be announced in addition to the number. Otherwise, you will only hear the active profile number.
To delete the voice synthesizer settings from the currently selected profile, use the Delete key in add-on control mode (NVDA+Y).
You will hear a message about the successful deletion of the profile with the specified number.
After each manipulation of the profile (create/update/delete) it is necessary to save changes using V key in the add-on control mode (NVDA+Y).
By pressing this key you will hear the message about successful saving of the changes.
You can open a dialog with a list of voice synthesizers profiles from the NVDA menu - press NVDA+N, go to the "Tools" submenu, then - "Quick Dictionary" and activate the item "Voice synthesizers profiles..." or just press the P key in add-on control mode.
For each profile in list specified its number, synthesizer name, voice name, and the language associated with that profile.
To activate a profile, go to it with up or down arrow keys and press Enter, or just press the number that corresponds to the profile number.
Other operations with voice synthesizers profiles are also available in the specified dialog. To perform one of the following actions - go to the corresponding button in the dialog or use the key indicated in brackets:
Note: By default, the associated language is set to "- Immutable language -". This means that switching to this synthesizer will not be performed. The process of changing the associated language for each profile will be described below.
To associate a profile with the desired language, follow these steps:
Note:
After making the above settings, the voice synthesizer of your choice will automatically turn on when you receive data from the dictionary. And after the announcement of the article, the previous synthesizer will turn on again.
Note: If for some reason switching to the previous voice synthesizer didn't happen - you can do it manually by pressing the B or R key in the add-on control mode.
You can see a list of all the commands used in the add-on as follows:
To open the add-on help - press NVDA+N, go to the "Tools" submenu, then - "Quick Dictionary" and activate the menu item "Help".
We are very grateful to everyone who made the effort to develop, translate and maintain this add-on:
Several good solutions from other developments were used in the Quick Dictionary add-on. Thanks to the authors of the following add-ons:
You may clone this repo to make alteration to NVDA Quick Dictionary.
These can be installed with pip: