Keyboard shortcuts

Desktop keybinds

Snag registers no global shortcuts; the desktop runs snag commands. contrib/hypr/ ships these binds, all on Super+Q:

Keys	Command	Does
Super+Q	`snag capture`	open the capture box; pressed again, switch kind
Super+Shift+Q	`snag capture --note`	open the capture box as a note
Super+Alt+Q	`snag toggle`	start or stop the timer
Super+Ctrl+Q (Hyprland, Omarchy 3)	`snag show`	open the timer window
Super+Ctrl+Shift+Q (Omarchy 4)	`snag show`	open the timer window

On Omarchy 4, Super+Ctrl+Q is the Calculator, so snag.lua uses Super+Ctrl+Shift+Q instead.

Hyprland does not warn about a duplicate bind; the later one wins. Check a key is free before changing it.

On GNOME, KDE and other desktops, add custom shortcuts in the keyboard settings that run the same commands.

Key	Does
Enter	file the capture; with a project, label or person menu open, take the highlighted match
Shift+Enter	new line
Tab	take the highlighted completion
Up, Down	move through completions
Esc	close the completion menu; otherwise close the box and keep the draft for 60 seconds
Ctrl+V	paste text, or attach a pasted file or screenshot

Key	Does
`/` or Ctrl+K	open the task picker
Left, Right, Up, Down	move between the action buttons
Tab	move between the action buttons
Enter	press the focused button
`?`	open or close About
Esc	close About, otherwise hide the window

With the picker closed, no single key starts or stops the timer.

Key	Does
typing	filter the list
Down or Ctrl+N	next task
Up or Ctrl+P	previous task
Enter	start the timer on the highlighted task
Esc	close the picker

Key	Does
Enter	Keep all (when no button has focus)
Tab	move between buttons
Esc	close without answering; the time is kept

The discard choices have no key of their own.