Getting started
Install sss, take your first annotated screenshot in under a minute.
Install
Pick your platform on the install page, or use Cargo from source:
cargo install --git https://github.com/SergioRibera/sss sss_cliYour first capture
Open an interactive area selector with the annotation overlay:
sss --areaClick-drag to pick a region. Tools appear in the toolbar — pen, rectangle, arrow, text, blur, pipette. Hit Enter to confirm, Esc to cancel.
Pick a window instead
sss --windowHover any window to highlight it; click to select. Add --window <title> to skip the picker and target a window by title substring.
Capture the current monitor, headless
sss --screen --current--current means “the monitor under the mouse cursor right now.” Pair with --show-cursor to composite the cursor into the frame.
Where it saves
By default sss copies the result to your clipboard and exits. Use --output <path> to save a PNG to disk instead.
Config file
Create ~/.config/sss/config.toml to set defaults. Example:
[general]
output = "~/Pictures/Screenshots/sss-%Y-%m-%d_%H-%M-%S.png"
show-cursor = true
[capture-ui]
toolbar = true
remember-last-selection = true
[ocr]
enabled = true
gpu = "auto"See the config reference for every key. CLI flags always override config values.
Next steps
- Flags — the full CLI reference.
- Configuration — TOML layout and import semantics.
- Examples — real workflows.