-
Notifications
You must be signed in to change notification settings - Fork 2
/
Copy pathmake.py
2833 lines (2821 loc) · 269 KB
/
make.py
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
import json
from settingsconfig import get
def GetOriginalLink(Link):
lng=get("language")
return Link.replace("\"lng\"", lng)
def AddLinks():
for i in dict.keys():
try:
dict[i].append(dict2[i])
print(f"added {dict2[i]} to {i}")
except:
pass
# here the first dictionery which containse addon name, and list for addon info, like what version of nvda needed, addon description, link for download.
dict={
"Sound Splitter":["2019.3+", "This add-on, partly based on Tony's Enhancements by Tony Malykh, adds the ability to split audio from NVDA and other sounds onto separate audio channels.\nCommands:\n• Alt+NvDA+S: toggle sound splitter. If enabled, NVDA will be heard through the right channel.\nSound Splitter settings\nYou can configure add-on settings from NVDA menu/Preferences/Settings/Sound Splitter category.\n• Split NVDA sound and applications' sounds into left and right channels: checkinb this checkbox will enable sound splitting feature.\n• Switch left and right during sound split: by default, NVDA will be heard through the right channel if sound splitting is on. You can instead hear NVDA through the left channel by checking this checkbox.\nVersion 22.02\n• Initial version based on Tony Malykh's Tony's Enhancements add-on.", "https://addons.nvda-project.org/files/get.php?file=soundsplitter"],
"Quick Notetaker":["2019.3 / 2021.2", """The Quick Notetaker add-on is a wonderful tool which allows writing notes quickly and easily anytime and from any app the user is using. Whether the user is watching a video for example, or participating in a meeting on Zoom, teams or Google meet, they can easily and smoothly open the notetaker and take a note. In order to create a quick note, NVDA + Alt + n key combination can be used, a floating window appears at the top left corner of the screen, so the note can be typed there.
Every note that is being Created can optionally get the active window title, and as such, the note content can get the context in which this note was created by having the note title as the active window title the user was using. This behavior can be changed from the add-on settings, where the user can decide whether the active window title is captured when creating a new note.
The Notetaker dialog
•
The note edit area: When opening the Notetaker interface the focus will be in this edit area. Writing with Markdown (a markup language to easily produce HTML content) is supported also. For more info on Markdown visit the Markdown guide page.
•
Preview note: to view the note in an HTML window.
•
Copy: to copy the note as is to the clipboard.
•
Copy HTML code: to copy the HTML code representing the note. A useful feature for those who write in Markdown.
•
A checkbox to allow saving the note as Microsoft Word also, or updating the corresponding one if it exists.
•
A save and close button.
•
A discard button to discard changes when desired. When unsaved changes exist, a warning message is displayed to the user asking if they are sure they want to exit and discard their changes.
The Notes Manager interface
Opening and closing this interface
•
NVDA + Alt + v will launch the Notes Manager interface.
•
Using either the Escape key or the close button found at the bottom of this window will close this interface.
The notes list
The notes are organized in a tabular list which includes:
. 1
The note title: If the note hasn’t got the active window title, the first line of the note will be the note title displayed in this list.
. 2
Last edited time stamp.
. 3
A preview text of the note content.
The options available in Notes Manager interface
•
View note: to view the note in an HTML window.
•
Edit note: opens the note to be edited using Notetaker interface.
•
Copy note: copies the note content as is to the clipboard.
•
Create a Microsoft Word document: Creates a Microsoft Word document representing this note in case it has no such document.
•
Open in Microsoft Word: opens the Microsoft Word document attached to this note in case it has a one.
•
Copy HTML code: copies the HTML code representing this note. A useful feature for those who write in Markdown.
•
Delete note: displays a warning before performing the note deletion.
•
New note: the Notetaker interface can be reached from this interface to create a new note.
•
Open settings: opening the add-on settings is also possible from here.
•
Close: to close the window.
The add-on settings
The add-on settings are a part of NVDA’s settings interface. To reach those settings, the user needs to open the NVDA menu using NVDA key + n, choose preferences > settings, and then arrow down until reaching Quick Notetaker category.
Using the settings interface the user can:
•
Default documents directory: to choose the default directory where Quick Notetaker documents will be saved. The user can press the “Browse” button to change the path of this directory.
•
Ask me each time where to save the note's corresponding Microsoft Word document: a checkbox (not checked by default) – to show the dialog for choosing the location where the document will be saved on each save or update operation for the note’s Microsoft Word document if such a one exists.
•
Open the note's corresponding Microsoft Word document after saving or updating: a checkbox (not checked by default) – to allow the user to choose whether the Microsoft Word document will be opened after a save or update operation in case the note has such document.
•
Capture the active window title when creating a new note: a checkbox (checked by default) – to allow the note to get the active window title the user was using when they created the note. This title will be also the title of the Microsoft Word document for the note in case it has a one.
•
Remember the note taker window size and position: a checkbox (not checked by default) – to tell the add-on to remember the size and the position of the Notetaker dialog when creating or editing a note. As such, when the user opens the dialog next time, the position and the size will be the same as the last time the dialog was used. The default position of this dialog is at the top left corner of the screen.
•
Auto align text when editing notes (relevant for RTL languages): a checkbox (checked by default) – to control whether the text when creating or editing a note should be auto aligned according to the language used. This is mostly relevant for right to left languages. For example, if the language used is Arabic or Hebrew, then the text will be right aligned when this option is chosen, if the language is English or French, then the text will be left aligned.
Keyboard shortcuts
•
NVDA + Alt + n: to open the Notetaker interface.
•
NVDA + Alt + v: to open the Notes Manager interface.
Keyboard shortcuts in the different interfaces
Interface
Command
Keyboard shortcut
Notetaker
Focus the note edit area
Alt + n
Notetaker
Align text to the right
Control + r
Notetaker
Align text to the left
Control + l
Notetaker
Preview note in an HTML window
Alt + r
Notetaker
Copy
Alt + p
Notetaker
Copy HTML code
Alt + h
Notetaker
Save note as a Microsoft Word document
Alt + w
Notetaker
Update the note corresponding Microsoft Word document
Alt + w
Notetaker
Save and close
Alt + s
Notetaker
Discard
Alt + d
Notetaker
Open notes Manager
Alt + m
Notes Manager
View note
Alt + v
Notes Manager
Edit note
Alt + e
Notes Manager
Copy note
Alt + p
Notes Manager
Open in Microsoft Word (if such a document exists)
Alt + o
Notes Manager
Create a word document for a saved note
Alt + w
Notes Manager
Copy HTML code
Alt + h
Notes Manager
Delete note
Alt + d
Notes Manager
New note
Alt + n
Notes Manager
Open settings
Alt + s
Notes Manager
Close the interface
Alt + c
The settings interface
Ask me each time where to save the note's corresponding Microsoft Word document
Alt + w
The settings interface
Open the note's corresponding Microsoft Word document after saving or updating
Alt + o
The settings interface
Capture the active window title when creating a new note
Alt + c
The settings interface
Remember the note taker window size and position
Alt + r
The settings interface
Auto align text when editing notes (relevant for RTL languages)
Alt + t
Acknowledgements
•
The add-on comes bundled with Pandoc, a wonderful tool which allows converting documents between different formats. Without this tool the add-on won’t be able to offer the capabilities it offers.""", "https://addons.nvda-project.org/files/get.php?file=quickNotetaker"],
"Ignore Blanks Indentation Reporting":["2021.1 and beyond", """This is an NVDA addon that alters the reporting of indentation by disregarding blank lines when deciding whether to report changes in indentation. It is best understood by contrasting with normal behaviour with an example.
Consider this example:
def foo():
x = 42
return x
def bar():
The current behaviour of NVDA is to report indentation changes for any line where the indentation has changed, even if the line is blank. So, the example would be read like:
def foo():
tab x = 42
no indent blank
tab return x
no indent blank
def bar():
The disadvantage for this behaviour is that for most programming languages, like python, a blank line has no semantic significance and is just used to visually separate lines of code with no change to the code's meaning. Therefore, by reporting the change of indentation upon entering a blank line and then reporting it again after landing on the next line is just noise that makes it harder to focus on understanding the code.
This addon aims to improve on the behaviour by ignoring blank lines when computing indentation speech, thus the example is read like this instead:
def foo():
tab x = 42
blank
return x
no indent def bar():""", "https://addons.nvda-project.org/files/get.php?file=ibir"],
"Search With":["2019.3 and beyond", """This addon helps you to search text, via various search engines. Let no text selected, and press the gesture of the addon, a dialog will be displayed, with an edit box to enter a search query, to search with Google press enter, or tab to search with other engins.
And if you want to search for selected text, select some text and press once, a menu will be displayed with various search engines to choose. and you can if you like, press the gesture twice to search selected text with Google directly.
The Default gesture for the addon is: NVDA+ Windows+ S. If the keystroke do not work for you, or conflict with other keystroke, you can as always add a gesture or change the existent one going to: NVDA menu>preferences>inputGestures>Search With category.
Usage
• If you want to enter a search query, just press the addon gesture. A dialog will be displayed, with an edit field to enter the search term.
• Want to search with Google? just press enter.
• Otherwise tab to Other Engines button, and give it a space, a popup menu will show up, with various search engines to choose. Yahoo, Bing, DuckDuckGo, and Youtube. This is the default menu, and you may modify it from addon's setting panel.
• Another way to use the addon, is by selecting some text. And on Pressing the addon's gesture, or any other you have assigned to it, a virtual menu will be displayed with various search engines, either the default menu, or any other you have tailed to your needs.
• Choose one and press enter, the default browser will open displaying search results. or, if you want to search with Google directly, press the gesture twice, and you are done.
• Want to trigger search menu specifically for clipboard or last spoken text? OK, then you can from input gestures dialog, assigned a gesture for:
• Trigger search menu for clipboard text, and pressed twice searches that text by Google directly.
• Trigger search menu for last spoken text, and pressed twice searches that text by Google directly.
• Want to modify Search with menu? Yes you can do that from the setting panel, and adjust the menu to fit to your mood and needs.
• You can from there, add to Search with menu, other available search engines. And you can if you like, remove an item from it, move item up, move item down, or return and set menu to default state.
• If you want these modifications to be permanent, you have to save configuration after wards.
• Want to search Google using other language options?
•
Then, go to Search With category in setting panels, from the cumbo box there, you can choose search Google either:
• Using browser settings and language.
• Using NVDA language.
• Using windows language.
•
Moreover, you have the option to choose the default query in Search with dialog. From the Options for default query combo box in setting panel, you can choose either
• Leave blank
• Use clipboard text
• Use last spoken text
•
And if clipboard or last spoken text is chosen, text in search box will be displayed selected, so that you can easily override it.
• Lastly, especially for advanced users
• You can through a check box in setting panel, choose if you want to preserve your data folder upon installing a new version. Be aware, choosing that you will not get new search engines, if any were included in the new addon version. And that's it, hope to search for good and find it, happy searching!""", "https://addons.nvda-project.org/files/get.php?file=searchwith"],
"Event Tracker":["2021.2 and beyond", """This add-on outputs information about objects for which events were fired. Properties recorded in debug log mode include object type, name, role, event, app module, and accessibility API specific information such as accName for IAccessible object and Automation Id for UIA objects.
Notes:
• This add-on is designed for developers and power users needing to track events coming from apps and various controls.
• In order to use the add-on, NVDA must be logging in debug mode (configured from general settings/logging level, or restart with debug logging enabled).
• It might be possible that add-ons loaded earlier than Event Tracker may not pass on the event to other add-ons, including Event Tracker. If this happens, Event Tracker will not be able to log events.
• Events are handled from global plugins, app modules, tree interceptors, and NVDA objects, in that order.
Events and their information
The following events are tracked and recorded:
• Focus manipulation: gain focus, lose focus, focus entered, foreground
• Changes: name, value, state, description, live region
• UIA events: controller for, element selected, item status, layout invalidated, notification, text change, tooltip open, window open
For each event, the following information will be recorded:
• Event name
• Object
• Object name
• Object role
• Object value or state depending on events
• App module
• For IAccessible objects: acc name, child ID
• For UIA objects: Automation Id, class name, notification properties if recording notification event information, child count for layout invalidated event""", "https://addons.nvda-project.org/files/get.php?file=evttracker"],
"PC Keyboard Braille Input for NVDA":["2019.3 +", """This NVDA add-on allows braille to be entered via the PC keyboard. Currently, the following keyboard layouts are supported:
• English QWERTY keyboard.
• French (France).
• German (Germany).
• Italian (Italy).
• Persian.
• Portuguese (Portugal).
• Spanish (Spain and Mexico).
• Turkish.
How to configure
The add-on can be configured from its category in the NVDA's settings dialog, under NVDA's menu, Preferences submenu. A gesture for opening the add-on settings panel can be assigned from Input gestures dialog, configuration category.
Check the corresponding checkbox if you want to type using only one hand, or ensure it's not checked if you prefer to type using the standard mode (two hands).
You can also select if NVDA should speak a single typed dot (using )the feature of "one hand mode").
كيفية الاستخدام
. 1Press NVDA+0 to enable braille input. This gesture can be changed from Input gestures dialog, Braille category.
. 2
Type braille by pressing keys together on the PC keyboard as if it were a braille keyboard.
•
If you want to enter text using two hands, use the following keys if you work with a QWERTY English keyboard, or the keys located at the corresponding positions in other layouts:
• f, d and s for dots 1, 2 and 3 respectively.
• j, k and l for dots 4, 5 and 6 respectively.
• Use the keys a and ; (semi-colon) for dots 7 and 8, respectively.
• You can also use the keys on the row above; i.e. q, w, e, r, u, i, o and p.
•
If you want to type text using one hand, you can compose characters pressing keys simultaneously or in several keystrokes, adding the dots corresponding to the desired character. Press g or h to type the character when you have added all its dots. If you make a mistake building a character, you can clear the dots before typing it by pressing t or y. The keys used in QWERTY English keyboard are the following:
• Left hand: f, d, s, r, e, w, a, q for dots 1, 2, 3, 4, 5, 6, 7 and 8.
• Right hand: j, k, l, u, i, o, ; (semicolon), p for dots 1, 2, 3, 4, 5, 6, 7 and 8.
. 3
You can press most other keys as normal, including space, backspace, enter and function keys. Take care about not pressing alt+shift, since changing the keyboard layout may affect the entered dots.
. 4Press space bar in combination with braille dots to move the system cursor (or report the current line), just if you were using a braille display. For example, space+dot1 to emulate upArrow, space+dot4+dot5+dot6 to emulate control+end, space+dot1+dot4 to report the current line, etc.
. 5Press NVDA+0 to disable braille input.""", "https://addons.nvda-project.org/files/get.php?file=pckbbrl"],
"Windows Magnifier":["2018.3 and beyond", """This add-on improves the use of Windows Magnifier with NVDA.
Features
• Allows to report the result of some native Magnifier keyboard commands.
• Allows to reduce the cases where table navigation commands conflict with Magnifier's commands.
• Adds some keyboard shortcuts to toggle various Magnifier options.
Settings
The setting panel of Windows Magnifier add-on allows to configure how NVDA reacts to native Windows Magnifier commands. You may want to have more or less commands reported according to what you are able to see. This panel may be opened choosing Preferences -> Settings in the NVDA menu and then selecting the Windows Magnifier category in the Settings window. The keyboard shortcut NVDA+Windows+O then O also allows to open this settings panel directly.
The panel contains the following options:
•
Report view moves: controls what is reported when you move the view with Control+Alt+Arrows commands. The three options are:
• Off: Nothing is reported.
• With speech: a speech message indicates the position of the zoomed view on the dimension the view is being moved.
• With tones: a tone is played and its pitch indicates the position of the zoomed view on the dimension the view is being moved.
This option only affects full view mode.
•
Report turn on or off: If checked, the Magnifier's state is reported when you use Windows++ or Windows+Escape commands to turn it on or off.
• Report zoom: If checked, the Magnifier's zoom level is reported when you use Windows++ or Windows+- zoom commands.
• Report color inversion: If checked, the color inversion state is reported when you use the control+Alt+I toggle command.
• Report view change: If checked, the view type is reported when you use a command that changes the view type (Control+Alt+M, Control+Alt+F, Control+Alt+D, Control+Alt+L)
• Report lens or docked window resizing: If checked, a message is reported when you use the resizing commands (Alt+Shift+Arrows). In docked window mode, the height or the width is reported. In lens mode, the new dimension cannot be reported for now. These resizing command do not seem to be available on all versions of Windows; if your Windows version does not support them, you should keep this option unchecked.
•
In documents and list views, pass control+alt+arrows shortcuts to Windows Magnifier: There are three possible choices:
• Never: The command is not passed to Windows Magnifier and standard NVDA table navigation can operate. When used in documents out of a table, the Control+Alt+Arrow command reports a "Not in a table" error message. This is the standard behaviour of NVDA without this add-on.
• Only when not in table: In table or in list views, Control+Alt+Arrow commands perform standard table navigation. When used in documents out of a table, Control+Alt+Arrow commands perform standard Magnifier view move commands. If you still want to move Windows Magnifier view while in table or in list view, you will need to press NVDA+F2 before using Control+Alt+Arrow commands. This option is the best compromise if you want to use Control+Alt+Arrow for both Magnifier and table navigation.
• Always: Control+Alt+Arrow commands moves the Magnifier's view in any case. This option may be useful if you do not use Control+Alt+Arrow to navigate in table, e.g. because you have changed table navigation shortcuts in NVDA or because you exclusively use Easy table navigator add-on for table navigation.
Commands added by this add-on
In addition to native Magnifier commands, this add-on provide additional commands that allow to control Magnifier's options without opening its configuration page. All the commands added to control Magnifier options are accessible through the Magnifier layer command NVDA+Windows+O:
• NVDA+Windows+O then C: Toggles on or off caret tracking.
• NVDA+Windows+O then F: Toggles on or off focus tracking.
• NVDA+Windows+O then M: Toggles on or off mouse tracking.
• NVDA+Windows+O then T: Toggles on or off tracking globally.
• NVDA+Windows+O then S: Toggles on or off smoothing.
• NVDA+Windows+O then R: Switches between mouse tracking modes (within the edge of the screen or centered on the screen); this feature is only available on Windows 10 build 17643 or higher.
• NVDA+Windows+O then X: Switches between text cursor tracking modes (within the edge of the screen or centered on the screen); this feature is only available on Windows 10 build 18894 or higher.
• NVDA+Windows+O then V: Moves the mouse cursor in the center of the magnified view (command available in full screen view only).
• NVDA+Windows+O then O: Opens Windows Magnifier add-on settings.
• NVDA+Windows+O then H: Displays help on Magnifier layer commands.
There is no default direct gesture for each command, but you can attribute one normally in the input gesture dialog if you wish. The same way, You can also modify or delete the Magnifier layer access gesture (NVDA+Windows+O). Yet, you cannot modify the shortcut key of the Magnifier layer sub-commands.
Magnifier's native commands
The result of the following Magnifier native commands may be reported by this add-on, according to its configuration:
• Start Magnifier: Windows++ (on alpha-numeric keyboard or on numpad)
• Quit Magnifier: Windows+Escape
• Zoom in: Windows++ (on alpha-numeric keyboard or on numpad)
• Zoom out: Windows+- (on alpha-numeric keyboard or on numpad)
• Toggle color inversion: Control+Alt+I
• Select the docked view: Control+Alt+D
• Select the full screen view: Control+Alt+F
• Select the lens view: Control+Alt+L
• Cycle through the three view types: Control+Alt+M
• Resize the lens with the keyboard: Shift+Alt+Left/Right/Up/DownArrow. Note: although this does not seem to be documented, this shortcut seems to have been withdrawn in recent Windows versions such as Windows 2004.
• Move the magnified view: Control+Alt+Arrows (reporting only affects full screen mode)
Here is also a list of other Magnifier native commands, just for information:
• Control+Alt+mouseScrollWheel: Zooms in and out using the mouse scroll wheel.
• Control+Windows+M: Opens the Magnifier's settings window.
• Control+Alt+R: Resizes the lens with the mouse.
• Control+Alt+Space: Quickly shows the entire desktop when using full screen view.
None of the Magnifier native commands can be modified.
Notes
• For computers equipped with an Intel graphic card, control+alt+arrow (left/right/up/down) are also shortcuts to modify the orientation of the screen. These shortcut are enabled by default and conflict with Windows Magnifiers shortcuts to move the view. You will need to disable them to be able to use them for the Magnifier. They can be disabled in the Intel control panel or in the Intel menu present in the system tray.
•
Depending on your Windows version, Alt+Shift+Arrow are Windows Magnifier shortcuts to resize the magnified view (lens or docked). When Magnifier is active (even in full screen mode), these shortcuts are captured by Magnifier and cannot be passed to the application, even if you press NVDA+F2 before. To use these shortcuts in the current application, you need to quit the Magnifier (Windows+Escape) and re-open it after (Windows++). For example in MS word, to decrease title level:
• Press Windows+Escape to quit Magnifier.
• Press Alt+Shift+RightArrow to decrease current title level.
• Press Windows++ to re-open the Magnifier.
•
For more information about Windows Magnifier's features and shortcuts, you may want to consult the following pages:
• Use Magnifier to make things on the screen easier to see
• Windows keyboard shortcuts for accessibility""", "https://addons.nvda-project.org/files/get.php?file=winmag"],
"Direct Link":["2019.3 and beyond", """The purpose of the addon is to convert the Dropbox, Google Drive or oneDrive (both personal and business) links to a direct link, furthermore, it generates a direct link to a WhatsApp chat with the chosen selected phone number.
Usage
• Select or copy a shared Dropbox, Google Drive or oneDrive link
• Press alt+NVDA+l to convert the link. The resulting URL will be in your clipboard.
• Similarly for the phone number, copy or select the number you like to chat with or share and press the same shortcut (alt+NVDA+L).
• if you like to open the resulted link in your browser, press alt+NVDA+shift+l.
Why the direct link?
A direct link will allow you to get the well-known save dialog box directly if you open it in the browser, without being hassled by the hosting company download page and locating the download link. Moreover, the direct link can be used to stream a file or view a file in certain programs such as media players (if coming with URL support). Likewise, if WhatsApp is common in your country, rather than creating a new contact each time if you need to chat with someone, weather it is a customer or technical support, you can simply select the number or copy it and start chatting right away. Even more, you can share the WhatsApp link of your own number if people usually need to contact you in case you work as a freelancer.
Notes
• A link of a folder cannot be converted; the link has to be directing to a file.
• Make sure the link you are sharing is public (anyone with the link can access) in order for it to be successfully converted.
• You can change the hotkeys from the NVDA menu> preferences> input gestures.
• If you find a certain format of a phone number that is not detected, you can email me with an example.
• Certain type of files and sizes in Google Drive might take you to a page that says "Google Drive can't scan this file for viruses." in that case, you have to click on download anyway link.""", "https://addons.nvda-project.org/files/get.php?file=directlink"],
"NVDA Unmute":["2019.3 and beyond", """This add-on checks the status of the Windows audio system when NVDA starts. And, if it turns out that the sound is muted - the add-on forcibly turns it on.
At the same time, the volume level is checked separately for the NVDA process.
The add-on also checks the status of the speech synthesizer. If there are problems with its initialization, attempts are made to start the synthesizer, which is specified in the NVDA settings.
There is an additional opportunity to check on which audio device the NVDA sound is output. And, if this device differs from the default device, the output automatically switches to the audio device installed in the system as the main one.
Note: If the add-on startup sound always plays even if the NVDA volume is online. That is, the add-on switches the output to the main audio device each time you start NVDA.
This occurs when the audio output device is in the NVDA settings is differ from the default output device or "Microsoft Sound Mapper".
This can be easily solved in one of the following ways:
. 1After restarting NVDA, just save the current configuration using NVDA+Ctrl+C. The default audio device will be saved in the NVDA settings and switching will not occur each time when NVDA starts.
. 2If you don't want to change the NVDA configuration - just disable the function of switching audio devices in the Unmute settings panel.
Add-on settings dialog
To open the add-on settings panel, follow these steps:
• Press NVDA+N to open NVDA menu.
• Then go to "Preferences" -> "Settings..." and in the categories list find and open "Unmute Windows Audio".
That's it, you can now use the Tab key to move between add-on settings.
The following options are available in the add-on settings dialog:
. 1
The first slider in the add-on settings dialog allows you to specify the volume level of Windows, which will be set when you start NVDA if the sound was previously muted or was too low.
. 2
The minimum Windows volume level at which the volume up procedure will be applied. This slider allows you to adjust the sensitivity level of the add-on.
If the volume level drops to less than the value specified here, the volume will be increased the next time you start NVDA.
Otherwise, if the volume level remains higher than the value specified here, then when you restart NVDA, its level will not change.
And, of course, if the sound was previously turned off, when restarts add-on will turn it on anyway.
. 3
The following check box allows to enable re-initialization of the voice synthesizer driver.
This procedure will only start if it is detected at NVDA startup that the voice synthesizer driver has not been initialized.
. 4
In this field you can specify the number of attempts to re-initialize the voice synthesizer driver. Attempts are performed cyclically with an interval of 1 second. A value of 0 means that attempts will be performed indefinitely until the procedure is successfully completed.
. 5
The "Switch to the default output audio device" option allows to check at startup the audio device on which NVDA sound is output. And, if this device differs from the default device, the output automatically switches to the audio device installed in the system as the main one.
. 6
The next checkbox turns on or off playing the startup sound when the operation is successful.
Third Party components
The add-on uses the following third-party components:
• For interaction with the Windows Core Audio API - PyCaw module that is distributed under the MIT license.
• For getting the information about running processes and using the PyCaw component - psutil module that is distributed under BSD-3 license.""", "https://addons.nvda-project.org/files/get.php?file=unmute"],
"Check Input Gestures":["2019.3 and beyond", """Find and fix input gestures conflicts in NVDA and add-ons. The general term "input gestures" includes keyboard commands, commands entered from Braille keyboards and gestures of touch screens.
Each of the installed add-ons can make changes to the NVDA configuration by adding or reassigning existing input gestures. If the same input gestures are binded to several functions, it will be impossible to call some of them.
Search for duplicate gestures
To detect duplicate gestures, call the NVDA menu, go to the "Tools" submenu, then - "Check Input Gestures" and activate the menu item "Search for duplicate gestures...".
After that, all input gestures used in NVDA will be checked in the following order:
. 1globalCommands;
. 2globalPlugins.
If the same input gestures will be detected, which are assigned to different functions, their list will be displayed in a separate dialog box.
After pressing the Enter key on the selected list item, the corresponding NVDA function will be selected and opened in the standard "Input Gestures..." dialog, where you can delete or reassign the associated gesture.
Note: As you know, features that don't have a text description do not appear in the "Input Gestures..." dialog. Therefore, after activating such an element, the corresponding warning will be displayed.
Gestures without description
To view the list of gestures binded with functions without a text description, if they are found in your NVDA configuration, you need to call the NVDA menu, go to the submenu "Tools", then - "Gestures without description...".
Such features do not appear in the standard NVDA "Input Gestures..." dialog, so it is not yet possible to delete or reassign associated gestures.
Help
One way to view this help page is to call up the NVDA menu, go to the "Tools" submenu, then - "Check Input Gestures", and activate "Help".
Note: All features of the add-on are presented in the NVDA "Input Gestures" dialog and you can assign your own keyboard shortcuts to each of them.
Contributions
We are very grateful to everyone who made the effort to develop, translate and maintain this add-on:
• Wafiqtaher - Arabic translation;
• Angelo Miguel Abrantes - Portuguese translation;
• Cagri Dogan - Turkish translation.""", "https://addons.nvda-project.org/files/get.php?file=cig"],
"NVDAUpdate Channel Selector":["2019.1 / 2021.1", """This add-on allows you to download and install the latest NVDA version of the chosen type without visiting any webpage nor using your web browser. It is useful when, for example, you want to test new features in a NVDA snapshot and then return back to the most recent stable release. If you test regularly NVDA snapshots and you usually install them in your computer, you will save a lot of time with this add-on. If you prefer testing snapshots in portable mode keeping your installed copy of NVDA unchanged, this add-on is for you as well.
Usage
You can change the NVDA update channel by going to NVDA menu, Preferences, Settings, Update channel category. Once you choose the desired channel and press OK, wait until the next automatic update check or go to NVDA help menu and choose "Check for updates" option. For now, these are the available channels:
• Default: this is the default channel used by your NVDA version. Choosing this option means the same as disabling the add-on.
• Stable: force update channel to stable. Useful when you want to return to a stable version from a snapshot.
• Stable, rc and beta: this is the channel for beta releases. You will receive the first beta version once it is released. This channel allows you to update through betas and release candidates until you reach the next stable version.
• Alpha (snapshots): choose this option to update to the latest alpha. Alpha snapshots allows you to test new features, but they are quite unstable. Please, be careful.
• Disable updates (not recommended): this option disables the update channel. If you check for updates an error message will be displayed. Remember that you can disable automatic updates from the General settings category. Use this option only with testing purposes.
Information about available updates for each channel will be retrieved in the background once the settings panel is opened. Press tab to navigate to a read only edit field, where you can see this information. This information will be dynamically updated when you change the update channel from the combo box. If there is an update available for the selected channel, one or two links will appear next to the edit field:
• Download: press spacebar on this link to open it in your web browser and download the latest installer.
• View changelog: press spacebar on this link to open the What's new document in your web browser. For some channels, this link won't be displayed.""", "https://addons.nvda-project.org/files/get.php?file=updchannelselect"],
"Proxy support for NVDA":["2019.3 / 2021.1", """This add-on allows the NVDA screen reader to connect to the Internet through one or more proxy servers. To make it possible, it applies various patches to the standard Python library or modifies certain environment variables, depending on the chosen configuration. You will be able to update NVDA and their add-ons automatically from your corporate environment and even perform remote sessions, provided that your organization proxy server allows it.
Features
• Support for various proxy server types: http, socks4 and socks5.
• Ability to redirect all traffic through the proxy server or only specific traffic (http, https, ftp).
• Ability to redirect all traffic through a proxy server and, after that, redirect specific traffic through other servers (nested proxies).
• Profile switch and config reset aware: if you usually work with a portable copy of NVDA, you can create various profiles for different environments (home, work, office1, office2) and manually activate them.
Usage
This add-on adds a new category to the NVDA settings dialog called "Proxy". In this category, you will find four settings groups. The first one allows you to configure a general proxy for all traffic. The other groups allow you to configure proxy servers only for specific protocols. All groups have the following fields:
• Host: hostname or ip address of the proxy server. Leave empty to disable that particular proxy.
• Port: server port.
• Username: optional. User name for server autentication.
• Password: optional. Password for server autentication. Note that password is not required for socks4 servers.
In addition to the previous fields, the following options are available in the first settings group:
• SOCKS proxy type: socks4, socks5 or http can be selected.
• Use proxy for dns requests if possible: when this checkbox is checked, hostnames or domain names will be directly sent to and resolved on the proxy server. When it is unchecked, names will be resolved locally and the server will receive only the destination ip address. Note that not all socks4 proxy servers support this option.
Tipically, most users will only have to configure the first settings group. If you don't know your proxy details, ask your organization network administrator for more information.
Limitations
• Very limited IPV6 support.
• UDP traffic is not supported on all proxy servers.
• External DLL libraries won't respect the settings configured in this add-on.
• Only basic autentication is supported for http proxy servers. Digest autentication is not supported.
• In order to redirect all traffic (including https connections) through an http proxy, the server must support the CONNECT http method.
• A "direct connection" mode can't be configured. If you disable a specific proxy, the system default will be used instead.""", "https://addons.nvda-project.org/files/get.php?file=nvdaproxy"],
"WordNav":["2019.3 +", """WordNav NVDA add-on improves built-in navigation by word, as well as adds extra word navigation commands with different definition for the word.
Most text editors support Control+LeftArrow/RightArrow commands for word navigation. However the definition of the word changes from one program to another. This is especially true of modern web-based text editors, such as Monaco. NVDA should know the definition of word in given program in order to speak words correctly. If NVDA doesn't know the exact definition, then either words are going to be skipped, or pronounced multiple times. Moreover, some web-based text editors position the cursor in the end of the word, instead of the beginning, making editing much harder for visually impaired users. In order to combat this problem I have created enhanced word navigation commands, that take the word definition from Notepad++ and they do not rely on program's definition of words, but rather parse lines into words on NVDA's side. The Control+LeftArrow/RightArrow gesture is not even sent to the program, thus ensuring the consistency of the speech.
Please note that a prototype of WordNav was formerly a part of Tony's enhancements add-on. Please either uninstall it or upgrade to Tony's enhancements latest stable version to avoid conflicts.
Currently WordNav supports four definitions of the word, assigned to different gestures:
• Left Control+Arrows: Notepad++ definition, that treats alphanumeric characters as words, and adjacent punctuation marks are also treated as words. This should be the most convenient word definition for the majority of users.
• RightControl+Arrows: Fine word definition splits camelCaseIdentifiers and underscore_separated_identifiers into separate parts, thus allowing the cursor to go into long identifiers.
• LeftControl+Windows+Arrows: Bulky word definition treats almost all punctuation symbols adjacent to text as part of a single word, therefore it would treat paths like C:\directory\subdirectory\file.txt as a single word.
• RightControl+Windows+Arros: Multiword definition, that groups several words together. The amount of words is configurable.
Gestures can be customized in WordNav settings panel.
Notes
• At this time WordNav doesn't modify Control+Shift+LeftArrow/RightArrow gestures to select words, since implementation of such commands are significantly more complicated.
• If you would like to use virtual desktops feature of Windows 10, please remember to disable Control+Windows+Arrows keyboard shortcuts either in WordNav Settings panel, or in NVDA Input gestures dialog.
• WordNav doesn't work reliably in VSCode, since due to its internal optimizations, VSCode presents only a few lines of file contents at a time, that change dynamically, and this occasionally interferes with WordNav algorithm.""", "https://addons.nvda-project.org/files/get.php?file=wordnav"],
"Win Wizard":["2019.3 and beyond", """This add-on allows you to perform some operations on the focused window or the process associated with it.
Keyboard commands:
All these commands can be remapped from the Input gestures dialog in the Win Wizard category.
Hiding and showing hidden windows:
• NVDA+Windows+numbers from 1 to 0 - hides currently focused window in the slot corresponding to the pressed number
• NVDA+Windows+left arrow - moves to the previous stack of hidden windows.
• NVDA+Windows+right arrow - moves to the next stack of hidden windows.
• Windows+Shift+h - hides the currently focused window in the first available slot
• NVDA+Windows+h - shows the last hidden window
• Windows+Shift+l - shows the list of all hidden windows grouped by the stacks (please note that by default last hidden window is selected)
Managing processes:
• Windows+F4 - kills the process associated with the currently focused window
• NVDA+Windows+p - opens dialog allowing you to set priority of the process associated with the currently focused window
Miscellaneous commands:
• NVDA+Windows+TAB - switches between top level windows of the current program (useful in foobar2000, Back4Sure etc.) Since this command moves the system focus it can be found in the System focus category of the Input gestures dialog.
• CTRL+ALT+T - allows you to change title of the currently focused program""", "https://addons.nvda-project.org/files/get.php?file=winwizard"],
"Console Toolkit":["2019.3 and later", """Console Toolkit is NVDA add-on, that provides accessibility improvements for Windows console, also known as Command prompt. It also works well in Windows PowerShell. Some of the features may work in alternative terminals, such as Cygwin, PuTTY and Windows Terminal, however, the add-on has only been carefully tested with the default Windows Console. SSH users might find this add-on especially handy.
Some of the features were previously part of Tony's enhancements add-on.
Downloads
Console toolkit
Real-time console speech
This option makes NVDA to speak new lines immediately as they appear in console output, instead of queueing new speech utterances. For example, if NVDA is busy speaking a line that appeared on the screen 1 minute ago, and now a new line appears, this option will cancel speaking the old line and start speaking the new line right away, thus providing a more real-time feedback on what's happening in console window.
Beep on console updates
Beep a low pitch impulse every time console text is updated.
Enforce Control+V in consoles
This option makes Control+V shortcut to work inside ssh sessions.
Experimental: command prompt editing
Note: this feature is experimental. Please read this section carefully and make sure you understand how it works before reporting issues.
Press NVDA+E to identify current prompt in console window and edit it in an accessible "Edit prompt" window. After editing you can either press Escape to update current command line, or Enter to update and immediately execute command. Alternatively you can press Alt+F4 to close edit prompt window without updating command line.
This feature has been tested in Windows command prompt cmd.exe as well as in bash shell over ssh connections, as well as in WSL and cygwin. It might also work in alternative Unix shells, however it hasn't been tested.
Here is how add-on extracts current command.
. 1It presses End key and then sends a control character, that is a rare Unicodecharacter not likely to be used anywhere.
. 2Then it presses home key and sends another control character.
. 3Then it waits for control characters to appear on the screen, which might take some time on slow SSH connections.
. 4Command is what appears between two control characters.
. 5When "Use UI Automation to access the Windows Console when available" option is enabled in NVDA settings, it sends one more control character in the beginning of the string. This is needed to parse multiline commands correctly: UIA implementation trims whitespaces in the end of each line, so in order to deduce whether there is a space between two lines, we need to shift them by one character. Please note, however, that this way we don't preserve the number of spaces between words, we only guarantee to preserve the presence of spaces.
. 6Before editing add-on makes sure to remove control characters by placing cursor in the beginning and end and simulating Delete and Backspace key presses.
. 7It presents command in "Edit prompt" window for user to view or edit.
. 8
After user presses Enter or Escape,it first erases current line in the console. This is achieved via one of four methods, the choice of the method is configurable. Currently four methods are supported:
• Control+C: works in both cmd.exe and bash, but leaves previous prompt visible on the screen; doesn't work in emacs; sometimes unreliable on slow SSH connections
• Escape: works only in cmd.exe"),
• Control+A Control+K: works in bash and emacs; doesn't work in cmd.exe
• Backspace (recommended): works in all environments; however slower and may cause corruption if the length of the line has changed
. 9
Then add-on simulates keystrokes to type the updated command and optionally simulates Enter key press.
Troubleshooting:
• Verify that 'Home', 'End', 'Delete' and 'Backspace' keys work as expected in your console.
• Verify that your console supports Unicode characters. Some ssh connections don't support Unicode.
• Verify that selected deleting method works in your console.
Experimental: capturing command output
Note: this feature is experimental. Please read this section carefully and make sure you understand how it works before reporting issues.
While in command line or in "Edit prompt" window, press Control+Enter to capture command output. This add-on is capable of capturing large output that spans multiple screens, although when output is larger than 10 screens capturing process takes significant time to complete. Add-on will play a long chime sound, and it will last as long as the add-on is capturing the output of currently running command, or until timeout has been reached. Alternatively, press NVDA+E to interrupt capturing.
When "Use UI Automation to access the Windows Console when available" feature is enabled in NVDA settings, you can switch to other windows while capturing is going on. However, if this option is disabled, then NVDA is using a legacy console code, that only works when consoel is focused, and therefore switching to any other window will pause capturing.
Command capturing works by redirecting command output to less command. Default suffix that is appended to commands is: |less -c 2>&1 Please only change it if you know what you're doing. This add-on knows how to interact with the output of less command to retrieve output page by page.
On Windows less.exe tool needs to be installed separately. You can install it via cygwin, or download a windows binary elsewhere.
If you are using tmux or screen in Linux, please make sure that no status line is displayed in the bottom. In tmux run tmux set status off to get rid of status line, or modify your tmux.conf file.
Troubleshooting:
• After a failed output capturing attempt, press UpArrow in the console to check what command has actually been executed.
• Revert back to default capturing suffix, mentioned above.
• Try troubleshooting steps from "command prompt editing" section.""", "https://addons.nvda-project.org/files/get.php?file=consoletoolkit"],
"Quick Dictionary":["2019.3 / 2020.3", """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.
Receiving a dictionary article
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.
Add-on control mode
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.
Add-on commands list
Basic dictionary commands:
• D - announce a dictionary entry for a selected word or phrase (same as NVDA+Y);
• W - show dictionary entry in a separate browseable window;
• S - swap languages and get Quick Dictionary translation;
• A - announce the current source and target languages;
• C - copy last dictionary entry to the clipboard;
• E - edit text before sending;
• U - download from online dictionary and save the current list of available languages;
• function keys - select online dictionary service;
• Q - statistics on the using the online service;
• F - choose online service.
Voice synthesizers profiles management:
• from 1 to 9 - selection of the voice synthesizer profile;
• G - announce the selected profile of voice synthesizers;
• B - back to previous voice synthesizer;
• R - restore default voice synthesizer;
• Del - delete the selected voice synthesizer profile;
• V - save configured voice synthesizer profile;
• P - display a list of all customized voice synthesizers profiles.
Press O to open add-on settings dialog.
Help on add-on commands
You can see a list of all the commands used in the add-on as follows:
• Via the NVDA menu - by pressing NVDA+N, go to the submenu "Tools", then - "Quick Dictionary" and activate the menu item "Help on add-on commands".
• Press the H key in add-on control mode (NVDA+Y).
Add-on help
To open the add-on help - press NVDA+N, go to the "Tools" submenu, then - "Quick Dictionary" and activate the menu item "Help".
Contributions
We are very grateful to everyone who made the effort to develop, translate and maintain this add-on:
• Cagri Dogan - Turkish translation;
• Wafiqtaher - Arabic translation.
Several good solutions from other developments were used in the Quick Dictionary add-on. Thanks to the authors of the following add-ons:
• Instant Translate - Alexy Sadovoy, Beqa Gozalishvili, Mesar Hameed, Alberto Buffolino and other NVDA contributors.
• To work with voice synthesizers profiles were used ideas from the Switch Synth add-on (thanks to Tyler Spivey).""", "https://addons.nvda-project.org/files/get.php?file=quickdictionary"],
"Numpad Nav Mode":["unnown", """Numpad Nav Mode is an NVDA add-on, which allows you to easily switch your keyboard's numpad between NVDA's navigation controls and the non-screenreader Windows navigation controls.
The normal functions of the PC number pad, with numlock off, are: page up, page down, home, end, four-way arrow keys, and a delete key. But NVDA completely takes over the numpad, to provide review keys, mouse controls, and object navigation controls. This is true even in laptop keyboard mode, which duplicates those functions on non-numpad keys for those who do not have a numpad.
However some users do have a numpad on their laptop, and would prefer to use it for Windows navigation purposes, especially because some laptops do not provide home, end, or other such keys. That is where this add-on can help. Additionally, some desktop users may sometimes find it convenient to use the numpad for those keyboard functions rather than the normal keys, which this add-on enables.
How it works
With numlock off, no matter what keyboard layout you are using, this add-on will let you press Alt+NVDA+NumpadPlus (which is usually the long key second up on the right), to quickly and easily switch between the normal NVDA navigation controls, and the classic Windows navigation controls. This key can be remapped under Input Gestures, in the Input section.
Note that this add-on doesn't disable the use of numpad insert as an NVDA modifier, if you have it set as such. If you want that feature, please let me know, although you can manually turn off numpad insert as a modifier in NVDA keyboard settings.
If you would prefer to have NVDA start with the Windows nav mode active by default, you can configure that in NVDA configuration. Go to NVDA's preferences, then settings, and find the Numpad Nav Mode settings panel. There you will be able to select a checkbox to turn Windows Nav Mode on by default when you start NVDA. To get there quickly, press NVDA+N, P, S, then N one or more times until you hear "Numpad Nav Mode".""", "https://addons.nvda-project.org/files/get.php?file=numpadNav"],
"Zoom Accessibility Enhancements":["2018.4 / 2020.2", """This add-on improves the experience of using Zoom for NVDA users by providing keyboard shortcuts to Handle alerts for Different events While In a meeting, make the process of remote control much more accessible and smoother, and more.
keyboard shortcuts for controlling alerts In meetings
•
NVDA + Shift + A: cycles between different modes of reporting alerts. The following modes are available:
• Report all alerts mode, where all alerts are reported as usual
• Beep for alerts, where NVDA will play a short beep for every alert displayed in Zoom
• Silence all alerts, where NVDA will ignore all alerts
• Custom mode, Where the user can customize which alerts they want to have and which not. This can be done using the settings dialog of the add-on, or by using the dedicated keyboard shortcuts for that
The following shortcuts can be used to toggle on / off the announcements of each type of alert (note that this will be effective when custom mode is selected):
• NVDA + Ctrl + 1: Participant Has Joined/Left Meeting (Host Only)
• NVDA + Ctrl + 2: Participant Has Joined/Left Waiting Room (Host Only)
• NVDA + Ctrl + 3: Audio Muted by Host
• NVDA + Ctrl + 4: Video Stopped by Host
• NVDA + Ctrl + 5: Screen Sharing Started/Stopped by a Participant
• NVDA + Ctrl + 6: Recording Permission Granted/Revoked
• NVDA + Ctrl + 7: Public In-meeting Chat Received
• NVDA + Ctrl + 8: Private In-meeting Chat Received
• NVDA + Ctrl + 9: In-meeting File Upload Completed
• NVDA + Ctrl + 0: Host Privilege Granted/Revoked
• NVDA + Shift + Ctrl + 1: Participant Has Raised/Lowered Hand (Host Only)
• NVDA + Shift + Ctrl + 2: Remote Control Permission Granted/Revoked
• NVDA + Shift + Ctrl + 3: IM chat message received
Note that you need to leave reporting all alert types selected (in Zoom accessibility settings) to have the add-on function as expected.
Keyboard shortcut for Opening add on Dialogue
NVDA + Z Opens the add-on dialog !
Using this dialog you can :
• See which alerts are announced and which aren't
• Select the types of the alerts you want to be announced
• Choose alerts reporting mode
• Save custom changes
Remote control
after a remote control permission is granted, NVDA + O will move the focus in /Out of the remote controlled screen
Note that the focus should be on one of the meeting controls to be able to remote control the other screen
An Important note
Currently the feature of custom alerts mode where the user can choose which alerts they want to have and which not works with Zoom only when the user interface language is set to english.""", "https://addons.nvda-project.org/files/get.php?file=zoom"],
"Kill NVDA":["2019.2 / 2019.3", """This add-on is designed to temporarily kill NVDA, so that you can recover if it freezes.
Usage
. 1Install this add-on.
. 2Copy it to the logon screen with the button in General Settings.
. 3When NVDA dies, press control alt delete, then activate the NVDA menu, Tools, Kill NVDA.
After that, press escape. NVDA restarts, but you should be able to use your computer again.""", "https://addons.nvda-project.org/files/get.php?file=killnvda"],
"Time Zoner":["2019.2.1 +", """An add-on for NVDA to announce the time in selected timezones.
Introduction
For a very long time now, Windows has had the ability to show multiple clocks from different timezones. Users can customize the clocks and they become instantly visible.
Unfortunately, for users of screen readers such as NVDA or JAWS, there is no simple way to get this information. These screen readers don't support additional clocks, so blind computer users have to resort to other, third-party solutions, some of which are paid.
A lot of the work I do involves working across timezones, and eventually I got tired of manually converting times in my head, especially for timezones that aren't aligned to the hour (such as India which is +5:30 UTC).
For these reasons, I've created this add-on for NVDA. The add-on lets you hear times in selected timezones through the use of the timezone ring.
Usage
The add-on supports both the legacy and the Python 3 version of NVDA.
Once the add-on is installed, press NVDA+N to bring up NVDA's context menu. Arrow down to "Preferences" and then up to "Time Zoner".
Press ENTER on "Configure timezone ring".
You will be presented with a dialog to set the timezones for which you want the time and date announced.
Select items in the timezone list to add them to your timezone ring. Deselect (or press the Remove button) to delete them from the ring.
You can also reorder the timezones in the ring by using the Move Up and Move Down buttons.
Use the "Filter" box to search for specific timezones.
Check the "Announce abbreviated timezones" box to hear abbreviated timezone names such as IST or GMT. Uncheck the box to hear the full timezone names such as Asia/Kolkata or Europe/London.
When you are finished configuring the timezones, press the Save button.
From here on, you can press NVDA+Alt+T to announce times and dates in your timezone ring.
When you first install the add-on, NVDA will default to your local timezone if it can get it.
Change Log
Version 1.03, released on 03/21/2020
• The add-on no longer crashes if the default timezone can't be set.
• Fixed an issue with relative links in the documentation.
Version 1.02, released on 03/18/2020
• When installing a new version of this add-on, the settings from a previous installation are no longer lost.
• Other changes to conform to NVDA add-on standard compliance.
Version 1.01, released on 03/12/2020
• The time and date are announced in the user's locale, meaning that 24-hour time is honored if set.
• NVDA will announce either the abbreviated or full timezone depending on the user's setting in the Timezone Ring dialog. For example, it will either say Europe/London, or it will say GMT or BST. This setting is controlled by checking or unchecking the "Announce abbreviated timezones" checkbox.
• Add-on includes translator comments (@ruifontes).
• Add-on now includes header comments (@ruifontes).
• The Escape key closes the Timezone Ring dialog (@ruifontes).
• The menu item to open the Timezone Ring dialog is now named appropriately (@ruifontes).
• NVDA now defaults to the local timezone on installation of this add-on, if the local timezone is available.
• Support for multiple timezones through the use of a timezone ring.
• This add-on now uses the key NVDA+Alt+T to prevent conflict with the Clock add-on.
• The timezone selector dialog now has a filter box. NVDA will announce the number of results as the user starts typing into the filter field.
• Python 2 support
• The date and time is now announced in a separate thread to prevent hanging the NVDA thread in case retrieval takes a little while.
• The timezone selector dialog now has a Cancel button and no longer prevents NVDA from shutting down.""", "https://addons.nvda-project.org/files/get.php?file=tz"],
"Tony's enhancements":["2019.3", """This add-on contains a number of small improvements to NVDA screen reader, each of them too small to deserve a separate add-on.
This add-on is only compatible with NVDA versions 2019.3 and above.
Enhanced table navigation commands
• Control+Alt+Home/End - jump to the first/last column in the table.
• Control+Alt+PageUp/PageDown - jump to the first/last row in the table.
• NVDA+Control+digit - jump to 1st/2nd/3rd/... 10th column in the table.
• NVDA+Alt+digit - jump to 1st/2nd/3rd/... 10th row in the table.
• NVDA+Shift+DownArrow - read current column in the table starting from current cell down.
Dynamic keystrokes
You can assign certain keystrokes to be dynamic. After issuing such a keystroke, NVDA will be checking currently focused window for any updates and if the line is updated, NVDA will speak it automatically. For example, certain keystrokes in text editors should be marked dynamic, such as Jump to bookmark, jump to another line and debugging keystrokes,such as step into/step over.
The format of dynamic keystrokes table is simple: every line contains a rule in the following format:
appName keystroke
where appName is the name of the application where this keystroke is marked dynamic (or * to b marked dynamic in all applications), andkeystroke is a keystroke in NVDA format, for example, control+alt+shift+pagedown.
Real-time console output
This option is disabled by default and must be enabled in the settings.
This option makes NVDA to speak new lines immediately as they appear in console output, instead of queueing new speech utterances.
There is also an option to beep on command line updates - this would give you a better idea when new lines are printed in the console.
Beep when NVDA is busy
Check this option for NVDA to provide audio feedback when NVDA is busy. NVDA being busy does not necessarily indicate a problem with NVDA, but rather this is a signal to the user that any NVDA commands will not be processed immediately.
NVDA volume
• NVDA+Control+PageUp/PageDown - adjust NVDA volume.
This option controls the volume of NVDA speech as well as all the other sounds and beeps produced by NVDA. The advantage of this option compared to adjusting volume of a speech synthesizer, is that it affects the volume of all the beeps proportionally.
Blocking double insert keystroke
In NVDA pressing Insert key twice in a row toggles insert mode in applications. However, sometimes it happens accidentally and it triggers insert mode. Since this is a special keystroke, it cannot be disabled in the settings. This add-on provides a way to block this keyboard shortcut. When double insert is blocked, insert mode can stil be toggled by pressing NVDA+F2 and then Insert.
This option is disabled by default and must be enabled in the settings.""", "https://addons.nvda-project.org/files/get.php?file=tony"],
"Phonetic Punctuation":["2019.3", """Phonetic punctuation is an NVDA add-on that allows to convert punctuation signs into audio icons. In general, it can also convert any regular expressions into audio icons.
Demo
You can listen to a sample speech output with phonetic punctuation here (10 seconds audio): https://soundcloud.com/user-977282820/nvda-phonetic-punctuation-demo
Usage
. 1Make sure that your symbol level is set to appropriate value. If you're not sure, then press NVDA+P several times until you select "Symbol level all".
. 2Make sure phonetic punctuation is enabled. Press NVDA+Alt+P to enable.
. 3Phonetic punctuation rules can be configured via a dialog box in NVDA preferences menu.
. 4Phonetic punctuation comes with a set of predefined audio rules. However, only a few of them are enabled by default. You can enable other rules, as well as add new rules in the configuration dialog.
. 5Audio rules are saved in a file called phoneticPunctuationRules.json in NVDA user configuration directory.
Supported voice synthesizers
Phonetic punctuation depends on new NVDA speech framework, and as of today (October 2019), not all voice synthesizers have proper support for the new commands. This means that phonetic punctuation might not work correctly with some voice synthesizers.
Synthesizers known to work well with Phonetic Punctuation:
• Microsoft Speech API
• eSpeak
• Windows OneCore Voices
Synthesizers known to have problems with PhoneticPunctuation:
• IBMTTS: see this issue.
• RHVoice: Break command is not supported.""", "https://addons.nvda-project.org/files/get.php?file=phoneticpunc"],
"Percentage Checker":["2019.2 / 2019.3", """This add-on allows you to check how far - in percents - you are in the text or on a list. This information can be given either by spoken message, or by a beep. In addition you can jump to the given percentage or a line number in the text.
Key Commands:
• Shift+NVDA+j: Displays a dialog allowing you to jump to the given line number.
• Shift+NVDA+p: Announces percentage in the current text or on a list. In addition if you are in a text the amount of words in the field would be spoken. In case of a list this would be amount of all list items.
• Alt+NVDA+p: Presents your position in a text or on a list as a beep.
The two last commands can be pressed twice in quick succession to display a dialog allowing you to jump to a given percentage in a text. All these commands can be remapped from the input gestures dialog.""", "https://addons.nvda-project.org/files/get.php?file=perChk"],
"Report Passwords":["2019.3 +", """This add-on adds the option of speaking the text typed in protected controls like passwords, such as when logging into web-based email sites, where typed characters are spoken as asterisks.
Note: NVDA has an option to configure if typed passwords will be spoken in Windows terminals. This add-on won't affect those kinds of controls.
How to configure
The add-on can be configured from its category in the NVDA's settings dialog, under NVDA's menu, Preferences submenu. A gesture for opening the add-on settings panel can be assigned from Input gestures dialog, configuration category.
Tip: If you have not configured NVDA to speak typed characters or words but want to hear typed text in passwords, you may create a configuration profile to enable the speaking of typed characters and passwords, and assign it to a gesture or create a trigger to enable it automatically in certain situations. For convenience, NVDA will ask if you want to create a dedicated profile when the add-on is installed.""", "http://addons.nvda-project.org/files/get.php?file=rp"],
"Audio Themes":["unknown", """This add-on creates a virtual audio display that plays sounds when focusing or navigating objects (such as buttons, links etc...) the audio will be played in a location that corresponds to the object's location in the visual display.
The add-on also enables you to activate, install, remove, edit, create, and distribute audio theme packages.
Usage
This add-on enables you to perform three distinct tasks, including managing your installed audio themes, editing the currently active audio theme, and creating a new audio theme.
You can access these functions from the add-on's menu which is found in the main NVDA menu.
Managing Your Audio Themes
• The 'Manage Audio Themes' dialogue enables you to activate or deactivate audio themes, in addition to installing and removing audio themes.
• In this dialogue there are some additional options including:
• Play sounds in 3D mode: When you uncheck this box the add-on will play the sounds in mono mode (always in the centre of the audio display) regardless of the object location.
• Speak role such as button, edit box , link etc.: When you uncheck this box NVDA will start announcing the role when focusing objects rather than ignoring it (which is the default behaviour when installing this add-on).
• Use Synthesizer Volume: Checking this box will set the sound player of this add-on to use the active voice sound, thus making all audible output the same as the voice volume when ever you change that volume.
• Audio Theme Volume Slider: Alternatively you can set the volume for the add-on using this slider. Setting it to 0 will mute all sounds, and 100 is the maximum volume.
Editing The Active Audio Theme:
• When you click on the 'Edit the active audio theme' option, a dialogue will open with a list containing all the sounds contained in the currently active theme. From this dialogue you can:
• Change Selected: Selecting a sound from the list and clicking this button, will open a standard open file dialogue, select an ogg or wave audio file from your file system to replace the selected sound, and click OK to complete the process.
• Remove Selected: This will remove the selected sound from the theme, click 'Yes' to confirm the removal process, and the selected sound will be removed.
• Add New Sound: When clicking this button a new dialogue will be shown. From the first combo box in the newly opened dialogue select the object type you want to assign the sound to it, for example (button, link, tab, menu and so on), then click the 'Browse to an audio file' button to select the sound you want to assign for the previously selected object type. Optionally you can click the preview button to preview the sound, and finally clicking the OK button will apply the changes and assign the selected sound to the selected object.
• Close: Will exit the dialogue without performing any action.
Creating A New Audio Theme
• If you have a good sound production skills you can apply them here and create an audio theme of your own, rather than editing an existing one. To do this you can follow these steps. - Collect your audio files in one place, they must be in ogg or wave format, and rename them to what ever make sense to you. For example when I was creating the default audio theme for this add-on, I grouped sounds according to interaction patterns, for example, the combo box, the drop down button, and the split button can all have the same sound, while the Check box, The toggle button, and the menu check item can have the same sound. - From the add-on menu click 'Create a new audio theme' - A dialogue will be opened asking you for some information about your new audio theme, including: * Theme Name : The name of your theme which will be shown in the audio themes manager. This must be a valid windows folder name. * Your Name: Enter your real name or a nick name.
• Theme description : A Brief description about your audio theme. - Click OK to move to the next step. - In the next step a dialogue similar to the 'Audio Themes Editor' will be shown, and from their the process is the same as the Theme editing process, so refer to 'Editing The Active Audio Theme' section.
Copyright:
Copyright (c) 2014-2016 Musharraf Omer and Others
Although this add-on was started as an independent project, it evolved to be an enhanced version of the 'Unspoken' add-on by Austin Hicks and Bryan Smart. The majority of this add-on's development went into creating the tools to manage, edit and create audio theme packages. So a big thank you to them for creating such a wonderful add-on, and making it available for us to build on top of their work.
A Note on Third-party audio files:
The Default audio theme package in this add-on uses sounds from several sources, here is a breakdown for them: - Unspoken 3D Audio: An add-on for NVDA - TWBlue: A free and open source twitter client - Mushy TalkBack: An alternative talkback with better sounds.""", "https://addons.nvda-project.org/files/get.php?file=ath"],
"Synth ring settings selector":["2019.2", """This add-on allows the user to select which settings should appear on the synth settings ring.
Features
This add-on provides the following features:
• A category panel in the NVDA settings to select which settings you want to include in the synth settings ring.
• save specific settings for each profile.
• overrides the default synth driver settings that are shown in the synth settings ring.
Requirements
You need NVDA 2019.2 or later.
Installation
Just install it as a NVDA add-on.
Usage
To enable or disable which settings are included, go to NVDA settings and select "Synth ring settings selector" category. In that category you can configure all supported features by this add-on. Settings included by default:
• language.
• voice.
• variant.
• rate.
• rate boost.
• volume.
• pitch.
• inflection.
Note: This dialog shows the supported settings by the current synthesizer only. Settings not present here aren't modified in the add-on config.""", "https://addons.nvda-project.org/files/get.php?file=synthrings"],
"Debug Helper":["unknown", """The purpose of this add-on is to make debugging things in NVDA easier. New features will be added based on user suggestions. All emails or GitHub issues with feedback or feature ideas are most welcome.
Key Command
• NVDA+Shift+F1: Inserts a mark line in the NVDA log.
Explanation and Usage
When you press the command key, the add-on inserts a line like the following in the NVDA log (at the Info level):
-- Mark 1 --
It will also announce: "Logged Mark 1!"
If you press the key again, you will get:
-- Mark 2 --
and "Logged Mark 2!" will be spoken.
Let us say for example that you were about to perform a series of tasks, that you know generate lengthy error content in the NVDA log. You are going to post the relevant portions of your log to a mailing list or the NVDA GitHub issue tracker. However you don't want to hunt through your entire log to find the relevant content. So you use this add-on to insert mark 1, right before you do the thing that causes the first error. If you know something else will generate further errors, or a different kind, you insert another mark to separate that error from the previous one, or so you can say "this is what I was doing at mark 3, where some errors occurred." Another example: While using some application, something happens that causes an error (maybe you hear the Windows error sound). You want to go back and find that error later, but you don't want to stop working and save the log right now. So you use this add-on again, to insert a mark in your log. This time the mark will appear after the errors in your log, instead of before. But either way, the marks will help you narrow down the important sections of your log.
The mark lines shown above can be easily searched for with the find command in a text editor such as Notepad or Notepad++. Additionally, by default, there is a blank line inserted above each mark. Blank lines are also possible after the mark. Blank lines can be helpful if you are using NVDA's log viewer, or another text editor, and want to use the arrow keys to quickly read up/down through the log, to find a particular mark. It is easy to pick the word "blank" out of a bunch of text being spoken as you quickly move through the log. If you arrow really fast, you might need more than one blank line, which you can adjust in settings.
Note: The mark count will survive the reloading of plugins (NVDA+Control+F3), but will start back at one if you restart NVDA.
Configuration:
In the Settings section of NVDA Preferences, you will find a "Debug Helper" category. In the settings dialog you can change the number of blank lines inserted before and after each mark line. The default is one line before, and zero after, although you can use 0 through 10 lines for either. Under the Tools category of NVDA's Input Gestures panel, you can change NVDA+Shift+F1 to a key sequence of your choice.
Changelog
•
Version 1.0.2 (2019-08-28)
• Translation and code cleanup.
•
Version 1.0.1 (2019-08-26)
• Minor bugfix version to probably fix an install problem on certain versions of Windows.
•
Version 1.0 (2019-08-22)
•
Initial release. Including following features:
• Ability to generate numbered mark lines in the log (at info level).
• Ability to add 0-10 blank lines before and after each mark line.
• Configuration via NVDA settings dialog system.""", "https://addons.nvda-project.org/files/get.php?file=debughelper"],
"Notepad++":["unknown", """This addon improves the accessibility of the notepad++ text editor. To learn more, and to read the documentation before installation, https://github.com/derekriemer/nvda-notepadplusplus visit the addons github page https://github.com/derekriemer/nvda-notepadplusplus""", "https://files.derekriemer.com/NotepadPlusPlus-2019.09.0.nvda-addon"],
"Beep Keyboard":["2018.2 to 2019.2", """This add-on allows the user to configure NVDA to beeps with some keyboard events.
Features
This add-on provides the following features you can use to adapt NVDA keyboard behavior:
• Beep for uppercases when caps lock is on: if this feature is enabled, NVDA will beep when you typing an uppercase and caps lock is on. Don't make any more uppercase mistakes!
• Beep for typed characters when shift is pressed: with this feature NVDA will beep if you type a character with shift key pressed.
• Beep for toggle keys changes: with this feature, NVDA will beep higher if a toggle key goes on, and lower tone if it goes off. Please note that Windows has a toggle keys beep function built-in on Ease of Access Center. This native feature works well if you don't use laptop keyboard layout setting.
• Announce toggle keys changes: just when "Beep for toggle keys changes" is on. You can enable or disable NVDA to announce toggle key status.
• Beep for specified characters: NVDA will beep for all characters that you set in advanced settings.
• Disable beeping on password fields: this feature is enabled by default to aboid security risks. Disable it if you want to hear beeps on password fields.
Requirements
You need NVDA 2018.2 or later.
Installation
Just install it as a NVDA add-on.
Usage
To enable or disable features, go to NVDA settings and select beep keyboard category. In that category you can configure all supported features by this add-on.
• "Beep for uppercases when caps lock is on" is enabled by default.
If you need more settings, open the advanced settings dialog that contains the following options:
• Ignored characters with shift pressed: all characters here will be ignored to beeping when shift is pressed. Escape Sequences are allowed, e.g. "\t" for tab, "\r" for carriage return.
• Beep always for the following characters: set here all characters that you want NVDA beeps for. Escape Sequences are allowed, e.g. "\t" for tab, "\r" for carriage return.
• Select tone to configure: you can configure parameters for all tones. Select one here, and set the parameters in the next text boxes. When change selection, NVDA will beep for the current selected tone with the current parameters set in the dialog.
• Tone pitch: tone pitch for the current selected tone.
• Tone length: tone length for the current selected tone.
• Tone volume: tone volume for the current selected tone.
• Test tone: this button lets you to play a test with the current set parameters.
• Press OK button to save settings or cancel to discard.""", "https://addons.nvda-project.org/files/get.php?file=beepkeyboard"],
"Developer Toolkit":["2019.1 / 2020.1", """Developer toolkit (DTK) is an NVDA add-on that helps blind and visually impaired developers independently create visually appealing user interfaces and web content. It provides gestures that enable you to navigate through objects and obtain information about them, such as their size, position, and characteristics. To begin using DTK, place focus on a control, then press ALT+WINDOWS+K. To disable it, press ALT+WINDOWS+K again. When on the web, press NVDA+SPACE to put NVDA in Focus Mode and press NVDA+SHIFT+SPACE to disable Single Letter Navigation.
Gestures
The following gestures are available when DTK is enabled.
• ALT+WINDOWS+K - Enable or disable DTK features.
• LEFT ARROW - Move to previous sibling.
• RIGHT ARROW - Move to next sibling.
• UP ARROW - Move to parent.
• DOWN ARROW - Move to first child.
• CTRL+HOME - Move to top-most parent.
• HOME - Move to the relative parent if one is assigned.
• A - In web content, speak HTML attributes. Press twice quickly to copy to the clipboard.
• B - Speak the position of the object's bottom edge. Press twice quickly to copy to the clipboard.
• SHIFT+B - Speak the distance between the object's bottom edge and the relative parent's bottom edge. Press twice quickly to copy to the clipboard.
• C - Speak the number of children contained inside the object. Press twice quickly to copy to the clipboard.
• control+c - Switch between RGB, Hex, and Name color values.
• CTRL+D - Enable or disable detailed messages.
• F - In web content, speaks the object's font and formatting information. Press twice quickly to copy to the clipboard.
• H - Speak the object's height. Press twice quickly to copy to the clipboard.
• L - Speak the position of the object's left edge. Press twice quickly to copy to the clipboard.
• n - Speak the object's name. Press twice quickly to copy to the clipboard.
• CTRL+P - Set the relative parent for obtaining size/location of objects.
• P - Speak the relative parent's name. Press twice quickly to copy to the clipboard.
• R - Speak the position of the object's right edge. Press twice quickly to copy to the clipboard.
• SHIFT+R - Speak the distance between the object's right edge and the relative parent's right edge. Press twice quickly to copy to the clipboard.
• ALT+R - Speak the object's Role/control type. Press twice quickly to copy it to the clipboard.
• S - Speak the number of siblings relative to the object. Press twice quickly to copy to the clipboard.
• SHIFT+S - Speak the object's control states. Press twice quickly to copy it to the clipboard.
• T - Speak the position of the object's top edge. Press twice quickly to copy to the clipboard.
• V - Speak Developer toolkit version. Press twice quickly to copy to the clipboard.
• W - Speak the object's width. Press twice quickly to copy to the clipboard.
Notes
• When using home or any modified version of the home key, using the numpad home key fails because NVDA will send the numpad7 keypress instead of a numpadHome keypress. Other keyboard add-ons that attempt to reassign numpad7 to the home key will fail in this add-on.
•
When using the relative parent feature, DTK will set the relative parent to the desktop under the following conditions.
• The focused object and the relative parent are the same.
• The relative parent is not a direct ancestor of the focused object.
•
DTK cannot access information such as CSS rules, padding, borders, or z-index. Doing so requires accessing them outside of the NVDA context, which presents a security concern for users.
Known issues
• The customizable list of font attributes found in Developer toolkit settings may be cumbersome to use. This is a limitation found in NVDA's user interface library.""", "https://addons.nvda-project.org/files/get.php?file=devtoolkit"],
"Add-ons documentation":["2017.3 / 2019.2", """This add-on provides a quick way to access documentation for the add-ons you have installed. It creates, in the NVDA Help menu, two sub-menus. One, called "Running add-ons documentation", groups the documentation for each add-on and make available a list of commands for all running add-ons, with a table for each add-on. Other sub-menu called "Disabled add-ons documentation", lists the disabled add-ons, giving access to its documentation. Please, remember that the Synth and Braille drivers add-ons will not appear in any of the above categories. Note that you also can access the add-ons documentation through the Add-ons manager in NVDA, Tools menu. Here you have also the information about the state of an add-on. Also remember that you can access the NVDA and add-ons commands in the Input gestures dialog. However, in this dialog the add-ons commands are not grouped and you can not find a command containing "windows", by instance...""", "https://addons.nvda-project.org/files/get.php?file=addonshelp"],
"Character Information":["2017.3 / 2021.1", """This add-on allows to present in a message character information such as unicode name, number, category, etc.
Commands
• Numpad2 (all keyboard layouts) or NVDA+. (laptop layout): when pressed 4 times, displays information about the character of the current navigator object where the review cursor is situated.
Notes
•
This add-on provides also two gestures that are unassigned by default:
• A script to display directly the review cursor character information. If you feel unconfortable with the four press gesture, you may assign to it a gesture in NVDA's input gesture dialog ("Text review" category).
• A script to display character information for the character at the position of the caret (works only in places where there is a caret). It can be found in the "system caret" category of NVDA input gestures dialog.
•
The provided information is in english since it is part of Unicode norm. If a local translation exists for this add-on, the information is also provided alongside with english.
• The CLDR name (Unicode Common Locale Data Repository) is only supported with NVDA 2019.1 and above.
• For the characters written with Microsoft proprietary fonts Symbol, Wingding (1, 2,, 3) and Webding, some additional information is provided: character name, font name and information of the corresponding unicode character.""", "https://addons.nvda-project.org/files/get.php?file=chari"],
"Addon to count elements of selected text":["2017.2 / 2019.1", """This addon announces the number of words, characters, paragraphs and lines of the selected text by pressing Control+Shift+F12.
Note: In some applications, like Word, WordPad and DSpeech, it only announces word and characters, to avoid hanging NVDA.
In any text editor, or in a virtual document, for example in a web browser, PDF, email body, etc., select the desired text using the usual text selection commands and press Control+Shift+F12.
This command can be modified in the "Input gestures" dialog in the "Text editing" section.""", "https://addons.nvda-project.org/files/get.php?file=wc"],
"Online image describer":["2018.3 / 2020.2", """This addon aims at adding online image recognition engines to NVDA.
There are two types of engines. OCR and image describer.
OCR extract text from image.
Image describer describe visual features in image in text form, such as general description, color type landmarks and so on.
Internet connection is required to use this addon, since image describe services are provided by API endpoints on the Internet.
They are called engines in this addon.
There are three types of engine for this addon.
• Online OCR engine
• Online image describer engine
• Windows 10 OCR engine (offline)
You also need to choose the source of recognition image.
• Current navigator object
• Current foreground window
• The whole screen
• Image data or file from clipboard
• Image file pathname or image url from clipboard
Keyboard commands
After choosing these types, you can start recognition with one gesture.
NVDA+Alt+P Perform recognize according to source and engine type setting, Then read result. If pressed twice, open a virtual result document.
There are four additional gestures left unassigned. Please assign them before using.
Cycle through different recognition engine types.
Cycle through different recognition source types.
Cancel current recognition
This gesture can be useful if you think you have waited for too long and want to cancel.
Also sometimes you do not want to be disturbed by recognition message because you need to review some messages arrived after recognition start.
Show previous result in a virtual result document.
Though there is a feature to copy result to clipboard. Character position information cannot be preserved, so this gesture is added to solve this problem.
There are also four old gestures are left unassigned for users who prefer gestures in previous versions.
It is recommended to use new gesture and switch engine type according to your need.
Recognize current navigator object with online OCR engine Then read result. If pressed twice, open a virtual result document.
Recognizes image in clipboard with online OCR engine. Then read result. If pressed twice, open a virtual result document.
Recognize current navigator object Then read result. If pressed twice, open a virtual result document.
Recognizes image in clipboard . Then read result. If pressed twice, open a virtual result document.
Engine Configuration
You can choose recognition engines and configure them in detail in Online Image Describer category in NVDA settings dialog.
The author of addon have registered account with free API quota and set up a proxy server on www.nvdacn.com to make this addon easier to test at first. Test quota is limited and may be cancelled by API provider anytime.
It is highly recommended to register your own key according to guide in each engine.
The following settings are applicable to all engines.
• Copy recognition result to the clipboard: if enabled, recognition result text will be copied to clipboard after recognition.
• Use browseable message for text result: if enabled, recognition result text will be shown in a popup window instead of speech or braille message.
• Swap the effect of repeated gesture with none repeated ones: by default, a virtual result document is shown only if you press the corresponding gesture twice, if you use that frequently you can enable this option so that you only need to press once to get a result viewer.
• Enable more verbose logging for debug purposes: some logs are essential for debugging but affects performance and takes up a lot of space. Only turn this on if specifically instructed to by the addon author or an NVDA developer.
• Proxy type: which type of proxy you are using. If you do not know what a proxy is just leave it as is.
• Proxy address: full URL of your proxy. If you do not know what a proxy is just leave it as is. If you choose to use proxy your proxy will be verified before saving , after verification, there will be a prompt to tell you result.
The following settings means the same in all engines, describe them here to save space.
•
API Access Type: this controls how you get access to the corresponding API endpoints.
• If you choose "Use public quota", you are using free quota in an account registered by addon author.
• If you choose "Use your own API key", this addon will use quota from your own account.
•
APP ID, API key or API Secret Key: if you want to use quota from your own account corresponding access tokens is required. Some engines only need API key. Some engines require two tokens. These are only valid if you choose "use your own API key" in API Access type.
Note that the quality and accuracy of results are affected by many factors.
• Models and techniques used by engine provider
• Quality of uploaded image
• Is navigator object hidden behind something else
• Screen resolution
Online image description
Here are three engines available.
Microsoft Azure Image Analyser
This engine extracts a rich set of visual features based on the image content.
This engine is english only. If you want description in other languages, you can use Microsoft Azure Image Describer
Visual Features include:
• Adult - detects if the image is pornographic in nature (depicts nudity or a sex act). Sexually suggestive content is also detected.
• Brands - detects various brands within an image, including the approximate location. The Brands argument is only available in English.
• Categories - categorizes image content according to a taxonomy defined in documentation.
• Color - determines the accent color, dominant color, and whether an image is black&white.
• Description - describes the image content with a complete sentence in supported languages.
• Faces - detects if faces are present. If present, generate coordinates, gender and age.
• ImageType - detects if image is clip art or a line drawing.
• Objects - detects various objects within an image, including the approximate location. The Objects argument is only available in English.
• Tags - tags the image with a detailed list of words related to the image content.
Some features also provide additional details:
• Celebrities - identifies celebrities if detected in the image.
• Landmarks - identifies landmarks if detected in the image.
Microsoft Azure Image describer
This engine generates a description of an image in human readable language with complete sentences. The description is based on a collection of content tags, which are also returned by the operation.
More than one description can be generated for each image. Descriptions are ordered by their confidence score.
There are two settings for this engine.
• Language: the language in which the service will return a description of the image. English by default.
• Maximum Candidates: maximum number of candidate descriptions to be returned. The default is 1.
Online OCR
Online engines rely on the use and presence of the following services.
https://www.nvdacn.com
https://ocr.space/ocrapi
https://azure.microsoft.com/en-us/services/cognitive-services/
http://ai.qq.com
http://ai.baidu.com
http://ai.sogou.com/
https://intl.cloud.tencent.com
Engines
There are five engines available.
Tencent Cloud OCR
This API is sponsored by Tencent Cloud and Aceessibility Research Association, with a quota of 15000 per day.
This engine support 19 languages.
• Chinese-English mix
• Japanese
• Korean
• Spanish
• French
• German
• Portuguese
• Vietnamese
• Malay
• Russian
• Italian
• Dutch
• Swedish
• Finnish
• Danish
• Norwegian
• Hungarian
• Thai
• Latin
Here is the settings of this engine.
• Language: Text language for recognition. Auto detection by default.
OCR space
This one is a paid API with free quota provided by OCR Space
It supports 24 languages
• Arabic
• Bulgarian
• Chinese(Simplified)
• Chinese(Traditional)
• Croatian
• Czech
• Danish
• Dutch
• English
• Finnish
• French