summaryrefslogtreecommitdiffstats
path: root/system/Solaar/README
diff options
context:
space:
mode:
Diffstat (limited to 'system/Solaar/README')
-rw-r--r--system/Solaar/README23
1 files changed, 23 insertions, 0 deletions
diff --git a/system/Solaar/README b/system/Solaar/README
new file mode 100644
index 0000000000..9c6b8509f9
--- /dev/null
+++ b/system/Solaar/README
@@ -0,0 +1,23 @@
+Solaar is a Linux device manager for Logitech's Unifying Receiver
+peripherals. It is able to pair/unpair devices to the receiver, and for
+most devices read battery status.
+
+It comes in two flavors, command-line and GUI. Both are able to list the
+devices paired to a Unifying Receiver, show detailed info for each
+device, and also pair/unpair supported devices with the receiver.
+
+Solaar will detect all devices paired with your Unifying Receiver, and
+at the very least display some basic information about them. For some
+devices, extra settings (usually not available through the standard
+Linux system configuration) are supported.
+
+By default, the udev rule
+/etc/udev/rules.d/42-logitech-unifying-receiver.rules
+allows all members of the plugdev group to have read/write access to the
+Unifying Receiver device. Therefore, make sure all desktop users are
+part of the plugdev group:
+usermod -a -G plugdev <username>
+
+After installation, you must physically remove the Unifying Receiver and
+re-insert it for the device node permissions to take effect for the
+first time.