by milgner

milgner / k290-fnkeyctl

Configures the behaviour of the F-keys on the Logitech K290

206 Stars 33 Forks Last release: over 6 years ago (v1.0) MIT License 25 Commits 2 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Reconfigures the way the function keys on Logitech K290 keyboards work

For some unfathomable reason, Logitech has decided to make the F-keys on this model emit their multimedia function by default. This utility switches the functionality back to the regular behaviour.

Build instructions

You'll need:

  • a C++ compiler, either G++ (default) or Clang
  • if you choose clang, change build.sh as described in there
  • libusb 1.0, including development files
    • on Ubuntu/Debian this can be achieved via
      sudo apt-get install libusb-1.0-0-dev

Then, on a regular Linux System just type

and it should work. If it does not, look at the script and adapt the path accordingly. If it still does not work, open an issue or a Pull Request on Github :)

Running it


Opening the device with libusb requires advanced permissions, so run it with

sudo ./k290_fnkeyctl

Afterwards, you'll have regular function key behaviour. If you want to switch back, just append


Automatically (udev)

To automatically run the program when the device is plugged in, you can use the included udev rules script as a template. Or just automatically install them along with the executable with

sudo ./install.sh

Which will copy the executable to

and install the udev rules into
. Now you'll just need to tell udev to apply the new rules:
sudo udevadm control --reload-rules
sudo udevadm trigger --subsystem-match=input

Fedora installation

Go to https://copr.fedoraproject.org/coprs/mariuszs/k290-fnkeyctl/

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.