swaygrab man page

swaygrab — Grab image data from the current sway session.

Synopsis

swaygrab [options] [file]

Grabs pixels from an output and writes them to file. The image will be passed to ImageMagick convert for processing.

Options

-h, --help
Show help message and quit.
-c, --capture
Captures multiple frames as video and passes them into ffmpeg. Continues until you send SIGTERM (ctrl+c) to swaygrab.
-o, --output <output>
Use the specified output. If no output is defined the currently focused output in sway will be used.
-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).
-R, --rate <rate>
Specify a framerate (in frames per second). Used in combination with -c. Default is 30. Must be an integer.
--raw
Instead of invoking ImageMagick or ffmpeg, dump raw rgba data to stdout.

Examples

swaygrab output.png

Grab the contents of currently focused output and write to output.png.

swaygrab -c -o 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.

Referenced By

sway(1).

11/26/2016