A graphical front end for managing Razer peripherals under GNU/Linux.
Python HTML JavaScript CSS Shell
Latest commit f324b50 Jan 17, 2017 @lah7 Hotfix Release



A front-end for customising the functionality of your Razer perpherials under GNU/Linux.



Screenshot Features
  • Set effects, brightness, colours and modes supported by the device.
  • Create application profiles.
  • Specify preferences - such as default colours.
  • View all connected devices and configure the daemon-specific settings.

Tray Applet

Screenshot Features
  • Quickly set supported effects, brightness and modes.
  • Change colours and application profiles on-the-fly.
  • Apply settings automatically when you log-in

View all screenshots

Device Support

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:

Keyboard Mouse Mousemat Keypad Headset
Keyboard Mouse Mousemat Keypad Headset

Known Issues

  • Mice
    • No support for setting the scroll_wheel or logo. These devices cannot be configured yet:
    • No option for reading/setting DPI for supported mice.
    • Profile support may be possible, further investigation needed.
  • Keypad
    • Profile support is not possible as the daemon does not support the matrix yet (like keyboards do).

Driver Installation

Chroma Drivers Razer Drivers for Linux

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 Installation

Ubuntu Ubuntu 16.04+ / Linux Mint 18+

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.

Ubuntu Ubuntu 14.04 / Linux Mint 17

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 Debian 8+

WebKit2 Dependency

  • Debian 8 "Jessie" provides an old version of gir1.2-webkit2-4.0 which is incompatible with Polychromatic.
  • Please enable jessie-backports and update gir1.2-webkit2-4.0 to at least v2.12.

Packages built for Ubuntu are also compatible with Debian.

Add this line to your /etc/apt/sources.list:

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.

Arch Arch Linux

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:

Other Distributions Other Distributions / Manual Installation

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:

Debian/Ubuntu Arch
gir1.2-gtk-3.0 gtk3
gir1.2-appindicator3-0.1 libappindicator
gir1.2-webkit2-4.0 (>= 2.12.0) webkitgtk
python3-gi python-gobject
python3-setproctitle python-setproctitle
python3-requests python-requests

Something not working?

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.