Touchpad, Mouse, and Keyboard

Make Pointing Easy

Change the acceleration and sensitivity of your touchpad, mouse, and scroll wheel. Map extra keys using xorg config or Solaar.

Command your computer with your choice of mouse and keyboard.

Command your computer with your choice of mouse and keyboard.

Please read the disclaimer before proceeding. We review and update guided solutions regularly. If you have suggestions or requests, please write support@kfocus.org.

Input Devices with System Settings

system-settingsSystem Settings is the preferred and most convenient way to adjust your mouse and touchpad. Click on System Settings > Input Devices to access controls for either.

Find input device settings in System Settings.

Find input device settings in System Settings.

Keyboard Mapping

When you first turn on a Kubuntu Focus system, it requests you select a keyboard layout which assigns meanings to keys. This assignment is often called “Keyboard Mapping.” Later, you can change or enhance this. First, we summarize where one can make these changes, and then we look at the two methods we recommend for this purpose.

Where to Change Mapping

One can adjust keyboard mapping on many levels. Starting nearest the hardware and working our way towards apps, you can change the meanings of keys in the keyboard firmware, BIOS, OS, interface (xmodmap for X11, and loadkeys for TTY), desktop environment, and per-app. Frequently, not all levels are available. For example, the keyboard firmware may not be programmable. Also, not all capabilities are available at all levels. For example, a 3D rendering app may not provide facilities to remap the control keys. We recommend either using KDE Plasma Keyboard or using OS-Wide settings.

KDE Plasma Keyboard
Configure keyboard options for KDE with System Settings.

System SettingsIf you do all your work in the KDE Plasma desktop environment, this should be all you need. It’s simple and fast. However, it does not propagate to virtual terminals or other desktop environments. Click on System Settings > Input Devices > Keyboard to change your layout and mappings. In the image above, we show how to remap Caps Lock to an extra Control key. There are many other combinations. Even if you eventually use OS-Wide settings, this is a great way to quickly find the adjustments you prefer.

OS-Wide Configuration
Configure system-wide keyboard settings with dpkg-reconfigure.

This is a bit more involved, but results in key mappings that work across all interfaces, such as virtual terminals, other desktop environments, and, of course, in KDE Plasma. The first step is to adjust /etc/default/keyboard to use keyboard options we prefer. Here, we can set XKBOPTIONS="ctrl:swapcaps" then run sudo dpkg-reconfigure keyboard-configuration. When stepping through the configuration screens as illustrated above, accept the defaults and then reboot. This will propagate your changes throughout the system. If we wanted to use both keys as control, we could use ctrl:nocaps in XKBOPTIONS.

More Information

See all available options using localectl list-x11-keymap-options, or man localectl. This Ask Ubuntu response may also be useful.

Keyboard Shortcuts

The hint widget shows the default keyboard shortcuts. If you customize your desktop, you may overwrite these. To revert to these defaults, you can run Start Menu > Kubuntu Focus Tools > KFocus Reset Defaults. From here, one can reset the keyboard shortcuts and effects to the default. If you changed the power management settings, the app will offer to reset that too.

Pressing the [ SUPER ] key (also called “meta” key) usually opens the start menu (also called the “application launcher” menu). However, some users have found this capability can get lost after they have customized other shortcuts. We have found that setting a shortcut for this menu fixes the problem:

Some users have reported that this fix works, even after removing the [ Meta + F1 ] shortcut.

Libinput Touchpad Settings

system-settingsAll M2 GEN 4+, Ir14, and Ir16 laptops use the Libinput driver. Click System Settings > Input Devices > Touchpad to make adjustments to the defaults shown in the following image.

Configure touchpad settings with the Libinput driver.

The Hardware Configuration subsystem, from the kfocus-hw package, identifies and configures the touchpad to provide the features most users expect. If you wish to toggle the touchpad on and off, press [ SUPER ][ SPACE ]. If you need to restore the original settings, press the Defaults button at the bottom left.

Advanced Configuration

Sometimes the interface may have some options greyed-out. One possible fix is to close System Settings, remove the local touchpad file (rm ~/.config/touchpadxlibinputrc), then return to System Settings.

One may add capabilities not found in the GUI by adjusting xinput properties, as shown below. These changes apply immediately, which makes testing easier. Record the changes you want to keep!

# Show devices xinput list; # List props for device 17 # (replace 17 with touchpad found) xinput list-props 17; # Set property on device 17 xinput set-prop 17 'libinput Accel Speed' 0.25;

