2015-11-27 15:06:24 +00:00
|
|
|
/////
|
|
|
|
|
vim:set ts=4 sw=4 tw=82 noet:
|
|
|
|
|
/////
|
|
|
|
|
:quotes.~:
|
|
|
|
|
|
|
|
|
|
swaygrab (1)
|
|
|
|
|
============
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
----
|
|
|
|
|
swaygrab - Grab image data from the current sway session.
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
--------
|
2015-12-17 15:47:18 +00:00
|
|
|
'swaygrab' [options] [file]
|
2015-11-27 15:06:24 +00:00
|
|
|
|
2015-12-17 15:47:18 +00:00
|
|
|
Grabs pixels from an output and writes them to _file_. The image will be passed to
|
2015-11-27 15:06:24 +00:00
|
|
|
ImageMagick convert for processing.
|
|
|
|
|
|
|
|
|
|
Options
|
|
|
|
|
-------
|
|
|
|
|
|
2015-11-28 14:18:54 +00:00
|
|
|
*-h, --help*::
|
|
|
|
|
Show help message and quit.
|
|
|
|
|
|
2015-11-27 15:06:24 +00:00
|
|
|
*-c, \--capture*::
|
|
|
|
|
Captures multiple frames as video and passes them into ffmpeg. Continues until
|
|
|
|
|
you send SIGTERM (ctrl+c) to swaygrab.
|
|
|
|
|
|
2015-12-17 15:47:18 +00:00
|
|
|
*-o, \--output* <output>::
|
|
|
|
|
Use the specified _output_. If no output is defined the currently focused
|
|
|
|
|
output in sway will be used.
|
|
|
|
|
|
2015-11-27 15:06:24 +00:00
|
|
|
*-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).
|
|
|
|
|
|
2016-03-29 18:32:21 +00:00
|
|
|
*-R, --rate* <rate>::
|
2015-11-27 19:21:38 +00:00
|
|
|
Specify a framerate (in frames per second). Used in combination with -c.
|
|
|
|
|
Default is 30. Must be an integer.
|
|
|
|
|
|
2017-02-13 00:22:48 +00:00
|
|
|
*-r, --raw*::
|
2015-11-27 19:21:38 +00:00
|
|
|
Instead of invoking ImageMagick or ffmpeg, dump raw rgba data to stdout.
|
2017-02-13 00:22:48 +00:00
|
|
|
|
|
|
|
|
*-f, --focused*::
|
|
|
|
|
Capture only the currently focused container.
|
2015-11-27 19:21:38 +00:00
|
|
|
|
2017-06-18 00:41:09 +00:00
|
|
|
Environment Variables
|
|
|
|
|
---------------------
|
|
|
|
|
swaygrab reads the following environment variables.
|
|
|
|
|
|
|
|
|
|
*SWAYGRAB_FFMPEG_OPTS*::
|
|
|
|
|
Pass additional arguments to FFmpeg when starting a capture.
|
|
|
|
|
|
2015-11-27 15:39:18 +00:00
|
|
|
Examples
|
|
|
|
|
--------
|
|
|
|
|
|
2015-12-17 15:47:18 +00:00
|
|
|
swaygrab output.png::
|
|
|
|
|
Grab the contents of currently focused output and write to output.png.
|
2015-11-27 15:39:18 +00:00
|
|
|
|
2015-12-17 15:47:18 +00:00
|
|
|
swaygrab -c -o HDMI-A-1 output.webm::
|
2015-11-27 15:39:18 +00:00
|
|
|
Capture a webm of HDMI-A-1.
|
|
|
|
|
|
2017-06-18 00:41:09 +00:00
|
|
|
SWAYGRAB_FFMPEG_OPTS="-f alsa -i pulse" swaygrab -c::
|
|
|
|
|
Capture the focused output and encode audio from the default recording
|
|
|
|
|
device.
|
|
|
|
|
|
2015-11-27 15:06:24 +00:00
|
|
|
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>.
|
