Skip to content
An utility to enable extra macro keys on Steelseries Apex keyboards
Branch: master
Clone or download
tuxmark5 Merge pull request #41 from qwazix/master
Added support for apex 300 (just added the new productId, everything …
Latest commit c2893d3 Jun 2, 2016
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
config udev rules for back/forward? Feb 9, 2015
src
.gitignore
ApexCtl.cabal updated usb library dependency to 1.3 May 3, 2015
apexctl-profile insignificant profile changes Sep 12, 2014
apexctl-resethub polished up (and renamed) apexctl-resethub ( previously apexctl-reset ) Mar 14, 2014
keys.txt updated keys after install Mar 12, 2014
license.txt
makefile fixed silly install root issue... >_< Apr 11, 2016
readme.md
scancodes.txt

readme.md

ApexCtl

Steelseries Apex and Apex [Raw] support for Linux

=========================================================

Contributors

tuxmark5 : github.com/tuxmark5
Zimmux : github.com/Zimmux
kiwistrongis : github.com/kiwistrongis

Dependencies

  • udev >= 206
  • git, pkg-config
  • ghc
  • cabal, cabal-install
  • libusb 1.0.0 and headers
  • haskell usb (>= 1.3.0.2) and cmdargs libraries

Debian:

sudo aptitude install ghc libusb-1.0-0-dev cabal-install git pkg-config
cabal update
cabal install usb cmdargs

Fedora:

sudo yum -y install ghc libusb libusb-devel cabal-install git pkgconfig
cabal update
cabal install usb cmdargs

Arch:

sudo pacman -Syu ghc libusb cabal-install git pkg-config
cabal update
cabal install usb cmdargs

Other:

Install GHC, libusb 1.0.0 headers, cabal. Then:

cabal update
cabal install usb cmdargs

Installation

Global Install

make && sudo make install

Local User Install

You will have to run ~/.local/bin/apexctl manually (as root) to enable the extra keys after every boot.

make && make local-install

Usage

Help

apexctl --help

Enable Macro Keys

sudo apexctl

Apex :: Set Colour Zones

sudo apexctl colors \
	-s RRGGBB:A \
	-n RRGGBB:A \
	-e RRGGBB:A \
	-w RRGGBB:A \
	-l RRGGBB:A
sudo apexctl colors \
	--south=RRGGBB:A \
	--north=RRGGBB:A \
	--east=RRGGBB:A \
	--west=RRGGBB:A \
	--logo=RRGGBB:A

Where RR, GG, and BB are in the domain of [00,ff], and A is in the domain of [1,8].

Example:

sudo apexctl colors \
	-s bb33bb:6 \
	-n ee1111:6 \
	-e 33aa33:6 \
	-w 88ee88:6 \
	-l aa7777:6

Apex [Raw] :: Set Brightness

sudo apexctl br (1..8)

Example:

sudo apexctl br 6

Notes

Some distros ( Fedora 19, for example ) do not have /usr/local/sbin in their secure_path. This means you cannot just run sudo apexctl, you will have to run sudo -E apexctl or sudo /usr/local/sbin/apexctl. To fix this, there are two options.

Find the line that sets secure_path in /etc/sudoers and change it to the following ( or anything that includes /usr/local/sbin ):

Defaults    secure_path = /sbin:/bin:/usr/sbin:/usr/bin:/usr/local/sbin:/usr/local/bin

Alternatively, before installation, change this line in the makefile:

binary_install_dir = /usr/local/sbin

to:

binary_install_dir = /usr/sbin
You can’t perform that action at this time.