sensei-raw-ctl/README.adoc

66 lines
2.3 KiB
Plaintext
Raw Normal View History

2013-05-26 10:54:42 +02:00
sensei-raw-ctl
2015-02-26 22:59:06 +01:00
==============
2015-09-27 01:32:57 +02:00
:compact-option:
2013-05-26 10:54:42 +02:00
This program makes it possible to change the configuration of your SteelSeries
Sensei Raw mouse from within Linux, *BSD or any other POSIX-compatible system
supported by libusb.
2015-09-27 01:32:57 +02:00
Run `sensei-raw-ctl --help` or `man sensei-raw-ctl` for usage information.
If you don't fancy command line tools, there's also a basic GTK+ frontend
2016-03-07 23:04:06 +01:00
available. On Ubuntu and its derivatives, you should be able to find it in your
System Settings, though this feature has disappeared completely with newer GNOME
versions.
2020-08-22 09:43:10 +02:00
image::sensei-raw-ctl-gui.png[align="center"]
Supported devices
2015-02-26 22:59:06 +01:00
-----------------
- SteelSeries Sensei Raw
- SteelSeries Call of Duty: Black Ops II
- SteelSeries Guild Wars 2
2016-03-10 20:40:42 +01:00
Packages
--------
Regular releases are sporadic. git master should be stable enough.
You can get a package with the latest development version using Arch Linux's
https://aur.archlinux.org/packages/sensei-raw-ctl-git[AUR],
or as a https://git.janouch.name/p/nixexprs[Nix derivation].
2016-03-10 20:40:42 +01:00
2013-05-26 10:54:42 +02:00
Installation
2015-02-26 22:59:06 +01:00
------------
Build dependencies: cmake >= 3.0, help2man +
2015-02-26 22:59:06 +01:00
Runtime dependencies: libusb >= 1.0, gtk+ >= 3.0 (optional)
2018-06-24 05:28:27 +02:00
$ git clone https://git.janouch.name/p/sensei-raw-ctl.git
2015-09-27 01:32:57 +02:00
$ mkdir sensei-raw-ctl/build
$ cd sensei-raw-ctl/build
2015-02-26 22:59:06 +01:00
$ cmake .. -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Debug
# make install
2013-05-26 10:54:42 +02:00
2015-09-27 01:32:57 +02:00
Note that there's no `make uninstall` and the GUI needs to be installed in the
right location in order to work correctly.
2013-06-09 00:15:04 +02:00
2015-09-27 01:35:47 +02:00
If you don't want the GUI frontend, append `-DBUILD_GUI=NO` to the `cmake`
2015-09-27 01:32:57 +02:00
command. The GUI also isn't going to be built if you don't have the GTK+ 3
development packages installed, if your distribution has any.
2013-06-09 00:15:04 +02:00
For Debian-based distros, you can do the following instead of the last step:
2015-09-27 01:32:57 +02:00
2015-04-16 20:05:23 +02:00
$ cpack -G DEB
2015-02-26 22:59:06 +01:00
# dpkg -i sensei-raw-ctl-*.deb
2013-06-27 22:12:02 +02:00
2015-09-27 01:30:19 +02:00
Contributing and Support
------------------------
2018-06-24 05:28:27 +02:00
Use https://git.janouch.name/p/sensei-raw-ctl to report bugs, request features,
or submit pull requests. `git send-email` is tolerated. If you want to discuss
the project, feel free to join me at ircs://irc.janouch.name, channel #dev.
Bitcoin donations are accepted at: 12r5uEWEgcHC46xd64tt3hHt9EUvYYDHe9
2015-09-27 01:30:19 +02:00
2015-02-26 22:59:06 +01:00
License
-------
This software is released under the terms of the 0BSD license, the text of which
is included within the package along with the list of authors.