satty(1) General Commands Manual satty(1)

# [NAME](#NAME)

satty - Modern Screenshot Annotation.

# [SYNOPSIS](#SYNOPSIS)

**satty** \[**--man**] \[**--license**] \[**-c**|**--config**] <**-f**|**--filename**> \[**--fullscreen**] \[**--resize**] \[**--floating-hack**] \[**-o**|**--output-filename**] \[**--early-exit**] \[**--corner-roundness**] \[**--initial-tool**] \[**--copy-command**] \[**--annotation-size-factor**] \[**--save-after-copy**] \[**--auto-copy**] \[**--actions-on-enter**] \[**--actions-on-escape**] \[**--actions-on-right-click**] \[**-d**|**--default-hide-toolbars**] \[**--focus-toggles-toolbars**] \[**--default-fill-shapes**] \[**--font-family**] \[**--font-style**] \[**--primary-highlighter**] \[**--disable-notifications**] \[**--profile-startup**] \[**--no-window-decoration**] \[**--brush-smooth-history-size**] \[**--zoom-factor**] \[**--pan-step-size**] \[**--text-move-length**] \[**--input-scale**] \[**--title**] \[**--app-id**] \[**--notification-thumbnail**] \[**--right-click-copy**] \[**--action-on-enter**] \[**-h**|**--help**] \[**-V**|**--version**]

# [DESCRIPTION](#DESCRIPTION)

Modern Screenshot Annotation.

# [OPTIONS](#OPTIONS)

