README.md

mxw - Model (O/O-/D/D-) Wireless

Cross platform CLI for configuring Glorious wireless mice.

See the original project and it's README at korkje/mow.

This fork uses updated dependencies, adds support for more devices (see below) and fixes panics when changing the polling rate and lift-off distance.

Supported Devices

• Model O
  • Tested
• Model D
  • Tested
• Model O-
  • Tested
• Model D-
  • Tested
• Model D2 Pro [#7]
  • Tested

This project currently only works with these mice, as they are compatible with Glorious Core v1. I don't have a newer device to test with, so if you've got a weekend to waste and no side project to work on, feel free to submit a pull request. Here may be a good starting point.

Common issues

• You get an error message like Error: hidapi error: Failed to open a device with path '/dev/hidraw5': Permission denied
  • You can bypass this for the current session by running sudo chmod a+rw /dev/hidraw5.
  • Use a HID rule for a more permanent fix. All relevant information you would need to fill in is in glorious.rs.
  • Install the mxw-udev AUR package on Arch Linux.

Installation

Arch Linux - AUR

mxw can be installed using the mxw-git AUR package. Udev rules to use it rootless (without sudo) can additionally be installed from mxw-udev.

Nix

You can either import this in your flake or just run

nix run github:dxbednarczyk/mxw -- [INSERT_FLAGS_HERE]

Example:

nix run github:dxbednarczyk/mxw -- config led-effect off