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