nvda-voicemeeter/README.md
2023-09-06 00:42:49 +01:00

2.9 KiB

pdm-managed Code style: black Imports: isort

NVDA Voicemeeter

A remote control app designed to be used with the NVDA screen reader.

This is still an early release but it should be usable.

Requirements

Run

To run this project from source you'll need to first download the Controller Client and place the files into the directory controllerClient. For more information check the documentation linked.

You should be able to then run the example \__main__.py. Adjust the KIND_ID value to whichever version of Voicemeeter you use.

If you want to get started quickly and easily I have uploaded some compiled versions of the app in the Releases section.

Use

The app presents four tabs Settings, Physical Strip, Virtual Strip and Buses. Navigate between the tabs with Control + TAB. All controls in the app can be navigated between using TAB.

The following controls offer context menus accessed by pressing SPACE or ENTER:

  • Hardware In
  • Hardware Out
  • Patch Composite

All other buttons can be triggered by pressing SPACE or ENTER.

To adjust Patch Asio Inputs to Strips and Patch Insert values use UP and DOWN arrows when in focus.

To rename a strip/bus channel navigate to the relevant tab, then press F2. This will open a popup window where you can set the channel index (with a spinbox) and set the new label using a text input box. Pressing the OK button with an empty text input will clear the label. In this case the label will be read as a default value for that channel. For example, if the leftmost Strip label were cleared, the screen reader will now read Hardware Input 1. Pressing Cancel will close the popup window with no affect on the label.

A single menu item Voicemeeter can be opened using Alt and then v. The menu allows you to:

  • Restart Voicemeeter audio engine
  • Save/Load current settings (as an xml file)
  • Set a config to load automatically on app startup.

The Save Settings option opens a popup window with two buttons, Browse and Cancel. Browse opens a Save As dialog, Cancel returns to the main app window. Load Settings and Load on Startup both open an Open dialog box immediately.

Issues

If you have any questions/suggestions feel free to raise an issue or open a new discussion.