Configures the behaviour of the F-keys on the Logitech K290
Switch branches/tags
Nothing to show
Clone or download
Latest commit 5745b6d Nov 20, 2015

README.md

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 ./build.sh 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

Manually

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 -r or --reset.

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 /usr/local/sbin and install the udev rules into /etc/udev/rules.d. 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/