# Spectacle User's Manual

`spectacle`

1

spectacle

screenshot capture Utility

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

`--scaled`

- When used with `-f`/`--fullscreen`, capture all screens scaled to the same size. Has no effect without `-f`.

`-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

## Copyright

Copyright © 2015 Boudhayan Gupta

License: GNU General Public Version 2 <https://www.gnu.org/licenses/gpl-2.0.html>