Skip to content

Mouse Emulation

You can use your keyboard to control your mouse pointer. ZMK lets you assign keys to move the pointer, click the buttons, and scroll.

For more technical details, you can read the official ZMK documentation.

Getting started

Before you can use mouse emulation, you need to turn it on. You can do this in the Advanced Configuration section of your layout by enabling the HID_POINTING option.

Advanced Configuration HID_POINTING

Advanced Configuration HID_POINTING

Note

After you enable this option and flash your keyboard for the first time, you will need to either reboot your computer (if you are using a USB cable) or re-pair your keyboard with your devices (if you are using Bluetooth). This is because your computer needs to recognize that your keyboard can now act as a mouse.

Assigning mouse actions to keys

To make a key control the mouse, click the behavior type selector in the top left corner of the key and choose one of the following:

Fine-tuning mouse emulation behavior

You can customize how the mouse emulation works in the Input Listeners section of your layout. Through configuring Input Processors you can fine-tune the mouse emulation behavior such as:

  • set pointer speed and orientation to your liking
  • create layer-specific behaviors