elemc / msi-keyboard Goto Github PK

This program can change the colors on your MSI steelseries keyboard. Depending on the model, the keyboards have 3 or 7 regions that can have different colors for each one.

Prerequisites (tested on Ubuntu 14.04 only):

Qt 5.2 or later (Ubuntu includes Qt 5.2.1)
libhidapi-dev
libhidapi-libusb0

To build:

qmake
make

Make sure to copy 99-msi.rules to /etc/udev/rules.d unless you want to run the program as root. Requires a reboot or maybe just a reload of udev rules to work correctly.

To use:

Usage: ./msi-keyboard [options]
Keyboard color changer for MSI steelseries keyboards

Options:
  -h, --help     Displays this help.
  -v, --version  Displays version information.
  -m, --mode <mode>      set color <mode>: normal, gaming, breathe, demo, wave
  -r, --rgb <rgb>      set an <rgb> color using the format:
                       region,red,green,blue with rgb values between 0 and 255
  -c, --color <color>  set a <color> preset using the format:
                       region,color,intensity (only valid for left/middle/right
                       regions). When using this option, a mode must be
                       specified with -m

Available regions:

left
middle
right
logo
front-left
front-right
touchpad

Available color presets (only for left/middle/right regions):

off
red
orange
yellow
green
sky
blue
purple
white

Available preset intensities (only for left/middle/right regions):

high
medium
low
light

Example:

./msi-keyboard -m normal -c left,red,high -c middle,purple,high -c right,sky,high -r touchpad,255,0,0 -r logo,255,255,255

Licensing:

This program is licensed as 3-clause BSD, terms are available in the COPYING file.

Based on a nodejs version of msi-keyboard by Steve Lacy of wearefractal.com:

Copyright (c) 2013 | Steve Lacy slacy.me | Fractal wearefractal.com [email protected]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

$The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.