Need help with polychromatic?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

605 Stars 53 Forks GNU General Public License v3.0 1.2K Commits 65 Opened issues


RGB lighting management front-end application for GNU/Linux. Powered by OpenRazer (but soon to be vendor agnostic)

Services available


Need anything else?

Contributors list


An open source RGB lighting management front-end application to customise OpenRazer peripherals on GNU/Linux. Soon to be vendor agnostic!

Build Unit Tests GitHub Release License Python Version

Screenshot of Polychromatic's v1.0.0 Controller interface

The next generation of the software (v1.0.0) - not released yet!

v0.3.12 Notice

This README (and branch) is for the next generation of the software still in development. For the older release (v0.3.12) designed for Razer BlackWidow Chroma and is compatible with most Razer hardware that was supported before 2018, see the stable branch.

v1.0.0 is aimed to be released for beta testing as soon as humanly possible!


Polychromatic is a vendor agnostic front-end for managing lighting, RGB effects and some special functionality for keyboards, mice, keypads and just about any other gaming peripheral on your GNU/Linux system.

The software aims to make it easy to create and co-ordinate lighting effects that work across all compatible hardware, even if you switch to another brand also supported by Polychromatic.

Presets and triggers enables you to switch your lighting on-the-fly to match the application or game that's currently playing.

View Features & Screenshots (v0.3.12)

Device Support

Polychromatic on its own is just a front-end, it needs at least one backend installed to provide the actual communication with the hardware.

Currently, OpenRazer is the only supported backend at the moment. (Being vendor agnostic is a fairly new objective!)

To check your Razer device is supported, check out the supported devices grid on the OpenRazer website.

In future, this project aims to add support for:


Instructions for each supported distro are provided on the website:

Installing packages from a software repository is recommended as this will keep the software up-to-date.

Alternately, providing all the dependencies are installed, you can run the application directly from the repository without installation. The

script will create an isolated configuration in
as opposed to

Are you on the cutting edge?

On Ubuntu, add

. Arch users can install
from the AUR.

Alternately, grab the latest build from the Actions tab. GitHub requires you to be signed in to download these.

Something not working?

For OpenRazer users, occasionally, issues are caused by an improper driver installation. Polychromatic includes a troubleshooter to identify common problems.

Should you still be stuck, check if an issue already exists, and that your hardware is supported before creating a new issue.

For bugs with Polychromatic, please raise an issue here.


The software can speak multiple languages! Here's a guide if you'd like to contribute.

Please note that there may be new and changed strings while this new version is being finalized.


If you love this software and wish to leave a little something to excite the developer, you're welcome to do so via Thank you for your generosity!

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.