How to fix F13-F24 keys

I have a USB foot pedal that acts as a keyboard and sends the F13 key. On Windows and Mac it works like you’d expect. But Linux seems to remap the F13-F24 keys at a low level to a bunch of random XF86 keys.

This reddit thread has instructions for a fix on plain Linux. But I am having trouble translating the fix to NixOS. The NixOS wiki describes how to define an entirely new layout, and how to set predefined options. But it does not describe how to define a new option.

Does anyone have a working recipe for using F13-F24 as normal keys on NixOS?

It looks like someone has tried to do this before.

The problems seems to be that you can’t edit xkb rules:

Replicating the patterns using in the linked code, I came up with this:

{ pkgs, ... }:
  my-xkeyboard-config = pkgs.xkeyboard_config.overrideAttrs (_: { 
   postFixup = ''
      cat > $out/share/X11/xkb/symbols/myoptions <<EOF
        default partial function_keys
        xkb_symbols "restore_fk" {
          key<FK13> { [ F13 ] };
          key<FK14> { [ F14 ] };
          key<FK15> { [ F15 ] };
          key<FK16> { [ F16 ] };
          key<FK17> { [ F17 ] };
          key<FK18> { [ F18 ] };
          key<FK19> { [ F19 ] };
          key<FK20> { [ F20 ] };
          key<FK21> { [ F21 ] };
          key<FK22> { [ F22 ] };
          key<FK23> { [ F23 ] };
          key<FK24> { [ F24 ] };

      ${pkgs.ed}/bin/ed -v $out/share/X11/xkb/rules/evdev <<EOF
      myopts:re_fk = +myoptions(restore_fk)

      ${pkgs.ed}/bin/ed -v $out/share/X11/xkb/rules/evdev.xml <<EOF
      <group allowMultipleSelection="true">
          <description>My custom options</description>
            <description>Restore original keysyms of the function keys from 13 to 24</description>

  services.xserver = {
    enable = true;
    exportConfiguration = true; # I'm not sure if this is necessary
    xkb.dir = my-xkeyboard-config + "/etc/X11/xkb";

I have not tested this, but it should be a good starting point for you.

After building your system the files should be modified and located in /etc/X11/xkb/rules/evdev.xml… etc

1 Like

I haven’t had exactly this problem, but when I’ve had similar problems I’ve fixed them at the libinput level (i.e. below the xkb/wayland level) using keymapper or kmonad or any of various other programs - see GitHub - jtroo/kanata: Improve keyboard comfort and usability with advanced customization for some other options.

Somewhat less intrusive might be using home-manager. I managed to define some XKB options this way in the past: