{"id":18834373,"url":"https://github.com/pzl/mx3100drv","last_synced_at":"2026-04-27T11:31:14.766Z","repository":{"id":150422200,"uuid":"80032421","full_name":"pzl/mx3100drv","owner":"pzl","description":"Linux and Mac driver for Perixx MX3100 gaming mouse","archived":false,"fork":false,"pushed_at":"2017-01-31T16:01:23.000Z","size":51,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-29T18:13:42.785Z","etag":null,"topics":["c","driver","hidapi","linux","linux-driver","mouse"],"latest_commit_sha":null,"homepage":null,"language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pzl.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2017-01-25T16:23:47.000Z","updated_at":"2017-10-12T17:07:15.000Z","dependencies_parsed_at":"2023-04-23T05:34:11.957Z","dependency_job_id":null,"html_url":"https://github.com/pzl/mx3100drv","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/pzl/mx3100drv","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pzl%2Fmx3100drv","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pzl%2Fmx3100drv/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pzl%2Fmx3100drv/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pzl%2Fmx3100drv/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pzl","download_url":"https://codeload.github.com/pzl/mx3100drv/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pzl%2Fmx3100drv/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32335295,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T23:26:28.701Z","status":"online","status_checked_at":"2026-04-27T02:00:06.769Z","response_time":128,"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":["c","driver","hidapi","linux","linux-driver","mouse"],"created_at":"2024-11-08T02:12:08.716Z","updated_at":"2026-04-27T11:31:14.749Z","avatar_url":"https://github.com/pzl.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"**mx3100drv** is a Unix (Linux \u0026 Mac) driver for the Perixx MX-3100 gaming mouse. It allows you to change all associated settings, and save to the onboard memory of the mouse.\n\nInstallation\n----------------\n\n**Dependencies**: **[HIDAPI](http://www.signal11.us/oss/hidapi/)** for communicating with the mouse. \n\nOn Mac, you must install a very recent version of HIDAPI, probably using the [github](https://github.com/signal11/hidapi) version and installing from source. v0.8.0 does not include the changes necessary to attach to the right USB interface of the mouse.\n\nOn Linux, it is recommended to use the libusb backend for HIDAPI, so libusb1.0+ should also be installed. But it is not required. If you do not want to use the libusb backend for HIDAPI, you may change the Makefile at the relevant Linux section from\n\n```\n        LIBS = -lhidapi-libusb\n```\n\nto\n\n```\n        LIBS = -lhidapi-hidraw\n```\n\n1. `make`\n2. `sudo make install`\n\nTo use this right after installing, you should do *one* of the following (to use the driver without being root):\n\n* Unplug and re-plug-in the mouse\n* Restart\n* run:\n\n```\nsudo udevadm control --reload-rules\nsudo udevadm trigger\n```\n\nUsage\n-----\n\n**mx3100drv** [OPTIONS] COMMAND [ARGUMENTS]\n\n## Options\n- `-h`, `--help`\n- `-v`, `--version`\n\n## Commands\n### Configuration Commands\ninspecting or changing mouse settings. Provide all arguments to change a setting to be that value. Leave off the final optional argument to retrieve the current value of that setting.\n \n- **snap** [`ON`|`OFF`]  \n    Controls the in-mouse Angle Correction feature to change slight curve movements of the mouse to straighter lines\n- **angle** [`LEVEL`]  \n    Controls the in-mouse Gesture correction feature to adjust the mouse movement angle. Valid values are -2,-1,0,1,2 (for -30 degrees, -15, 0, 15, 30, respectively).\n- **led** [`MODE`]  \n    Determines LED mode. Valid `MODE`s are: `standard`, `breathe`, `neon`, and `off`. Standard mode is a solid LED color (color determined by DPI color), dimmable via the **brightness** setting. Breathe mode pulses the LED, with timing controlled by **speed** option, color determined by DPI color. Neon mode cycles between all colors, the speed of that cycle controlled by **speed** command, DPI color is ignored. Off turns the LED off.\n- **speed** [`TIME`]  \n    Determines the speed of the LED pulsing when in Breathe mode, or cycling in Neon mode. Smaller number is faster. Min: 1, Max: 15\n- **brightness** [`VALUE`]  \n    Determines the intensity of the LED in standard mode. Min: 0, Max: 10. A setting of 0 does not turn the LED off. Use the **led** command set to `off` to do that.\n- **sensitivity** `X`|`Y` [`VALUE`]  \n    The X and Y sensitivity of the mouse movement. Min: 1, Max: 10.\n- **dpi** `PROFILE` [`off`|`on`]  \n    Turns DPI `PROFILE` (1-7) on or off (or tells you, if last argument is omitted).\n- **dpi** `PROFILE` **color** [`HEX`]  \n    Controls the LED color for profile number `PROFILE` (1-7). `HEX` should be a 6-digit hex representation of RGB, like you would use in HTML/CSS. Do not include the '#'.\n- **dpi** `PROFILE` **value** [`AMOUNT`]  \n    The actual _dpi_ for the given dpi profile as `AMOUNT`. Min: 100, Max:12000\n\n### Bulk Commands\n\n- **reset**  \n    Resets all mouse configurations, settings, macros, and profiles to factory default. Similar to a recovery mode.\n- **dump** `FILE`  \n    Save the entire mouse configuration including all settings, macros, and profiles to a `FILE`. `-` may be provided in place of a file name for stdout.\n- **load** `FILE`  \n    Load the entire mouse configuration including all settings, macros, and profiles from a `FILE` into memory. `-` may be provided in place of a file name for stdin.\n\n## Examples\n\n\nNotes\n---------\n\n* This is a userspace driver, not for use as part of the kernel\n* This driver is only for settings configuration. It does not interact with the pointer or keyboard interfaces of the mouse. These will continue to use the default HID driver.\n\nContributing\n--------------\n\nPlease feel free to open issues with improvements, or suggestions, bugs, etc. Pull requests are also welcome. Opening issues to discuss patches and features first are encouraged.\n\n\nLicense\n------------\n```\nMX3100DRV - portable driver for the MX-3100 gaming mouse\nCopyright (C) 2017  Dan Panzarella\n\nThis program is free software; you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation; version 2 of the License.\n\nThis program is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\nGNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License along\nwith this program; if not, write to the Free Software Foundation, Inc.,\n51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.\n```\n\n\nThis software and all files included are licensed under the GPL v2. See `doc/LICENSE` for the full terms.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpzl%2Fmx3100drv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpzl%2Fmx3100drv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpzl%2Fmx3100drv/lists"}