grimshot(1) General Commands Manual grimshot(1) NAME grimshot - a helper for screenshots within sway SYNOPSIS grimshot [--notify] [--cursor] (copy|save) [TARGET] [FILE] grimshot check grimshot usage OPTIONS --notify Show notifications to the user that a screenshot has been taken. --cursor Include cursors in the screenshot. save Save the screenshot into a regular file. Grimshot will write image 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 con- venient interface over grim, slurp and jq, and supports storing the screen- shot 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 cap- tures 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) 2026-08-30 grimshot(1)
Want to link to this manual page? Use this URL:
<https://man.FreeBSD.org/cgi/man.cgi?query=grimshot&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>