NAME

simplestroke — detect mouse gestures

SYNOPSIS

DESCRIPTION

simplestroke detects mouse gestures. There are twelve pre-defined mouse gestures you can choose from.

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

The following gestures are supported. The names are derived from the direction you would draw them in.

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

The following examples assume that simplestroke.sh is the shell script you call simplestroke from:

#!/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

Tobias Kortkamp <tobik@FreeBSD.org>

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