1SLOP(1) slop man page SLOP(1)
2
6 slop - select operation
7
9 slop [-klqn] [OPTIONS]
10
12 slop is an application that queries for a selection from the user and
13 prints the region to stdout. It grabs the mouse and turns it into a
14 crosshair, lets the user click and drag to make a selection (or click
15 on a window) while drawing a pretty box around it, then finally prints
16 the selection's dimensions to stdout.
17
19 -h, --help
20 Print help and exit.
21 -v, --version
23 Print version and exit.
24 -x, --xdisplay=hostname:number.screen_number
26 Sets the xdisplay to use.
27 -b, --bordersize=FLOAT
29 Sets the selection rectangle's thickness.
30 -p, --padding=FLOAT
32 Sets the padding size for the selection, this can be negative.
33 -t, --tolerance=FLOAT
35 How far in pixels the mouse can move after clicking, and still
36 be detected as a normal click instead of a click-and-drag. Set‐
37 ting this to 0 will disable window selections. Alternatively
38 setting it to 9999999 would force a window selection.
39 -c, --color=FLOAT,FLOAT,FLOAT,FLOAT
41 Sets the selection rectangle's color. Supports RGB or RGBA in‐
42 put. Depending on the system's window manager/OpenGL support,
43 the opacity may be ignored.
44 -r, --shader=STRING
46 This sets the vertex shader, and fragment shader combo to use
47 when drawing the final framebuffer to the screen. This obviously
48 only works when OpenGL is enabled. The shaders are loaded from
49 ~/.config/slop. See https://github.com/naelstrof/slop for more
50 information on how to create your own shaders.
51 -f, --format=STRING
53 Sets the output format for slop. Format specifiers are %x (x
54 offset), %y (y offset), %w (width), %h (height), %i (window id),
55 %c (1 if cancelled, 0 otherwise), %g (geometry - `%wx%h+%x+%y'),
56 and %% for a literal percent sign.
57 -n, --nodecorations=INT
59 Sets the level of aggressiveness when trying to remove window
60 decorations. `0' is off, `1' will try lightly to remove decora‐
61 tions, and `2' will recursively descend into the root tree until
62 it gets the deepest available visible child under the mouse. De‐
63 faults to `0'. Supplying slop with just `-n` is equivalent to
64 supplying `-n1`.
65 -l, --highlight
67 Instead of outlining a selection, slop will highlight it in‐
68 stead. This is particularly useful if the color is set to an
69 opacity lower than 1.
70 -D, --nodrag
72 Allows you to click twice to indicate a selection, rather than
73 click-dragging.
74 -q, --quiet
76 Disable any unnecessary cerr output. Any warnings simply won't
77 print.
78 -k, --nokeyboard
80 Disables the ability to cancel selections with the keyboard.
81 -o, --noopengl
83 Disables graphics acceleration. Might be useful if you get ren‐
84 dering bugs.
85
87 To emulate a windows XP selection, you can use something like this:
88 slop --highlight --tolerance=0 --color=0.3,0.4,0.6,0.4
90 In order to avoid using eval(1) in your scripts (pretty big security
92 issue), you can use slop like this instead:
93 read -r X Y W H G ID < <(slop -f "%x %y %w %h %g %i")
95
97 maim(1)
98
100 No known bugs.
101
103 Dalton Nell (naelstrof@gmail.com)
104Linux 2017-03-21 SLOP(1)