sway/contrib/grimshot.1.scd

77 lines
1.7 KiB
Plaintext
Raw Normal View History

2020-05-01 09:57:48 +00:00
grimshot(1)
# NAME
grimshot - a helper for screenshots within sway
# SYNOPSIS
*grimshot* [--notify] (copy|save) [TARGET] [FILE]++
*grimshot* check++
*grimshot* usage
2020-05-01 09:57:48 +00:00
# OPTIONS
2020-05-01 09:57:48 +00:00
*--notify*
Show notifications to the user that a screenshot has been taken.
*save*
Save the screenshot into a regular file. Grimshot will write images
files to *XDG_SCREENSHOTS_DIR* if this is set (or defined
in *user-dirs.dir*), or otherwise fall back to *XDG_PICTURES_DIR*.
2020-05-01 09:57:48 +00:00
*copy*
Copy the screenshot data (as image/png) into the clipboard.
# DESCRIPTION
Grimshot is an easy-to-use screenshot utility for sway. It provides a
convenient interface over grim, slurp and jq, and supports storing the
screenshot either directly to the clipboard using wl-copy or to a file.
2020-05-01 09:57:48 +00:00
# EXAMPLES
2020-05-01 09:57:48 +00:00
An example usage pattern is to add these bindings to your sway config:
2020-05-01 09:57:48 +00:00
```
# Screenshots:
# Super+P: Current window
# Super+Shift+p: Select area
# Super+Alt+p Current output
# Super+Ctrl+p Select a window
2020-05-01 09:57:48 +00:00
2020-05-08 02:56:25 +00:00
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
2020-05-01 09:57:48 +00:00
```
# TARGETS
grimshot can capture the following named targets:
_active_
Captures the currently active window.
_screen_
Captures the entire screen. This includes all visible outputs.
2020-05-08 02:56:25 +00:00
_area_
2020-05-01 09:57:48 +00:00
Allows manually selecting a rectangular region, and captures that.
_window_
Allows manually selecting a single window (by clicking on it), and
captures it.
_output_
Captures the currently active output.
# OUTPUT
Grimshot will print the filename of the captured screenshot to stdout if called
with the _save_ subcommand.
2020-05-01 09:57:48 +00:00
# SEE ALSO
*grim*(1)