Multi-pointer X

From ArchWiki
Jump to navigation Jump to search

Xorg servers starting from version 1.7 have a feature called "multi-pointer". Basically it allows to have multiple mouse cursors (each with its own keyboard focus) on the screen and control them with separate physical input devices. It can be used as a crude multiseat solution.

Basic concepts

Master and slave devices

With the introduction of XInput2, input devices are organised in a two-level hierarchy:

  • Master devices, which correspond to cursors on the screen
  • Slave devices, which correspond to physical input devices

Master devices come in pairs, one for pointer and one for keyboard. Each master device can have a number of slave devices attached, so that cursor of a master device can be controlled by all slave devices attached to it.

Client pointer

When an application grabs input (e.g. a fullscreen game), it grabs a master device that is set as its client pointer. By default, the client pointer is set to "Virtual core pointer", but it can be set to a different one with a "xinput" utility.


configuration file

Tango-view-fullscreen.pngThis article or section needs expansion.Tango-view-fullscreen.png

Reason: Information how to configure multipointer with xorg.conf should be added (Discuss in Talk:Multi-pointer X#)

xinput utility

More pointers can be added with xinput CLI utility. Here is how to do it:

Create a new pair of master devices named "name pointer" and "name keyboard":

xinput create-master [name]

Find out names and ids of existing slave devices:

xinput list

Reattach slave devices to newly created master devices:

xinput reattach [slave device name or id] [master device name or id]

For example, say we create a device called "Auxiliary":

xinput create-master Auxiliary

When we list the xinput devices you should see something like this:

Virtual core pointer
  >Virtual Core XTEST pointer
  >[probably your main mouse]
Virtual core keyboard
  >Virtual Core XTEST pointer
  >[probably your main keyboard]
  >[other function buttons]
Auxiliary pointer
  >auxiliary XTEST pointer
Auxiliary keyboard
  >auxiliary XTEST keyboard

What you then want to do is simply attach your secondary mouse and keyboard to the respective auxiliary positions. The XTEST devices are irrelevant here. I found the easiest way to determine whats what was to just unplug stuff and type "xinput list" again.

To attach devices, you type:

xinput reattach [device id #] "Auxiliary pointer"

and then do so for your keyboard as well!

Shamelessly stolen from Antonio Ospite at



The Compton compositor can cause the cursors to flicker and should be disabled.

Software support

It is possible to use multi-pointer with software that doesn't explicitly support it, but with limited functionality. Applications which do not support it won't distinguish between multiple pointers and will interpret all actions as if done by single master device pair.

Window managers

In window managers multi-pointer support could mean:

  • recognizing multiple focuses
  • setting the client pointer of a focused window to the pointer that "focused" it
  • letting move and resize windows simultaneously

As of 24 December 2016, only multicursor-wm (development stops around 2011) supports multi-pointer.

Useful links