mirror of
https://github.com/onyx-and-iris/nvda-addon-voicemeeter.git
synced 2026-03-20 20:09:11 +00:00
138 lines
4.6 KiB
Markdown
138 lines
4.6 KiB
Markdown
[](https://pdm-project.org)
|
|
[](https://github.com/astral-sh/ruff)
|
|
|
|
# NVDA Addon Voicemeeter
|
|
|
|
Control [Voicemeeter][voicemeeter] with global hotkeys.
|
|
|
|
## Requirements
|
|
|
|
- [NVDA screen reader][nvda]
|
|
|
|
## Install
|
|
|
|
This addon can be installed through the Add-on store, `Install from external source`. Simply download the [latest Release](https://github.com/onyx-and-iris/nvda-addon-voicemeeter/releases) 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:
|
|
|
|
```json
|
|
{
|
|
"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.
|
|
|
|
[voicemeeter]: https://voicemeeter.com/
|
|
[nvda]: https://www.nvaccess.org/
|