Difference between revisions of "Mouse acceleration"

From ArchWiki
Jump to: navigation, search
(Disabling mouse acceleration: added info that restarting X is needed after changing stuff in xorg.conf)
m (reword accuracy flag)
 
(28 intermediate revisions by 19 users not shown)
Line 1: Line 1:
 
[[Category:Mice]]
 
[[Category:Mice]]
[[Category:X Server]]
+
[[Category:X server]]
[[ja:Mouse acceleration]]
+
[[ja:マウスのアクセラレーション]]
There are several ways of setting mouse acceleration:
+
[[zh-CN:Mouse acceleration]]
 +
{{Related articles start}}
 +
{{Related|Mouse buttons}}
 +
{{Related|Mouse polling rate}}
 +
{{Related articles end}}
  
# By editing xorg configuration files
+
{{Accuracy|Configuration depends on the input driver, libinput can be used in [[Xorg]]. Each subsection should explicitly state which driver is assumed.}}
# The {{Pkg|xorg-server-utils}} package provides two programs that can be used to change those settings from a shell or a script:
+
 
#* '''xset'''
+
Setting the mouse acceleration depends on the windowing protocol you are using: either [[Xorg]] or [[Wayland]].
#* '''xinput'''
+
 
# Many [[desktop environment]]s provide a configuration GUI for mouse settings. They should be easy to find and use.
+
* On [[Xorg]], there are several ways of setting mouse acceleration
 +
:* by editing Xorg configuration files
 +
:* {{Pkg|xorg-server-utils}} which provides ''xset'' and ''xinput''
 +
:* and configuration interfaces common in [[desktop environments]].
 +
 
 +
* If you are using [[Wayland]], the events are controlled via [[libinput]]. It is the compositor's job to expose the settings brought by libinput. There is currently not standard way to change settings across compositors.[https://www.reddit.com/r/gnome/comments/3upay2/wayland_where_are_the_mouse_acceleration_options/]
  
 
== Setting mouse acceleration ==
 
== Setting mouse acceleration ==
  
 
=== In Xorg configuration ===
 
=== In Xorg configuration ===
 +
 +
{{Style|Don't use comments in code blocks, provide more description in the wiki text instead.}}
  
 
See {{ic|man xorg.conf}} for details.
 
See {{ic|man xorg.conf}} for details.
Line 40: Line 51:
 
}}
 
}}
  
You can also assign settings to specific hardware by using "MatchProduct", "MatchVendor" and other matches inside class sections.
+
You can also assign settings to specific hardware by using "MatchProduct", "MatchVendor" and other matches inside class sections. Run {{ic|lsusb}} to find out the product name and vendor to match:
 +
 +
$ lsusb -v | grep -e idProduct -e idVendor
 +
 
 +
If you are unable to identify your device, try running {{ic|xinput list}}. Some devices the use Logitech Unifying Recceiver share the same USB connection therefore, the mouse don't appear using {{ic|lsusb}}
  
 
=== Using xset ===
 
=== Using xset ===
  
 
To get the current values, use:
 
To get the current values, use:
 +
 
  $ xset q | grep -A 1 Pointer
 
  $ xset q | grep -A 1 Pointer
  
 
To set new values, type:
 
To set new values, type:
 +
 
  $ xset m ''acceleration'' ''threshold''
 
  $ xset m ''acceleration'' ''threshold''
  
where ''acceleration'' defines how many times faster the cursor will move than the default speed. ''threshold'' is the velocity required for acceleration to become effective, usually measured in device units per 10ms. ''acceleration'' can be a fraction, so if you want to slow down the mouse you can use 1/2, 1/3, 1/4, ... if you want to make it faster you can use 2/1, 3/1, 4/1, ...
+
where ''acceleration'' defines how many times faster the cursor will move than the default speed. ''threshold'' is the velocity required for acceleration to become effective, usually measured in device units per 10ms. ''acceleration'' can be a fraction, so if you want to slow down the mouse you can use 1/2, 1/3, 1/4, ... if you want to make it faster you can use 2/1, 3/1, 4/1, ...  
 +
 
 +
''Threshold'' defines the point at which acceleration should occur in pixels per 10 ms. If threshold is zero, e.g. if you use:
 +
 
 +
$ xset m 3/2 0
 +
 
 +
as suggested in the man page, then acceleration is treated as "the exponent of a more natural and continuous formula."
  
 
To get the default settings back:
 
To get the default settings back:
 +
 
  $ xset m default
 
  $ xset m default
  
 
For more info see {{ic|man xset}}.
 
For more info see {{ic|man xset}}.
  
To make it permanent, edit xorg configuration (see above) or add commands to [[xprofile]]. The latter won't affect speed in a [[display manager]].
+
Commands may be stored in [[Xinitrc]] or [[Xprofile]]. Alternatively, create a [[Desktop entry]] in {{ic|.config/autostart}}:
 +
 
 +
[Desktop Entry]
 +
Name=Disable mouse acceleration
 +
Exec=xset m 0 0
 +
Type=Application
 +
 
 +
