Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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
       window.

       Screenshots are saved immediately. The first of the following locations
       that is defined is used (i.e.: if the  environment  variable  is	 unde-
       fined, 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  wlr_screencopy  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
	   implemented)
          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,
       shotman 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
       clipboard  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
       developed  for  anyone to use freely. If	you would like to sponsor this
       project,	see:

	   https://whynothugo.nl/sponsor

				  2025-04-13			    shotman(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=shotman&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help