Skip to content

MaxGyver83/koy

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

31 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

KOY <> Qwertz - Keyboard remapping for Linux when pressing CTRL or ALT

Deutsche Version

This project lets you use the QWERTZ shortcuts you are used to although you are using the K,O.Y keyboard layout. It's a fork of https://github.com/tbocek/dvorak. So Thomas' project description is still valid, I just have changed the filenames in the installation section.


Since I type with the "Dvorak" keyboard layout, the shortcuts such as ctrl-c, ctrl-x, or ctrl-v are not comfortable anymore for the left hand. And even one of them require two hands to press.

Furthermore, applications such as Intellij have their shortcuts, which I'm used to. So for these shortcuts I prefer "Qwerty". Since there is no way to configure this, it is necessary to intercept the keys and remap the keys from "Dvorak" to "Qwerty" when pressing CTRL, ALT, WIN or any of those combinations.

With X.org I was relying on the wonderful project from Kenton Varda. And then came Wayland.

Keyboard remapping with dvorak that works reliably with Wayland - make ctrl-c ctrl-c again

XGrabKey() works partially with some application but not with others (e.g., gedit is not working). Since XGrabKey() is an X.org function with some support in Wayland, I was looking for a more stable solution. After a quick look to this repo, I saw that Kenton added a systemtap script to implement the mapping. It scared me a bit to follow that path, so I implemented an other solution based on /dev/uinput. The idea is to read /dev/input, grab keys with EVIOCGRAB, create a virtual device that can emit the keys and pass the keys from /dev/input to /dev/uinput. If CTRL/ALT/WIN is pressed it will map the keys back to "Qwerty".

Kenton Varda reported that this project also works with Chrome OS if started as root.

Problems

The mapping does not work with Eclipse. Regular typing uses Dvorak, while the shortcuts are using Qwerty (I have not figured out why). This results in a situation where a Qwerty key gets remapped according to the Dvorak mapping.

Installation

  • create binary with make
  • install it with sudo make install

This will copy 3 files: koy, 80-koy.rules, and koy@.service

The file is triggered on the udev rule and call koy systemd service with the device that was attached. The rule contains the search term "keyb", that will match case insensitive the device name. Only a device with name that contains the substring "keyb" will be considered. To prevent an endless loop, the newly created virtual device is excluded from mapping itself.

That way, koy will be called whenever an input device is attached.

Related Links

I used the following sites for inspiration:

About

Wayland keyboard remapping with KOY - make ctrl-c ctrl-c again :)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C 95.3%
  • Makefile 4.7%