RomanNum3ral
/
Solaar
mirror of https://github.com/pwr-Solaar/Solaar.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
Linux device manager for Logitech devices
152 Commits 3 Branches 90 Tags 15 MiB
Python 99.1%
Shell 0.7%
Makefile 0.2%
Go to file
Daniel Pavel f0007d0a13 updates to the command lines 2012-12-07 13:41:07 +02:00
app updates to the command lines 2012-12-07 13:41:07 +02:00
bin added solaar-cli for command-line operations 2012-12-03 11:34:35 +02:00
lib updates to the command lines 2012-12-07 13:41:07 +02:00
rules.d added script for udev rule installation 2012-12-05 12:08:45 +02:00
share optimized appicon mask 2012-12-01 19:16:52 +02:00
.gitignore brought solar app up-to-date with the UR api 2012-09-25 17:41:40 +03:00
COPYING readme and installation notes updated, license changed to GPLv2 2012-10-13 23:28:06 +03:00
README.md added script for udev rule installation 2012-12-05 12:08:45 +02:00

README.md

Solaar is a Linux device manager for Logitech's Unifying Receiver peripherals.

It comes in two flavours, 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.

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 (it will switch to root when necessary), or you can do all the required steps by hand, as the root user:

  • copy rules.d/99-logitech-unfiying-receiver.rules from Solaar to /etc/udev/rules.d/

    By default, the rule makes the Unifying Receiver device available for r/w by all users belonging to the plugdev system group (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.

  • run udevadm control --reload-rules to let the udev daemon know about the new rule

  • physically remove the Unifying Receiver, wait 10 seconds and re-insert it

Supported Devices

Solaar will detect all devices paired with your Unifying Receiver, and at the very least display some basic information about them. Depending on the device, it may be able to read its battery status. Changing various settings of the devices (like mouse DPI) is currently not supported, but implementation is planned.

The K750 Solar Keyboard is also queried for its solar charge status. Pressing the Solar key on the keyboard will pop-up the application window and display the current lighting value, similar to Logitech's Solar app for Windows.

Extended support for other devices will be added in the future, depending on the documentation available, but the K750 keyboard is the only device I have and can test on right now.

Thanks

This project began as a third-hand clone of Noah K. Tilton's logitech-solar-k750 project on GitHub (no longer available). It was developed further thanks to the diggings in Logitech's HID++ protocol done by many other people: