DOKK / manpages / debian 11 / grimshot / grimshot.1.en
grimshot(1) General Commands Manual grimshot(1)

grimshot - a helper for screenshots within sway

grimshot [--notify] (copy|save) [TARGET] [FILE] grimshot check grimshot usage

--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`

copy

Copy the screenshot data (as image/png) into the clipboard.

Grimshot is an easy to use screenshot tool for sway. It relies on grim, slurp and jq to do the heavy lifting, and mostly provides an easy to use interface.

A recommended usage pattern is to just bind this to Super+P via sway:

# Screenshots:
# Cmd+P: Current window
# Cmd+Shift+p: Select area
# Cmd+Alt+p Current output
# Cmd+Ctrl+p Select a window
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

grimshot can capture the following named targets:

active

Captures the currently active window.

screen

Captures the entire screen. This includes all visible outputs.

area

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.

Grimshot will always print the filename of the captured screenshot to stdout.

grim(1)

2020-05-08