Fusuma::Plugin::Thumbsense

Remapper from key to click only while tapping the touchpad.
Implemented as Fusuma Plugin.

THIS PLUGIN IS EXPERIMENTAL.

ThumbSense is a tool that lets you control a laptop's touchpad using the keyboard. It assigns certain keyboard keys as mouse buttons and switches between acting as mouse buttons or normal keyboard keys based on whether the user's thumb is touching the touchpad. ThumbSense aims to make it easier to use the touchpad without moving your hand away from the keyboard.

• fusuma 2.0 or later
• fusuma-plugin-keypress 0.5 or later
  • fusuma-plugin-keypress is used to get keyboard input and is installed automatically.
• fusuma-plugin-remap
  • You need to set up udev rules for creating a virtual input device.
  • fusuma-plugin-remap is installed automatically.
  • Please refer to fusuma-plugin-remap's README for details.

Run the following code in your terminal.

$ sudo apt install ruby-dev build-essential

$ sudo apt install libevdev-dev

$ echo 'KERNEL=="uinput", MODE="0660", GROUP="input", OPTIONS+="static_node=uinput"' | sudo tee /etc/udev/rules.d/60-udev-fusuma-remap.rules
$ sudo udevadm control --reload-rules && sudo udevadm trigger

$ sudo gem install fusuma-plugin-thumbsense

First, add the thumbsense context to ~/.config/fusuma/config.yml. The context is separated by --- and specified by context: thumbsense. Fusuma will switch to the thumbsense context while tapping the touchpad.

You can remap keys to mouse buttons while tapping the touchpad. The remap property is specified in the thumbsense context.

Available mouse buttons are:

• BTN_LEFT
• BTN_MIDDLE
• BTN_RIGHT
• BTN_SIDE
• BTN_EXTRA
• BTN_FORWARD
• BTN_BACK
• BTN_TASK
• BTN_0
• BTN_1
• ...
• BTN_9

Set the following code in ~/.config/fusuma/config.yml.

# add thumbsense context

---
context: thumbsense

remap:
  F: BTN_LEFT
  E: BTN_MIDDLE
  D: BTN_RIGHT
  SPACE: BTN_LEFT
  J: BTN_LEFT
  K: BTN_RIGHT

• thumbsense

  • change layer of remap while tapping
  • make it possible to execute executor like command: sendkey:

• remap

  • remap to single key like remap: { J: BTN_LEFT }
  • send BTN_LEFT/BTN_MIDDLE/BTN_RIGHT click remap: { I: BTN_MIDDLE }
  • remap multiple keys like remap: { H: LEFTCTRL+TAB }
  • remap POINTER_MOTION to POINTER_SCROLL_FINGER remap: { S: POINTER_SCROLL_FINGER }

Bug reports and pull requests are welcome on GitHub at https://github.com/iberianpig/fusuma-plugin-thumbsense. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

The gem is available as open source under the terms of the MIT License.

Everyone interacting in the Fusuma::Plugin::Thumbsense project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.