.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.42)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "SHUTTER 1"
.TH SHUTTER 1 "2022-02-19" "perl v5.34.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
Shutter \- Feature\-rich Screenshot Tool
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
shutter [options]
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
Shutter is Copyright (C) by Mario Kemper and Shutter Team
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBShutter\fR is a feature-rich screenshot program. You can take a screenshot of a specific area, window, your whole screen, or even of a website \- apply different effects to it, draw on it to highlight points, and then upload to an image hosting site, all within one window.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "Example 1" 8
.IX Item "Example 1"
shutter \-a \-p=myprofile \-\-min_at_startup
.IP "Example 2" 8
.IX Item "Example 2"
shutter \-s=100,100,300,300 \-e
.IP "Example 3" 8
.IX Item "Example 3"
shutter \-\-window=.*firefox.*
.IP "Example 4" 8
.IX Item "Example 4"
shutter \-\-web=http://shutter\-project.org/ \-e
.SS "\s-1CAPTURE MODE OPTIONS\s0"
.IX Subsection "CAPTURE MODE OPTIONS"
.IP "\fB\-s, \-\-select=[X,Y,WIDTH,HEIGHT]\fR" 8
.IX Item "-s, --select=[X,Y,WIDTH,HEIGHT]"
Capture an area of the screen. Providing X,Y,WIDTH,HEIGHT is optional.
.IP "\fB\-f, \-\-full\fR" 8
.IX Item "-f, --full"
Capture the entire screen.
.IP "\fB\-w, \-\-window=[\s-1NAME_PATTERN\s0]\fR" 8
.IX Item "-w, --window=[NAME_PATTERN]"
Select a window to capture. Providing a \s-1NAME_PATTERN\s0 (Perl-style regex) ist optional.
.IP "\fB\-a, \-\-active\fR" 8
.IX Item "-a, --active"
Capture the current active window.
.IP "\fB\-m, \-\-menu\fR" 8
.IX Item "-m, --menu"
Capture a menu.
.IP "\fB\-t, \-\-tooltip\fR" 8
.IX Item "-t, --tooltip"
Capture a tooltip.
.IP "\fB\-\-web=[\s-1URL\s0]\fR" 8
.IX Item "--web=[URL]"
Capture a webpage. Providing an \s-1URL\s0 ist optional.
.IP "\fB\-r, \-\-redo\fR" 8
.IX Item "-r, --redo"
Redo last screenshot.
.SS "\s-1SETTINGS OPTIONS\s0"
.IX Subsection "SETTINGS OPTIONS"
.IP "\fB\-p, \-\-profile=NAME\fR" 8
.IX Item "-p, --profile=NAME"
Load a specific profile on startup.
.IP "\fB\-o, \-\-output=FILENAME\fR" 8
.IX Item "-o, --output=FILENAME"
Specify a filename to save the screenshot to (overwrites any profile-related setting).
.Sp
\&\fBSupported image formats:\fR You can save to any popular image format (e.g. jpeg, png, gif, bmp). Additionally it is possible to save to pdf, ps or svg.
.Sp
\&\fBPlease note:\fR There are several wildcards available, like
.Sp
.Vb 11
\& %Y = year
\& %m = month
\& %d = day
\& %T = time
\& $w = width
\& $h = height
\& $name = multi\-purpose (e.g. window title)
\& $nb_name = like $name but without blanks in resulting strings
\& $profile = name of current profile
\& $R = random char (e.g. $RRRR = ag4r)
\& %NN = counter
.Ve
.Sp
The string is interpretted by strftime. See \f(CW\*(C`man strftime\*(C'\fR for more examples.
.Sp
\&\fBAs an example:\fR shutter \-f \-e \-o './%y\-%m\-%d_$w_$h.png' would create a file named '11\-10\-28_1280_800.png' in the current directory.
.IP "\fB\-d, \-\-delay=SECONDS\fR" 8
.IX Item "-d, --delay=SECONDS"
Wait n seconds before taking a screenshot.
.IP "\fB\-c, \-\-include_cursor\fR" 8
.IX Item "-c, --include_cursor"
Include cursor when taking a screenshot.
.IP "\fB\-C, \-\-remove_cursor\fR" 8
.IX Item "-C, --remove_cursor"
Remove cursor when taking a screenshot.
.SS "\s-1APPLICATION OPTIONS\s0"
.IX Subsection "APPLICATION OPTIONS"
.IP "\fB\-h, \-\-help\fR" 8
.IX Item "-h, --help"
Prints a brief help message and exits.
.IP "\fB\-v, \-\-version\fR" 8
.IX Item "-v, --version"
Prints version information.
.IP "\fB\-\-debug\fR" 8
.IX Item "--debug"
Prints a lot of debugging information to \s-1STDOUT.\s0
.IP "\fB\-\-clear_cache\fR" 8
.IX Item "--clear_cache"
Clears cache, e.g. installed plugins, at startup.
.IP "\fB\-\-min_at_startup\fR" 8
.IX Item "--min_at_startup"
Starts Shutter minimized to tray.
.IP "\fB\-\-disable_systray\fR" 8
.IX Item "--disable_systray"
Disables systray icon.
.IP "\fB\-e, \-\-exit_after_capture\fR" 8
.IX Item "-e, --exit_after_capture"
Exit after the first capture has been made. This is useful when using Shutter in scripts.
.IP "\fB\-n, \-\-no_session\fR" 8
.IX Item "-n, --no_session"
Do not add the screenshot to the session. This is useful when using Shutter in scripts.
.SH "BUG REPORTS"
.IX Header "BUG REPORTS"
If you find a bug in Shutter, you should report it.  But first, you should make sure that it really is a bug, and that it appears in the latest version of Shutter.
.PP
The latest version is always available from:
\&\fBhttps://github.com/shutter\-project/shutter/releases\fR
.PP
Once you have determined that a bug actually exists, please report it at github:
\&\fBhttps://github.com/shutter\-project/shutter/issues/new\fR