Git Product home page Git Product logo

keyboardvisualizer's Introduction

Keyboard Visualizer Icon

Razer Chroma and Corsair RGB Keyboard Spectrograph Visualizer for Windows and Linux

Binary Windows builds can be downloaded from the Release submodule

You must have the Microsoft Visual C++ 2015 32-bit redistributable package installed to run this program (Windows).

To build this project in Linux, install QT Creator and libopenal-dev, libhidapi-dev and open/build the .pro file.

Settings

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.

Command Line Options and Settings File

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 tray

Available 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
    ledstrip          - LED config strings :
                      - Serial : ledstrip=port,baud,num_leds
                      - (ex.ledstrip=COM1,115200,30)
                      - UDP : ledstrip=udp:client,port,num_leds
                      - (ex.ledstrip=udp:192.168.1.5,1234,30)
    xmas              - COM port, ex. xmas=COM2
    hueplus           - HUE+ config:
                      - hueplus=port,channel,num_leds
                      - channel: 0 -> both channels, 1 -> channel 1, 2 -> channel 2
                      - num_leds: Fans * 8 ex. 3 Fans -> 24
                      - Important for Fans: If you have connected fans on both channels only count the fans on the channel with the most fans
                                            ex. 3 Fans on Ch. 1 4 Fans on CH. 2: num_leds 32 for the 4 Fans
                                            For best Visualizer results don`t connect on one channel 3 fans more than on the other channel
                      - (ex. hueplus=COM4,1,24
    razer_use_keyboard_generic_effect
                     - Use generic effect type in the Razer SDK, allows the use of SDK-unsupported keyboards at the expense of scaling
    razer_use_headset_custom_effect
                      - Use custom effect for headsets, allows smooth color transitions on the Kraken V2 but disables the Kraken V1
    razer_use_chromalink_single_color
                      - Use the single color option for the Chroma Link SDK outputs instead of bar graph option
    razer_disable_chromalink
                      - Disable the Chroma Link SDK, works around a bug in the current Chroma SDK where the Chroma HDK commands are overridden
    razer_chroma_box_mode
                      - razer_chroma_box_mode=mode
                      - 0:  Matrix (use 4 strips for best effect)
                      - 1:  Bar graph per single strip
                      - 2:  Bar graph stretched across 2 strips each
                      - 3:  Bar graph stretched across all 4 strips

Available Visual Effects

* 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

Supported Devices (Windows)

* Razer Chroma SDK

    Keyboards
    - BlackWidow Chroma (spectrograph)
    - BlackWidow Chroma Tournament Edition (spectrograph)
    - DeathStalker Chroma (horizontal bar)
    - BlackWidow X Chroma (spectrograph)
    - BlackWidow X Chroma Tournament Edition (spectrograph)
    - Razer Blade Stealth (spectrograph)
    - Razer Blade (spectrograph)
    - Razer Ornata Chroma (spectrograph)
    
    - Unsupported keyboards may be used in "generic" mode by adding the razer_use_keyboard_generic_effect settings parameter
    - This uses a single effect for all keyboards supported by the SDK core, even those that don't have a device ID
    - Use this setting for support of these otherwise unsupported keyboards:
        - Razer Blade Stealth (late 2016, Kaby Lake) (spectrograph)
        - Razer BlackWidow Chroma V2 (spectrograph)

    Keypads
    - Razer Orbweaver Chroma (spectrograph)
    - Razer Tartarus Chroma (single color)

    Mice
    - Diamondback Chroma (bar and single color)
    - Mamba Tournament Edition (bar and single color)
    - Mamba Chroma Wireless (bar and single color, wired and wireless)
    - DeathAdder Chroma (single color)
    - Naga Epic Chroma (single color, wired only)
    - Naga Chroma (single color)
    - Orochi Chroma (single color, wired only)
    
    Headsets
    - Kraken 7.1 Chroma (single color)
    - Kraken 7.1 Chroma V2 (single color)
    - ManO'War (single color)

    - The Kraken 7.1 Chroma V1 does not support custom effects, so a flickery workaround is used.  If you only have a V2 you
    - can add the settings parameter razer_use_headset_custom_effect to make the V2 output a smooth, non-flickery output but
    - if you also have a V1 or ManO'War connected it will go black.
    
    Mouse Mats
    - Firefly (bar)

    External Graphics Dock
    - Razer Core (bar and single color)

    Other
    - Razer Chroma Mug (bar)

* Corsair CUE SDK

    Keyboards
    - K70 RGB (spectrograph)
    - Likely other CUE SDK supported keyboards (spectrograph), untested

* Cooler Master RGB

	Keyboards
	- Masterkeys Pro L (spectrograph)
	- Masterkeys Pro S (spectrograph)

* Logitech G Gaming SDK

    Keyboards
    - G910 Orion Spark (spectrograph)
    - G810 Orion Spectrum (spectrograph)
    - Other single-zone RGB and Monochrome keyboards (single color)

    Headsets
    - G633 (single color)
    - G933 (single color)

    Mice
    - G600 (single color)
    - G900 Chaos Spectrum (single color)
    - G303 Daedalus Apex (single color)
    - G502 Proteus Spectrum (single color)
* SteelSeries

    Keyboards
    - Apex M800 (spectrograph)

* MSI SteelSeries
    
    Keyboards
    - MSI 3-zone laptop keyboards and additional LED zones (MSI GS63VR, etc) (bar, single color)

* NZXT Hue+

    - Configured using the hueplus=port,num_leds option in the settings file (bar)

* WS28XX Pixel LED Strips

    - Arduino (Serial/USB-Serial) or ESP8266 (UDP over WiFi) may be used for controller
    - WS2812B, WS2811, and compatible LED strips/strings supported
    - Adjust the LEDs value in the Arduino sketch to match the number of LEDs on your LED strip/string
    - Recommended maximum of 90 or so LEDs on Arduino using 115200 baud rate
    - Configure LED strip using the ledstrip command line/settings file parameter
    - Number of LEDs in Arduino sketch must match num_leds parameter in LED command string
    - For serial connected LEDs, -ledstrip=port,baud,num_leds (ex. -ledstrip=COM1,115200,30)
    - For WiFi connected LEDs, -ledstrip=client,port,num_leds (ex. -ledstrip=192.168.1.5,1234,30)

    - For up to 200 LEDs on Arduino using 1000000 baud rate, see my pixel_controller repository
    - This requires AVR Studio 4 + WinAVR to build, but is more efficient by skipping Arduino IDE

Supported Devices (Linux)

* Razer Linux Drivers (https://github.com/terrycain/razer-drivers)

    Keyboards
    - BlackWidow Chroma (spectrograph)
    - BlackWidow Chroma Tournament Edition (spectrograph)
    - DeathStalker Chroma (horizontal bar)
    - Razer Ornata Chroma (spectrograph)
    - Razer Blade Stealth (spectrograph)
    - Razer Blade Pro (spectrograph)

    Keypads
    - Razer Tartarus Chroma (single color)

    Mice
    - Diamondback Chroma (bar and single color)
    - Mamba Tournament Edition (bar and single color)
    - DeathAdder Chroma (single color)

    Headsets
    - Kraken 7.1 Chroma (single color)
    - Kraken 7.1 Chroma V2 (single color)

    Mouse Mats
    - Firefly (bar)

    External Graphics Dock
    - Razer Core (bar and single color)

    Other
    - Razer Chroma Mug (bar)

* SteelSeries

    Keyboards
    - Apex M800 (spectrograph)

* MSI SteelSeries
    
    Keyboards
    - MSI 3-zone laptop keyboards and additional LED zones (MSI GS63VR, etc) (bar, single color)

* NZXT Hue+

    - Configured using the hueplus=port,num_leds option in the settings file (bar)

* WS28XX Pixel LED Strips

    - See the information under the Windows supported devices list.

Donations

  • 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

keyboardvisualizer's People

Contributors

avinashraja98 avatar bl4d3s avatar calcprogrammer1 avatar d-rez avatar dennisblokland avatar pokerzues avatar rsandoz avatar saltybot avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.