Differences

This shows you the differences between two versions of the page.

--- ubuntu:mouse:map_mouse_buttons [2021/10/25 09:34] – peter
+++ ubuntu:mouse:map_mouse_buttons [2021/10/26 14:07] (current) – peter
@@ Line 1: / Line 1: @@
 ====== Ubuntu - Mouse - Map Mouse Buttons ======
+In most cases,
+  * Buttons 1, 2, 3 are interpreted as left, middle, right.
+  * Logical buttons 4, 5, 6, 7 are usually interpreted as scroll up, down, left, right.
+  * The fourth and fifth physical buttons on a device will thus send logical buttons 8 and 9.
+----
   * [[Ubuntu:Mouse:Determine the Mouse|Determine the Mouse]].
@@ Line 6: / Line 14: @@
 ----
-===== Map the Mouse Buttons =====
+===== Map a Mouse Button to Another Button =====
+This can be useful for changing the mouse for left-handed people.
+  * The left and right buttons could be swapped around (the 3 and 1 are switched).
+<code bash>
+xinput set-button-map 8 3 2 1 4 5 6 7 8 9
+</code>
+<WRAP info>
+**NOTE:**  The initial **8** is the Mouse Id as determined above.
+  * The remaining **3 2 1 4 5 6 7 8 9** is the 9 mouse buttons as determined above.
+  * Usually this would be in the order **1 2 3**, where
+    * **1**: is the left mouse button.
+    * **2**: is the middle mouse button.
+    * **3**: is the right mouse button.
+  * Here, button 3 is swapped with button 1.
+    * This means that when the actual left button on the mouse is clicked it results in a right-click.
+    * Also, clicking on the actual right mouse button results in a left-click.
+</WRAP>
+----
+===== Disable a Specific Mouse Buttons =====
 <code bash>
@@ Line 19: / Line 55: @@
   * Here, button 2 is replaced by a zero.
     * This disables this button.
-  * For left-handed people, the left and right buttons could be swapped around (the 3 and 1 are switched).
-    * **3 2 1 4 5 6 7 8 9**
 </WRAP>
@@ Line 27: / Line 60: @@
 ----
-===== Mapping Mouse Buttons to Arbitrary Functions =====
+====== Run at startup ======
-Create or edit **~/.xbindkeysrc**.
+One approach is to create a shell script that performs the Mouse Button mapping:
-  * To create a double-click event when a button is released, I added the following:
+<code bash>
+echo "xinput --set-button-map 21 3 2 1" > leftmouseremap.sh
+</code>
-<file bash ~/.xbindkeysrc>
+Give it executable permission:
-"/usr/bin/xte 'mouseclick 1' 'mouseclick 1' &"
-b:8 + Release
-</file>
-----
+<code bash>
+chmod +x leftmouseremap.sh
+</code>
+<WRAP info>
+**NOTE:**  Either run the script manually, or configure it to automatically run on system reboot.
+  * Follow any process to have this script run at boot if needed.
+  * Remember to configure 'xbindkeys' to run automatically on system startup too if needed:
+    * '/usr/bin/xbindkeys'
+</WRAP>
-The format of this file is a series of paired lines. The first line is a command to be executed for an event; the second line is the event description. We will use the xte component of xautomation to send events directly to the input handler.
 ----
@@ Line 51: / Line 90: @@
 http://manpages.ubuntu.com/manpages/focal/man1/xev.1.html
+https://linux.die.net/man/7/xautomation
+https://manpages.debian.org/stretch/xautomation/xte.1