aboutsummaryrefslogtreecommitdiff
path: root/README.adoc
diff options
context:
space:
mode:
authorPřemysl Janouch <p.janouch@gmail.com>2015-09-27 01:32:57 +0200
committerPřemysl Janouch <p.janouch@gmail.com>2015-09-27 01:34:24 +0200
commitbdaa46a67624c34335bbddb3439ed78e9ea386b8 (patch)
tree1039fc576ae009404c9610b2f93f64697ebc27a9 /README.adoc
parent6bfc9b0f1a7527b7425860436132508546471a27 (diff)
downloadsensei-raw-ctl-bdaa46a67624c34335bbddb3439ed78e9ea386b8.tar.gz
sensei-raw-ctl-bdaa46a67624c34335bbddb3439ed78e9ea386b8.tar.xz
sensei-raw-ctl-bdaa46a67624c34335bbddb3439ed78e9ea386b8.zip
Convert README to AsciiDoc
Diffstat (limited to 'README.adoc')
-rw-r--r--README.adoc61
1 files changed, 61 insertions, 0 deletions
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 <p.janouch@gmail.com>.
+
+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