One can then save the properties to a file that will apply the next time you login, as shown below.

# Copy libinput settings cd /usr/share/X11/xorg.conf.d; cp 80-kfocus.conf 99-local.conf; # Edit 99-local.conf to override defaults.

Do NOT remove the kfocus-hw package, as that can break the installation. Also, do not delete 80-kfocus.conf, because software updates overwrite this file. The Achi Wiki page provides additional insight.

Synaptics Touchpad Settings

system-settingsThe Focus laptops M1, XE, and M2 GEN 1-3 use the Synaptics touchpad driver. Click System Settings > Input Devices > Touchpad to make adjustments to the defaults shown in the following images.

The Hardware Configuration subsystem, from the kfocus-hw package, identifies and configures the touchpad to provide the features most users expect. If you wish to toggle the touchpad on and off, press [ SUPER ][ SPACE ]. If you need to restore the original settings, press the Defaults button at the bottom left.

If you wish, you may try the Libinput touchpad settings instead: purge the Synaptics driver then log out and back in. To restore Synaptics, install the driver again. We do not usually recommend using the Synaptics driver for models other than those listed.

# Purge Synaptics driver sudo apt purge xserver-xorg-input-synaptics; # Install Synaptics driver sudo apt install xserver-xorg-input-synaptics;
Configure advanced touchpad settings with the Synaptics driver.Configure advanced touchpad settings with the Synaptics driver.Configure advanced touchpad settings with the Synaptics driver.Configure advanced touchpad settings with the Synaptics driver.Configure advanced touchpad settings with the Synaptics driver.

Mouse Settings

system-settingsUse System Settings > Input Devices > Mouse. If you need to restore the defaults, press the Defaults button at the bottom left. This will present you with Libinput's mouse controls, as shown below.

Configure mouse settings with the Libinput driver.

konsoleTo get advanced settings, open a terminal and enter:

echo 'Section "InputClass" Identifier "evdev-mouse" MatchIsPointer "yes" Driver "evdev" EndSection' \ |sudo tee /usr/share/X11/xorg.conf.d/91-evdevmouse.conf

Now sign out and back in to see the advanced mouse controls as shown below.

Configure advanced mouse settings with the evdev driver.Configure advanced mouse settings with the evdev driver.Configure advanced mouse settings with the evdev driver.

Solaar for Logitech Hardware


Use Solaar to manage advanced Logitech hardware like the MX Master 3 Mouse and the MX Keys. Solaar makes managing universal and bolt USB receivers easy. Use the Discover software manager to install or the command-line with sudo apt install solaar.

Use Solaar to bind, unbind, and reconfigure most Logitech devices and receivers.

Xorg Configuration

Logitech Trackman Marble mouse support is configured with the file /usr/share/X11/xorg.conf.d/50-marblemouse.conf. Other devices may be configured in a similar fashion. See the excellent Arch Linux guide. You may wish to search for a file for your specific mouse device that you can drop into the xorg.conf.d directory.

Troubleshooting

Q: My Logitech MX Master 3 wireless mouse is jerky or stuttering. Sometimes the cursor takes half a second to catch up with my input. How can I fix this?

A: There are two likely fixes. First, try moving the universal or bolt receiver to a different port. We have verified this often solves the issue completely. We have noticed this issue when using a front USB 3 port on NX systems; moving the receiver to the back USB 2 port fixes it. The second likelihood is channel interference. Install and run Solaar to remove your mouse connection, then change the connection channel (1 of 3, found on the underside of the mouse). Then connect again.

Q: Whenever I shut down my computer, it wakes up again. This only happens with an external USB keyboard however. When it is not attached, this does not happen. What is going on and how can I fix this?

A: Some USB peripherals can trigger a Wake Event at inappropriate times. This can be disabled in the BIOS. To fix on an NX GEN 2, use the following:

The steps for an NX GEN 1 should be similar.

Q: I can no longer use the [ SUPER ] button to launch the start menu. How can I fix this?

A: Setting a different keyboard shortcut can often fix this issue. See the Keyboard Shortcuts section for instructions.

Revisions

This is a partial revision history. See the git repository for all entries.

Disclaimer

We try hard to provide a useful solution validated by professionals. However, we cannot anticipate every situation, and therefore cannot guarantee this procedure will work for your needs. Always backup your data and test the solution to determine the correct procedure for you.

THIS SOLUTION IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOLUTION, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

HAVE QUESTIONS?Call 844-536-2871 or write
TellMeMore@kfocus.org   |  GET FOCUS MERCH