Solaar

Linux device manager for Logitech devices

Go to file

Daniel Pavel d857144653 added script to build gh-pages with jekyll		2013-05-21 01:12:04 +03:00
bin	small fixes to hidconsole	2013-04-28 14:00:46 +02:00
docs	minor updates to the documentation files	2013-05-21 00:46:07 +03:00
jekyll	added jekyll skeleton for the site	2013-05-21 00:46:49 +03:00
lib	the 'Solar key' on K750 is named 'Light Check button'	2013-05-21 00:48:21 +03:00
packaging	added script to build gh-pages with jekyll	2013-05-21 01:12:04 +03:00
rules.d	incipient support for the Nano receiver	2013-04-28 14:27:16 +02:00
share	use a separate icon for the about logo	2013-05-20 16:32:26 +03:00
tools	added script to build gh-pages with jekyll	2013-05-21 01:12:04 +03:00
.gitignore	ignore some development-side directories	2013-01-07 12:05:40 +02:00
COPYING	updated FSF address in COPYING	2013-04-29 15:34:00 +02:00
COPYRIGHT	proper debian packaging, dropper stdeb	2013-01-05 11:48:35 +02:00
ChangeLog	next version will be 0.8.8	2013-05-06 14:33:06 +02:00
MANIFEST.in	added source changelog file	2013-01-08 00:55:47 +02:00
README.md	minor updates to the documentation files	2013-05-21 00:46:07 +03:00
setup.py	setup.py: use the version declared in the sources	2013-05-21 01:08:34 +03:00

README.md

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.

Supported Devices

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. For a full list of supported devices and their features, see docs/devices.md.

Pre-built packages

Pre-built packages are available for a few Linux distros:

Ubuntu 12.04+: ppa:daniel.pavel/solaar
a Debian Wheezy package .deb, should work on testing and Sid as well
a Gentoo overlay, courtesy of Carlos Silva
an OpenSUSE rpm, courtesy of Mathias Homann
an Arch package, courtesy of Arnaud Taffanel

Manual installation

See docs/installation.md for the step-by-step procedure for manual installation.

Known Issues

Ubuntu's Unity indicators are not supported at this time. However, if you whitelist 'Solaar' in the systray, you will get an icon (see Enable more icons to be in the system tray? for details).

Devices connected throught a Nano Receiver (which is very similar to the Unifying Receiver) are not supported at this time.

Running the command-line application (bin/solaar-cli) while the GUI application is also running may occasionally cause either of them to become confused about the state of the devices. I haven't encountered this often enough to be able to be able to diagnose it properly yet.

License

This software is distributed under the terms of the GNU Public License, v2.

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:

Julien Danjou, who also provided some internal Logitech documentation
Lars-Dominik Braun
Alexander Hofbauer
Clach04
Peter Wu
Nestor Lopez Casado provided some more Logitech specifications for the HID++ protocol

Also thanks to Douglas Wagner, Julien Gascard and Peter Wu for helping with application testing and supporting new devices.