Skip to content

RGB keyboard control for Asus ROG laptops

License

Notifications You must be signed in to change notification settings

ProjektOsmium/rogauracore

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

57 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

rogauracore - RGB keyboard control for Asus ROG laptops

(c) 2019 Will Roberts

Linux-compatible open-source libusb implementation similar to the ROG Aura Core software. Supports RGB keyboards with IDs 0b05:1854 (GL553, GL753), 0b05:1869 (GL503, FX503, GL703) and 0b05:1866 (GL504, GL703, GX501, GM501).

Usage

Usage:
   rogauracore COMMAND ARGUMENTS

COMMAND should be one of:
   single_static
   single_breathing
   single_colorcycle
   multi_static
   multi_breathing
   red
   green
   blue
   yellow
   gold
   cyan
   magenta
   white
   black
   rainbow
   brightness
   initialize_keyboard

In typical use, you will need root privileges to directly communicate with the laptop's keyboard. This is easy to do with sudo. Try some of these commands and see what works for you:

sudo rogauracore single_static 0000ff
sudo rogauracore single_static 00ff00
sudo rogauracore single_static ffff00
sudo rogauracore multi_static ff0000 ffff00 00ff00 00ffff
sudo rogauracore single_colorcycle 1

If your keyboard does not respond to rogauracore, it may help to send an initialisation message to the keyboard to "wake it up":

sudo rogauracore initialize_keyboard

Building

On Ubuntu from a release:

sudo apt install libusb-1.0-0 libusb-1.0-0-dev
VERSION=1.3
curl -LOs https://github.com/wroberts/rogauracore/releases/download/$VERSION/rogauracore-$VERSION.tar.gz
tar xf rogauracore-$VERSION.tar.gz
cd rogauracore-$VERSION/
./configure
make
sudo make install

From github:

Clone the github repo and enter the top-level directory. Then:

autoreconf -i
./configure
make

Tips and tricks

On some machines, running rogauracore can cause the system's power management to not be able to find the keyboard backlight control. This manifests as unresponsive UI controls for brightening and darkening the keyboard backlight. If this issue affects you, @willlovesbearz suggests running this command after rogauracore:

sudo systemctl restart upower.service

About

RGB keyboard control for Asus ROG laptops

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C 72.2%
  • Python 24.2%
  • M4 2.9%
  • Makefile 0.7%