Hotkeys

Every action is bound from settings.toml. Live-reloaded — save the file and your new bindings take effect within a second.

#Defaults

[hotkeys]
region                 = "ctrl+alt+cmd+1"   # Region (Quick Tray)
window                 = "ctrl+alt+cmd+2"   # Window (Quick Tray)
fullscreen             = "ctrl+alt+cmd+3"   # Fullscreen (Quick Tray)
open_clipboard_image   = "ctrl+alt+cmd+e"   # Paste clipboard image
repeat_last            = "ctrl+alt+cmd+r"   # Repeat previous mode
pin_last               = "ctrl+alt+cmd+."   # Pin most recent capture
color_picker           = "ctrl+alt+cmd+p"   # Eyedropper → hex on clipboard
record_video           = "ctrl+alt+cmd+v"   # Start/stop video recording
record_gif             = "ctrl+alt+cmd+g"   # Start/stop GIF recording
preferences            = "ctrl+alt+cmd+,"   # In-app settings editor
help                   = "ctrl+alt+cmd+/"   # Cheat-sheet window
silent_region          = ""                 # unbound by default
silent_window          = ""                 # unbound by default
silent_fullscreen      = ""                 # unbound by default

#Syntax

A binding is mod+mod+key. Modifiers, in any order:

• ctrl / control
• alt / option / opt
• cmd / command / super / meta
• shift

Keys:

• Digits 0-9
• Letters a-z (case-insensitive)
• . / period, , / comma, / / slash, \\ / backslash
• space, tab, enter / return, esc / escape

Whitespace around + is fine. ctrl+alt+cmd+1 and Ctrl + Alt + Cmd + 1 parse identically.

#Empty = unbound

An empty string in any slot disables that hotkey. Useful when you want to remove the default for an action without inventing a new one.

#Invalid bindings

If you save an invalid hotkey (typo, conflict, modifier-only), the log will say:

settings reload: invalid hotkeys, keeping previous: parsing hotkey for window: wat+1

…and the previous set stays active. You can't lock yourself out by typo.

#macOS built-in conflicts

Avoid ⌘⇧3 / ⌘⇧4 / ⌘⇧5 — those are owned by macOS's own screenshot tool. The default ⌃⌥⌘N scheme was chosen to never clash with system shortcuts or common app bindings.

#All action IDs

These are the keys you set under [hotkeys] in settings.toml: