I recently took the plunge and got myself a ZSA Voyager, a beautiful split ergonomic keyboard. So far I’m really happy with it – even though my fingers are still getting used to the split layout 😅

One of its coolest features is the incredibly smooth configuration and customization experience using Oryx, ZSA’s configuration tool. Unlike VIA, which requires Chromium-based browsers for WebHID support, Oryx works flawlessly with Firefox: configure your layout in the web interface, download the .bin file, and flash it using their Keymapp tool.¹

While setting up custom layers for various shortcuts in Oryx, I realized that, by default, the F13 to F24 keys mapped to some “inet” keycodes like XF86Launch4 for F13, XF86AudioMicMute for F20, but also NoSymbol for F19 and F24. That’s… OK-ish, but not very convenient. Luckily, this is easy to fix: you just need to enable the fkeys:basic_13-24 XKB option to be able to use the standard F13 to F24 keycodes. For instance, in Sway, this looks like this:

input 12951:6519:ZSA_Technology_Labs_Voyager {
    xkb_options fkeys:basic_13-24
}

In addition to that, the “Application” key maps to the Menu keycode.

Now, back to learning how to type on that thing 😄