Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
SIMPLESTROKE(1) 	     General Commands Manual		 SIMPLESTROKE(1)

NAME
     simplestroke -- detect mouse gestures

SYNOPSIS
     simplestroke

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  possi-
     ble  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 di-
     rection you would draw them in.

   ARROW GESTURES
     ArrowUp	     ^
     ArrowDown	     v
     ArrowLeft	     <
     ArrowRight      >

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

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

   Z GESTURES
     LeftZ
     RightZ

   SQUARE GESTURES
     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,  re-
     lease 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>.

FreeBSD ports 15.quarterly	 April 18, 2020 		 SIMPLESTROKE(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=simplestroke&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help