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

FreeBSD Manual Pages

  
 
  

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
       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 out-
       put 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.

   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,
       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>.

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.0.quarterly>

home | help