Keymapping on Yosemite for your Keyboard with Karabiner
If you were a good developer this year Santa probably brought you a keyboard for Christmas. Alas, it probably doesn’t have the magical Apple key that you use every day. Good news. I have your solution
In my case, I like a “chicklette” style keyboard with the small keys and a short action. Santa got me the Logitech K811. It’s pretty good so far – supports 3 devices and without a numberpad it allows your mouse to be super close.
But as you can see, since it is intended for mobile and desktop use, it is missing some function keys. In my case, I really like to have a “show desktop” shortcut. But I didn’t want to switch over to using “F” keys.
NOTE: there’s no reason why we can’t use this with another keyboard. For example, a Microsoft Sculpt Ergonomic Keyboard, is going to be my next attempt.
You will need to download and install Karabiner.
Next you need log out the keys you intent to use with DEBUG MODE. In my case it took a while to figure it out, but the logitech keyboard uses a combination of a key and a modifier key to activate mission control.
To determine this I first noticed that the single keypress actually activated 2 keys. The only way that would work is if at least one of them was a modifier key. So then I mashed on the modifier keys until I figured out which one it was.
I then set out to modify
private.xml (get the details here).
Private.xml is the custom keymapping file. I started with the two entries suggested in the Logitech forums. I then added two more (good old guess and test style). I mapped
<command>+<key> to each of the shortcuts I wanted by simply mapping them to the default keys used by OSX to activate the shortcut. I did this to avoid conflicts with the behaviour of the built in keyboard, although Karabiner does support different profiles and ways of keyboard specific mappings.
After you decide what to map, next is how to map it.
Karabiner has a couple of included files that translate key codes into names. If possible use this because then your XML file makes sense when you read it. If not you can use the
For a full list of what you can do and map, there’s a man page just for the private.xml file.
In the end, here’s my private.xml:
And that is that.
Hope this makes you as happy as it made me today. :)