This technique may be more desirable than employing the xorg configuration technique described above; latter may interfere with setting mouse speed in a display manager.
  
 
=== Using xinput ===
 
=== Using xinput ===
  
 
First, get a list of devices plugged in (ignore any virtual pointers):
 
First, get a list of devices plugged in (ignore any virtual pointers):
 +
 
  $ xinput list
 
  $ xinput list
  
Line 67: Line 99:
  
 
Get a list of available properties and their current values available for modification with
 
Get a list of available properties and their current values available for modification with
 +
 
  $ xinput list-props 9
 
  $ xinput list-props 9
  
 
where {{ic|9}} is the ID of the device you wish to use. Or
 
where {{ic|9}} is the ID of the device you wish to use. Or
 +
 
  $ xinput list-props ''mouse brand''
 
  $ xinput list-props ''mouse brand''
  
Line 75: Line 109:
  
 
Example, changing the property of {{ic|Constant Deceleration}} to 2:
 
Example, changing the property of {{ic|Constant Deceleration}} to 2:
 +
 
{{hc|$ xinput list-props 9|
 
{{hc|$ xinput list-props 9|
 
Device '''mouse brand''':
 
Device '''mouse brand''':
Line 85: Line 120:
 
  $ xinput --set-prop '''mouse brand''' 'Device Accel Constant Deceleration' 2
 
  $ xinput --set-prop '''mouse brand''' 'Device Accel Constant Deceleration' 2
  
To make it permanent, edit xorg configuration (see above) or add commands to [[xprofile]]. The latter won't affect speed in a [[Display Manager]].
+
To make it permanent, edit xorg configuration (see above) or add commands to [[xprofile]]. The latter won't affect speed in a [[Display manager]].
  
 
=== Configuration example ===
 
=== Configuration example ===
Line 91: Line 126:
 
You may need to resort to using more than one method to achieve your desired mouse settings. Here's what I did to configure a generic optical mouse:
 
You may need to resort to using more than one method to achieve your desired mouse settings. Here's what I did to configure a generic optical mouse:
 
First, slow down the default movement speed 3 times so that it's more precise.
 
First, slow down the default movement speed 3 times so that it's more precise.
 +
 
  $ xinput --set-prop 9 'Device Accel Constant Deceleration' 3 &
 
  $ xinput --set-prop 9 'Device Accel Constant Deceleration' 3 &
 +
 
Then, enable acceleration and make it 3 times faster after moving past 6 units.
 
Then, enable acceleration and make it 3 times faster after moving past 6 units.
 +
 
  $ xset mouse 3 6 &
 
  $ xset mouse 3 6 &
 +
 
If you are satisfied of the results, store the preceding commands in {{ic|~/.xinitrc}}.
 
If you are satisfied of the results, store the preceding commands in {{ic|~/.xinitrc}}.
  
Line 109: Line 148:
 
Option "AccelerationProfile" "-1"
 
Option "AccelerationProfile" "-1"
 
Option "AccelerationScheme" "none"
 
Option "AccelerationScheme" "none"
 +
Option "AccelSpeed" "-1"
 
EndSection
 
EndSection
 
}}
 
}}
 
and restart X.
 
and restart X.
 +
 +
Since {{Pkg|libinput}}-1.1.0-1 and {{Pkg|xf86-input-libinput}}-0.15.0-1 you can use a flat acceleration profile which will give a 1:1 mapping of physical to virtual mouse movements. To enable it put this in the following file:
 +
 +
{{hc|/etc/X11/xorg.conf.d/50-mouse-acceleration.conf|2=
 +
Section "InputClass"
 +
Identifier "My Mouse"
 +
Driver "libinput"
 +
MatchIsPointer "yes"
 +
Option "AccelProfile" "flat"
 +
EndSection
 +
}}
 +
and restart X.
 +
 +
{{Note|The speed setting {{ic|libinput Accel Speed}} is the same as before, taking values in the [-1, 1] range. The Speed setting is a fraction that is added (or subtracted) to 100%, e.g. -0.3 is 70% of the normal speed, and 0.5 is 150%. For example, to adjust the mouse speed down to 50%, use {{ic|xinput --set-prop 8 'libinput Accel Speed' -0.5}}.}}

Latest revision as of 12:04, 21 May 2016

Tango-inaccurate.pngThe factual accuracy of this article or section is disputed.Tango-inaccurate.png

