NVDA Volume Adjustment

Adjust the volume level of all audio devices installed in the system and each running program separately using simple keyboard shortcuts.

You can always change the default keyboard shortcuts to your preferred ones through the NVDA input gestures dialog.

Features

Switch between audio sources

To go to the previous or next audio source you can use the NVDA+Windows+ left or right arrow key combinations. The list consists of two parts - system audio devices and running audio sessions. Switching occurs cyclically in a circle like NVDA settings circle.

Through the add-on settings panel you can hide any items in this list.

Switching between audio sessions can occur automatically when switching to the window of the corresponding program - this mode can be enabled in the add-on settings panel.

Note: The list of audio sessions changes dinamicly and depends on the running programs.

Adjust the volume level

When the sound source is selected you can change its volume level using the following commands:

Note: The volume changes by one percent per one keypress by default. This value can be changed in the settings panel in the range from 1 to 20.

Adjust the volume of the selected channel

For the selected sound source is also available to adjust the volume of its individual channels:

Note: Channel volume control is currently available only for audio devices.

Quick switching between audio output devices

To switch the output of all NVDA sounds to the next available audio device, simply press NVDA+Windows+PageUp.

And to return to the previous audio device, use NVDA+Windows+PageDown.

In addition, to quickly switch the NVDA audio output to the selected audio device, you can use the NVDA+Windows+ function keys from F1.

Note: The separate switching functions are created for all output audio devices detected in the system. All of these features are displayed in the "Input Gestures" dialog, where you can assign activation commands to each of the detected devices.

Add-on settings panel

The following options allows to flexibly adjust the behavior of the add-on and the list of audio resources to switch between them.

Announce the state of the sound source when switching

If this checkbox is checked, during the switching between audio sources or between channels, their current status will be announced, namely the volume level or mute indicator.

Step to change the volume level

The minimum value to which the volume level will be changed with a one keypress. You can set value from 1 to 20 points.

Automatic audio session switching

If this check box is checked, the add-on will be automatically switching to the audio session that corresponds to the program in focus.

For example, if you are currently browsing a website in Firefox, the add-on will detect this and automatically switch to the Firefox audio session. And you can immediately adjust the volume level for the current process without finding it in the list.

Hide audio sessions with the same names

Sometimes, when runs some programs, there are openning multiple audio sessions with the same names. This option allows to hide such audio sessions.

Hide processes

In this list of check boxes you can mark the processes that you want to hide from the main list. These can be, for example, service programs.

The "Update" button is used to update the list of all running processes and available audio sessions. The all checked elements remain as marked.

"Clear" button - uncheck all checked elements and removes obsolete items.

Control all available audio devices

Enables advanced features of the add-on, namely the ability to adjust the volume of all audio devices detected in the system.

For unknown reasons, this feature causes errors on some systems, so it is marked as experimental.

Hide audio devices

If you don't use one or more audio devices and do not want them to be present when switching between audio sources, you can easily remove them from the main list by simply checking them in the settings panel.

The "Update" button is used to scan all audio devices on the system and display updated information. And all checked elements are remain as marked.

"Clear" button - uncheck all checked elements and removes obsolete items.

Mute the volume

The volume mute feature can work in two modes:

  1. Completely turn off the audio source. To enable this mode, you must select the appropriate option in the mutting mode selection list.
  2. Decrease the volume level by the percentage value that can be adjusted with the slider in the add-on settings panel.

Note: It is possible to restore the volume level for all available muted audio sources when NVDA shutdown. Because the list of audio sessions changes dynamically, the volume will only be restored for currently available programs that play audio.

Using default keyboard shortcuts

If you don't planning to use all the features of the add-on. In the settings panel, you can disable the default key combinations for all available functions. Then you can assign your own keyboard shortcuts through the standard NVDA "Input Gestures..." dialog only for those functions that interest you.

Contributions

We are very grateful to everyone who made the effort to develop, translate and maintain this add-on:

Known issues

In some systems, the scanning function of all available audio devices causes errors for unknown reasons. This is a known issue with the third-party PyCaw module that has not yet been resolved.

Change log

Version 1.3.4

Version 1.3.3

Version 1.2

Version 1.1

Version 1.0: features of implementation

Altering of add-on source code

You may clone this repo to make alteration to NVDA Volume Adjustment.

Third Party dependencies

These can be installed with pip:

To package the add-on for distribution

  1. Open a command line, change to the root of this repo
  2. Run the scons command. The created add-on, if there were no errors, is placed in the current directory.