wayshot(7)

✨ wayshot(7) — from the Miscellaneous Information Manual ✨

okay bestie, gather round, because this is Wayshot: the screenshot tool for compositors that implement zwlr_screencopy_v1 — think sway, think river, think your fave wlroots-adjacent setup. it's giving "screenshot but make it Wayland" 💅

---

🌸 SYNOPSIS 🌸

wayshot [options] [output]

that's it. that's the whole vibe. options first, output last, slay.

---

🎀 REGION SELECTION 🎀

you wanna grab just a piece of the screen? interactively select a screen region using the waysip overlay — this needs the selector feature, no cap:

wayshot -g

and if you're feeling ✨artistic✨, you can optionally pass custom background/foreground colors:

wayshot -g --geometry-background-color 00000050 --geometry-foreground-color ffffffff

or capture a region using a geometry string in slurp/grim format — that's "x,y width_x_height", iykyk:

wayshot FILE -g "$(slurp)"
wayshot -g "783,746 177x251"

literally copy-paste energy. 🫶

---

🦋 CAPTURE FULLSCREEN 🦋

capture all connected outputs. every single one. main character behavior:

wayshot

---

🍓 CUSTOM FILE PATH AND EXTENSION 🍓

you want a specific path and a specific extension? say less:

wayshot ../screenshot.png --extension ppm

---

💖 SCREENSHOT AND COPY TO CLIPBOARD 💖

the "i need to paste this in the group chat immediately" move:

wayshot --clipboard

---

🌈 SCREENSHOT A PARTICULAR DISPLAY 🌈

got multiple monitors and only care about one? first list available outputs, pick one name, then go:

wayshot -l # list available outputs, pick one name
wayshot -o eDP-1

---

⭐ INTERACTIVELY CHOOSE A DISPLAY ⭐

instead of typing names like a peasant, just pick:

wayshot --choose-output

---

🧚 CAPTURE A SPECIFIC TOPLEVEL WINDOW 🧚

windows, not monitors. list active windows, copy the "app_id title" string, then capture it:

wayshot --list-toplevels # list active windows, copy the "app_id title" string
wayshot --toplevel "org.mozilla.firefox Firefox"

---

🔥 INTERACTIVELY CHOOSE A TOPLEVEL WINDOW 🔥

same energy, but you point and click instead of typing:

wayshot --choose-toplevel

---

👑 PICK A COLOR WITH INFORMATION 👑

grab a color and get the deets with it:

wayshot --color

---

💜 PICK A HEX COLOR CODE, USING IMAGEMAGICK 💜

if you have ImageMagick and you want that #RRGGBB realness:

wayshot -g - | convert - -format '%[pixel:p{0,0}]' txt:-|grep -E "#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})" -o

---

🐚 PICK A HEX COLOR CODE WITHOUT USING IMAGEMAGICK 🐚

no ImageMagick? no problem, bestie, we do it raw:

wayshot -g - --encoding ppm | tail -c 3 | od -An -tuC | xargs printf '#%02X%02X%02Xn'

---

🌸 PICK A COLOR, USING IMAGEMAGICK 🌸

and the plain version — just the pixel, no hex grepping, using ImageMagick:

wayshot -g - | convert - -format '%[pixel:p{0,0}]' txt:-

---

💅 SHELL COMPLETIONS 💅

generate and install a completion script for your shell — this one requires the completions feature. pick your fighter:

fish

wayshot --completions fish | source

zsh

wayshot --completions zsh > ~/.zfunc/_wayshot

bash

wayshot --completions bash > /etc/bash_completion.d/wayshot

elvish

wayshot --completions elvish >> ~/.config/elvish/rc.elv

PowerShell (pwsh)

wayshot --completions pwsh >> $PROFILE

nushell

wayshot --completions nushell | save -f ~/.config/nushell/completions/wayshot.nu
# then source it from env.nu

---

🌟 AUTHORS 🌟

maintained by Shinyzenith <aakashsensharma@gmail.com> — absolute icon, fr fr. for more info about development, see <https://github.com/waycrate/wayshot> 🫶

---

and that's the whole page, bestie! this came to you from github.com/waycrate/wayshot, version/date 1980-01-01, living in section wayshot(7) of the Miscellaneous Information Manual. go take some screenshots, you're gonna ate 💖✨