NAME

SYNOPSIS

DESCRIPTION

With no arguments simplestroke starts in gesture detection mode. Draw your gesture and then confirm by clicking any mouse button.

simplestroke reacts on the release of mouse buttons. This makes it possible to start simplestroke from your window manager while pressing down a mouse button and start gesture analysis after releasing it.

simplestroke prints the name of the detected gesture, if any. The output can then be used in a simple shell script to execute commands.

GESTURES

ArrowUp		^
ArrowDown	v
ArrowLeft	<
ArrowRight	>

TopDown 	| (start at top)
DownTop		|
LeftRight	- (left to right)
RightLeft	- (right to left)

TopLeftDown	\ (start at top)
TopRightDown	/ (start at top)
DownLeftTop	\
DownRightTop	/

LeftZ
RightZ

SquareLeft	("clockwise" square)
SquareRight	("counterclockwise" square)

EXAMPLES

#!/bin/sh
case $(simplestroke) in
    ArrowUp)
    ;;
    ArrowDown)
    ;;
    ArrowLeft)
    ;;
    ArrowRight)
    ;;
    TopDown)
    ;;
    DownTop)
    ;;
    LeftRight)
    ;;
    RightLeft)
    ;;
    TopLeftDown)
    ;;
    TopRightDown)
    ;;
    DownLeftTop)
    ;;
    DownRightTop)
    ;;
    LeftZ)
    ;;
    RightZ)
    ;;
    SquareLeft)
    ;;
    SquareRight)
    ;;
    *)
        exit 1
esac

To start detection under i3 while holding down the 9th mouse button add this to your ~/.config/i3/config:

bindsym --whole-window button9 exec simplestroke.sh

The right mouse button can be determined via xev(1).

For Sway add this to your ~/.config/sway/config:

bindsym --whole-window BTN_EXTRA exec simplestroke.sh

The right BTN_* values can be determined via libinput-debug-events(1).

Hold the mouse button and after you are finished drawing your gesture, release it.

AUTHORS

simplestroke is inspired and based on easystroke 0.6.0 written by Thomas Jaeger ⟨https://github.com/thjaeger/easystroke⟩.