Thanks to Nestor from Logitech for providing me this device. The firmware on this touchpad features out-of-the-box tap-to-click (no host software needed). The following features work with no additional software (tested in Linux 3.11-rc6 with KDE 4.11): - Left-click: single tap - Middle-click ("scroll-wheel click"): three finger tap - Right-click ("context menu"): two finger tap or tap in right corner - Navigate left ("Back"): three finger slide to left - Navigate right ("Forward"): three finger swipe to the right - Scroll (up/down/right/left): slide with two fingers - Move pointer (any direction): slide Click and drag is also possible (for example, for selecting text or moving windows with Super + right/left-click in KDE), just press harder on the surface. Right click is in the bottom-right corner, left is anywhere else. Sliding with three fingers up acts if you pressed Super. Sliding with three fingers down triggers a key press of Super + D (normally the "Show Desktop" in MSWIN). Not working as it requires additional software: - Pinch-to-zoom. - Four-finger gestures, likely needs to be controlled via features as there are no HID messages at all. |
||
---|---|---|
bin | ||
docs | ||
jekyll | ||
lib | ||
packaging | ||
po | ||
rules.d | ||
share | ||
tools | ||
.gitignore | ||
COPYING | ||
COPYRIGHT | ||
ChangeLog | ||
MANIFEST.in | ||
README | ||
README.md | ||
setup.py |
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.
- Debian 7 (Wheezy) or higher: packages in this repository
- Ubuntu/Kubuntu 12.04+: ppa:daniel.pavel/solaar
The solaar
package uses a standard system tray implementation; to ensure
integration with gnome-shell or Unity, install solaar-gnome3
.
- an Arch package, courtesy of Arnaud Taffanel
- a Gentoo overlay, courtesy of Carlos Silva
- a Mageia package, courtesy of Damien Lallement
- an OpenSUSE rpm, courtesy of Mathias Homann
Manual installation
See docs/installation.md for the step-by-step procedure for manual installation.
Known Issues
-
KDE/Kubuntu: if some icons appear broken in the application, make sure you've properly configured the Gtk theme and icon theme in KDE's control panel.
-
Some devices using the Nano Receiver (which is very similar to the Unifying Receiver) are supported, but not all. For details, see docs/devices.md.
-
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.