{"id":13790029,"url":"https://github.com/ysph/gHub-GUI","last_synced_at":"2025-05-12T07:31:20.106Z","repository":{"id":157467553,"uuid":"246452684","full_name":"ysph/gHub-GUI","owner":"ysph","description":"Manage your logitech device on Linux using GUI. Lightweight and user-friendly. (not yet)","archived":false,"fork":false,"pushed_at":"2024-04-09T21:49:02.000Z","size":29,"stargazers_count":81,"open_issues_count":11,"forks_count":9,"subscribers_count":11,"default_branch":"master","last_synced_at":"2024-11-18T04:35:35.017Z","etag":null,"topics":["dpi","led","logitech-mouse","rgb-led"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ysph.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-03-11T02:09:11.000Z","updated_at":"2024-11-16T10:18:32.000Z","dependencies_parsed_at":"2024-04-09T22:46:00.810Z","dependency_job_id":"7e64de0b-9edd-4416-8ebb-e8e2ba2129c7","html_url":"https://github.com/ysph/gHub-GUI","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ysph%2FgHub-GUI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ysph%2FgHub-GUI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ysph%2FgHub-GUI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ysph%2FgHub-GUI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ysph","download_url":"https://codeload.github.com/ysph/gHub-GUI/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253695104,"owners_count":21948813,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dpi","led","logitech-mouse","rgb-led"],"created_at":"2024-08-03T22:00:36.110Z","updated_at":"2025-05-12T07:31:19.752Z","avatar_url":"https://github.com/ysph.png","language":"C","funding_links":[],"categories":["Computer"],"sub_categories":[],"readme":"# gHub-GUI\nManage your logitech device on Linux using GUI.\nThe program is lightweight and user-friendly.\n\n## Dependencies\n\nUbuntu:\n\n```bash\nsudo apt-get install libusb-1.0-0-dev libx11-dev libgl-dev\n```\n\nFedora (38):\n\n```bash\nsudo dnf install libusb1-devel libx11-devel mesa-libGL-devel\n```\n\n## Compile\n\n```bash\nmake all\n```\n\n## Usage\n\nRun as root:\n```bash\nsudo ./ghub-gui\n```\n\n## Cleaning up\n\n```bash\nmake clean\n```\n\n## TroubleShooting\n\n### The mouse stopped working after execution\nThe problem is that the OS has failed to attach driver (see \"can't add hid device\" in dmesg)  \nTo solve that, either try to execute program again or switch the port.  \nIt may also help in future if you add udev rules listed in the case below.\n\n### Can I run the program without root privileges?\n\ncreate a rule in /etc/udev/rules.d/:\n\n```bash\nprintf '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\n```\n\nIf rules fail to reload automatically:\n\n```bash\nsudo udevadm control --reload\n```\n\nTo manually force udev to trigger your rules:\n\n```bash\nsudo udevadm trigger\n```\nReboot may also be needed.  \n\nLinks regarding udev rules:  \n[udev homepage](http://www.kernel.org/pub/linux/utils/kernel/hotplug/udev/udev.html)  \n[Debian's udev overview](http://wiki.debian.org/udev)  \n[Arch's udev overview](https://wiki.archlinux.org/index.php/udev)  \n[Writing udev rules](http://www.reactivated.net/udevrules.php)  \n[Ask about udev on the forum](http://vger.kernel.org/vger-lists.html#linux-hotplug)  \n\n### My device is UNIDENTIFIED, what could that be?\nSome logitech devices use the same id for bluetooth receiver.  \nHowever, the Linux kernel since version of 5.2 may recognize IDs properly.  \nPossible solution for debian-based distributions would be:  \n\n```bash\nsudo apt-get upgrade\n```\n\n## Miscellaneous\nThe program is not complete yet.\nIt also requires root privileges.\n\n### Completed features\n- Set the static LED colour for the primary or logo\n\n### Missing features\n- Set custom LED colours\n- Set the cycle or breathing\n- Set the colour for logo or primary\n- Set DPI\n- Set report rate\n- Battery level report\n- Comprehensive GUI\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fysph%2FgHub-GUI","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fysph%2FgHub-GUI","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fysph%2FgHub-GUI/lists"}