.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH satty 1  "satty 0.22.0" 
.SH NAME
satty \- Modern Screenshot Annotation.
.SH SYNOPSIS
\fBsatty\fR [\fB\-\-man\fR] [\fB\-\-license\fR] [\fB\-c\fR|\fB\-\-config\fR] <\fB\-f\fR|\fB\-\-filename\fR> [\fB\-\-fullscreen\fR] [\fB\-\-resize\fR] [\fB\-\-floating\-hack\fR] [\fB\-o\fR|\fB\-\-output\-filename\fR] [\fB\-\-early\-exit\fR] [\fB\-\-corner\-roundness\fR] [\fB\-\-initial\-tool\fR] [\fB\-\-copy\-command\fR] [\fB\-\-annotation\-size\-factor\fR] [\fB\-\-save\-after\-copy\fR] [\fB\-\-auto\-copy\fR] [\fB\-\-actions\-on\-enter\fR] [\fB\-\-actions\-on\-escape\fR] [\fB\-\-actions\-on\-right\-click\fR] [\fB\-d\fR|\fB\-\-default\-hide\-toolbars\fR] [\fB\-\-focus\-toggles\-toolbars\fR] [\fB\-\-default\-fill\-shapes\fR] [\fB\-\-font\-family\fR] [\fB\-\-font\-style\fR] [\fB\-\-primary\-highlighter\fR] [\fB\-\-disable\-notifications\fR] [\fB\-\-profile\-startup\fR] [\fB\-\-no\-window\-decoration\fR] [\fB\-\-brush\-smooth\-history\-size\fR] [\fB\-\-zoom\-factor\fR] [\fB\-\-pan\-step\-size\fR] [\fB\-\-text\-move\-length\fR] [\fB\-\-input\-scale\fR] [\fB\-\-title\fR] [\fB\-\-app\-id\fR] [\fB\-\-notification\-thumbnail\fR] [\fB\-\-right\-click\-copy\fR] [\fB\-\-action\-on\-enter\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] 
.SH DESCRIPTION
Modern Screenshot Annotation.
.SH OPTIONS
.TP
\fB\-\-man\fR
Show manpage. Pipe to man \-l \-
.TP
\fB\-\-license\fR
Show license
.TP
\fB\-c\fR, \fB\-\-config\fR \fI<CONFIG>\fR
Path to the config file. Otherwise will be read from XDG_CONFIG_DIR/satty/config.toml
.TP
\fB\-f\fR, \fB\-\-filename\fR \fI<FILENAME>\fR
Path to input image or \*(Aq\-\*(Aq to read from stdin
.TP
\fB\-\-fullscreen\fR [\fI<FULLSCREEN>\fR]
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
.br

.br
\fIPossible values:\fR
.RS 14
.IP \(bu 2
all
.IP \(bu 2
current\-screen
.RE
.TP
\fB\-\-resize\fR [\fI<MODE|WIDTHxHEIGHT>\fR]
Resize to coordinates or use smart mode (0.20.1). \-\-resize without parameter is equivalent to \-\-resize smart [possible values: smart, WxH.]
.TP
\fB\-\-floating\-hack\fR
Try to enforce floating (0.20.1). Mileage may vary depending on compositor
.TP
\fB\-o\fR, \fB\-\-output\-filename\fR \fI<OUTPUT_FILENAME>\fR
Filename to use for saving action or \*(Aq\-\*(Aq 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
.TP
\fB\-\-early\-exit\fR [\fI<EARLY_EXIT>...\fR]
Exit directly after save action. 0.21.0: changed to accommodate different triggers
.br

.br
\fIPossible values:\fR
.RS 14
.IP \(bu 2
all
.IP \(bu 2
copy
.IP \(bu 2
save
.IP \(bu 2
save\-as
.RE
.TP
\fB\-\-corner\-roundness\fR \fI<CORNER_ROUNDNESS>\fR
Draw corners of rectangles round if the value is greater than 0 (Defaults to 12) (0 disables rounded corners)
.TP
\fB\-\-initial\-tool\fR \fI<TOOL>\fR
Select the tool on startup
.br

.br
\fIPossible values:\fR
.RS 14
.IP \(bu 2
pointer
.IP \(bu 2
crop
.IP \(bu 2
line
.IP \(bu 2
arrow
.IP \(bu 2
rectangle
.IP \(bu 2
ellipse
.IP \(bu 2
text
.IP \(bu 2
marker
.IP \(bu 2
blur
.IP \(bu 2
highlight
.IP \(bu 2
brush
.RE
.TP
\fB\-\-copy\-command\fR \fI<COPY_COMMAND>\fR
Configure the command to be called on copy, for example `wl\-copy`
.TP
\fB\-\-annotation\-size\-factor\fR \fI<ANNOTATION_SIZE_FACTOR>\fR
Increase or decrease the size of the annotations
.TP
\fB\-\-save\-after\-copy\fR
After copying the screenshot, save it to a file as well Preferably use the `action_on_copy` option instead
.TP
\fB\-\-auto\-copy\fR
Automatically copy to clipboard after every annotation change (0.21.0)
.TP
\fB\-\-actions\-on\-enter\fR \fI<ACTIONS_ON_ENTER>\fR
Actions to perform when pressing Enter
.br

.br
\fIPossible values:\fR
.RS 14
.IP \(bu 2
save\-to\-clipboard
.IP \(bu 2
save\-to\-file
.IP \(bu 2
save\-to\-file\-as
.IP \(bu 2
copy\-filepath\-to\-clipboard
.IP \(bu 2
exit
.RE
.TP
\fB\-\-actions\-on\-escape\fR \fI<ACTIONS_ON_ESCAPE>\fR
Actions to perform when pressing Escape
.br

.br
\fIPossible values:\fR
.RS 14
.IP \(bu 2
save\-to\-clipboard
.IP \(bu 2
save\-to\-file
.IP \(bu 2
save\-to\-file\-as
.IP \(bu 2
copy\-filepath\-to\-clipboard
.IP \(bu 2
exit
.RE
.TP
\fB\-\-actions\-on\-right\-click\fR \fI<ACTIONS_ON_RIGHT_CLICK>\fR
Actions to perform when hitting the copy Button
.br

.br
\fIPossible values:\fR
.RS 14
.IP \(bu 2
save\-to\-clipboard
.IP \(bu 2
save\-to\-file
.IP \(bu 2
save\-to\-file\-as
.IP \(bu 2
copy\-filepath\-to\-clipboard
.IP \(bu 2
exit
.RE
.TP
\fB\-d\fR, \fB\-\-default\-hide\-toolbars\fR
Hide toolbars by default
.TP
\fB\-\-focus\-toggles\-toolbars\fR
Experimental (since 0.20.0): Whether to toggle toolbars based on focus. Doesn\*(Aqt affect initial state
.TP
\fB\-\-default\-fill\-shapes\fR
Experimental feature (since 0.20.0): Fill shapes by default
.TP
\fB\-\-font\-family\fR \fI<FONT_FAMILY>\fR
Font family to use for text annotations
.TP
\fB\-\-font\-style\fR \fI<FONT_STYLE>\fR
Font style to use for text annotations
.TP
\fB\-\-primary\-highlighter\fR \fI<PRIMARY_HIGHLIGHTER>\fR
The primary highlighter to use, secondary is accessible with CTRL
.br

.br
\fIPossible values:\fR
.RS 14
.IP \(bu 2
block
.IP \(bu 2
freehand
.RE
.TP
\fB\-\-disable\-notifications\fR
Disable notifications
.TP
\fB\-\-profile\-startup\fR
Print profiling
.TP
\fB\-\-no\-window\-decoration\fR
Disable the window decoration (title bar, borders, etc.) Please note that the compositor has the final say in this. Requires xdg\-decoration\-unstable\-v1
.TP
\fB\-\-brush\-smooth\-history\-size\fR \fI<BRUSH_SMOOTH_HISTORY_SIZE>\fR
Experimental feature: How many points to use for the brush smoothing algorithm. 0 disables smoothing. The default value is 0 (disabled)
.TP
\fB\-\-zoom\-factor\fR \fI<ZOOM_FACTOR>\fR
Experimental feature (0.20.1): The zoom factor to use for the image. 1.0 means no zoom. defaults to 1.1
.TP
\fB\-\-pan\-step\-size\fR \fI<PAN_STEP_SIZE>\fR
Experimental feature (0.20.1): The pan step size to use when panning with arrow keys. defaults to 50.0
.TP
\fB\-\-text\-move\-length\fR \fI<TEXT_MOVE_LENGTH>\fR
Experimental feature (0.20.1): The length to move the text when using the arrow keys. defaults to 50.0
.TP
\fB\-\-input\-scale\fR \fI<INPUT_SCALE>\fR
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
.TP
\fB\-\-title\fR \fI<TITLE>\fR
Experimental feature (0.21.0): Set window title
.TP
\fB\-\-app\-id\fR \fI<APP_ID>\fR
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
.TP
\fB\-\-notification\-thumbnail\fR \fI<NOTIFICATION_THUMBNAIL>\fR
Experimental feature (0.22.0): use preview thumbnail in notifications where available
.br

.br
\fIPossible values:\fR
.RS 14
.IP \(bu 2
screenshot
.IP \(bu 2
app\-icon
.RE
.TP
\fB\-\-right\-click\-copy\fR
Right click to copy. Preferably use the `action_on_right_click` option instead
.TP
\fB\-\-action\-on\-enter\fR \fI<ACTION_ON_ENTER>\fR
Action to perform when pressing Enter. Preferably use the `actions_on_enter` option instead
.br

.br
\fIPossible values:\fR
.RS 14
.IP \(bu 2
save\-to\-clipboard
.IP \(bu 2
save\-to\-file
.IP \(bu 2
save\-to\-file\-as
.IP \(bu 2
copy\-filepath\-to\-clipboard
.IP \(bu 2
exit
.RE
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
\fB\-V\fR, \fB\-\-version\fR
Print version
.SH VERSION
v0.22.0
.SH AUTHORS
Matthias Gabriel <gabm+aur@mailbox.org>