NAME

       scrot - capture a screenshot using imlib2

SYNOPSIS

       scrot [options] [file]

DESCRIPTION

       scrot  is  a  screen  capture  utility using the imlib2 library to aquire and save images.
       scrot has a few options, detailed below. Specify  [file]  as  the  filename  to  save  the
       screenshot  to.   If  [file]  is not specified, a date-stamped file will be dropped in the
       current directory.

OPTIONS

       -h, --help
            display help output and exit.

       -v, --version
            output version information and exit.

       -b, --border
            When selecting a window, grab wm border too

       -c, --count
            Display a countdown when used with delay.

       -d, --delay NUM
            Wait NUM seconds before taking a shot.

       -e, --exec APP
            Exec APP on the saved image.

       -q, --quality NUM
            Image quality (1-100) high value means  high  size,  low  compression.  Default:  75.
            (Effect differs depending on file format chosen).

       -m, --multidisp
            For multiple heads, grab shot from each and join them together.

       -s, --select
            Interactively select a window or rectangle with the mouse.

       -u, --focused
            Use the currently focused window.

       -t, --thumb NUM
            generate  thumbnail too. NUM is the percentage of the original size for the thumbnail
            to be.

       -z, --silent
            prevent beeping.

SPECIAL STRINGS

       Both the --exec and filename parameters can take format specifiers that  are  expanded  by
       scrot when encountered.  There are two types of format specifier. Characters preceded by a
       '%' are interpretted by strftime(2). See man strftime for examples.  These options may  be
       used to refer to the current date and time.  The second kind are internal to scrot and are
       prefixed by '$' The following specifiers are recognised:

       $f image path/filename (ignored when used in the filename)
       $n image name (ignored when used in the filename)
       $s image size (bytes) (ignored when used in the filename)
       $p image pixel size
       $w image width
       $h image height
       $t image format
       $$ prints a literal '$'
       \n prints a newline (ignored when used in the filename)

EXAMPLE

       scrot '%Y-%m-%d_$wx$h.png' -e 'mv $f ~/shots/'
       This would create a file called something like 2000-10-30_2560x1024.png  and  move  it  to
       your shots directory.

BUGS

       None known.

LICENSE

       Copyright Tom Gilbert 2000

       Permission  is  hereby  granted,  free  of  charge, to any person obtaining a copy of this
       software and associated documentation files (the "Software"),  to  deal  in  the  Software
       without  restriction, including without limitation the rights to use, copy, modify, merge,
       publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons
       to whom the Software is furnished to do so, subject to the following conditions:

       The  above  copyright notice and this permission notice shall be included in all copies of
       the Software, its documentation and marketing & publicity  materials,  and  acknowledgment
       shall  be  given  in the documentation, materials and software packages that this Software
       was used.

       THE SOFTWARE IS PROVIDED "AS IS", WITHOUT  WARRANTY  OF  ANY  KIND,  EXPRESS  OR  IMPLIED,
       INCLUDING  BUT  NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
       PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL  THE  AUTHORS  BE  LIABLE  FOR  ANY  CLAIM,
       DAMAGES  OR  OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
       FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR  THE  USE  OR  OTHER  DEALINGS  IN  THE
       SOFTWARE.

       Email bugs and feature requests to
       <scrot_sucks@linuxbrit.co.uk>

                                           Oct 26, 2000                                  scrot(1)