.vscode | ||
controllerClient | ||
img | ||
src/nvda_voicemeeter | ||
tests | ||
__main__.py | ||
.gitignore | ||
build.ps1 | ||
LICENSE | ||
pdm.lock | ||
pyproject.toml | ||
README.md |
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
- NVDA screen reader
- NVDA's Controller Client files
- Python 3.10 or greater
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.