Poster of Linux kernelThe best gift for a Linux geek
MOUSEEMU

MOUSEEMU

Section: Maintenance Commands (8) Updated: 2005-03-29
Local index Up
 

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.


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLES
AUTHOR

This document was created by man2html, using the manual pages.
Time: 22:02:01 GMT, April 16, 2011