summaryrefslogtreecommitdiffstats
path: root/swaygrab.1.txt
blob: 54a1c37addb488cc0d7126ad46540565168b65cd (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
/////
vim:set ts=4 sw=4 tw=82 noet:
/////
:quotes.~:

swaygrab (1)
============

Name
----
swaygrab - Grab image data from the current sway session.

Synopsis
--------
'swaygrab' [options] [output] [file]

Grabs pixels from _output_ and writes them to _file_. The image will be passed to
ImageMagick convert for processing.

Options
-------

*-c, \--capture*::
	Captures multiple frames as video and passes them into ffmpeg. Continues until
	you send SIGTERM (ctrl+c) to swaygrab.

*-v, \--version*::
	Print the version (of swaymsg) and quit.

*-s, --socket* <path>::
	Use the specified socket path. Otherwise, swaymsg will ask sway where the
	socket is (which is the value of $SWAYSOCK, then of $I3SOCK).

Examples
--------

swaygrab HDMI-A-1 output.png::
	Grab the contents of HDMI-A-1 and write to output.png.

swaygrab -c HDMI-A-1 output.webm::
	Capture a webm of HDMI-A-1.

Authors
-------

Maintained by Drew DeVault <sir@cmpwn.com>, who is assisted by other open
source contributors. For more information about sway development, see
<https://github.com/SirCmpwn/sway>.

See Also
--------

**sway**(5)