nvda-addon-voicemeeter/README.md

NVDA Addon Voicemeeter

Control Voicemeeter with global hotkeys.

Requirements

• NVDA screen reader

Install

This addon can be installed through the Add-on store, Install from external source. Simply download the latest Release and load it with NVDA.

Default Keybinds

Channel Controllers

• NVDA+alt+s: Enable strip controller

• NVDA+alt+b: Enable bus controller.

• NVDA+alt+1: Enable controller index 1 (strip|bus)

• NVDA+alt+2: Enable controller index 2 (strip|bus)

• NVDA+alt+3: Enable controller index 3 (strip|bus)

• NVDA+alt+4: Enable controller index 4 (strip|bus)

• NVDA+alt+5: Enable controller index 5 (strip|bus)

• NVDA+alt+6: Enable controller index 6 (strip|bus)

• NVDA+alt+7: Enable controller index 7 (strip|bus)

• NVDA+alt+8: Enable controller index 8 (strip|bus)

Slider Controllers

• NVDA+alt+g: Enable gain slider controller.
• NVDA+alt+c: Enable comp slider controller.
• NVDA+alt+t: Enable gate slider controller.
• NVDA+alt+d: Enable denoiser slider controller.
• NVDA+alt+a: Enable audibility slider controller.

Sliders

• NVDA+shift+upArrow: Move slider up by 1 step
• NVDA+shift+downArrow: Move slider down by 1 step
• NVDA+shift+alt+upArrow: Move slider up by 0.1 step
• NVDA+shift+alt+downArrow: Move slider down by 0.1 step
• NVDA+shift+control+upArrow: Move slider up by 3 steps
• NVDA+shift+control+downArrow: Move slider down by 3 steps

Channel Parameters

• NVDA+shift+o: Mono
• NVDA+shift+s: Solo
• NVDA+shift+m: Mute
• NVDA+shift+c: MC
• NVDA+shift+k: Karaoke
• NVDA+shift+n: Next Bus Mode
• NVDA+shift+p: Previous Bus Mode

Bus Assignments (A1-A5|B1-B3)

• NVDA+shift+1: Toggle BUS assignment 1
• NVDA+shift+2: Toggle BUS assignment 2
• NVDA+shift+3: Toggle BUS assignment 3
• NVDA+shift+4: Toggle BUS assignment 4
• NVDA+shift+5: Toggle BUS assignment 5
• NVDA+shift+6: Toggle BUS assignment 6
• NVDA+shift+7: Toggle BUS assignment 7
• NVDA+shift+8: Toggle BUS assignment 8

Announcements

• NVDA+shift+q: Announce current controller.
• NVDA+shift+a: Announce Voicemeeter kind and version.

Configuration

By placing a file named nvda_settings.json in User Home Directory / Documents / Voicemeeter (the same place as your Voicemeeter xml profiles) you can change most of the default keybinds.

The voicemeeter key can take one of three values:

• basic
• banana
• potato

example:

{
  "voicemeeter": "banana",
  "bits": 64,
  "keybinds": {
    "NVDA+alt+k": "strip_mode",
    "NVDA+alt+l": "bus_mode",
    "NVDA+alt+g": "gain_mode",
    "NVDA+alt+c": "comp_mode",
    "NVDA+alt+t": "gate_mode",
    "NVDA+alt+d": "denoiser_mode",
    "NVDA+alt+a": "audibility_mode",
    "NVDA+shift+q": "announce_controller",
    "NVDA+shift+z": "announce_voicemeeter_version",
    "NVDA+shift+o": "rotate_mono",
    "NVDA+shift+s": "toggle_solo",
    "NVDA+shift+m": "toggle_mute",
    "NVDA+shift+c": "toggle_mc",
    "NVDA+shift+k": "rotate_karaoke",
    "NVDA+shift+n": "rotate_bus_mode_next",
    "NVDA+shift+p": "rotate_bus_mode_previous",
    "NVDA+shift+upArrow": "slider_increase_by_point_one",
    "NVDA+shift+downArrow": "slider_decrease_by_point_one",
    "NVDA+shift+alt+upArrow": "slider_increase_by_one",
    "NVDA+shift+alt+downArrow": "slider_decrease_by_one",
    "NVDA+shift+control+upArrow": "slider_increase_by_three",
    "NVDA+shift+control+downArrow": "slider_decrease_by_three",
    "NVDA+control+1": "bus_assignment",
    "NVDA+control+2": "bus_assignment",
    "NVDA+control+3": "bus_assignment",
    "NVDA+control+4": "bus_assignment",
    "NVDA+control+5": "bus_assignment",
    "NVDA+control+6": "bus_assignment",
    "NVDA+control+7": "bus_assignment",
    "NVDA+control+8": "bus_assignment"
  }
}

Would make the following changes:

• load the plugin in banana mode (default is potato)
• override the bits of Voicemeeter GUI to 64 (default is 32)
• change the strip_mode and bus_mode binds to NVDA+alt+k and NVDA+alt+l respectively
• change the announce_voicemeeter_version bind to NVDA+shift+z
• changes the bus assignment binds to NVDA+control+number

All other binds would then be defaults.