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
41 Commits 3 Branches 90 Tags 15 MiB
Python 99.1%
Shell 0.7%
Makefile 0.2%
Go to file
Daniel Pavel cb3a42c04e greatly simplified loading of icons 2012-10-05 02:39:32 +03:00
app greatly simplified loading of icons 2012-10-05 02:39:32 +03:00
lib greatly simplified loading of icons 2012-10-05 02:39:32 +03:00
resources greatly simplified loading of icons 2012-10-05 02:39:32 +03:00
rules.d added hidapy python wrapper, and initial support for the Logitech Universal Receiver 2012-09-19 03:58:08 +03:00
tools some clean-ups in the logitech library 2012-09-28 13:58:17 +03:00
.gitignore brought solar app up-to-date with the UR api 2012-09-25 17:41:40 +03:00
LICENSE added license file 2012-10-03 08:25:33 +03:00
README updated README with installation instructions 2012-09-28 14:37:53 +03:00
logitech_k750.py de-hardcode interface numbers; make script smart enough to find the secret sauce interface 2012-02-23 14:42:04 -06:00
solaar greatly simplified loading of icons 2012-10-05 02:39:32 +03:00
solaar.py greatly simplified loading of icons 2012-10-05 02:39:32 +03:00

README 

Solaar


This application connects to a Logitech Unifying Receiver and puts an icon in
the systray that watches for events from devices attached to it.

Currently the K750 solar keyboard is also queried for its solar charge status.
Other devices can also be added in the future (the K750 keyboard is the only
device I have and can test on).


Requirements
------------

- Python (2.7 or 3).
- Python GI (GObject Introspection), for Gtk bindings.
- A hidapi native implementation (see below for details).
- Optional python-notify2 for desktop notifications.


Installation
------------

1. Make the Logitech Unifying Receiver device available to standard users

Normally USB devices are not accessible for r/w by regular users.

In rules.d/ you'll find a udev rule to be copied in /etc/udev/rules.d/ . In its
current form it makes the UR device available for r/w by all users belonging to
the 'plugdev' system group (standard Debian group for pluggable devices). It may
need changes, specific to your particular system's configuration.

2. Compile the hidapi native library.

Solaar uses a thin ctypes layer on top of a native hidapi library to talk
directly to the UR device. Its source code is available here:
https://github.com/signal11/hidapi .

The native library comes in two flavors, `hidraw` and `libusb`. You should
compile and use the hidraw implementation (in linux/); the libusb version
disconnects the device from the kernel and may cause your UR-connected devices
to stop working until you physically remove and re-insert the UR.

Once compiled, you should copy the shared library (libhidapi-hidraw.so) to the
lib/ directory in the application.

3. Start the application with ./solaar


Notes
-----

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 Julien Danjou
(http://julien.danjou.info/blog/2012/logitech-k750-linux-support) and
Lars-Dominik Braun (http://6xq.net/git/lars/lshidpp.git).


Cheers,
-pwr