1scrot(1)                    General Commands Manual                   scrot(1)
2
3
4

NAME

6       scrot - Screen capture using imlib2
7

SYNOPSIS

9       scrot [options] [file]
10

DESCRIPTION

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

OPTIONS

19       -h, --help
20            display help output and exit.
21
22       -v, --version
23            output version information and exit.
24
25       -b, --border
26            When selecting a window, grab wm border too
27
28       -c, --count
29            Display a countdown when used with delay.
30
31       -d, --delay NUM
32            Wait NUM seconds before taking a shot.
33
34       -e, --exec APP
35            Exec APP on the saved image.
36
37       -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
41       -m, --multidisp
42            For multiple heads, grab shot from each and join them together.
43
44       -s, --select
45            Interactively select a window or rectangle with the mouse.
46
47       -t, --thumb NUM
48            generate thumbnail too. NUM is the percentage of the original size
49            for the thumbnail to be.
50

SPECIAL STRINGS

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

EXAMPLE

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

BUGS

74       None known.
75

LICENSE

77       Copyright Tom Gilbert 2000
78
79       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
87       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
92       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
100       Email bugs and feature requests to
101       <scrot_sucks@linuxbrit.co.uk>
102
103
104
105                                 Oct 26, 2000                         scrot(1)
Impressum