.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
.\"
.\" 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
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    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
.\" ========================================================================
.\"
.IX Title "SHUTTER 1"
.TH SHUTTER 1 2025-03-02 "perl v5.40.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 "CAPTURE MODE OPTIONS"
.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=[NAME_PATTERN]\fR" 8
.IX Item "-w, --window=[NAME_PATTERN]"
Select a window to capture. Providing a NAME_PATTERN (Perl-style regex) is 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=[URL]\fR 8
.IX Item "--web=[URL]"
Capture a webpage. Providing an URL is optional.
.IP "\fB\-r, \-\-redo\fR" 8
.IX Item "-r, --redo"
Redo last screenshot.
.SS "SETTINGS OPTIONS"
.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 "APPLICATION OPTIONS"
.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 STDOUT.
.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