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.
Open a terminal (on SteamOS: Desktop Mode → Konsole) and paste:
curl -fsSL https://raw.githubusercontent.com/dealwith/logi-options-linux/main/get.sh | bashThe 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
passwdfirst.
- 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
| 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.
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.
git clone https://github.com/dealwith/logi-options-linux.git
cd logi-options-linux
./install.shTry it without a mouse (simulated device):
python3 clickworkd.py --demo --open~/.local/share/clickwork/uninstall.sh- "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.
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.
MIT. Not affiliated with or endorsed by Logitech. Logitech, Logi, MX Master and Logi Options+ are trademarks of Logitech.
