shotman(1)

✨ shotman(1) ✨

okay bestie, welcome to the shotman man page — section 1 of the General Commands Manual, and no, it's not a scam, it's a whole screenshot gui 💖

---

🌸 NAME 🌸

shotman — the uncompromising screenshot gui for wayland. uncompromising as in it does not negotiate, it does not ask twice, it just screenshots. periodt 💅

---

🎀 SYNOPSIS 🎀

shotman [options...]

---

✨ OPTIONS ✨

• -c, --capture TARGET — tell it what to capture. the deets live down in TARGETS. 👀
• -C, --copy — auto-copies the screenshot to your clipboard the second it's taken. no extra vibes required. 📋
• -v, --verbose — verbose logging. and, direct quote from the page itself, it "can be specified more than". that's it, that's the sentence, I do not make the rules. 🗣️
• -a, --anchor ANCHOR — anchors the thumbnail to this edge of the screen (default: top-left). 🧲
• -h, --help — prints help info (use -h for a summary). 😌
• -V, --version — prints version info and dips out. exit stage left. 👋

---

💜 DESCRIPTION 💜

shotman takes a screenshot and then, iconically, shows it to you in a small floating thumbnail window. main character behavior honestly. 🦋

Screenshots are saved immediately. and it goes down this list and uses the first location that's actually defined — meaning if the environment variable isn't set, it just slides down to the next one. no cap, here's the order:

1. $XDG_SCREENSHOTS_DIR/
2. $XDG_PICTURES_DIR/screenshots/
3. $HOME/screenshots/
4. The current directory.

⚠️ heads up bestie: shotman requires a compositor that supports ext-image-copy-capture, ext-image-capture-source and wlr_layer_shell. if your compositor doesn't have those, this whole thing is a no-go, sorry. 😭

---

⌨️ KEYBOARD CONTROLS ⌨️

these hit different when the thumbnail window is focused, okay:

• Esc or q: quit, keeping the screenshot you saved 💾
• Del or d: discard (delete) the screenshot and exit. gone, deleted, never happened 🙈
• 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 the screenshot window 🪟
• f: toggle fullscreen — not implemented 🚫
• e: edit the image (opens it in GIMP) — not implemented 🚫
• h,j,k,l: move the preview to another corner 🔀

when you quit, if the screenshot has been copied into the clipboard, shotman keeps running in the background so you can still paste it. and it will exit the moment it loses clipboard ownership. it's loyal like that. 🫶

---

🌈 TARGETS 🌈

• window — the currently active window. only available on swaywm, and it requires swaymsg. 🪟
• region — an interactively picked region. it uses slurp for picking the region, and yes, it requires it too. 🎯
• output — the current active output. 🖥️

---

🦋 ENVIRONMENT 🦋

• WAYLAND_DISPLAY — connect to that specific wayland socket instead of the default one. 🔌
• IMAGE_EDITOR — specifies the image editor to use when you edit a screenshot. 🎨

---

🔒 PRIVACY 🔒

shotman only saves the screenshot to disk, and it will only copy it into the clipboard when the user manually asks for it. no internet access is involved. zero. none. your screenshots are not being posted, bestie, they're safe. 🛡️

---

🛠️ DEVELOPMENT 🛠️

for issues and general development inquiries, the project home is currently hosted at SourceHut:

https://git.sr.ht/~whynothugo/shotman

---

🌸 HAIKU 🌸

Fast and simple tool, Shotman captures the scene, Wayland's beauty preserved.

(that's the actual haiku, I'm not adding anything, it's just beautiful and it lives here 🥹)

---

👑 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'd like to sponsor this project, see:

https://whynothugo.nl/sponsor

---

and that's the whole page, bestie!! this edition of the shotman(1) man page is dated 2026-08-17 and belongs to the shotman(1) family of pages (General Commands Manual, section 1, as you know). go take a screenshot, you ate. 🎀✨💅🦋🌸