NAME

       mouseemu - Emulate mouse buttons and mouse wheel

SYNOPSIS

       mouseemu [options]

DESCRIPTION

       Mouseemu  is a daemon to emulate mouse buttons on trackpads with only one button.  It lets
       you:
         - emulate middle and right click
         - emulate mouse wheel
         - block trackpad while typing

       It was initially developed for Apple PowerBooks and iBooks, but it may be useful on  other
       architectures as well.

       This program only works when booting a 2.6 kernel because it uses the new uinput interface
       to emulate the mouse.

OPTIONS

       -middle B2_MOD B2_KEY
              Modifier and key for the middle (second) mouse  button.  Defaults  to  F11  and  no
              modifier on PowerPC and Intel Macs, and to none on all other architectures.

       -right B3_MOD B3_KEY
              Modifier  and  key  for  the  right  (third)  mouse  button. Defaults to F12 and no
              modifier on PowerPC and Intel Macs, and to none on all other architectures.

       -scroll SCROLL_MOD
              Modifier for the scrolling function. Defaults to none.

       -typing-block DELAY
              Time in milliseconds for which the trackpad will be blocked  while  typing  on  the
              keyboard.  Defaults to 300ms.

       -device UINPUT
              Device  node  for the uinput device. Defaults to /dev/uinput. If this device is not
              read  and  writeable  the  following   devices   are   also   tried:   /dev/uinput,
              /dev/input/uinput and /dev/misc/uinput.

       -nofork
              don't run in the background

       -autorescan
              Automatically  scan  every  5s  for new devices. This is normally not need, as udev
              should inform mouseemu about new devices.

       -debug print debugging messages about device scans

       -help  show usage message

       The key codes for the buttons and modifiers are  key  scancodes.  They  can  be  found  in
       include/linux/input.h  in  the  kernel  headers  or  by  using `showkey` in a console. The
       keycodes must be given as decimal values (`showkey` displays hex values!).

       Mouseemu does normally not automatically scan for new devices. An udev  rule  is  used  to
       trigger a rescan when new devices are connected. You can also trigger a rescan manually by
       sending a HUP signal to the mouseemu process.

EXAMPLES

       To have the same behaviour as in MacOS  X  (CTRL-click  for  right  mouse  button  and  no
       emulation for the middle button):

           mouseemu -middle 0 0 -right 29 272

       The code for the (left) mouse button is 272 (0x110 in hex). The code for CTRL is 29.

       Trigger a rescan for newly attached devices:

           kill -HUP `cat /var/run/mouseemu.pid`

AUTHOR

       Mouseemu  was  written  by   Colin  Leroy <colin@colino.net>.  This manpage was originally
       written by Gaudenz Steinlin <gaudenz@debian.org> for the Debian Project, but may  be  used
       by others under the terms of the GNU General Public License.

                                            2005-03-29                                MOUSEEMU(8)