Linux device manager for Logitech devices
Go to file
Daniel Pavel 6e939e9485 small documentation updates 2012-11-06 18:44:24 +02:00
app use the first python version found when starting the scripts 2012-11-05 20:52:51 +02:00
bin LD_LIBRARY_PATH no longer needed 2012-11-06 17:38:49 +02:00
lib small documentation updates 2012-11-06 18:44:24 +02:00
rules.d small documentation updates 2012-11-06 18:44:24 +02:00
share optimized some images 2012-11-02 10:04:48 +02:00
.gitignore brought solar app up-to-date with the UR api 2012-09-25 17:41:40 +03:00
COPYING readme and installation notes updated, license changed to GPLv2 2012-10-13 23:28:06 +03:00
README small documentation updates 2012-11-06 18:44:24 +02:00

README

Solaar
------


This application connects to a Logitech Unifying Receiver
(http://www.logitech.com/en-us/66/6079) and listens for events from devices
attached to it.

Currently the K750 solar keyboard is also queried for its solar charge status.
Support for other devices could be added in the future, but the K750 keyboard is
the only device I have and can test on.


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

- Python (2.7 or 3.2). Either version should work well.
- Gtk 3; Gtk 2 should partially work with some problems.
- Python GI (GObject Introspection), for Gtk bindings.
- pyudev for enumerating udev devices.
- Optional libnotify GI bindings, for desktop notifications.

The necessary packages for Debian/Ubuntu are `python-pyudev`/`python3-pyudev`,
`python-gi`/`python3-gi`, `gir1.2-gtk-3.0`, and optionally `gir1.2-notify-0.7`.


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

Normally USB devices are not accessible for r/w by regular users, so you will
need to install a udev rule to allow access to the Logitech Unifying Receiver.

In rules.d/ you'll find a udev rule file, to be copied in /etc/udev/rules.d/ (as
root).

In its current form it makes the UR device available for r/w by all users
belonging to the 'plugdev' system group (standard Debian/Ubuntu group for
pluggable devices). It may need changes, specific to your particular system's
configuration.

If in doubt, replacing GROUP="plugdev" with GROUP="<your username>" should just
work.

After you copy the file to /etc/udev/rules.d (and possibly modify it for your
system), run 'udevadm control --reload-rules' as root for it to apply. Then
physically remove the Unifying Receiver, wait 30 seconds and re-insert it.


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, among others, 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