Reason: Configuration depends on the input driver, libinput can be used in Xorg. Each subsection should explicitly state which driver is assumed. (Discuss in Talk:Mouse acceleration#)

Setting the mouse acceleration depends on the windowing protocol you are using: either Xorg or Wayland.

  • On Xorg, there are several ways of setting mouse acceleration
  • If you are using Wayland, the events are controlled via libinput. It is the compositor's job to expose the settings brought by libinput. There is currently not standard way to change settings across compositors.[1]

Setting mouse acceleration

In Xorg configuration

Tango-edit-clear.pngThis article or section needs language, wiki syntax or style improvements.Tango-edit-clear.png

Reason: Don't use comments in code blocks, provide more description in the wiki text instead. (Discuss in Talk:Mouse acceleration#)

See man xorg.conf for details.

Examples:

/etc/X11/xorg.conf.d/50-mouse-acceleration.conf
Section "InputClass"
	Identifier "My Mouse"
	MatchIsPointer "yes"
# set the following to 1 1 0 respectively to disable acceleration.
	Option "AccelerationNumerator" "2"
	Option "AccelerationDenominator" "1"
	Option "AccelerationThreshold" "4"
EndSection
/etc/X11/xorg.conf.d/50-mouse-deceleration.conf
Section "InputClass"
	Identifier "My Mouse"
	MatchIsPointer "yes"
# some curved deceleration
#	Option "AdaptiveDeceleration" "2"
# linear deceleration (mouse speed reduction)
	Option "ConstantDeceleration" "2"
EndSection

You can also assign settings to specific hardware by using "MatchProduct", "MatchVendor" and other matches inside class sections. Run lsusb to find out the product name and vendor to match:

$ lsusb -v | grep -e idProduct -e idVendor

If you are unable to identify your device, try running xinput list. Some devices the use Logitech Unifying Recceiver share the same USB connection therefore, the mouse don't appear using lsusb

Using xset

To get the current values, use:

$ xset q | grep -A 1 Pointer

To set new values, type:

$ xset m acceleration threshold

where acceleration defines how many times faster the cursor will move than the default speed. threshold is the velocity required for acceleration to become effective, usually measured in device units per 10ms. acceleration can be a fraction, so if you want to slow down the mouse you can use 1/2, 1/3, 1/4, ... if you want to make it faster you can use 2/1, 3/1, 4/1, ...

Threshold defines the point at which acceleration should occur in pixels per 10 ms. If threshold is zero, e.g. if you use:

$ xset m 3/2 0

as suggested in the man page, then acceleration is treated as "the exponent of a more natural and continuous formula."

To get the default settings back:

$ xset m default

For more info see man xset.

Commands may be stored in Xinitrc or Xprofile. Alternatively, create a Desktop entry in .config/autostart:

[Desktop Entry]
Name=Disable mouse acceleration
Exec=xset m 0 0
Type=Application

This technique may be more desirable than employing the xorg configuration technique described above; latter may interfere with setting mouse speed in a display manager.

Using xinput

First, get a list of devices plugged in (ignore any virtual pointers):

$ xinput list

Take note of the ID. You may also use the full name in commands if the ID is prone to changing.

Get a list of available properties and their current values available for modification with

$ xinput list-props 9

where 9 is the ID of the device you wish to use. Or

$ xinput list-props mouse brand

where mouse brand is the name of your mouse given by $ xinput list

Example, changing the property of Constant Deceleration to 2:

$ xinput list-props 9
Device 'mouse brand':
       Device Enabled (121):   1
       Device Accel Profile (240):     0
       Device Accel Constant Deceleration (241):       1.000000
       Device Accel Adaptive Deceleration (243):       1.000000
       Device Accel Velocity Scaling (244):    10.000000
$ xinput --set-prop 'mouse brand' 'Device Accel Constant Deceleration' 2

To make it permanent, edit xorg configuration (see above) or add commands to xprofile. The latter won't affect speed in a Display manager.

Configuration example

You may need to resort to using more than one method to achieve your desired mouse settings. Here's what I did to configure a generic optical mouse: First, slow down the default movement speed 3 times so that it's more precise.

$ xinput --set-prop 9 'Device Accel Constant Deceleration' 3 &

Then, enable acceleration and make it 3 times faster after moving past 6 units.

$ xset mouse 3 6 &

If you are satisfied of the results, store the preceding commands in ~/.xinitrc.

Disabling mouse acceleration

Mouse acceleration has changed dramatically in recent X server versions; using xset to disable acceleration doesn't work as it used to and is not recommended anymore.

Recent changes on PointerAcceleration can be read here.

To completely disable any sort of acceleration/deceleration, create the following file:

/etc/X11/xorg.conf.d/50-mouse-acceleration.conf
Section "InputClass"
	Identifier "My Mouse"
	MatchIsPointer "yes"
	Option "AccelerationProfile" "-1"
	Option "AccelerationScheme" "none"
	Option "AccelSpeed" "-1"
EndSection

and restart X.

Since libinput-1.1.0-1 and xf86-input-libinput-0.15.0-1 you can use a flat acceleration profile which will give a 1:1 mapping of physical to virtual mouse movements. To enable it put this in the following file:

/etc/X11/xorg.conf.d/50-mouse-acceleration.conf
Section "InputClass"
	Identifier "My Mouse"
	Driver "libinput"
	MatchIsPointer "yes"
	Option "AccelProfile" "flat"
EndSection

and restart X.

Note: The speed setting libinput Accel Speed is the same as before, taking values in the [-1, 1] range. The Speed setting is a fraction that is added (or subtracted) to 100%, e.g. -0.3 is 70% of the normal speed, and 0.5 is 150%. For example, to adjust the mouse speed down to 50%, use xinput --set-prop 8 'libinput Accel Speed' -0.5.