[**--man**](#man)

Show manpage. Pipe to man -l -

[**--license**](#license)

Show license

[**-c**, **--config** *<CONFIG>*](#c)

Path to the config file. Otherwise will be read from XDG\_CONFIG\_DIR/satty/config.toml

[**-f**, **--filename** *<FILENAME>*](#f)

Path to input image or '-' to read from stdin

[**--fullscreen** \[*<FULLSCREEN>*\]](#fullscreen)

Start Satty in fullscreen mode. Since 0.20.1, takes optional parameter. --fullscreen without parameter is equivalent to --fullscreen current. Mileage may vary depending on compositor

*Possible values:*

- all
- current-screen

[**--resize** \[*<MODE|WIDTHxHEIGHT>*\]](#resize)

Resize to coordinates or use smart mode (0.20.1). --resize without parameter is equivalent to --resize smart \[possible values: smart, WxH.]

[**--floating-hack**](#floating)

Try to enforce floating (0.20.1). Mileage may vary depending on compositor

[**-o**, **--output-filename** *<OUTPUT\_FILENAME>*](#o)

Filename to use for saving action or '-' to print to stdout. Omit to disable saving to file. Might contain format specifiers: <https://docs.rs/chrono/latest/chrono/format/strftime/index.html>. Since 0.20.0, can contain tilde (~) for home dir

[**--early-exit** \[*<EARLY\_EXIT>...*\]](#early)

Exit directly after save action. 0.21.0: changed to accommodate different triggers

*Possible values:*

- all
- copy
- save
- save-as

[**--corner-roundness** *<CORNER\_ROUNDNESS>*](#corner)

Draw corners of rectangles round if the value is greater than 0 (Defaults to 12) (0 disables rounded corners)

[**--initial-tool** *<TOOL>*](#initial)

Select the tool on startup

*Possible values:*

- pointer
- crop
- line
- arrow
- rectangle
- ellipse
- text
- marker
- blur
- highlight
- brush

[**--copy-command** *<COPY\_COMMAND>*](#copy)

Configure the command to be called on copy, for example \`wl-copy\`

[**--annotation-size-factor** *<ANNOTATION\_SIZE\_FACTOR>*](#annotation)

Increase or decrease the size of the annotations

[**--save-after-copy**](#save)

After copying the screenshot, save it to a file as well Preferably use the \`action\_on\_copy\` option instead

[**--auto-copy**](#auto)

Automatically copy to clipboard after every annotation change (0.21.0)

[**--actions-on-enter** *<ACTIONS\_ON\_ENTER>*](#actions)

Actions to perform when pressing Enter

*Possible values:*

- save-to-clipboard
- save-to-file
- save-to-file-as
- copy-filepath-to-clipboard
- exit

[**--actions-on-escape** *<ACTIONS\_ON\_ESCAPE>*](#actions~2)

Actions to perform when pressing Escape

*Possible values:*

- save-to-clipboard
- save-to-file
- save-to-file-as
- copy-filepath-to-clipboard
- exit

[**--actions-on-right-click** *<ACTIONS\_ON\_RIGHT\_CLICK>*](#actions~3)

Actions to perform when hitting the copy Button

*Possible values:*

- save-to-clipboard
- save-to-file
- save-to-file-as
- copy-filepath-to-clipboard
- exit

[**-d**, **--default-hide-toolbars**](#d)

Hide toolbars by default

[**--focus-toggles-toolbars**](#focus)

Experimental (since 0.20.0): Whether to toggle toolbars based on focus. Doesn't affect initial state

[**--default-fill-shapes**](#default)

Experimental feature (since 0.20.0): Fill shapes by default

[**--font-family** *<FONT\_FAMILY>*](#font)

Font family to use for text annotations

[**--font-style** *<FONT\_STYLE>*](#font~2)

Font style to use for text annotations

[**--primary-highlighter** *<PRIMARY\_HIGHLIGHTER>*](#primary)

The primary highlighter to use, secondary is accessible with CTRL

*Possible values:*

- block
- freehand

[**--disable-notifications**](#disable)

Disable notifications

[**--profile-startup**](#profile)

Print profiling

[**--no-window-decoration**](#no)

Disable the window decoration (title bar, borders, etc.) Please note that the compositor has the final say in this. Requires xdg-decoration-unstable-v1

[**--brush-smooth-history-size** *<BRUSH\_SMOOTH\_HISTORY\_SIZE>*](#brush)

Experimental feature: How many points to use for the brush smoothing algorithm. 0 disables smoothing. The default value is 0 (disabled)

[**--zoom-factor** *<ZOOM\_FACTOR>*](#zoom)

Experimental feature (0.20.1): The zoom factor to use for the image. 1.0 means no zoom. defaults to 1.1

[**--pan-step-size** *<PAN\_STEP\_SIZE>*](#pan)

Experimental feature (0.20.1): The pan step size to use when panning with arrow keys. defaults to 50.0

[**--text-move-length** *<TEXT\_MOVE\_LENGTH>*](#text)

Experimental feature (0.20.1): The length to move the text when using the arrow keys. defaults to 50.0

[**--input-scale** *<INPUT\_SCALE>*](#input)

Experimental feature (0.20.1): Scale the default window size to fit different displays. Note that before 0.21.0 this is ignored with explicit resize

[**--title** *<TITLE>*](#title)

Experimental feature (0.21.0): Set window title

[**--app-id** *<APP\_ID>*](#app)

Experimental feature (0.21.0): Set toplevel app\_id. Note that this has to match D-Bus well known name format, otherwise GTK does not accept it

[**--notification-thumbnail** *<NOTIFICATION\_THUMBNAIL>*](#notification)

Experimental feature (0.22.0): use preview thumbnail in notifications where available

*Possible values:*

- screenshot
- app-icon

[**--right-click-copy**](#right)

Right click to copy. Preferably use the \`action\_on\_right\_click\` option instead

[**--action-on-enter** *<ACTION\_ON\_ENTER>*](#action)

Action to perform when pressing Enter. Preferably use the \`actions\_on\_enter\` option instead

*Possible values:*

- save-to-clipboard
- save-to-file
- save-to-file-as
- copy-filepath-to-clipboard
- exit

[**-h**, **--help**](#h)

Print help

[**-V**, **--version**](#V)

Print version

# [VERSION](#VERSION)

v0.22.0

# [AUTHORS](#AUTHORS)

Matthias Gabriel <gabm+aur@mailbox.org>

satty 0.22.0

---

Document: satty(1) from satty 0.22.0-r1 (Chainguard OS)