Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ysph/gHub-GUI
Manage your logitech device on Linux using GUI. Lightweight and user-friendly. (not yet)
https://github.com/ysph/gHub-GUI
dpi led logitech-mouse rgb-led
Last synced: 2 days ago
JSON representation
Manage your logitech device on Linux using GUI. Lightweight and user-friendly. (not yet)
- Host: GitHub
- URL: https://github.com/ysph/gHub-GUI
- Owner: ysph
- License: mit
- Created: 2020-03-11T02:09:11.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-04-09T21:49:02.000Z (7 months ago)
- Last Synced: 2024-08-03T22:02:37.490Z (4 months ago)
- Topics: dpi, led, logitech-mouse, rgb-led
- Language: C
- Homepage:
- Size: 28.3 KB
- Stars: 62
- Watchers: 9
- Forks: 9
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# gHub-GUI
Manage your logitech device on Linux using GUI.
The program is lightweight and user-friendly.
## Dependencies
Ubuntu:
```bash
sudo apt-get install libusb-1.0-0-dev libx11-dev libgl-dev
```
Fedora (38):
```bash
sudo dnf install libusb1-devel libx11-devel mesa-libGL-devel
```
## Compile
```bash
make all
```
## Usage
Run as root:
```bash
sudo ./ghub-gui
```
## Cleaning up
```bash
make clean
```
## TroubleShooting
### The mouse stopped working after execution
The problem is that the OS has failed to attach driver (see "can't add hid device" in dmesg)
To solve that, either try to execute program again or switch the port.
It may also help in future if you add udev rules listed in the case below.
### Can I run the program without root privileges?
create a rule in /etc/udev/rules.d/:
```bash
printf 'KERNEL=="hidraw*", SUBSYSTEM=="hidraw", MODE="0664", GROUP="plugdev"\nSUBSYSTEM=="usb", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c083", GROUP="ubuntu", MODE="066"\nSUBSYSTEM=="usb_DEVICE", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c083", GROUP="ubuntu", MODE="066"' | sudo tee /etc/udev/rules.d/99-hidraw-permission.rules
```
If rules fail to reload automatically:
```bash
sudo udevadm control --reload
```
To manually force udev to trigger your rules:
```bash
sudo udevadm trigger
```
Reboot may also be needed.
Links regarding udev rules:
[udev homepage](http://www.kernel.org/pub/linux/utils/kernel/hotplug/udev/udev.html)
[Debian's udev overview](http://wiki.debian.org/udev)
[Arch's udev overview](https://wiki.archlinux.org/index.php/udev)
[Writing udev rules](http://www.reactivated.net/udevrules.php)
[Ask about udev on the forum](http://vger.kernel.org/vger-lists.html#linux-hotplug)
### My device is UNIDENTIFIED, what could that be?
Some logitech devices use the same id for bluetooth receiver.
However, the Linux kernel since version of 5.2 may recognize IDs properly.
Possible solution for debian-based distributions would be:
```bash
sudo apt-get upgrade
```
## Miscellaneous
The program is not complete yet.
It also requires root privileges.
### Completed features
- Set the static LED colour for the primary or logo
### Missing features
- Set custom LED colours
- Set the cycle or breathing
- Set the colour for logo or primary
- Set DPI
- Set report rate
- Battery level report
- Comprehensive GUI