- Authors: Leonard de Ruijter
- Download latest stable version
- NVDA compatibility: 2023.2 and later
The RDAccess add-on (Remote Desktop Accessibility) adds support for Microsoft Remote Desktop, Citrix, or VMware Horizon remote sessions to NVDA. When installed on both the client and the server in NVDA, speech and braille generated on the server will be spoken and displayed in braille on the client machine. This enables a user experience where managing a remote system feels as seamless as operating the local system.
- Support for Microsoft Remote Desktop, Citrix, and VMware Horizon
- Speech and braille output
- Automatic detection of remote braille using NVDA's automatic braille display detection
- Automatic detection of remote speech using a dedicated detection process that can be disabled in NVDA's settings dialog
- Support for portable copies of NVDA running on a server (additional configuration required for Citrix)
- Full support for portable copies of NVDA running on a client (no additional administrative privileges required to install the add-on)
- Multiple active client sessions simultaneously
- Remote desktop instantly available after NVDA start
- Ability to control specific synthesizer and braille display settings without leaving the remote session
- Ability to use speech and braille from the user session when accessing secure desktops
- Fixed broken braille display gestures.
- Use Ruff as a formatter and linter. #13
- Fixed an issue where NVDA on the client generates an error when pausing speech on the server.
- Fixed support for
winAPI.secureDesktop.post_secureDesktopStateChange. - Improved driver initialization on the server.
- Added support for NVDA 2023.3 style device registration for automatic detection of braille displays. #11
- Added support for NVDA 2024.1 Alpha
winAPI.secureDesktop.post_secureDesktopStateChangeextension point. #12
Initial stable release.
- Install RDAccess on both a client and server copy of NVDA.
- The remote system should automatically start speaking using the local speech synthesizer. If not, in the NVDA instance on the server, select the remote speech synthesizer from NVDA's synthesizer selection dialog.
- To use braille, enable automatic braille display detection using the braille display selection dialog.
After installation, the RDAccess add-on can be configured using NVDA's settings dialog, accessible from the NVDA Menu by choosing Preferences > Settings... Then, choose the Remote Desktop category.
This dialog contains the following settings:
This list of checkboxes controls the operating mode of the add-on. Choose between:
- Incoming connections (Remote Desktop Server): Choose this option if the current instance of NVDA is running on a remote desktop server.
- Outgoing connections (Remote Desktop Client): Choose this option if the current instance of NVDA is running on a remote desktop client that connects to one or more servers.
- Secure Desktop pass-through: Choose this option if you want to use braille and speech from the user instance of NVDA when accessing the secure desktop. Note that for this to work, you need to make the RDAccess add-on available on the secure desktop copy of NVDA. For this, choose "Use currently saved settings during sign-in and on secure screens (requires administrator privileges)" in NVDA's general settings.
To ensure a smooth start with the add-on, all options are enabled by default. However, you are encouraged to disable server or client mode as appropriate.
This option is only available in server mode. It ensures that the connection will automatically be re-established when the Remote Speech synthesizer is active and the connection is lost, similar to braille display auto-detection.
This option is enabled by default. It is strongly encouraged to leave this option enabled if the Remote Desktop server has no audio output.
When enabled in the client, this option allows you to control driver settings (such as synthesizer voice and pitch) from the remote system. Changes made on the remote system will automatically reflect locally.
This client option, available on installed copies of NVDA, ensures that the client portion of NVDA is loaded in your remote desktop client even when NVDA is not running.
To use the client portion of RDAccess, changes need to be made in the Windows Registry. The add-on ensures that these changes are made under the profile of the current user, requiring no administrative privileges. Therefore, NVDA can automatically apply the necessary changes when loaded and undo these changes when exiting NVDA, ensuring compatibility with portable versions of NVDA.
This option is disabled by default. However, if you are running an installed copy and you are the only user of the system, it is advised to enable this option for smooth operation when connecting to a remote system after NVDA starts.
This option, enabled by default, ensures that the client portion of RDAccess is loaded in the Microsoft Remote Desktop client (mstsc) when starting NVDA. Changes made through this option will be automatically undone when exiting NVDA unless persistent client support is enabled.
This option, enabled by default, ensures that the client portion of RDAccess is loaded in the Citrix Workspace app when starting NVDA. Changes made through this option will be automatically undone when exiting NVDA unless persistent client support is enabled.
This option is available only under the following conditions:
- Citrix Workspace is installed. Note that the Windows Store version of the app is not supported due to limitations in the app itself.
- It is possible to register RDAccess under the current user context. After installing the app, you have to start a remote session once to enable this.
There are important points to note when using RDAccess with the Citrix Workspace app:
- The Windows Store variant of the app is not supported.
- After installing Citrix Workspace, you need to start a remote session once to let RDAccess register itself. This occurs because the application copies system settings to user settings during the initial session setup. Following this, RDAccess can register itself under the current user context.
In Citrix Virtual Apps and Desktops 2109, Citrix enabled the so-called virtual channel allow list, restricting third-party virtual channels, including the channel required by RDAccess, by default. For more information, see this Citrix blog post.
Explicitly allowing the RdPipe channel required by RDAccess is not yet tested. For now, it is best to disable the allow list altogether. If your system administrator has concerns, feel free to address the issue here.
To report an issue or contribute, refer to the issues page on Github.
This add-on relies on RD Pipe, a library written in Rust backing the remote desktop client support. RD Pipe is redistributed as part of this add-on under the terms of version 3 of the GNU Affero General Public License.
[[!tag dev beta]]