'\" t
.\"     Title: \fBspectacle\fR
.\"    Author: Yuri Chornoivan <yurchor@ukr.net>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 2021-04-11
.\"    Manual: Spectacle User's Manual
.\"    Source: KDE Applications Spectacle 21.08
.\"  Language: English
.\"
.TH "\FBSPECTACLE\FR" "1" "2021\-04\-11" "KDE Applications Spectacle 21." "Spectacle User's Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
spectacle \- screenshot capture Utility
.SH "SYNOPSIS"
.HP \w'\fBspectacle\fR\ 'u
\fBspectacle\fR [\fISpectacle\ options\fR]
.SH "DESCRIPTION"
.PP
\fBspectacle\fR
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 printed, sent to other applications for manipulation, or quickly be saved as\-is\&.
.SH "SPECTACLE OPTIONS"
.PP
\fB\-f, \-\-fullscreen\fR
.RS 4
Capture the entire desktop (default)\&.
.RE
.PP
\fB\-m, \-\-current\fR
.RS 4
Capture the current monitor\&.
.RE
.PP
\fB\-a, \-\-activewindow\fR
.RS 4
Capture the active window\&.
.RE
.PP
\fB\-u, \-\-windowundercursor\fR
.RS 4
Capture the window currently under the cursor, including parents of pop\-up menus\&.
.RE
.PP
\fB\-t, \-\-transientonly\fR
.RS 4
Capture the window currently under the cursor, excluding parents of pop\-up menus\&.
.RE
.PP
\fB\-r, \-\-region\fR
.RS 4
Capture a rectangular region of the screen\&.
.RE
.PP
\fB\-l, \-\-launchonly\fR
.RS 4
Launch Spectacle without taking a screenshot\&.
.RE
.PP
\fB\-g, \-\-gui\fR
.RS 4
Start in GUI mode (default)\&.
.RE
.PP
\fB\-b, \-\-background\fR
.RS 4
Take a screenshot and exit without showing the GUI\&.
.RE
.PP
\fB\-s, \-\-dbus\fR
.RS 4
Start in DBus\-Activation mode\&.
.RE
.PP
\fB\-n, \-\-nonotify\fR
.RS 4
In background mode, do not pop up a notification when the screenshot is taken\&.
.RE
.PP
\fB\-o, \-\-output \fR\fB\fIfileName\fR\fR
.RS 4
In background mode, save image to specified file
\fIfileName\fR\&.
.RE
.PP
\fB\-d, \-\-delay \fR\fB\fIdelayMsec\fR\fR
.RS 4
In background mode, delay before taking the shot (in milliseconds)\&.
.RE
.PP
\fB\-c, \-\-copy\-image\fR
.RS 4
In background mode, copy screenshot only to clipboard, unless \-o is also used\&.
.RE
.PP
\fB\-C, \-\-copy\-path\fR
.RS 4
In background mode, copy screenshot file path to clipboard\&.
.RE
.PP
\fB\-w, \-\-onclick\fR
.RS 4
Wait for a click before taking screenshot\&. Invalidates delay\&.\&.
.RE
.PP
\fB\-i, \-\-new\-instance\fR
.RS 4
Starts a new GUI instance of spectacle without registering to DBus\&.
.RE
.PP
\fB\-i, \-\-pointer\fR
.RS 4
In background mode, include pointer in the screenshot\&.
.RE
.PP
\fB\-e, \-\-no\-decoration\fR
.RS 4
In background mode, do not include window decorations in the screenshot\&.
.RE
.SH "FEEDBACK"
.PP
On IRC, irc\&.libera\&.chat #kde or via email, kde\-graphics\-devel@kde\&.org or on the web, <\m[blue]\fBhttps://apps\&.kde\&.org/spectacle\fR\m[]>
.SH "SEE ALSO"
.RS 4
More detailed user documentation is available from \m[blue]\fBhelp:/spectacle\fR\m[]
(either enter this URL into Konqueror, or run
\fB\fBkhelpcenter\fR\fR\fB
\fR\fB\fIhelp:/spectacle\fR\fR)\&.
.RE
.RS 4
kf5options(7)
.RE
.RS 4
qt5options(7)
.RE
.RS 4
There is also further information available at
\m[blue]\fBhttps://apps\&.kde\&.org/spectacle\fR\m[]
.RE
.SH "COPYRIGHT"
.PP
Copyright (c) 2015 Boudhayan Gupta
.PP
License: GNU General Public Version 2 <\m[blue]\fBhttps://www\&.gnu\&.org/licenses/gpl\-2\&.0\&.html\fR\m[]>
.SH "AUTHOR"
.PP
\fBYuri Chornoivan\fR <\&yurchor@ukr\&.net\&>
.RS 4
Spectacle man page\&.
.RE