VolumeControl.SDK 5.2.2

<p align="center"> <a href="https://radj307.github.io/volume-control"><img alt="[Volume Control Banner]" src="https://i.imgur.com/rMbNIhU.png"></a><br/> <a href="https://github.com/radj307/volume-control/releases/latest"><img alt="GitHub tag (latest SemVer)" src="https://img.shields.io/github/v/tag/radj307/volume-control?color=e8e8e7&label=Latest%20Release&logo=github&logoColor=e8e8e7&sort=semver&style=flat-square"></a>   <a href="https://github.com/radj307/volume-control/releases"><img alt="Downloads" src="https://img.shields.io/github/downloads/radj307/volume-control/total?color=e8e8e7&logo=github&logoColor=e8e8e7&style=flat-square"></a>   <a href="https://github.com/radj307/volume-control-cli"><img alt="Volume Control CLI Latest Version" src="https://img.shields.io/github/v/tag/radj307/volume-control-cli?color=e8e8e7&logo=github&logoColor=e8e8e7&label=Latest%20VCCLI%20Version&style=flat-square"></a> </p>

Simple, universal application-specific volume hotkeys & more.
Designed for adjusting the volume of your music independently of other programs, such as games and VoIP.

What it does

• Adds completely user-configurable global hotkeys to Windows.
  • You can add, remove, and rename hotkeys, as well as configure the 'action' that they perform.
    This requires enabling 'Advanced Hotkey Mode', which is a fancy way of saying 'Check the box labelled 'Advanced Hotkeys', which is located in the Settings tab'
  • The hotkey actions mentioned earlier are fairly diverse, and can be expanded in the form of user-created plugins.
• Integrates a functionally superior alternative to the Windows Audio Mixer.
  • Includes volume slider trackbars and textboxes so you can specify a volume level with the keyboard.
    • Like the Windows Audio Mixer, you can do this with any running process independently at any time.
  • Allows you to specify the 'target' application using the mixer, in addition to the target switching hotkeys.

Requirements

• A keyboard.

Windows Version Compatibility

We've tested Volume Control on Windows 10, it should be compatible with any version of Windows since Vista, however this is untested.

Unconfirmed

If you use one of these operating systems, please fill out a compatibility report form.
(If everything works it should take less than 30 seconds. If there is an issue, we'll fix it ASAP)

• Windows Vista
• Windows 7
• Windows 8
• Windows 8.1
• Windows 11

Getting Started

Installation

• Download the latest release
• Save VolumeControl.exe to a location of your choice.
  If you're unsure about where to choose as a location, create a directory in your user folder and place it inside of that: C:\Users\<USERNAME>\VolumeControl\VolumeControl.exe

Setup

Before starting the program for the first time, you have to unblock the executable from the properties menu.
This is necessary because Windows Defender requires a paying >$300 a year for a Microsoft-approved publishing certificate in order to prevent Windows Defender from blocking it.
If you're unsure, you're can always run it through VirusTotal first, or check the source code yourself.

1. R+Click on VolumeControl.exe in the file explorer and select Properties in the context menu.
2. Check the box next to Unblock:
   
3. Click Ok to save the changes.

Usage

First, enable the Volume Up & Volume Down hotkeys from the Hotkeys tab by checking the box to the left of the hotkey name. If you don't have a volume slider, change the key from the dropdown. You can also set a modifier key with the checkboxes to the right of the dropdown.

NOTE: Hotkeys cannot be enabled if their associated key is set to None.

Next, let's set a target application to test the hotkeys with.
Start playing some audio from any application, then return to the Mixer tab, click Reload, then click the Select button next to the test application, and try using the volume hotkeys.

In the settings tab, you can change how the application behaves such as which audio device is controlled, enable or disable the toast notification, enable advanced hotkeys, set the volume step (how much the volume will increase on decrease when the hotkeys are pressed), tell the application to run on startup, and more!

By enabling notifications, you will see a toast notification in the bottom right of your screen when you switch target sessions. This tells you which session is currently selected. Using the Un/Lock Session hotkey, you can prevent changing the targeted audio device. The border of the toast notification will be red when the currently targeted session is locked. You can press the hotkey again to unlock the session.

If you want to add or remove hotkeys, you can press the Advanced Hotkeys button in the Settings tab to enable the advanced features. Now the Hotkeys tab will have additional customisability so you can create new hotkeys, and change the action of each hotkey when it is pressed. You can reset all hotkeys to their default value by pressing the Reset Hotkeys button in the Settings tab. Note that this will also remove any additional hotkeys you have created.

Addon Development

Want to develop an addon for Volume Control?
See the github pages site for instructions and API documentation.

VolumeControlCLI

Volume Control CLI has moved to its own repo after I rewrote it in C++.

Contributing

If you want to improve/add a feature and you are familiar with C#, pull requests are always welcomed!

Guidelines

Please follow these guidelines when submitting pull requests:

• Briefly test the code to ensure that it can compile & run.
• Format & organize your code.
• Write/update documentation in xmldoc format for anything that is accessible via the SDK.
  If you're using Visual Studio, you will see compiler warnings for undocumented publicly-accessible objects/methods.