A front-end for customising the functionality of your Razer perpherials under GNU/Linux.
See the daemon's device support table to check whether your device is supported by the daemon. Once it works with the daemon, it's likely to work in Polychromatic too.
However, not all newly supported devices will work straight away. These devices have known issues:
- Profile support is not possible as the daemon does not support the matrix yet (like keyboards do).
If you haven't already, you will need to install the razer-drivers driver and daemon.
Ubuntu and Linux Mint users can install this via this PPA:
sudo add-apt-repository ppa:terrz/razerutils sudo apt update sudo apt install python3-razer razer-kernel-modules-dkms razer-daemon razer-doc
Please see the project website for instructions for your distribution.
Polychromatic can be installed via this PPA:
sudo add-apt-repository ppa:lah7/polychromatic sudo apt update sudo apt install polychromatic
The PPA is recommended as it keeps the application up-to-date.
Earlier distributions will not be able to use the latest version of this software as it depends on a newer version of WebKit2 which is not available in earlier releases.
Instead, the legacy branch contains an older version (v0.1.0 / v0.2.0.1) that will not receive further updates as it requires the original driver/daemon:
- Debian 8 "Jessie" provides an old version of
gir1.2-webkit2-4.0which is incompatible with Polychromatic.
- Please enable
gir1.2-webkit2-4.0to at least v2.12.
Packages built for Ubuntu are also compatible with Debian.
Add this line to your
deb http://ppa.launchpad.net/lah7/polychromatic/ubuntu trusty main
Then add the public key to verify the packages:
gpg --keyserver hkp://keyserver.ubuntu.com:11371 --recv-keys A4BFC960 gpg --armor --export A4BFC960 | sudo apt-key add -
Followed by updating your Apt sources:
sudo apt-get update
Otherwise, standalone packages are available from the releases page, or by following a manual installation below.
Packages for Arch are maintained by z3ntu. You can install using an AUR wrapper, like as follows:
yaourt -S polychromatic pacaur -S polychromatic
There are two packages:
See further below for which dependencies you will require to install first.
git clone https://github.com/lah7/polychromatic.git cd polychromatic git checkout stable sudo ./install/install.sh
If you'd like to use the latest development version (but potentially unstable), skip this line:
git checkout stable.
You can update your installation by clicking "Check for Updates" in the preferences, or by running:
Polychromatic interfaces with the daemon from the razer-drivers project. These packages are required for all distributions:
|gir1.2-webkit2-4.0 (>= 2.12.0)||webkitgtk|
Something not working?
- Check that the driver and daemon are properly installed for your distribution.
- Check that your device has daemon support.
- For DBUS, daemon or driver bugs, see if an issue has been raised on the razer-drivers repository, otherwise please create a new issue there.
For visual or functional problems with Polychromatic, please raise an issue here instead.
If you'd like to translate this application, take a look at this wiki page.