huekeys

huekeys

Huekeys is a fun application that makes it easy to adjust your System76 keyboard colors and brightness. In addition to the simple ability to set and get the color and brightness, it also provides several patterns that you can run indefinitely, to really make your keyboard pop!

• Change the color according to CPU utilization (cold to hot).

• Monitor the desktop picture and change the keyboard color to match.

• Pulse the keyboard brightness up and down.

• Loop through all the colors of the rainbow.

• Constantly change the color to a random selection.

• Change the color according to typing speed (cold to hot).

  • Optionally switch to another pattern while typing has stopped for a while!

• Monitor any external changes to brightness and/or color and reset them.

  • For example, when waking from sleep, restore set values instead of the system default.

• And best of all, manage it from a convenient system tray interface!

  

Questions?

If you have any questions, please hop into our Discord!

Installation

Choose one of the following that works best for you:

• Using Homebrew on Linux:

  $ brew install bitponyllc/tap/huekeys
  

• Using GitHub CLI:

  $ gh release download -R BitPonyLLC/huekeys -p huekeys
  

• Download from the Releases page

After installation, note the following:

• If you did NOT use Homebrew, you may need to install a library:
  • If you see this error…

    error while loading shared libraries: libayatana-appindicator3.so.1: cannot open shared object file: No such file or directory
    

    …then run this:

    $ sudo apt install libayatana-appindicator3-1
    

• The device access huekeys uses to change the keyboard color, brightness, or to monitor typing, all require root privileges. As such, you must either run with sudo or modify the permissions of the devices.
  • If you want to modify the device permissions, you can do something like the following (depending on your own setup), but NOTE that it will not survive a reboot (the permissions will revert to root-only):

    $ ( cd /sys/class/leds/system76*\:\:kbd_backlight && \
        sudo chgrp adm color* brightness && \
        sudo chmod 664 brightness color* )
    

Usage

# show the basic help
$ huekeys

# set color to red
$ huekeys set red

# set brightness
$ huekeys set 255

# set color and brightness
$ huekeys set pink 127

# run an infinite rainbow in the background
$ huekeys run rainbow &

# run an infinite pulse in the background
$ huekeys run pulse &

# my personal favorite, make the colors get warmer the faster you type,
# but synchronize with the desktop background when idle!
$ huekeys run typing -i desktop

Menu

To show a system tray icon for controlling the current color pattern from the desktop:

$ huekeys menu

Unless there's already another huekeys "wait" process already running, you will be prompted for your sudo password to run a background process that will listen for commands from the menu app. Once running, simply choose the pattern you'd like to have running!

Optionally, you can also open the Info section to see the currently set color and brightness values. Clicking on them will copy those values into your clipboard in case you'd like to use or remember a specific setting for later.

To temporarily stop a pattern, select the Pause item, or, to completely turn the keyboard lights off, select Off.

NOTE:

Huekeys can be automaticallly started when you log in by setting the autostart value in the Menu Key Configuration section below. You should also consider setting the permissions prompt delay.

Remote Control

When there's a background "wait" process running, you can use huekeys to coordinate changes from the command line, too. For example, when running get you'll note that, in addition to telling you about the current color and brightness values, it also indicates what current color pattern is running. Likewise, most commands will coordinate with the background process, allowing you to use huekeys run to change the current pattern, or even huekeys quit to stop the background process.

Configuration

Most of the command line options can be managed through a configuration file. To begin, have the defaults dumped out and saved into your home directory:

$ huekeys --dump-config > ~/.huekeys

Feel free to change the values to better suit your preferences.

NOTE:

The configuration file is monitored and when changed, most values will be adjusted in any live running process (e.g. you can change the log level without restarting the process).

Attribution

This project was originally produced as https://github.com/bambash/sys76-kb. Though it's significantly different as huekeys, a huge thanks goes out to bambash's original as an excellent starting point!