An open source RGB lighting management front-end application to customise OpenRazer peripherals on GNU/Linux. Soon to be vendor agnostic!
The next generation of the software (v1.0.0) - not released yet!
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)
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:
- OpenRGB - supports many brands, including GPU, MB and RAM modules.
- Philips Hue (phue)
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.
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 paypal.me. Thank you for your generosity!