NAME

       slop - select operation

SYNOPSIS

       slop [-klqn] [OPTIONS]

DESCRIPTION

       slop  is  an  application  that queries for a selection from the user and prints the region to stdout. It
       grabs the mouse and turns it into a crosshair, lets the user click and drag to make a selection (or click
       on  a  window)  while  drawing  a pretty box around it, then finally prints the selection's dimensions to
       stdout.

OPTIONS

       -h, --help
              Print help and exit.

       -v, --version
              Print version and exit.

       -x, --xdisplay=hostname:number.screen_number
              Sets the xdisplay to use.

       -b, --bordersize=FLOAT
              Sets the selection rectangle's thickness.

       -p, --padding=FLOAT
              Sets the padding size for the selection, this can be negative.

       -t, --tolerance=FLOAT
              How far in pixels the mouse can move after clicking, and still  be  detected  as  a  normal  click
              instead  of  a  click-and-drag.  Setting  this  to 0 will disable window selections. Alternatively
              setting it to 9999999 would force a window selection.

       -c, --color=FLOAT,FLOAT,FLOAT,FLOAT
              Sets the selection rectangle's color. Supports RGB or RGBA input. Depending on the system's window
              manager/OpenGL support, the opacity may be ignored.

       -r, --shader=STRING
              This  sets  the vertex shader, and fragment shader combo to use when drawing the final framebuffer
              to the screen. This obviously only works when OpenGL is  enabled.  The  shaders  are  loaded  from
              ~/.config/slop.  See  https://github.com/naelstrof/slop for more information on how to create your
              own shaders.

       -f, --format=STRING
              Sets the output format for slop. Format specifiers are %x (x offset), %y (y offset),  %w  (width),
              %h  (height), %i (window id), %c (1 if cancelled, 0 otherwise), %g (geometry - `%wx%h+%x+%y'), and
              %% for a literal percent sign.

       -n, --nodecorations=INT
              Sets the level of aggressiveness when trying to remove window decorations. `0' is  off,  `1'  will
              try  lightly  to  remove decorations, and `2' will recursively descend into the root tree until it
              gets the deepest available visible child under the mouse. Defaults to  `0'.  Supplying  slop  with
              just `-n` is equivalent to supplying `-n1`.

       -l, --highlight
              Instead  of  outlining a selection, slop will highlight it instead. This is particularly useful if
              the color is set to an opacity lower than 1.

       -q, --quiet
              Disable any unnecessary cerr output. Any warnings simply won't print.

       -k, --nokeyboard
              Disables the ability to cancel selections with the keyboard.

       -o, --noopengl
              Disables graphics acceleration. Might be useful if you get rendering bugs.

EXAMPLES

       To emulate a windows XP selection, you can use something like this:

              slop --highlight --tolerance=0 --color=0.3,0.4,0.6,0.4

       In order to avoid using eval(1) in your scripts (pretty big security issue), you can use slop  like  this
       instead:

              read -r X Y W H G ID < <(slop -f "%x %y %w %h %g %i")

SEE ALSO

       maim(1)

BUGS

       No known bugs.

AUTHOR

       Dalton Nell (naelstrof@gmail.com)