Keymap

synd key bindings are grouped by keymap layer. A layer is an active UI context, such as entries, feeds, or filter.

Custom Key Bindings

Key bindings can be customized in the configuration file under [keys.<layer>].

[keys.entries]
keymap = [
  { on = "j", command = "entries.next", desc = "Next entry" },
  { on = ["g", "g"], command = "entries.first", desc = "Go to first entry" },
  { on = "up", command = "no_op" },
]

on is either a single key string or an array of key strings for multi-key sequences. The example above binds g followed by g.

User keymaps are merged onto the default keymaps:

• a binding with the same on in the same layer replaces the default binding
• a binding with a new on is added to that layer
• command = "no_op" disables that key sequence in that layer

desc is optional description metadata for the binding.

Commands are validated against the layer. For example, entries.next is valid in the entries layer, but not in the feeds layer.

Key names use the same notation as the default keymap, including enter, space, tab, backtab, esc, arrow keys, C-c for Control-C, S-t for Shift-T, and A-enter for Alt-Enter.

Configurable layers:

category-filter and search-prompt are runtime-generated layers. Their dynamic bindings are managed by the application for now.

Commands

Default Key Bindings