Repository files navigation

This is an unofficial driver for Logitech mice and keyboard.

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

Refer to the wiki for details.

You may also refer tologid.example.cfg for an example.

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

This project requires a C++20 compiler,cmake,libevdev,libudev,glib, andlibconfig.For popular distributions, I've included commands below.

Arch Linux:sudo pacman -S base-devel cmake libevdev libconfig systemd-libs glib2

Debian/Ubuntu:sudo apt install build-essential cmake pkg-config libevdev-dev libudev-dev libconfig++-dev libglib2.0-dev

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

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

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

openSUSE:sudo zypper install cmake libevdev-devel systemd-devel libconfig-devel gcc-c++ libconfig++-devel libudev-devel glib2-devel

To build this project, run:

mkdir buildcd buildcmake -DCMAKE_BUILD_TYPE=Release ..make

To install, runsudo make install after building. You can set the daemon to start at boot by runningsudo systemctl enable logid orsudo systemctl enable --now logid if you want to enable and start the daemon.

The project may only run as root, but for development purposes, you may find itconvenient to run as non-root on the user bus. You must compile with the CMakeflag-DUSE_USER_BUS=ON to use the user bus.

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.

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.

For a list of tested devices, check TESTED.md

Logitech, Logi, and their logos are trademarks or registered trademarks of Logitech Europe S.A. and/or its affiliates in the United States and/or other countries. This software is an independent product that is not endorsed or created by Logitech.

Thanks to the following people for contributing to this repository.

• Clément Vuchener & contributors for creating the old HID++ library
• Developers of Solaar for providing information on HID++
• Nestor Lopez Casado for providing Logitech documentation on the HID++ protocol
• Everyone listed in the contributors page