Touchpad, Mouse, and Keyboard

Make Pointing Easy

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

• Input Devices with System Settings
• Keyboard Mapping
• Keyboard Shortcuts
• Libinput Touchpad Settings
• Synaptics Touchpad Settings
• Mouse Settings
• Solaar for Logitech Hardware
• Xorg Configuration
• Troubleshooting
• Revisions
• Disclaimer

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 Settings is the preferred and most convenient way to adjust your mouse and touchpad. To access controls for either, click on System Settings > Input Devices.

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

If 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. To change your layout and mappings, click on System Settings > Input Devices > Keyboard. 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

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:

• Right click on the start menu icon.
• In the context menu that appears, select “Configure Application Launcher...”
• A configuration window called “Application Launcher Settings” should appear.
• On the left side of this window, click on “Keyboard Shortcuts”.
• The right side of the window will now show “Keyboard Shortcuts”
• Click on the keyboard shortcut button, and set the value to [ Meta+F1 ]
• If you receive a warning that it will overwrite the existing shortcut, agree to the overwrite.
• Then click [ Apply ]at the bottom right of the window.

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

Libinput Touchpad Settings

All 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.

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!

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

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

The 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. The Synaptics driver is not usually recommended except for the listed models.

Mouse Settings

Use 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.

To get advanced settings, open a terminal and enter:

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

Solaar for Logitech Hardware

Solaar manages advanced Logitech hardware, including the MX Master 3 Mouse and 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.

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. This does not happen when it's not attatched. 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:

• On boot, press F2 to enter the BIOS.
• Enter the power settings tab.
• Select secondary or advanced options.
• Check the box that enables USB power in S4/S5.
• This enables a checkbox with a name like USB Wake from S5.
• Disable this checkbox and save the settings.

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.

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.