satty
Wayland screenshot annotation tool
TLDR
SYNOPSIS
satty [--filename file|-] [options]
DESCRIPTION
satty is a GTK4/Adwaita screenshot annotation tool for Wayland (Sway, Hyprland, River, and other wlroots compositors). It is inspired by Swappy and Flameshot: simple tools plus fullscreen annotation and post-capture cropping, with OpenGL rendering.Typical use is a pipeline: slurp selects a region, grim captures it, satty edits. --filename - reads stdin. Save with Ctrl+S, copy with Ctrl+C (or --copy-command wl-copy). Config is ~/.config/satty/config.toml; CLI flags override the file.Omarchy ships satty in its base package list as part of the screenshot stack.
PARAMETERS
-f, --filename FILE
Input image, or - for stdin. Required.-o, --output-filename FILE
Save path (strftime specifiers and ~ allowed), or - for stdout.--fullscreen [all|current-screen]
Start fullscreen.--initial-tool TOOL
Startup tool: pointer, crop, line, arrow, rectangle, ellipse, text, marker, blur, highlight, brush.--copy-command CMD
Command used on copy (typically wl-copy).--early-exit [triggers...]
Exit after copy/save/save-as (or all).-c, --config FILE
Config file (default ~/.config/satty/config.toml).--man
Print the man page (pipe to man -l -).
CONFIGURATION
~/.config/satty/config.toml
Tools, copy command, output filename, keybinds, font, and color palette. CLI options always win over the file.
INSTALL
CAVEATS
Wayland-first; compositor support for fullscreen and CSD/SSD varies. Needs GTK4 and libadwaita. For Hyprland, escape # in slurp colors as ##.
