Because I didn't find any GKey support for Logitech G910 keyboard I decided to create this GKey mapper. Code is based on an issue in g910-gkey-uinput project. I expanded the code, so that it is more user friendly to add functionality to GKeys.
The code is tested on Logitech G910 keyboard, OS: Manjaro, 4.19.1 Linux kernel, DE: kde plasma 5.14.3.
Everything is described in great depth (and actually much better) on WIKI.
Note: From version 0.2.0 onwards the g810-led controller is no longer required because Gkey to Fkey mapping is disabled inside the driver.
To use this project you need:
- Python >=3.7
- git
- uinput kernel module (more on this here)
- pip requirements are stored in requirements.txt
- g810-led for color changing per profile, https://github.com/MatMoul/g810-led
Installation [AUR]
install g810-led-git for your distro (for Arch based distros: aur)disable Gkeys to Fkeys mapping:g910-led -gkm 1
(probably will include that on program start)- load uinput kernel module:
modprobe uinput
(on Manjaro is loaded by default afaik) - clone repo:
git clone https://github.com/JSubelj/g910-gkey-macro-support.git
- move to cloned repo:
cd g910-gkey-macro-support
- run the installer shell:
chmod +x installer.sh; sudo ./installer.sh
- This will install the module and set a command
g910-gkeys
, add a service file to/usr/lib/systemd/system/g910-gkeys.service
and reload systemd daemon - start the daemon:
systemctl start g910-gkeys
- you can also add it to start on startup:
systemctl enable g910-gkeys
If you update from version <= v0.2.4 you will need to make some manual changes to your /etc/g910-gkeys/config.json
to make use of the new gkey profile feature.
You don't need to do anything if you don't want to use the profile feature your old config will be loaded as default profile m1.
- Uninstalling can be done with files.txt that was created on install (if you deleted it you can always run the installer again to create it)
- run command:
cat files.txt | sudo xargs rm -rf
- list pip packages that include g910:
pip list | grep g910
- remove the ones that concern this driver:
pip uninstall ${pkgs to uninstall}
- it is also recommended to disable the service:
systemctl disable g910-gkeys
- and remove it from system folder:
rm /usr/lib/systemd/system/g910-gkeys.service
- you can also delete the configuration:
rm /etc/g910-gkeys -rf
Configuration should be located in /etc/g910-gkeys/config.json
and should be syntactically correct. Example
configuration can be found in docs folder: ex_config. Currently supported keyboard layouts:
- de - german
- en - english
- fr - french
- si - slovenian (default)
Currently the mapper supports three types of hotkeys (also described in hotkey_types.txt):
"typeout"
- Type out (ex. clicking on GKey types out a string)"shortcut"
- Shortcuts (ex. clicking on GKey presses shift+f4)"run"
- Starting a program (anything you can start from shell) This works only on cli programs (see why: Why can't I run graphic programs by default)."nothing"
- Do nothing (unbound key)
To add a hotkey add to config.json
the following code:
"g<no_of_gkey>": {
"hotkey_type": <type of command "nothing" or "typeout" or "shortcut" or "run">,
"do": "<thing to do>"
}
Depending on the hotkey command, the syntax for "do" is different (supported characters for typeout and hotkeys are listed in supported_keys.txt):
"typeout"
- Typeout syntax is same as you would type text out (ex. "tyPe Me Out!")"shortcut"
- Shortcuts are separated by a plus sign and a comma (ex. "ctrl+c,ctrl+v")"nothing"
- Ifhotkey_type
is set to"nothing"
then "do" key need not exist or can be anything."run"
- Run has the same syntax as you would type a cli program in command line (ex. "systemctl daemon-reload")
There are four profiles you can use and set up different gkey macros in config. Select the profile with M[1-3|R] key on your keyboard.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.