Skip to content
/ Solaar Public
forked from pwr-Solaar/Solaar

Linux device manager for a wide range of Logitech devices

License

Notifications You must be signed in to change notification settings

marsmee/Solaar

 
 

Repository files navigation

title layout
Solaar
default

Solaar is a Linux device manager for Logitech's Unifying, Lightspeed, and Nano receiver peripherals. It is able to pair/unpair devices with the receiver and for most devices show battery status. Solaar can also control some of the changeable features of the devices, such as smooth scrolling or function key behavior. Solaar does not work with Logitech peripherals that use Bluetooth or peripherals from other companies.

Solaar can be used as a GUI application or via its command-line interface. 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.

Solaar does not handle normal input from the peripherals. It is thus unable to fix problems that arise from incorrect handling of mouse movements or keycodes by Linux drivers or other software.

Solaar has progressed past version 1.0. Problems with earlier versions should not be reported as bugs. Instead upgrade to a recent version or manually install the current version.

Supported Devices

Solaar will detect all devices paired with your Unifying, Lightspeed, or Nano receiver, and at the very least display some basic information about them. Solaar can pair and unpair a Logitech device showing the Unifying logo with any Unifying receiver and can pair and unpair devices with Lightspeed receivers. Solaar can pair some Logitech devices with Logitech Nano receivers but not all Logitech devices can be paired with Nano receivers. Logitech devices without a Unifying logo generally cannot be paired with Unifying receivers.

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.

The solaar package uses a standard system tray implementation; to ensure integration with gnome-shell or Unity, install solaar-gnome3.

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.

  • For details on devices using the Nano receiver 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:

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

About

Linux device manager for a wide range of Logitech devices

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 95.6%
  • Shell 4.3%
  • Makefile 0.1%