• Stars
    star
    222
  • Rank 179,123 (Top 4 %)
  • Language
    Shell
  • License
    MIT License
  • Created almost 11 years ago
  • Updated 6 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

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

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/