Screenshots

[screenshot] sets where glimpse-shot saves captures and how its editor starts.

directory and filename supply the default save path for every capture. Use an absolute directory: ~ is not expanded, and relative paths start from the directory where you launch glimpse-shot. Filename patterns use local time. If a generated name already exists, a new capture gets (2) before .png, then (3), instead of overwriting it.

glimpse-shot --screen, --window and --region read the configured delay, flash and notify. Flash needs desktop animations enabled. Notifications stay off with editor = "window". The app's Take Screenshot button uses its own Delay row, initially set from delay, and reads flash but keeps notifications off. glimpse-shot capture waits only for --delay; it never flashes or notifies.

[screenshot]

colorone of default "red"

The color annotation tools start with.

• "red"
• "yellow"
• "green"
• "blue"
• "white"

cursorboolean default false

Include the pointer in a capture.

delayinteger default 0

How many seconds you wait before an editor capture, from 0 to 60. The glimpse-shot capture command uses its own --delay option.

directorystringnot set by default

Where you save screenshots, with the folder created on your first save. Use a full path; ~ doesn't expand to your home folder.

editorone of default "overlay"

Where an annotation opens: over the screen, or in a window.

• "overlay"
• "window"

filenamestring

The file name, as a strftime pattern expanded at the capture time. Must end in .png and contain no /.

Default

"Screenshot from %Y-%m-%d %H-%M-%S.png"

flashboolean default true

Flash your screen when the editor takes a screenshot. The glimpse-shot capture command doesn't flash.

notifyboolean default true

Notify you after saving or copying a screenshot from the fullscreen editor.

strokeone of default "medium"

The starting thickness of your annotation lines.

• "thin"
• "medium"
• "thick"

The preferences window saves only the keys you change to the [screenshot] table of the top writable config.toml: the one in your --config-dir when you pass one, otherwise ~/.config/glimpse/config.toml. It shows the effective values from every configuration directory and is read-only when that file is not writable. Other tables are preserved when preferences are saved.

The preferences rows correspond to these keys:

Preferences row	Key
Folder	directory
File Name	filename
Annotate In	editor
Default Delay	delay
Show Pointer	cursor
Flash on Capture	flash
Notify After Saving or Copying	notify
Color	color
Line Width	stroke (thin, medium, thick)