Linux device manager for Logitech devices
Go to file
Peter Wu dded8504e6 Fix window positioning of main windows
Previously, the intent was likely to position the receiver window near the
status icon. It did so by calling move followed by present. According to the
Gtk documentation, move() may fail if the window is hidden before.

Therefore present the window *after* determining the position, but *before*
moving it. (presenting the window before getting the position gives a Gtk
warning and has unpredictable behavior wrt. the window position).

As window positioning is now enabled, add additional logic to prevent overlap
of windows: position the first window near the status icon and others on the
left. This is not idea, e.g. when the status icon is on the left side of the
screen, but the idea of positioning windows near to each other is broken anyway.
2013-05-05 11:18:29 +02:00
bin small fixes to hidconsole 2013-04-28 14:00:46 +02:00
docs removed dox(x) documentation 2013-05-04 19:42:26 +02:00
lib Fix window positioning of main windows 2013-05-05 11:18:29 +02:00
packaging minor fixes in shell scripts 2013-05-04 19:00:14 +02:00
rules.d incipient support for the Nano receiver 2013-04-28 14:27:16 +02:00
share fixed icon name in desktop file 2013-01-09 21:41:50 +02:00
tools minor fixes in shell scripts 2013-05-04 19:00:14 +02: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 release 0.8.7 2013-01-18 18:37:06 +02:00
MANIFEST.in added source changelog file 2013-01-08 00:55:47 +02:00
README.md split manual instalation procedure into it's own document 2013-05-04 14:13:31 +02:00
setup.py version increased to 0.8.7.1 2013-04-28 13:59:07 +02: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:

Manual installation

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

Known Issues

  • The application only looks at the first Unifying Receiver it finds, even if there's more than one plugged in. Support for multiple receivers is in progress.

  • 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.

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:

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

--