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
829 Commits 3 Branches 90 Tags 15 MiB
Python 99.1%
Shell 0.7%
Makefile 0.2%
Go to file
Peter Wu 5ba816dd38 [WIP] Support MX Master with DPI adjustment support (#208) 
It's not known whether the DPI ranges can be queried, so let's set
hard-code some values for now. Step size is 200. Does this need to
be changed?

TODO: need a capture of whether this is really a read function.
 		2015-05-31 15:53:26 +02:00
bin merged solaar-cli functionality into main solaar binary 2013-08-09 12:25:47 +02:00
docs Merge branch 'updates' 2015-05-27 23:43:10 +02:00
jekyll jekyll configuration update 2013-08-09 12:29:02 +02:00
lib [WIP] Support MX Master with DPI adjustment support (#208) 2015-05-31 15:53:26 +02:00
packaging Ignore HID++ devices on Linux 3.19+ 2015-05-14 23:28:04 +02:00
po Added Spanish Translation 2015-03-05 13:05:59 +00:00
rules.d Ignore HID++ devices on Linux 3.19+ 2015-05-14 23:28:04 +02:00
share replaced appinstance with GtkApplication 2013-07-09 17:52:07 +02:00
tools po-update.sh without arguments re-formats all translation files 2013-08-08 22:22:39 +02:00
.gitignore minor clean-ups 2013-07-18 20:36:27 +02:00
COPYING added copyright notices to all source files 2013-07-15 17:54:42 +02:00
COPYRIGHT proper debian packaging, dropper stdeb 2013-01-05 11:48:35 +02:00
ChangeLog changelog update 2013-08-09 12:28:47 +02:00
MANIFEST.in started i18n support 2013-07-15 17:16:44 +02:00
README added a symlink to README.md to pacify sdist 2013-07-07 12:25:12 +02:00
README.md Add Fedora package information to README.md 2014-07-30 14:39:46 -04:00
setup.py added 'solaar.cli' on setup.py files (line 74 "packages=") 2013-08-13 11:02:13 +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.

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.

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

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