WhatsApp NG

NVDA add-on that provides accessibility enhancements for the web-based WhatsApp Desktop.

Features

Toggle Scripts (no default shortcut - configure in Input Gestures)

Native WhatsApp Desktop keyboard shortcuts

Requirements

Installation

  1. Download the whatsAppNG.nvda-addon file
  2. In NVDA, go to Tools → Add-on Manager
  3. Click Install and select the file
  4. Restart NVDA

Configuration

Phone number filters can be toggled: - In conversation list: Configure a shortcut in Input Gestures - In message list: Configure a shortcut in Input Gestures

Configure shortcuts in: NVDA menu → Preferences → Input Gestures → WhatsApp NG

Changelog

Version 1.8.1 (2026-05-06)

Changed: - NVDA 2026 compatibility

Fixed: - Control+R: Not working for messages with "read more" button (now finds the button by structure instead of language-dependent text) - Control+R: Not working when usage hints filter is disabled - Control+R: Not reading messages that contain links or formatted text

Version 1.8.0 (2026-05-01)

Added: - Donation dialog during add-on installation

Changed: - Navigation (Alt+1, Alt+2, Alt+D) more resilient to WhatsApp UI changes

Fixed: - Enter and Shift+Enter not working when usage hints filter is disabled - Enter key not working in file dialogs and conversation list - Toggle phone filtering in conversation list not updating correctly - Improved Finnish translation and documentation

Version 1.7.1 (2026-04-10)

Fixed: - Minor bug fixes and stability improvements

Version 1.7.0 (2026-04-10)

Added: - Phone number filtering toggle for conversation and message lists

Version 1.6.0 (2026-03-23)

Added: - Usage hints filtering: Automatically hides "For more options..." and similar tooltips from message announcements - Supports multiple languages - Can be toggled with NVDA+Shift+H

Fixed: - Duplicate announce in conversation list: NVDA no longer announces each chat row twice when navigating with arrow keys (#11) - Alt+1 navigation: Improved reliability when locating conversation list - Message copying: Enhanced accuracy when copying messages with Control+C

Version 1.5.0 (2026-03-05)

Added: - Control+Shift+Enter: React to messages (opens reaction menu) - Alt+Enter: Read complete message in browse mode window - Native WhatsApp Desktop keyboard shortcuts added to documentation

Changed: - Performance significantly optimized: Navigation is now more fluid and responsive - Alt+2 more reliable and precise in navigation - Control+C now only works in message list

Fixed: - Control+R now reads complete text correctly when expanding long messages

Version 1.4.0 (2026-02-23)

Added: - Full language support: Arabic, German, Spanish, Italian, and Russian - Ukrainian translation updated with latest strings

Fixed: - "Text not found" error in Control+R after clicking "read more" button - Control+R now works only on text messages (shows "Not a text message" for voice/images)

Changed: - Repository links updated to new repository (nunotfc/WhatsAppNG) - Documentation: All localized READMEs now include complete changelog through version 1.3.0

Version 1.3.0 (2026-02-07)

Added: - Turkish translation support - Toggle automatic Focus Mode option (configure gesture in Input Gestures)

Changed: - Improved performance: Navigation commands are now faster on repeated use - Escape key now passes through to WhatsApp correctly

Fixed: - Enter now plays video messages (previously only worked for audio)

Version 1.1.1 (2025-01-31)

Added: - Control+R: Read complete message (clicks "read more" button automatically) - Control+C: Copy current message to clipboard - Browse mode auto-disable (keeps focus mode active for better WhatsApp experience)

Changed: - Improved error messages: All scripts now provide clear feedback on failure - Navigation commands (Alt+1, Alt+2, Alt+D) now silent on success - Enter: Slider-based detection instead of button counting (more reliable)

Fixed: - Alt+1 and Alt+2 correctly report errors when all paths fail - Optimized object filtering to reduce input lag

Version 1.1.0 (2025-01-30)

Added: - Control+R: Read complete message - Smart voice message playback using slider detection

Changed: - Enter: Improved logic using slider detection instead of counting buttons

Fixed: - Alt+2 now correctly tries all navigation paths if first attempt fails

Version 1.0.0 (2025-01-29)

Initial release: - Navigation shortcuts for conversation list, message list, and message composer - Voice message playback with support for individual chats and groups - Context menu access for message actions - Phone number filtering toggle for conversations and messages - Automatic focus mode activation in WhatsApp Desktop

Credits

Developed by Nuno Costa to provide accessibility enhancements for the modern WhatsApp Desktop experience.

Support

For issues or suggestions, please visit: https://github.com/nunotfc/whatsAppNG/issues

Translation Compilation

To update or compile translations: bash scons pot

This requires GNU Gettext tools to be installed.