Skip to content
master
Switch branches/tags
Code

Files

Permalink
Failed to load latest commit information.

Polychromatic

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!

https://polychromatic.app


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!

About

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:

Download

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 polychromatic-controller-dev script will create an isolated configuration in dev/config as opposed to ~/.config/polychromatic.

Are you on the cutting edge?

On Ubuntu, add ppa:polychromatic/edge. Arch users can install polychromatic-git 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.

Translations

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.

Donations

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