grimshot(1)                 General Commands Manual                grimshot(1)

<?><?><?> (NAME)
       grimshot - <?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>
       Sway

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       grimshot [--notify] [--cursor] [--wait N] (copy|save) [TARGET] [FILE]
       grimshot check
       grimshot usage

<?><?><?><?><?><?><?><?> (OPTIONS)
       --notify
           <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?> <?><?><?>.

       --cursor
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>.

       --wait N
           <?><?><?> <?><?> <?><?><?> N <?><?><?><?><?> <?><?><?> <?><?>
           <?><?><?> <?><?><?><?><?><?><?><?><?><?>. <?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?><?> <?><?><?><?><?><?>. <?><?><?><?><?> <?><?><?><?><?><?>
           <?><?> --notify <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?>.

       save
           <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?><?>. <?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?> XDG_SCREENSHOTS_DIR <?><?><?><?><?><?><?><?>
           <?><?><?> <?><?><?><?> (<?><?> <?><?> user-dirs.dir <?><?><?><?><?>
           <?><?><?> <?><?><?><?>)<?> Grimshot <?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?><?>
           <?><?> <?><?><?> <?><?><?> <?><?><?><?> <?><?> XDG_PICTURES_DIR
           <?><?><?><?><?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?> STDOUT <?><?><?><?><?> FILE <?><?>
           <?><?><?><?><?> <?><?> '-' <?><?><?><?> <?><?><?><?>.
           <?><?><?><?><?> <?><?><?><?><?> GRIMSHOT_FILENAME_FORMAT <?><?>
           <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>.

       copy
           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?> (<?><?> <?><?><?><?> image/png)
           <?><?> <?><?><?><?><?> <?><?><?><?> (<?><?><?><?><?><?><?><?><?>).

       savecopy
           <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?><?> (<?><?><?><?><?><?><?> save <?><?>
           <?><?><?><?><?><?>) <?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
           (<?><?><?><?><?><?><?><?><?>) (<?><?><?><?><?><?><?> copy <?><?>
           <?><?><?><?><?><?>).

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?><?> Grimshot <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> sway <?><?><?>. <?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> grim <?>slurp <?> jq <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?> wl-copy <?><?> <?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?> sway <?><?><?>:

           # 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

       <?>/<?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>:

           export GRIMSHOT_FILENAME_FORMAT="$(date --iso-8601=ns | tr ':' -)"

<?><?><?><?><?> (TARGETS)
       <?><?><?><?><?><?> grimshot <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?> <?><?><?>:

       active
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?><?>.

       screen
           <?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?><?>. <?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?>.

       area
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?> <?><?><?> <?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?>.

       window
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?> (<?><?> <?><?><?><?> <?><?><?>
           <?><?>) <?> <?><?><?> <?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?>.

       output
           <?><?><?><?><?> (<?><?><?><?><?><?><?>) <?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?>.

       anything
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?> (<?><?> <?><?><?><?> <?><?><?>
           <?><?>)<?> <?><?> <?><?><?><?><?> (<?><?> <?><?><?><?> <?><?>
           <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>) <?><?>
           <?><?> <?><?><?><?><?> (<?><?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?><?> <?> <?><?><?><?><?>) <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?>.

<?><?><?><?><?> (OUTPUT)
       <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?> save <?><?> savecopy<?>
       <?><?><?><?><?><?> Grimshot <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> (stdout) <?><?><?>
       <?><?><?><?><?><?>.

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       grim(1)

                                  2026-06-24                       grimshot(1)