Sponsor:

Your company here — click to reach over 10,000 unique daily visitors

spectacle - Man Page

screenshot capture Utility

Examples (TL;DR)

Synopsis

spectacle [Spectacle options]

Description

spectacle is a simple application for capturing desktop screenshots. It can capture images of the entire desktop, a single monitor, the currently active window, the window currently under the mouse, or a rectangular region of the screen. The images can then be annotated, printed, sent to other applications for manipulation, or quickly be saved as-is.

Spectacle Options

-h,  --help

Displays help on commandline options.

--help-all

Displays help including Qt specific options.

-v,  --version

Displays version information.

-f,  --fullscreen

Capture the entire desktop (default).

-m,  --current

Capture the current monitor.

-a,  --activewindow

Capture the active window.

-u,  --windowundercursor

Capture the window currently under the cursor, including parents of pop-up menus.

-t,  --transientonly

Capture the window currently under the cursor, excluding parents of pop-up menus.

-r,  --region

Capture a rectangular region of the screen.

-l,  --launchonly

Launch Spectacle without taking a screenshot.

-g,  --gui

Start in GUI mode (default).

-b,  --background

Take a screenshot and exit without showing the GUI.

-s,  --dbus

Start in DBus-Activation mode.

-n,  --nonotify

In background mode, do not pop up a notification when the screenshot is taken.

-o,  --output fileName

In background mode, save image to specified file fileName.

-d,  --delay delayMsec

In background mode, delay before taking the shot (in milliseconds).

-c,  --copy-image

In background mode, copy screenshot only to clipboard, unless -o is also used.

-C,  --copy-path

In background mode, copy screenshot file path to clipboard.

-w,  --onclick

Wait for a click before taking screenshot. Invalidates delay..

-i,  --new-instance

Starts a new GUI instance of spectacle without registering to DBus.

-p,  --pointer

In background mode, include pointer in the screenshot.

-e,  --no-decoration

In background mode, do not include window decorations in the screenshot.

-E,  --edit-existing existingFileName

Open and edit existing screenshot file.

Feedback

On IRC, irc.libera.chat #kde or via email, kde-graphics-devel@kde.org or on the web, <https://apps.kde.org/spectacle>

See Also

More detailed user documentation is available from help:/spectacle (either enter this URL into Konqueror, or run khelpcenter help:/spectacle).
kf6options(7)
qt6options(7)
There is also further information available at https://apps.kde.org/spectacle

Author

Yuri Chornoivan <yurchor@ukr.net>

Spectacle man page.

Info

2023-11-26 KDE Applications Spectacle 23. Spectacle User's Manual