{"id":52987,"date":"2020-01-01T21:51:41","date_gmt":"2020-01-02T05:51:41","guid":{"rendered":"https:\/\/linuxhint.com\/?p=52987"},"modified":"2021-07-11T18:00:03","modified_gmt":"2021-07-12T01:00:03","slug":"change_mouse_touchpad_settings_xinput_linux","status":"publish","type":"post","link":"https:\/\/linuxhint.com\/change_mouse_touchpad_settings_xinput_linux\/","title":{"rendered":"How to Change Mouse and Touchpad Settings Using Xinput in Linux"},"content":{"rendered":"
\nMost Linux distributions ship with \u201clibinput\u201d library by default to handle input events on a system. It can process input events on both Wayland and X and can handle a variety of input devices including touchscreen displays and stylus pens.<\/p>\n

This article explains changing various options for an input device being handled by the libinput library. To check and configure available options, a command line tool called \u201cxinput\u201d will be used.<\/p>\n

Note that this guide works with X display server only. For Wayland, you have to rely on system settings provided by the distribution or use a centralized configuration utility like gsettings.<\/p>\n

List Input Devices<\/h3>\n

Xinput comes pre-installed by default on Ubuntu. If for some reason it is not installed on your system, run the command below to install it:<\/p>\n

$ <\/span>sudo<\/span> apt install<\/span> xinput<\/div><\/div>\n

To list all built-in and external input devices connected to your system, run the command below:<\/p>\n

$ <\/span>xinput --list<\/span><\/div><\/div>\n

You will see some output in terminal like this:<\/p>\n

\"\"<\/a><\/p>\n

The entry under \u201cVirtual core pointer\u201d (highlighted by red arrows) is a wired USB mouse connected to my system. You will have to use exact name or id shown in the screenshot above to configure mouse or touchpad settings through the xinput command line tool.<\/p>\n

Note that in the screenshot above, xinput is showing properties of devices connected to my system. Device names and IDs will be different for your system depending on your hardware configuration and external devices connected via USB, Bluetooth, or wireless receivers.<\/p>\n

View Properties of a Connected Device<\/h3>\n

To see current status and various options active for the device listed above, run a command in the following format:<\/p>\n

$ <\/span>xinput --list-props<\/span> \u201cid<\/span>\u201d<\/div><\/div>\n

For the Dell mouse listed above, the command would be:<\/p>\n

$ <\/span>xinput --list-props<\/span> 8<\/span><\/div><\/div>\n

There is a limitation with using this command. IDs shown in the terminal output tend to change when you connect a listed device to a different port. As the IDs keep changing, there is always a chance of accidentally changing settings for a different device. To overcome this issue, it is better to use full device name as identifier instead of its id. So for the Dell mouse listed above, the better command would be:<\/p>\n

$ <\/span>xinput --list-props<\/span> "PixArt Dell MS116 USB Optical Mouse"<\/span><\/div><\/div>\n

The area highlighted below in red rectangle shows current configuration for the device. You can only change options that are shown in the output. Depending on the capabilities of your device, some extra options may be listed while others can be omitted altogether.<\/p>\n

\"\"<\/a><\/p>\n

Change Properties of a Connected Device<\/h3>\n

Now that you know how to check the properties of a connected input device, settings for it can be easily changed using some simple commands.<\/p>\n

For instance, to enable or disable natural scrolling, you have to run commands in the following format:<\/p>\n

$ xinput set-prop "PixArt Dell MS116 USB Optical Mouse"<\/span> 285<\/span> 0<\/span>
\n$ xinput set-prop "PixArt Dell MS116 USB Optical Mouse"<\/span> 285<\/span> 1<\/span><\/div><\/div>\n

\u201c285\u201d is the id for natural scrolling, as shown in the screenshot above. \u201c0\u201d disables natural scrolling while \u201c1\u201d enables it. Once again, using IDs is not a reliable way to change these settings. A better approach is to use the full property identifier.<\/p>\n

$ xinput set-prop "PixArt Dell MS116 USB Optical Mouse"<\/span>
\n"libinput Natural Scrolling Enabled"<\/span> 0<\/span>
\n$ xinput set-prop "PixArt Dell MS116 USB Optical Mouse"<\/span>
\n"libinput Natural Scrolling Enabled"<\/span> 1<\/span><\/div><\/div>\n

Note that you are not supposed to touch property identifiers having the word \u201cDefault\u201d in it. These are reference fallback values and any attempt to change them will result in xinput throwing an error.<\/p>\n

To know more about other options and those listed in the terminal output above, visit the following page<\/a><\/u>.<\/p>\n

Making the Changes Persistent<\/h3>\n

The method explained above changes settings for active session only. When you reboot the system, these changes will be gone. To make them persistent, two approaches can be used.<\/p>\n

The first method requires you to add these commands to startup applications. You can add as many entries as you want using a nice graphical interface. No root permissions are required to create these entries, plus changing them later is super easy.<\/p>\n

To add the command to startup applications, launch \u201cStartup Applications\u201d app from the application launcher. Click on \u201cAdd\u201d button to add an entry. Set a description and enter appropriate xinput command as per your needs. Make sure that checkbox is checked once you have saved the entry.<\/p>\n

That\u2019s it, the xinput command you have entered will run automatically on system startup. I have added a little bit of delay to the command to wait for the session to load properly. For reference, here is the command used below in the screenshot below:<\/p>\n

$ sleep<\/span> 3<\/span> &&<\/span> xinput set-prop "PixArt Dell MS116 USB Optical Mouse"<\/span>
\n"libinput Natural Scrolling Enabled"<\/span> 1<\/span><\/div><\/div>\n

\"\"<\/a><\/p>\n

The second method requires you to run some commands as root and edit a text file. The advantage of using this method is that you don\u2019t have to create separate entries for each option in a GUI and everything just resides in one text file, making it easier to share it between devices.<\/p>\n

Run the commands below to create required directory and the conf file:<\/p>\n

$ sudo<\/span> mkdir<\/span> -p<\/span> \/<\/span>etc\/<\/span>X11\/<\/span>xorg.conf.d
\n$ sudo<\/span> touch<\/span> \/<\/span>etc\/<\/span>X11\/<\/span>xorg.conf.d\/<\/span>99<\/span>-libinput.conf<\/div><\/div>\n

Notice the \u201c99\u201d part in the filename. It indicates the load order of the files that exist in \u201cxorg.conf.d\u201d folder. A file that has the highest number as prefix will be loaded last, overriding any options specified in previous files in case there are duplicates. By specifying \u201c99\u201d or any other number as a prefix, you can ensure that it is loaded after other files.<\/p>\n

Open \u201c99-libinput.conf\u201d file with root access in your favorite text editor. Enter the code snippet below after making necessary changes as per your requirements.<\/p>\n

Section "InputClass"
\nIdentifier "Dell Mouse"
\nMatchProduct "PixArt Dell MS116 USB Optical Mouse"
\nOption "NaturalScrolling" "true"
\nEndSection<\/div><\/div>\n

Where:<\/p>\n