2019-07-17 05:53:51 +00:00
# logiops
This is an unofficial driver for Logitech mice and keyboard.
This is currently only compatible with HID++ \>2.0 devices.
2019-07-30 02:56:20 +00:00
## Configuration
[Refer to the wiki for details. ](https://github.com/PixlOne/logiops/wiki/Configuration )
2020-09-01 13:58:08 +00:00
You may also refer to [logid.example.cfg ](./logid.example.cfg ) for an example.
2019-07-30 02:56:20 +00:00
2020-09-01 13:58:08 +00:00
Default location for the configuration file is /etc/logid.cfg, but another can be specified using the `-c` flag.
2020-07-07 03:27:47 +00:00
2020-06-15 09:47:03 +00:00
## Dependencies
2020-09-01 13:58:08 +00:00
This project requires a C++14 compiler, `cmake` , `libevdev` , `libudev` , and `libconfig` . For popular distributions, I've included commands below.
2020-06-15 09:47:03 +00:00
2021-03-22 10:30:16 +00:00
**Arch Linux:** `sudo pacman -S cmake libevdev libconfig pkgconf`
2020-06-15 09:47:03 +00:00
**Debian/Ubuntu:** `sudo apt install cmake libevdev-dev libudev-dev libconfig++-dev`
2019-07-17 05:53:51 +00:00
2021-03-22 10:30:16 +00:00
**Fedora:** `sudo dnf install cmake libevdev-devel systemd-devel libconfig-devel gcc-c++`
2020-06-15 09:47:03 +00:00
2021-04-24 05:49:27 +00:00
**Gentoo Linux:** `sudo emerge dev-libs/libconfig dev-libs/libevdev dev-util/cmake virtual/libudev`
2021-03-22 10:29:17 +00:00
2020-09-27 07:54:08 +00:00
**Solus:** `sudo eopkg install libevdev-devel libconfig-devel libgudev-devel`
2020-06-15 09:47:03 +00:00
## Building
2019-07-17 05:53:51 +00:00
To build this project, run:
2020-09-01 13:58:08 +00:00
```bash
2019-07-17 05:53:51 +00:00
mkdir build
cd build
cmake ..
make
```
2020-09-01 13:58:08 +00:00
To install, run `sudo make install` after building. You can set the daemon to start at boot by running `sudo systemctl enable logid` or `sudo systemctl enable --now logid` if you want to enable and start the daemon.
2019-07-17 05:53:51 +00:00
2020-06-15 07:31:36 +00:00
## 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.
< a href = 'https://ko-fi.com/R6R81QQ9M' target = '_blank' > < img height = '36' style = 'border:0px;height:36px;' src = 'https://cdn.ko-fi.com/cdn/kofi1.png?v=2' border = '0' alt = 'Buy Me a Coffee at ko-fi.com' / > < / a >
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.
2019-07-17 05:53:51 +00:00
## Compatible Devices
2020-06-21 19:45:50 +00:00
[For a list of tested devices, check TESTED.md ](TESTED.md )
2020-07-02 21:37:28 +00:00
## Special Thanks
Thanks to the following people for contributing to this repository.
- [Clément Vuchener & contributors for creating the old HID++ library ](https://github.com/cvuchener/hidpp )
- [Developers of Solaar for providing information on HID++ ](https://github.com/pwr-Solaar/Solaar )
- [Nestor Lopez Casado for providing Logitech documentation on the HID++ protocol ](http://drive.google.com/folderview?id=0BxbRzx7vEV7eWmgwazJ3NUFfQ28 )
- Everyone listed in the contributors page
