Skip to content

A Python script to add hotkeys to Elgato's Wave Link software.

Notifications You must be signed in to change notification settings

Tronnic/wave-link-audio-wrapper

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 

Repository files navigation

🔉 Wave Link Audio Wrapper

This is a Python script that allows you to turn keys on your keyboard into volume controls for Elgato's Wave Link software, and displays a simple popup of the current volume level.

Elgato leaves a websocket open, currently on port 1824, that is intended to be used to communicate between their Wave Link and Stream Deck software. I utilize this websocket connection to send actions based upon whatever the current volume or mute status is.

⚙️ How to Use

Prerequisites

  • Must be using Windows 10/11. This script does not support macOS.

  • You will need to have Elgato's Wave Link software installed for this to work. This script works as of the version: 1.10.1 (2293)

  • A "nerd font" is required to properly display icons. I use SpaceMono, but you can change the font to one of your chosing here: nerdfonts.com

Installation

  • Clone the repo with the command: git clone https://github.com/TheLtWilson/wave-link-audio-wrapper

  • In the cloned folder, install the required dependencies with the command: pip install -r requirements.txt

Running the Script

This small project was made to fit my own needs. If you want to change the keybindings, you will need to open the script and modify it yourself to fit your own needs.

I have the F13, F14, and F15 keys binded to a knob on my keyboard, as such the controls look like the following:

Knob Direction Key Action
Clockwise F13 Volume Up
Counter-clockwise F14 Volume Down
Knob Button F15 Toggle Mute

Once the script has been adjusted to your likings, you can simply run the script by opening it in your file manager and it will run in the background.

You can run the script on startup by adding a shortcut to it in your shell:startup folder.

ℹ️ Notice: My script assumes you always want the script to be running, so if you want to close the script you will need to end the Python process or implement your own hotkey.

⚠️ Handling Errors

Because the script is intended to run in the background without a terminal open, a log file is created in the directory where the script is located. This can be used to determine errors in the script, or get a gist of what the script is doing.

About

A Python script to add hotkeys to Elgato's Wave Link software.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%