mirrors/logiops
1
0
Fork 0
mirror of https://github.com/PixlOne/logiops.git synced 2025-07-13 12:52:42 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity
An unofficial userspace driver for HID++ Logitech devices
294 Commits 2 Branches 12 Tags 1.6 MiB
C++ 98.4%
CMake 1.4%
C 0.2%
fbd915e201
Go to file
pixl fbd915e201
Merge pull request #346 from ckiee/config-invalid-enforce 
logid: Fail on invalid Configurations
2023-05-02 21:08:38 -04:00
.github Add GitHub Actions 2020-07-12 21:09:37 -04:00
src Merge branch 'master' into config-invalid-enforce 2023-05-02 21:07:56 -04:00
.editorconfig add .editorconfig to ease contribution by external devs 2022-01-05 12:53:55 +02:00
.gitignore Added mutex to devices to avoid cuncurrency issues 2019-09-13 11:21:26 -03:00
.gitmodules Add ipcgull submodule and require glib 2022-01-07 02:37:17 -05:00
CMakeLists.txt Fix versioning 2023-05-02 19:23:04 -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 Update OpenSUSE dependencies 2023-05-02 19:22:15 -04:00
TESTED.md Merge pull request #272 from lazarin/patch-1 2022-01-02 02:56:03 -05:00
version.txt Fix versioning 2023-05-02 19:23:04 -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.

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.

Dependencies

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

Arch Linux: sudo pacman -S cmake libevdev libconfig pkgconf glib2

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

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

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

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

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

Building

To build this project, run:

mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make

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.

Development

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

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

Credits

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.