shotman - uncompromising screenshot gui for wayland
Contents
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 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 wlr_screencopy and wlr_layer_shell.
Development
For issues and general development inquiries, see the project home currently hosted at SourceHut:
https://git.sr.ht/~whynothugo/shotman
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.
Haiku
Fast and simple tool, Shotman captures the scene, Wayland's beauty preserved.
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 (notimplemented)
• Space: Unfocus screenshot window
• f: Toggle fullscreen (notimplemented)
• e: Edit image (opens it in GIMP) (notimplemented)
• 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.
Name
shotman - uncompromising screenshot gui for wayland
Options
-c,--captureTARGET
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,--anchorANCHOR
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
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.
See Also
slurp(1) swaymsg(1)
Synopsis
shotman [options...]
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.
