VolumeControl.SDK 6.0.0

.NET 6.0
There is a newer version of this package available.
See the version list below for details. 
dotnet add package VolumeControl.SDK --version 6.0.0
NuGet\Install-Package VolumeControl.SDK -Version 6.0.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="VolumeControl.SDK" Version="6.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
paket add VolumeControl.SDK --version 6.0.0
#r "nuget: VolumeControl.SDK, 6.0.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
// Install VolumeControl.SDK as a Cake Addin
#addin nuget:?package=VolumeControl.SDK&version=6.0.0

// Install VolumeControl.SDK as a Cake Tool
#tool nuget:?package=VolumeControl.SDK&version=6.0.0

<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>

A universal, portable, and extensible hotkey framework that lets you control the volume of specific applications, and a whole lot more.
Designed for adjusting the volume of your music independently of other programs, such as games and VoIP.

What It Does

  • Makes your keyboard's volume slider useful
  • Provides you with an alternative to media keys if you don't have them
  • Adds a fully configurable hotkey framework that can be extended via user-created addons
  • Has all of the same features as Windows' Volume Mixer
  • And more!

How does it work?

Volume Control uses the same method as the built-in windows volume mixer to modify the volume of specific applications, and the Win32 API to create hotkey combinations; resulting in little to no latency when pressing a hotkey.

You can have an unlimited number of distinct hotkey combinations at the same time, and each hotkey can be assigned an action. These determine what happens when you press the associated key combination. Most common actions are provided by default, such as Volume Up, Volume Down, & Toggle Mute. You can also write your own actions in C# and use them in Volume Control.

Getting Started

Getting started is simple; first, download the latest release.

Installation

Because Volume Control is portable, there is no installation required.
Simply move VolumeControl.exe to a location of your choice, and run it.

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:
    alternate text is missing from this package README image
  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. View of the Hotkeys Tab

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.

View of the Mixer Tab

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!

View of the Settings Tab

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.

View of the toast notification View of the toast notification when an audio session is locked

If you want to add or remove hotkeys, you can press the Edit Mode button to enable editing. 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. Note that this will also remove any additional hotkeys you have created.
View of the advanced hotkeys

⚠️ Note

Some applications that use the DirectInput API (dinput) - usually games - may cause issues with Volume Control's hotkeys.
In many cases you can resolve this by running Volume Control as an Administrator. (See issue #44)

Troubleshooting

The first step when troubleshooting is always to delete volumecontrol.json and re-launch; this fixes the vast majority of bugs.
If this does not fix your problem, post a bug report and we'll do our best to help.

Contributing

See CONTRIBUTING.md for more information.

Addon Development

Want to develop an addon for Volume Control?
Get started with the tutorial!
We also have doxygen-generated API Documentation available online.

Product Compatible and additional computed target framework versions.
.NET net6.0-windows7.0 is compatible.  net7.0-windows was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
6.6.3 153 11/22/2023
6.6.1 92 11/13/2023
6.6.0 81 11/13/2023
6.6.0-pr1 68 11/12/2023
6.5.2 75 11/8/2023
6.5.0 85 11/3/2023
6.4.0 108 10/28/2023
6.3.0 113 10/24/2023
6.3.0-debug 77 10/25/2023
6.2.0 108 10/21/2023
6.2.0-rev1 87 10/21/2023
6.1.1 101 10/18/2023
6.1.1-SelectActiveApplication 66 10/19/2023
6.1.1-rev1 72 10/19/2023
6.1.0 87 10/18/2023
6.1.0-pr1 70 10/12/2023
6.0.5 106 10/3/2023
6.0.4 97 10/1/2023
6.0.3 95 9/29/2023
6.0.2 97 9/27/2023
6.0.1 96 9/23/2023
6.0.0 285 1/13/2023
6.0.0-pr9.1 46 9/16/2023
5.2.6 351 8/26/2022
5.2.5 336 8/19/2022
5.2.4 331 8/17/2022
5.2.3 346 8/7/2022
5.2.2 364 8/6/2022
5.2.1 356 8/6/2022
5.2.0.1 357 8/5/2022
5.2.0 362 8/5/2022
1.0.0 348 8/3/2022

Full Changelog: https://github.com/radj307/volume-control/commits/main