Mouse Reader for NVDA

NVDA add-on

Version 0.6.0 (beta) · Updated · · Free and open source

Mouse Reader reads the text under the mouse where NVDA's mouse tracking, also known as mouse echo, cannot: messages in Slack and other Electron apps, VS Code's chat, pictures of text, and PDFs whose font makes a mess of OCR. Hold Control+NVDA and click, and Mouse Reader reads the paragraph you clicked; from then on, move the mouse to hear the paragraphs under it, or hold Shift+NVDA and click to read on from that paragraph. On a web page or a PDF in Chrome or Edge it reads the page's own text, exact whatever the font looks like; everywhere else it takes a screenshot of the window and uses OCR. Because the window draws itself for the picture, it works with Windows Magnifier in full-screen mode.

Install

How to Install
  1. Press the Install button above to download mouseReader-0.6.0.nvda-addon. Your browser may ask you to confirm the download, since .nvda-addon files are uncommon.
  2. Open the downloaded file (press Enter on it in your Downloads folder). NVDA shows a dialog titled Add-on Installation that says: “Are you sure you want to install this add-on? Only install add-ons from trusted sources. Addon: Mouse Reader 0.6.0”. Choose Yes.
  3. NVDA says “Please wait while the add-on is being installed”, then asks: “Changes were made to add-ons. You must restart NVDA for these changes to take effect. Would you like to restart now?” Choose Yes.
  4. Updating later works the same way, except the first dialog asks whether to update the installed version to the new one. Choose Yes. You can also install from inside NVDA: NVDA menu, Tools, Add-on Store, then Install from external source, and pick the downloaded file.

To turn it off, untick Enable Mouse Reader in NVDA Settings, Mouse Reader. The keyboard commands can be changed under Input Gestures, in the Mouse Reader category.

How to Use

Hold Control+NVDA and click where you want NVDA to read, or place the mouse there and press Control+NVDA+Enter. Mouse Reader reads the paragraph you clicked. If mouse tracking is on, you can then move the mouse over other text to hear it, a paragraph at a time.

Where the text comes from. On a web page, or a PDF open in Chrome or Edge, Mouse Reader reads the page's own text, so the words are exact whatever the font looks like, a bulleted list reads item by item, and the browse cursor moves to the paragraph you clicked, so the keyboard carries on from there. Everywhere else, and on pages whose text has no paragraphs, it takes a screenshot of the window and uses OCR. The Read text from setting can force OCR only, and Play a beep when OCR is used tells the two apart.

In an OCR window that scrolls, roll the mouse wheel and Mouse Reader recognizes the screen again. Clicking or pressing a key ends the recognition; recognize again whenever you need it.

Hold Shift+NVDA and click, or press Shift+NVDA+Enter, to start continuous reading from that point. Continuous reading ignores mouse movement, even with mouse tracking on, and stops when you click or press a key. On a page that has focus, the page scrolls along.

The Hover reads setting chooses how much you hear at a time: one line, one paragraph, or a whole message or section.

Key Features
Accessibility
Requirements and Known Limits
Open Source

Mouse Reader is free software under the GNU General Public License, version 2, the same licence as NVDA. The source code and the licence are in the mouse-reader-for-nvda repository on GitHub, where each version is also published as a release.

Categories

Productivity NVDA add-ons

Change Log

Current: 0.6.0 (beta)

Download version 0.6.0 (September 17, 2026)

New in this version

  • Reads a web page's or a PDF's own text before turning to OCR. In Chrome or Edge, Mouse Reader reads NVDA's copy of the page: exact words whatever the font, whole paragraphs, a bulleted list item by item, and the browse cursor moves to the paragraph you clicked. Reading on uses NVDA's own continuous reading through the page, so the page scrolls along.
  • Bullet dots found in the picture. Windows OCR leaves bullet dots out, so a list in Slack could only be split by luck; Mouse Reader now finds the dots itself, a little to the left of each line, and each bullet reads on its own.
  • Read text from: a setting, and a command you can assign a key to, for Automatic (the page's own text when it has paragraphs, otherwise OCR) or OCR only.
  • Play a beep when OCR is used: a short soft beep at each OCR recognition, click or wheel, for when speech is too quick to say “Recognizing”. Off by default.
  • Better OCR paragraphs on book-style text. Lines that OCR returns in pieces (italic runs, a bold word) are put back together before any rule runs, and a full line that ends a sentence continues its paragraph, as printed text does.

Fixes

  • A whole message read as one item. OCR sometimes reads the avatar in front of a name as a capital O, which counted as a bullet, and everything under it was then swallowed as that item's continuation. A capital O is no longer a bullet, and an item's continuation lines have to line up with its text.
  • Browsers NVDA reads through UI Automation (its fallback when it could not hook into the browser) go straight to OCR instead of stalling; the Requirements section says how to get the browser back on the normal route.

Download version 0.5.10 (September 17, 2026)

New in this version

  • Nothing in this release.

Fixes

  • Numbered and bulleted items read as one paragraph. A list item's continuation lines, whether indented under its text (as on this page) or flush with its number (as in VS Code's chat), used to be read line by line; each item is now one paragraph at the Paragraph level, and a heading after the list is still its own.

Download version 0.5.8 (September 17, 2026)

New in this version

  • The first public version. Control+NVDA and click (or Control+NVDA+Enter) recognizes the window under the mouse with Windows OCR and reads the paragraph under the pointer; from then on hovering reads paragraphs, and rolling the wheel recognizes the window again.
  • Read on to the end. Shift+NVDA and click (or Shift+NVDA+Enter) reads from the paragraph under the pointer to the bottom of the window, ignoring the mouse until a key or a click stops it.
  • Hover reads a line, a paragraph or a whole block, from the settings or a command you can assign a key to.
  • Works with full-screen Magnifier: the window draws itself for the picture.
  • Recognized text is dropped when you click or press a key, so a window that has changed is never read from an old picture.

Fixes

  • Nothing yet: this is the first public version. Anything you find goes here next.