Skip to content

About

Logi Options+ alternative for Linux & SteamOS: MX Master 3S DPI, SmartShift, button remapping and gestures. One-line install.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

Repository files navigation

Logi Options for Linux: MX Master 3S settings on Linux & SteamOS

Clickwork is a small, unofficial Logi Options+ alternative for Linux. Change DPI, scroll wheel and button settings on a Logitech MX Master 3S (and other HID++ mice) from a simple settings page. Works on SteamOS / Steam Deck / Steam Machine, Ubuntu, Fedora, Arch and any Linux with systemd.

Clickwork settings page

Install (one command)

Open a terminal (on SteamOS: Desktop Mode → Konsole) and paste:

curl -fsSL https://raw.githubusercontent.com/dealwith/logi-options-linux/main/get.sh | bash

The settings page opens on its own. You can also find Clickwork in your app menu, or go to http://127.0.0.1:7317/

SteamOS: sudo needs a password once. If you never set one, run passwd first.

What the installer does

  • Copies the app to ~/.local/share/clickwork (no system packages, no pip; Python standard library only)
  • Adds one udev rule (/etc/udev/rules.d/70-clickwork.rules) so your user can talk to the mouse. This is the only step that needs sudo.
  • Starts a background user service (clickwork.service) that keeps your settings applied

Features

Pointer speed DPI slider (200 to 8000 on MX Master 3S) and 3 DPI presets
Scroll wheel Ratchet / free spin, SmartShift auto-switch and sensitivity, ratchet force (on mice that support it), reverse scroll, reverse thumb wheel
Button remapping Middle, back, forward, gesture and wheel-mode buttons → keyboard shortcut, mouse button, run a command, cycle DPI, DPI shift while held, toggle wheel mode, horizontal scroll, or disable
Gestures Hold the gesture (thumb) button and move up / down / left / right, or tap
Always on Settings come back by themselves after sleep or reconnect, and remaps work in Steam Gaming Mode too

Connects over Bluetooth or a Logi Bolt / Unifying receiver.

Supported mice

Made and tuned for the Logitech MX Master 3S. Other Logitech mice that use HID++ 2.0 should work too: MX Master 3, MX Master 2S, MX Anywhere 3/3S, MX Vertical, M720 and others. Clickwork reads what each mouse supports and only shows those settings.

Manual install

git clone https://github.com/dealwith/logi-options-linux.git
cd logi-options-linux
./install.sh

Try it without a mouse (simulated device):

python3 clickworkd.py --demo --open

Uninstall

~/.local/share/clickwork/uninstall.sh

Troubleshooting

  • "No permission to open /dev/hidraw…": unplug and replug the receiver (or turn the mouse off and on), or reboot once after installing.
  • Buttons don't do anything: close Solaar or logiops if they're running. Two tools controlling the same buttons will fight.
  • Shortcuts type the wrong keys: key names follow a US layout (ctrl+shift+t, super, alt+tab, f12, volumeup, playpause).
  • Logs: journalctl --user -u clickwork -f

Please open an issue with the log output if your mouse isn't detected.

Why not Logi Options+?

Logitech only ships Logi Options+ for Windows and macOS, so on Linux and SteamOS there's no official way to change MX Master 3S settings. Clickwork covers the main settings in one small Python file plus a web page. Left and right click can never be remapped, so you can't lock yourself out.

License

MIT. Not affiliated with or endorsed by Logitech. Logitech, Logi, MX Master and Logi Options+ are trademarks of Logitech.

About

Logi Options+ alternative for Linux & SteamOS: MX Master 3S DPI, SmartShift, button remapping and gestures. One-line install.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages