/logiops

An unofficial userspace driver for HID++ Logitech devices

Primary LanguageC++GNU General Public License v3.0GPL-3.0

logiops

This is an unofficial driver for Logitech mice and keyboard.

This is currently only compatible with HID++ >2.0 devices.

Dependencies

This project requires a C++14 compiler, cmake, libevdev, libudev, and libconfig. For popular distributions, I've included commands below.

Arch Linux: sudo pacman -S cmake libevdev libconfig pkgconf

Debian/Ubuntu: sudo apt install cmake libevdev-dev libudev-dev libconfig++-dev

Fedora: sudo dnf install cmake libevdev-devel systemd-devel libconfig-devel gcc-c++

Gentoo Linux: sudo emerge dev-libs/libconfig dev-libs/libevdev dev-util/cmake virtual/libudev

Solus: sudo eopkg install libevdev-devel libconfig-devel libgudev-devel

How to build

To build this project, run:

mkdir build
cd build
cmake ..
make

How to install

To install after building, run:

sudo make install

Finally, enable and start the daemon:

sudo systemctl enable --now logid

How to configure

Default location for the configuration file is /etc/logid.cfg, but another can be specified using the -c flag.

Refer to the wiki for details.

You may also refer to logid.example.cfg for an example.

How to uninstall

First, disable the daemon:

sudo systemctl disable --now logid

Then remove the few files that were installed:

sudo rm /usr/local/bin/logid
sudo rm /lib/systemd/system/logid.service
sudo rm /etc/logid.cfg

Donate

This program is (and will always be) provided free of charge. If you would like to support the development of this project by donating, you can donate to my Ko-Fi below.

Buy Me a Coffee at ko-fi.com

I'm also looking for contributors to help in my project; feel free to submit a pull request or e-mail me if you would like to contribute.

Compatible Devices

For a list of tested devices, check TESTED.md

Special Thanks

Thanks to the following people for contributing to this repository.