Skip to content

nvda-es/goldenCursor

This branch is 109 commits ahead of josephsl/goldenCursor:master.

Folders and files

NameName
Last commit message
Last commit date
Mar 24, 2025
Oct 6, 2024
Dec 27, 2024
Oct 6, 2024
Jan 16, 2016
Oct 6, 2024
Oct 6, 2024
Jan 16, 2016
Oct 6, 2024
Jan 4, 2025
May 25, 2024
Jan 16, 2016
Oct 20, 2019
Oct 6, 2024
Feb 19, 2023
Oct 6, 2024
Jul 13, 2021

Repository files navigation

golden cursor#

  • Author: salah atair, Joseph Lee
  • Download stable version
  • NVDA compatibility: 2022.4 and beyond

This add-on allows you to move the mouse using a keyboard and save mouse positions for applications.

Key commands

  • Control+NVDA+L: view saved mouse positions for an application, if any. You can also assign gestures to these positions from this dialog. When pressing the assigned gesture, a left click will be performed in the saved position.
  • Shift+NVDA+l: save a tag or a label for the current mouse position in the currently focused application.
  • Windows+NVDA+C: change mouse movement unit.
  • Windows+NVDA+R: toggle mouse restriction.
  • Windows+NVDA+S: toggle reporting of mouse position in pixels.
  • Windows+NVDA+J: move mouse to a specific x and y position.
  • Windows+NVDA+P: report mouse position.
  • Windows+NVDA+M: sswitch mouse arrows on or off.
  • Windows+NVDA+arrow keys (or just arrow keys if mouse arrows is on): move mouse.

Note: these gestures can be reassigned via NVDA's Input Gestures dialog under Golden Cursor category.

Notes

  • When sharing positions (tags), each party should use same display resolution.
  • For maximum compatibility, you should maximize windows by pressing Windows+Up arrow.
  • When sharing positions, existing position labels should be renamed.
  • Version 1.x and 2.x mouse position formats are incompatible.
  • To perform functions that require use of arrow keys, turn off mouse arrows first.
  • When deleting saved positions, if there are no saved positions left, positions for the application will be cleared.

Version 6.2

  • Requires NVDA 2022.4 or later.
  • Compatible with NVDA 2023.1.

Version 6.1

  • Requires NVDA 2021.3 or later.
  • Now, you can assign shortcuts for saved positions from the positions list. When pressing a shortcut, a left click will be performed for the position.

Version 5.0

  • Modernized add-on source code to make it compatible with NVDA 2021.1.
  • Resolved many coding style issues and potential bugs with Flake8.

Version 4.0

  • Requires NVDA 2019.3 or later.
  • Golden Cursor settings dialog has been replaced by Golden Cursor settings panel.

Version 3.3

  • Internal changes to support future NVDA releases.

Version 3.2

  • Add-on is compatible with NVDA 2018.3 (wxPython 4).

Version 3.0

  • If using NVDA 2018.2, add-on settings will be found in new multi-category settings screen under "Golden Cursor" category.

Version 2.1

  • Fixed unicode decode error when trying to delete tag name.
  • Prevent Multiple Instances When Opening various add-on Dialogs.
  • Improved appearance of mouse positions list and jump to position dialogs.

Version 2.0

  • Requires NVDA 2017.3 and later.
  • Position file format is incompatible with 1.x versions. If 1.x position format is found, old positions will be migrated to the new format during installation.
  • Added a new Golden Cursor settings dialog in NVDA's Preferences menu to configure mouse movement unit and announcement of mouse positions as mouse moves.
  • Various messages from this add-on has changed.
  • When toggling various settings, toggle tone will no longer be heard.
  • You can now enter mouse arrows mode where you can move the mouse by pressing just arrow keys.
  • Changes to positions list dialog, including new name (now called Mouse Positions) and layout, displaying mouse coordinates for a label, and showing the name of the active app as part of the title.
  • From Mouse Positions dialog, pressing Enter on a saved label will move the mouse to the saved location.
  • When renaming a mouse position, an error dialog will be shown if a label with the same name as the new name exists.
  • When deleting or clearing mouse positions, you must now answer Yes before positions are deleted and/or cleared.
  • Changes to mouse jump feature, including a new name (now called New mouse position) and ability to enter X and Y coordinates separately or by using up or down arrow keys.
  • The dialog shown when saving the current mouse position now shows coordinates for current mouse location.
  • When saving positions, resolved an issue where NvDA may play error tones if the positions folder does not exist.

Version 1.4

  • Removed win32api dependency to make it compatible with past and future versions of NVDA.

Version 1.0

  • Initial release.

About

Golden Cursor NvDA add-on

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 97.6%
  • CSS 1.2%
  • Smarty 1.2%