====== Ubuntu - Mouse - Determine the Mouse Button Numbers ======

Each button on the mouse should have a Unique number associated with it.

This Button Number can be used to configure a specific button.

----

===== Determine the Mouse to use =====

<code bash>
xinput | grep -m 1 "DeathAdder" | sed 's/^.*id=\([0-9]*\)[ \t].*$/\1/'
</code>

returns: <code bash>
8
</code>

<WRAP info>
**NOTE:**  See [[Ubuntu:Mouse:Determine the Mouse|Determine the Mouse]].

  * This shows that the id of the mouse is 8 in this case.
</WRAP>

----

===== Get Button Map =====

<code bash>
xinput get-button-map 8
</code>

returns:

<code bash>
1 2 3 4 5 6 7 8 9
</code>

<WRAP info>
**NOTE:**  The id of 8 is used, as determined by the previous command.

  * The result shows that the mouse has 9 buttons.
</WRAP>

----


----

===== Determine Which Mouse Button is Which =====

<code bash>
xinput test
</code>

returns:

<code bash>
...
button press   1 
button release 1 
...
</code>

<WRAP info>
**NOTE:**  A unique button number should be able to be determined for each button on the mouse.

  * In this case, the result shows **button press   1** when the left mouse button on the mouse was pressed.
    * Determine the Button Number for every button.

  * Usually left mouse button is shown as **button 1**.
  * Usually middle mouse button is shown as **button 2**.
  * Usually right mouse button is shown as **button 3**.
  * Other buttons can be determined through trial and error.
    * The scroll wheel on the mouse (both forwards and backward scrolls) also have a unique button id.

</WRAP>


----

===== Another Way to Determine the Mouse Buttons =====

<code bash>
xev | grep button

or

xev
</code>

displays:

{{:ubuntu:mouse:xev.png?100|}}

<WRAP info>
**NOTE:** Move the mouse cursor within the boxes and the xev will display many lines of data relating to mouse movements and button presses.
</WRAP>

----

==== Identify Each Button Number ====

With **xev** running, move the mouse pointer into the xev display and click each button on the mouse.

<code bash>
ButtonPress event, serial 37, synthetic NO, window 0x6200001,
    root 0x1e4, subw 0x0, time 2473474233, (151,31), root:(239,183),
    state 0x0, button 1, same_screen YES
</code>

<WRAP info>
**NOTE:**  A unique button number should be able to be determined for each button on the mouse.

  * In this case, the bottom line of the result shows **button 1** when the left mouse button on the mouse was pressed.
    * Determine the Button Number for every button.

  * Usually left mouse button is shown as **button 1**.
  * Usually middle mouse button is shown as **button 2**.
  * Usually right mouse button is shown as **button 3**.
  * Other buttons can be determined through trial and error.
    * The scroll wheel on the mouse (both forwards and backward scrolls) also have a unique button id.

</WRAP>

----

===== References =====

http://manpages.ubuntu.com/manpages/focal/man1/xev.1.html