pyClick - a pseudo-driver for the Griffin AirClick USB for Linux
version 0.1 - 23/04/2006

pyClick is a small Python script that runs user-configurable commands
for each key on the AirClick remote control.
I wouldn't go so far as to say that it's a proper driver, as it makes
some very naive assumptions. It does, however, Work For Me.

How it works
============
The script reads the hiddev device node associated with the AirClick
device as a text file and looks for certain characters that seem to 
occur when each key is pressed. It then runs a user-configurable
command for each key. By default, it uses xte from the xautomation
package to simulate X keypresses, such as Play/Pause, Next Track, 
Prev Track, etc.
It's a little bit of a botched way of doing it, but it does the
trick :)

Requirements
============
Python
screen
xautomation (http://hoopajoo.net/projects/xautomation.html)

Installation
============
1. Put bin/pyclick and bin/pyclick.py from the .tar.gz archive
   somewhere in your $PATH. ~/bin or /usr/local/bin is a good bet.

2. Put .pyclick.conf from the archive in your home directory, and
   edit it to contain the correct path to the hiddev file associated
   with your AirClick device. This will usually be /dev/hiddev0 or
   /dev/usb/hiddev0

3. Run 'pyclick', and enter your password (the script uses sudo
   to set world-read permissions on the hiddev file)

4. Gape in awe as you control your Linux media player from your
   AirClick remote.


Configuration
=============
You can edit the pyclick.py file to change the commands attached to
each key. It's labelled towards the top of that file.


Who's mad enough to create such a hack?
=======================================
Dave Arter <dave@minus-zero.org>
Feedback/criticism/etc welcome, either via e-mail on on my blog at
http://blog.minus-zero.org/index.php/davea/entry/pyclick

Project page: http://minus-zero.org/projects.html#pyclick