/asus-wmi-hotkeys-driver

Linux configurable driver for Asus WMI hotkeys. The driver works as middle-man, is listening for events and when is appropriate key event caught then is send custom event configured in config file.

Primary LanguageShellGNU General Public License v2.0GPL-2.0

Asus WMI hotkeys driver

The driver has been created for situation when special keys on laptop do not work. The driver works as middle-man, is listening for events and when is appropriate key event caught then is send custom event configured in config file.

License: GPLv2 GitHub commits Hits

If you find the project useful, do not forget to give project a GitHub stars People already did!

Installation

You can get the latest ASUS WMI hotkeys driver for Linux from Git and install it using the following commands.

git clone https://github.com/asus-linux-drivers/asus-wmi-hotkeys-driver.git
cd asus-wmi-hotkeys
sudo bash ./install.sh

To uninstall, just run:

sudo .bash /uninstall.sh

Configuration

Back-up of configuration is up to you as repository contains only examples for easy getting started. Config is located here:

cat "/usr/share/asus_wmi_hotkeys-driver/keys_wmi_layouts/layout.py"

Discovered keys up to this moment which might be equal across models:

Model: UP5401EA

KEY_WMI_TOUCHPAD = 0x6B # 107
KEY_WMI_MICMUTE = 0x7C # 124
KEY_WMI_CAMERA = 0x85 # 133
KEY_WMI_MYASUS = 0x86 # 134

Model: UX8402

KEY_WMI_SCREENPAD = 0x6A #106
KEY_WMI_SWITCHWINDOWS = 0x9C #156

Troubleshooting

To activate logger, do in a console:

LOG=DEBUG sudo -E ./asus_wmi_hotkeys.py

Existing similar projects

Do not know any.