1scrot(1) General Commands Manual scrot(1)
2
6 scrot - Screen capture using imlib2
7
9 scrot [options] [file]
10
12 scrot is a screen capture utility using the imlib2 library to aquire
13 and save images. scrot has a few options, detailed below. Specify
14 [file] as the filename to save the screenshot to. If [file] is not
15 specified, a date-stamped file will be dropped in the current direc‐
16 tory.
17
19 -h, --help
20 display help output and exit.
21 -v, --version
23 output version information and exit.
24 -b, --border
26 When selecting a window, grab wm border too
27 -c, --count
29 Display a countdown when used with delay.
30 -d, --delay NUM
32 Wait NUM seconds before taking a shot.
33 -e, --exec APP
35 Exec APP on the saved image.
36 -q, --quality NUM
38 Image quality (1-100) high value means high size, low compression.
39 Default: 75. (Effect differs depending on file format chosen).
40 -m, --multidisp
42 For multiple heads, grab shot from each and join them together.
43 -s, --select
45 Interactively select a window or rectangle with the mouse.
46 -t, --thumb NUM
48 generate thumbnail too. NUM is the percentage of the original size
49 for the thumbnail to be.
50
52 Both the --exec and filename parameters can take format specifiers that
53 are expanded by scrot when encountered. There are two types of format
54 specifier. Characters preceded by a '%' are interpretted by strf‐
55 time(2). See man strftime for examples. These options may be used to
56 refer to the current date and time. The second kind are internal to
57 scrot and are prefixed by '$' The following specifiers are recognised:
58 $f image path/filename (ignored when used in the filename)
59 $n image name (ignored when used in the filename)
60 $s image size (bytes) (ignored when used in the filename)
61 $p image pixel size
62 $w image width
63 $h image height
64 $t image format
65 $$ prints a literal '$'
66 \n prints a newline (ignored when used in the filename)
67
69 scrot '%Y-%m-%d_$wx$h.png' -e 'mv $f ~/shots/'
70 This would create a file called something like 2000-10-30_2560x1024.png
71 and move it to your shots directory.
72
74 None known.
75
77 Copyright Tom Gilbert 2000
78 Permission is hereby granted, free of charge, to any person obtaining a
80 copy of this software and associated documentation files (the "Soft‐
81 ware"), to deal in the Software without restriction, including without
82 limitation the rights to use, copy, modify, merge, publish, distribute,
83 sublicense, and/or sell copies of the Software, and to permit persons
84 to whom the Software is furnished to do so, subject to the following
85 conditions:
86 The above copyright notice and this permission notice shall be included
88 in all copies of the Software, its documentation and marketing & pub‐
89 licity materials, and acknowledgment shall be given in the documenta‐
90 tion, materials and software packages that this Software was used.
91 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
93 OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MER‐
94 CHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN
95 NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
96 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
97 FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
98 DEALINGS IN THE SOFTWARE.
99 Email bugs and feature requests to
101 <scrot_sucks@linuxbrit.co.uk>
102 Oct 26, 2000 scrot(1)