mousemate is a "plugin" for the Video Disk Recorder (VDR).

Written by:                  Joachim Welker <j.welker@gmx.net>
                             Peter Pinnau <vdr@unterbrecher.de>

See the file COPYING for license information.

Description
-----------

This plugin allows using a mouse to control some of VDR's functions through the
mapping of remote control keys to mouse actions. Observed are relative wheel
movement and up to eigth buttons.

You can specify different key bindings for several contexts of VDR (Normal, 
Menu and Replay). A long push of the button toggles to an alternative key 
binding. The alternative key binding can be active temporary or until next long
button push.


Install
-------

- Extract and copy the plugin in /your vdr src/PLUGINS/src/mousemate-0.?.?
  (when you read this, I think you already done it). 
- Make a Link in /your vdr src/PLUGINS/src: 
  	ln -s mousemate-0.?.? mousemate
- Go to /your vdr src/ and compile the plugin (and all other):
  	make plugins
- Install plugins:
  	make install-plugins
- Run your vdr with the option:
  	-P"mousemate -d /dev/input/event"
  The command line parameter -d  specifies the mouse device
  (default:/dev/input/event1). 


How to find the right device
----------------------------
You can find the right device with following line:
 	cat /proc/bus/input/devices
This should produce something like:

  I: Bus=0011 Vendor=0001 Product=0001 Version=ab41
  N: Name="AT Translated Set 2 keyboard"
  P: Phys=isa0060/serio0/input0
  S: Sysfs=/class/input/input0
  H: Handlers=kbd event0
  B: EV=120013
  B: KEY=4 2000000 3802078 f840d001 f2ffffdf ffefffff ffffffff fffffffe
  B: MSC=10
  B: LED=7

  I: Bus=0011 Vendor=0002 Product=0004 Version=0000
  N: Name="GenPS/2 Genius <NULL>"
  P: Phys=isa0060/serio1/input0
  S: Sysfs=/class/input/input2
  H: Handlers=mouse0 event2 ts0
  B: EV=7
  B: KEY=1f0000 0 0 0 0 0 0 0 0
  B: REL=103

In this case the fist device is a keyboard and the second one is a mouse. In 
line "H: Handler=" you can read the right event (here event2). The line 
"N: Name=" can give you a hint to chose the right mouse, if you have more than
one installed.


Setup menu parameters
---------------------

- Sensitivity:
  Sets the sensitivity of mouse wheel's turning actions (1-10).

- Double click time:
  Sets the time in milliseconds between two button clicks to be recognized as
  a double click.

- Toggle click time:
  Sets the time in milliseconds the button had to be pushed to toggle the key 
  binding.

- Show toggle with scroll lock led:
  Should the scroll lock led be used for indicating active toggle? (EXPERIMENTAL)

- Toggle automatic off:
  Should toggle mode be turn off automatically?

- Toggle off time (ms):
  Sets the time in milliseconds after toggle is turn inactive (only important
  if the upper option is set to yes.)

- Context:
  This item is there to choose the current context to specify its key bindings.

- Turn Left,
  Turn Right,
  Pushed Turn Left,
  Pushed Turn Right,
  Left click,
  Left double-click,
  Middle click,
  Middle double-click,
  Right click,
  Right double-click,
  Side click,
  Side double-click,
  Extra click,
  Extra double-click,
  Forward click,
  Forward double-click,
  Back click,
  Back double-click,
  Task click,
  Task double-click:

  The keys that should be triggered at the different events in the
  choosen context. Not all events may be available with your mouse.

TODO
-----
- Plugin sensitve context for menu 
- Sometimes key is sent while toggling
- Improve setup menu

REMARK
------
- This plugin is *not* compatible with Linvdr 0.7 or other ancient Linux.


--------------------

This plugin is based on powermate plugin

Written by:  Andreas Regel <andreas.regel@powarman.de>
 
Project's homepage:          www.powarman.de

