FreeBSD Manual Pages
shotman(1) General Commands Manual shotman(1) NAME shotman - uncompromising screenshot gui for wayland SYNOPSIS shotman [options...] OPTIONS -c, --capture TARGET Specify which target to capture. See TARGETS below. -C --copy Automatically copy screenshot to clipboard. -v --verbose Verbose logging. Can be specified more than. -a, --anchor ANCHOR Anchor thumbnail to this edge of the screen (default: top-left). -h --help Print help information (use `-h` for a summary) -V --version Print version information and exit DESCRIPTION shotman takes a screenshot and shows it in a small floating thumbnail win- dow. Screenshots are saved immediately. The first of the following locations that is defined is used (i.e.: if the environment variable is undefined, the next one on the list is used). 1. $XDG_SCREENSHOTS_DIR/ 2. $XDG_PICTURES_DIR/screenshots/ 3. $HOME/screenshots/ 4. The current directory. shotman requires a compositor that supports ext-image-copy-capture, ext-im- age-capture-source and wlr_layer_shell. KEYBOARD CONTROLS The following are applicable while the thumbnail window is focused: * Esc or q: quit, keeping the saved the screenshot * Del or d: discard (delete) the screenshot and exit * Ctrl+C or XF86Copy: copy the screenshot into the clipboard * Ctrl+X or XF86Cut: cut the screenshot file into the clipboard (not im- plemented) * Space: Unfocus screenshot window * f: Toggle fullscreen (not implemented) * e: Edit image (opens it in GIMP) (not implemented) * h,j,k,l: Move preview to another corner When quitting, if the screenshot has been copied into the clipboard, shot- man will continue running in the background to allow pasting it. Shotman will exit as soon as it loses clipboard ownership. TARGETS window The currently active window. Only available on swaywm. Requires swaymsg. region An interactively picked region. Uses and requires slurp for picking the region. output The current active output. ENVIRONMENT WAYLAND_DISPLAY Connect to the specific wayland socket instead of the default. IMAGE_EDITOR Specified the image editor to use to edit a screenshot. PRIVACY Shotman only saves the screenshot to disk, and will copy it into the clip- board when manually requested by the user. No internet access is involved. DEVELOPMENT For issues and general development inquiries, see the project home cur- rently hosted at SourceHut: https://git.sr.ht/~whynothugo/shotman HAIKU Fast and simple tool, Shotman captures the scene, Wayland's beauty pre- served. SEE ALSO slurp(1) swaymsg(1) AUTHORS Developed by Hugo O. Barrera <hugo@whynothugo.nl>. shotman is an open source project licensed under the ISC licence and devel- oped for anyone to use freely. If you would like to sponsor this project, see: https://whynothugo.nl/sponsor 2026-07-31 shotman(1)
NAME | SYNOPSIS | OPTIONS | DESCRIPTION | KEYBOARD CONTROLS | TARGETS | ENVIRONMENT | PRIVACY | DEVELOPMENT | HAIKU | SEE ALSO | AUTHORS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=shotman&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>