Reference

shutter(1)

Feature-rich Screenshot Tool

NAME

Shutter - Feature-rich Screenshot Tool

SYNOPSIS

shutter [options]

COPYRIGHT

Shutter is Copyright (C) by Mario Kemper and Shutter Team

DESCRIPTION

Shutter 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.

OPTIONS

Example 1

shutter -a -p=myprofile --min_at_startup

Example 2

shutter -s=100,100,300,300 -e

Example 3

shutter --window=.*firefox.*

Example 4

shutter --web=http://shutter-project.org/ -e

CAPTURE MODE OPTIONS

-s, --select=[X,Y,WIDTH,HEIGHT]

Capture an area of the screen. Providing X,Y,WIDTH,HEIGHT is optional.

-f, --full

Capture the entire screen.

-w, --window=[NAME_PATTERN]

Select a window to capture. Providing a NAME_PATTERN (Perl-style regex) is optional.

-a, --active

Capture the current active window.

-m, --menu

Capture a menu.

-t, --tooltip

Capture a tooltip.

--web=[URL]

Capture a webpage. Providing an URL is optional.

-r, --redo

Redo last screenshot.

SETTINGS OPTIONS

-p, --profile=NAME

Load a specific profile on startup.

-o, --output=FILENAME

Specify a filename to save the screenshot to (overwrites any profile-related setting).

Supported image formats: 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.

Please note: There are several wildcards available.

Wild cards provided by Shutter are:

 $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

Additionally, there are date related wildcards:

 %Y = year
 %m = month
 %d = day
 %T = time

The string is interpretted by strftime. See "man strftime" for more examples.

As an example: 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.

-d, --delay=SECONDS

Wait n seconds before taking a screenshot.

-c, --include_cursor

Include cursor when taking a screenshot.

-C, --remove_cursor

Remove cursor when taking a screenshot.

APPLICATION OPTIONS

-h, --help

Prints a brief help message and exits.

-v, --version

Prints version information.

--debug

Prints a lot of debugging information to STDOUT.

--clear_cache

Clears cache, e.g. installed plugins, at startup.

--min_at_startup

Starts Shutter minimized to tray.

--disable_systray

Disables systray icon.

-e, --exit_after_capture

Exit after the first capture has been made. This is useful when using Shutter in scripts.

-n, --no_session

Do not add the screenshot to the session. This is useful when using Shutter in scripts.

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.

The latest version is always available from: https://github.com/shutter-project/shutter/releases

Once you have determined that a bug actually exists, please report it at github: https://github.com/shutter-project/shutter/issues/new

History

--active since Debian 7 (Wheezy); --delay since Debian 7 (Wheezy); --exit_after_capture since Debian 7 (Wheezy); --include_cursor since Debian 7 (Wheezy); --menu since Debian 7 (Wheezy); --no_session since Debian 7 (Wheezy); --output since Debian 7 (Wheezy); --profile since Debian 7 (Wheezy); --redo since Debian 7 (Wheezy); --remove_cursor since Debian 7 (Wheezy); --select since Debian 7 (Wheezy); --tooltip since Debian 7 (Wheezy); --version since Debian 7 (Wheezy); --web since Debian 7 (Wheezy); -C since Debian 7 (Wheezy); -a since Debian 7 (Wheezy); -c since Debian 7 (Wheezy); -d since Debian 7 (Wheezy); -e since Debian 7 (Wheezy); -f since Debian 7 (Wheezy); -h since Debian 7 (Wheezy); -m since Debian 7 (Wheezy); -n since Debian 7 (Wheezy); -o since Debian 7 (Wheezy); -p since Debian 7 (Wheezy); -r since Debian 7 (Wheezy); -s since Debian 7 (Wheezy); -t since Debian 7 (Wheezy); -v since Debian 7 (Wheezy); -w since Debian 7 (Wheezy).

--section until Debian 12 (Bookworm); --selection until Debian 6.0 (Squeeze).