Uh oh!
There was an error while loading.Please reload this page.
- Notifications
You must be signed in to change notification settings - Fork99
Audio visualizer and effects engine for RGB keyboards, mice, and accessories using the OpenRGB SDK. Supports Windows, Linux, and MacOS. Issue tracker on GitLab (https://gitlab.com/CalcProgrammer1/KeyboardVisualizer)
License
CalcProgrammer1/KeyboardVisualizer
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
Keyboard Visualizer turns your OpenRGB-supported RGB setup into a spectacular light show for your music. Keyboard Visualizer is able to listen to any input or loopback audio device on your computer so it can visualize audio from any music player, website, game, or other application.
To use Keyboard Visualizer with your setup, you must first install OpenRGB and set it up to detect all of your RGB devices. OpenRGB can be found here:
https://gitlab.com/CalcProgrammer1/OpenRGB
Development on this version has stalled as I'm not interested in supporting a multitude of proprietary SDKs that change constantly and only work on Windows. This version remains as Keyboard Visualizer 3.x and downloads are still available in the Release submodule. I will accept pull requests for this version if others wish to keep it alive, but I plan to focus primarily on the OpenRGB version (4.x) going forwards.
Pre-built binaries are available under the Releases section on GitLab.
If you wish to build the application yourself:
- Download the latest Visual Studio Community Edition and Qt Creator.
- git clonehttps://gitlab.com/CalcProgrammer1/KeyboardVisualizer
- git submodule update --init --recursive
- Open the KeyboardVisualizer.pro project in Qt Creator.
- Use the MSVC compiler kit, either 32- or 64-bit, to build the application.
- Run the project from Qt Creator. If you want to use your custom build standalone, download the latest matching Release package and replace the OpenRGB.exe in it with your new build.
Pre-built binaries are not currently available for Linux
You can build the project using Qt Creator or on the command line. The commands listed here work for Debian-based distros.
- sudo apt install build-essential qtcreator qt5-default libopenal-dev
- git clonehttps://gitlab.com/CalcProgrammer1/KeyboardVisualizer
- cd KeyboardVisualizer
- git submodule update --init --recursive
- qmake KeyboardVisualizer.pro
- make -j8
Run the application with ./KeyboardVisualizer
There are many settings you can tweak to make Keyboard Visualizer work with your audio setup and to personalize it to your liking.
* Amplitude - How reactive the visualizer is to sound. If it is not responding, or is responding with a low level, increase this value.* Background Brightness - How bright the background layer is (0-100%)* Average Size - How many bars of input to combine, increase for a less detailed output that may look better on devices with low LED counts.* Decay - How much of the previous value is retained from step to step. Higher values make the visualizer less flickery but seem slower to react, while low values are fast and flickery. (0-100%)* Delay - How many milliseconds to wait between each device update. Lower values give a higher "frame rate" but can cause flicker or other issues on certain setups.* Normalization Offset - Adjusts amplitude of bass frequencies, increase if your song lacks bass and decrease if your song is bass heavy* Normalization Scale - Amount to scale up each consecutive frequency bar over normalization offset, to amplify higher frequencies. Increase if the right side of the visualizer is low.* Filter Constant - Amount of signal to blend per update, 0-1 floating point. A value of 1 disables filtering and updates the spectrum every cycle, a value between 0 and 1 blends the new value with the previous value, slowing the response. A value of 0 holds the existing value and ignores new samples.* FFT Window Mode - Select between None, Hamming, Hanning, and Blackman windowing functions (see https://en.wikipedia.org/wiki/Window_function for the math behind FFT windowing)* Background Mode - Select between various static and animated background colors and patterns* Foreground Mode - Select between various static foreground colors and patterns* Single Color Mode - Select between various color options for devices that use the single color effect* Average Mode - Select between discrete bars (binning) or a smoothed line (low pass) output* Animation Speed - Speed of background and foreground animated patterns, default 100, can be negative to reverse the direction of the pattern, can be increased to speed up the pattern or decreased to slow it down.* Filter Constant - A low pass filter constant between 0 and 1. A value less than 1 slows the response of the visualization, which makes for a less jumpy, smoother effect the lower the value is.* Background Timeout - How long to wait (in multiples of 10 milliseconds) before fading the background in.
Keyboard Visualizer allows you to save your custom settings in two different ways. You can pass parameters in on the command line (which is useful for creating shortcuts) or you can save a settings file in the same directory that the .exe is stored called settings.txt. The parameters are as follows:
Available command line commands: help - Display this message and quit startminimized - Start in system trayAvailable command line arguments: Usage: argument1=value1 argument2=value2 ... amplitude - Adjust the amplitude of the visualizer bkgd_bright - Adjust the background brightness avg_size - Number of points to average decay - Percentage of value to decay every step delay - Milliseconds between each device update nrml_ofst - Normalization offset, floating point value nrml_scl - Normalization scale, floating point value fltr_const - Low pass filter constant, floating point value 0-1 window_mode - FFT windowing mode selector, values are: - 0: No windowing - 1: Hanning window - 2: Hamming window - 3: Blackman window bkgd_mode - Background mode, values are: - 0 Black - 1 White - 2 Red - 3 Orange - 4 Yellow - 5 Green - 6 Cyan - 7 Blue - 8 Purple - 9 Green/Yellow/Red - 10 Green/White/Red - 11 Blue/Cyan/White - 12 Red/White/Blue - 13 Rainbow Bars - 14 Rainbow Bars Inverse - 15 Original - 16 Rainbow - 17 Color Wheel - 18 Spectrum Cycle frgd_mode - Foreground mode, values are: - 0 Black - 1 White - 2 Red - 3 Orange - 4 Yellow - 5 Green - 6 Cyan - 7 Blue - 8 Purple - 9 Green/Yellow/Red - 10 Green/White/Red - 11 Blue/Cyan/White - 12 Red/White/Blue - 13 Rainbow Bars - 14 Rainbow Bars Inverse - 15 Original - 16 Rainbow - 17 Color Wheel - 18 Spectrum Cycle single_color_mode - Single color mode, values are: - 0 Black - 1 White - 2 Red - 3 Orange - 4 Yellow - 5 Green - 6 Cyan - 7 Blue - 8 Purple - 9 Background - 10 Follow Background - 11 Follow Foreground avg_mode - Visualizer averaging mode - 0: Binning - 1: Low-pass filtering anim_speed - Animation Speed (percent) server - Configure this instance as a server for synchronization - Takes what port to serve on as argument, i.e. server=1234 client - Configure this instance as a client for synchronization - Takes the IP/hostname of the server and port as arguments, - i.e. client=192.168.1.100,1234
* Spectrograph - Shows vertical bars for each frequency in the audio* Bar - Shows a single bar representing bass frequencies* Single Color - Brightness and color represent strength of bass frequencies
I created this project for fun mostly, and Razer's support of sending free products for me to integrate is awesome, but several people have asked if I'd accept donations. I've gotten back into cryptocurrency and mining recently so if you want to send some Bitcoin, Dogecoin, or Ethereum my way you can do so with the addresses below. I don't want to bother with PayPal and its ugly fees and I detest online advertising and block all ads on my PCs so I would never put ads on my videos or programs.
Bitcoin: 1N83YPu7btXYadPS1neB9zX7X1QTdpyZQ
Dogecoin: D7nqJZ3dyfCMRvS6J5jpoxerpteUG5z7Pm
Ethereum: 0xb5023019E6789af4887aED2056E471DF0f4c8e93
Monero: 44p8QfKTHxA65PeY1HabFsaZnayVu36h2eNHsTVcHzg5EeUDszmK91aTaAc4otCRdL4644gMzatb85bWyZB7vfK78siS962
About
Audio visualizer and effects engine for RGB keyboards, mice, and accessories using the OpenRGB SDK. Supports Windows, Linux, and MacOS. Issue tracker on GitLab (https://gitlab.com/CalcProgrammer1/KeyboardVisualizer)
Topics
Resources
License
Uh oh!
There was an error while loading.Please reload this page.
Stars
Watchers
Forks
Sponsor this project
Uh oh!
There was an error while loading.Please reload this page.
Packages0
Uh oh!
There was an error while loading.Please reload this page.
Contributors12
Uh oh!
There was an error while loading.Please reload this page.