RomanNum3ral
/
Solaar
mirror of https://github.com/pwr-Solaar/Solaar.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
Solaar/docs/installation.md

2.3 KiB
Raw Blame History

Manual installation

Requirements

You should have a reasonably new kernel (3.2+), with the logitech-djreceiver driver enabled and loaded; also, the udev package must be installed and the daemon running. If you have a modern Linux distribution (2011+), you're most likely good to go.

The command-line application (bin/solaar-cli) requires Python 2.7.3 or 3.2+ (either version should work), and the python-pyudev/python3-pyudev package.

The GUI application (bin/solaar) also requires Gtk3, and its GObject Introspection bindings. The Debian/Ubuntu package names are python-gi/python3-gi and gir1.2-gtk-3.0; if you're using another distribution the required packages are most likely named something similar. If the desktop notifications bindings are also installed (gir1.2-notify-0.7), you will also get desktop notifications when devices come online/go offline.

Installation

Normally USB devices are not accessible for r/w by regular users, so you will need to do a one-time udev rule installation to allow access to the Logitech Unifying Receiver.

You can run the rules.d/install.sh script from Solaar to do this installation automatically (it will switch to root when necessary), or you can do all the required steps by hand, as the root user:

  1. Copy rules.d/99-logitech-unifying-receiver.rules from Solaar to /etc/udev/rules.d/. udev will automatically pick up this file using inotify.

    By default, the rule allows all members of the plugdev group to have read/write access to the Unifying Receiver device. (standard Debian/ Ubuntu group for pluggable devices). It may need changes, specific to your particular system's configuration. If in doubt, replacing GROUP="plugdev" with GROUP="<your username>" should just work.

  2. Physically remove the Unifying Receiver and re-insert it.

    This is necessary because if the receiver is already plugged-in, it already has a /dev/hidraw? device node, but with the old (root:root) permissions. Plugging it again will re-create the device node with the right permissions.

  3. Make sure your desktop users are part of the plugdev group, by running gpasswd $USER plugdev as root. If these users were not assigned to the group before, they must re-login for the changes to take effect.