From bdaa46a67624c34335bbddb3439ed78e9ea386b8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?P=C5=99emysl=20Janouch?= Date: Sun, 27 Sep 2015 01:32:57 +0200 Subject: Convert README to AsciiDoc --- README.adoc | 61 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 61 insertions(+) create mode 100644 README.adoc (limited to 'README.adoc') diff --git a/README.adoc b/README.adoc new file mode 100644 index 0000000..f19b92c --- /dev/null +++ b/README.adoc @@ -0,0 +1,61 @@ +sensei-raw-ctl +============== +:compact-option: + +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. + +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 +available. On Ubuntu and its derivates, you should be able to find it in your +System Settings. + +Supported devices +----------------- + - SteelSeries Sensei Raw + - SteelSeries Call of Duty: Black Ops II + - SteelSeries Guild Wars 2 + +Installation +------------ +Build dependencies: cmake >= 2.8.5, help2man + +Runtime dependencies: libusb >= 1.0, gtk+ >= 3.0 (optional) + + $ git clone git://github.com/pjanouch/sensei-raw-ctl.git + $ mkdir sensei-raw-ctl/build + $ cd sensei-raw-ctl/build + $ cmake .. -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Debug + # make install + +Note that there's no `make uninstall` and the GUI needs to be installed in the +right location in order to work correctly. + +If you don't want the GUI frontend, append `-DBUILD_GUI=NO` to the cmake +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. + +For Debian-based distros, you can do the following instead of the last step: + + $ cpack -G DEB + # dpkg -i sensei-raw-ctl-*.deb + +Note that for versions of CMake before 2.8.9, you need to prefix cpack with +`fakeroot` or file ownership will end up wrong. + +Contributing and Support +------------------------ +Use this project's GitHub to report any bugs, request features, or submit pull +requests. If you want to discuss this project, or maybe just hang out with +the developer, feel free to join me at irc://anathema.irc.so, channel #anathema. + +License +------- +'sensei-raw-ctl' is written by Přemysl Janouch . + +You may use the software under the terms of the ISC license, the text of which +is included within the package, or, at your option, you may relicense the work +under the MIT or the Modified BSD License, as listed at the following site: + +http://www.gnu.org/licenses/license-list.html -- cgit v1.2.3