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



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 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.


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!

  • OpenRazer update breaks Polychromatic

    OpenRazer update breaks Polychromatic

    Yesterday I took an OpenRazer update through the Software Update Manager (using PPA as source) in Mint 18.3. After reboot Polychromatic fails. Attached is error screen. openrazerfail

    support openrazer 
    opened by PDXsailor 40
  • Razer Blade Stealth logo activation

    Razer Blade Stealth logo activation

    Can you please add the option to activate/deactivate the Razer logo of the shell from your interface, since the driver can do it ?

    bug openrazer device specific 
    opened by xlinbsd 27
  • Constant Crashing under Ubuntu 20.04

    Constant Crashing under Ubuntu 20.04

    I just installed this to use with my Razer Blackwidow Elite while I use Ubuntu in my dual boot windows/ubuntu laptop. I am getting constant crashes - it seems like it is mainly with the system tray application, but I am not sure. I uninstalled it because I thought that maybe it was because my default Python was Python2, but i just tried again after forcing Python3 as my default, but it still has issues. Attached are a couple of screen shots of the error message from the Ubuntu error report tool. I can provide more details if needed (but might need some help if you need logs or anything like that).

    The first error is the first one I saw (Python related). The second looks more like a hard crash.

    The odd thing is that even after these errors, the keyboard lighting is still happening as I type this report.

    error error2

    bug packaging 
    opened by spiff72 26
  • Support for toggling logo for Razer Abyssus

    Support for toggling logo for Razer Abyssus

    Currently there does not seem to be mouse/device specific options. For example my mouse does only support setting lighting on/off, but I cannot do this via Polychromatic right now.

    bug openrazer 
    opened by claell 23
  • Razer Tartarus Chroma Profile Support

    Razer Tartarus Chroma Profile Support

    Hi, today I got my Razer Tartarus Chroma that I bought since I found out of your project and @terrycain's one. First of all thanks for all the effort and work you put into this.

    The macro keys and profile options are greyed out on the tray applet atm. The ones are: Game Mode, Profiles, Enable Macro Keys, Change Primary/Secondary colors and on the top the first option Tartarus Chroma is also greyes out. Ofc this options aren't displayed on the configuration utility either.

    I suppose this is because it hasn't been implemented yet? Or have I done something missed/done something wrong during the installation process? In case it hasn't been implemented, is there any other way around on the meantime?

    Ps: Excuse my English...


    feature request feedback device specific 
    opened by ghost 22
  • Only half of deathstalker chroma configurable with custom effects

    Only half of deathstalker chroma configurable with custom effects

    Details about the problem

    While the default effects (static, wave, etc.) work well, the custom effects don't: There is no device graphic (which I don't mind), only the grid view. Which looks about right from what I know about the addressable colour zones (just 6 in a row), but unfortunately, the left 2, the center 2 and the right 2 grid cells each target the same zone on the hardware, each contributing approx. 50% to its colour. This means that the righthand half of the keyboard cannot be illuminated in any way with custom effects, as the lefthand side (caps/shift/esc to about P/L/dot ) is covered twice. (Which sucks, because due to Razer's poor design choices, the print on the keys is hardly visible at all this way).

    As mentioned, the default effects work for the whole keyboard, they're just... not very exciting if you have a configurable RGB keyboard. (I would happily settle for the wave effect, if I could set its speed)

    Operating System / Desktop Environment / Version(s)

    • Manjaro XFCE with Linux Kernel 5.10
    • polychromatic V0.6.0 (just installed from AUR)
    • OpenRazer Daemon + Python library 3.0.1
    • D-Bus 1.12.20
    • DKMS 2.8

    Affected Devices

    • deathstalker chroma
    • (~~naga hex mouse~~. Custom effects don't work at all here, but apparently mice are still under development) EDIT: Naga Hex V2
    support openrazer device specific device map 
    opened by rem3-1415926 21
  • Blackwidow Elite and Mamba Elite support

    Blackwidow Elite and Mamba Elite support

    This patch adds full support (custom colors and supported effects) for the following hardware:

    • Keyboard Blackwidow Elite
    • Mouse Mamba Elite
    device specific device map 
    opened by beranat 21
  • Configuring key bindings on the Orbweaver

    Configuring key bindings on the Orbweaver


    Tested the debs linked in https://github.com/terrycain/razer-drivers/issues/22 (0.1.3) and I got to configure the brightness on my Orbweaver, yay!

    But shouldn't I be able to reconfigure the layout? Is this a known deficiency because Orbweaver's not officially supported yet?


    feature request openrazer device specific 
    opened by mjtorn 20
  • Build error on Gentoo - lessc

    Build error on Gentoo - lessc

    It complains about a lack of "data/pages/controller.css" because there is no file named controller.css.

    make -j4 PREFIX=/usr DESTDIR=/var/tmp/portage/app-misc/polychromatic-9999/image/ install 
    lessc source/data/controller.less data/pages/controller.css
    /usr/local/lib64/ruby/gems/2.2.0/gems/less-2.6.0/bin/lessc:100:in `read': No such file or directory @ rb_sysopen - data/pages/controller.css (Errno::ENOENT)
    	from /usr/local/lib64/ruby/gems/2.2.0/gems/less-2.6.0/bin/lessc:100:in `<top (required)>'
    	from /usr/local/bin/lessc:23:in `load'
    	from /usr/local/bin/lessc:23:in `<main>'
    make: *** [Makefile:24: css] Ошибка 1
     * ERROR: app-misc/polychromatic-9999::vifino-overlay failed (install phase):
     *   emake failed
    opened by cyberhoffman 18
  • Applet running fine but cannot start controller

    Applet running fine but cannot start controller

    been using the stable 0.3.12 branch for a while now no problems and switched over to the new testing branch because I'm on a Razer Viper Ultimate Wireless and wanted the battery indicator for the mouse.

    Currently running Manjaro and testing also the m JohnOberhauser:basiliskU branch from openrazer for the added perks regarding the charging dock for the Viper. And decided to jump to the polychromatic-git band wagon to do some testing.

    My problem is that I cannot start the polychromatic-controller and I get this as output if I do so from a terminal.

    /usr/lib/python3.9/site-packages/gi/module.py:163: Warning: g_boxed_type_register_static: assertion 'g_type_from_name (name) == 0' failed
      g_type = info.get_g_type()
    /usr/lib/python3.9/site-packages/gi/module.py:163: Warning: g_once_init_leave: assertion 'result != 0' failed
      g_type = info.get_g_type()
    /usr/lib/python3.9/site-packages/gi/module.py:197: Warning: g_type_get_qdata: assertion 'node != NULL' failed
      type_ = g_type.pytype

    Seems to run if I use sudo but it cannot display any of my plugged devices and the polychromatic-tray-applet seems to work just fine and allows me to interact and control all my devices no problem.

    Any ideas on what could be causing this error?

    bug openrazer controller external dependency 
    opened by diffficult 18
  • Razer DeathAdder 3.5G - Can't adjust DPI

    Razer DeathAdder 3.5G - Can't adjust DPI

    Details about the problem

    I've got a Razer DeathAdder 3.5G and I can't seem to set the DPI at all. When I click on the device in the Controller it defaults to 3500, but if I (1) select a different value through the dropdown menu, (2) click away (e.g. to adjust the keyboard settings), and (3) click back, the DPI is reset to back 3500.

    Screenshot from 2021-09-08 15-58-38

    Using polychromatic-cli to attempt to set the DPI throws an exception:

    Screenshot from 2021-09-08 15-57-19

    FWIW I can adjust the polling rate just fine and it saves my setting. Also, browsing around other issues, I saw a Python script recommended to set the mouse DPI at startup (#278) - I tried that, and it just caused my mouse to not be recognized.

    Operating System / Desktop Environment / Version(s)

    Ubuntu 21.04 / Polychromatic 0.7.0

    Affected Devices

    Razer DeathAdder 3.5G

    bug openrazer 
    opened by stscardsfan 6
  • Suggestion: Hint DE to use dark theme if available

    Suggestion: Hint DE to use dark theme if available

    Details about the problem

    Hint DE to use dark theme for the application window. For default branded style it would give dark headerbar.

    Default theme with dark header bar enabled Imgur

    For system theme it would provide better readability for icons, since green-on-white lacks contrast. But I'm not sure is there is reliable way to enable dark theme for Qt that would work indepently from theme engine.

    Adwaita Imgur Adwaita Dark variant Imgur

    feature request feedback 
    opened by ZwS 3
  • polychromatic-controller crashes on startup

    polychromatic-controller crashes on startup

    polychromatic-controller will not launch.

    Operating System / Desktop Environment / Version(s)

    reproduced on pop!_os 20.04 using Plasma & Pop (Gnome 3.36.8) desktop environments, with Wayland and X11.

    Error Message

    $ polychromatic-controller -v
    Traceback (most recent call last):
      File "/usr/bin/polychromatic-controller", line 34, in <module>
        from PyQt5.QtWebEngineWidgets import QWebEngineView
    ImportError: /lib/x86_64-linux-gnu/libQt5Network.so.5: undefined symbol: _ZN15QIPAddressUtils8toStringER7QStringPh, version Qt_5

    Installed Versions

    • openrazer-daemon/focal,focal,now 3.1.0~ubuntu20.04.1 all [installed,automatic]
    • openrazer-doc/focal,focal 3.1.0~ubuntu20.04.1 all
    • openrazer-driver-dkms/focal,focal,now 3.1.0~ubuntu20.04.1 all [installed,automatic]
    • openrazer-meta/focal,focal,now 3.1.0~ubuntu20.04.1 all [installed]
    • python3-openrazer/focal,focal,now 3.1.0~ubuntu20.04.1 all [installed,automatic]
    • polychromatic/focal,focal,now 0.7.0 all [installed]
    • polychromatic-cli/focal,focal,now 0.7.0 all [installed,automatic]
    • polychromatic-common/focal,focal,now 0.7.0 all [installed,automatic]
    • polychromatic-controller/focal,focal,now 0.7.0 all [installed,automatic]
    • polychromatic-tray-applet/focal,focal,now 0.7.0 all [installed,automatic]
    • python3-pyqt5/focal,now 5.14.1+dfsg-3build1 amd64 [installed,automatic]
    • python3-pyqt5.qtwebengine/focal,now 5.14.0-2build1 amd64 [installed,automatic]

    Affected Devices

    System76 Thelio

    In addition...

    I am still able to control my peripheral (keyboard) using polychromatic-cli Let me know if there is anything else I can provide.

    support external dependency 
    opened by richardapilling 1
  • Can't install polychromatic on Debian 11

    Can't install polychromatic on Debian 11

    Hello so I was trying to install polychromatic and all steps were alright till the last step the "sudo apt-get install polychromatic" and there's what the problem is I tried fixing it by myself tho I had no progress so that I'm here help me please. and I did the steps by the main page https://polychromatic.app/download/debian/

    sudo apt-get install polychromatic

    Reading package lists... Done
    Building dependency tree... Done
    Reading state information... Done
    Some packages could not be installed. This may mean that you have
    requested an impossible situation or if you are using the unstable
    distribution that some required packages have not yet been created
    or been moved out of Incoming.
    The following information may help to resolve the situation:
    The following packages have unmet dependencies:
     polychromatic-tray-applet : Depends: gir1.2-appindicator3-0.1 but it is not installable
    E: Unable to correct problems, you have held broken packages.
    support packaging 
    opened by Arashk05 1
  • Error selecting pulsate with a Razer Deathstalker

    Error selecting pulsate with a Razer Deathstalker

    Operating System / Desktop Environment / Version(s)

    Ubuntu Impish and Polychromatic 0.7.0

    Affected Devices

    Razer Deathstalker

    When selecting pulsate a error is displayed on the screen: See screenshot:


    This started since new version 0.7.0. Must be a regression of some sort.


    Traceback (most recent call last): 
    File ’/usr/lib/python3.9/site-packages/polychromatic/backends/openrazer.py’, line 918, in set_device_state 
        rzone.pulsate(colour_1[0], colour_1[1], colour_1[2]) 
    AttributeError: ’RazerFX’ object has no attribute ’pulsate’
    bug openrazer device specific 
    opened by pallebone 4
  • Use non-green colours for native Controller UI and tray applet

    Use non-green colours for native Controller UI and tray applet

    In the tray applet and Controller (native theme), icons are coloured green and do not integrate with the environment nicely.

    As the icons are SVG, recolouring them to match the user's theme is pretty trivial. However, the architecture of the software makes this difficult in some places. Plus, GTK isn't very intuitive for retrieving the colour.

    Some progress started in the fix_icon_colour_for_native_theme branch, but will need more work. Perhaps after porting the tray applet to Qt's equivalent of a system tray icon.

    bug feedback controller tray applet 
    opened by lah7 0
  • Support for ckb-next

    Support for ckb-next

    Hi, I'm Lofty, and I'm one of the maintainers of ckb-next.

    Since the project aspires to be vendor-neutral, I figure that you'll get a request sooner or later to add support for Corsair devices, so it seems reasonable to offer to work together to help with that.

    One thing I should mention, because it's a common misunderstanding for people working on ckb-next, is that even though the ckb-next project is split into a daemon and a GUI, these two should be considered as one whole: if Polychromatic wants to draw animations etc on a device, it should do it by using the GUI's pipe animation, as trying to talk to the daemon is asking for trouble (it would amount to reimplementing much of the ckb-next GUI to maintain state, and I don't think either of us would like that).

    feature request backend 
    opened by Ravenslofty 3
  • Support for OpenRGB

    Support for OpenRGB

    OpenRGB supports many vendors and types of hardware, including the lighting on my ASRock motherboard. The project runs a SDK server in the background, and there's a Python library that we could use to integrate into Polychromatic.

    It's also cross platform with Windows and Mac, which is useful for our distant future cross-platform port of this application.

    feature request backend 
    opened by lah7 0
  • Support for other gaming mice (using libratbag)

    Support for other gaming mice (using libratbag)

    I'd like to suggest adding support for the libratbag library. This library has support for many non-Razer peripherals, and I think that it would help Polychromatic be more vendor agnostic.

    feature request backend 
    opened by sergeant-savage 1
  • Device Effects Reset When Switching Back and Forth Between Linux and Windows on a Dual Boot System

    Device Effects Reset When Switching Back and Forth Between Linux and Windows on a Dual Boot System

    Details about the problem

    When switching between windows and linux on a dual boot, the effects on the device have to be restarted when rebooting into linux.

    For example: I initially am logged into the Linux OS with a static color set on the device. If I reboot into Linux, the static color stays just fine as openrazer boots up. Now if I boot into windows which has the proprietary razer driver installed, which again sets the effect to a static color, and then reboot into linux, the device is reset, and it goes back to the initial unset color cycle. And its not until I go back into polychromatic and manually disable and reenable the effect on the device does it work again.

    It seems to me that logging into windows resets polychromatic or openrazers settings for the device.

    Operating System / Desktop Environment / Version(s)

    Arch LInux, Gnome 40.2 polychromatic version 0.6.0 Open razer version 3.0.1

    Affected Devices

    Razer Firefly

    opened by K4LCIFER 1
  • v0.7.0(Aug 8, 2021)

    It's here! 🎉 A new stable release after 3 years! 🥳 Just about everything has changed, overhauling the UI experience from v0.3.12 and vastly improving support for newer OpenRazer hardware.

    What's New?


    The main application is now based on PyQt5, dropping WebKitGTK. Essentially, this means it's no longer a hybrid web app and now functions as a traditional desktop application. Still featuring the familiar look & feel, but redesigned to be neat and tidy.

    4K screenshot of Polychromatic's controller interface

    • New tab & sidebar interface.
    • New preferences dialog.
    • New colour picker dialog and saved colour management.
    • New "Apply to All" section to quickly set an effect, brightness or colour to all capable devices.
    • New "Device Info" dialog.
      • New "Inspect Matrix" for testing LEDs and co-ordinates (for compatible hardware)
    • 🖱️ New DPI controls, allowing independent X/Y axis.
    • 🖱️ Add ability to set custom DPI stages.
    • Ability to use "native" system theme (distro-dependent)

    Some slightly more trivial things:

    • Ability to hide the new menu bar, pressing Alt to reveal.
    • Add links to Help menu, and show dependency versions in About dialog.
    • Warn when configuration was saved in a newer version of the program.
    • Configure the window placement behaviour and toolbar preferences.
    • Press F5 to refresh the tab list (or CTRL+F5 to fully reload)
    • Drop --print-device-info parameter (this is replaced by "Device Info" and "Inspect Matrix")

    Effect Editor

    Create your own static and animated effects! This is available for any device capable of individually addressable LEDs (also known as a matrix). Click & drag with your pointer to draw on a graphic representing your devices, or use a grid.

    4K screenshot of effect editor

    • Effects will replay at login if they were playing previously.
    • Key labels can be hidden for keyboards for a minimalist look.
    • Added keyboard shortcuts.
    • Add options to change the brush's hue, saturation and lightness, as well as shifting all LEDs up, down, left or down.
    • Give your effect a description and an icon from a choice of emblems, a low-res one from your Steam library (if installed) or your own.

    Device graphics are available for the following devices:

    • ⌨️ Razer BlackWidow Chroma [ 🇺🇸 🇬🇧 ]
    • ⌨️ Razer BlackWidow Elite [ 🇺🇸 ] -- thanks @beranat and @antarean!
    • ⌨️ Razer DeathStalker Chroma -- thanks @rem3-1415926!
    • ⌨️ Razer Huntsman Elite [ 🇩🇪 ] -- thanks @leifhelm!
    • 🖱️ Razer Mamba Elite -- thanks @beranat!
    • 🖱️ Razer Mamba Tournament Edition
    • 💻 Razer Blade Stealth (2016) [ 🇺🇸 🇬🇧 ]
    • 💻 Razer Blade (2018) [ 🇺🇸 🇬🇧 ]
    • 💻 Razer Blade Pro (2019) [🇩🇪 ] -- thanks @Baiyah7o!
    • Razer Firefly
    • Razer Base Station Chroma

    If your device isn't listed, the grid is always available. If you're lucky, there might be a graphic identical to your device already. Learn how to contribute device graphics.

    Device Support

    Polychromatic has a new objective to be vendor agnostic with a goal to have seamless integration between RGB brands. For now, this software continues to be compatible with OpenRazer:

    • OpenRazer is no longer a hard dependency.
      • This software can run without OpenRazer installed, but will be limited.
    • Add support for multizoned hardware
      • Including the logo, scroll wheel, and battery charging states.
    • 🖱️🔋 Add support for battery status, sleep and low power modes.
    • Support custom effects for all compatible hardware.
    • Add shortcut to open mouse preferences for acceleration settings.
    • Button to sync DPI ranges to compatible hardware.
      • Only a couple of devices support this in the firmware. For most mice, this option isn't available.
    • Add information about macros and key remapping.

    To improve your experience with OpenRazer, there is now:

    • New troubleshooter for identifying installation problems.
    • New configuration editor for editing ~/.config/openrazer/razer.conf, for options provided by the OpenRazer daemon, like:
      • Turning off the brightness when the screen is locked.
      • Sending battery status notifications.
      • Turning off persistence introduced in OpenRazer 3.0.

    Tray Applet

    Screenshot of Polychromatic's tray applet under a KDE panel at the top

    • Overhauled with a new menu.
      • Implemented in a way that does not "crash" like v0.3.12's did on some distros.
    • Custom effects and "Apply to All" can be set.
    • Adds support for GTK Status Icon (legacy).
    • New option to delay autostart.
      • For speedy systems, sometimes the menu or icon doesn't initialise as expected due to race conditions. Adding a delay for a few seconds can fix this.

    New: Command Line

    Are you a terminal warrior? Scripting kiddie? Introducing polychromatic-cli. You can set options (-o), parameters (-p), colours (-c) and more (-k) for all devices or just specific ones (-d, -s, -n).

    polychromatic-cli --help

    Other Changes

    • There is now just one desktop launcher, which opens the Controller.
      • If your desktop supports it, right click for desktop actions, like tray applet and opening specific tabs.
    • polychromatic-helper spawns for each device to run custom effects.
    • polychromatic-helper --autostart takes care of autostarting the tray applet (enabled by default)
    • New and updated icons.
    • Font rendering has improved.
    • New (partial) translations: 🇧🇷 pt_BR, 🇫🇷 fr_FR, 🇫🇮 fi_FI, 🇷🇺 ru, 🇳🇱 nl, 🇨🇳 zh_CN
    • Change shebang to #!/usr/bin/python3
      • Prevents custom Python installations from interfering in some situations.
    • For packagers:
      • Updated dependencies and scripts to reflect new code.
      • Change build system to meson/ninja.
      • Switch from lessc to sassc

    Debian Packages

    The application is now packaged modularly on Debian-based systems.

    • If desired, you can just install a component exclusively, like polychromatic-tray-applet.
    • polychromatic is a metapackage to install the complete set.

    Known Issues


    At least 3.0.1 is recommended due to older bugs that may affect the operation of this software.

    • There is an unused Gdk dependency in older versions of OpenRazer that may lock up this software up on some distributions.

    Bugs in OpenRazer that will be fixed in 3.1.0:

    • Devices with charging zones shows an error - https://github.com/openrazer/openrazer/commit/7a8b099035b885707217e42fbfc874e3b0a74cd2
    • DeathAdder 3.5G shows an error - https://github.com/openrazer/openrazer/pull/1576
    • Razer DeathStalker Chroma matrix dimensions were incorrect - https://github.com/openrazer/openrazer/commit/902aed4757ee557b1577c32e2029eda48f4e2c57

    If this affects you, consider using the -git or daily package of OpenRazer until the next release.

    There are some unresolved problems for some hardware:

    • Pulsate effect doesn't work - https://github.com/openrazer/openrazer/issues/1575

    If you haven't visited in a long while, Polychromatic can be found at https://polychromatic.app - also recently updated!

    We also have documentation if you're looking to get involved or learn more about the project as well as OpenRazer.

    🐦 We're on Twitter too: @polychromic_app

    Source code(tar.gz)
    Source code(zip)
    polychromatic-0.7.0-1-any.pkg.tar.zst(638.89 KB)
    polychromatic-0.7.0-debs.tar.gz(562.37 KB)
  • v0.3.12(Apr 19, 2018)

    After having a bit of a hiatus developing the next "major" update to this application, it's time for a very minor release to fix some "paper cuts" in the stable version:

    • Address misaligned button text on Ubuntu/Debian (due to fonts-play package).
    • Fixed a hard to read DPI/Poll Rate label.
    • Fix an issue causing a blank Preferences → Daemon screen.
    • Add warnings if the old PPA is detected.

    Ubuntu / Linux Mint users: The PPA has changed!

    If you installed Polychromatic prior to around September 2017, there's been a bit of re-organisation since then regarding PPAs used for updating the software:

    • lah7/polychromatic has moved to polychromatic/stable.
    • lah7/polychromatic-daily has moved to polychromatic/daily

    :warning: v0.3.12 will be the last update to the old PPA.

    To make the transition:

    1. Open Software & Updates and open the Other Software tab.

    2. Find the "lah7/polychromatic" entry in the list and delete it.

    3. Open the terminal and run:

      sudo add-apt-repository ppa:polychromatic/stable
      sudo apt update
    Source code(tar.gz)
    Source code(zip)
    controller.precompiled.css(24.64 KB)
    polychromatic_0.3.12.deb(854.73 KB)
  • v0.3.11.1(Sep 20, 2017)

    This release simply renames and points to the new naming used for the driver/daemon. Previously known as terrycain/razer-drivers.


    The version has been bumped to v2.0.0.

    :warning: If you're using Ubuntu, you should to switch to the new driver/daemon repository, as you will get dependency errors and be unable to update the program.

    Unless you are already using ppa:openrazer/stable, run these commands to make a clean switch:

    sudo rm /etc/apt/sources.list.d/terrz-ubuntu-razerutils-*
    sudo apt remove python3-razer razer-daemon razer-doc razer-kernel-modules-dkms
    sudo add-apt-repository ppa:openrazer/stable
    sudo apt update
    sudo apt install polychromatic openrazer-meta
    Source code(tar.gz)
    Source code(zip)
    polychromatic_0.3.11.2_all.deb(809.71 KB)
  • v0.3.10(Aug 10, 2017)

    A minor update to address a few issues, particularly after the daemon's last updat which caused a regression for Blade Stealth devices.

    The changes are mainly for improved stability until the next major release, which is slowly tugging along. :hammer_and_wrench:

    • Catch more exceptions in the Controller and Tray Applet to prevent missing items, both in the interface and under the hood.
    • Internal code refactoring, namely the preferences page.
    • Drop version dependency of WebKit2 >2.12 for Debian/Ubuntu.
    • "Properly" add support for the starlight effect (where supported by keyboards via hardware)
    • Bump preferences to revision 5, which cleans up how booleans were stored and pretty prints the JSON files.
    Source code(tar.gz)
    Source code(zip)
    polychromatic_0.3.10_all.deb(763.35 KB)
  • v0.3.9.3(Jul 1, 2017)

  • v0.3.9.2(Jun 11, 2017)

  • v0.3.9.1(May 29, 2017)

    It's been a quiet couple of weeks, this minor release contains a few small things.

    • Re-licensed as GPL 3.
    • :de: Add German translation. (Thanks @BlauerHunger!)
      • Packages for Ubuntu already got this in time for v0.3.9.
    • Tray: Do not show colours menu in tray if device doesn't support RGB.
    • Controller: Fix profile matrix rows/cols for non-BW devices. (#92)
    • Controller: Various fixes to prevent exceptions, including:
      • Determining username for "plugdev message". (#91)
      • Ensure slider for unknown poll rate. (#91)

    More major improvements still to come! :clock1030:

    Source code(tar.gz)
    Source code(zip)
    polychromatic_0.3.9.1_all.deb(706.15 KB)
  • v0.3.9(May 1, 2017)

    This is a minor release, with some fixes and new device support.

    Device Support

    • Add option for changing "backlit" mice, e.g. Naga 2014. (#77)
    • Add option for setting polling rate for mice.
    • Limit DPI to values the device supports.

    Applies to both Controller and Tray Applet.


    • Add logic to check whether user is part of the plugdev group.
    • Fix logic when detecting an out of date daemon.
    • Requires sync_effects_enabled in daemon's config to be disabled. (#79)
    • Fix garbled display when choosing an application (#82)
    • Minor UI tweaks.

    Tray Applet

    • Fix wrong colour being selected for green variants. (e.g. BlackWidow Ultimate)
    • Hide effects if device doesn't have any to show.

    Both the Controller and Tray Applet now synchronise device states, so if you make tweaks in one while the other is running, they'll be reflected without needing to reload. :relieved:

    Source code(tar.gz)
    Source code(zip)
    polychromatic_0.3.9_all.deb(697.58 KB)
  • v0.3.8(Apr 4, 2017)

    The tray applet gets a lot of love in this update! :heart:

    Tray Applet

    • Completely overhauled.
    • Only shows options relevant to that device.
    • Improved support for devices that have separate logo/scroll lighting options.
    • Shows the current status for effects, brightness, etc.
    • Shows a visual list of your saved colours.
    • (For mice) Now supports setting the DPI.
    • Offers an option to restart the daemon.


    • Fixed an issue when creating profiles based on an installed application.
    • Macros, game modes and profiles only show if the device supports them.
    • Preferences - Improved selection for changing icons.
    • Preferences - Daemon options have been temporarily dropped, as the latest daemon does not read them.
    • Ultimate (non-RGB) keyboards present shades of green.
    • Refreshed UI improvements.
    • Miscellaneous fixes under the hood.

    Feature Dropped: "Start-up Settings"

    The tray applet use to be responsible for setting an effect, brightness or profile when it first runs. This has been dropped temporarily. It was unreliable, especially as it applied them to the first device.

    Rest assured, this feature will be coming back much improved in the next major release. :+1:

    Even more packages! :package:

    If you're a Fedora or openSUSE user, you'll be pleased to know you now have packages available! Thanks to @z3ntu for setting this up. See the README for instructions.

    Source code(tar.gz)
    Source code(zip)
    polychromatic_0.3.8_all.deb(690.62 KB)
  • v0.3.7.1(Mar 16, 2017)

    This is a very minor release, mainly fixing a few issues introduced from v0.3.7.


    • Fix regression when editing profiles.
    • Fix regression with wave effect in header.
    • Stop "syncing" mouse DPI with hardware. (#65)
    • Add starlight FX for future daemon support.
      • This option is not available as the daemon does not support this yet.
    • Add Naga Hex V2 ring in UI.
    • Update application icons. (#66 - thanks @aldy-art!)
    • Tweaked the message when restarting daemon.

    :package: Daily PPA for Ubuntu

    If you'd like future fixes and new features faster, see here about adding the daily PPA instead of the "stable" (normal) PPA for Polychromatic updates.

    Arch users already have the polychromatic-git package for this.

    Source code(tar.gz)
    Source code(zip)
    polychromatic_0.3.7.1_all.deb(731.20 KB)
  • v0.3.7(Mar 7, 2017)

    Many new changes await in this release! Thanks for your patience everyone.


    • Add support for Razer DeathAdder, Abysuss and other devices that have separate lighting configurations for the logo and scroll wheel. The UI has been refreshed to adopt to this. (#41 #43 #50)
    • Add option for changing mouse DPI. (#59)
    • Add ability to create/modify your own colours. (#20)
    • Add "Breeze" tray icons for KDE desktops. (#52)
    • Overview Screen
      • Shows firmware versions.
      • Highlights the current colour in use.
    • Show more suggestions when device isn't bound to the driver.
    • Refined loading animation and tweaks when restarting the daemon.
    • Use daemon for determining device images.
    • Speed up the refresh rate when setting the ripple effect.
    • Prevent missing images for device icons and header background.
    • Miscellaneous small fixes and improvements.
      • Updated categories for desktop launcher.
      • Add man pages.
      • Internal fix when saving files in ~/.config/polychromatic
      • Reshuffled data files and code clean ups.

    Tray Applet

    • Fix a crash when no devices were present. (#46)
    • Feel neglected. :cry:

    Don't worry, the poor tray applet will be getting revamped with the latest developments in the next major release. :+1:

    Also, Gentoo users -- you've got packages! :package: Thank you to vifino for providing these. See the README for more details.

    Source code(tar.gz)
    Source code(zip)
    polychromatic_0.3.7_all.deb(727.60 KB)
  • v0.3.6(Jan 14, 2017)

    This is a maintenance release, with the following changes:


    • Fix command loop (causing high CPU utilisation). Closes #39.
    • Add button to gracefully stop the daemon.
    • Show images for headsets and keypads.
    • Show actual device images on Overview screen.
    • Show more visual errors when things go wrong.
      • More checks when running without the daemon installed.
      • When a device cannot process a command, show the error on-screen (apparent with new devices)
    • Miscellaneous tweaks, such as:
      • Re-syncing the BlackWidow Chroma demo.
      • Colourising verbose details in the terminal.

    What about new devices?

    Some devices are still known to be unconfigurable and rest assured, support for the following is coming soon:

    • Razer DeathAdder Chroma
    • Razer Naga
    • Reading/setting mouse DPI (where supported)

    See the README's Device Support section to see which devices are known to be problematic under Polychromatic.

    Source code(tar.gz)
    Source code(zip)
    polychromatic_0.3.6.1_all.deb(713.78 KB)
    polychromatic_0.3.6_all.deb(713.71 KB)
  • v0.3.5(Dec 13, 2016)

    This is a minor release, with a few fixes.

    • Prevent crash when device serial returned null. (#40)
    • Correct logic for showing "No Devices Found" screen. (#40)
    • Update verbose messages when running with -v flag.
    • Correct function used when updating colours while reactive effect was set.
    • Add new device overview screen.
    • Drop obsolete "Enable Macro Keys" button.
      • With the latest daemon, macro keys for keyboards are enabled straight away, so they no longer need activating manually.
    Source code(tar.gz)
    Source code(zip)
    polychromatic_0.3.5_all.deb(599.38 KB)
  • v0.3.4(Nov 27, 2016)

    This is a minor release, with a few small enhancements.

    • When no devices were detected, adapt the message depending whether a Razer product is physically connected. Closes #37.
    • Track and retain device states. Closes #14.
    • Show a dialog when restarting daemon (if zenity is optionally installed).
    • Fix "Reset Preferences" button.
    • Miscellaneous UI fixes.

    Also, Arch users -- you've got packages! :package: These are maintained by z3ntu (thanks!). See the README for more details.

    Source code(tar.gz)
    Source code(zip)
    polychromatic_0.3.4_all.deb(596.90 KB)
  • v0.3.3(Nov 6, 2016)

    A new update with enhancements and bug fixes has been released.


    • Preferences
      • Now a tabbed interface.
      • View change logs from within the application.
      • Add daemon settings - allows you to change daemon-specific settings, view logs and visit project links.
      • Add demo option - a synchronised Razer BlackWidow Chroma advert.
    • Show the application window sooner, with a loading screen.
    • In the profile editor, the FN/Space keys are enabled for supported keyboards.
    • Add ability to restart the daemon when errors occur.
    • Remove useless "device refresh" button.

    Tray Applet

    • Prevent tray applet crash when a profile didn't exist.
    • Prevent tray applet crash when the daemon is not ready/present.
    • Icon shows read when there is a problem.
    Source code(tar.gz)
    Source code(zip)
    polychromatic_0.3.3_all.deb(595.58 KB)
  • v0.3.2(Oct 2, 2016)

    This is a minor release, with mostly visual changes.

    • Added keyboard navigation support.
      • For all you keyboard warriors out there, you'll be happy to know you can Tab or Shift + Tab !
      • Buttons have changed slightly, like the text being primarily grey text and showing its focus border.
    • Misc. UI Tweaks
      • Drop-down menus are now themed.
      • The normal cursor will be used consistently throughout.
    • Application Profile Editing
      • Tools relocated to the top-right. The keyboard is no longer "cut off" at the bottom.
      • Tools show the one currently in use.
      • Keys are now highlighted in full as opposed to just its border.
      • "Empty" keys are a bit lighter so they're a bit easier to read.
    Source code(tar.gz)
    Source code(zip)
    polychromatic_0.3.2_all.deb(647.93 KB)
  • v0.3.1(Sep 25, 2016)

    This is a minor release, addressing a few issues raised since v0.3.0 for the Controller application.

    • An error message is shown when daemon cannot be initalised.
    • Process title for the Controller is set properly.
    • Daemon/library version information can now be seen in the preferences.
    • Only supported features are shown. Addresses #28.

    The following are now supported, but not fully tested:

    • Add pulsate effect for Razer BlackWidow 2013.
    • Add logo lighting toggle for Razer Abyssus. Addresses #29.
    Source code(tar.gz)
    Source code(zip)
    polychromatic_0.3.1_all.deb(647.18 KB)
  • v0.3.0(Sep 18, 2016)

    A new daemon awaits. Polychromatic has undergone large changes and is now compatible with the latest razer-drivers daemon, which now supports the ripple effect and on-the-fly macro recording!

    For users previously running v0.2.2

    You'll first need to uninstall the older driver and daemon, which was provided by the package razer-chroma-drivers.

    Ubuntu/Debian users can type these commands to quickly make the transition:

    sudo apt remove razer-chroma-drivers
    sudo add-apt-repository ppa:terrz/razerutils
    sudo apt update
    sudo apt install python3-razer razer-kernel-modules-dkms razer-daemon razer-doc
    sudo apt install polychromatic

    polychromatic requires python3-razer and razer-daemon to function. Ubuntu/Debian users will receive the update via the PPA, but may need to update their driver/daemon first.

    This transition for other distributions may vary and can be updated as usual with the ./install/update.sh script.

    For the new driver to function properly, please restart the computer.

    What's new in this release?


    • Interfaces with the new daemon
    • Allows multiple devices to be configured.
    • Applications profiles are now in JSON format. This conversion happens automatically.
    • Add the ripple effect.
      • Random or solid colour.
    • Internal code maintenance and folder restructure.

    Tray Applet

    • New "Devices" menu to pick a device to customise.
    • Options are hidden if your device does not support them.
    • Shortened menu labels.
    • Refreshed icons. No longer relies on GTK to determine a system icon.


    • New effect icons.
    • New tab row for customising multiple devices.
    • New dynamic header, based on current colours and device.
    • New graphical error messages when something went terribly wrong.
    • Add About section to Preferences with a check for updates and change log button.
    • Add quick help for using macros.
    • Favours the "Play" font on the system.
    • Fix open configuration folder button.
    • Fix new profile dialog "preview" text being inconsistently updated.
    • Hides features not supported by device (e.g. application profiles hidden when customising a mouse)

    Thank you for your patience! More improvements will be coming along the way.

    Source code(tar.gz)
    Source code(zip)
    polychromatic_0.3.0_all.deb(645.94 KB)
  • v0.2.3(Aug 14, 2016)

  • v0.2.2(Jul 31, 2016)

    A new release is available! This version continues the v0.2.2 series to add and improve features.

    The project logo has been updated too, to reflect the eventual move to the new user-space daemon which will properly support multiple Razer devices.

    This release has altered the preferences structure -- The conversion happens automatically, but please do not use an older version to avoid messing your saved profiles and settings.

    What's New?

    • Application Profiles can be renamed and have icons assigned to them.
    • Create new profiles based on an installed application.
    • New styled UI controls and scroll bars, plus other minor UI tweaks.
    • Add browse buttons for icons and setting the tray applet icon.
    • Improvements to tray applet icon in Preferences.
    • Tray Applet automatically restarts when changes are made to preferences or profiles (if running).
    • Tray Applet only loads "start-up settings" once per login session.

    Bug Fixes

    • Prevent the scroll bar appearing in the editor.
    • Internal code clean-ups.
    • Tray Applet now loads preferred colours when started.
    • Tray Applet launches Controller detached from its process to prevent hold-up when exiting.

    Ubuntu users will get the update automatically via the PPA. Yakkety (16.10) builds have been added. Debian users can download the package below. Other distributions can update with the install/update.sh script.

    Source code(tar.gz)
    Source code(zip)
    polychromatic_0.2.2_all.deb(344.23 KB)
  • v0.2.1(Jul 7, 2016)

    This is a maintenance release, with these major changes:

    • New dialogue prompts for profile creation/deletion.
    • Translation support.
    • Switched to a Python module for setting process title.
    • Internal code clean-up.

    Ubuntu users will get the update automatically via the PPA. Debian users can download the package below. Other distributions can update with the install/update.sh script.

    Source code(tar.gz)
    Source code(zip)
    polychromatic_0.2.1_all.deb(336.06 KB)
  • v0.2.0(Jun 12, 2016)

    Polychromatic has hit v0.2.0 and is considered stable for daily use for one Razer keyboard/peripheral at a time.

    WebKit2 is still fairly new. If your distribution has problems with the switch, v0.1.0 is available with the same features. This is the case for Ubuntu 14.04 - 15.10 and Linux Mint 17.

    Multi-device support (and improved integration with other Razer devices) is planned for v0.3.0 by supporting the newly re-written user-space razer-chroma-drivers daemon (currently under development).

    This release solidifies the separation from the original release.

    Thanks for your patience!


    • Migrated to WebKit 2.
    • Internal code changes.
    • Prepared packaging for Ubuntu.

    Ubuntu users can now install from a PPA!

    sudo add-apt-repository ppa:lah7/polychromatic
    sudo apt update
    sudo apt install polychromatic

    For installation instructions, please see the README.

    Source code(tar.gz)
    Source code(zip)
    polychromatic_0.1.0_all.deb(376.97 KB)
    polychromatic_0.2.0_all.deb(379.15 KB)
    razer-chroma-driver_20160612_debian_amd64.deb(81.55 KB)
    razer-chroma-driver_20160612_ubuntu_amd64.deb(81.40 KB)
  • v0.1.0(May 17, 2016)

    This is the original code base as used in the Razer Linux Chroma Drivers project, decoupled to make development more flexible. It is mostly stable.

    If you've previously been running the GUI tools from the main repository, use this to migrate your preferences:

    mv ~/.config/razer_chroma ~/.config/polychromatic


    This release presents a basic package for easy installation for Ubuntu users.

    A PPA is not yet available, but do check back in a few weeks!

    Other Distributions

    Other distributions and packaging will be properly addressed in future developments.

    To perform a standard install on distributions other than Ubuntu:

    1. Install the dependencies, according to your distro:

      • razer-chroma-drivers
      • python3-gi
      • gir1.2-webkit-3.0 (this version is based on the legacy WebKit)
      • gir1.2-appindicator3-0.1
    2. Obtain the stable branch.

      git clone https://github.com/lah7/polychromatic.git
      cd polychromatic
      git checkout v0.1.0
    3. Run the install script.


    Check back in a couple of weeks for further updates.

    Source code(tar.gz)
    Source code(zip)
    polychromatic-v0.1.0-ubuntu.deb(374.98 KB)
Collection of front-end utilities to manage peripherals powered by OpenRazer.
visualCaptcha's Main Repo. This is a collection of all the different versions/repos of visualCaptcha.

visualCaptcha Please note visualCaptcha is no longer actively developed. It still works and should continue to, but it won't be improved by the initia

null 405 Sep 2, 2021
Open source API management platform

About Fusio is an open source API management platform which helps to build and manage REST APIs. Fusio provides all tools to quickly build an API from

Apioo 997 Sep 15, 2021
Personal CRM. Remember everything about your friends, family and business relationships.

Personal Relationship Manager Monica is a great open source personal relationship management system. Introduction Purpose Features Who is it for? What

Monica 13.3k Sep 24, 2021
Open source back-end server for web, mobile and IoT. The backend for busy developers. (self-hosted or hosted)

A scalable, multitenant backend for the cloud. Para is a scalable, multitenant backend server/framework for object persistence and retrieval. It helps

Erudika 408 Sep 20, 2021
Multi-platform app that allows your devices to communicate

KDE Connect - desktop app KDE Connect is a multi-platform app that allows your devices to communicate (eg: your phone and your computer). (Some) Featu

KDE GitHub Mirror 1.2k Sep 15, 2021
Self-hosted VirusTotal / MetaDefender wannabe with API, demo UI and Scanners running in Docker.

MalwareMultiScan Self-hosted VirusTotal / OPSWAT MetaDefender wannabe API for scanning URLs and files by multiple antivirus solutions. IMPORTANT: vers

Volodymyr Smirnov 237 Sep 14, 2021
A black hole for Internet advertisements

Network-wide ad blocking via your own Linux hardware The Pi-hole® is a DNS sinkhole that protects your devices from unwanted content, without installi

Pi-hole 32.5k Sep 17, 2021

EventX What do you do when you have an event and all the event management applications available are too heavy but with little functionality to serve

Andela 20 Jun 29, 2019
Read-only mirror of https://gitlab.gnome.org/GNOME/gparted

GPARTED ======= Gparted is the GNOME Partition Editor for creating, reorganizing, and deleting disk partitions. A hard disk is usually subdivided int

GNOME Github Mirror 179 Sep 24, 2021
The Linux PowerTOP tool -- please post patches to the mailing list instead of using github pull requests

PowerTOP PowerTOP is a Linux* tool used to diagnose issues with power consumption and power management. In addition to being a diagnostic tool, PowerT

Arjan van de Ven 543 Sep 24, 2021
A platform for community discussion. Free, open, simple.

Discourse is the 100% open source discussion platform built for the next decade of the Internet. Use it as a: mailing list discussion forum long-form

Discourse 34.1k Sep 24, 2021
A free open source IT asset/license management system

Snipe-IT - Open Source Asset Management System This is a FOSS project for asset management in IT Operations. Knowing who has which laptop, when it was

snipe 5.3k Sep 19, 2021
Graphical program used to map keyboard buttons and mouse controls to a gamepad. Useful for playing games with no gamepad support

antimicro ?? Important update ?? This repo is currently unmaintained. The code hasn't been updated for a while. But not all is lost, antimicro has a f

null 1.5k Sep 24, 2021
🔥 Open source static (serverless) status page. Uses hyperfast Go & Hugo, minimal HTML/CSS/JS, customizable, outstanding browser support (IE8+), preloaded CMS, read-only API, badges & more.

Über fast, backwards compatible (IE8+), tiny, and simple status page built with Hugo. Completely free with Netlify. Comes with Netlify CMS, read-only

cState 1.4k Sep 17, 2021
OpenProject is the leading open source project management software.

OpenProject OpenProject is a web-based project management software. Its key features are: Project planning and scheduling Product roadmap and release

OpenProject 5.2k Sep 25, 2021
The Rails application that powers OpenStreetMap

"The Rails Port" This is The Rails Port, the Ruby on Rails application that powers the OpenStreetMap website and API. The software is also known as "o

OpenStreetMap on GitHub 1.4k Sep 20, 2021
Online genealogy

webtrees - online collaborative genealogy Contents License Coding styles and standards Introduction System requirements Internet browser compatibility

Greg Roach 582 Sep 15, 2021
NO LONGER MAINTAINED - Project management and time tracking should be easy. SprintApp is simple to setup, simple to use, and elegant - making you look like a hero in your organization.

SprintApp DEPRECATED This project has not seen any community contributions for a year now, and I have not had time for the project, or the need, for a

Matthew Millsaps-Brewer 304 Aug 12, 2021