sway/contrib/grimshot.1

110 lines
2.2 KiB
Groff
Raw Normal View History

.\" Generated by scdoc 1.11.2
2020-05-01 09:57:48 +00:00
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "grimshot" "1" "2022-03-31"
2020-05-01 09:57:48 +00:00
.P
.SH NAME
.P
grimshot - a helper for screenshots within sway
.P
.SH SYNOPSIS
.P
\fBgrimshot\fR [--notify] [--cursor] (copy|save) [TARGET] [FILE]
.br
\fBgrimshot\fR check
.br
\fBgrimshot\fR usage
2020-05-01 09:57:48 +00:00
.P
.SH OPTIONS
2020-05-01 09:57:48 +00:00
.P
\fB--notify\fR
.RS 4
Show notifications to the user that a screenshot has been taken.\&
2020-05-01 09:57:48 +00:00
.P
.RE
\fB--cursor\fR
.RS 4
Include cursors in the screenshot.\&
.P
.RE
2020-05-01 09:57:48 +00:00
\fBsave\fR
.RS 4
Save the screenshot into a regular file.\& Grimshot will write images
files to \fBXDG_SCREENSHOTS_DIR\fR if this is set (or defined
in \fBuser-dirs.\&dir\fR), or otherwise fall back to \fBXDG_PICTURES_DIR\fR.\&
Set FILE to '\&-'\& to pipe the output to STDOUT.\&
2020-05-01 09:57:48 +00:00
.P
.RE
\fBcopy\fR
.RS 4
Copy the screenshot data (as image/png) into the clipboard.\&
2020-05-01 09:57:48 +00:00
.P
.RE
.SH DESCRIPTION
.P
Grimshot is an easy-to-use screenshot utility for sway.\& It provides a
convenient interface over grim, slurp and jq, and supports storing the
screenshot either directly to the clipboard using wl-copy or to a file.\&
2020-05-01 09:57:48 +00:00
.P
.SH EXAMPLES
2020-05-01 09:57:48 +00:00
.P
An example usage pattern is to add these bindings to your sway config:
2020-05-01 09:57:48 +00:00
.P
.nf
.RS 4
# Screenshots:
# Super+P: Current window
# Super+Shift+p: Select area
# Super+Alt+p Current output
# Super+Ctrl+p Select a window
2020-05-01 09:57:48 +00:00
2020-05-08 02:56:25 +00:00
bindsym Mod4+p exec grimshot save active
bindsym Mod4+Shift+p exec grimshot save area
bindsym Mod4+Mod1+p exec grimshot save output
bindsym Mod4+Ctrl+p exec grimshot save window
2020-05-01 09:57:48 +00:00
.fi
.RE
.P
.SH TARGETS
.P
grimshot can capture the following named targets:
.P
\fIactive\fR
.RS 4
Captures the currently active window.\&
2020-05-01 09:57:48 +00:00
.P
.RE
\fIscreen\fR
.RS 4
Captures the entire screen.\& This includes all visible outputs.\&
2020-05-01 09:57:48 +00:00
.P
.RE
2020-05-08 02:56:25 +00:00
\fIarea\fR
2020-05-01 09:57:48 +00:00
.RS 4
Allows manually selecting a rectangular region, and captures that.\&
2020-05-01 09:57:48 +00:00
.P
.RE
\fIwindow\fR
.RS 4
Allows manually selecting a single window (by clicking on it), and
captures it.\&
2020-05-01 09:57:48 +00:00
.P
.RE
\fIoutput\fR
.RS 4
Captures the currently active output.\&
2020-05-01 09:57:48 +00:00
.P
.RE
.SH OUTPUT
.P
Grimshot will print the filename of the captured screenshot to stdout if called
with the \fIsave\fR subcommand.\&
2020-05-01 09:57:48 +00:00
.P
.SH SEE ALSO
.P
\fBgrim\fR(1)