aboutsummaryrefslogtreecommitdiff
path: root/swaygrab
diff options
context:
space:
mode:
authorChristoph Gysin <christoph.gysin@gmail.com>2015-12-02 12:47:34 +0200
committerChristoph Gysin <christoph.gysin@gmail.com>2015-12-02 12:49:01 +0200
commit99af7e7c9cf3fbf6e3b626fa7b8e20f173bd6295 (patch)
tree2064357a24faf45ec40ef38475d6a81f13f5eb3f /swaygrab
parent7a1c8c2939c8581bb47323513b91a94aebf62b36 (diff)
downloadsway-99af7e7c9cf3fbf6e3b626fa7b8e20f173bd6295.tar.xz
move manpages to subfolders
Diffstat (limited to 'swaygrab')
-rw-r--r--swaygrab/CMakeLists.txt2
-rw-r--r--swaygrab/swaygrab.1.txt58
2 files changed, 60 insertions, 0 deletions
diff --git a/swaygrab/CMakeLists.txt b/swaygrab/CMakeLists.txt
index d5468cda..f664c01d 100644
--- a/swaygrab/CMakeLists.txt
+++ b/swaygrab/CMakeLists.txt
@@ -13,3 +13,5 @@ install(
DESTINATION bin
COMPONENT runtime
)
+
+add_manpage(swaygrab 1)
diff --git a/swaygrab/swaygrab.1.txt b/swaygrab/swaygrab.1.txt
new file mode 100644
index 00000000..cd4b8bd2
--- /dev/null
+++ b/swaygrab/swaygrab.1.txt
@@ -0,0 +1,58 @@
+/////
+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
+-------
+
+*-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.
+
+*-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 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>.