Scroll to navigation

grimshot(1) General Commands Manual grimshot(1)

NAME

grimshot - a helper for screenshots within sway

SYNOPSIS

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

OPTIONS

--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. Set FILE to '-' to pipe the output to STDOUT.

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.

EXAMPLES

An example usage pattern is to add these bindings to your sway config:

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

TARGETS

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.

OUTPUT

Grimshot will print the filename of the captured screenshot to stdout if called with the save subcommand.

SEE ALSO

grim(1)

2021-02-23