Skip to content

Instantly share code, notes, and snippets.

Show Gist options
  • Save robertknight/295736d5d07dbd405d2085acd5586880 to your computer and use it in GitHub Desktop.
Save robertknight/295736d5d07dbd405d2085acd5586880 to your computer and use it in GitHub Desktop.
Testing the Windows screenreader NVDA on a Mac

How to test NVDA screen reader behaviour on a Mac:

  1. Download Microsoft Edge VM from https://developer.microsoft.com/en-us/microsoft-edge/tools/vms/
  2. Download Virtualbox and import the Edge VM image.

Then in the VM:

  1. Install guest addons in the VM
  2. Download & install latest NVDA from nvaccess.org
  3. Download & install SharpKeys and use it to map left an alternative key (eg. Left Ctrl) to the Insert key. This is needed because Macs do not typically have an “Insert” key which is the prefix for many NVDA commands.
  4. Log out and log in again for SharpKeys changes to take effect. Pressing Ctrl+N should now launch NVDA.
  5. Configure NVDA to use “Laptop” keyboard layout in the NVDA menu (NVDA+n) => Preferences => Keyboard Settings since the desktop layout relies on many keys which do not exist on a standard Mac keyboard.
  6. Install the Focus Highlight addon for NVDA which makes it easier to see what object currently has each of NVDA’s different focus targets.
  7. Enable the “Speech Viewer” log window via NVDA Menu => Tools => Speech Viewer so you can see what NVDA is saying more easily.

When testing, you may want to try different browsers and in particular Firefox which has historically been the best supported browser by NVDA.

@MicahDitto
Copy link

I'm new to the accessibility scene... Is there anything that is more current for Mac?

@robertknight
Copy link
Author

More recently I have used Parallels Desktop for the VM and a physical keyboard with an Insert key.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment