aboutsummaryrefslogtreecommitdiffstats
path: root/contrib/grimshot.1
blob: a51f3d4d0a0abe0f73a8fef5c04d239f2736e119 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
.\" Generated by scdoc 1.10.1
.\" 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" "2020-05-08"
.P
.SH NAME
.P
grimshot - a helper for screenshots within sway
.P
.SH DESCRIPTION
.P
grimshot [--notify] (copy|save) [TARGET] [FILE]
grimshot check
grimshot usage
.P
\fB--notify\fR
.RS 4
Show notifications to the user that a screenshot has been taken.
.P
.RE
\fBsave\fR
.RS 4
Save the screenshot into a regular file. Grimshot will write images
files to \fB$XDG_SCREENSHOTS_DIR\fR if this is set (or defined
in `user-dirs.dir`), or otherwise fall back to `$XDG_PICTURES_DIR`
.P
.RE
\fBcopy\fR
.RS 4
Copy the screenshot data (as image/png) into the clipboard.
.P
.RE
.SH SYNOPSIS
.P
Grimshot is an easy to use screenshot tool for sway. It relies on grim, slurp
and jq to do the heavy lifting, and mostly provides an easy to use interface.
.P
A recommended usage pattern is to just bind this to Super+P via sway:
.P
.nf
.RS 4
# Screenshots:
# Cmd+P: Current window
# Cmd+Shift+p: Select area
# Cmd+Alt+p Current output
# Cmd+Ctrl+p Select a window

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
.fi
.RE
.P
.SH TARGETS
.P
grimshot can capture the following named targets:
.P
\fIactive\fR
.RS 4
Captures the currently active window.
.P
.RE
\fIscreen\fR
.RS 4
Captures the entire screen. This includes all visible outputs.
.P
.RE
\fIarea\fR
.RS 4
Allows manually selecting a rectangular region, and captures that.
.P
.RE
\fIwindow\fR
.RS 4
Allows manually selecting a single window (by clicking on it), and
captures it.
.P
.RE
\fIoutput\fR
.RS 4
Captures the currently active output.
.P
.RE
.SH OUTPUT
.P
Grimshot will always print the filename of the captured screenshot to
stdout.
.P
.SH SEE ALSO
.P
\fBgrim\fR(1)