This add-on provides users with contextual information, fitting a wide variety of use cases. With a single keypress, it can give you the meaning of a word, geolocate an IP address, and tell you about a book (via ISBN). Simply select something, use your assigned keystroke, and wait.
Currently, the following features are supported:
- IP address information. Includes geolocation, ISP, VPN/tor exit node and cellular network identification.
- english dictionary definitions, part of speech, example sentences, synonyms, antonyms, etc. Definitions come from either the Free Dictionary API or Wiktionary, whichever you select in the settings. When you bring up a word definition in a browsable dialog, buttons are included to hear its pronunciation, when audio is available
- ISBN lookups via the google books API
- URL information. Fetches the page title, meta description, content length, and final domain (if the URL redirects to a different one) before you visit a site.
- credit card type verification (Mastercard, Visa, Discover, Amex, etc)
The add-on implements support for identifying phone numbers and email addresses as well, though no actual information is obtained. This is apt to change as soon as I can find something to do with them, and a straightforward API that meets our specifications.
Note: Regular expressions are used under the hood to verify data. This means that email addresses and card numbers will never leave your machine.
Options live under NVDA menu -> Preferences -> Settings -> Text Information.
- Dictionary for word definitions. Choose between the Free Dictionary API and Wiktionary. The Free Dictionary API is the default. Its entries are more concise and it supplies pronunciation audio, but it is less reliable and lacks entries for some very common words. Wiktionary is more dependable and covers far more, at the cost of longer, more technical definitions and no pronunciation audio of its own.
- If the selected dictionary lacks a definition or pronunciation, try another source. Off by default. When enabled, a word the selected dictionary cannot define is looked up in the other one, and a pronunciation it cannot supply is looked for among Wikimedia Commons recordings.
Words are looked up without any punctuation surrounding them, so selecting a word at the end of a sentence or inside quotes or brackets works as expected. Punctuation inside a word is kept, leaving things like let's and so-so intact.
If the selected dictionary reports that a word does not exist, the add-on confirms this against Wiktionary before telling you so. A word that does exist but has no entry available is reported as "definition unavailable" instead, so a real word is never reported as not being a word.
note: These bindings asume an English keyboard layout, and might not work otherwise. If you experience an issue, first try changing them in the input gestures dialog.
- NVDA+; (semicolon): provides information based on the text that's selected
- NVDA+SHIFT+; (semicolon): provides information about text on the clipboard
- NVDA+control+; (semicolon): speaks the last reported information. Press twice quickly to get it displayed in a browsable dialog. For word definitions, this dialog also includes buttons to play pronunciation audio, when available. Escape closes the dialog.
As of NVDA version 2019.3, all add-ons must be python 3 compatible. If you are for some reason running an older version, 1.0 is the last version usable with python 2, and dictionary definitions no longer work due to the deprecation of the Princeton Wordnetweb. Both should be considered unsupported.
Contributions are appreciated. You can either submit a PR, or get in contact with the following info:
twitter: @cartertemm
email: cartertemm (at) gmail (dot) com
This package is distributed under the terms of the GNU General Public License, version 2 or later. Please see the file COPYING.txt for further details.