{"id":19417209,"url":"https://github.com/kyokenn/rogdrv","last_synced_at":"2025-07-25T08:09:49.968Z","repository":{"id":29870282,"uuid":"118093451","full_name":"kyokenn/rogdrv","owner":"kyokenn","description":"ASUS ROG userspace mouse driver for Linux","archived":false,"fork":false,"pushed_at":"2025-05-16T14:03:22.000Z","size":255,"stargazers_count":87,"open_issues_count":16,"forks_count":12,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-05-16T15:23:21.034Z","etag":null,"topics":["driver","hid","linux","mouse","mouse-devices","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kyokenn.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,"zenodo":null}},"created_at":"2018-01-19T07:39:01.000Z","updated_at":"2025-05-16T14:03:26.000Z","dependencies_parsed_at":"2023-11-23T22:21:06.791Z","dependency_job_id":"eb8030c8-9816-4f15-9ecf-498a9925acbe","html_url":"https://github.com/kyokenn/rogdrv","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kyokenn/rogdrv","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kyokenn%2Frogdrv","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kyokenn%2Frogdrv/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kyokenn%2Frogdrv/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kyokenn%2Frogdrv/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kyokenn","download_url":"https://codeload.github.com/kyokenn/rogdrv/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kyokenn%2Frogdrv/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266978004,"owners_count":24015486,"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","status":"online","status_checked_at":"2025-07-25T02:00:09.625Z","response_time":70,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["driver","hid","linux","mouse","mouse-devices","python"],"created_at":"2024-11-10T13:08:07.544Z","updated_at":"2025-07-25T08:09:49.934Z","avatar_url":"https://github.com/kyokenn.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"rogdrv\n======\n\n**rogdrv** is a simple ASUS ROG (Republic of Gamers) userspace mouse driver for Linux.\nIt acts as native (no D-BUS interaction) front-end to [ratbag-python](https://github.com/kyokenn/ratbag-python)\n\n\nSupported devices\n-----------------\n\n[Device files](https://github.com/kyokenn/ratbag-python/tree/master/ratbag/devices)\n\n\nInstallation\n------------\n\nClone the git repository (including **ratbag-python** submodule):\n```\ngit clone --recurse-submodules https://github.com/kyokenn/rogdrv.git\ncd rogdrv\n```\n\nInstall the ratbag-python:\n```\nsudo pip3 install ./ratbag-python\n```\n\nInstall the rogdrv:\n```\nsudo pip3 install .\n```\n\n**rogdrv** and **rogdrv-config** requires r/w permissions\nfor /dev/hidrawX file of your mouse.\nIf you want to run them in _rootless_ mode without \"sudo\",\nthen you can install the custom udev rules:\n```\nsudo ./install_udev\nsudo udevadm control --reload-rules\nsudo udevadm trigger\n```\n\nUsing\n-----\n\nUserspace driver consists of 2 programs: **rogdrv** and **rogdrv-config**\n\nYour mouse must be connected using RF or USB.\n\n**rogdrv** is mouse configuration tool with GUI,\nwhich have easy access to some simple settings like profile switching.\n![rogdrv](/screenshot.png)\n```\nUsage:\n  rogdrv\n```\n\n**rogdrv-config** is a mouse configuration tool for the console,\nwhich covers the almost all settings.\n```\nUsage:\n  rogdrv-config \u003ccommand\u003e --help - display help for a command\n  rogdrv-config \u003ccommand\u003e [--debug] [args] - run a command\n\nAvailable commands:\n  rogdrv-config actions - display list of available action codes\n  rogdrv-config bind - bind a button or display current bindings\n  rogdrv-config color - get/set LED colors\n  rogdrv-config dpi - get/set DPI\n  rogdrv-config profile - get/set profile\n  rogdrv-config rate - get/set polling rate\n  rogdrv-config response - get/set button response\n  rogdrv-config snapping - enable/disable snapping\n```\n\n\nSee also\n--------\n\n**hid-asus-mouse**\n\nIf your mouse doesn't support native HID-compatible keyboard events\n(old Gladius II generation and earlier mice in RF mode) or you want some extra features,\nthen you can try the kernel module\n[hid-asus-mouse](https://github.com/kyokenn/hid-asus-mouse)\n\n\n**ratbag-python**\n\nYou can run the **ratbag-python** daemon and use it with [piper](https://github.com/libratbag/piper)\n\nInstall the D-BUS settings:\n```\nsudo cp -fv ./ratbag-python/dbus/org.freedesktop.ratbag1.conf /etc/dbus-1/system.d/\n```\n\nRun the **ratbag-python** daemon:\n```\nsudo ratbagd\n```\n\nRun the **piper** GUI.\n```\npiper\n```\n\n\n**libratbag**\n\nYou can also replace **ratbag-python** daemon with original\n[libratbag](https://github.com/libratbag/libratbag)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkyokenn%2Frogdrv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkyokenn%2Frogdrv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkyokenn%2Frogdrv/lists"}