A remote control app for Voicemeeter, designed to be used with the NVDA screen reader.
For an outline of this projects goals see the SPECIFICATION.
- NVDA screen reader
- NVDA's Controller Client files
- Python 3.10 or greater
First clone the source files from this repository and install the dependencies.
git clone https://github.com/onyx-and-iris/nvda-voicemeeter.git
cd nvda-voicemeeter
pip install .
Then download the Controller Client and place the dll files into the directory controllerClient.
Your directory structure should look like this:
├── controllerClient/
├── x64/
├── nvdaControllerClient64.dll
├── x86/
├── nvdaControllerClient32.dll
If you want to get started quickly and easily I have uploaded some compiled versions of the app in the Releases section.
Once the repository is downloaded and the controller client files in place you can launch the GUI with the following __main__.py:
import voicemeeterlib
import nvda_voicemeeter
KIND_ID = "potato"
with voicemeeterlib.api(KIND_ID) as vm:
with nvda_voicemeeter.draw(KIND_ID, vm) as window:
window.run()May be one of the following:
basicbananapotato
The app presents four tabs Settings, Physical Strip, Virtual Strip and Buses. Navigate between the tabs with Control + TAB and Control + SHIFT + TAB or once focused on any tab, Left and Right arrow keys.
All controls within the tabs may be navigated between using TAB.
The following controls offer context menus accessed by pressing SPACE or ENTER:
- Hardware In
- Hardware Out
- Patch Composite
Press ESCAPE to exit any context menu.
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 access Advanced Settings you may press the Advanced Settings button or use Control + A when in the Settings tab.
You will find in each of these tabs two nested tabs,Buttons and Sliders. For each nested tab you will find the controls appropriate for the Voicemeeter kind and channel type.
All buttons may be triggered by pressing SPACE or ENTER.
All sliders may be controlled in three different ways:
Left|Right arrowto move a slider by 1 step.Shift + Left|Right arrowto move a slider by 0.1 steps.Control + Left|Right arrowto move a slider by 3 steps.
To reset a slider back to its default value you may use Control + Shift + R.
To rename a strip/bus channel focus on the channel in question and press F2. Then enter the new channel name into the text input widget and press the Ok button.
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.
For potato version only, you may access advanced Compressor and Gate sliders. Simply focus any Gate or Compressor slider and press Control + A. This will open a popup window where you can navigate between the different sliders with TAB. Move the sliders with the same binds you would for normal sliders. However, there are a couple of extra binds for certain controls.
For Compressor Release you may use:
Alt + Left|Right arrowto move the slider by 10 steps.Alt + Control + Left|Right arrowto move the slider by 50 steps.
For Gate BP Sidechain, Attack, Hold, Release you may use:
Alt + Left|Right arrowto move the slider by 10 steps.Alt + Control + Left|Right arrowto move the slider by 50 steps.
To reset a slider back to its default value you may use Control + Shift + R.
The Voicemeeter menu can be opened using Alt and then v. It offers the following options:
- 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.
The Theme menu can be opened using Alt and then t. Use this menu to select from a list of coloured themes. Some themes offer higher contrast colours. An application restart is required to load a new theme. Once a theme is selected it will become the default for future startups.
There are a number of quick binds available to assist with faster navigation and general use.
When focused on any one of "Physical Strip", "Virtual Strip" or "Buses" you may use Control + Number to skip to the corresponding channel.
When focused on any single channel (Strip or Bus), the following binds exist:
Alt + Numberwill trigger the Bus output button corresponding to the number. For exampleAlt + 3will trigger theA3buttonControl + Owill trigger the Mono buttonControl + Swill trigger the Solo buttonControl + Mwill trigger the Mute button
You may also enter slider modes which allow for control of the channels sliders until the slider mode is exited. You may access the slider modes with the following binds:
Control + Uwill enter Audibility modeControl + Gwill enter Gain modeControl + Twill enter Gate modeControl + Lwill enter Limit modeControl + Bwill enter Bass modeControl + Iwill enter Mid modeControl + Rwill enter Treble mode
To exit any of the slider modes press Escape.
Once you are in a slider mode you may now control the slider that matches the slider mode. Slider mode binds are the same as the normal slider binds with the addition of the Alt keypress. For example, where you would normally use Right Arrow to shift a slider rightwards by 1 step, in slider mode you would now use Alt + Right Arrow.
If you have any questions/suggestions feel free to raise an issue or open a new discussion.
Mario Loreti for his help in testing and offering feedback during development.
NVAccess for creating the open source NVDA screen reader and its controller client.
Vincent Burel for creating Voicemeeter and its SDK.
FreeSimpleGUI a fork of the now closed source PySimpleGUI project.