mirrors/logiops
1
0
Fork 0
mirror of https://github.com/PixlOne/logiops.git synced 2025-07-14 13:22:33 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity
An unofficial userspace driver for HID++ Logitech devices
213 Commits 2 Branches 12 Tags 1.6 MiB
C++ 98.4%
CMake 1.4%
C 0.2%
d63a4c5c19
Go to file
Reilly Brogan d63a4c5c19 Add Installation section to readme so that prospective users know that distribution packages are available
2021-04-02 12:55:36 -05:00
.github Add GitHub Actions 2020-07-12 21:09:37 -04:00
src/logid Merge pull request #200 from deamn/master 2021-03-13 20:24:54 -05:00
.gitignore Added mutex to devices to avoid cuncurrency issues 2019-09-13 11:21:26 -03:00
CMakeLists.txt Fix versioning system 2020-07-15 13:22:05 -04:00
LICENSE Initial commit 2019-07-09 13:58:10 -04:00
logid.example.cfg docs: Update config example to match hidpp20 name 2020-09-01 10:56:53 -03:00
README.md Add Installation section to readme so that prospective users know that distribution packages are available 2021-04-02 12:55:36 -05:00
TESTED.md Filled in config name for MX Vertical 2020-11-30 11:05:21 +03:00
version.txt Add version.txt for tarballs 2020-07-15 13:23:11 -04:00

README.md

logiops

This is an unofficial driver for Logitech mice and keyboard.

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

Installation

Logiops is currently available in packaged form for the following distributions:

Debian (Sid only) sudo apt install logiops

Arch Linux:: sudo pacman -S logiops-git

Fedora (>=32): sudo dnf install logiops

All packages install logiops with the logid service in a disabled state so be sure to enable it with sudo systemctl enable --now logid after you have configured it.

Configuration

Refer to the wiki for details.

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

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

Build Dependencies

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

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

Arch Linux: sudo pacman -S cmake libevdev libconfig pkgconf

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

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

Building

To build this project, run:

mkdir build
cd build
cmake ..
make

To install, run the following after building:

sudo make install
sudo systemctl daemon-reload

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.

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.