wl-kbptr: control your mouse using keyboard in wayland

i have been looking for this kind of program for so long. there was exist program called warpd, but it has been abandoned. a few days ago, i saw a twitter post about a program called mouseless, which does the same thing, but it is a paid program. that post spark me to find a foss alternative, which lead me to this program wl-kbptr (read 'wayland keyboard pointer').

this guide will show you how to use and configure wl-kbptr

usage

this program has many modes to move the cursor.

  1. split mode
  2. tile mode
  3. bisect mode
  4. click mode there is an example of each mode in the github page.

you can use many modes in sequence to move the cursor. the typical use, and the one in the example config, is to have tile mode, and then bisect mode. to specify the mode sequence, change the modes field in the config, separate each with comma

my config look like this:

[general]
home_row_keys=
modes=tile,split,click
cancellation_status_code=0

it is important to have the click mode as the last mode, else the cursor only moved (no auto left click).

keybind

to use wl-kbptr, you can add keybind in your window manager config that execute "wl-kbptr". for me, im using sway, so the config is:

bindsym $mod+s exec "wl-kbptr" # move cursor and click
bindsym $mod+m exec "wl-kbptr --modes=split" # move cursor only

configuring the background opacity

[mode_tile]
selectable_bg_color=#0007

set the last hex char of selectable_bg_color.
0 mean transparent, f means black.