brad/steelseries-led
1
0
Fork 0
Code Issues Pull Requests Releases Activity

Merge branch 'markdown_readme' of lb.laboon/steelseried-led into master

Browse Source
This commit is contained in:
L. Bradley LaBoon 2018-06-30 00:14:20 -04:00 committed by Gogs
commit 8840dc6c0a
1 changed files with 12 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
README → README.md
View File

@ -1,5 +1,6 @@
About steelseries-led # steelseries-led
=====================
## About steelseries-led
steelseries-led is a utility for controlling the backlight of the SteelSeries steelseries-led is a utility for controlling the backlight of the SteelSeries
keyboards included in many MSI laptops. The keyboard is broken up into three keyboards included in many MSI laptops. The keyboard is broken up into three
@ -10,7 +11,7 @@ select various other modes such as breathe and wave. The goal of this program
is to replicate that functionality as well as possibly add additional modes and is to replicate that functionality as well as possibly add additional modes and
features. features.
NOTE: While this program may work for other SteelSeries keyboards, it is not **NOTE:** While this program may work for other SteelSeries keyboards, it is not
guaranteed. My development efforts with be focused solely on supporting the guaranteed. My development efforts with be focused solely on supporting the
keyboard included in MSI laptops, specifically the MSI GS60 Ghost. This keyboard included in MSI laptops, specifically the MSI GS60 Ghost. This
keyboard does not have a model name or number as far as I know, but I believe keyboard does not have a model name or number as far as I know, but I believe
@ -23,25 +24,22 @@ correctly is normal mode. For the time being, this requires setting the color
of each section separately, followed by setting the mode to normal. of each section separately, followed by setting the mode to normal.
Required packages ## Required packages
=================
steelseries-led depends on the hidapi library which can be found at: steelseries-led depends on the hidapi library which can be found [here](http://www.signal11.us/oss/hidapi/).
http://www.signal11.us/oss/hidapi/
Compiling and Running ## Compiling and Running
=====================
Running 'make' will compile steelseries-led and produce a single executable. Running `make` will compile steelseries-led and produce a single executable.
You can run 'steelseries-led help' for details on how to use the program and You can run `steelseries-led help` for details on how to use the program and
what arguments are supported. what arguments are supported.
This program must be run with root privileges in order to send data to the This program must be run with root privileges in order to send data to the
keyboard. If you want to avoid this, you can either change the permissions of keyboard. If you want to avoid this, you can either change the permissions of
the device file manually (i.e. 'chmod o+w /dev/bus/usb/<bus>/<device>', where the device file manually (i.e. `chmod o+w /dev/bus/usb/<bus>/<device>`, where
<bus> and <device> can be found by running 'lsusb'), or you can create a udev \<bus> and \<device> can be found by running `lsusb`), or you can create a udev
rule to do this for you at boot. I have had very limited success with the udev rule to do this for you at boot. I have had very limited success with the udev
method, since the rules typically get applied very early in the boot process method, since the rules typically get applied very early in the boot process
before USB devices get initialized. before USB devices get initialized.
@ -50,7 +48,7 @@ before USB devices get initialized.
How to report bugs? How to report bugs?
=================== ===================
Bugs should be reported to L. Bradley LaBoon <me@bradleylaboon.com> Open an issue on the bug tracker.
Please indicate what OS and architecture you are using, as well as output from Please indicate what OS and architecture you are using, as well as output from
the program showing the bug, if possible. Please read this entire README first, the program showing the bug, if possible. Please read this entire README first,