ManyButtonsMouseHowto

Differences between revisions 2 and 3
Revision 2 as of 2005-07-26 06:19:39
Size: 3914
Editor: S0106000000cc07fc
Comment: add category documentation, cleanup
Revision 3 as of 2006-06-19 16:06:39
Size: 65
Editor: 127
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
## This wiki explains how to (1) activate extra mouse buttons on mice with forward/backwards buttons, or
## multi button mice (like Turbo Mouse) and (2) how to control what ANY mouse button does.
= Many Buttons Mouse Howto =

This page gives useful informations to configure one of those mice with tons of buttons, wheels and other controls.

If you have installed the GNOME environment you ALREADY have the software needed to get the "4th" and "5th" mice buttons working (forward/backward on most mice)!

In /etc/X11/xorg.conf or /etc/X11/XF86Config-4 change {{{Option "Buttons" "5"}}} to {{{Option "Buttons" "7"}}} (see "The X11 configuration file" section for an example). You may also have to change the ZAxisMapping option from "4 5" to "6 7" but you'll have to experiment to see what your set-up needs.

== How to do it ==

The key to being able to program your mouse buttons is to install imwheel. Download and install it using Synaptic or apt-get.

Then, you will modify your /etc/X11/xorg.conf (or XF86Config-4) file to register that your mouse is more than the "standard" five (5) button mouse.

Note: A "standard" 2 (left, right click) + 1 (middle click/scroll) button mouse is actually a five button mouse from X11's perspective! The scroll wheel's up and down action counts as mouse buttons 4 and 5. This means that any mouse with one scroll wheel has two more buttons than you'd expect.

Then, you need to modify your /etc/X11/imwheel/imwheelrc or ~/.imwheelrc files to tell imwheel what to do with a mouse click when it happens in a particular application (see the wikis referenced below for details on what you can do with your imwheelrc or .imwheelrc file).

Note: If you modify ~/.imwheelrc this means that you can customise the imwheel behaviour for each user on the system.

Then, if desired, you have to tell X11 to run imwheel whenever X11 is started (modifying /etc/X11/Xsession.d/60imwheel_start-imwheel _and_ changing IMWHEEL_START=0 to =1 in /etc/X11/imwheel/startup.conf). Alternatly, you can start imwheel manually.

PS See IntellimouseMousemanBackForwardButtons for an outstanding explanation of how to set up imwheel properly.

== The X11 configuration file ==

This is what the relevant portion of my xorg.conf file looks like:
{{{
Section "InputDevice"
        Identifier "Configured Mouse"
        Driver "mouse"
        Option "CorePointer"
        Option "Device" "/dev/input/mice"
        Option "Protocol" "ExplorerPS/2"
        Option "Emulate3Buttons" "false"
        Option "Buttons" "7"
        Option "ZAxisMapping" "6 7"
EndSection
}}}

== The .imwheelrc configuration file ==

And my .imwheelrc looks like:
{{{
"^Firefox-bin$"
# Flip between browser tabs
None, Left, Control_L|Page_Up
None, Right, Control_L|Page_Down
}}}

(obviously you'd add more applications to this file if you'd like to customise the mouse button behaviour in those apps)

== Useful links ==

 * http://www.google.com/search?q=configure+x11+mouse+buttons&btnG=Search&hl=en&lr=
 * IntellimouseMousemanBackForwardButtons
 * http://subwiki.honeypot.net/cgi-bin/view/Computing/ExtraMouseButtons

 * http://forums.macosxhints.com/showpost.php?p=46998&postcount=57
 * http://www.lirc.org/html/configure.html
 * http://www.linuxnetmag.com/en/issue5/m5mouse1.html
 * http://fedoraforum.org/forum/showthread.php?t=27470
 * http://fedoraforum.org/forum/showthread.php?s=5745dd389c241334b0dc76f0f7b86a16&t=25659
 * http://docs.hp.com/en/B2355-90122/ch06s04.html
 * http://www.linuxforum.com/linux_tutorials/70/1.php

== Credits ==

Most of the contents have been posted in the ubuntu-users list by Eric Dunbar, and have been (graciously) copied to the wiki by EnricoZini.

CategoryDocumentation CategoryCleanup
#REFRESH 0 http://help.ubuntu.com/community/ManyButtonsMouseHowto

ManyButtonsMouseHowto (last edited 2008-08-06 16:36:23 by localhost)