Logitech MX Master: Difference between revisions

(3 intermediate revisions by one other user not shown)

Line 3:

There are 2 main configuration paths for specific MX Master options:

* [https://search.nixos.org/packages?~~channel=unstable&~~query=solaar Solaar] - GUI

*[https://search.nixos.org/packages?query=solaar Solaar] - GUI application using the <code>hidapi</code> library

* [https://search.nixos.org/packages?~~channel=unstable&~~query=~~Logio~~ LogiOps] - Command Line

* [https://search.nixos.org/packages?query=logiops LogiOps] - Command Line controlled systemd service

*

== [https://search.nixos.org/packages?~~channel=unstable&~~query=solaar Solaar] ==

== Solaar ==

It is possible to quickly ~~run~~ Solaar with nix run~~, set device settings and have them~~ persist.<syntaxhighlight lang="nixos">

[https://search.nixos.org/packages?query=solaar Solaar] is a program that runs as a user process for configuring devices using Logitech's HID++ protocol.

=== Installation ===

It is possible to quickly test Solaar with nix run. Settings will not persist across reboots without proper installation.<syntaxhighlight lang="nixos">

sudo nix run nixpkgs#solaar

# sudo needed to detect mouse

</syntaxhighlight>~~For more extensive configuration~~, ~~gesture support~~, ~~etc perform a proper install~~.

</syntaxhighlight>To install on NixOS:<syntaxhighlight lang="nixos">

environment.systemPackages = with pkgs; [

solaar

];

</syntaxhighlight>Additionally, to use Solaar without `sudo` you will have to add a udev rule. Read the warning and apply caution.<syntaxhighlight lang="nixos">

services.udev.extraRules = ''

# This rule was added by Solaar.

#

# Allows non-root users to have raw access to Logitech devices.

# Allowing users to write to the device is potentially dangerous

# because they could perform firmware updates.

ACTION == "remove", GOTO="solaar_end"

SUBSYSTEM != "hidraw", GOTO="solaar_end"

# USB-connected Logitech receivers and devices

ATTRS{idVendor}=="046d", GOTO="solaar_apply"

# Lenovo nano receiver

ATTRS{idVendor}=="17ef", ATTRS{idProduct}=="6042", GOTO="solaar_apply"

# Bluetooth-connected Logitech devices

KERNELS == "0005:046D:*", GOTO="solaar_apply"

GOTO="solaar_end"

LABEL="solaar_apply"

# Allow any seated user to access the receiver.

# uaccess: modern ACL-enabled udev

TAG+="uaccess"

# Grant members of the "plugdev" group access to receiver (useful for SSH users)

#MODE="0660", GROUP="plugdev"

~~See~~: [https://pwr-solaar.github.io/Solaar/index ~~extensive~~ documentation]

LABEL="solaar_end"

# vim: ft=udevrules

'';

</syntaxhighlight>For further configuration, see: [https://pwr-solaar.github.io/Solaar/index project documentation] or section on udev rule specifically [https://pwr-solaar.github.io/Solaar/installation/#installing-solaars-udev-rule-manually installing udev rule manually]

== [https://search.nixos.org/packages?~~channel=unstable&~~query=~~Logio~~ LogiOps] ==

== LogiOps ==

Is a userspace driver running as a systemd service. Default location for the configuration file is /etc/logid.cfg, but another can be specified using the <code>-c</code> flag.

[https://search.nixos.org/packages?query=LogiOps LogiOps] a userspace driver running as a [[Systemd/User Services|systemd service]]. Default location for the configuration file is /etc/logid.cfg, but another can be specified using the <code>-c</code> flag.

See [https://github.com/PixlOne/logiops/wiki/Configuration project documentation] and [https://wiki.archlinux.org/title/Logitech_MX_Master Arch Wiki] for usage and configuration details.{{expand}}

== Tips ==

== Tips and Tricks ==

=== Smoother Scrolling (Scroll Wheel Resolution) ===

@@ Line 3: / Line 3: @@
 There are 2 main configuration paths for specific MX Master options:
-* [https://search.nixos.org/packages?channel=unstable&query=solaar Solaar] - GUI
+*[https://search.nixos.org/packages?query=solaar Solaar] - GUI application using the <code>hidapi</code> library
-* [https://search.nixos.org/packages?channel=unstable&query=Logio LogiOps] - Command Line
+* [https://search.nixos.org/packages?query=logiops LogiOps] - Command Line controlled systemd service
-*
-== [https://search.nixos.org/packages?channel=unstable&query=solaar Solaar] ==
+== Solaar ==
-It is possible to quickly run Solaar with nix run, set device settings and have them persist.<syntaxhighlight lang="nixos">
+[https://search.nixos.org/packages?query=solaar Solaar] is a program that runs as a user process for configuring devices using Logitech's HID++ protocol.
+=== Installation ===
+It is possible to quickly test Solaar with nix run. Settings will not persist across reboots without proper installation.<syntaxhighlight lang="nixos">
 sudo nix run nixpkgs#solaar
 # sudo needed to detect mouse
-</syntaxhighlight>For more extensive configuration, gesture support, etc perform a proper install.
+</syntaxhighlight>To install on NixOS:<syntaxhighlight lang="nixos">
+  environment.systemPackages = with pkgs; [
+    solaar
+  ];
+</syntaxhighlight>Additionally, to use Solaar without  `sudo` you will have to add a udev rule. Read the warning and apply caution.<syntaxhighlight lang="nixos">
+services.udev.extraRules = ''
+# This rule was added by Solaar.
+#
+# Allows non-root users to have raw access to Logitech devices.
+# Allowing users to write to the device is potentially dangerous
+# because they could perform firmware updates.
+ACTION == "remove", GOTO="solaar_end"
+SUBSYSTEM != "hidraw", GOTO="solaar_end"
+# USB-connected Logitech receivers and devices
+ATTRS{idVendor}=="046d", GOTO="solaar_apply"
+# Lenovo nano receiver
+ATTRS{idVendor}=="17ef", ATTRS{idProduct}=="6042", GOTO="solaar_apply"
+# Bluetooth-connected Logitech devices
+KERNELS == "0005:046D:*", GOTO="solaar_apply"
+GOTO="solaar_end"
+LABEL="solaar_apply"
+# Allow any seated user to access the receiver.
+# uaccess: modern ACL-enabled udev
+TAG+="uaccess"
+# Grant members of the "plugdev" group access to receiver (useful for SSH users)
+#MODE="0660", GROUP="plugdev"
-See: [https://pwr-solaar.github.io/Solaar/index extensive documentation]
+LABEL="solaar_end"
+# vim: ft=udevrules
+    '';
+</syntaxhighlight>For further configuration, see: [https://pwr-solaar.github.io/Solaar/index project documentation] or section on udev rule specifically [https://pwr-solaar.github.io/Solaar/installation/#installing-solaars-udev-rule-manually installing udev rule manually]
-== [https://search.nixos.org/packages?channel=unstable&query=Logio LogiOps] ==
+== LogiOps ==
-Is a userspace driver running as a systemd service. Default location for the configuration file is /etc/logid.cfg, but another can be specified using the <code>-c</code> flag.
+[https://search.nixos.org/packages?query=LogiOps LogiOps] a userspace driver running as a [[Systemd/User Services|systemd service]]. Default location for the configuration file is /etc/logid.cfg, but another can be specified using the <code>-c</code> flag.
 See [https://github.com/PixlOne/logiops/wiki/Configuration project documentation]  and [https://wiki.archlinux.org/title/Logitech_MX_Master Arch Wiki] for usage and configuration details.{{expand}}
-== Tips ==
+== Tips and Tricks ==
 === Smoother Scrolling (Scroll Wheel Resolution) ===